前言¶
DeepSeek Harness (DSH) 本身具备在侧边栏预览文件、在回合结束时刷新预览以及打开指定行等功能。但在智能体实际执行编辑操作时,目前没有直接的“跟随”反馈。dsh-follow-edits 插件利用这些已有的 API,在编辑发生的瞬间,自动在右侧侧边栏打开文件、跳转到变更行并高亮差异,提供类似 Cline 的实时跟随体验。
插件定位¶
这是 DeepSeek Harness (DSH) 的一个客户端插件,由用户 zcr-133 维护。它解决的是“编辑发生时无法即时感知”的问题,通过在预览中高亮差异(黄色为新增/修改,红色为删除)来实现精确的跟随。
核心功能¶
- 实时打开与跳转:当编辑工具(如
str_replace_editor、write、edit)被调用时,侧边栏会自动打开对应文件,并跳转到修改行。 - 差异高亮:修改的内容显示为黄色,被删除的内容显示为红色。
- 支持 Shell 写入:通过终端或 Shell 命令(如
pwsh、bash)写入的文件也会被打开。 - 跟随策略:
- 对编辑工具提供精确跟随(打开 + 跳转 + 高亮)。
- 对 Shell 命令提供降级跟随(仅打开文件,无跳转和高亮)。
安装与启用¶
通过官方插件管理器安装:
plugin_manager action: install_bundle target: <绝对路径>
在桌面端,也可以通过 CLI 先检查:
dsh web --patch ./cordis.patch.yml
安装后,插件会在 DSH 启动时自动加载。
典型用法¶
安装完成后,无需额外配置。你可以像往常一样运行智能体任务,插件会自动捕捉编辑动作并高亮显示。验证插件逻辑的测试命令如下:
pnpm install && pnpm test
注意事项¶
- 版本状态:当前版本为 v0.3,状态为 working。
- 终端限制:终端/Shell 写入的文件绕过了
ctx.fs,无法生成差异,插件仅提供“打开文件”的降级功能。 - 冷读/重放:在此场景下,映射可能为空。
- 卸载:通过 Plugin Manager 的
set_bundle/remove_bundle命令卸载或禁用。
结语¶
该插件通过链式调用 DSH 已有的原生 API,在不改变核心逻辑的前提下,增强了开发时的反馈颗粒度。源码与文档位于 GitHub。