前言¶
在 DeepSeek Harness(DSH)里让智能体改代码,常见做法是改完再看终端或自己 diff 一遍:哪些文件动了、要不要保留、测什么路径,往往要人工串起来。社区插件 change-review(维护者 Deiael,GitHub:Deiael/change-review)把「审查 agent 的文件改动」和「从 pending/accepted diff 推理自测范围」放在同一套 Host 工具里。它是社区插件,在 dsh.pub 上架只表示公开组合包契约通过自动化检查,不代表 DeepSeek 官方产品或安全审计。
这是什么¶
change-review 是 DSH 的 Host 组合包:无独立 Web 侧栏,通过工具列出、查看 unified diff、接受或还原智能体经 ctx.fs.writeText / ctx.fs.editText 产生的改动;改完后可用 change_review_scope 从 diff 抽出文件、符号、路由,再用 change_review_selftest 规划 代码自测(unit)、边缘性测试(edge) 或 探索性 HTTP 冒烟(exploratory)。快照按 session 存在进程内存,不落盘。
分类上属于 工作流;目录页:skillhub.cn/plugins/Deiael/change-review。
核心功能¶
| 面 | 说明 |
|---|---|
| 跟踪范围 | 仅包装 ctx.fs.writeText / ctx.fs.editText 的文本写/编辑 |
| 审查 | change_review_list / show / accept / revert / comment |
| 开发自测 | change_review_scope 推理范围;change_review_selftest 支持 kind=unit / edge / exploratory / all |
| 探索性测试 | 需在设置中配置 exploreBaseUrl 与可选 exploreToken;token 不出现在工具返回 |
| 数据 | 快照在进程内存、按 session 分桶;卸载或重启 Host 后审查快照消失 |
直接通过 shell 改磁盘的操作不会进入审查台。接受(accept)之后不能再还原。探索性测试只请求配置的 origin,最多 12 个请求,返回状态码与耗时。
安装与启用¶
环境要求:带 fs + tools 的 Web profile(README 建议对照 0.1.x Host 开发)、Node.js >= 22;peer 依赖 @deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery 由宿主提供。
dsh.pub 推荐(钉死 commit):
npx dshpub add Deiael/change-review --profile web
原生 DSH:
dsh plugin --profile web add github:Deiael/change-review
装完后重启 dsh web。
激活时可核对配置是否加载:
dsh --profile web --dump-config
应出现组合包层,以及 id: change-review、name: change-review;设置页会出现 改动审查台 表单。
配置¶
设置 → change-review,或在更高一层 整行替换 config(不是深合并)。示例来自 README:
- id: change-review
name: change-review
config:
maxBytes: 524288
ignore:
- "*.lock"
- coverage
enableSelftest: true
exploreBaseUrl: http://127.0.0.1:3000
exploreToken: ""
exploreTimeoutMs: 8000
| 字段 | 作用 |
|---|---|
maxBytes |
超过则不跟踪(默认 512 KiB) |
ignore |
额外忽略的路径片段或 *.ext |
enableSelftest |
关闭后自测工具会提示未开启 |
exploreBaseUrl |
探索性测试 origin |
exploreToken |
可选 Bearer token,只保存在设置 |
exploreTimeoutMs |
单次探测超时 |
Token 不要发给模型,也不要写进仓库。
典型用法¶
对话里可以直接用自然语言驱动工具,README 示例:
列出这次改了哪些文件
把 src/app.ts 还原
按这次改动做代码自测和边缘测试
对配置的网址做探索性测试
开发自测建议顺序:
- 智能体改完文件后先调
change_review_scope。 change_review_selftest且kind=unit:补/跑相关文件的主路径测试。kind=edge:空值、越界、非法输入、缺 token 等。kind=exploratory:用设置里的网址与 token,对 diff 推断出的路由做冒烟;只有这一类会真正发 HTTP。
kind=all 会给出三类计划。
适用场景与注意¶
适合在 DSH Web 开发会话里,希望 先审查再保留/还原 agent 改动,并在不手动贴 diff 的前提下 按改动范围规划自测 的开发者。
使用前请注意:
- 插件以当前 dsh 进程权限 运行;安装前应自行查看 源码 与 MIT 许可证(package.json 版本 0.2.0)。
- 社区目录(dsh.pub / skillhub)与 DeepSeek、幻方无官方从属关系;DSH 生态理念是「一切皆插件」,本插件为社区贡献。
- 仓库 README 说明 没有 在真实
dsh web会话里做端到端安装冒烟,本机应按「安装 / 激活」自行核对--dump-config与工具列表。
停用:在 profile 里去掉 change-review 组合包层或卸载依赖,重启 Host;已 accept 写入磁盘的文件不会被改回。
结尾¶
change-review 把 agent 文件改动的 list/diff/accept/revert 与 diff 范围内的 unit、edge、exploratory 自测串成一条工作流,适合作为 DSH Web profile 上的审查与自测辅助。
- 目录页:https://www.skillhub.cn/plugins/Deiael/change-review
- GitHub:https://github.com/Deiael/change-review