前言¶
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 訂閱額度的開發者。
