dsh-snapshot

简体中文 | English

自动快照、一键回滚的 DeepSeek Harness 插件。

Agent 每次 write/edit 前自动保存目标文件内容，支持 /rollback 命令恢复到任意历史快照（类似 Trae 的 Checkpoint 能力）。 附带侧边栏 “快照时间线” 面板与 设置页配置卡片。

---

功能

每次 write/edit 前自动快照目标文件内容，追加进该会话的 snapshots.jsonl，并记录触发快照的用户消息开头作为标注。

界面操作

• 快照时间线 侧边栏底部「快照」按钮点击打开面板，列出当前会话全部快照。
  • 每条记录显示：触发快照的用户消息预览、使用的工具与文件路径。
  • 点击某条记录即回滚到该状态（回滚前自动记录当前状态，支持再次回滚）。
  • 头部「清空」按钮可二次确认后删除全部快照。

• 配置卡片 设置页「插件配置」中的 snapshot 卡片。布尔字段为二态开关，数字字段留空或点击「恢复默认」即可回退，改动即时生效。

命令操作

/rollback list                     # 列出快照
/rollback  --yes              # 恢复到指定快照（恢复前先记录当前状态，可再回滚）
/rollback --call  --yes    # 按工具调用回滚
/rollback clear --yes              # 清空该会话全部快照

安装

插件通过 dsh plugin 命令安装进 profile（dsh web 对应 web profile），自动写入依赖与 bundle 列表，无需手动编辑：

dsh plugin --profile web add dsh-snapshot

💡 没有全局 dsh 命令怎么办？

未安装全局 CLI 时，可直接使用 npx 执行：

npx @deepseek-ai/dsh plugin --profile web add dsh-snapshot  # 安装插件到 web profile
npx @deepseek-ai/dsh web                                    # 启动 dsh web