dsh-turn-rewind

为 Git 工作区建立 Turn 级检查点，在 Web 中预览全部或部分恢复计划，并支持只恢复文件、恢复后继续或只回溯消息。

• Git 测试工作区（必需）：只在已提交或有外部备份的可丢弃仓库中测试。
• 独立 Web Profile（必需）：避免与生产工作区和并行 Agent 混用。

本页命令固定使用 DSH 0.1.1-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.1.1-rc.2

安装来源

GitHub 源码（锁定提交）

固定目标

github:Anionex/dsh-turn-rewind#df0a18e56504

既有插件教程与安装命令的固定 CLI 基线，独立于 npm 默认分发；不代表每个插件已在该版本或新版本运行验证。更新前须逐项审核配置证据。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   GitHub 源码（锁定提交）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add github:Anionex/dsh-turn-rewind#df0a18e56504

3. 03
   如遇构建脚本拦截

   GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。

4. 04
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 @anionex/dsh-turn-rewind或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

5. 05
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove @anionex/dsh-turn-rewind

$DSH_HOME/profiles/web/cordis.patch.yml

设置检查点模式、存储目录、容量、超时与信任等级。

$DSH_HOME/change-ledger/v1

默认检查点、blob、journal 与救援点存储。

- id: turn-rewind
  config:
    storageDir: ~/.dsh/change-ledger/v1
    maxRestorePoints: 20
    maxTurnCheckpointsPerSession: 10
    turnCheckpointMode: off
    turnCheckpointTrust: strict

1. 先保持 turnCheckpointMode=off，只验证只回溯消息流程。
2. 启用文件检查点前确认 storageDir 不与任何受管理 worktree 重叠。

1. 01
   在测试会话打开回退弹窗并选择只回溯消息。

   期望结果：创建新会话但不改变 Git 工作树。

2. 02
   启用检查点后修改一个测试文件并预览恢复计划。

   期望结果：列表只含预期文件；恢复前先出现救援点和最终确认。

• 先用只回溯消息验证会话分叉，再在单文件测试提交上验证文件恢复。

执行 Git 读取并写入、覆盖、重命名或删除工作区文件，管理检查点、救援点、journal 与设置；用户确认后才执行恢复，Git index、分支和 HEAD 不在修改范围

数据存储：默认 $DSH_HOME/change-ledger/v1；Git-native 检查点还会使用仓库 Git 对象库。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

恢复按钮被阻止

检查同一工作树是否有运行中的 Agent、Git 是否在 merge/rebase，以及预览是否已过期。

恢复列表出现意外文件

立即取消，重新检查工作区、检查点模式、忽略文件和 storageDir。