前言¶
在 DSH（DeepSeek Harness）裏做複雜任務，常見做法是改系統提示詞或臨時約定「你現在扮演某某角色」。這類做法依賴模型自覺，工具調用往往仍走全量權限，多步驟協作也缺少可複用的編排結構。DeepSeek Harness 社區插件 dsh-expert-suite（目錄名 lanyun417/dsh-expert-suite，npm 包名 dsh-expert-suite）把協作拆成兩個維度：專家（單角色 + 工具白名單）與 專家團（團長派工、串並行交付）。下面介紹它是什麼、如何安裝，以及命令與工具層面的典型用法。
這是什麼¶
DSH 專家工坊 由維護者 LanYun417 發佈，分類爲工作流。定位是：給 AI 增加「角色與團隊」——要麼以某一領域專家身份執行任務，要麼拉起一支多 Agent 團隊按流程交付。
隨包內置 8 位專家與 1 個「全棧交付團」，可直接試用。用戶自定義數據落在 $DSH_HOME/expert-suite/（專家 experts/<id>.json，團隊 teams/<id>.json）；與內置同 id 時，用戶目錄版本優先。
README 標明對齊 DSH 0.2.0-rc.2 運行時；package.json 中 engines.dsh 爲 >=0.1.5-rc.1，更早版本需按宿主安裝時的 peer 提示處理（例如 dsh plugin --profile <profile> allow-version）。
核心功能¶
專家（Expert）¶
一個專家 = 人設與方法論（persona） + 工具白名單（toolFilter）。召喚後模型以該身份幹活；白名單外的工具調用由宿主 tools.guard() 進程內拒絕，不是僅靠提示詞提醒。空白名單表示不限制工具。
主要字段包括：id、name、category、description、capabilities、expertise[]、exampleTasks[]、persona、可選 model、toolFilter[]、source。
專家團（Expert Team）¶
一個團隊 = 團長（lead） + 成員（members）（按 order 排序，各帶 responsibility）。支持兩種用法：
- 會話式（默認）：進入團隊後與團長對話；打招呼不會自動跑全隊，有任務時團長澄清目標，再通過
team_dispatch按需派工給成員（每次派工爲 one-shot 子代理，交付後整合回覆）。 - 批量（顯式）：使用
team_run，給定自包含總目標，一次拆解並跑完相關成員後整合總結。
批量執行模式（團隊定義裏的 executionMode）包括：serial（按 order 串行，後續成員可見前序交付物）、parallel（同波次並行，默認受 maxParallelMembers 限制爲 4）、auto（團長先做波次規劃，失敗則回退串行）。interventionMode: step 時，每位成員或每個並行波次交付後會暫停，需 team_message(action=continue) 放行。
團長默認 leadToolFace: coordinator，只協調不執行（拒絕 bash/pwsh/write/edit 等）；可在插件配置改爲 full。
三種創建方式¶
| 方式 | 入口 |
|---|---|
| 手動創建 | 面板「創建專家 / 創建專家團」，或工具 expert_create / team_create |
| 文件導入 | 面板「導入」，或 expert_import / team_import（專家支持 JSON / Markdown，團隊僅 JSON） |
| AI 生成 | 面板「AI 生成」，或 expert_generate / team_generate（描述 → 校驗後入庫，save=false 可只預覽） |
每位專家、每個團隊及使用說明會註冊爲運行時 skill，AI 可隨時加載。圖形入口：設置 →「DSH 專家工坊」，或右下角懸浮按鈕。
插件共註冊 19 個工具（如 expert_list、expert_summon、team_dispatch、team_run 等），詳見官方 README 工具清單。
安裝與啓用¶
推薦從 npm 安裝：在 DSH「插件」頁搜索 dsh-expert-suite，或執行：
dsh plugin add dsh-expert-suite
安裝完成後重啓一次 DSH。插件加載時會把「專家模式」「專家團模式」兩個預設鋪到 $DSH_HOME/.agent-presets/，重啓後可在預設選擇器中看到。
可選配置（寫在 cordis.yml 插件行的 config 下）示例：
- insert:
- id: expert-suite
name: 'dsh-expert-suite'
config:
dataDir: '' # 缺省 $DSH_HOME/expert-suite
layPresets: true # 自動鋪設兩個預設
maxParallelMembers: 4 # 波次內最大並行子代理數
leadToolFace: 'coordinator' # coordinator | full
典型用法¶
斜槓命令¶
# 單專家
/expert-list # 瀏覽名冊
/expert data_analyst # 召喚數據分析師
/expert data_analyst 幫我解讀這份報表 # 召喚併發送第一句話
/expert-dismiss # 退出專家模式
# 專家團（會話式）
/team-list # 瀏覽團隊
/team fullstack_delivery # 進入全棧交付團
/team fullstack_delivery 你好 # 進入併發送第一句話
# 在會話中請求 AI 調用生成工具
請調用 expert_generate：我需要一個專門寫技術文檔的專家
請調用 team_generate：幫我組建一個能完成產品從設計到上線的團隊
工具驅動¶
單專家：expert_list → expert_summon → expert_dismiss。
團隊：team_dispatch（團長按需派工）、team_status、team_end；需要一次跑完整條流水線時用 team_run（可配合 serial / parallel / auto 與 step 干預）。
召喚成功後面板會收起，界面狀態條顯示當前專家或團隊，可一鍵退出。
導入專家（Markdown 示例）¶
專家 Markdown 爲 YAML frontmatter + 正文（正文即 persona）：
---
id: tech_doc_writer
name: 技術文檔專家
category: 寫作
description: 面向開發者的技術文檔寫作
expertise: [技術寫作, Vue, Vite]
exampleTasks:
- 把這份源碼註釋整理成教程
toolFilter: [read, write, grep, glob]
capabilities: |-
多行能力介紹……
---
你是資深技術文檔工程師……（persona 正文）
專家團 JSON 中成員通過 expertId 引用已存在的專家，需先保證名冊裏已有對應專家。
適用場景與注意¶
適合誰：需要 repeatable 角色設定（含工具邊界）的開發者；需要團長編排、串並行多子代理交付的工作流場景；希望用面板或 JSON/Markdown 管理專家資產、而非每次手寫長提示詞的用戶。
權限與安全：插件在當前 DSH 進程權限下運行；專家與成員的 toolFilter 是進程內門禁，但宿主本身能調用的工具仍取決於你的環境與配置。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證（package.json version 0.1.0），確認符合你的合規要求。
兼容性：Client 側依賴 web profile；無 webserver 的 profile 下面板會降級爲只讀空態，核心斜槓命令與工具仍可用。若專家定義指定了 model，需宿主開啓「子代理模型選擇」opt-in，否則派工可能報錯；內置專家默認不指定模型。
生態說明：DSH 採用「一切皆插件」思路；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-expert-suite 把「專家人設 + 工具白名單」和「專家團編排」做成可安裝、可導入、可 AI 生成的插件能力，並內置專家與全棧交付團供開箱試用。若要瀏覽元信息與安裝入口，見目錄頁 https://www.skillhub.cn/plugins/LanYun417/dsh-expert-suite ；完整說明與架構細節見 https://github.com/LanYun417/dsh-expert-suite 。
