DeepSeek Harness 插件介紹：dsh-rolehub-bridge

前言¶

DeepSeek Harness（DSH）採用插件化架構，旨在通過組合不同的能力來構建智能體系統。在具體開發中，管理可移植的智能體角色、驗證角色的來源與完整性、以及在保持當前對話上下文獨立性的前提下啓動特定角色，是常見需求。

dsh-rolehub-bridge 是 DeepSeek Harness 與 RoleHub 之間的原生兼容層。它負責從 Host 配置的 Hubs 中發現角色，驗證並鎖定確切的包摘要，計算 Host 所有的有效策略，並創建一個獨立的、角色作用域的子會話。

核心功能¶

該插件通過 Host 命令和原生 UI 提供以下能力：

Hub 發現與驗證：支持 Hub 發現、目錄驗證和有界下載。
完整性校驗：對清單、壓縮包或 Bundle 執行精確的摘要驗證。
策略與綁定：計算有效的能力策略，並建立固定的 Host 工具綁定。
會話管理：創建一個新的可繼續、角色作用域的子會話。
集成能力：通過 Room 的公共 Host API 可選地附加會話。
原生控件：提供原生 DSH 控件和只讀快照。

安裝與啓用¶

安裝前，請確保環境滿足以下要求：

Node.js 版本 ^22.19.0 || >=24
DeepSeek Harness 版本 0.1.0-rc.6

執行以下命令安裝插件：

dsh plugin --profile web add github:ishuowang/dsh-rolehub-bridge#v0.2.0
dsh web

安裝後，插件會向當前配置的 profile 添加 Host 運行時、/rolehub 命令、只讀原生 API 以及 Web 客戶端。

若需將創建的角色會話附加到 Room，可在同一 profile 下安裝 Room 插件：

dsh plugin --profile web add github:ishuowang/dsh-agent-team-room#v0.6.0

注意：該包目前尚未發佈到 npm，官方支持通過上述 GitHub 鏈接直接安裝。

典型用法¶

安裝完成後，可以通過 Host 命令或原生 UI 進行操作。

刷新與檢查¶

首先刷新配置的 Hubs 以獲取最新目錄：

/rolehub refresh

檢查特定角色的詳細信息：

/rolehub inspect official/software-engineer

啓動角色¶

啓動一個角色會話，並指定初始提示詞：

/rolehub start official/software-engineer --label "Software engineer" --prompt "Review the current implementation."

如果已安裝 Room 插件，可以在啓動時直接指定 Room ID 進行附加：

/rolehub start official/software-engineer --room <room-id> --label "Implementation reviewer"

列表與會話¶

查看 Host 配置的 Hub 列表或已安裝的角色列表：

/rolehub hubs
/rolehub list

查看當前父會話的持久化角色綁定：

/rolehub sessions

配置¶

安裝後，插件會在 profile 的 cordis.patch.yml 中插入 rolehub-bridge 配置項。當默認配置不能滿足需求時，可以手動編輯：

- id: rolehub-bridge
  name: dsh-rolehub-bridge
  config:
    storageDir: /srv/dsh/rolehub-bridge
    allowCommunityRoles: false
    allowedCapabilities:
      - filesystem.read
      - filesystem.write
      - network.fetch
      - web.search
      - source-control.read
      - room.message
    fetchTimeoutMs: 15000

注意事項¶

能力集限制：可執行的能力集嚴格限於 required role requests ∩ bridge support ∩ Host allowlist。這比角色請求的意圖更窄。
可選能力：任何可選能力都不會自動授予。如果缺少必需能力，系統將失敗並關閉。
Room 關係：Agent Team Room 是會話結果的可選目的地，而非依賴項，也不是角色權威的來源。
無內置內容：插件不包含內置的公司團隊、人設或 Room 場景。角色僅來自 RoleHub，且僅當用戶明確選擇時纔會出現。
變更機制：所有變更（如安裝角色）僅通過 Agent 作用域的 Host 命令提供。插件故意不提供面向模型（model-facing）的“安裝角色”或“啓動角色”工具。
瀏覽器快照：瀏覽器快照暴露了 Hub ID、公共角色元數據、摘要、能力標籤和有界 Room 摘要。它省略了目錄/歸檔 URL、本地路徑、存儲的策略收據、提供者綁定、轉錄和私有 Room 數據。

總結¶

dsh-rolehub-bridge 通過原生 UI 和 Host 命令，爲 DeepSeek Harness 提供了與 RoleHub 的安全對接能力。它通過嚴格的校驗和驗證和 Host 策略計算，確保了角色加載的安全性，同時保持了 DSH 原生架構的完整性。