dsh-turn-rewind：DeepSeek Harness 的对话与工作区状态回退插件

dsh-turn-rewind 是 DeepSeek Harness（DSH）的对话与工作区状态回退插件（DSH plugin），由 Anionex 维护，采用 BSD-3-Clause 协议，最近更新于 2026-08。它解决的是 AI 代理在修改工作区后需要安全回退的问题，核心能力基于持久化的 Change Ledger 引擎，提供消息锚定的项目文件恢复，并可选从恢复点重新开始请求。Change Ledger 作为底层服务，支持内容寻址的恢复点清单、Git 工作树/HEAD/分支围栏、过期计划检测、双重确认、自动救援点、恢复后哈希校验、失败回滚以及启动时日志协调，并提供公开的 ctx.changeLedger 服务供其他插件使用。

dsh-turn-rewind 这个 DSH plugin 支持哪些核心特性？

dsh-turn-rewind 的核心特性围绕安全的恢复生命周期展开：它创建恢复点，允许代理、用户或外部工具修改工作树，然后预览精确的路径级差异，审查完整或选择性恢复计划，最终在回退对话框中按下恢复按钮。整个过程绝不自动提交、暂存、重置、切换分支或修改 Git 索引，所有恢复操作都需显式触发。版本 0.1 支持普通 Git 工作树中的已跟踪文件（包括缺失的）、未被 .gitignore 排除的未跟踪文件、二进制或文本文件、符号链接以及可执行权限位；稀疏检出、子模块、超大文件等则被拒绝或排除。

dsh-turn-rewind 怎么安装？

安装 dsh-turn-rewind 只需一条命令，通过 DSH 插件管理器添加即可：

dsh plugin --profile web add github:anionex/dsh-turn-rewind

安装后，插件会在每条用户消息下显示一个图标按钮（位于时间戳和复制操作之后），点击即可打开回退对话框，查看受影响的文件并选择恢复方式。

dsh-turn-rewind 的安全契约有哪些？

安全契约是 dsh-turn-rewind 的基石：所有恢复必须由用户在对话框中按下最终按钮或通过服务 API 显式调用；对话框预览生成会话绑定的过期计划，不修改任何文件；直接修改请求若没有有效的会话绑定计划对则失败关闭；每次恢复前都会捕获当前合格树作为持久救援点；不支持的类型或路径会明确失败，不会静默跳过；所有持久路径均为规范且相对工作区，拒绝符号链接父目录和非空目录替换；应用时重新检查所选路径和 HEAD/分支/操作围栏，任何相关变更都会使计划失效；Git 索引、分支、HEAD、暂存区和提交均不受影响。

dsh-turn-rewind 的 Change Ledger 引擎是什么？

Change Ledger 是 dsh-turn-rewind 底层的持久化恢复引擎，它拥有完整的恢复生命周期，包括内容寻址的恢复点清单、Git 工作树和 HEAD/分支围栏、过期计划检测、两步确认加 DSH 人工批准、自动预恢复救援点、恢复后哈希验证、失败回滚以及启动时对中断恢复日志的协调。其持久格式在 docs/FORMAT.md 中记录，安全与失败模型在 SECURITY.md 中说明。该引擎作为 ctx.changeLedger 服务公开，其他 DSH 插件可以消费，从而复用快照和恢复层。

dsh-turn-rewind 兼容哪些 DeepSeek Harness 版本和平台？

dsh-turn-rewind 作为 DSH 插件，兼容 DeepSeek Harness 框架，通过标准的插件接口注册。它基于 JavaScript 开发，适用于支持 DSH 插件的环境。由于版本 0.1 仅支持普通 Git 工作树，建议在标准 Git 仓库中使用，并确保工作区符合插件支持的路径和文件类型限制。

查看更多 DSH 插件，访问 dsh-plugin.org