前言¶
在 DeepSeek Harness (DSH) Desktop 的使用中，智能体执行 edit、write 或 str_replace_editor 操作后，输出通常只是一行文本。开发者很难在纯文本日志中快速确认具体改动了哪些文件，以及变更的具体内容。下面介绍 dsh-diff-card 插件，它为每个对话轮次提供了一张可视化的文件变更卡片。
插件定位¶
该插件用于 DSH Desktop，旨在为智能体执行文件变更操作时提供 Codex 风格的展示。插件由 WongYuYe 维护，采用 MIT 许可证。它覆盖了 edit、write、str_replace_editor 和 Code Dispatch 子调用，使得每个轮次的变更都能以卡片形式呈现。
核心功能¶
- 变更行展示：工具行显示新增/删除行数，如
+N −M。轮末卡片会列出本轮修改的文件，默认预览 3 条，标题中包含合计数据。 - Diff 展开与收起：点击某一行可以展开或收起该文件的 diff。点击“查看更改”按钮可展开本轮全部文件并打开 diff，再次点击收起。
- 审核模式：提供“审核”功能，可直接展开本轮全部 diff 进行查看。
- 撤销与恢复：
- 点击“撤销”可将本轮文件恢复到改动之前。如果文件已被其他进程修改，插件会拒绝操作。
- 撤销成功后，按钮变为“恢复”，再次点击可将撤销的改动写回。
- 撤销和恢复操作均会弹出轻量确认。
- 文件快速操作：每一行右侧有一个下拉符号
▾。点击它可以使用系统应用打开文件、在文件夹中显示、调用 VS Code 打开，或复制文件的绝对/相对路径。 - 语言适配：界面文案会跟随 DSH 的界面语言（中文或英文）自动切换。
安装与启用¶
安装前请确保你的 DeepSeek Harness 版本满足 >= 0.1.2-rc.1。
在终端执行以下命令安装：
dsh plugin --profile desktop add dsh-diff-card
安装完成后，刷新 Web GUI 或重启 DSH Desktop 即可生效。
典型用法¶
- 查看变更：智能体执行代码修改后，工具行会出现
+N −M标识，轮末出现“已编辑 N 个文件”的卡片。 - 检查 Diff：点击卡片中的文件行，展开具体的 diff 内容，确认变更是否正确。
- 文件跳转：如果需要直接打开文件进行二次修改，点击文件行右侧的
▾，选择“VS Code”或系统默认应用。 - 回滚操作：如果发现本轮修改有误，点击“撤销”按钮即可恢复原状；确认无误后可点击“恢复”将改动重新应用。
适用场景与注意¶
该插件适合需要精细控制文件变更流程、进行代码审核或需要频繁回滚操作的 DSH 开发者。由于插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
结尾¶
dsh-diff-card 通过可视化的卡片和交互操作，解决了智能体输出日志中文件变更信息不直观的问题。更多详情与源码可参考：
* GitHub：https://github.com/WongYuYe/dsh-diff-card
* 生态目录：https://www.skillhub.cn/plugins/WongYuYe/dsh-diff-card
