前言¶

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 仓库。