dsh-rewind
在终端中运行以下命令:
dsh plugin install LIghtJUNction/dsh-rewind
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install LIghtJUNction/dsh-rewind 安装本插件,源码见 https://github.com/LIghtJUNction/dsh-rewind。
插件介绍
在 Agent 改代码时,你往往只想回滚某几个文件,又不想动 HEAD、分支或暂存区,也不想用 reset/checkout/clean 把整仓状态搅乱。dsh-rewind 针对这种「局部、可预览、可撤销」的需求:对调用方明确列出的已有本地文件,把当前内容与权限写入 Git 对象检查点,用独立 refs 引用,不生成普通提交,也不读写你的 index。
核心流程是 checkpoint、list、preview、restore。preview 返回 token 和各文件 before/after 的 base64 原始字节(含权限差异),便于解码对比后再决定是否恢复。restore 只覆盖检查点里选定的路径;覆盖前会先持久保存 redo 检查点(backupId),想撤销本次恢复可对 backupId 再 preview/restore。token 与当前文件字节、权限、HEAD 和分支绑定,预览后若文件被改动,恢复会被拒绝;跨 HEAD 或分支恢复同样被拒绝。
实现上强调边界与安全习惯:拒绝工作区外路径、.git 元数据、符号链接等;单次 1–100 个文件、单文件与 manifest 有体积上限;多文件恢复不是全批事务。检查点占用 .git/objects,可能含敏感内容,paths 应由调用者审慎选择。仅支持宿主机本地文件系统与本地 Git,不面向 remote world/sandbox,也不是安全沙箱。
适合在 DeepSeek Harness agent-workflow 里编排「改前先打点、改错按文件回滚」的自动化:需要细粒度文件级快照、又不想绑架 Git 工作流状态的插件作者与 Agent 集成者。若你需要自动每轮全仓快照、会话级回退或交互式选择器,首版刻意不提供这些能力,行为目标更接近可控的检查点工具而非完整 pi-rewind 移植。
使用场景
- Agent 批量改几个文件前先 checkpoint,改错后只恢复选定路径
- 需要看 before/after 原始字节再决定是否 restore,而不是盲覆盖
- 覆盖前自动有 backupId,用 redo 检查点撤销一次 restore
适合人员
- 在 Harness 里编排改码与回滚的插件或 Agent 作者
- 希望局部回滚、不 reset/checkout/clean 的开发者
- 需要明确选文件、控制检查点范围的集成方