前言¶
DSH 的插件生態強調「一切皆插件」。在實際使用 DSH 做代碼檢查、修復和交付時，常見的問題是：檢查依賴單次提示詞，修復後缺少統一複查，問題是否真的消失也缺少可復跑的驗證。
下面介紹 @dsh-external/dsh-inspect。它是一個 DSH 插件，提供 checkup、fix、review 三個工具，用於把“發現問題 → 修復交付 → 質量複查”組織成簡單閉環。
這是什麼¶
@dsh-external/dsh-inspect 是一個面向 DSH 的閉環檢查插件。它的核心能力是提供三個工具：
checkup：檢查問題並輸出分級問題清單。fix：根據任務或問題清單進行修復，並輸出交付報告。review：對交付物進行復查，並可對修復項逐條重跑驗證。
資料中的 owner 線索爲 omdsh-dev；包名與安裝地址使用 dsh-external。兩者路徑不一致，安裝前請以實際倉庫、許可證和源碼覈對爲準。
該插件基於 DSH 官方 workflow 引擎編排，並運行時依賴 schemastery。它不註冊進 ctx.skills，也不碰 TUI；工具觸發主要依靠工具描述。
核心功能¶
checkup：檢查問題並輸出分級清單¶
checkup 用於檢查目標代碼或目錄。
輸入參數：
target：必填，檢查目標。angles：可選，檢查角度，可指定多個角度。context：可選，背景信息。
輸出爲分級問題清單，分爲嚴重、一般、建議，幷包含證據與驗證方式。
其機制是：檢查員按角度檢查，紅隊環節嘗試推翻問題聲明；推不翻的問題才保留。這樣可以讓問題清單更貼近可驗證的證據，而不是隻靠靜態閱讀產生結論。
fix：修復任務並輸出交付報告¶
fix 用於執行修復和交付。
輸入參數：
task：必填，修復任務。issues：可選，可傳checkup輸出的問題 JSON 數組。acceptance：可選，驗收標準。
輸出爲交付報告，包括完成情況、檢查記錄和交付說明。
其機制是：先拆解任務，再並行實現，隨後進行對抗式檢查和修復輪收斂。每個實現環節要求找根因、實施修改，並重跑復現驗證。修復後若問題沒有消失，就繼續分析，而不是直接標記通過。
review：複查交付物並驗證修復是否消失¶
review 用於複查交付物。
輸入參數：
target：必填，複查目標。dimensions：可選，複查角度。context：可選，背景信息。fixed_issues：可選，需要逐條驗證的修復清單。
輸出爲分級複查報告和 passed 結果。
如果傳入 fixed_issues，review 會對這些問題逐條重跑驗證，確認問題是否真的消失。對於未消失的修復項，可以按嚴重問題反饋給後續流程。
可單獨使用，也可串聯成閉環¶
三個工具可以單獨使用：
1、checkup：只檢查，不修復。
2、fix：只執行修復和交付。
3、review：只對交付物複查。
也可以串聯爲閉環：
1、先用 checkup 找問題。
2、把問題清單交給 fix 修復。
3、用 review 複查交付物。
如果 review 不通過，或者人工對交付不滿意，可以把反饋作爲新問題再次進入 fix，直到收斂。
安裝與啓用¶
安裝命令如下，<profile> 需要替換爲具體 profile，例如 tui、headless、web 或自建 profile：
dsh plugin --profile <profile> add git+https://github.com/dsh-external/dsh-inspect.git
安裝後重啓對應 profile：
dsh --profile <profile>
重啓後，checkup / fix / review 會隨 profile 注入。
如果 dsh plugin 提示需要 allowBuilds，按提示在：
$DSH_HOME/profiles/<name>/pnpm-workspace.yaml
中添加對應配置即可。
更新命令：
dsh plugin --profile <profile> update
卸載命令：
dsh plugin --profile <profile> remove @dsh-external/dsh-inspect
典型用法¶
閉環用法¶
可以用一句話觸發完整閉環：
用 checkup 檢查 ./src，把問題清單餵給 fix 修復，修完 review 把關
執行路徑大致是：
1、checkup 檢查 ./src，輸出嚴重、一般、建議三級問題清單。
2、fix 接收問題清單，執行拆解、修復和檢查。
3、review 複查交付物，並輸出是否通過。
如果 review 發現修復項未消失，可以把這些問題作爲新的 fix 輸入繼續處理。
單用 checkup¶
示例：
用 checkup 檢查 ./src，重點看錯誤處理和狀態同步
對應參數重點是：
target：./srcangles：錯誤處理、狀態同步等檢查角度context：可選背景
單用 fix¶
示例：
根據 checkup 輸出的問題清單修復 ./src，驗收標準是主要接口不再出現未捕獲異常
對應參數重點是：
task：修復任務issues：checkup輸出的問題 JSON 數組acceptance：驗收標準
單用 review¶
示例：
用 review 複查 ./src，重點驗證剛纔修復的問題是否真的消失
對應參數重點是：
target：./srcdimensions：複查角度fixed_issues：需要驗證的修復清單
配置與依賴¶
可選配置¶
插件支持以下可選配置：
subagentProvider
maxTotalAgents
plannerModel
workerModel
checkerModel
reviewerModel
mergerModel
redteamModel
這些配置用於調整子代理 provider、子代理總數上限，以及規劃、實現、檢查、複查、彙總、紅隊等角色使用的模型。
運行時依賴¶
插件運行時依賴 DSH 官方 workflow 引擎和 schemastery。
peerDependencies 聲明包括：
@deepseek-ai/dsh-agent
@deepseek-ai/dsh-tools
@deepseek-ai/dsh-workflow
cordis
schemastery 已從 peer 移入 dependencies。官方 Profile 的 autoInstallPeers: false 不會自動安裝 peer，因此插件需要安裝到能提供 workflows provider 的 profile 中。
官方 base 組合自帶所需能力，通常無需額外安裝。如果 profile 組合缺少 workflows provider，例如標準 web 組合，插件仍可照常加載；但調用 checkup、fix 或 review 時，會拋出帶指引的清晰錯誤，而不是掛起整個 profile。
運行環境¶
Node 引擎要求爲：
^22.19.0 || >=24.0.0
並要求使用 erasable-only TypeScript 語法。
適用場景與注意¶
適合的場景¶
這個插件適合需要把 DSH 的使用流程從“單次生成”推進到“檢查、修復、複查”閉環的場景，例如：
- 檢查某個目錄或模塊的問題。
- 根據問題清單執行修復。
- 對修復後的交付物做複查。
- 對修復項逐條驗證是否消失。
- 在 review 不通過時，把反饋重新交給 fix。
使用前注意¶
1、插件以當前 dsh 進程權限運行。安裝前請檢查源碼、依賴和許可證。
2、資料中的許可證爲 MIT；package.json 中聲明 private: true。實際安裝前仍建議覈對倉庫源碼。
3、資料中給出的 GitHub 倉庫線索爲 https://github.com/omdsh-dev/dsh-inspect；包名與安裝地址爲 @dsh-external/dsh-inspect。兩者路徑不一致，安裝前請覈對最終倉庫地址。
4、DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應寫成官方應用商店。
5、資料未提供可用的目錄頁 URL，因此本文不提供目錄頁鏈接。
短結尾¶
@dsh-external/dsh-inspect 的價值，是把 DSH 中常見的檢查、修復和複查流程放到同一組工具裏：checkup 找問題，fix 修問題，review 驗問題是否消失。
適合安裝到提供 workflows provider 的 profile 中使用。使用前建議先覈對源碼、許可證和倉庫地址。
