前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，功能可以按需擴展，但默認行爲並不強調執行紀律：系統提示爲空、失敗後容易重複同一套錯誤操作、已安裝的 Skill 未必被調用、待辦工具常被忽略。開發者在實際跑任務時，常見現象是智能體在同一問題上反覆重試、不主動反思、也不把成功經驗沉澱下來。
cleverer-dsh 是一套面向 DSH 的工作流插件套件，由 Classicoke 維護，目標是在不修改 DSH 源碼的前提下，用 11 個插件和 6 個內置 Skill 補齊上述缺口。套件零外部依賴，README 標註 478 個單元測試全部通過，語句與行覆蓋率 100%。
這是什麼¶
cleverer-dsh 的定位是 DSH execution-discipline plugin suite：通過紀律層、工具層和 Skill 層協同，讓 Harness 在失敗攔截、任務規劃、記憶去重、經驗沉澱等方面有穩定約束。
維護者：Classicoke
許可證：MIT（見 package.json）
當前版本：1.2.0
分類：工作流
GitHub：https://github.com/Classicoke/cleverer-dsh
社區目錄頁：https://www.skillhub.cn/plugins/Classicoke/cleverer-dsh
核心功能¶
下面按 README 中的架構分層介紹，只列已覈實能力。
紀律層（8 個插件 + 1 個 Hub）¶
| 插件 | 作用 |
|---|---|
discipline-hub |
共享失敗日誌、提醒節流、輪次統計 |
anti-stuck |
卡死循環防護：禁止相同參數重複重試，強制換方案 |
dsh-env-triage |
問題追蹤：多種方案均失敗時停止並上報 |
dsh-plan-discipline |
多步任務提醒先制定計劃 |
dsh-memory |
跨會話記憶：自動去重、防膨脹 |
skill-evolver |
經驗蒸餾：失敗 → 解法 → 保存爲 Skill |
dsh-discipline |
每輪注入 11 條執行規則 |
dsh-skill-loader |
提升 Skill 使用率：按需目錄 + 關鍵詞召喚 |
dsh-cordis-discipline |
動態插件護欄：先 define 再 run，先 stop 再 undefine |
紀律插件通過 discipline-hub 共享失敗日誌與提醒管道，避免各自爲政。
工具層（2 個插件）¶
| 插件 | 作用 |
|---|---|
dsh-fast-locate |
並行多目錄文件查找 |
dsh-env-check-tool |
環境健康檢查（9 項） |
Skill 層（6 個內置 Skill）¶
README 列出的內置 Skill 包括：六步錯誤處理、錯誤速查表、快速文件定位、根因調試、本地優先、先計劃後執行。運行時由 dsh-skill-provider 在包內解析註冊，dsh-skill-loader 負責按需加載。
實測數據（README 自述，樣本有限）¶
README 記錄了一次對比實驗：同一任務（分析軟件打包日誌），安裝套件 vs 裸 DSH：
| 指標 | 安裝套件 | 裸 DSH | 差異 |
|---|---|---|---|
| 總耗時 | 8.6 min | 12.8 min | 快 49% |
| LLM 調用 | 51 | 61 | -20% |
| 工具調用 | 59 | 67 | -14% |
| 估算總 token | ~41,000 | ~73,000 | 少 44% |
| 推理塊 | 401 | 1,163 | -65% |
README 明確標註：每組 n=1，token 爲字符估算（±20%），尚未廣泛驗證，具體數字有待更多樣本和真實 API 賬單數據。文中引用此表僅爲說明方向，不作爲普遍結論。
安裝與啓用¶
前提：已安裝並初始化 DSH；本機可用 pnpm（DSH 插件管理器依賴）。
兩種安裝方式只能選其一。README 警告：同時安裝會導致每個插件重複加載，行爲重複甚至提前拒絕。
方式一：DSH 官方插件管理器（推薦）¶
適合希望一條命令完成安裝的場景。插件以 inline patch 形式寫入 cordis.patch.yml。
dsh plugin --profile web add github:Classicoke/cleverer-dsh
無頭環境將 web 換成 headless：
dsh plugin --profile headless add github:Classicoke/cleverer-dsh
命令完成後無需構建，插件與 Skill 即可用。卸載：
dsh plugin --profile web remove cleverer-dsh
方式二：PowerShell 腳本安裝¶
適合需要 board 分組架構的場景。腳本從 GitHub Release 下載 v1.2 壓縮包，解壓後執行 install.ps1，將插件分爲 discipline-board（紀律組）和 tools-board（工具組），紀律插件與 Hub 的結構化協作更強。
在 PowerShell 7+ 中粘貼執行：
$u = 'https://github.com/Classicoke/cleverer-dsh/archive/refs/tags/v1.2.zip'
$z = "$env:TEMP\cleverer-dsh.zip"; $d = "$env:TEMP\cleverer-dsh-install"
Invoke-WebRequest $u -OutFile $z
Expand-Archive $z $d -Force
pwsh -File "$d\cleverer-dsh-1.2\install.ps1"
Remove-Item $z, $d -Recurse -Force
卸載需先恢復安裝前自動備份的 cordis.patch.yml，再按 README 列出的插件與 Skill 文件名逐項刪除。完整卸載腳本見 GitHub README「Uninstall (Option 2)」一節。
典型用法¶
安裝完成後，套件隨 DSH 進程自動加載，無需額外啓動命令。行爲體現在任務執行過程中：
- 多步任務：
dsh-plan-discipline提醒先建計劃，減少無結構推進。 - 命令失敗：
anti-stuck攔截相同參數的重複重試；dsh-env-triage在多種方案失敗後要求停止並報告。 - 查找文件：通過
dsh-fast-locate並行掃描多個目錄，替代逐目錄猜測。 - 環境排查：調用
dsh-env-check-tool執行 9 項健康檢查，快速定位環境問題。 - 經驗沉澱：
skill-evolver將失敗與解法蒸餾爲可複用 Skill，供後續任務加載。
README 對比實驗中的可觀察差異：安裝套件後，智能體在關鍵決策點會詢問用戶、自動切換失效方案並把可用命令沉澱爲腳本；裸 DSH 在同一問題上重試 13 次，未蒸餾經驗，也未主動徵詢。
適用場景與注意¶
適合誰
- 日常用 DSH 跑多步開發任務，希望減少「卡死重試」和無效 token 消耗。
- 需要結構化紀律約束（計劃、反思、記憶去重、Skill 自動加載），但不想改 DSH 源碼。
- 願意在 Linux/macOS 上用官方
dsh plugin add，或在 Windows 上用 board 架構腳本安裝。
注意事項
- 權限：插件以當前 DSH 進程權限運行，安裝前應閱讀源碼並確認 MIT 許可證，評估是否接受其文件訪問與工具調用範圍。
- 安裝互斥：方式一與方式二不可並存；切換前先卸載已有安裝。
- 實測數據：README 性能對比爲單樣本實驗，不宜直接外推到所有任務類型。
- 社區目錄：SkillHub（https://www.skillhub.cn）爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係；插件分發以 GitHub 倉庫爲準。
結尾¶
cleverer-dsh 把 DSH 默認缺失的執行紀律、實用工具和 Skill 庫打包成一套零依賴方案：11 個插件分工明確，6 個內置 Skill 按需加載，一條 dsh plugin add 命令即可啓用。若你正在用 DSH 做日常智能體工作流，且受困於重複失敗、計劃缺失或 Skill 閒置，可以先從官方插件管理器安裝，對照 README 中的架構表理解各插件職責，再按任務類型觀察紀律層與工具層的實際效果。
- 社區目錄：https://www.skillhub.cn/plugins/Classicoke/cleverer-dsh
- GitHub：https://github.com/Classicoke/cleverer-dsh
