staff-os/dsh-workbench: DeepSeek Harness 企业级工作台插件

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在开发和运行 DSH 时，往往需要同时管理 AI 员工、知识库、技能、MCP 服务器以及插件本身。staff-os/dsh-workbench 提供了一个集中的工作台，将这五个领域纳入统一的管理界面。

这是什么¶

这是一个 DeepSeek Harness 的企业级工作台插件，由 staff-os 维护，采用 MIT 许可证。它不依赖外部后端或数据库，所有状态以本地文件形式存储在 $DSH_HOME 目录下，可独立运行。

核心功能¶

该插件通过 ctx.tools 挂载点提供五个领域的工具：

技能管理
- 本地技能直接以目录形式管理，每个目录包含 SKILL.md。
- 支持从市场安装技能，安装后需重启 DSH 才能生效。
- 提供安全扫描功能，基于正则规则和字符集检测，防止潜在风险。
AI 员工
- 管理代理预设（Agent Presets），支持通过复制现有预设创建新员工。
- system 级信任的预设不可编辑或删除。
- 知识库绑定仅作为声明，不自动触发检索。
知识库
- 支持本地分块与 BM25 关键词检索，不依赖向量模型。
MCP 服务器
- 配置写入当前 profile 的补丁文件中。
- 使用 import_json 接口，将环境变量引用（如 ${VAR}）转换为 JS 执行表达式（!!js process.env.VAR）。
- 配置更改需在下次 DSH 启动后生效。
DSH 插件
- 将操作转发至 dsh plugin CLI。
- 不涉及 pnpm 或直接修改 dsh.profile.bundles，通过列表判断插件是否生效。

安装与启用¶

在终端中执行以下命令即可安装：

dsh plugin --profile web add @staff-os/dsh-workbench

如果进行本地开发，可使用绝对路径链接：

dsh plugin --profile web add link:/path/to/dsh-workbench

安装完成后需重启 DSH。

配置¶

插件通过环境变量和补丁文件进行配置。

环境变量¶

在 $DSH_HOME/.env 或调用 dsh 的同级目录 .env 中配置：

DSH_PROFILE：指定 MCP 和插件管理的 profile，默认为 web。
CLAWHUB_REGISTRY：ClawHub 兼容市场的根 URL，未设置则使用内置的公开端点。
CLAWHUB_API_KEY：市场凭证，仅作为引用名称，实际值由凭证服务或启动环境解析，不会内联写入配置。

补丁层配置¶

编辑 profile 自身的补丁文件 $DSH_HOME/profiles/<name>/cordis.patch.yml。配置项需完全重写（非深度合并）：

- id: workbench
  config:
    profile: web
    dshHome: ''
    registries:
      - id: skillhub
        name: Intranet skills
        url: http://10.0.14.55
        flavor: clawhub
        apiKeyEnv: SKILLHUB_REGISTRY_API_KEY
    registryTimeoutMs: 15000
    toolTimeoutMs: 20000
    networkToolTimeoutMs: 120000
    dshExecutable: dsh
    pluginToolTimeoutMs: 300000

flavor 选项决定市场接口风格：clawhub（默认）或 skillhub。

市场源管理¶

技能市场源可在 UI 中增删，配置写入 $DSH_HOME/workbench/market.json，实时生效。

运行与注意¶

环境要求：需要 Node.js ^22.19.0 || >=24.0.0。
破坏性操作：删除或覆盖等操作需在工具参数中显式设置 confirm: true，否则操作会被拒绝。
状态同步：技能写入后立即同步，MCP 服务器变更需重启。

适用场景¶

该插件适合需要在 DeepSeek Harness 中统一管理 AI 员工、知识库、技能、MCP 服务器及插件的用户。它提供了从 CLI 到 UI 的完整管理闭环，所有数据均为本地状态。

参考资料¶

插件目录：https://www.skillhub.cn/plugins/staff-os/dsh-workbench
源代码：https://github.com/staff-os/dsh-workbench