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 原生架构的完整性。