前言¶
DeepSeek Harness (DSH) 的核心設計是“一切皆插件”。當你在 DSH 中開發智能體時，模型往往缺乏對代碼質量和開發流程的主動約束。shenhuanageshei/dsh-thincoder-suite 是一個移植自開源項目 thincoder 的插件，它將“AI 寫代碼時的四條自我紀律”封裝爲四個獨立工具。它不依賴 DSH 本體代碼，直接在插件層實現功能。
這套機制通過強制輸出可機械覈對的痕跡（對賬表、令牌、紀要），將原本依賴信任的流程轉變爲可審計的流程。
核心功能¶
插件提供四個核心工具，分別解決評審循環、代碼方向、能力溢出和卡點問題。
- advisor：解決評審無限循環問題。它會強制輸出“逐條對賬表”，並通過“引用驗真”機制覈對行號，確保評審有界且可追溯。
- eng / eng_coder：解決代碼方向錯誤問題。進入工程模式後，模型必須先拿到“設計評審通過令牌”才能執行寫代碼操作，否則會被攔截。
- escalate：解決模型能力不足問題。當任務超出當前模型能力時，將寫權限連同任務一起交給池中的更強模型，並返回術後報告供驗收。
- consult_start：解決卡點問題。支持多模型並行獨立會診，會診結果落盤並通知，只有消化了舊會診結果才能發起新會診。
安裝與啓用¶
依賴要求¶
- DSH (DeepSeek Harness): 版本需滿足
>= 0.2.0-rc.1。 - Jobs 插件: 想要支持超過 10 分鐘的長任務，必須安裝
dsh-jobs-local和dsh-tool-jobs兩個插件。
安裝步驟¶
- 克隆倉庫：
git clone https://github.com/shenhuanageshei/dsh-thincoder-suite.git
- 在你的 web profile 目錄（通常爲
~/.dsh/profiles/web）執行：
pnpm add link:<克隆路徑>/dsh-thincoder-suite
- 編輯 profile 的
package.json，將包加入 bundles：
{
"dsh": {
"profile": {
"bundles": [
"@dsh-external/dsh-thincoder-suite"
]
}
}
}
- 重啓 DSH。日誌中出現
[thincoder-suite] active: advisor/eng/eng_coder ...即表示安裝成功。
使用說明¶
advisor：評審收斂與對賬¶
advisor 將“無限找茬”的評審模式改爲“有界對賬”模式。它要求被評審方每輪必須輸出 | # | Action | Detail | 格式的對賬表，且 Action 只能是 Fixed / Dispatched / Not an issue / Deferred 四種之一。
- 引用驗真：評審報告中的每個
文件:行號都會去磁盤驗證，僞造引用會被標出。 - 輪次控制：代碼評審有 5 輪硬上限；設計評審豁免輪次上限，但若連續三次跑不出可用結論，將拒絕再發起（不可自解除）。
eng / eng_coder：工程模式與令牌機制¶
- eng：開啓工程模式，模型此時只能寫文檔（
docs/**和根級.md），無法修改產品代碼。設計評審必須由用戶發起，模型不能自己審自己給自己發令牌。 - eng_coder：負責實際的產品代碼編寫。它支持結構化階段任務書（
stages），每段有目標、可動文件和驗收標準。 - 令牌：設計評審通過後發放令牌。令牌默認 7 天有效，存放在
$DSH_HOME/.thincoder/design-tokens.json。設計文檔未變時自動續期。
escalate：能力升級¶
當任務超出當前模型能力時，使用 escalate 工具。它將任務連同寫權限一併移交給 consultModels 池中的更強模型。子代理內不再允許遞歸飛刀，且在工程模式下直接拒絕（只能走 eng_coder）。
consult_start：並行會診¶
consult_start 發起多模型並行獨立分析（只讀）。會診在後臺運行，完成後通知用戶。紀要默認先落盤到 docs/consult-minutes/，再發送通知。爲了防止重複會診，未消化的會診會攔截新的發起。
長任務後臺化¶
- 默認後臺：
eng_coder和escalate默認使用後臺執行（批 21 起省略background即後臺）。任務完成後會通知用戶，報告全文首選讀取落盤文件$DSH_HOME/.thincoder/jobs/<jobId>.txt。 - 前提條件：後臺化依賴
dsh-jobs-local+dsh-tool-jobs。未安裝這兩個插件時，任務會告警並回落爲同步執行（此時仍受平臺 10 分鐘牆鍾限制）。
注意事項¶
- 版本兼容：本插件僅支持 DSH
>= 0.2.0-rc.1。低版本 DSH 無法安裝，平臺會在安裝期攔截。 - 本地開發：開發調試時請務必使用
link:而非file:。link:會在node_modules建立源碼目錄鏈接，修改代碼即刻生效；file:僅僅是硬鏈接複製，修改源碼不會反映到插件中。 - 安全模型：授權依賴記錄全等匹配 + 設計文檔集指紋 + 流程紀律（令牌格式爲
uuid:過期時間）。
