前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。開發者在面對模糊的編程需求時，往往在執行前浪費 token，或在執行後丟失經驗。dsh-spec-forge 插件通過「需求分級」與「模板沉澱」兩件事，將模糊的編程需求鍛造成可執行規格，並在每次任務完成後沉澱爲會自動複用的個人提示詞模板庫。
核心功能¶
需求分級：三級響應與三態路由¶
插件在模型請求發出前，根據啓發式規則判定下一步動作：
- implement：需求明確（如加字段、改文案、調間距），不追問，直接執行。
- confirm：需求只有容器（如「加個按鈕」），使用 ask_user_question 問清再動手。
- triage：模塊級/架構級需求，先進行四維體檢定級。
需求體檢：四維完整度分析與保守默認¶
對需求進行四維分析，並給出保守默認值。分級是啓發式，漏檢一律回退 L2（按默認執行），不會默認 L1 瞎幹。
模板沉澱：三層漏斗與同名冪等¶
僅在代碼改動且複用價值三問通過時沉澱。採用三層漏斗機制，同名冪等更新，避免模板無限堆積。
項目禁區自動累積¶
識別到的禁區（如禁止動 common/Result.java）會自動累積進項目檔案，後續需求自動注入約束。
召回機制：零依賴關鍵詞指紋¶
基於關鍵詞指紋匹配，而非向量檢索。對語義相同但說法不同的需求召回有限，但可解釋且零成本。
成本控制：減少往返與大文件紀律¶
減少工具往返次數（簡單需求從 3 次降到 1 次）。限制大文件讀取，避免整讀大文件消耗大量 token。
安裝與前置要求¶
前置要求：
- dsh 可用
- Node 22+
- pnpm 在 PATH 上
安裝命令：
dsh plugin --profile web add github:<你的賬號>/dsh-spec-forge
dsh web # 必須重啓，插件纔會組合進插件樹
注意事項¶
- dsh 仍是 developer preview，插件鎖定 API 面。
- 匹配不是向量檢索，對語義相同但說法不同的需求召回有限。
- 分級是啓發式，漏檢一律回退 L2。
- 插件與宿主同進程同權限，只讀寫數據目錄，不聯網/執行 shell/讀憑據。
- 卸載不刪除已沉澱的模板數據。
