前言¶
DeepSeek Harness（DSH）把對話、工具調用和模型路由統一在一個客戶端裏。若你已經在本地使用 Google Antigravity 的 agy CLI，常見做法是單獨開終端跑 agy，再把輸出手動貼回 DSH，會話上下文和 token 統計也難以對齊。
dsh-agy-link 由社區維護者 amlyczz 開發，通過調用本機未修改的 agy 進程，把 Antigravity 模型註冊爲 DSH 的一個模型提供方。你在 /model 裏選模型即可對話，流式輸出、思考過程、工具活動與用量統計會映射到 DSH 原生界面。
這是什麼¶
dsh-agy-link 是 DSH 社區插件，npm 包名爲 dsh-agy-link，當前版本 0.4.20，MIT 許可證。它在 SkillHub 目錄中歸類爲「模型推理」。
插件不直接請求遠程 API，而是爲每一輪對話啓動獨立的 agy -p --output-format stream-json 子進程，解析 NDJSON 事件流後寫入 DSH 協議。DSH 會話與 agy 原生會話通過 --conversation 綁定，由 agy 管理完整歷史，每輪只發送增量。
核心功能¶
多賬號池化與輪換¶
支持在 DSH 內添加多個 Google 賬號。除主賬號沿用系統默認憑證外，備用賬號在插件私有目錄下建立獨立 HOME 沙箱，憑證相互隔離。
噹噹前賬號觸發 429 限流、5 小時滾動額度或 7 天周額度耗盡時，調度器會按順序切換到池中下一個可用賬號。Gemini 與 Claude / GPT-OSS 等模型族的速率限制獨立計算，某一族進入冷卻不影響其他族繼續調用。
官方雙 Bucket 配額監控¶
插件後臺輪詢 Antigravity 官方接口 v1internal:retrieveUserQuotaSummary，在控制檯展示 5 小時滾動額度與 7 天周額度的進度條和重置倒計時，可按模型展開明細。
GUI 內 OAuth 登錄¶
點擊「添加賬號」會調起系統瀏覽器完成 Google 授權，本地迴環監聽自動捕獲憑證，無需手動複製粘貼授權碼。也可在輸入框執行 /agy auth 爲主賬號發起登錄。
流式輸出與工具映射¶
文本、thinking 摺疊段和工具活動均映射到 DSH 流協議。agy 執行的終端命令（run_command）和文件修改（inline diff）以 DSH 原生卡片渲染。輸入、輸出、思考與緩存讀取 token 計入 DSH 用量統計。
其他能力¶
- 在 DSH 模型配置中註冊
antigravity提供方，通過/model切換 Gemini、Claude、GPT-OSS 等模型。 - 每個賬號可單獨配置 HTTP(S) / SOCKS 代理，隔離 IP 出口。
- 支持多模態圖片傳入，自動落盤並通過
--add-dir授權給 agy。 - 提供
agy_ask輔助工具，允許其他 DSH 模型把單次任務委託給 Antigravity。 - 頂部欄
AGY (n)徽標可打開管理控制檯，查看賬號池、配額與代理狀態。 /agy快捷命令族：status、auth、models、mode、effort、workspace、clear、doctor、help。
前置要求¶
安裝前確認以下環境：
| 前置項 | 說明 |
|---|---|
| 系統網絡代理 | Google Antigravity 與 OAuth 需訪問 oauth2.googleapis.com、cloudcode-pa.googleapis.com 等域名。國內網絡通常需開啓 TUN 模式或設置代理環境變量。 |
| DeepSeek Harness | 用 dsh --version 驗證已安裝。 |
| Node.js ≥ 24 | 用 node --version 驗證。 |
Google Antigravity agy CLI |
按 Google 官方安裝文檔 安裝，agy --version 能輸出版本號即可。尚未登錄也可先裝插件，再在 GUI 內完成授權。 |
安裝與啓用¶
下面介紹安裝步驟。插件以 npm 包發佈，面向 DSH Web 配置檔（--profile web）。
- 若終端未被系統代理自動接管，先設置代理環境變量（端口按本地代理軟件實際值替換）：
export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
- 安裝插件：
dsh plugin --profile web add dsh-agy-link
升級到最新版：
dsh plugin --profile web add dsh-agy-link@latest --registry https://registry.npmjs.org
- 啓動 DSH Web GUI，在輸入框檢查狀態：
/agy status
典型用法¶
添加賬號並選擇模型¶
經過上面的安裝步驟後，可用兩種方式登錄：
- 方式 A：點擊頂部導航欄
AGY (n)徽標，再點「添加賬號」，在瀏覽器完成 Google 授權。 - 方式 B：在輸入框執行
/agy auth爲主賬號發起登錄。
隨後在 /model 選擇器裏挑選 Antigravity 模型，即可開始對話。
常用配置項¶
插件配置可在 /plugin、設置面板或環境變量中調整：
| 鍵名 | 環境變量 | 默認值 | 作用 |
|---|---|---|---|
enabled |
DSH_AGY_ENABLED |
true |
插件主開關 |
agyBin |
DSH_AGY_BIN |
自動探測 | 顯式指定 agy 二進制路徑 |
permissionMode |
DSH_AGY_MODE |
skip |
權限模式：skip / plan / accept-edits |
defaultModel |
DSH_AGY_DEFAULT_MODEL |
agy 默認 | 默認模型 slug |
defaultEffort |
DSH_AGY_DEFAULT_EFFORT |
模型默認 | 思考預算：low / medium / high |
timeoutMs |
DSH_AGY_TIMEOUT_MS |
600000 |
單輪活躍看門狗超時（毫秒） |
workspaceRoot |
DSH_AGY_WORKSPACE_ROOT |
會話 cwd | agy 工作區根目錄 |
進入「設置 → Antigravity」，或在賬號卡片上點「代理」，可爲單個賬號配置專屬代理 URL，例如 http://127.0.0.1:7890。
適用場景與注意¶
適合已在本地安裝 agy CLI、希望在 DSH 統一界面裏使用 Antigravity 訂閱額度的開發者。若你持有多個 Google 賬號並需要自動輪換與配額可視化，多賬號池化是主要價值點。
使用前請注意：
- 插件以當前
dsh進程的權限運行，會啓動子進程、讀寫憑證與工作區文件。安裝前應查看 GitHub 源碼 與 MIT 許可證，確認可接受其行爲範圍。 - 使用需遵循 Google Antigravity 服務條款；插件僅橋接本機官方
agy，不修改其二進制。 - SkillHub 是 DSH 社區獨立目錄站點，與 DeepSeek / 幻方無官方從屬關係。
鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/amlyczz/dsh-agy-link
- GitHub 倉庫：https://github.com/amlyczz/dsh-agy-link
- npm 包：https://www.npmjs.com/package/dsh-agy-link
dsh-agy-link 把 Antigravity 的 CLI 能力接入 DSH 模型路由，省去終端與 GUI 之間來回切換。若你已在用 agy 且希望對話、工具卡片和 token 統計留在同一客戶端，可按上文步驟安裝試用。
