前言¶
DeepSeek Harness（DSH）的設計理念是“一切皆插件”。在構建智能體或管理專家目錄時，維護一套標準化的角色描述、技能樹和工具配置往往耗時費力。手動搬運文件不僅繁瑣，還容易出錯。
這個插件旨在解決專家目錄管理與 DSH 會話流割裂的問題。它通過讀取本地 WorkBuddy 的專家目錄，讓 DSH 用戶可以直接在插件市場瀏覽、安裝並切換專家，從而將專家能力無縫集成到日常工作流中。
它是什麼¶
dsh-workbuddy-expert 是一個由社區開發者 pbwheel 維護的 DSH Web 插件。它不聯網下載專家，而是作爲本地 WorkBuddy 專家目錄的“代理”。
該插件主要做兩件事：
1. 專家市場：只讀掃描本地 WorkBuddy 專家目錄，提供卡片瀏覽、搜索和分類，支持一鍵安裝、更新和卸載。
2. 會話選擇器：在 DSH 的會話輸入框旁提供專家膠囊，允許用戶隨時切換當前會話的專家，保留全部歷史記錄，在下一個模型請求邊界生效。
核心功能¶
該插件通過只讀掃描和文件導出機制，實現了專家能力的標準化管理。
-
本地專家市場
插件默認掃描~/.workbuddy/plugins/marketplaces/experts/plugins目錄。它不聯網，只做只讀掃描，絕不修改 WorkBuddy 的原始目錄。市場頁面支持卡片瀏覽、搜索和分類，操作按鈕包括安裝、卸載和更新。 -
專家導出與安裝
安裝操作本質上是導出。選中專家後，插件會將其導出爲標準專家文件夾到~/.dsh/experts/<id>/，包含expert.yml、清洗後的role.md、完整的skills目錄以及頭像文件。更新時支持就地重導，卸載則刪除整個文件夾。 -
會話級專家切換
在會話輸入框旁的專家膠囊中，可以展開專家列表並切換。切換是整組替換（角色描述與 skills），但保留全部會話歷史。切換事務串行化，同一會話同時只允許一次切換。切換在下一個模型請求邊界生效，不會打斷當前的流式輸出。 -
工具白名單與能力掛載
專家的expert.yml中的tools.allow配置會被掛載到當前會話的作用域，限制可用工具。專家的角色描述和專屬 skills 也會隨會話註冊或註銷。
安裝與啓用¶
安裝前請確認宿主環境。DSH 桌面端和終端使用不同的 profile（desktop 和 web），互不相通。
終端安裝¶
終端用戶需要指定 --profile web，並使用 npm 包名或 Git 地址：
dsh plugin --profile web add github:pbwheel/dsh-workbuddy-expert
桌面端安裝¶
桌面端（DeepSeek Harness App）使用應用內插件面板。不要在終端執行 dsh --profile desktop，因爲該 profile 由 Electron 獨佔。
- 打開側欄 Plugins 面板，點擊 Add plugin。
- 輸入插件名
dsh-workbuddy-expert（或倉庫地址github:pbwheel/dsh-workbuddy-expert）。 - 安裝完成後重啓桌面 App（bundles 列表僅在啓動時讀取）。
典型用法¶
使用該插件需要先在 WorkBuddy 中“召喚”專家，插件才能掃描到它們。
- 安裝專家：在 DSH 設置 → WorkBuddy 專家頁面，點擊專家卡片右上角的“安裝”。
- 切換專家：在會話輸入框旁展開專家膠囊，選擇目標專家；或者在命令行使用
/expert列出專家，用/expert <name>切換。 - 新建會話：創建新會話時，也可以先選擇專家，創建即生效。
適用場景與注意¶
- 前置條件：需要 DSH 版本 >= 0.2.0-rc.2。
- 數據來源：插件不聯網，必須先在 WorkBuddy 桌面端專家中心點擊“召喚”，專家文件落盤後才能被插件掃描。
- Profile 區分：終端執行
dsh --profile desktop會報錯，請勿混淆。桌面端用戶需通過應用面板安裝。 - 配置：默認源目錄爲
~/.workbuddy/plugins/marketplaces/experts/plugins，可在設置頁面修改。支持配置roots追加發現根。
結尾¶
這個插件通過引入本地 WorkBuddy 專家目錄，降低了 DSH 中專家管理的門檻。它不僅提供了可視化的市場管理，還實現了會話級別的專家無縫切換，適合希望統一管理專家能力並提升開發效率的 DSH 用戶。
