beforewrite
在终端中运行以下命令:
dsh plugin install caishengshuo/beforewrite
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中确保 dsh web 与 plugin_manager 可用后,执行 dsh plugin install caishengshuo/beforewrite 安装;源码见 https://github.com/caishengshuo/beforewrite。
插件介绍
Agent 改代码、配置或文档时,最痛的不是写错,而是把原来正确的一版覆盖掉之后才发现。Git 要嘛还没 commit、要嘛改动还没进仓库;编辑器撤销管不到 agent 在别处动过的文件;覆盖写入也不会进回收站。BeforeWrite 挂在 DSH 的 fs/write-intent 瀑布流上,在内容被替换的那一瞬间之前把旧内容取走存起来,粒度是一次写入,而不是按小时或按天的粗快照。
核心能力都收在 time_machine 这一个工具里:列出最近快照、查看某文件全历史、行级 diff、带回「可反悔」链路的 restore,以及体量统计;需要时可对单文件手动 snapshot。Shell 里 rm、sed -i、重定向等绕过文件服务的破坏,不会自动触发,跑这类命令前需要 consciously 打点——这是设计边界,不是隐藏功能。装好后还有顶栏下的「时光机」界面:按会话看时间轴,合并台词、工具调用与快照,点回档或先 diff 再还原。
数据落在本地 ~/.dsh/time-machine/,索引追加写、内容按 sha256 去重;二进制会存但 diff/restore 会拒绝误当文本写回。适合长期用 DSH 让 agent 改仓库、又希望每次覆盖前都有退路的人——尤其是 waterfall 类钩子很少、你更需要「看不见但一直在」的写盘前兜底,而不是再多一块侧边栏面板。
使用场景
- Agent 通过文件服务改文件后,发现覆盖了正确版本,需要按写入粒度找回上一版
- 想看清某次快照与当前磁盘内容的行级差异,再决定是否 restore
- 准备执行 rm、sed -i 或重定向等不经 write-intent 的命令前,先对关键文件手动 snapshot
适合人员
- 日常用 DSH 托管 agent、频繁改本地仓库的开发者
- 希望写盘前自动留档、而不是只靠 git commit 节奏的人
- 需要 time_machine 或时光机时间轴做 diff/回档的 Harness 用户