dsh-experts:DeepSeek Harness 专家目录插件

DSH (DeepSeek Harness) 采用“一切皆插件”的理念,但在原生设计中并不包含“专家”或“专家组”的概念。社区维护了一个名为“Awesome DSH Experts”的目录,但目录本身与 Web UI 相分离。下面介绍 dsh-experts,这是一个树外插件,旨在将这个社区目录带入 DeepSeek Harness 的 Web UI 中,无需对 deepseek-harness 源码进行任何修改。

核心功能

该插件通过注册到 settings.section 槽位,在 Web UI 的设置页面提供了一个“专家市场”选项卡,并提供了可选的聊天输入栏入口。

  1. 设置选项卡浏览与复制
    在 Web UI 的设置页面中打开“专家市场”选项卡。这里可以浏览专家和专家组,按类别或类型筛选,查看详情,并点击“Add to chat”按钮,将准备好的 @expert <id> 调用块复制到剪贴板。

  2. 作曲家入口
    这是一个可选功能,旨在将已安装的专家组注入到聊天输入框中。点击按钮会弹出一个选择器,允许选择并复制专家组的调用块。该入口注册在 DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT 配置项指定的槽位上。

  3. HTTP API
    插件提供了一个同源 HTTP API (POST /api/expert-marketplace),支持 bootstrap、list、detail、groups、refresh、packs 和 packDetail 等方法,用于程序化浏览目录。

  4. 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 配置文件后,操作步骤如下:

  1. 打开 Settings(设置)页面,进入 Expert Marketplace(专家市场)选项卡。
  2. 在列表中搜索或按分类/类型过滤专家或专家组。
  3. 点击某个条目打开详情,然后点击 Add to chat 按钮。
  4. 将复制到剪贴板的 @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

安全与数据来源

  1. 网络行为:浏览器端不会直接联系 GitHub。插件的主机进程(Node)会从指定的 catalogUrl(默认为 SkillHub 上的目录)获取预构建的 catalog.json。浏览器仅调用同源 API (/api/expert-marketplace)。
  2. 数据存储:目录数据缓存在内存中,系统临时目录 (<tmpdir>/dsh-experts/catalog.json) 作为辅助缓存,且包含一个内置的 catalog-seed.json 作为离线备用源。不读写个人文件。
  3. 信任与验证:远程目录被视为不受信任的输入,所有条目均经过架构验证,且不执行代码,仅在 UI 中展示可读文本和可复制的调用块提示。
  4. 权限:插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证。

注意事项

  • 版本要求:必须使用 DSH 0.1.0-rc.6 及以上版本。
  • 静默降级:Composer 入口在较旧的 DSH 版本中会静默失效,Settings 选项卡是始终可用的核心功能。
  • 无机密传输:插件不包含任何凭证,不向外部传输用户数据。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜