前言¶
DeepSeek Harness（DSH）的思路是「一切皆插件」。在 DSH 中接入 Google Antigravity（agy）時，常見工作包括 OAuth 登錄、多賬號管理、限流後的賬號輪換、設備指紋和代理設置。dsh-agy 把這些能力封裝爲插件，提供 Web 和 CLI 兩種管理方式。
下面按安裝、用法和注意事項介紹。
這是什麼¶
dsh-agy 是 chaos-03x 維護的 Google Antigravity（agy）DeepSeek Harness 插件，許可證爲 MIT。它提供 OAuth 認證、多賬號池、429 輪換、設備指紋，並支持 CLI 與 Web 管理。
核心功能¶
- OAuth 登錄：支持瀏覽器回調、headless 粘貼 URL 和 credential blob 通道。
- Web 與 CLI：兩種管理界面，核心功能一致。
- 多賬號池：加密賬號存儲、用量感知選擇、限流自動輪換、按賬號冷卻和按賬號設備指紋。
- DSH Web 運行時：可在
/agy面板做登錄、賬號管理、按模型配額、模型測試、憑據導入導出和指紋管理。 - CLI：可在有或沒有 harness 的獨立環境運行。
- 代理：每個賬號可單獨配置代理。
- 環境變量：可禁用插件、切換指紋模式、設置後臺健康檢查間隔。
安裝與啓用¶
Web 方式¶
先安裝插件到 DSH 的 web profile：
dsh plugin --profile web add dsh-agy
再啓動 DSH Web：
dsh web
打開 /agy 面板：
http://127.0.0.1:3080/agy
點擊 “Login with Google”，完成 OAuth 授權。
CLI 方式¶
如果不需要全局安裝，可以直接運行：
npx dsh-agy login
npx dsh-agy status
也可以全局安裝：
npm install -g dsh-agy
之後使用：
dsh-agy login
dsh-agy status
dsh-agy verify
dsh-agy health
dsh-agy import <file>
dsh-agy logout
典型用法¶
賬號代理¶
每個賬號可以單獨配置代理：
dsh-agy proxy set --index 0 --proxy <url>
dsh-agy proxy clear --index 0
dsh-agy proxy test --index 0
per-account proxy 會忽略 NO_PROXY。代理不可達時會跳過賬號並清除 affinity；loopback 地址強制直連。
限流與錯誤處理¶
429 響應會按類型處理：
soft_rate_limit：立即重試。rate_limited：冷卻並切換賬號。quota_exhausted：冷卻至真實重置時間。unknown：指數退避。
401 / 403 會把賬號標記爲需重新認證。
風險控制¶
DSH_AGY_DISABLE=1 是 kill switch：插件不註冊 provider 和 /agy 路由，且 CLI 拒絕運行。
卸載¶
如不再使用 Web 插件：
dsh plugin --profile web remove dsh-agy
如不再使用全局 CLI：
npm uninstall -g dsh-agy
適用場景與注意¶
適合需要在 DSH 中管理 agy 多賬號、使用 Web 面板或 CLI 的開發者。
使用注意：
1、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
2、Quota dashboard 僅在 DSH Web 運行時激活。
3、刪除本地文件不會撤銷 Google 端授權；refresh token 在過期或手動撤銷前仍有效。
4、本地開發路徑要求 Node >= 22，package.json engines 要求 node >=20.18.1；最低運行要求需按實際環境確認。
5、社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
獲取項目¶
目錄頁：https://www.skillhub.cn/plugins/chaos-03x/dsh-agy
GitHub：https://github.com/chaos-03x/dsh-agy
