change-review: DSH Change Review Console and Diff-based Developer Self-Testing

前言

在 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 还原
按这次改动做代码自测和边缘测试
对配置的网址做探索性测试

开发自测建议顺序:

  1. 智能体改完文件后先调 change_review_scope。
  2. change_review_selftest 且 kind=unit:补/跑相关文件的主路径测试。
  3. kind=edge:空值、越界、非法输入、缺 token 等。
  4. 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye