前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在模型推理场景下，直接使用 OpenAI 或 xAI 的 API 需要管理 API Key。如果希望使用 ChatGPT 或 Grok 的官方能力，通常需要安装对应的官方 CLI 工具。
DSH Connect 插件通过适配器模式，将 ChatGPT 和 Grok 的官方 CLI 接入 DSH 生态。它不依赖 API Key，而是通过 OAuth 登录，利用官方进程完成模型推理和工具调用。
插件介绍¶
这是一个社区维护的 Cordis 插件，包含模型提供者适配器和 Web 设置面板。
- 核心价值：统一 DeepSeek Harness 与 ChatGPT、Grok 的模型目录，支持流式输出、动态工具调用和会话恢复。
- 提供者 ID：
- ChatGPT:
openai-codex - Grok:
xai-grok
- ChatGPT:
- 依赖要求：插件本身不扫描
node_modules，也不下载模型二进制文件。它依赖系统路径下已安装的官方 CLI 才能运行。
安装与启用¶
DSH 不会自动扫描 node_modules。一个插件要生效，必须同时满足两个条件：安装在 profile workspace 目录下，并在该 profile 的 package.json 中列出。
使用官方命令安装，它会自动处理上述两个步骤：
dsh plugin --profile web add @canary-builds/dsh-connect
如果 dsh plugin 命令不可用，需要手动执行以下两步：
- 进入 profile 目录：
cd ~/.dsh/profiles/web
- 安装包并修改
package.json：
npm install @canary-builds/dsh-connect
在 `package.json` 的 `dsh.profile.bundles` 数组中添加该包名：
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@canary-builds/dsh-connect"
]
}
}
安装完成后，重启对应 profile 的服务（例如 `systemctl --user restart dsh-web`）并刷新浏览器。
前置要求：官方 CLI¶
ChatGPT 和 Grok 都需要单独安装对应的官方 CLI，且必须以运行 DSH 的同一用户身份安装，否则无法执行。
| 提供者 | 二进制名称 | 安装时机 |
|---|---|---|
| ChatGPT | codex |
必须安装。若未安装，ChatGPT 登录会立即失败。 |
| Grok | grok |
必须安装。Grok 不依赖 Codex。 |
ChatGPT 的 codex 二进制可以通过 npm install -g @openai/codex 安装。安装后重启 DSH。
配置与环境¶
SSH 端口转发¶
ChatGPT 的 OAuth 回调地址固定为 127.0.0.1:1455。如果你在远程服务器上运行 DSH Web UI，必须配置 SSH 端口转发，否则无法完成登录：
ssh -N -o ExitOnForwardFailure=yes -L 3080:127.0.0.1:3080 -L 1455:127.0.0.1:1455 user@harness-host
Grok 的设备登录不需要端口转发，直接在设置页面输入设备代码即可。
环境变量与配置文件¶
插件支持通过环境变量或配置文件覆盖默认路径。
环境变量：
* DSH_CODEX_BIN: 指定 Codex 可执行文件的绝对路径。
* DSH_CODEX_HOME: 指定 Codex 的登录目录（默认 ~/.deepseek-harness/codex）。
* DSH_GROK_BIN: 指定 Grok 可执行文件的绝对路径。
* DSH_GROK_HOME: 指定 Grok 登录目录（默认 ~/.grok）。
配置文件：
默认路径为 ~/.dsh/connect.json。该文件用于存放路径配置，不要在此存放凭据。
{
"codexBin": "/absolute/path/to/codex",
"codexHome": "/absolute/path/to/codex-home",
"grokBin": "/absolute/path/to/grok",
"grokHome": "/absolute/path/to/grok-home",
"noProxy": "example.com"
}
诊断工具¶
使用 dsh-connect-doctor 命令检查环境配置是否正确。该命令位于 profile 的 node_modules/.bin 目录下。
权限与安全¶
- 工具执行权：Harness 拥有工具执行的最终权限。插件禁用了 Codex 的原生工具调用，转而通过 Harness 执行。
- Grok 限制：Grok 没有对 shell 或文件系统的访问权限。当 Grok 请求工具时，插件会将其返回给 Harness 处理，而不是在 Grok 进程中执行。
- 版本锁定：生产环境建议锁定版本，例如
@canary-builds/dsh-connect@0.4.0。
目录与链接¶
该插件已收录在社区目录：dhs-connect - SkillHub
