dsh-rewind-branch
DeepSeek Harness 的逐轮分叉与回退：在每个已完成轮次下提供一个操作，将该轮通过 DSH 文件工具修改的文件恢复到轮次开始前的状态，然后在该消息边界打开一个新的分支会话，同时保持原会话不受影响。无需 Git。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:shutongcao1-design/dsh-rewind-branch#bb9f8fa18035ad460a99389d7b45288897b773fbRewind Branch 以 dsh-rewind-branch 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Rewind a turn of a DeepSeek Harness session and continue in a new branch — with the files that turn changed restored. The session you came from is left exactly as it was.
English | 中文
Every finished turn gets one action under the assistant reply: Rewind to before this prompt.
Clicking it:
Nothing is deleted from the original session: its log, messages and continuation stay untouched. The new branch keeps the conversation up to the message before the rewind point.
An in-place rewind truncates the current conversation. Branching keeps the original as evidence and makes the rewind reversible: the old session is still there to compare against or to continue.
File restoration does not require Git. The Host captures the pre-write bytes of DSH's file-tool targets into a content-addressed store, so a workspace without a repository (or with unrelated uncommitted changes) is restored file by file instead of by resetting a repository.
Requires DeepSeek Harness 0.2.1-rc.3 or newer (declared in dsh.engines). No dependencies, no build step, plain JavaScript.
Install from GitHub:
dsh plugin --profile <profile> add "git+https://github.com/shutongcao1-design/dsh-rewind-branch.git"
dsh plugin installs the package and selects the bundle in the same operation. Restart DSH after installing (a full quit, not just a page refresh) so the Host half starts and the turn-tail action reaches the client.
This plugin is not published to npm; install it from this repository.
Notes:
session-running); wait for it to finish.Captured (pre-write bytes and a post-write snapshot, per file):
write, edit, str_replace_editor, multi_edit — the tools that write files through DSH.Not captured:
bash, pwsh, terminal tools, run_code and other shell/code executors. If such a tool ran in the selected turn, the preview shows a warning and the files it changed are not restored; captured files are still restored.<data>/safety/<timestamp>/ (manifest.json plus one .bin per file) before any write.<DSH_HOME>/dsh-rewind-branch/ (journal.jsonl, blobs/, safety/).DSH_HOME, they fall back to a data/ directory next to this package.journal.1.jsonl). Delete the directory to drop all checkpoint history; safety/ backups are plain files you can copy out first./preview, /rewind, /client.js) are same-origin only: each one runs connection.requestRejection and fails closed with 403 when the request is not the profile's own authenticated page.sessions service.turn/start.seq - 1), so the first turn cannot be rewound.node --test test/ # unit tests: plan building, restore execution, TOCTOU, safety backup, manifest
npm run check # syntax check for every runtime file
Layout:
| File | Role |
|---|---|
index.js | Host half: capture, plan routes, restore |
client.js | Browser half: turn-tail action, preview panel, fork + switch |
lib/store.js | Content-addressed blobs + append-only journal |
lib/plan.js | Pure plan computation + plan execution (unit tested) |
test/ | Unit tests and manifest checks |
No build step: the runtime files are plain ESM plus one browser script.
MIT. See LICENSE.