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。随后三条路由都会出现在模型目录中。

Gemini / Antigravity 登录

CLIProxyAPI 7.x 已实现公开的 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；本地密钥绝不会被隐式发送到远程端点。

配置

每个字段都是可选的。

| 字段 | 默认值 | 含义 |
|---|---|---|
| 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 | normal，3 次重试 | 在 harness 兼容默认值之上合并。 |

- 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

为什么由代理负责 Antigravity

直接客户端远不止一个 OAuth bearer token。上游线路要求：

- Google OAuth scopes 以及已注册的 Antigravity 公共客户端；
- 通过 loadCodeAssist 进行项目发现/引导；
- daily-cloudcode-pa.googleapis.com / cloudcode-pa.googleapis.com 路由；
- antigravity/hub/ user agent 以及 HTTP/1.1 指纹；
- 嵌套在 Antigravity envelope 中的 Gemini body，包含 project、request 和 session id；
- tool-schema 清理、加密推理重放、模型特定的输出上限以及 token 刷新。

CLIProxyAPI 已经拥有并测试了这些事实。在此处重复它们会产生两个 token 写入者，以及第二个独立漂移的协议实现。因此，此插件将 OpenAI 兼容的流式请求发送到 loopback 代理，并且从不复制 Google 的 client secret 或账户 token。

模型体验

该适配器对模型是透明的：它注册 provider 路由并流式传输响应，不添加任何 tool、prompt section 或 context。使用量计数是不相交的——inputTokens 不包含已计入 prompt_tokens 内的 cache reads。

仅文本。Image、audio 和 video 会在发送请求之前被拒绝，尽管某些 Antigravity 模型在上游支持它们；此适配器的 serializer 尚未保留这些输入。

安全性

- Google access/refresh token 完全保留在 CLIProxyAPI 的 auth-dir 内。
- 代理访问密钥按请求读取，绝不会进入错误或日志。对于非 loopback 目标，本地配置发现会自动禁用。
- 截断的流会抛出 STREAM_CLOSED，而不是看起来完整。
- retry-after 会到达 harness retry 插件；idle timeout 衡量的是服务器静默，而不是慢消费者。
- Chunk 字段在加载时会根据固定 payload 进行检查，因此 harness 协议漂移会拒绝挂载，而不是静默损坏 tool calls。

已知限制

- 模型目录是从 CLIProxyAPI 的 Antigravity registry 复制的静态默认值；未编目的模型在显式命名时仍可解析。提供 geminiModels 会替换默认值。
- 尚无 image/audio/video 序列化。
- 该插件没有 settings-directory 条目；它通过 cordis.yml 配置。
- 测试使用本地 HTTP 服务器以及记录的 harness translator/serializer 输出。真实 OAuth 和模型可用性仍由供应商控制。

测试

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

64 个测试，无需网络，也无需凭据。

许可证

MIT — 参见 LICENSE 和 NOTICE.md。