前言¶
DeepSeek Harness（DSH）通過插件擴展能力。連接非 OpenAI 兼容模型通常需要適配器或直接 API 調用。dsh-cliproxy 通過一個本地 CLIProxyAPI 實例，將 Claude、OpenAI/Codex 和 Gemini 的請求統一路由到 DSH。它將協議和 OAuth 的複雜性移交給代理，爲 DSH 提供一個 OpenAI 兼容的客戶端。
核心功能¶
- 統一路由：通過一個本地 CLIProxyAPI 實例，在 DeepSeek Harness 中路由 Claude、OpenAI/Codex 和 Gemini。
- OpenAI 兼容接口：對 DSH 來說表現爲 OpenAI 客戶端。
- 模型透明：對底層模型透明，不添加工具、提示部分或上下文。
- 輸入限制：在請求發送前拒絕圖像、音頻和視頻輸入。
安裝與啓用¶
通過官方命令安裝插件：
dsh plugin --profile web add github:DevViking-Persike/dsh-cliproxy
安裝後重啓 DSH。三個路由（cliproxy-claude、cliproxy-openai、cliproxy-gemini）將出現在模型目錄中。
前置條件與配置¶
需要一個正在運行的 CLIProxyAPI 實例（默認端點 http://127.0.0.1:8317/v1）。對於 Gemini 路由，必須完成 -antigravity-login。
插件通過 cordis.yml 配置，沒有設置目錄條目。所有字段均爲可選。
| 字段 | 默認值 | 含義 |
|---|---|---|
baseURL |
http://127.0.0.1:8317/v1 |
端點，包括 /v1。 |
apiKeyEnv |
CLIPROXY_API_KEY |
代理訪問密鑰的環境變量。 |
proxyConfigPath |
/opt/homebrew/etc/cliproxyapi.conf |
本地 CLIProxyAPI YAML，用於讀取代理訪問密鑰。 |
readLocalProxyKey |
true |
允許僅針對迴環端點的本地配置發現。 |
claudeModels |
六個 Claude 條目 | cliproxy-claude 目錄。 |
openaiModels |
五個 GPT 條目 | cliproxy-openai 目錄。 |
geminiModels |
八個 Gemini 條目 | Antigravity 目錄 cliproxy-gemini。 |
streamIdleTimeoutMs |
300000 |
流讀取之間的預算。 |
defaultContextWindow |
200000 |
未列入目錄模型的上下文大小。 |
maxTokens |
32000 |
默認輸出上限。 |
retryPolicy |
正常，3 次重試 | 合併到 DSH 默認值中。 |
示例 cordis.yml 配置：
- id: dsh-cliproxy
name: dsh-cliproxy
config:
baseURL: http://127.0.0.1:8317/v1
geminiModels:
- id: gemini-pro-agent
name: Gemini 3.1 Pro High
contextWindow: 1048576
maxTokens: 65535
身份驗證與安全¶
對於 Gemini，CLIProxyAPI 處理 Google Antigravity OAuth。運行一次登錄命令以授權 Google 賬戶：
cliproxyapi -config /opt/homebrew/etc/cliproxyapi.conf -antigravity-login
CLIProxyAPI 將 antigravity-<email>.json 寫入其 auth-dir 並自行刷新令牌。插件從不讀取 Google 令牌。
代理訪問密鑰在每次請求時讀取，永不進入錯誤或日誌。本地配置發現僅針對迴環 URL 自動禁用。
行爲與限制¶
- 模型透明：插件註冊路由並流式傳輸響應，不添加工具或提示部分。
- 僅文本：目前拒絕圖像、音頻和視頻輸入（儘管上游模型可能支持）。
- 靜態目錄：模型目錄是靜態默認值，從 CLIProxyAPI 的 Antigravity 註冊表複製。提供
geminiModels可覆蓋默認值。 - 流處理：截斷的流引發
STREAM_CLOSED，而不是將其視爲完整。 - 測試：64 個測試，無需網絡或憑證。
許可證與鏈接¶
本插件由 DevViking-Persike 維護，使用 MIT 許可證。源代碼位於 GitHub：https://github.com/DevViking-Persike/dsh-cliproxy。
生態背景：DSH 理念是「一切皆插件」。此插件通過社區目錄 https://www.skillhub.cn/plugins/DevViking-Persike/dsh-cliproxy 發佈，與 DeepSeek 或幻方無關。
