Antigravity 账号池 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 天周额度 + Argon 独立周池）、浏览器免粘贴一键登录与浅色/深色主题高对比度自适应，由官方未修改的 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 / 周额度耗尽）时，系统自动平滑接力至下一个可用账号，对话完全不中断！
- 🕰 额度到期优先轮换 (Quota-Expiry-First)：多个账号可用时，优先切换到重置窗口最早到期的账号，把"还剩很久才重置"的额度留给后面，整体池化利用率最大化。
- 🧠 网络抖动智能甄别 (Jitter-Safe Auth)：代理抖动导致的 keyring 鉴权超时会被自动识别为可重试的网络错误而非"登录失效"——基于 agy 本次运行日志的 keyringAuth 传输证据精准分类，且粘性"需重新登录"隔离需二次确认，健康账号绝不会被误标。
- 📊 官方多 Bucket 配额监控 (Multi-Bucket Quota)：直接调用 Antigravity 官方专用的 v1internal:retrieveUserQuotaSummary 接口，同时展示 5小时滚动额度、7天周额度，以及付费 Pro/Ultra 账号专属的 Gemini 4 Argon 独立周额度池（不占用普通 Gemini 池）。
- 🔀 手动切换当前账号 (Manual Switch-Active)：控制台卡片一键「设为当前使用」，即刻把调度指针钉到指定账号。
- 🔑 GUI 内浏览器免粘贴登录 (In-GUI Zero-Paste OAuth)：点击「➕ 添加账号」自动调起系统浏览器，本地回环监听自动捕获授权凭证，全程无需手动复制粘贴授权码。
- 🎨 多主题高对比度自适应 (Light & Dark Themes)：原生适配 DSH 浅色/深色主题，告别发暗发灰与看不清文字，UI 视觉清晰锐利。
- 🌐 独立账号网络代理 (Per-Account Proxy)：支持为每个账号独立绑定 HTTP(S) / SOCKS 代理，避免多账号同 IP 引起风控；未显式配置时自动探测系统代理（macOS scutil / Windows 注册表 / Linux gsettings）。
- ⚡ 分模型族独立冷却 (Family-Scoped Cooldown)：Gemini、Claude、GPT-OSS 与 Argon 的速率限制独立计算，某个模型族受限不影响其他模型族正常调用。

✨ 全功能特性一览

| 能力 | 说明 |
| 🎨 官方专属矢量 Logo | 36×36 高质感纯矢量微标（assets/icon.svg），透明底自适应深浅主题；设置左侧导航菜单（[role="dialog"] nav）动态替换系统齿轮，呈现专属品牌标识 |
| 🧩 设置与插件面板统一 | 在 DSH「设置 → 插件」详情页直接内嵌 Antigravity 完整控制台，账号池、配额监控与代理配置一站式操作，列表保持轻量整洁 |
| 🚀 副账号并发租约 | Windows 凭据槽支持同一副账号多会话共享租约并发运行，消除单账号多任务排队饥饿；仅在跨账号身份切换时串行交接 |
| ⚡ 原生上下文缓存与真实计量 | 完整映射 Google Gemini 原生上下文缓存协议（cache_read_tokens），精准追踪缓存读取与物理上下文占用，深度适配 1M 超长上下文 |
| 👥 多账号池化轮换 | 支持主账号 + 多个备用账号；遇到 429 或配额耗尽自动平滑切换，模型族独立冷却，额度到期早的账号优先接班 |
| 🧠 抖动安全鉴权 (Jitter-Safe Auth) | 基于 agy 运行日志的 keyring 传输证据区分"网络抖动"与"真登出"，抖动自动按可重试网络错误处理；粘性隔离需二次确认，杜绝误标"需重新登录" |
| 📊 官方多 Bucket 配额监控 | 实时拉取官方端点，同时呈现 5h 滚动额度、7d 周额度与 Argon 独立周池（付费 Pro/Ultra）多进度条与倒计时，单模型明细可展开 |
| 🔑 浏览器一键登录 | 点击添加账号自动唤起 Google 授权页，本地回环自动捕获，全程无需复制粘贴任何代码 |
| 🔀 手动切换当前账号 | 控制台「设为当前使用」按钮即刻钉住调度指针；顶部徽标始终显示服务器实际调度的账号 |
| 🎨 多主题高对比 UI | 浅色、深色主题自适应变色，纯矢量 SVG 图标（无 Emoji），字迹清晰不发暗 |
| 🌐 独立账号代理 | 每个账号支持独立配置 HTTP(S) 代理，隔离 IP 出口；亦可自动探测系统代理 |
| 🔌 原生模型路由 | 在 DSH 模型配置中注册 antigravity 提供方，/model 选择器随心切换 Gemini / Claude / GPT-OSS / Argon |
| 🌊 完整流式映射 | 文本、思考过程（thinking turn）与工具活动均无损映射到 DSH 原生流协议 |
| 🃏 原生工具卡片 | agy 执行的终端命令（run_command）、文件修改（inline diff）均以 DSH 原生卡片渲染 |
| 🔗 会话上下文保真 | DSH 会话与 agy 原生会话绑定（--conversation），由 agy 管理完整历史，每轮仅发送增量 |
| 🎯 DSH 目标与计划集成 | 长任务自动携带 DSH goal / plan 上下文，工具续跑不丢任务状态 |
| 📊 精确 Token 统计 | 输入 / 输出 / 思考 / 缓存读取 token 完整计入 DSH 用量统计，全面适配 1M 上下文 |
| 🎛 顶部控制台徽标 | 顶部栏 AGY (n) 徽标一键弹出控制台，直观查看账号池、配额进度条与代理状态 |
| 🖼 图片多模态 | 支持多模态图片传入，自动落盘本地媒体目录并通过 --add-dir 安全授权给 agy 查看 |
| 🤝 agy_ask 辅助工具 | 允许任意 DSH 模型把单次任务委托给 Antigravity 模型（AskAntigravity 协作模式） |
| ⌨️ /agy 快捷命令族 | status / pool / auth / models / mode / effort / workspace / goal / session / enable-account / disable-account / 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 命令行 | 按 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 |
| hiddenModels | DSH_AGY_HIDDEN_MODELS | [] | 在 /model 选择器中隐藏的模型 slug 列表（黑名单语义，新模型默认可见；建议直接在设置面板「模型显示」中点选管理） |
| timeoutMs | DSH_AGY_TIMEOUT_MS | 600000 | 单轮活跃看门狗超时（毫秒） |
| longToolIdleMinutes | DSH_AGY_LONG_TOOL_IDLE_MINUTES | 240 | 存在未完成工具步骤（ACTIVE）时的空闲预算（分钟）；0 = 不抬高预算，卡死的工具按 timeoutMs 快速失败 |
| workspaceRoot | DSH_AGY_WORKSPACE_ROOT | 会话 cwd | agy 工作区根目录（默认跟随当前会话工作区） |
| suppressAgyAutoUpdate | DSH_AGY_SUPPRESS_AUTOUPDATE | Windows true，其他平台 false | 每次 spawn 前刷新 agy 的更新检查时间戳，阻断 --bg-updater 子进程链（Windows 闪窗根因）。关闭后 agy 恢复自动更新检查 |
| autoWarmup | DSH_AGY_AUTO_WARMUP | false | 7 天周配额自动预热（opt-in）：周额度到达重置时间或冷启动时发送极小探活请求，提前激活 7 天计时器。开启后每 5 分钟巡检一次；该路径直连 Google 内部端点，请自行评估风控风险 |
| warmupModels | DSH_AGY_WARMUP_MODELS | gemini-3.8-flash,claude-sonnet-4-6 | 自动预热使用的模型列表（逗号分隔）；空数组表示不自动预热 |

🧩 架构与工作原理

1. 短生命周期进程驱动：每一轮 DSH 对话启动一个独立的官方 agy -p --output-format stream-json 进程，解析 NDJSON 事件流。
2. 多账号沙箱机制：除主账号沿用系统默认 Keychain / HOME 外，所有备用账号在插件私有目录下建立专属 HOME 隔离区，独立写入 agy 格式的标准 OAuth 凭证。Windows 上 agy 的凭据实际存放在机器级 Credential Manager（gemini:antigravity），插件因此以「身份级引用计数租约」接管该槽：同一授权的多个会话并行运行，只有账号身份切换才串行，且由最后一个持有者还原主账号凭据。
3. 多 Bucket 官方配额汇总：插件定时后台静默轮询官方 v1internal:retrieveUserQuotaSummary，精准掌控每个账号的 5h 滚动削峰水位、7d 账号阶梯周额度，以及付费账号的 Argon 独立周池。
4. 会话级无缝故障转移：当遭遇 HTTP 429、额度耗尽或凭证异常时，号池调度器自动标记当前账号家族进入冷却（或按额度到期时间择优轮换），并无缝将后续请求路由到池内下一个有效账号。
5. 失败分类与自愈：错误按 AUTH / NETWORK / RATE_LIMIT / ELIGIBILITY 等精确分类；网络抖动借由 agy 运行日志自动甄别为可重试故障，绝不误伤健康账号的登录状态。

❓ 常见问题排查 (FAQ)

Windows 平台开始对话时为什么会短暂闪一下黑色命令行窗口（黑框）？

答：这是 Windows 系统的控制台分配机制，完全良性，不会影响对话和模型功能。
- 原因分析：DSH 是基于 Electron 的图形桌面应用（GUI 进程）。每次发起对话时，插件都要调用底层命令，校验并同步当前账号在 Windows 凭据管理器（Credential Manager）中的 OAuth Token，随后启动 agy.exe 控制台子进程，建立流式通信。在 Windows 11 下，如果系统默认终端设成了「Windows 终端 (Windows Terminal)」，Windows Terminal 会拦截后台控制台子进程的句柄分配，并闪现弹窗（这是 Windows Terminal 已知的 OpenConsole 委托拦截机制）。
- 解决步骤：
1. 打开 Windows 终端 (Windows Terminal) 的「设置」→「启动」（或进入 Windows「设置」→「系统」→「开发者选项」）。
2. 把 默认终端应用程序 (Default terminal application) 从「让 Windows 决定」或「Windows 终端」改为 「Windows 控制台主机 (Windows Console Host)」。
3. 点击右下角 保存 (Save)。
4. 完全退出并重启 DSH（让新启动的主进程应用更新后的控制台委托注册表），黑框闪烁即可彻底消除。

agy 自己的自动更新子进程也会闪窗（0.4.66 修复）

除了上面那种控制台委托导致的闪窗，agy 自己还会在距上次更新检查满 15 分钟后派生一条 --bg-updater → agy --version 的子进程链。这条链由 agy 内部创建，会自行分配可见控制台，父进程的 windowsHide 和 AGY_CLI_DISABLE_AUTO_UPDATE=1 都来不及生效（这就是 Issue #49 实测确认的结论）。

0.4.66 起的处理方式：每次 spawn agy 之前，插件把 agy 更新检查的 fast-path 时间戳（<agy home>/last_check.timestamp）刷新为当前时间。agy 的检查逻辑是「距上次检查 < 15 分钟就直接跳过且不派生子进程」，于是这条可见窗口链根本不会被创建——对话、冷启动探测、模型选择器刷新、登录探测全部覆盖。

- 代价：插件所使用的那个 agy home 不再自动检查更新；手动 agy update 完全不受影响。
- 开关：suppressAgyAutoUpdate（环境变量 DSH_AGY_SUPPRESS_AUTOUPDATE）。Windows 上默认开启，其他平台默认关闭；设为 false 即回到 agy 原本的自动更新行为。
- 旧版本用户的手动 workaround：把 %USERPROFILE%\.gemini\antigravity-cli\updater\update.lock 设为只读（attrib +R ...），agy 拿不到更新锁就会跳过检查。代价是手动 agy update 会报 update already in progress，需要先 attrib -R。

🙏 参考与致谢

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

⚠️ 免责声明

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

许可证

MIT License.

把 Google Antigravity 模型接入 DeepSeek Harness (DSH) — 支持 多账号池化与自动轮换、官方多桶配额追踪（5h 滚动 + 7d 每周 + Argon 每周池）、零粘贴的 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 里，点击账号卡片上的「🌐 Proxy」按钮，为每个账号单独配置代理 URL（例如 http://127.0.0.1:7890）。

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

手上有多个 Google Antigravity / Gemini 账号？dsh-agy-link 让多账号调度变得顺畅、自动化：

- 👥 多账号池：管理不限数量的 Google 账号（主池 + 副池），HOME 沙箱环境和凭据完全隔离。
- 🔄 顺序耗尽故障转移：账号触发速率限制（429）或 5 小时 / 每周配额用尽时，请求会自动、平滑地切到下一个可用账号，对话不中断！
- 🕰 配额到期优先轮换：有多个账号可用时，调度器优先选重置窗口最早到期的那个，把整个账号池的利用率拉满。
- 🧠 抖动安全的鉴权分类：代理抖动导致的 keyring 鉴权超时，会被识别为可重试的网络错误，而不是登出——判断依据是 agy 自身运行日志里的 keyringAuth 传输证据；粘性的「需要重新登录」隔离状态需要二次确认，健康账号绝不会被误标。
- 📊 官方多桶配额追踪：直接对接 Antigravity 官方的 v1internal:retrieveUserQuotaSummary 端点，实时查看 5 小时滚动限额、7 天每周限额和 Gemini 4 Argon 每周池（付费 Pro / Ultra 账号，与普通 Gemini 池分开计费）。
- 🔀 手动切换活跃账号：点一下「Set active」，调度器指针就固定到你选的账号。
- 🔑 图形界面内零粘贴 OAuth：一键「Add Account」打开浏览器，通过本地回环自动捕获 OAuth token——不用复制粘贴授权码。
- 🎨 主题自适应高对比度界面：无缝适配 DSH 的浅色和深色主题，字体清晰，对比锐利。
- 🌐 按账号配置代理：为每个账号单独配置 HTTP(S) / SOCKS 代理，隔离 IP 地址；不设置时自动探测系统代理（macOS scutil / Windows 注册表 / Linux gsettings）。
- ⚡ 按模型系列隔离的冷却：Gemini、Claude、GPT-OSS 和 Argon 的速率限制各自独立计算，某个模型额度耗尽不会拖累其他模型。

✨ 功能总览

| 功能 | 说明 |
| 🎨 官方矢量 Logo | 干净的 36×36 视网膜矢量图标（assets/icon.svg），背景透明；在 DSH 设置侧边栏（[role="dialog"] nav）里动态替换默认齿轮图标 |
| 🧩 统一设置与插件控制台 | 把 Antigravity 控制台直接嵌进 DSH 插件设置；账号池、配额、代理都在一处配置，列表卡片依然清爽 |
| 🚀 副账号并行租约 | Windows 凭据槽允许同一账号上的多个会话并发共享租约，不会排队饿死；只有跨账号切换才串行 |
| ⚡ 原生上下文缓存与 token 计量 | 转发 Google Gemini 原生提示词缓存（cache_read_tokens）；准确追踪缓存读取，真实反映 1M 上下文窗口的提示词占用 |
| 👥 多账号池 | 主账号加无限备用账号，触发速率限制时自动按顺序轮换（Sequential Drain）；优先调度配额即将到期的账号 |
| 🧠 抖动安全鉴权 | 借助 agy 运行日志里的 keyring 传输证据，区分网络抖动和真正掉登录；粘性隔离需人工确认，不会误报「需要重新登录」 |
| 📊 多桶配额 HUD | 5 小时滚动、7 天每周、Argon 每周（付费 Pro/Ultra）三个池的实时进度条，附精确重置倒计时 |
| 🔑 零粘贴浏览器登录 | 自动走浏览器 Google OAuth 登录，带回环回调处理器 |
| 🔀 手动切换活跃账号 | 在控制台把调度器钉到任意账号；顶部徽标始终显示服务端调度的账号 |
| 🎨 主题自适应 UI | 明暗主题动态切换，纯 SVG 矢量图标（不用 emoji），高对比度 |
| 🌐 按账号代理 | 每个账号槽可配独立 HTTP(S) 代理，也可自动探测系统代理 |
| 🔌 原生模型路由 | 在 DSH 注册 antigravity 服务商；在 /model 选择器里挑 Gemini / Claude / GPT-OSS / Argon |
| 🌊 完整流式协议 | 文本、思考轮次标注、工具调用全部原生流式输出 |
| 🃏 原生工具 UI 卡片 | 命令执行和行内 diff 渲染成干净的 DSH 原生工具卡片 |
| 🔗 会话连续性 | 把 DSH 会话绑定到原生 agy 对话（--conversation），上下文零冗余 |
| 🎯 DSH 目标与计划集成 | 长任务在工具续接之间携带 DSH 目标 / 计划上下文 |
| 📊 精确 token 计量 | 输入、输出、思考、cacheRead token 全部上报 DSH，支持 1M 上下文 |
| 🎛 顶部控制台徽标 | 点顶部 AGY (n) 徽标，立刻打开管理控制台 |
| 🖼 多模态图片 | 把图片暂存到本地，通过 --add-dir 传入安全的绝对路径 |
| 🤝 agy_ask 委派 | 允许其他 DSH 模型把子任务委派给 Antigravity 模型 |
| ⌨️ /agy 命令 | 完整命令集：status、pool、auth、models、mode、effort、workspace、goal、session、enable-account、disable-account、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 命令行 | 按 Google 官方指南 安装。用 agy --version 验证 |

🚀 快速开始

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!

⚙️ 配置

| 键 | 环境变量 | 默认值 | 说明 |
| 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) | 默认模型 slug |
| defaultEffort | DSH_AGY_DEFAULT_EFFORT | (model default) | 思考预算：low / medium / high |
| hiddenModels | DSH_AGY_HIDDEN_MODELS | [] | 在 /model 选择器中隐藏的模型 slug（拒绝列表，新发现的模型仍可见；在设置面板的「Model visibility」一行管理） |
| timeoutMs | DSH_AGY_TIMEOUT_MS | 600000 | 活动看门狗超时，单位毫秒 |
| longToolIdleMinutes | DSH_AGY_LONG_TOOL_IDLE_MINUTES | 240 | 工具步骤处于 ACTIVE 状态时的空闲预算（分钟）；0 表示沿用常规 timeoutMs 预算，让卡死的工具快速失败 |
| workspaceRoot | DSH_AGY_WORKSPACE_ROOT | 会话 cwd | 工作目录根路径 |
| suppressAgyAutoUpdate | DSH_AGY_SUPPRESS_AUTOUPDATE | Windows 上为 true，其他平台为 false | 每次启动前刷新 agy 的更新检查时间戳，让它那条 --bg-updater 子进程链（Windows 控制台闪窗的根源）永不启动。设为 false 则恢复 agy 自带的自动更新检查 |
| autoWarmup | DSH_AGY_AUTO_WARMUP | false | 可选开启的 7 天周配额预热：当周窗口已重置或处于冷状态时，发送一次最小探测，激活 7 天计时器。每 5 分钟扫描一次；这条路径直接与 Google 内部端点通信，风险控制的取舍请自行评估 |
| warmupModels | DSH_AGY_WARMUP_MODELS | gemini-3.8-flash,claude-sonnet-4-6 | 预热探测使用的模型列表（逗号分隔）；空列表会关闭自动预热 |

无头运行

有界复现、最小权限读规则校验、进程与工具的验收检查，见 无头权限。

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

两种模式都不要假设存在未文档化的通配符语义。请在限定工作区内，针对确切的 agy 版本和命令集做测试。只有当你明确接受无人值守的工具执行时，才选择 skip。

❓ 常见问题与故障排查

在 Windows 上开始对话时，为什么黑色命令提示符 / 终端窗口会短暂闪一下？

答：这是 Windows 控制台子系统的外观行为，完全无害。
- 根本原因：DSH 是 Electron 桌面应用（GUI 进程）。每轮对话开始前，插件通过 Windows 凭据管理器校验/同步 Google 凭据，并启动 agy.exe 控制台子进程做流式输出。在 Windows 11 上，如果系统默认终端设为「Windows Terminal」，Windows Terminal 会拦截后台控制台分配，瞬间闪出一个空窗口（这是 Windows Terminal OpenConsole 委托的已知行为）。
- 解决办法：
1. 打开 Windows Terminal → 设置 → 启动（或 Windows 设置 → 系统 → 开发者选项）。
2. 把 默认终端应用程序 从「让 Windows 决定」或「Windows Terminal」改为 「Windows 控制台主机」。
3. 点击右下角 保存。
4. 完全退出并重启 DSH，让正在运行的主进程读取更新后的控制台委托设置。

agy 自带的自动更新器也会闪窗口（0.4.66 已修复）

除了上面说的控制台委托闪烁，agy 自身在距上次更新检查超过 15 分钟后，会拉起一条 --bg-updater → agy --version 子进程链。这条链在 agy 内部创建，会分配自己的可见控制台，所以父进程的 windowsHide 和 AGY_CLI_DISABLE_AUTO_UPDATE=1 都来不及生效——这正是 issue #49 中记录的测量结论。

从 0.4.66 起，插件在每次启动前刷新 agy 的快路径时间戳（<agy home>/last_check.timestamp）。agy 会跳过在运行不足 15 分钟时完全跳过检查，也不启动任何进程，所以可见的窗口链根本不会出现——轮次、启动探测、模型选择器刷新、登录探测都是如此。

- 代价：本插件使用的 agy 主目录不再自动检查更新；手动执行 agy update 仍然正常。
- 开关：suppressAgyAutoUpdate（环境变量 DSH_AGY_SUPPRESS_AUTOUPDATE）。Windows 上默认开启，其他平台默认关闭；设为 false 可恢复 agy 自身的行为。
- 旧版本的手动变通方案：把 %USERPROFILE%\.gemini\antigravity-cli\updater\update.lock 设为只读（attrib +R ...）。这样 agy 拿不到更新锁，就会跳过检查——代价是 agy update 会报 update already in progress，直到你执行 attrib -R。

⚠️ 免责声明

本插件严格只调用你本地系统上安装的官方、未修改的 agy 命令行二进制文件。使用本插件需遵守 Google Antigravity 的服务条款。

许可证

MIT License。