前言¶

DeepSeek Harness (DSH) 通過插件系統實現功能擴展。在構建智能體應用時，爲不同領域配置專家角色通常需要維護獨立的 skill 配置或編寫大量模型調用邏輯。上游 agency-agents-zh 項目提供了 268 個針對中文場景優化的專家角色，覆蓋 20 個部門，但這些資源尚未直接集成到 DSH 的技能註冊表中。該插件旨在解決這一集成問題，將上游資源封裝爲 DSH bundle 插件，使這些專家角色能夠以原生 dsh skill 的形式被調用。

插件簡介¶

該插件將 agency-agents-zh（268 箇中文 AI 專家角色，覆蓋 20 個部門）封裝爲 DeepSeek Harness (dsh) 的 bundle 插件。

• 維護者：RHY006
• 許可協議：MIT
• 核心能力：
  • 封裝上游角色庫爲 DSH bundle 插件。
  • 將 268 位專家註冊爲原生 dsh skill。
  • 支持模型對話中的自動匹配和手動觸發。
  • 支持按部門進行白名單/黑名單過濾。
  • 支持限制註冊的最大技能數量。

安裝與啓用¶

安裝前請確保已安裝 git（通過 github: 安裝依賴 pnpm 調用 git 拉取倉庫）。

使用官方命令安裝插件：

dsh plugin --profile web add "github:RHY006/agency-agents-zh-dsh-plugin"

安裝完成後，必須重啓 dsh 才能使插件生效。重啓後，可以通過查詢可用技能來確認專家角色已註冊。

使用方式¶

插件安裝後，專家角色以原生 skill 形式存在於註冊表中。技能名稱遵循 kebab-case 命名規範，格式取自文件 stem。

手動觸發¶

在對話中直接輸入斜槓命令即可觸發特定專家：

• /engineering-frontend-developer：前端開發者
• /marketing-xiaohongshu-operator：小紅書運營專家
• /engineering-security-engineer：安全工程師

自動匹配¶

在對話中描述需求，模型會根據專家的 description 自動匹配並加載對應的專家角色。

配置過濾¶

默認情況下，插件會註冊全部 268 個專家。如果希望減少註冊數量，可以在 profile 的 cordis.patch.yml 中爲該 loader 行添加 config 過濾參數：

- id: agency-agents-zh
  config:
    categories: [engineering, marketing, design]   # 部門白名單：只註冊這些
    excludeCategories: [specialized]               # 部門黑名單：剔除這些（優先於白名單）
    maxSkills: 60                                  # 總量上限：超出按列表順序截斷並告警

• 白名單與黑名單：三者均可選且可組合。不配置則註冊全部（向後兼容）。
• 類型錯誤處理：cordis.patch.yml 中類型寫錯會導致 dsh 啓動即報錯。
• 部門對照：插件內置了部門目錄名與部門的映射關係，支持過濾。

注意事項¶

1. Git 依賴：必須安裝 git 才能通過 github: 方式安裝插件。
2. 重啓生效：安裝後必須重啓 dsh 進程才能加載新註冊的技能。
3. 版權歸屬：角色內容版權歸上游 agency-agents 及 agency-agents-zh 所有，本插件僅做封裝分發。
4. 錯誤提示：配置文件中的類型拼寫錯誤或部門名不存在會被拒絕並告警。

結語¶

該插件爲 DSH 用戶提供了快速接入大量中文領域專家角色的能力。通過配置過濾機制，用戶可以根據實際需求控制技能規模。更多細節可參考 插件目錄頁 或 GitHub 倉庫。