dsh-zcode-rewind
DeepSeek Harness 的每次工具调用工作区检查点：捕获包括 shell 副作用在内的每次文件变更，存储内容寻址的 blob，预览逐行差异，并且每次恢复操作本身也可撤销。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:BOWLUNA/dsh-zcode-rewind#b96acbe49eecea685cc729dfb5e1e6ce83185ce3Zcode Rewind 以 dsh-zcode-rewind 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Per-tool-call workspace checkpoints for DeepSeek Harness — every file mutation, shell side effects included.
Every checkpoint system we could find only tracks changes made through file-editing tools.
The Claude Code documentation says it outright: "Checkpointing does not track files modified by
Bash commands" — rm file.txt, mv old.txt new.txt, cp source.txt dest.txt cannot be undone
through rewind. Cline does catch command side effects, but by committing the whole repository to a
shadow git repository after every tool call, and its own documentation warns that large repositories
suffer significant storage use and slowdown.
DSH's own market is no different: all four rollback plugins we read (dsh-rewind-plugin,
@anionex/dsh-turn-rewind, dsh-undo-savepoint, dsh-recall-plugin) either parse only the
file_path argument of write/edit, or snapshot at turn boundaries — so a sed -i mid-turn is
invisible to all of them.
bash, pwsh, write, edit, MCP tools, subagent tools.tools/execute (before) ──> mark pending; first capture writes a full baseline
│ (the tool runs: bash rm/mv/sed, write, edit, MCP …)
tools/post-execute ─────> fingerprint diff → read changed files →
content-addressed blobs (sha-256, deduped) →
append-only ledger record
The fingerprint is path → size + mtime for the whole workspace. Capture costs one O(files) stat
walk plus content reads only for files that actually changed — measured at 88 ms for 3000 files,
against 2936 ms for the initial full-content baseline, i.e. 86 ms for a no-change capture.
dsh plugin --profile web add dsh-zcode-rewind
Restart DSH — a bundle plugin binds during startup assembly. Verify the composed tree with
dsh --profile web --dump-config | grep workspace-rewind. The store lives outside your workspace,
at $DSH_HOME/workspace-rewind/, and never touches your git repository.
| Tool | What it does |
|---|---|
rewind_now | Create a manual checkpoint right now, e.g. before a risky operation |
rewind_list | Recent records, newest first: id, time, tool, +added ~modified -deleted, sample paths |
rewind_diff | Restore plan plus a line-level unified diff; changes nothing |
rewind_restore | mode=revert undoes one record; mode=asof returns to a point in time |
rewind_undo | Undo the last restore — repeating it toggles undo/redo |
rewind_status | Store statistics: records, blobs, bytes, quota, active configuration |
- insert:
- id: workspace-rewind
name: 'dsh-zcode-rewind'
config:
capture: all # all | fileTools | off
maxFileBytes: 8388608 # larger files are recorded as events only
maxFiles: 20000 # per-walk file cap
maxTotalBytes: 536870912 # store quota; oldest unreferenced blobs are evicted
keepRecords: 500 # ledger trim threshold
excludes: ['.git', 'node_modules', 'dist']
secretNames: ['.env', '*.pem', '*.key']
| Mode | Meaning |
|---|---|
revert | Undo exactly the delta of one record — the "undo what just broke" case |
asof | Return the workspace to the state recorded at a checkpoint, folding the ledger and resolving files created after the target |
apply=true is required to touch the filesystem.rewind_undo can reverse it — repeatedly.Developed and verified on DSH 0.1.5-rc.2 (desktop harness) and 0.1.6-alpha.2 (WSL). The declared
range is:
>=0.1.5-alpha.1 || >=0.1.6-alpha.1
Host APIs used: ctx.tools.register with defineTool, ctx.inject(['fs'], …) and the
tools/execute / tools/post-execute / tools/result events, ctx.systemPrompt.section,
ctx.logger, plus resolveDshHome() from @deepseek-ai/dsh-home-paths. Peers are resolved through a
multi-anchor createRequire, so a link:-installed copy works without a local node_modules.
node test/run.mjs # 2 suites, 73 checks — no DSH required
node tools/verify-translation-pairing.mjs --write # bilingual pair hashes
node tools/verify-doc-numbers.mjs # documented numbers vs the real run
node tools/verify-version-consistency.mjs --dsh 0.1.6-alpha.2
excludes list or capture: fileTools.MIT