dsh-turnsnap

DeepSeek Harness (DSH) 的零配置每轮 git 快照。每个 agent 回合结束后，如果该会话的工作目录是一个有未提交改动的 git 仓库，TurnSnap 会自动 git add -A 并创建一个带 [turnsnap] 标签的提交——一个你从不需要开口要的回滚点。

为什么

长会话会改动大量文件。某一轮跑砸了，你要么手动翻 git，要么丢失现场。TurnSnap 把检查点变成自动的：每轮一个提交，提交信息带轮次、文件数和时间：

▼
text
复制代码
[turnsnap] turn 12 · 7 files · 14:32:08

▼
sh
复制代码
dsh plugin --profile <你的-profile> add dsh-turnsnap

零配置、无浏览器端、无需审批：宿主半区几秒内热载，随即开始守护所有处于 git 工作区的会话。

监听 harness 的 agent/turn-stopping 事件。
从 agent.session.header.cwd 解析会话工作目录。
目录不是 git 仓库或工作树干净时静默跳过。
否则执行 git add -A && git commit -m "[turnsnap] turn N · M files · HH:MM:SS" --no-verify。
所有快照在一条内部队列上串行执行：父会话和子代理同时结束回合也不会竞争 git index。
git 通过 harness shell 服务运行；宿主暴露沙箱策略解析器时，每个请求都会盖上所属会话现行文件策略的戳。

三个工具都零参数。对话里直接说"暂停 turnsnap"，或在任何能调用 harness 工具的脚本里自己调。

MIT

工作原理

监听 harness 的 agent/turn-stopping 事件。

从 agent.session.header.cwd 解析会话工作目录。

目录不是 git 仓库或工作树干净时静默跳过。

否则执行 git add -A && git commit -m "[turnsnap] turn N · M files · HH:MM:SS" --no-verify。

所有快照在一条内部队列上串行执行：父会话和子代理同时结束回合也不会竞争 git index。

git 通过 harness shell 服务运行；宿主暴露沙箱策略解析器时，每个请求都会盖上所属会话现行文件策略的戳。

工具

作用

turnsnap_pause

暂停自动快照，直到 resume

turnsnap_resume

恢复自动快照

turnsnap_status

报告开关状态、计数器和最近一次检查点

注意事项

git add -A 会把已暂存但未提交的内容一并收进检查点。如果你刻意保持部分暂存跨回合存在，请先 pause。

被忽略的文件仍然被忽略（add -A 遵守 .gitignore）。

提交使用 --no-verify，pre-commit 钩子不会在快照上运行。

每仓库每回合一个检查点：共享同一工作区的子代理会落进同一个提交。