Skip to content

agy-next

Verified

agy-next · v1.1.0 · MIT · Web UI

Antigravity provider for DeepSeek Harness — requires the official locally installed Antigravity app

Install

dsh plugin add agy-next

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

Antigravity Next for DSH

Antigravity Next for DSH 橫幅

CI Version License: MIT DeepSeek Harness

English | 繁體中文 | 简体中文

非官方的 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,不上傳任何金鑰。

系統需求

  1. DeepSeek Harness:版本 0.1.5 ~ 0.2.x(完整相容至最新 0.2.1 系列),Node.js >=20。
  2. 官方 Antigravity 桌面程式:已安裝於 Windows 或 macOS(Linux 支援進行中)。可至官方網站下載(使用外掛時該程式不需保持啟動)。
  3. Google 帳號:可正常完成瀏覽器 OAuth 授權,並擁有 Gemini / Cloud Code Assist 存取權限。

安裝指南

方式一:DSH 介面安裝(推薦)

  1. 開啟 DSH 側邊欄的 「插件」→「+ 添加插件」。
  2. 在輸入框貼上 GitHub 倉庫網址:
    https://github.com/kizaki-R/Antigravity-Next-for-DSH
    
    (待 npm 發布後,亦可直接輸入 agy-next)。
  3. 點選 「安裝」,完成後重新啟動 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」:

  1. 檢查狀態:確認頁面偵測到本機 Antigravity 安裝路徑。
  2. 新增帳號:點選 「登入 / 新增帳號」,瀏覽器會開啟 Google 官方授權頁面。
  3. 授權後帳號即進入帳號池,並顯示各模型額度狀態。

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 的空清冊,防止舊版設定自動回補舊帳號。

授權條款

本專案採用 MIT 條款開源 © Kizaki