Plugin directory / Developer / dsh-file-undo
dsh-file-undo
Verified · install-tested on dsh QinLuza
What it does
Undo file write/edit operations in DSH via /undo command with snapshot history.
Works — verified, early-stage project
Undo file write/edit operations in DSH via /undo command with snapshot history. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-file-undo
DSH 插件：撤销 agent 对文件的 **write / edit** 操作，通过 /undo 恢复到操作前状态。
命令
| 命令 | 作用 | |---|---| |/undo | 撤销最近一次文件写入/编辑 |
| /undo list | 查看所有已记录的操作历史（索引 + 时间 + 工具 + 文件路径） |
| /undo <n> | 撤销指定索引的操作 |
| /undo prune [days] | 清理 N 天前的快照（默认 7 天），只缩短可回退深度，不动任何当前文件 |
原理
每次write / edit 执行前，插件自动保存文件操作前的内容到本地快照；/undo 时用快照内容覆盖回文件。
安装
方式一：本地构建（link）
1. 构建插件： ``sh
pnpm install
pnpm build
`
2. 在 profile 的 package.json 里加依赖：
`json
"dependencies": {
"dsh-file-undo": "link:<本目录绝对路径>"
}
`
3. 在 profile 的 cordis.patch.yml 里挂载：
`yaml
- insert:
- id: file-undo
name: 'dsh-file-undo'
`
4. 安装依赖并重启：
`sh
cd ~/.dsh/profiles/web
pnpm install
dsh web
`
方式二：发布到 npm 后
`sh
dsh plugin --profile web add dsh-file-undo
`
快照存储
- 位置：~/.dsh/file-undo/snapshots.jsonl
- 插件每次加载自动按 7 天惰性清理一次
- 手动清理：/undo prune [days]（默认 7 天）
- time 字段缺失的快照条目会保守保留，不会被清理
限制
- 只覆盖 write / edit 两个工具；shell 里直接改文件（如 Set-Content、重定向）不覆盖
- 删除回退不支持（官方 fs 无 delete 方法）
- 快照全局共享，不按会话隔离
开发
`sh
pnpm typecheck # 类型检查
pnpm build # 构建
node verify-prune.mjs # 隔离验证清理逻辑（临时 HOME，不碰真实快照）
``
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-file-undo for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:QinLuza/dsh-file-undoHeadless (CLI) profile:
dsh plugin --profile headless add github:QinLuza/dsh-file-undoTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-file-undo/)<a href="https://dshbase.com/plugins/dsh-file-undo/"><img src="https://dshbase.com/badges/dsh-file-undo.svg" alt="dshbase install-tested"></a>