前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在利用智能体进行代码生成与修改的场景中，单次交互可能涉及大量文件的变更和命令的执行。当某一步骤出现错误，开发者急需清晰的答案：具体修改了哪些文件？哪个命令失败了？如何在不丢失后续工作或无关代码的前提下回滚？
dsh-turnscope 针对这些痛点，为 DSH coding sessions 提供了逐轮的文件差异分析、确定性安全警告以及“预览优先”的安全回溯机制。
插件介绍¶
zhaolianghz/dsh-turnscope 是一个 DeepSeek Harness 插件。它通过原生集成 conversation.view，在 DSH 的界面中展示详细的逐轮时间线。该插件不仅提供文件差异和指标统计，还通过“预览-应用”流程实现安全的回滚操作。
核心能力¶
-
逐轮时间线与状态
插件提供运行、完成、失败或输出限制等状态。每轮展示持续时间、工具调用次数、错误次数及活动列表，帮助开发者快速定位问题节点。 -
文件变更明细
提供每轮的命令结果、变更文件摘要及具体的文件 Diff，支持查看本轮开始时已脏的文件。 -
安全回溯
- Preview：起草变更计划，不进行工作区写入。
- Apply：提交变更计划，使用原子重命名和文件日志，并在应用过程中崩溃时，在下次启动时自动回滚到应用前的字节状态。
-
漂移防护
Drift Guard 会防止在预览后工作区发生变化时进行不安全的操作。 -
隐私与存储
采用本地存储（管理模式 root，权限 0o600），无遥测数据，不执行git reset --hard操作。
安装与启用¶
当前未发现标准的 dsh plugin add 安装命令，需通过源码构建本地加载。插件要求 Node.js 22.19 或更新版本，以及 pnpm 11.7。
环境准备¶
corepack enable
pnpm install
pnpm build
验证与加载¶
构建完成后，使用 DSH 0.2.0-rc.2 进行本地加载。GitHub 提供了 smoke:dsh 脚本用于快速验证安装：
pnpm smoke:dsh
典型用法¶
在 DSH 的对话视图中，该插件会渲染出 Turns 面板。
- 查看当前轮次的文件变更摘要和 Diff。
- 点击 Preview 按钮，查看即将应用的变更计划，此时工作区不会发生实际修改。
- 确认无误后，点击 Apply 按钮，系统将提交变更。
- 若在 Apply 过程中发生崩溃，重启 DSH 时，文件会自动回滚到 Apply 之前的字节状态。
适用场景与注意¶
该插件适合需要精细控制代码变更过程、关注审计与安全回滚的开发者。
- 环境要求：需要 Node.js 22.19+、pnpm 11.7 及 DSH 0.2.0-rc.2。
- 权限注意：插件以当前 DSH 进程权限运行，安装前请检查源码。
- 限制：目前版本不支持 Forked retry（计划于 V0.3），且仅支持浏览器端只读行为。
- 许可证：未核实具体许可证名称，仅确认存在 LICENSE 文件。
结语¶
dsh-turnscope 通过提供确定性的安全警告和基于预览的回滚机制，降低了智能体代码修改的风险。如需了解更多细节或获取源码，请访问插件目录或 GitHub 仓库。
