前言¶
在 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
