amlyczz/dsh-agy-link
Google Antigravity (agy CLI) models for DeepSeek Harness — streaming chat, thinking, tool activity, usage, in-GUI Google OAuth login
安装Install
dsh plugin --profile web add dsh-agy-link把 amlyczz/dsh-agy-link 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
🛰️ dsh-agy-link
DeepSeek Harness × Google Antigravity — 多账号智能池化与官方 agy CLI 驱动桥接 / Multi-Account Pool & Native agy CLI Bridge for DSH
中文
全网统一昵称：小斯syzs · B站 @小斯syzs · 抖音 · 小红书 · 快手（全网同名）
把 Google Antigravity 模型接入 DeepSeek Harness（DSH） —— 支持多账号智能池化轮换、官方双 Bucket 配额监控（5小时滚动 + 7天周额度）、浏览器免粘贴一键登录与浅色/深色主题高对比度自适应，由官方未修改的 agy CLI 驱动，完整支持流式输出、思考折叠（thinking）、原生工具卡片与精确 token 用量。
🚨 【国内用户核心前置：必须开启系统代理 / TUN 模式！】
Google Antigravity 服务及 OAuth 登录需要直连 Google 海外官方服务器（
oauth2.googleapis.com、cloudcode-pa.googleapis.com等）。
- 推荐方式（最稳妥）：开启代理工具（Clash / Surge / v2rayA / Sing-box / Loon 等）的 TUN 虚拟网卡模式（或系统代理全局接管），确保终端命令、后台 Node.js 进程及浏览器均能顺畅访问 Google 网络。
- 终端代理环境变量：若终端未被代理自动接管，启动 DSH 或运行命令前请在终端中执行：
(注：端口export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:78907890请替换为你本地代理软件的实际端口)- GUI 单账号独立代理：进入 DSH「设置 → Antigravity」或点击顶部
AGY徽标，点击卡片上的「🌐 代理」按钮，可为特定账号单独配置专属代理 URL（如http://127.0.0.1:7890），实现多账号不同 IP 出口隔离。
🌟 核心亮点：多账号池化与智能轮换
你拥有多个 Google Antigravity / Gemini 账号？dsh-agy-link 让多账号管理变得极致简单与自动化：
- 👥 多账号池化管理 (Account Pool)：在 DSH 内添加任意数量的 Google 账号（主账号 + 备用账号群），每个账号拥有独立的 HOME 目录沙箱与凭证隔离。
- 🔄 顺序耗尽故障转移 (Sequential Drain)：当前账号额度用尽（触发 429 限流或 5h / 周额度耗尽）时，系统自动平滑接力至下一个可用账号，对话完全不中断！
- 📊 官方双 Bucket 配额监控 (Dual-Bucket Quota)：直接调用 Antigravity 官方专用的
v1internal:retrieveUserQuotaSummary接口，同时展示 5小时滚动额度 与 7天周额度 真实数据及精准重置倒计时。 - 🔑 GUI 内浏览器免粘贴登录 (In-GUI Zero-Paste OAuth)：点击「➕ 添加账号」自动调起系统浏览器，本地回环监听自动捕获授权凭证，全程无需手动复制粘贴授权码。
- 🎨 多主题高对比度自适应 (Light & Dark Themes)：原生适配 DSH 浅色/深色主题，告别发暗发灰与看不清文字，UI 视觉清晰锐利。
- 🌐 独立账号网络代理 (Per-Account Proxy)：支持为每个账号独立绑定 HTTP(S) / SOCKS 代理，避免多账号同 IP 引起风控。
- ⚡ 分模型族独立冷却 (Family-Scoped Cooldown)：Gemini 与 Claude / GPT-OSS 速率限制独立计算，某个模型族受限不影响其他模型族正常调用。
✨ 全功能特性一览
| 能力 | 说明 |
|---|---|
| 👥 多账号池化轮换 | 支持主账号 + 多个备用账号；遇到 429 或配额耗尽自动平滑切换，模型族独立冷却 |
| 📊 官方双 Bucket 配额监控 | 实时拉取官方端点，同时呈现 5h 滚动额度 与 7d 周额度 双进度条与倒计时，单模型明细可展开 |
| 🔑 浏览器一键登录 | 点击添加账号自动唤起 Google 授权页，本地回环自动捕获，全程无需复制粘贴任何代码 |
| 🎨 多主题高对比 UI | 浅色、深色主题自适应变色，纯矢量 SVG 图标（无 Emoji），字迹清晰不发暗 |
| 🌐 独立账号代理 | 每个账号支持独立配置 HTTP(S) 代理，隔离 IP 出口 |
| 🔌 原生模型路由 | 在 DSH 模型配置中注册 antigravity 提供方，/model 选择器随心切换 Gemini / Claude / GPT-OSS |
| 🌊 完整流式映射 | 文本、思考过程（thinking turn）与工具活动均无损映射到 DSH 原生流协议 |
| 🃏 原生工具卡片 | agy 执行的终端命令（run_command）、文件修改（inline diff）均以 DSH 原生卡片渲染 |
| 🔗 会话上下文保真 | DSH 会话与 agy 原生会话绑定（--conversation），由 agy 管理完整历史，每轮仅发送增量 |
| 📊 精确 Token 统计 | 输入 / 输出 / 思考 / 缓存读取 token 完整计入 DSH 用量统计，全面适配 1M 上下文 |
| 🎛 顶部控制台徽标 | 顶部栏 AGY (n) 徽标一键弹出控制台，直观查看账号池、配额进度条与代理状态 |
| 🖼 图片多模态 | 支持多模态图片传入，自动落盘本地媒体目录并通过 --add-dir 安全授权给 agy 查看 |
🤝 agy_ask 辅助工具 |
允许任意 DSH 模型把单次任务委托给 Antigravity 模型（AskAntigravity 协作模式） |
⌨️ /agy 快捷命令族 |
status / auth / models / mode / effort / workspace / clear / doctor / help |
📋 前置要求
在安装本插件前，请确保具备以下环境：
| 前置项 | 说明 / 验证方式 |
|---|---|
| 1. 系统网络代理 | 【必须开启】（推荐开启 Clash / Surge / v2rayA 的 TUN 模式或设置 HTTPS_PROXY 环境变量，确保可流畅连接 Google 服务） |
| 2. DeepSeek Harness (DSH) | 你正在使用的 DSH 客户端；dsh --version 可验证 |
| 3. Node.js ≥ 24 | DSH 依赖环境；node --version 验证 |
4. Google Antigravity agy CLI |
按 Google 官方安装文档 安装（支持 macOS / Linux / Windows）。agy --version 能输出版本号即表示安装成功 |
💡 提示：即使你的 agy 尚未登录，也可以直接安装插件！在 DSH 界面顶部点击
AGY徽标或进入「设置 → Antigravity」，点击「➕ 添加账号」即可直接在浏览器中完成登录。
🚀 快速上手
# 0. 确保系统代理 / TUN 模式已开启（国内网络必需）：
export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890
# 1. 安装插件（npm 官方包，无需编译构建）：
dsh plugin --profile web add dsh-agy-link
# 升级到最新版：
# dsh plugin --profile web add dsh-agy-link@latest --registry https://registry.npmjs.org
# 2. 启动 DSH Web GUI，在输入框中检查状态：
# /agy status
# 3. 登录与添加账号：
# 方式 A：点击顶部导航栏的 "AGY (n)" 徽标，点击 "➕ 添加账号"，浏览器一键登录；
# 方式 B：输入框执行 /agy auth 为主账号发起登录。
# 4. 在 /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 工作区根目录（默认跟随当前会话工作区） |
🧩 架构与工作原理
- 短生命周期进程驱动：每一轮 DSH 对话启动一个独立的官方
agy -p --output-format stream-json进程，解析 NDJSON 事件流。 - 多账号沙箱机制：除主账号沿用系统默认 Keychain / HOME 外，所有备用账号在插件私有目录下建立专属 HOME 隔离区，独立写入 agy 格式的标准 OAuth 凭证。
- 双 Bucket 官方配额汇总：插件定时后台静默轮询官方
v1internal:retrieveUserQuotaSummary，精准掌控每个账号的 5h 滚动削峰水位与 7d 账号阶梯周额度。 - 会话级无缝故障转移：当遭遇 HTTP 429、额度耗尽或凭证异常时，号池调度器自动标记当前账号家族进入冷却，并无缝将后续请求路由到池内下一个有效账号。
🙏 参考与致谢
- CLIProxyAPI — Antigravity 公开 OAuth 客户端与回环回调登录范式
- opencode-antigravity-auth — opencode 平台的多账号实践
- OmniRoute — Antigravity 端点分发与配额语义
- pi-mono — Antigravity 轮换与桥接设计参考
⚠️ 免责声明
本插件仅通过调用用户本地官方安装的未修改 agy CLI 进程进行交互。使用本插件需遵循 Google Antigravity 服务条款。
许可证
MIT License.
English
Known online as 小斯syzs — Bilibili @小斯syzs · Douyin · Xiaohongshu · Kuaishou (same handle across all platforms).
Bring Google Antigravity models into DeepSeek Harness (DSH) — featuring Multi-Account Pooling & Automatic Rotation, Official Dual-Bucket Quota Tracking (5h Rolling + 7d Weekly), Zero-Paste In-GUI OAuth Login, and Theme-Adaptive High-Contrast UI, powered by the official unmodified agy CLI.
🚨 【Important: System Proxy / VPN / TUN Mode Required in Restricted Regions】
Google Antigravity services and Google OAuth require access to Google servers (
oauth2.googleapis.com,cloudcode-pa.googleapis.com, etc.).
- Recommended: Enable TUN mode / System Proxy in your VPN or proxy client (Clash, Surge, Sing-box, etc.) so that all terminal commands, Node.js background processes, and browser calls route through your proxy.
- Terminal Proxy Export: If your terminal does not inherit proxy automatically, export the environment variables before starting DSH:
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- Per-Account Dedicated Proxy: You can also configure a dedicated proxy URL per account directly in DSH Settings → Antigravity by clicking the "🌐 Proxy" button on the account card (e.g.
http://127.0.0.1:7890).
🌟 Core Feature: Multi-Account Pool & Smart Rotation
Have multiple Google Antigravity / Gemini accounts? dsh-agy-link makes multi-account orchestration seamless and automated:
- 👥 Multi-Account Pooling: Manage unlimited Google accounts (Primary + Secondary pool) with fully isolated HOME sandbox environments and credentials.
- 🔄 Sequential Drain Failover: When an account reaches its rate limits (429) or runs out of 5h/weekly quotas, requests automatically and smoothly fail over to the next available account without interrupting your conversation!
- 📊 Official Dual-Bucket Quota Tracking: Direct integration with Antigravity's official
v1internal:retrieveUserQuotaSummaryendpoint, providing real-time visibility for both 5-Hour Rolling Limit and 7-Day Weekly Limit with live countdowns. - 🔑 In-GUI Zero-Paste OAuth: One-click "Add Account" opens your browser and automatically captures OAuth tokens via local loopback — no copying and pasting of authorization codes required.
- 🎨 Theme-Adaptive High-Contrast UI: Seamlessly adapts to Light and Dark DSH themes with crystal clear typography and crisp contrast.
- 🌐 Per-Account Proxy: Configure dedicated HTTP(S) / SOCKS proxy for each individual account to isolate IP addresses.
- ⚡ Family-Scoped Cooldowns: Gemini, Claude, and GPT-OSS rate limits are calculated independently, preventing one exhausted model from blocking others.
✨ Features Overview
| Feature | Description |
|---|---|
| 👥 Multi-Account Pool | Primary + unlimited spare accounts with automatic Sequential Drain rotation upon rate limits |
| 📊 Dual-Bucket Quota HUD | Real-time dual progress bars for both 5h rolling and 7d weekly quota limits with exact reset countdowns |
| 🔑 Zero-Paste Browser Login | Automatic browser-based Google OAuth login with loopback callback handler |
| 🎨 Theme-Adaptive UI | Dynamic light/dark theme switching, pure SVG vector marks (no emojis), high contrast |
| 🌐 Per-Account Proxy | Dedicated HTTP(S) proxy per account slot |
| 🔌 Native Model Routing | Registers antigravity provider in DSH; choose Gemini / Claude / GPT-OSS in /model picker |
| 🌊 Full Streaming Protocol | Native streaming for text, thinking turn annotations, and tool calls |
| 🃏 Native Tool UI Cards | Command runs and inline diffs render as clean, native DSH tool cards |
| 🔗 Session Continuity | Binds DSH sessions to native agy conversations (--conversation) for zero-redundancy context |
| 📊 Accurate Token Metering | Input, output, thinking, and cacheRead tokens are fully reported to DSH with 1M context support |
| 🎛 Top Header Console Badge | Click the AGY (n) badge in the header to instantly open the management console |
| 🖼 Multimodal Images | Stages images to local storage and passes safe absolute paths via --add-dir |
🤝 agy_ask Delegation |
Allows other DSH models to delegate subtasks to Antigravity models |
⌨️ /agy Commands |
Full command suite: status, auth, models, mode, effort, workspace, clear, doctor, help |
📋 Prerequisites
| Requirement | Details |
|---|---|
| 1. System Proxy / VPN | 【Required in restricted regions】 (TUN mode or HTTPS_PROXY environment variable to ensure Google endpoints are reachable) |
| 2. DeepSeek Harness (DSH) | Your current DSH environment (dsh --version) |
| 3. Node.js ≥ 24 | Required runtime (node --version) |
4. Google Antigravity agy CLI |
Installed per Google's official guide. Verified with agy --version |
🚀 Quick Start
# 0. Ensure System Proxy / TUN mode is active (required for Google connectivity):
export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890
# 1. Install plugin:
dsh plugin --profile web add dsh-agy-link
# Upgrade to latest:
# dsh plugin --profile web add dsh-agy-link@latest --registry https://registry.npmjs.org
# 2. Start DSH Web GUI, test status:
# /agy status
# 3. Add accounts:
# Click "AGY (n)" badge in the top header, click "➕ Add Account" and complete browser login.
# 4. Select an Antigravity model in /model and start chatting!
⚙️ Configuration
| Key | Environment Variable | Default | Description |
|---|---|---|---|
enabled |
DSH_AGY_ENABLED |
true |
Master switch |
agyBin |
DSH_AGY_BIN |
auto-detected | Path to agy binary |
permissionMode |
DSH_AGY_MODE |
skip |
skip (recommended) / plan (read-only) / accept-edits |
defaultModel |
DSH_AGY_DEFAULT_MODEL |
(agy default) |
Default model slug |
defaultEffort |
DSH_AGY_DEFAULT_EFFORT |
(model default) |
Thinking budget: low / medium / high |
timeoutMs |
DSH_AGY_TIMEOUT_MS |
600000 |
Activity watchdog timeout in milliseconds |
workspaceRoot |
DSH_AGY_WORKSPACE_ROOT |
session cwd | Working directory root |
⚠️ Disclaimer
This plugin operates strictly by invoking the official, unmodified agy CLI binary installed on your local system. Use of this plugin is subject to Google Antigravity's Terms of Service.
License
MIT License.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …