agy2dsh：把 Antigravity 與 ChatGPT 訂閱接入 DeepSeek Harness

前言¶

DeepSeek Harness（DSH）採用插件化架構，讓開發者按需擴展能力。但在現有生態中，若想使用 Google Antigravity（Gemini/Claude）和 ChatGPT Codex 的訂閱額度，需要分別對接各自的 API，配置繁瑣且難以統一管理。agy2dsh 插件通過 DSH 的 llm 服務接口，將這兩種消費級訂閱轉化爲可被 DSH Desktop 調用的普通 LLM 提供商，統一了認證、額度與調度。

插件定位¶

agy2dsh 是一個 DeepSeek Harness 插件，由維護者 wanzdoan 發佈，歸類爲「模型推理」類。它把已付費的 Antigravity（Gemini/Claude）和 ChatGPT Codex 賬號註冊到 DSH 的 llm 服務中，實現自動刷新 OAuth 令牌、請求輪轉、準確額度展示與圖片生成等能力，讓用戶直接從 DSH 桌面端消費現有訂閱，而無需購買額外 API 額度。

核心功能¶

1. 雙 LLM 提供商接入¶

Antigravity：從 fetchAvailableModels 獲取模型列表，過濾出計費模型族（claude-*、gemini-3.8-flash-{low,medium,high}），必要時回退到內置目錄。
Codex：使用目錄中公開的推理級別與上下文窗口信息，將 Codex 訂閱作爲 LLM 提供者。
兩者都註冊爲 DSH 的 llm 服務提供者，可被 DSH 桌面端統一調用。

2. 自刷新憑證與重試¶

每個賬號獨立管理憑證引用（如 ANTIGRAVITY_OAUTH_1、CODEX_OAUTH_2 等），支持代理、併發上限與標籤。
支持令牌刷新時的退避重試、時鐘偏移校正，以及令牌被拒絕時從 CLI 存儲重新讀取令牌。
Codex 賬號支持直接導入 ~/.codex/auth.json。

3. 賬號輪轉與限流策略¶

每個賬號被視爲一個「槽位」，支持輪轉（round-robin）、最少使用（least-used）或粘性（sticky）順序。
在遇到 HTTP 429 錯誤後，對特定模型族應用冷卻期，防止過度消耗同一賬號。
無效賬號進入隔離區，並通過預熱探針重新檢查可用性。

4. 準確的額度展示¶

Antigravity 每個賬號顯示四個窗口：Gemini 與 Claude 的周窗口與 5 小時窗口，以百分比與重置倒計時呈現。
狀態圓點根據 Gemini 5 小時窗口剩餘量變色：≥60% 綠色、20–60% 黃色、<20% 紅色。
Codex 顯示其 5 小時與 7 天窗口。
CLI 爲首選來源：通過 agy --print "/usage" 解析計費桶的剩餘分數與重置時間，緩存 5 分鐘；若 CLI 不可用或未登錄，則調用 Cloud Code 的 :retrieveUserQuotaSummary 與 :retrieveUserQuota 接口。
UI 中通過「Subscription Hub」展示每窗口剩餘比例與重置倒計時，會話頭部顯示狀態圓點與快捷跳轉。

5. 圖片生成與操作¶

generate_image：使用訂閱綁定的 Google 圖片模型生成圖片，並在對話中展示。
Codex 賬號可作爲主機的圖片生成服務提供者（subscriptionImages）。
支持在確認步驟後消費 Codex 重置額度。
插件保留請求歷史、診斷信息、僅限本地的儀表盤，以及可選的加密 vault（支持 WebDAV/Gist/S3）。

安裝與啓用¶

agy2dsh 以 profile-sourced bundle 形式安裝：DSH Desktop 會從活動 profile 的 manifest 組裝主機。需要在 profile 的 package.json 中添加依賴與 bundle 條目：

{
  "dependencies": { "agy2dsh": "github:wanzdoan/agy2dsh" },
  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "agy2dsh"] } }
}

添加後重新安裝 profile（profile 目錄是 pnpm workspace，DSH Desktop 會覆蓋安裝），並重啓 DSH Desktop。插件入口、路由與後臺定時器僅在啓動時加載，瀏覽器端代碼位於 lib/client.js，同樣需要重啓才能生效。

典型用法¶

1. 導入賬號¶

打開會話頭部的「Subscription Hub」或設置中的插件卡片，每個提供商一個標籤頁：

Antigravity：可通過「從 CLI 導入」讀取本地 Credential Manager 記錄與 ~/.gemini/account-vault/sessions/*.json，支持多賬號去重與複用已有槽位；或粘貼 OAuth 刷新令牌、手動 OAuth（需要 antigravityClientId 與 antigravityClientSecret）。
Codex：可通過「從 CLI 導入」讀取 ~/.codex/auth.json，或粘貼刷新令牌 / API 密鑰。

導入操作將憑證寫入 DSH 憑證存儲，不再修改 CLI 文件。導入後插件會自動刷新各賬號，無需再次運行 vendor CLI。

2. 調用模型¶

在 DSH 桌面端選擇 Antigravity 或 Codex 提供商，即可像使用其他 LLM 提供者一樣發起對話或函數調用。系統會根據所選策略在已註冊賬號間輪轉請求。

3. 查看額度¶

會話頭部顯示狀態圓點與快捷入口，點擊可打開 Subscription Hub，查看每個窗口剩餘比例、重置倒計時與賬號列表。Composer 界面也會顯示當前活動賬號的最低剩餘窗口。

適用場景與注意事項¶

適合已訂閱 Antigravity 或 ChatGPT Codex，希望統一通過 DSH 桌面端使用這些訂閱額度的用戶。
插件以 DSH Desktop 進程權限運行，安裝前建議閱讀源碼與 MIT 許可證。
Antigravity 需要安裝 agy CLI（路徑按 DSH_AGY_PATH、AGY_PATH、LOCALAPPDATA\agy\bin\agy.exe、APPDATA\agy\bin\agy.exe、USERPROFILE\AppData\Local\agy\bin\agy.exe 順序查找），CLI 必須登錄到要查看計費的賬號。
Codex CLI 可選，若存在則可導入 ~/.codex/auth.json。

小結¶

agy2dsh 把 Google Antigravity 與 ChatGPT Codex 的消費級訂閱直接接入 DeepSeek Harness，提供自動刷新 OAuth、多賬號輪轉、準確額度展示與圖片生成能力。通過統一的 DSH 接口，用戶可以在一個桌面端界面中管理多種訂閱，減少 API 額度購買成本。

插件目錄頁：https://www.skillhub.cn/plugins/wanzdoan/agy2dsh
GitHub 倉庫：https://github.com/wanzdoan/agy2dsh