DSH (DeepSeek Harness) 采用“一切皆插件”的理念,但在原生设计中并不包含“专家”或“专家组”的概念。社区维护了一个名为“Awesome DSH Experts”的目录,但目录本身与 Web UI 相分离。下面介绍 dsh-experts,这是一个树外插件,旨在将这个社区目录带入 DeepSeek Harness 的 Web UI 中,无需对 deepseek-harness 源码进行任何修改。
核心功能¶
该插件通过注册到 settings.section 槽位,在 Web UI 的设置页面提供了一个“专家市场”选项卡,并提供了可选的聊天输入栏入口。
-
设置选项卡浏览与复制
在 Web UI 的设置页面中打开“专家市场”选项卡。这里可以浏览专家和专家组,按类别或类型筛选,查看详情,并点击“Add to chat”按钮,将准备好的@expert <id>调用块复制到剪贴板。 -
作曲家入口
这是一个可选功能,旨在将已安装的专家组注入到聊天输入框中。点击按钮会弹出一个选择器,允许选择并复制专家组的调用块。该入口注册在DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT配置项指定的槽位上。 -
HTTP API
插件提供了一个同源 HTTP API (POST /api/expert-marketplace),支持bootstrap、list、detail、groups、refresh、packs和packDetail等方法,用于程序化浏览目录。 -
Agent 工具
插件注册了expert_list和expert_detail工具,供 Agent 使用。这些工具的可用性取决于@deepseek-ai/dsh-tools包是否存在。
安装与启用¶
安装插件需要使用 Web 配置文件,并确保 DSH 版本满足要求。
dsh plugin --profile web add https://github.com/fuchao2pku/dsh-experts.git
安装完成后,需要重启 Web 配置文件以加载插件:
dsh --profile web web
典型用法¶
安装并重启 Web 配置文件后,操作步骤如下:
- 打开 Settings(设置)页面,进入 Expert Marketplace(专家市场)选项卡。
- 在列表中搜索或按分类/类型过滤专家或专家组。
- 点击某个条目打开详情,然后点击 Add to chat 按钮。
- 将复制到剪贴板的
@expert <id>代码块粘贴到聊天输入框中。
示例:在聊天输入框中粘贴 @software-team,随后输入功能需求,即可在对话中调用包含产品经理、架构师、工程师和 QA 的多角色软件团队。
配置与兼容性¶
该插件依赖 DSH 0.1.0-rc.6 版本及 Web 配置文件 (dsh.client.platform: "web")。在旧版本中,作曲家入口会静默降级,Settings 选项卡仍可正常工作。
所有配置项均可通过 cordis.patch.yml 或环境变量覆盖,默认值如下:
| 配置项 | 环境变量覆盖 | 默认值 |
|---|---|---|
catalogUrl |
DSH_EXPERT_MARKETPLACE_CATALOG_URL |
发布的 catalog.json (来自配套仓库 awesome-dsh-experts) |
maxAgeMs |
- | 172800000 (48小时) |
timeoutMs |
- | 15000 (15秒) |
maxBytes |
- | 5000000 (5MB) |
composerSlot |
DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT |
composer.toolbar (设置为空字符串可禁用) |
composerIntegration |
- | true |
agentTools |
- | true |
安全与数据来源¶
- 网络行为:浏览器端不会直接联系 GitHub。插件的主机进程(Node)会从指定的
catalogUrl(默认为 SkillHub 上的目录)获取预构建的catalog.json。浏览器仅调用同源 API (/api/expert-marketplace)。 - 数据存储:目录数据缓存在内存中,系统临时目录 (
<tmpdir>/dsh-experts/catalog.json) 作为辅助缓存,且包含一个内置的catalog-seed.json作为离线备用源。不读写个人文件。 - 信任与验证:远程目录被视为不受信任的输入,所有条目均经过架构验证,且不执行代码,仅在 UI 中展示可读文本和可复制的调用块提示。
- 权限:插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证。
注意事项¶
- 版本要求:必须使用 DSH 0.1.0-rc.6 及以上版本。
- 静默降级:Composer 入口在较旧的 DSH 版本中会静默失效,Settings 选项卡是始终可用的核心功能。
- 无机密传输:插件不包含任何凭证,不向外部传输用户数据。