前言¶
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
