amlyczz/dsh-agy-link

🛰️ dsh-agy-link

DeepSeek Harness × Google Antigravity — 多账号智能池化与官方 agy CLI 驱动桥接 / Multi-Account Pool & Native agy CLI Bridge for DSH

🌐 Language / 语言：
中文 ·
English ·
Português (Brasil) ·
Español ·
English (standalone)

中文

把 Google Antigravity 模型接入 DeepSeek Harness（DSH） —— 支持多账号智能池化轮换、官方双 Bucket 配额监控（5小时滚动 + 7天周额度）、浏览器免粘贴一键登录与浅色/深色主题高对比度自适应，由官方未修改的 agy CLI 驱动，完整支持流式输出、思考折叠（thinking）、原生工具卡片与精确 token 用量。

  

🚨 【国内用户核心前置：必须开启系统代理 / TUN 模式！】

Google Antigravity 服务及 OAuth 登录需要直连 Google 海外官方服务器（oauth2.googleapis.com、cloudcode-pa.googleapis.com 等）。

1. 推荐方式（最稳妥）：开启代理工具（Clash / Surge / v2rayA / Sing-box / Loon 等）的 TUN 虚拟网卡模式（或系统代理全局接管），确保终端命令、后台 Node.js 进程及浏览器均能顺畅访问 Google 网络。
2. 终端代理环境变量：若终端未被代理自动接管，启动 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

(注：端口 7890 请替换为你本地代理软件的实际端口)
3. 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 工作区根目录（默认跟随当前会话工作区） |

🧩 架构与工作原理

1. 短生命周期进程驱动：每一轮 DSH 对话启动一个独立的官方 agy -p --output-format stream-json 进程，解析 NDJSON 事件流。
2. 多账号沙箱机制：除主账号沿用系统默认 Keychain / HOME 外，所有备用账号在插件私有目录下建立专属 HOME 隔离区，独立写入 agy 格式的标准 OAuth 凭证。
3. 双 Bucket 官方配额汇总：插件定时后台静默轮询官方 v1internal:retrieveUserQuotaSummary，精准掌控每个账号的 5h 滚动削峰水位与 7d 账号阶梯周额度。
4. 会话级无缝故障转移：当遭遇 HTTP 429、额度耗尽或凭证异常时，号池调度器自动标记当前账号家族进入冷却，并无缝将后续请求路由到池内下一个有效账号。

🙏 参考与致谢

- CLIProxyAPI — Antigravity 公开 OAuth 客户端与回环回调登录范式
- opencode-antigravity-auth — opencode 平台的多账号实践
- OmniRoute — Antigravity 端点分发与配额语义
- pi-mono — Antigravity 轮换与桥接设计参考

⚠️ 免责声明

本插件仅通过调用用户本地官方安装的未修改 agy CLI 进程进行交互。使用本插件需遵循 Google Antigravity 服务条款。

许可证

MIT License.

English

将 Google Antigravity 模型引入 DeepSeek Harness (DSH) —— 具备多账号池化与自动轮换、官方双 Bucket 配额追踪（5h 滚动 + 7d 周度）、零粘贴 GUI 内 OAuth 登录以及主题自适应高对比度 UI，由官方未修改的 agy CLI 提供支持。

  

🚨 【重要：受限地区需启用系统代理 / VPN / TUN 模式】

Google Antigravity 服务与 Google OAuth 需要访问 Google 服务器（oauth2.googleapis.com、cloudcode-pa.googleapis.com 等）。

1. 推荐：在你的 VPN 或代理客户端（Clash、Surge、Sing-box 等）中启用 TUN 模式 / 系统代理，以便所有终端命令、Node.js 后台进程和浏览器调用都通过代理路由。
2. 终端代理导出：如果你的终端未自动继承代理，请在启动 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

3. 按账号专用代理：你也可以直接在 DSH 设置 → Antigravity 中，通过点击账号卡片上的“🌐 代理”按钮，为每个账号配置专用代理 URL（例如 http://127.0.0.1:7890）。

🌟 核心功能：多账号池与智能轮换

拥有多个 Google Antigravity / Gemini 账号？dsh-agy-link 让多账号编排无缝且自动化：

- 👥 多账号池化：管理无限数量的 Google 账号（主账号 + 备用池），并拥有完全隔离的 HOME 沙箱环境与凭证。
- 🔄 顺序耗尽故障转移：当某个账号达到速率限制（429）或耗尽 5h/周度配额时，请求会自动且平滑地故障转移到下一个可用账号，而不会中断你的对话！
- 📊 官方双桶配额跟踪：直接集成 Antigravity 官方的 v1internal:retrieveUserQuotaSummary 端点，实时展示 5 小时滚动限额 和 7 天每周限额，并带有实时倒计时。
- 🔑 GUI 内零粘贴 OAuth：一键“添加账户”即可打开浏览器，并通过本地回环自动捕获 OAuth 令牌——无需复制粘贴授权码。
- 🎨 主题自适应高对比度 UI：无缝适配浅色和深色 DSH 主题，字体清晰锐利，对比鲜明。
- 🌐 按账户代理：为每个独立账户配置专用的 HTTP(S) / SOCKS 代理，以隔离 IP 地址。
- ⚡ 按模型家族隔离的冷却：Gemini、Claude 和 GPT-OSS 的速率限制独立计算，防止某个耗尽的模型阻塞其他模型。

✨ 功能概览

| 功能 | 描述 |
| --- | --- |
| 👥 多账户池 | 主账户 + 无限备用账户，遇到速率限制时自动按顺序轮换排空 |
| 📊 双桶配额 HUD | 实时双进度条，同时展示 5 小时滚动 和 7 天每周 配额限制，并带有精确的重置倒计时 |
| 🔑 零粘贴浏览器登录 | 基于浏览器的 Google OAuth 自动登录，带本地回环回调处理 |
| 🎨 主题自适应 UI | 动态浅色/深色主题切换，纯 SVG 矢量图标（无 emoji），高对比度 |
| 🌐 按账户代理 | 每个账户槽位可配置专用 HTTP(S) 代理 |
| 🔌 原生模型路由 | 在 DSH 中注册 antigravity 提供商；可在 /model 选择器中选择 Gemini / Claude / GPT-OSS |
| 🌊 完整流式协议 | 原生流式支持文本、思考轮次标注和工具调用 |
| 🃏 原生工具 UI 卡片 | 命令运行和内联 diff 以简洁的原生 DSH 工具卡片形式呈现 |
| 🔗 会话连续性 | 将 DSH 会话绑定到原生 agy 对话（--conversation），实现零冗余上下文 |
| 📊 精确 Token 计量 | 输入、输出、思考和 cacheRead token 全部上报至 DSH，支持 1M 上下文 |
| 🎛 顶部标题栏控制台徽章 | 点击标题栏中的 AGY (n) 徽章即可立即打开管理控制台 |
| 🖼 多模态图像 | 将图像暂存到本地存储，并通过 --add-dir 传递安全的绝对路径 |
| 🤝 agy_ask 委托 | 允许其他 DSH 模型将子任务委托给 Antigravity 模型 |
| ⌨️ /agy 命令 | 完整命令套件：status、auth、models、mode、effort、workspace、clear、doctor、help |

📋 前置条件

| 要求 | 详情 |
| --- | --- |
| 1. 系统代理 / VPN | 【受限地区必需】（TUN 模式或 HTTPS_PROXY 环境变量，以确保 Google 端点可访问） |
| 2. DeepSeek Harness (DSH) | 你当前的 DSH 环境（dsh --version） |
| 3. Node.js ≥ 24 | 所需运行时（node --version） |
| 4. Google Antigravity agy CLI | 按照 Google 官方指南 安装。使用 agy --version 验证 |

🚀 快速开始

0. 确保系统代理 / TUN 模式已启用（连接 Google 所必需）：
export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890

1. 安装插件：
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. 添加账号：
点击顶部页眉中的 "AGY (n)" 徽章，点击 "➕ Add Account" 并完成浏览器登录。

4. 在 /model 中选择一个 Antigravity 模型，然后开始聊天！

⚙️ 配置

| 键 | 环境变量 | 默认值 | 描述 |
| --- | --- | --- | --- |
| 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 default) | 默认模型标识符 |
| defaultEffort | DSH_AGY_DEFAULT_EFFORT | (model default) | 思考预算：low / medium / high |
| timeoutMs | DSH_AGY_TIMEOUT_MS | 600000 | 活动看门狗超时时间（毫秒） |
| workspaceRoot | DSH_AGY_WORKSPACE_ROOT | 会话当前工作目录 | 工作目录根路径 |

无头运行

有关有界复现、最小权限读取规则验证以及进程与工具验收检查，请参阅无头权限。

该插件将选定的权限模式传递给 agy；它本身不会批准、拒绝或绕过权限。在无头/打印运行中，agy 可能会在 plan 或 accept-edits 模式下自动拒绝工具请求。原始工具错误会保留在 /agy status 中；它并不能证明是人为拒绝。

不要假设任一模式具有未记录的通配符语义。请在限定范围内的工作区中测试确切的 agy 版本和命令集。仅当你明确接受无人值守的工具执行时，才选择 skip。

⚠️ 免责声明

本插件严格通过调用安装在您本地系统上的官方、未经修改的 agy CLI 二进制文件来运行。使用本插件须遵守 Google Antigravity 的服务条款。

许可证

MIT 许可证。