dsh-agy-link

dsh plugin --profile web add dsh-agy-link

<h1 align="center">🛰️ dsh-agy-link</h1>

<p align="center">

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

</p>

<p align="center">

<a href="https://www.npmjs.com/package/dsh-agy-link"><img src="https://img.shields.io/npm/v/dsh-agy-link?color=cb3837&label=npm&logo=npm" alt="npm"/></a>

<a href="https://github.com/amlyczz/dsh-agy-link/actions/workflows/ci.yml"><img src="https://github.com/amlyczz/dsh-agy-link/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>

<img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT"/>

<img src="https://img.shields.io/badge/node-%3E%3D24-green" alt="node"/>

<img src="https://img.shields.io/badge/agy-v0.5.1-purple" alt="agy v0.5.1"/>

</p>

<p align="center">

<b>🌐 Language / 语言：</b>

<a href="#中文">中文</a> ·

<a href="#english">English</a> ·

<a href="./docs/README.pt-BR.md">Português (Brasil)</a> ·

<a href="./docs/README.es.md">Español</a> ·

<a href="./docs/README.en.md">English (standalone)</a> ·

<a href="./docs/CONFIGURATION.md">完整配置文档</a>

</p>

---

中文

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

<p align="center">

<img src="./docs/assets/console.png" alt="Antigravity 管理控制台 - 多账号池化与配额监控" width="760" />

</p>

<p align="center">

<img src="./docs/assets/model-picker.png" alt="DSH 模型选择器中的 Antigravity 模型列表" width="280" />

&nbsp;&nbsp;

<img src="./docs/assets/settings.png" alt="DSH 设置 → 插件中的 Antigravity 设置面板" width="540" />

</p>

<p align="center">

<img src="./docs/assets/token-usage.png" alt="原生上下文缓存与 Token 用量统计" width="340" />

&nbsp;&nbsp;

<img src="./docs/assets/context-metering.png" alt="1M 物理上下文负载精确计量" width="340" />

</p>

---

🚨 【国内用户核心前置：必须开启系统代理 / 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 或运行命令前请在终端中执行：

```bash

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 视觉清晰锐利。
• 📱 手机 Web 端响应式自适应 (Mobile Web)：控制台在屏幕宽度小于 680px 时自动变为全屏抽屉面板（100dvh），标签与开关控件折行重排，配额条独占单行，操作按钮等宽网格分布，并在多尺寸设备（360×800、390×844、768×1024）实测无横向溢出。
• 🗣 DSH 原生大白话翻译卡片 (/tsl)：卡片沿用 DSH 自己的观感（0.5px 细描边、markdown 代码块底色、12px 圆角、横幅表头），只用一枚单色 Gemini 星标 + 「Gemini 译文」标签标明出处，深浅主题全由 DSH 令牌决定，不再是一块品牌渐变横幅；每个 DSH 会话绑定独立翻译会话（<sessionId>#tsl），仅首轮注入人格，后续仅传指令行，共享主号池与故障转移。
• 🧠 思考强度自适应学习 (Effort Learning)：当模型拒绝 --effort 参数时，自动无 effort 原样重放确保轮次完成，持久化记录至本地文件并自动收回该机型的档位声明，避免后续重复报错。
• 🌐 独立账号网络代理 (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），字迹清晰不发暗

📱 手机 Web 端自适应 · 屏幕宽度 < 680px 时控制台自动转为全屏抽屉面板（100dvh），标签开关折行重排，操作按钮等宽网格分布，全面适配触屏滚动

🌐 独立账号代理 · 每个账号支持独立配置 HTTP(S) 代理，隔离 IP 出口；亦可自动探测系统代理

🔌 原生模型路由 · 在 DSH 模型配置中注册 antigravity 提供方，/model 选择器以 Antigravity (agy CLI) 分组随心切换 Gemini / Claude / GPT-OSS / Argon

🌊 完整流式映射 · 文本、思考过程（thinking turn）与工具活动均无损映射到 DSH 原生流协议

🃏 原生工具卡片 · agy 执行的终端命令（run_command）、文件修改（inline diff）均以 DSH 原生卡片渲染；MCP 元工具（call_mcp_tool）自动拆包为 Terminal/Search 卡片

🔗 会话上下文保真 · DSH 会话与 agy 原生会话绑定（--conversation），由 agy 管理完整历史，每轮仅发送增量

🎯 DSH 目标与计划集成 · 长任务自动携带 DSH goal / plan 上下文，工具续跑不丢任务状态

📊 精确 Token 统计 · 输入 / 输出 / 思考 / 缓存读取 token 完整计入 DSH 用量统计，全面适配 1M 上下文

🎛 顶部控制台徽标 · 顶部栏 AGY · 别名 / AGY (n) 徽标一键弹出控制台，直观查看账号池、配额进度条与代理状态

🖼 图片多模态 · 支持多模态图片传入，自动落盘本地媒体目录并

…(truncated)