前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。对于拥有 Google AI 订阅（Antigravity / Code Assist）的用户，直接将其接入 DSH 需要一个中间层，将 Google 的 OAuth 认证流程转换为 DSH 可识别的 OpenAI 兼容端点。dsh-gemini-oauth-bridge 插件旨在解决这一需求，让 DSH 能够直接调用 Google 订阅额度，而非消耗 Google 的 API 信用点数。
插件介绍¶
名称：dsh-gemini-oauth-bridge
维护者：hyqhyq3
类别：联网工具
许可证：MIT
核心功能¶
该插件提供以下能力：
* 一键登录与注册：在 DSH 设置中点击登录，完成 Google OAuth 流程，自动注册并发现上游模型。
* OpenAI 兼容端点：提供 /v1/chat/completions（支持流式 SSE 和非流式）以及 /v1/models 接口，供 DSH 调用。
* 协议翻译：支持 system messages、多模态 data-URL 图片、function calling 以及 reasoning_content 等协议细节。
* 签名重放机制：针对 Gemini 3 思考模式，重放 thoughtSignature 以支持多轮工具调用。
* 订阅优化：动态 User-Agent、requestType=agent、Keep-Alive 连接，适配 Google 订阅接口。
* 限流处理：自动解析 429 状态码与 Retry-After 头，进入冷却窗口，防止频繁请求。
* Token 刷新：自动刷新 Token，并发请求共享刷新过程。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add github:hyqhyq3/dsh-gemini-oauth-bridge
安装完成后重启 DSH，在设置中点击“登录 Google 账号”并完成浏览器中的 OAuth 流程。
配置与使用¶
登录成功后，在 ~/.dsh/settings.yaml 中注册 gemini-oauth 提供者。DSH 通常会在登录时自动写入配置，但手动配置时需确保 baseURL 与你的 DSH Web 端口一致（默认为 3080）。
llm-pi-ai:
providers:
gemini-oauth:
api: openai-completions
baseURL: http://127.0.0.1:3080/gemini-oauth-bridge/v1
apiKeyEnv: GEMINI_OAUTH_API_KEY
models:
- id: gemini-3.1-pro-high
- id: gemini-3.7-flash-high
重启 DSH 后，在模型选择器中选取对应的模型即可。
注意事项¶
- 非官方使用：该插件依赖 Antigravity 的公开 OAuth 凭据和非公开
v1internal接口，非 Google 官方支持。存在接口失效或账号风险的可能性。 - 单账号限制：仅支持单账号，不支持账号轮转。
- 图片支持：仅支持 data-URL 格式的图片，不支持 http(s):// 格式的图片 URL。
- 端口冲突：登录回调占用
127.0.0.1:51121。如果 Antigravity 桌面应用同时登录，可能会发生冲突。 - 通道与缓存：生成请求默认走
daily-cloudcode-pa通道，签名缓存最多保留 800 条。
结语¶
该插件为 DSH 用户提供了使用 Google 订阅的另一种途径。它通过 OpenAI 兼容协议桥接了 Google 的 OAuth 认证，适合需要在本地或私有环境中使用 Google 订阅额度的开发者。
