前言¶
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 或幻方无关。
