CLI 订阅路由 DevViking-Persike/dsh-cliproxy

dsh-cliproxy

在 DeepSeek Harness 中，通过一个本地 CLIProxyAPI 实例，将 Claude、OpenAI/Codex 以及 Gemini 经由 Antigravity OAuth 进行路由。

Gemini 路由使用你的 Google/Antigravity 账户——而非 Gemini API 密钥。CLIProxyAPI 负责浏览器登录、刷新令牌、Google 项目、原生请求指纹以及转换；本插件是其兼容 OpenAI 的 DSH 客户端。

| DSH 提供商 | 由 CLIProxyAPI 持有的认证 |
| cliproxy-claude | Claude Code 订阅 |
| cliproxy-openai | Codex/OpenAI 订阅 |
| cliproxy-gemini | Google Antigravity OAuth |

安装

dsh plugin --profile web add github:DevViking-Persike/dsh-cliproxy

重启 DSH。当 Harness 请求其模型目录时，已启用的路由会查询 /v1/models，因此只会出现你的代理当前暴露的模型。安装插件不会执行 OAuth 登录。

当 Claude 和 Codex 已由 dsh-subscriptions 提供时，此处仅启用 routes: [gemini]，以避免为相同的模型系列呈现替代的代理路由。

Gemini / AGY (Antigravity) 登录

CLIProxyAPI 负责 Antigravity OAuth 登录。运行一次：

cliproxyapi -config /opt/homebrew/etc/cliproxyapi.conf -antigravity-login

在浏览器中授权 Google 账户。CLIProxyAPI 会在其配置的 auth-dir（通常为 ~/.cli-proxy-api）下写入 antigravity-.json，并自行刷新。本 DSH 插件从不读取 Google 访问令牌或刷新令牌。

下面提到的密钥仅是 DSH 与 127.0.0.1:8317 之间本地代理的访问控制；它不是 Gemini API 密钥。对于回环端点，插件默认从本地 CLIProxyAPI 配置中读取第一个 api-keys 条目，因此无需环境变量，且密钥永远不会被显示。

要求

- 一个正在运行的 CLIProxyAPI 实例；默认端点 http://127.0.0.1:8317/v1。
- 对于 Gemini，需完成 -antigravity-login。
- 在 harness 凭据存储 / CLIPROXY_API_KEY 中提供代理访问密钥，或提供可读取的本地代理配置。本地配置发现仅允许用于回环 URL；本地密钥绝不会被隐式发送到远程端点。

配置

每个字段都是可选的。

| 字段 | 默认值 | 含义 |
| routes | [claude, openai, gemini] | 要注册的提供商系列。与 dsh-subscriptions 一起使用时用 [gemini]。 |
| discoverModels | true | 查询已认证的 /v1/models 端点以获取可用模型 id。设为 false 以使用显式管理的离线目录。 |
| modelDiscoveryTimeoutMs | 10000 | 每次目录请求的截止时间。 |
| 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 条目 | cliproxy-gemini 的 Antigravity 目录。 |
| streamIdleTimeoutMs | 300000 | 流读取之间的时间预算。 |
| defaultContextWindow | 200000 | 未编目模型所假定的上下文。 |
| maxTokens | 32000 | 默认输出上限。 |
| retryPolicy | 正常，3 次重试 | 合并到与 harness 兼容的默认值之上。 |

- id: dsh-cliproxy
name: dsh-cliproxy
config:
baseURL: http://127.0.0.1:8317/v1
routes: [gemini]
geminiModels:
- id: gemini-pro-agent
name: Gemini 3.1 Pro High
contextWindow: 1048576
maxTokens: 65535
inputModalities: [text, image]

发现与路由

代理的 OpenAI 模型端点 会公开可用的 id，而非上下文窗口或图像能力。此插件会为已知 id 附加已配置的元数据。带有路由的 claude-、gpt- 或 gemini- 前缀的新 id 会以纯文本形式出现，并使用配置的默认上下文和输出限制。自定义别名必须列在相应的模型目录中。显式目录会将发现限制为其列出的 id；它不会公布代理响应中不存在的已配置模型。目录错误会保持可见，不会静默回退到可能不可用的模型。

Gemini 路由标识的是模型系列，而非经过身份验证的 Google 账户。CLIProxyAPI 会选择后端和账户；如果预期的凭据来源是 Antigravity，请将其配置为通过 Antigravity 提供 Gemini 服务。账户资格和配额仍由 Google 控制。此插件不捆绑任何 Google OAuth 客户端密钥、访问令牌或刷新令牌。使用该插件时，现有的 Claude/Codex 身份验证仍保留在 dsh-subscriptions 中。

将 Gemini 固定到 Antigravity

routes: [gemini] 选择的是 Harness 模型系列；它不会选择后端账户。如果代理还通过其他提供商提供 Gemini 服务，请在其 Antigravity OAuth 通道下创建一个唯一别名，如 CLIProxyAPI 配置 所支持的那样：

CLIProxyAPI configuration, not cordis.yml:
oauth-model-alias:
antigravity:
- name: gemini-pro-agent
alias: agy-gemini-pro
fork: true

然后仅在 Harness 插件配置中选择该别名：

routes: [gemini]
geminiModels:
- id: agy-gemini-pro
name: Gemini Pro (AGY / Antigravity)
contextWindow: 1048576
maxTokens: 65535
inputModalities: [text, image]

在所有代理提供方中，保持该别名专属于 Antigravity。模型 ID 和限制必须与你的安装实际暴露的上游模型一致。只有在 CLIProxyAPI 暴露该别名后，发现机制才会列出它。此配置是运维示例；安装此插件不会重写你的代理配置或发起登录。

模型体验

该适配器对模型是透明的：它注册提供方路由并流式传输响应，不添加任何工具、提示词片段或上下文。用量计数互不重叠——inputTokens 不包含已计入 prompt_tokens 内的缓存读取。

对于声明具备图像能力的目录条目，支持文本和图像输入。图像通过 Harness 附件服务解析，并序列化为数据 URL。未知模型默认仅支持文本；音频和视频会被拒绝。

该适配器实现 prepareCall() 时不读取凭据，也不查询目录。调度会保留已准备好的适配器，仅在流开始时读取代理访问密钥。图像请求的定价未指定，因此 Harness 使用其中性估算值。

安全性

- Google 访问令牌/刷新令牌完全保留在 CLIProxyAPI 的 auth-dir 内。
- 代理访问密钥按请求读取，绝不会进入错误信息或日志。对于非回环目标，本地配置发现会自动禁用。
- 被截断的流会抛出 STREAM_CLOSED，而不会看起来像是完整结束。
- retry-after 会传递给 harness 重试插件；空闲超时衡量的是服务器静默时间，而绝不是慢速消费者。
- 分块字段在加载时会根据此适配器预期的载荷词汇表进行检查。此自检不会协商已安装的 Harness 版本；兼容性还必须针对目标 Harness 进行验证。

已知限制

- 发现机制反映的是请求时的代理目录；可用性可能在调度前发生变化。未编入目录的模型在被显式命名时仍可解析，并使用默认限制和仅文本输入。
- 不支持音频/视频序列化。图像支持同时需要已配置的模型能力和 Harness 附件服务。
- 该插件没有设置目录条目；它通过 cordis.yml 配置。
- 测试使用本地 HTTP 服务器以及录制的 harness 转换器/序列化器输出。真实 OAuth 和模型可用性仍由供应商控制。

测试

npm install && node --test test/*.test.js

该测试套件使用临时回环 HTTP 服务器；不需要提供方凭据或供应商网络访问。发现测试覆盖账户可见 ID、已配置别名、路由选择、认证错误、取消以及已准备调度。

许可证

MIT — 参见 LICENSE 和 NOTICE.md。