Antigravity Next for DSH
非官方的 DeepSeek Harness（DSH）模型供應商外掛。將本機安裝的官方 Google Antigravity / Cloud Code Assist 整合至 DSH 的 Agent 核心架構中，註冊提供者識別碼為 agy-next。
免責聲明： 本專案為非官方本地整合，與 Google 或 DeepSeek 均無任何隸屬、認可或官方支援關係。使用者須具備合法 Google 帳號授權，並於本機安裝官方 Antigravity 應用程式。
功能特點
- 免手動配置 GCP：直接從本機安裝的官方 Antigravity 解析 OAuth client，不需要在 Google Cloud Console 建立專案或金鑰。
- 多帳號輪替池：可加入多組 Google 帳號並設定安全閾值；當前帳號額度用盡時，自動切換至備用帳號接續對話。
- 即時額度監控面板：在設定頁顯示 Gemini、Claude 與 Gemini 4 Argon 的每週及 5 小時額度條與重設倒數。
- 思考強度檔位調節：支援推理思考強度（Low、Medium、High，適用於 Gemini 4 Argon、Gemini 3.8 Flash 與 Claude 系列）。
- 本機安全儲存：客戶端探索僅讀取檔案，不會執行官方 App。Token 僅存於本機
<DSH_HOME>/storages/agy-next-oauth.json，不上傳任何金鑰。
系統需求
- DeepSeek Harness：版本
0.1.5～0.2.x（完整相容至最新0.2.1系列），Node.js>=20。 - 官方 Antigravity 桌面程式：已安裝於 Windows 或 macOS（Linux 支援進行中）。可至官方網站下載（使用外掛時該程式不需保持啟動）。
- Google 帳號：可正常完成瀏覽器 OAuth 授權，並擁有 Gemini / Cloud Code Assist 存取權限。
安裝指南
方式一：DSH 介面安裝（推薦）
- 開啟 DSH 側邊欄的 「插件」→「+ 添加插件」。
- 在輸入框貼上 GitHub 倉庫網址：
（待 npm 發布後，亦可直接輸入https://github.com/kizaki-R/Antigravity-Next-for-DSHagy-next）。 - 點選 「安裝」，完成後重新啟動 DSH。
方式二：本機開發模式（CLI / Link）
從本地原始碼進行開發測試：
# 於 DSH profile 註冊本機連結
dsh plugin --profile <profile> add link:/absolute/path/to/agy-next
確認該 profile 的 dsh.profile.bundles 已包含 agy-next，隨後重新啟動 DSH。
快速上手
1. 登入帳號
在 DSH 中開啟 「設定」→「AGY-Next」：
- 檢查狀態：確認頁面偵測到本機 Antigravity 安裝路徑。
- 新增帳號：點選 「登入 / 新增帳號」，瀏覽器會開啟 Google 官方授權頁面。
- 授權後帳號即進入帳號池，並顯示各模型額度狀態。
CLI 備用指令：
npm run login # 登入新帳號
npm run login -- --status # 檢視目前作用帳號與額度
npm run login -- --force # 強制重新授權
npm run login -- --logout # 清除已存憑證
2. 自訂安裝路徑
若 Antigravity 安裝在非標準路徑，在啟動 DSH 前設定環境變數即可：
# PowerShell
$env:AGY_NEXT_INSTALL_PATH = 'C:\Custom\Path\To\Antigravity'
進階設定
若需調整連線參數，可在 profile 的 cordis.yml 中覆寫：
- id: agy-next
name: agy-next
config:
credentialPath: "" # 預設為 <DSH_HOME>/storages/agy-next-oauth.json
streamIdleTimeoutMs: 300000 # 串流閒置超時保護（毫秒，預設 5 分鐘）
discoveryTimeoutMs: 8000 # 本機 client 探索超時（毫秒）
projectCacheTtlMs: 1800000 # 專案 metadata 快取存活時間（毫秒，30 分鐘）
runtimeModel: "" # 選填：固定指定後端模型 ID
支援模型矩陣
| 模型家族 | 代表型號 | 上下文長度 | 特性支援 |
|---|---|---|---|
| Gemini 4 Argon | gemini-4-argon | 1M tokens | Low / Medium / High 思考檔位、5 小時與每週額度獨立監控 |
| Gemini 3 / 2.5 | gemini-3.8-flash、gemini-3-flash、gemini-2.5-pro、gemini-2.5-flash | 1M tokens | 高速多模態串流輸出、工具調用 |
| Claude 系列 | claude-sonnet-5-5、claude-opus-5-5、claude-opus-4-6、claude-sonnet-4-6 | 1M tokens | 整合 Cloud Code Assist 之 Claude 執行環境 |
| 開源大模型 | gpt-oss-120b | 128k tokens | 大參數開源權重推理 |
開發與測試
於 agy-next/ 目錄下執行離線測試：
npm run check # 檢查全數 40 支模組語法
npm test # 執行離線回歸測試（21 項 fixture 隔離驗證）
npm run test:peers # 嚴格主機 peers 契約測試（需設定 AGY_PEER_ROOT）
執行 peers 契約測試時，指定主機依賴路徑：
$env:AGY_PEER_ROOT = 'C:\path\to\dsh\node_modules'
npm run test:peers
安全設計
- 不內嵌密鑰：代碼庫不包含任何 Google Client ID 或 Client Secret，全部由本機應用程式資源即時解析。
- 儲存隔離：憑證儲存在 DSH 專屬的
agy-next-oauth.json，不讀取或更動官方 Antigravity 的內部資料庫。 - 墓碑機制（Tombstone）：登出所有帳號時寫入標記為
loggedOut: true的空清冊，防止舊版設定自動回補舊帳號。