前言¶
DSH 原本是一個 agent 包攬約 60 個工具，每次請求全量加載。這會帶來較高的上下文開銷和工具冗餘。dsh-paoding（庖丁）是 DSH 的預設生成器，它將 DSH 改造成「一個指揮 + 四個幫手」的架構。主 agent 只負責編排與內部搜索，其餘工作按角色委派給只帶本行工具的子 agent。全部靠配置完成，零 DSH 源碼改動。
核心功能¶
- 分工明確的小團隊：主 agent 當指揮，拆解任務、分派驗收；聯網調研、UI 設計、寫代碼、全倉深搜四位專屬幫手各司其職，隨叫隨到、幹完即走。
- 高頻小事不過手他人：找代碼、查引用、讀文件這類順手的事，主 agent 自己直接辦，不繞委派的圈子。
- 可招募專屬幫手：內置四角色只是起點——給新角色配好工具和技能，之後一句指令就有人接活。配置文件、圖形界面兩個入口都能建。
- 幫手能指定專用模型：寫代碼的用強檔、查資料的用輕快檔，各配各的模型；不配就跟隨主 agent 當前會話的模型。
- 幫手能繼承對話開工（fork）：把某個角色的「啓動方式」切成繼承對話，幫手帶着主 agent 已完成的對話輪次直接開工，省得在委派時把上下文複述一遍。
- 幫手能就地續修（continuable）：把某個角色的「會話模式」切成可續，活幹砸了或幹得不滿意，主 agent 用
send_message在同一個子會話接着修，不用從頭重派。 - 省錢省上下文：幫手的工具只在被叫到時才加載，用一次付一次；主 agent 每次請求的工具開銷約降三分之二，上下文只收摘要。
- 角色隨改隨用：刪掉用不上的內置角色、給角色改顯示名、給主 agent 配顯示名，都是配置裏一行的事；改完在面板點一次「保存並應用」，預設即時重生成。
- 裝了什麼都能認出來：MCP 服務器、本地插件、已裝技能，安裝與配置時全程檢測；默認只裝 dsh 基礎工具，檢測到的 host 工具在「庖丁配置」裏按需勾選。
- 按工作區各有各的班底：不同項目可以配不同的主/子 agent——「庖丁配置」裏選定工作區單獨配置，每個工作區生成自己的預設。
- 圖形界面配置：點開左側欄底部的「庖丁配置」入口，整頁點選即可，「保存並應用」即時重生成預設。
- 版本更新有提醒，面板一鍵升級：面板會對比 npm registry 上的最新版本，發現新版就地提示並附上發佈頁鏈接；點「升級」就地換上新版。
- 來去自由：不改 DSH 一行源碼；裝完新會話即用，卸載即刪目錄。
- 兩代宿主都兼容：DSH 0.1.5 – 0.2.0-rc.2 全支持。
安裝與啓用¶
前置條件：Node.js ≥ 18、pnpm 與已裝好的 DSH host（0.1.5 – 0.2.0-rc.2）。
使用官方插件通道安裝：
dsh plugin --profile web add dsh-paoding
安裝後重啓 DSH 即可使用。默認只裝 DSH 自帶的基礎工具，檢測到的 MCP/host 工具不會自動寫入。裝完點開左側欄的「庖丁配置」按需勾選工具與角色，「保存並應用」即生效。
典型用法¶
給主 agent 派活即可，它按分工自己路由：
* 找代碼 / 查引用 / 讀文件 → 主 agent 自己辦，不委派。
* 聯網查資料、做調研 → 聯網調研幫手（search_external）。
* 出界面方案、設計稿 → 設計幫手（design）。
* 寫代碼 / 改代碼 → 實現幫手（implement）。
* 超大倉庫全倉探索 → 全倉深搜幫手（search_internal_deep）。
* 專屬活 → 先建自定義角色，之後隨叫隨到。
配置與維護¶
所有偏好都寫在 ~/.dsh/dsh-paoding.config.yml：角色增刪改、技能分配、專用模型、會話模式、啓動方式等。改完在面板點「保存並應用」即生效。
卸載需清理 .agent-presets 目錄：
rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets/orchestrator"
rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets"/orchestrator-*
生態背景¶
DSH 理念是「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
