@luchenglong/cli-bridge 0.0.0-stage → 0.2.2

package/README.md

@@ -1,3 +1,151 @@
-# Temporary Holding Version
+# cli-bridge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**简体中文** · [English](README.en.md)
+
+> 一个用于 **DeepSeek Harness (DSH)** 的 Cordis 插件包：把编码/构建/调试/排查等实际工作
+> **优先派发给本机 CLI agent** —— Google **Antigravity（`agy`）**、腾讯 **CodeBuddy Code**、
+> 小米 **MiMo（MiMoCode CLI / MiMo Desktop）** —— DSH 全程掌控这些 CLI（非交互、无提示），
+> 并在 **限流 / 网络不通** 时弹窗让用户选择是否回退到 **DSH 本地 API 配置**；会话标题栏提供
+> **一盏聚合实时状态灯**（三家分区），设置面板统一三家偏好与凭据。
+>
+> 本包整合并取代三个旧包：`agy-first-bridge`（1.7.1 终版）、`codebuddy-first-bridge`（1.6.2 终版）、
+> `mimo-first-bridge`（1.2.9 终版）。旧包已 deprecated，功能全部并入此处；迁移见
+> [docs/MIGRATION.md](docs/MIGRATION.md)。
+
+![聚合状态灯的几种状态](assets/indicator-states.svg)
+
+---
+
+## 这是什么
+
+`@luchenglong/cli-bridge` 给运行中的 DSH 注入：
+
+1. **每家三个模型工具** —— `<id>_run` / `<id>_continue` / `<id>_status`
+   （agy 另有 `agy_quota`，mimo 另有 `mimo_settings`），把任务转交给本机 CLI 执行；
+   **工具名与入参语义与旧包逐字一致**，历史会话提示词零改动继续可用。
+2. **一段 CLI 优先策略提示**（每家各自 POLICY 段），让模型在所有模式下优先把实际工作
+   派发给对应 CLI，原生工具只用于只读查询与最终验证。
+3. **一盏聚合状态灯（家级插件，随 DSH 启动加载）**：标题栏 pill 汇总三家状态
+   （绿=就绪/成功、黄=运行中、红=失败、灰=不可用、琥珀=本地回退、preset 高亮=本会话运行在桥接预设下）；
+   悬停看当前步骤，点击展开按 provider、按项目（工作目录）的活动面板 ——
+   每项目实时步骤折叠（当前工具 + 参数摘要 + 轨迹）、runs/tokens 累计、最近完成运行。
+4. **统一设置面板**（DSH 设置页「CLI Bridge」段）：**横向标签页** —— 「总设置」+ 每个 CLI 一页，
+   点名字切换、同屏只渲染一张卡（页长不随 CLI 数量增长）；每家字段由 provider 自己声明
+   （meta 驱动渲染）；token 类字段永不明文回传；保存写
+   `{DSH_HOME}/cli-bridge-settings.json`（按 provider 分区）；**旧包设置文件自动一次性迁移**。
+5. **调度（0.2.0+）**：「总设置」页勾选**启用哪些 CLI**（决定调用面数量）+ `↑↓` 排定**调用优先级**，
+   一次保存同时贯通预设、动态宿主与 MCP 三种形态 —— 详见 [调度](#调度启用哪些-cli与调用优先级)。
+
+## 四种形态
+
+同一套 provider 描述符（单一事实来源）驱动四种落地形态：
+
+| 形态 | 位置 | 能力 | 状态灯 |
+| --- | --- | --- | --- |
+| **持久 Agent Preset**（推荐） | [`preset/<dir>/`](preset/) | 工具 + POLICY + 回退弹窗 + 三家预设（`cordis-agy` / `codebuddy-first` / `cordis-mimo`） | ✅（家级灯自动点亮） |
+| **家级插件（指示灯+设置+声明注册）** | [`home-plugin/cli-bridge-indicator/`](home-plugin/cli-bridge-indicator/) | HTTP 路由 + 浏览器 pill/面板/设置 + **preset 声明制注册** | 本体 |
+| **动态宿主（沙箱插件）** | [`dynamic/<id>.host.js`](dynamic/)（由模板生成） | 无 preset 时在任意组合里挂载工具 | ✅（经收集器汇入） |
+| **MCP stdio server** | [`mcp/cli-bridge-mcp.mjs`](mcp/)（bin `cli-bridge-mcp`） | 任何 MCP 客户端（Claude Code/Cursor/DSH 外部）直连本机三家 CLI | ✅（快照文件桥接，见下） |
+
+MCP 接入（一个 server 暴露全部三家工具；只想要一家用兼容入口或 `--provider=`）：
+
+```json
+{
+  "mcpServers": {
+    "cli-bridge": {
+      "command": "node",
+      "args": ["/path/to/node_modules/@luchenglong/cli-bridge/mcp/cli-bridge-mcp.mjs"]
+    }
+  }
+}
+```
+
+旧包单家配置迁移：`node mcp/agy-mcp-server.mjs`（等价 `--provider=agy`），env 变量名不变。
+
+**MCP 形态的状态灯**：MCP 是独立进程，没有 `ctx.emit`，故它把每台状态原子写入
+`{DSH_HOME}/cli-bridge-mcp-<id>.json`（90s 内有效），家级灯轮询合并 —— 你在 DSH 外面
+用 Claude Code 跑 agy，DSH 标题栏照样亮。
+
+## 调度（启用哪些 CLI 与调用优先级）
+
+设置页「CLI Bridge 桥接」→「总设置」标签：勾选要启用的 CLI（决定智能体可调用的 CLI 数量），
+`↑↓` 排定调用优先级（首位最高）。每个 CLI 另有自己的标签页（后端字段驱动 + 诊断）。
+
+**落盘**：`{DSH_HOME}/cli-bridge-settings.json` 顶层 `_scheduling = { enabled, priority }`
+（下划线前缀 = 非 provider 分区，旧版本读该文件时整区忽略 → 纯增量兼容）。
+派生 `order = priority ∩ enabled`：`enabled` 是集合（数组顺序无意义），`priority` 的**数组顺序即优先级**。
+
+**一次配置贯穿四种形态**：
+
+| 生效面 | 行为 |
+| --- | --- |
+| preset / 动态宿主 | `apply()` 首行门禁：禁用面**不注册任何工具、策略段、心跳**；启用面按优先级排注册顺序 |
+| 声明制 preset 注册 | 三个 preset 恒常注册（禁用 ≠ 从目录消失，仍可切入排查），注册顺序按优先级 |
+| MCP 形态 | `enabled` 过滤工具面、`order` 排序；启动读一次（重启子进程刷新），家级 `bin\` 服务器**每请求现读**（面板改完立即生效） |
+| 状态灯与设置视图 | `GET /cli-bridge/status`、`GET /cli-bridge/settings` 每次轮询现读并附 `scheduling` 快照（`enabled/priority/order/all/labels`） |
+
+**语义与边界**：
+
+- **fail-open**：文件缺失 / 坏值 / 无 fs → 全部启用（读不到配置 ≠ 关掉所有桥）；
+  只有**显式** `enabled: []` 才是「全关」，且面板会红字提示「三形态都不会注册任何 CLI 工具」。
+- **钉住优先**：env `CLI_BRIDGE_PROVIDER` 或 `--provider=<id>`（MCP 形态的薄封装）优先级最高，
+  用于「这个客户端只要 agy」的单面用法；宿主形态传 `ignorePin`，不会被全局 env 反噬。
+- **指示灯不长明**：超过 10 分钟无活动且未运行的项目不再渲染为常亮灯（历史仍保留在点击弹窗里）。
+
+**加第 N 家 CLI**：只改 `providers/registry.mjs`（id 唯一轴）+ 交付该 provider 的描述符；
+调度卡的选项、标签页、状态灯、设置保存循环与构建派生物全部自动跟上 —— 契约见
+[PROVIDER-CONTRACT.md](PROVIDER-CONTRACT.md) §3.1。
+
+## 架构速览
+
+```
+providers/registry.mjs ── createProvider(id) ─┬─ providers/agy.mjs      ┐
+core/bridge-kit.mjs（状态引擎/runner/限流/     ├─ providers/codebuddy.mjs ├─ 同一描述符驱动
+ 回退/渲染/MCP 载荷，零 import）               └─ providers/mimo.mjs     ┘   四种形态
+home-plugin/cli-bridge-indicator/
+  ├ index.mjs      统一状态机（租约/合并/stale） + HTTP 路由 + 收集器
+  ├ settings.mjs   分区设置读写 + 掩码 + 旧文件迁移
+  ├ preset-declarations.mjs  声明制注册（Form-A 自注册，全版本可用）
+  └ client.js      浏览器 pill/面板/设置（标签页 + 调度卡 + 陈旧过滤；注册 id ≡ 包名，红线，CI 锁）
+preset/standard-base.mjs + preset/<dir>/plugin-list.mjs ── scripts/build.mjs ──> agent.cordis.yml / preset.yml / dynamic/*.host.js
+```
+
+- 开发/移植第三家 CLI？契约见 [PROVIDER-CONTRACT.md](PROVIDER-CONTRACT.md)，一次实现一个描述符即可接入全部形态。
+- 为什么 preset id 和工具名不变？旧会话头/提示词引用它们（红线清单在契约 §0）。
+- 生成物为什么提交进仓库？fresh clone 直接可装可用；`node scripts/build.mjs --check` 在 CI/prepack 防漂移。
+
+## 安装
+
+```bash
+npm install -g @luchenglong/cli-bridge        # MCP 用：cli-bridge-mcp 已在 PATH
+```
+
+DSH 接线（home-plugin bundle + presets + 指示灯一次装齐）见 **[docs/INSTALL.md](docs/INSTALL.md)**。
+要点：包带 `dsh.bundle.patch`（bundle 面自注册），DSH profile 加入该 bundle 后
+三盏能力 + 三家 preset + 设置面板 + 状态灯一次到位；本仓库脚本 `npm run deploy:local`
+只做到「暂存目录」，不改运行时接线（需先停 DSH）。
+
+## 开发
+
+```bash
+node scripts/build.mjs        # 生成 dynamic 宿主 + legacy YAML
+node scripts/verify.mjs       # 发布红线（client id/exports/描述符完整度…）
+node --test                   # 单测（含每家 tests/<id>/）
+node mcp/cli-bridge-mcp.mjs --check   # MCP 自检
+npm run check                 # 三闸门全量
+```
+
+## 文档
+
+- [docs/INSTALL.md](docs/INSTALL.md) — 安装与接线（含旧包迁移）
+- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — 三形态共享内核设计、状态机与红线论证
+- [docs/MIGRATION.md](docs/MIGRATION.md) — 从三个旧包迁移对照表
+- [MCP-POLICY.md](MCP-POLICY.md) / [中文版](docs/MCP-POLICY.zh.md) — 给外部 MCP 客户端（Claude Code/Codex）的派发策略卡
+- [docs/RELEASE-SOP.md](docs/RELEASE-SOP.md) — 发版流程与红线检查
+- [docs/FALLBACK-AND-INDICATOR.md](docs/FALLBACK-AND-INDICATOR.md) — 回退弹窗与状态灯语义详解
+- [PROVIDER-CONTRACT.md](PROVIDER-CONTRACT.md) — provider 接入契约（冻结）
+- [CHANGELOG.md](CHANGELOG.md) + [docs/history/](docs/history/) — 统一历史与三家 lineage 全量历史
+
+## 许可
+
+[MIT](LICENSE)

package/assets/indicator-states.svg

@@ -0,0 +1,62 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="760" height="330" viewBox="0 0 760 330" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif">
+  <rect width="760" height="330" fill="#ffffff"/>
+  <text x="20" y="30" font-size="17" font-weight="600" fill="#1f2328">CLI Bridge 聚合状态灯（一盏 pill，三家分区）</text>
+
+  <!-- helper row labels -->
+  <g font-size="12.5" fill="#57606a">
+    <text x="20" y="70">就绪 / 成功</text>
+    <text x="20" y="115">运行中</text>
+    <text x="20" y="160">失败</text>
+    <text x="20" y="205">不可用（未安装/未登录）</text>
+    <text x="20" y="250">本地回退（DSH API 接管中）</text>
+    <text x="20" y="295">预设高亮（本会话跑在桥接 preset 下）</text>
+  </g>
+
+  <!-- row 1 ready -->
+  <g>
+    <rect x="230" y="52" rx="12" width="240" height="26" fill="#dafbe1" stroke="#1a7f37"/>
+    <circle cx="246" cy="65" r="6" fill="#1a7f37"/>
+    <text x="258" y="69" font-size="12.5" fill="#116326">AGY · CB · MIMO 就绪</text>
+  </g>
+  <!-- row 2 running -->
+  <g>
+    <rect x="230" y="97" rx="12" width="252" height="26" fill="#dbeafe" stroke="#3b82f6"/>
+    <circle cx="246" cy="110" r="6" fill="#3b82f6">
+      <animate attributeName="opacity" values="1;0.35;1" dur="1.2s" repeatCount="indefinite"/>
+    </circle>
+    <text x="258" y="114" font-size="12.5" fill="#1d4ed8">AGY 工作中… read(index.mjs)</text>
+  </g>
+  <!-- row 3 failed -->
+  <g>
+    <rect x="230" y="142" rx="12" width="240" height="26" fill="#ffebe9" stroke="#cf222e"/>
+    <circle cx="246" cy="155" r="6" fill="#cf222e"/>
+    <text x="258" y="159" font-size="12.5" fill="#a40e26">CB 失败 HUNG_TIMEOUT</text>
+  </g>
+  <!-- row 4 unavailable -->
+  <g>
+    <rect x="230" y="187" rx="12" width="240" height="26" fill="#f6f8fa" stroke="#afb8c1"/>
+    <circle cx="246" cy="200" r="6" fill="#afb8c1"/>
+    <text x="258" y="204" font-size="12.5" fill="#57606a">MIMO 未安装（灰）</text>
+  </g>
+  <!-- row 5 fallback -->
+  <g>
+    <rect x="230" y="232" rx="12" width="262" height="26" fill="#fff1e5" stroke="#bc4c00"/>
+    <circle cx="246" cy="245" r="6" fill="#bc4c00"/>
+    <text x="258" y="249" font-size="12.5" fill="#8a3700">AGY 限流 → 本地 API 回退中</text>
+  </g>
+  <!-- row 6 preset highlight -->
+  <g>
+    <rect x="230" y="277" rx="12" width="300" height="26" fill="#dafbe1" stroke="#1a7f37"/>
+    <circle cx="246" cy="290" r="6" fill="#1a7f37"/>
+    <text x="258" y="294" font-size="12.5" fill="#116326">CB · MIMO 就绪 · 本会话 CB 优先（preset 租约）</text>
+  </g>
+
+  <text x="560" y="70" font-size="12" fill="#57606a">悬停：该项目当前步骤</text>
+  <text x="560" y="92" font-size="12" fill="#57606a">点击：按 provider · 按项目</text>
+  <text x="560" y="110" font-size="12" fill="#57606a">展开活动面板（trail/runs/tokens）</text>
+  <text x="560" y="150" font-size="12" fill="#57606a">数据源三路合并：</text>
+  <text x="560" y="168" font-size="12" fill="#57606a">preset 事件 · dynamic 收集器</text>
+  <text x="560" y="186" font-size="12" fill="#57606a">· MCP 快照文件（90s 过期）</text>
+  <text x="560" y="226" font-size="12" fill="#57606a">preset 租约 75s TTL / 30s 心跳，</text>
+  <text x="560" y="244" font-size="12" fill="#57606a">关会话灯自动灭</text>
+</svg>

package/bin/agy-quota.mjs

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+// bin/agy-quota.mjs
+//
+// 查询 agy 所用 Google AI 套餐（Antigravity OAuth consumer）的池子额度。
+// 链路（参考开源项目 lbjlaq/Antigravity-Manager，已实测打通）：
+//   1. 读 Windows 凭据管理器 gemini:antigravity（agy 登录时写入的 OAuth token）
+//   2. 用 refresh_token + 公开的 Antigravity OAuth client 刷新 access_token
+//   3. POST fetchAvailableModels        -> 每模型池子剩余百分比 remainingFraction
+//   4. POST retrieveUserQuotaSummary    -> 分组套餐余量（weekly + 5h 双窗口）
+//
+// 用法：
+//   node bin/agy-quota.mjs            # stdout 输出 JSON
+//   node bin/agy-quota.mjs --summary  # 仅输出一行紧凑摘要（灯 tooltip 用）
+//
+// 输出 JSON：
+//   { ok, models: [{name, percentage, resetTime, displayName}...],
+//     groups: [{displayName, buckets: [{bucketId, window, remainingFraction, resetTime}]}],
+//     tier, tokenSource, error? }
+//
+// 独立运行，无 npm 依赖（Node 18+ fetch + child_process）。
+
+import { spawnSync } from 'node:child_process'
+import { createRequire } from 'node:module'
+const require = createRequire(import.meta.url)
+
+const CLOUDCODE_ENDPOINTS = [
+  'https://daily-cloudcode-pa.sandbox.googleapis.com/v1internal:fetchAvailableModels',
+  'https://daily-cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels',
+  'https://cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels',
+]
+const SUMMARY_ENDPOINTS = [
+  'https://daily-cloudcode-pa.sandbox.googleapis.com/v1internal:retrieveUserQuotaSummary',
+  'https://daily-cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary',
+  'https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary',
+]
+const TOKEN_URL = 'https://oauth2.googleapis.com/token'
+// Antigravity 官方 OAuth client（consumer 登录用）。为避免在仓库中硬编码凭据
+// （GitHub secret-scanning 会拦截），运行时优先读环境变量，否则从本机已安装的
+// Antigravity 扩展文件动态提取（jlcodes.antigravity-cockpit 扩展的 out/extension.js
+// 中硬编码了官方 client_id / client_secret）。
+const OAUTH_CLIENT_ID = process.env.AGY_OAUTH_CLIENT_ID || detectAntigravityOAuth()[0]
+const OAUTH_CLIENT_SECRET = process.env.AGY_OAUTH_CLIENT_SECRET || detectAntigravityOAuth()[1]
+
+function detectAntigravityOAuth() {
+  try {
+    const fs = require('node:fs')
+    const { homedir } = require('node:os')
+    const { join } = require('node:path')
+    const exts = join(homedir(), '.antigravity', 'extensions')
+    const entries = fs.readdirSync(exts, { withFileTypes: true }).filter((d) => d.isDirectory() && d.name.includes('antigravity-cockpit'))
+    for (const dir of entries) {
+      const f = join(exts, dir.name, 'out', 'extension.js')
+      if (!fs.existsSync(f)) continue
+      const txt = fs.readFileSync(f, 'utf8')
+      const idm = txt.match(/["']([0-9]{12,}-[a-z0-9]{20,}\.apps\.googleusercontent\.com)["']/)
+      const sm = txt.match(/["'](GOCSPX-[A-Za-z0-9_-]{20,})["']/)
+      if (idm && sm) return [idm[1], sm[1]]
+    }
+  } catch (e) { /* ignore */ }
+  return ['', '']
+}
+const USER_AGENT = 'vscode/1.95.3 (Antigravity/4.3.0)'
+const CRED_TARGET = 'gemini:antigravity'
+
+// 读 Windows 凭据管理器条目（CredRead P/Invoke），返回 blob 的 UTF-8 文本。
+// 方案：用 csc.exe 现编译一个最小 C# 程序（避免 PowerShell Add-Type 在
+// 本机因 LIB 自引用失效的问题；编译只需几秒，成功后在 %TEMP% 缓存）。
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+const CRED_CS = `
+using System;
+using System.Runtime.InteropServices;
+using System.Text;
+class AGYCredDump {
+  [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
+  struct CRED { public int Flags; public int Type; public IntPtr TargetName; public IntPtr Comment; public System.Runtime.InteropServices.ComTypes.FILETIME LastWritten; public int BlobSize; public IntPtr Blob; public int Persist; public int AttrCount; public IntPtr Attr; public IntPtr Alias; public IntPtr UserName; }
+  [DllImport("advapi32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
+  static extern bool CredRead(string target, int type, int reserved, out IntPtr cred);
+  [DllImport("advapi32.dll", SetLastError = true)]
+  static extern void CredFree(IntPtr p);
+  static int Main(string[] args) {
+    string target = args.Length > 0 ? args[0] : "gemini:antigravity";
+    IntPtr p;
+    if (!CredRead(target, 1, 0, out p)) { Console.Error.WriteLine("ERR credread " + Marshal.GetLastWin32Error()); return 1; }
+    try {
+      CRED c = (CRED)Marshal.PtrToStructure(p, typeof(CRED));
+      byte[] b = new byte[c.BlobSize];
+      Marshal.Copy(c.Blob, b, 0, c.BlobSize);
+      Console.OutputEncoding = Encoding.UTF8;
+      Console.WriteLine(Encoding.UTF8.GetString(b));
+      return 0;
+    } finally { CredFree(p); }
+  }
+}
+`
+
+function getCredDumpExe() {
+  const dir = join(tmpdir(), 'agy-quota-tool')
+  const exe = join(dir, 'agy-cred-dump.exe')
+  if (existsSync(exe)) return exe
+  mkdirSync(dir, { recursive: true })
+  const csPath = join(dir, 'agy-cred-dump.cs')
+  writeFileSync(csPath, CRED_CS, 'utf8')
+  const csc = process.env.WINDIR + '\\Microsoft.NET\\Framework64\\v4.0.30319\\csc.exe'
+  const r = spawnSync(csc, ['/nologo', '/out:' + exe, csPath], { encoding: 'utf8', timeout: 30000, windowsHide: true, maxBuffer: 4 * 1024 * 1024 })
+  if (r.status !== 0 || !existsSync(exe)) throw new Error('csc compile failed: ' + String(r.stderr || r.stdout || '').slice(0, 400))
+  return exe
+}
+
+function readWindowsCredential(target) {
+  const exe = getCredDumpExe()
+  const r = spawnSync(exe, [target], { encoding: 'utf8', timeout: 10000, windowsHide: true, maxBuffer: 1024 * 1024 })
+  if (r.error) throw new Error('cred-dump spawn: ' + r.error.message)
+  const out = String(r.stdout || '').trim()
+  if (r.status !== 0 || out.startsWith('ERR:')) throw new Error('CredRead failed (status=' + r.status + ') ' + String(r.stderr || '').slice(0, 200))
+  return out
+}
+
+// 用 refresh_token 换新 access_token
+async function refreshAccessToken(refreshToken) {
+  const body = new URLSearchParams({
+    client_id: OAUTH_CLIENT_ID,
+    client_secret: OAUTH_CLIENT_SECRET,
+    refresh_token: refreshToken,
+    grant_type: 'refresh_token',
+  })
+  const res = await fetch(TOKEN_URL, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: body.toString(), signal: AbortSignal.timeout(15000) })
+  if (!res.ok) throw new Error('token refresh HTTP ' + res.status + ': ' + (await res.text()).slice(0, 300))
+  const j = await res.json()
+  if (!j.access_token) throw new Error('token refresh: no access_token')
+  return j
+}
+
+async function postJson(url, token, payload) {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json', 'User-Agent': USER_AGENT },
+    body: JSON.stringify(payload),
+    signal: AbortSignal.timeout(20000),
+  })
+  if (!res.ok) throw new Error('HTTP ' + res.status)
+  return res.json()
+}
+
+// 依次尝试端点，全部失败抛错
+async function firstOk(urls, token, payload) {
+  let lastErr = null
+  for (const u of urls) {
+    try { return await postJson(u, token, payload) } catch (e) { lastErr = e }
+  }
+  throw lastErr || new Error('all endpoints failed')
+}
+
+function roundPct(f) { return typeof f === 'number' ? Math.round(f * 100) : null }
+
+// 模型家族识别：Claude / GPT 属于 3p 池子（Antigravity 上基本不可用，DSH 不应
+// 主动选择），Gemini 是主力可用池子，其余（tab_*、chat_* 等）归 other。
+function modelFamily(name) {
+  const n = String(name || '').toLowerCase()
+  if (n.includes('claude')) return 'claude'
+  if (n.includes('gpt')) return 'gpt'
+  if (n.includes('gemini')) return 'gemini'
+  return 'other'
+}
+
+async function main() {
+  const summaryOnly = process.argv.includes('--summary')
+  try {
+    // 1. 读凭据
+    const blobText = readWindowsCredential(CRED_TARGET)
+    let tok
+    try { tok = JSON.parse(blobText).token } catch (e) { throw new Error('credential blob is not JSON: ' + blobText.slice(0, 120)) }
+    const refreshToken = tok && tok.refresh_token
+    if (!refreshToken) throw new Error('no refresh_token in credential')
+    // 2. 刷新 access_token
+    const fresh = await refreshAccessToken(refreshToken)
+    const accessToken = fresh.access_token
+    // 3. fetchAvailableModels（每模型池子%）
+    const quotaResp = await firstOk(CLOUDCODE_ENDPOINTS, accessToken, {})
+    const models = []
+    if (quotaResp && quotaResp.models && typeof quotaResp.models === 'object') {
+      for (const [name, info] of Object.entries(quotaResp.models)) {
+        const q = info && info.quotaInfo
+        if (q) {
+          const family = modelFamily(name)
+          models.push({ name, percentage: roundPct(q.remainingFraction), resetTime: q.resetTime || '', displayName: (info && info.displayName) || '', family, recommended: family === 'gemini' || family === 'other' })
+        }
+      }
+      models.sort((a, b) => (b.percentage || 0) - (a.percentage || 0))
+    }
+    // 4. retrieveUserQuotaSummary（分组套餐余量）
+    let groups = []
+    try {
+      const sum = await firstOk(SUMMARY_ENDPOINTS, accessToken, {})
+      if (sum && Array.isArray(sum.groups)) {
+        groups = sum.groups.map((g) => ({
+          displayName: g.displayName || '',
+          buckets: (g.buckets || []).map((b) => ({ bucketId: b.bucketId || '', window: b.window || '', remainingFraction: typeof b.remainingFraction === 'number' ? b.remainingFraction : null, resetTime: b.resetTime || '' })),
+        }))
+      }
+    } catch (e) { /* summary 失败不阻塞主结果 */ }
+    const out = { ok: true, models, groups, tier: (tok.auth_method || 'consumer'), tokenSource: 'windows-credential:gemini:antigravity' }
+    if (summaryOnly) {
+      // 一行紧凑摘要
+      const weekBuckets = groups.flatMap((g) => g.buckets.filter((b) => b.window === 'weekly').map((b) => ({ g: g.displayName, id: b.bucketId, pct: roundPct(b.remainingFraction), reset: b.resetTime })))
+      // topModels 只列推荐模型（Gemini/other），Claude/GPT 3p 不推荐故不列出。
+      const recommended = models.filter((m) => m.recommended)
+      const pool = recommended.length ? recommended : models
+      const modelSummary = pool.slice(0, 4).map((m) => m.name.split('-').slice(0, 2).join('-') + ' ' + m.percentage + '%').join(', ')
+      console.log(JSON.stringify({ ok: true, weekly: weekBuckets, topModels: modelSummary }))
+    } else {
+      console.log(JSON.stringify(out))
+    }
+    process.exit(0)
+  } catch (e) {
+    console.log(JSON.stringify({ ok: false, error: String(e && e.message || e) }))
+    process.exit(1)
+  }
+}
+
+main().catch((e) => { console.log(JSON.stringify({ ok: false, error: String(e && e.message || e) })); process.exit(1) })