前言¶

DeepSeek Harness (DSH) 是一个以插件为核心架构的系统。在构建复杂的智能体工作流时，开发者常需要接入外部服务或工具。OrgX 提供了 MCP 工具和工作日志访问能力，useorgx/orgx-deepseek-harness-plugin 就是用于将 OrgX 能力集成到 DSH 中的插件。

插件定位¶

这是一个开发者预览插件，旨在为 DeepSeek Harness profile 添加 OrgX MCP 工具，并提供一个运行在工作区内的 OrgX gateway peer。

• 名称：@useorgx/deepseek-harness-plugin
• 所有者：useorgx
• 许可证：MIT
• 核心价值：OrgX MCP 工具，Work Ledger 访问，以及 DeepSeek Harness 的 Sovereign Execution peer。

核心功能¶

该插件主要完成以下工作：

1. 集成 OrgX 工具：将 OrgX MCP 工具添加到 DeepSeek Harness 配置中。
2. 运行 Gateway Peer：通过 Harness 的 headless 模式运行一个绑定到工作区的 OrgX gateway peer。
3. 挂载客户端：挂载一个名为 orgx 的 dsh-mcp-client 实例，用于与 OrgX 服务通信。

安装与启用¶

推荐使用 OrgX 提供的向导进行安装和配置。

1. 运行 OrgX 向导初始化设置：

    npx @useorgx/wizard@latest setup

2. 通过向导触发一次 DeepSeek 任务，以刷新 OAuth Token 并确保 DSH 启动前凭证就绪：

    npx @useorgx/wizard@latest deepseek "List the OrgX tools available in this workspace."

对于高级用户，也可以直接安装插件包。DeepSeek Harness 版本需锁定在 0.1.0-rc.6，Node.js 版本需为 ^22.19.0 或 >=24.0.0。

dsh plugin --profile headless add @useorgx/deepseek-harness-plugin@0.1.0

典型用法¶

安装完成后，可以在 DSH headless profile 中调用 OrgX 工具或检查配置：

dsh --profile headless "List the OrgX tools available in this workspace."

检查当前挂载的配置：

dsh --profile headless --dump-config

注意事项与风险¶

由于这是开发者预览版本，使用时需注意以下具体限制和风险：

1. 状态验证：插件包的安装成功并不代表 OrgX 认证通过、网关准入成功或部署就绪。如果 MCP 连接或初始工具同步失败，DSH bundle 将无法启动。
2. 功能缺失：当前版本不支持通过此客户端访问 MCP Resources 和 Prompts。此外，非文本 MCP 块在模型端会有损投影（即使执行本地的结果保留了 JSON 块）。
3. 主机访问权限：Peer 将执行目录设置在 ORGX_WORKSPACE_ROOT 内。这构成了路径和变异边界，而非主机隔离。DSH 的 workspace-write 权限不限制同一用户的文件读取、进程可见性或网络访问。
   • 若需利用此能力，需设置环境变量 ORGX_DEEPSEEK_HOST_ACCESS_ACK=1，并在接受相关风险后手动设置。
4. 凭证范围：API Key 必须针对 gateway:drive 和 plugin:heartbeat 进行授权。
5. 认证机制：OAuth Token 必须是客户端管理的 OrgX OAuth 2.1 访问令牌（格式为 oxk_ 开头的 gateway key 不适用于托管 MCP）。

总结¶

该插件为 DeepSeek Harness 提供了接入 OrgX 生态的途径，允许在 Harness 中直接使用 OrgX 的 MCP 工具链和工作日志。鉴于其开发者预览属性及在主机访问权限上的特殊设计，开发者在使用前应仔细评估权限边界与功能缺失。

• GitHub 仓库
• 社区目录