dsh-doc-impact
在终端中运行以下命令:
dsh plugin install xarleyn/dsh-doc-impact
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install xarleyn/dsh-doc-impact 安装,插件仓库地址为 https://github.com/xarleyn/dsh-doc-impact,安装完成后重启 Harness 即可加载。
插件介绍
Agent 每一轮都在改代码,但描述这些改动的文档却悄悄落后。dsh-doc-impact 把代码与文档编织成一张声明式影响图,将「模块 A 变了,文档 B 必须审阅」从团队口头约定变成可配置、自动执行的规则。
工作流分四步:回合第一步快照基线(git HEAD 或文件哈希);回合即将结束时对 workspace 与基线做 diff,匹配项目规则;生成一条聚合提醒,让 agent 多走一步模型调用去审阅或更新受影响的文档;严格模式下 agent 必须显式调用 resolve 工具并给出状态与理由,同时按指纹去重的防循环机制避免无限提醒。支持 remind、require-resolution、require-review、require-update 四种策略,glob 包含排除,以及 git 与文件系统双检测器。插件以标准 Cordis 扩展形式提供,无需修改 Harness 核心,所有配置均可在 Settings 面板实时切换。
如果你的项目中有 Agent 频繁触碰核心模块,而 API 参考、架构说明和用户指南散落在仓库各处,dsh-doc-impact 会把文档同步变成每轮自动执行的一环,让代码与文档始终保持一致。
使用场景
- Agent 每次改核心模块后,相关 API 文档和架构说明自动进入审查范围
- 回合结束时自动检测哪些文档因代码变更需要更新或审阅
- 团队希望把代码必须带文档变成可配置的硬性流程而非口头约定
适合人员
- 使用 DeepSeek Harness 跑 Agent 工作流的开发团队
- 仓库中代码与分散文档并存、需要保持同步的项目
- 希望将文档一致性纳入 Agent 闭环的工程负责人