改动审查台 Deiael/change-review

change-review

dsh.pub registry status

DeepSeek Harness Host 组合包：改动审查台 + 按 diff 推理的开发自测。

智能体通过 ctx.fs 写文件或做字面量编辑时，插件记下第一次改动前的快照。之后可以列出、看 unified diff、保留或还原。改完后不必把 diff 再贴一遍：change_review_scope 从 pending / accepted 的改动抽出文件、符号、路由，再分 代码自测 / 边缘性测试 / 探索性测试 让 agent 自己补测。探索性测试需要你在设置里填网址和 token。

这是社区插件。上架 dsh.pub 只说明公开组合包契约通过了自动检查；它不是 DeepSeek 官方产品，也不代表安全审计或质量评分。

English: Host bundle for DeepSeek Harness. It snapshots ctx.fs.writeText / editText so you can list, diff, accept, or revert agent edits. After that, change_review_scope infers files, symbols, and routes from pending/accepted diffs. change_review_selftest then plans unit tests, edge tests, or same-origin exploratory HTTP probes. Put exploreBaseUrl and exploreToken in plugin settings; the token is never printed in tool output. Install with npx dshpub add Deiael/change-review --profile web. See the tables below for config, tools, disable, and uninstall.

能力

| 面 | 说明 |
| 交付形态 | Host 工具插件（无独立 Web 侧栏） |
| 跟踪范围 | ctx.fs.writeText / ctx.fs.editText 的文本写/编辑 |
| 审查 | list / show / accept / revert / comment |
| 开发自测 | 从 diff 推理范围；unit / edge 给 agent 计划；exploratory 对配置 origin 冒烟 |
| 数据 | 快照在进程内存里，按 session 分桶；不落盘 |
| Token | exploreToken 只放设置，不出现在工具返回 |

兼容性

- DeepSeek Harness 带 fs + tools 的 Web profile（开发时对照 0.1.x Host）
- Node.js >= 22
- peer：@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery（由宿主提供，不要装进本包的 dependencies）

安装

公开仓库根目录就是可安装组合包。

dsh.pub 推荐（钉死 commit）：

npx dshpub add Deiael/change-review --profile web

原生 DSH：

dsh plugin --profile web add github:Deiael/change-review

本地开发链接（目录必须一直存在）：

dsh plugin --profile web add .

或在会话里用 plugin_manager 的 install_bundle，target 填仓库绝对路径或 Git 规格。

装完后重启 dsh web。

激活

dsh --profile web --dump-config

应出现组合包层，以及 id: change-review、name: change-review。设置页会出现 改动审查台 表单（Config）。

配置

设置 → change-review，或在更高一层 patch 整行替换 config（不是深合并）：

- 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（node_modules、.git、dist、锁文件已内置） |
| enableSelftest | 关闭后自测工具会提示未开启 |
| exploreBaseUrl | 探索性测试 origin，例如 http://127.0.0.1:3000 |
| exploreToken | 可选 Bearer token，只保存在设置 |
| exploreTimeoutMs | 单次探测超时 |

Token 不要发给模型，也不要写进仓库。

工具

| 工具 | 作用 |
| change_review_list | 列出改动（默认 pending） |
| change_review_show | 某一文件的 unified diff 和审查意见 |
| change_review_accept | 保留当前内容，丢掉还原快照 |
| change_review_revert | 还原到首次改动前；新建文件则删除 |
| change_review_comment | 记下人对该文件的反馈 |
| change_review_scope | 从 pending/accepted diff 推理文件、符号、路由 |
| change_review_selftest | kind=unit / edge / exploratory / all |

对话示例：

列出这次改了哪些文件把 src/app.ts 还原按这次改动做代码自测和边缘测试对配置的网址做探索性测试

开发自测流程

1. 智能体改完文件后先调 change_review_scope。
2. change_review_selftest kind=unit：补/跑这些文件的主路径测试。
3. kind=edge：空值、越界、非法输入、缺 token。
4. kind=exploratory：用设置里的网址 + token，对 diff 推断出的路由做冒烟。只请求该 origin，最多 12 个请求，返回里只有状态码和耗时。

kind=all 会给出三类计划；只有 exploratory 会真正发 HTTP。

工作原理

- 包装 ctx.fs.writeText / ctx.fs.editText，不占用 fs/write-intent 决策槽。
- 第一次改某个文件前读取原文；之后只更新「当前内容」。
- 用 fs/observed 里的 actor 尽量按 session 分桶；拿不到 session 时记在 default。
- 卸载插件时 ctx.effect 会拆掉包装。

校验

npm test

当前用 node --test。本仓库 没有 在真实 dsh web 会话里做端到端安装冒烟；请在本机按上面「安装 / 激活」核对 --dump-config 和工具列表。

停用与卸载

1. 在 profile 里去掉 change-review 组合包层，或卸载该依赖。
2. 重启 Host。审查快照随进程消失，磁盘上已接受的文件不会被改回去。
3. 本地开发链接：删掉 profile 里对该目录的引用后再删仓库。

范围与限制

- 审查面是工具输出里的 diff，不是独立 Web 侧栏。
- 直接打 shell 改磁盘的操作不会进审查台。
- 接受之后不能再还原。
- 还原新建文件时走宿主 processPath + unlink，适合本地文件系统后端。
- 探索性测试不会跟到别的域名；失败时只报告状态或错误信息。

License

MIT