Gemini 额度条 xinglan163/dsh-gemini-quota

dsh-gemini-quota

在 DeepSeek Harness 输入框那一行显示一条 Gemini 额度小条，点一下弹出多号池面板。

Gemini 额度条：5h 37% / 7d 87%（悬停可看重置时间）

- 只在当前选中的模型属于 Gemini 时出现，切到 DeepSeek / Codex 自动消失；
- 鼠标悬停显示剩余量与重置时间（含账号），提示气泡跟随 DSH 主题配色（明暗主题与皮肤插件都会同步）；
- 0.2.0 新增账号池面板：点一下额度条，逐个账号看 5h / 7d 剩余额度，并能直接 启用 / 停用（冷却）/ 检测登录态 / 保活 / 切号——不用切去反代后台网页；
- 0.3.0 新增降级守卫：额度耗尽时 Gemini 会静默换成更弱的模型却仍返回 200，额度条会染成警告色 + ⚠️，写明「请求 X，实际 Y」，并给一键换号；
- 0.3.1 修复额度条与账号不同步：多号池 + 额度感知选号时请求会在号之间改道，额度条过去可能一直显示另一个号的额度（数字看着挺正常，所以很隐蔽）。现在它跟反代调度器的结果一致 —— 也就是下一条请求会用的那个号；在面板里切号 / 启停之后立刻刷新，不用等下一个轮询周期；
- 数据来自本地 gemini-web2api-go 反代的 /admin/api/。

本插件是显示 + 控制层，不含反代本身。你需要先自己跑一个 gemini-web2api-go。

注意：上游 v4.22.0 没有 GET /admin/api/quota 这个接口——它是本机对上游的本地补丁（internal/app/quota.go，上游升级会被覆盖，需备份）。没有它，额度条永远不显示（路由返回 502），但账号池面板仍然可用（它只依赖上游已有的 /admin/api/cookies）。

账号池面板里的逐号额度另需一个本地扩展：GET /admin/api/quota?account_id=N。
没打这个补丁时，面板会明确标出「按号查额度不支持」，不会拿自动选号的数字冒充某个账号。

前置条件

1. 一个在跑的反代，默认地址 http://127.0.0.1:8083；
2. 它的 admin token，放在下面任一位置（按优先级）：
- token 配置项（直接写在 config 里，不推荐提交到仓库）；
- 环境变量 GEMINI_WEB_ADMIN_TOKEN（可用 tokenEnv 改名）；
- envFile 指向的文件里的 GEMINI_WEB_ADMIN_TOKEN=...；
- $DSH_HOME/gemini-web2api.env（默认 ~/.dsh/gemini-web2api.env）——推荐，机器相关的东西放这里。

install -m 600 /dev/null ~/.dsh/gemini-web2api.env
printf 'GEMINI_WEB_ADMIN_TOKEN=%s\n' '<你的 admin token>' > ~/.dsh/gemini-web2api.env

安装

在 DSH 侧边栏 插件 页里安装（输入包名即可）：

dsh-gemini-quota

也可以走 CLI / 其他 spec 形式：

注册表包
dsh plugin --profile <profile> add dsh-gemini-quota
本地目录（开发用）
dsh plugin --profile <profile> add /path/to/dsh-gemini-quota
tarball / git
dsh plugin --profile <profile> add ./dsh-gemini-quota-0.2.0.tgz
dsh plugin --profile <profile> add github:xinglan163/dsh-gemini-quota

安装后默认启用。本插件没有任何依赖构建脚本，因此不会触发 pnpm 的 allowBuilds 审批。

配置

改组合包自带的 cordis.patch.yml，或在你 profile 的 cordis.patch.yml 里按 id: gemini-web-quota 覆盖：

| 项 | 默认 | 说明 |
| baseUrl | http://127.0.0.1:8083 | 反代地址 |
| providers | ["gemini-web"] | 哪些 DSH provider id 触发显示（决定门控） |
| matchModelPrefix | true | 额外按模型名 gemini- 兜底 |
| token | — | 直接给 admin token（优先级最高） |
| tokenEnv | GEMINI_WEB_ADMIN_TOKEN | 从哪个环境变量读 token |
| envFile | $DSH_HOME/gemini-web2api.env | 从该文件读 token |
| timeoutMs | 8000 | 上游超时 |
| readOnly | false | true = 面板只读，禁用一切账号动作 |

providers 必须和你在 llm-pi-ai 里给反代起的 provider 名一致（默认 gemini-web）。

账号池面板（0.2.0）

额度条点一下弹出面板（再点 / 点外面 / 按 Esc 关闭）：

Gemini 账号池面板：逐号 5h / 7d 剩余额度，一行一个号，可 停用 / 检测 / 保活 / 切到此号

Gemini 账号池 1/2 启用 [刷新] [反代面板] [✕] ● Pro(FF导入) #1 [当前] 5h ▓▓▓▓ 100% 7d ▓▓▓ 80% 出口 直连 · 15 个 cookie · 上次成功 2 小时前 [停用][检测][保活][切到此号] ● 备用号 #2 5h ░░░░ 0% 7d ▓▓▓ 55% 出口 新加坡 · 失败 3 次 · 上次成功 1 天前 [启用][检测][保活][切到此号]

| 元素 | 含义 |
| ● 颜色 | 绿=在用；黄=待检测（还没成功用过）；红=鉴权失败中（多半 cookie 过期）；灰=已停用 |
| [当前] | 额度条上显示的正是这个号 —— 反代调度器下一个请求会挑的号（所以点完「切到此号」立刻就变） |
| 5h / 7d | 该账号自己的网页端额度（?account_id=N），失败时显示原因，不支持时显示 — |
| 第二行 | 出口代理、失败计数、cookie 个数、上次成功时间（悬停看完整 last_error） |
| 启用 / 停用 | 即"冷却"开关：停用的号不会被调度器选中 |
| 检测 | 真的去上游探一次登录态（/check），结果直接显示在下方 |
| 保活 | 刷新 cookie（/rotate，SAPISID 轮换），返回刷新了哪几个字段 |
| 切到此号 | 需点两次确认：启用目标号，并停用其余已启用的号 |

「切到此号」为什么要点两次：反代的调度器只按 (fail_count, last_used_at) 轮转，没有「活跃账号」这个开关，所以"让接下来的请求都走这个号"唯一诚实的实现就是 把别的号禁用掉——这是会一次改动多行的动作，值得一次确认。

「反代面板」按钮会新开 baseUrl/admin/（反代自带的 web 面板），加 cookie / 配代理这类不常做的事还是去那边。

降级守卫（0.3.0）

额度用完后，Gemini 会静默把你的模型换掉，但 HTTP 照样回 200。

你选了 4 Argon（付费号专属）。当账号 5 小时额度见底时，上游不报错，而是把这一轮转给更笨的 3.5 Flash-Lite 去答，然后正常返回成功。于是 DSH 以为用的是强模型， agent 还会理直气壮地说"我做完了"——issue #41 里管这叫「产生严重幻觉并破坏任务」。

额度条会整条染成警告色并加一个 ⚠️，悬停第一行就是原因：

⚠️ 最近一次请求被降级：请求 gemini-4-argon，实际 3.5 Flash-Lite 5h 额度：剩余 5%
账号：Pro(FF导入)
点一下：账号池面板

点开面板，顶部是告警条 + 一个按钮：切到额度最充足的号（两下确认，与行内「切到此号」同一套逻辑：启用目标号 + 停用其它已启用的号）。

判定规则（以及为什么这么判）

| 情形 | 判定 |
| 请求 gemini-4-argon，上游自报 4 Argon / 4 Argon High | ok |
| 请求 gemini-4-argon，上游自报 3.5 Flash-Lite | downgraded |
| 上游没自报显示名（生图 / 生视频 / 抽取失败） | unknown —— 不亮红灯 |
| 模型不在插件内置表里（例如将来新增） | unknown —— 不亮红灯 |

两个刻意的设计：

1. 判不了就说判不了。unknown 绝不等于"没问题"——把"看不见"伪装成"没降级"，比漏报更糟（用户会开始无视这个红灯）。
2. 上游改名要容忍。Google 把 3.7 原地升级成 3.8 过（同一个 hex、显示名变了），所以 id→显示名是一张容错表，遇到改名不误报。

真相来自反代自己记录的 upstream_model（上游在响应帧里自报的显示名）。
不能靠响应体判断：反代回给客户端的 "model" 填的是你请求的那个，响应体本身在撒谎。

已知边界

- 判定表是插件内置的：反代新增模型后要更新插件（否则新模型一律 unknown，不误报）；
- 每次在最近 5 条请求里找「最近一次可判定的」：最新一条是生图时会继续往前找，不会因为一条判不了的请求就把更早的降级藏起来；
- 它不能阻止这一次降级——那要在反代里做（上游 strict_model）。插件负责让你 知道，以及下一步换号。

宿主路由

| 路由 | 上游 | 说明 |
| GET /plugins/dsh-gemini-quota/quota[?account_id=N][?refresh=1] | GET /admin/api/quota | 额度条数据；account_id 是面板逐号查的入口 |
| GET /plugins/dsh-gemini-quota/pool | GET /admin/api/cookies | 账号池视图（健康度、失败计数、代理、cookie 摘要） |
| GET /plugins/dsh-gemini-quota/actual[?limit=N] | GET /admin/api/requests | 降级守卫：最近几次请求「请求的模型 vs 实际用的模型」（只回元数据，不含 prompt/正文） |
| POST /plugins/dsh-gemini-quota/account | POST /admin/api/cookies/{id}/{toggle\|check\|rotate} | 账号动作；switch 由插件编排（启用目标 + 停用其余） |

sapisid_tail 之类的摘要字段来自反代；完整 cookie 值不会出现在任何回给浏览器的数据里。

工作原理

- 宿主半（index.js）把反代 /admin/api/ 转成同源路由 /plugins/dsh-gemini-quota/。
为什么不让浏览器直连反代：反代的 CORS 预检没有 Access-Control-Allow-Headers，带 Authorization 的 fetch 会被浏览器拒；用 ?token= 又能过但会把 admin token 泄进前端产物。
- 四条路由都自带最小信任闸门（回环对端 + 回环 Host + 非 cross-site + 同源 Origin）， POST /account 另有 readOnly 开关和入参校验。
- 面板的逐号额度是打开面板时才按需并发查（3 个 worker），一旦发现反代不支持 ?account_id=N 就立刻停手并如实标注，不白打上游。
- 路由同时下发 providers / matchModelPrefix：浏览器半拿不到 cordis config （client-modules 只传 { name: id }），所以门控范围必须由宿主告知。
- 降级判定必须在宿主半做：响应体里的 "model" 是「你请求的」（反代原样回填），真相只在上游自报的 upstream_model 里，而那个字段只有反代的 admin API 才给得出来。

自测

node --check index.js && node --check client.js
node selftest.mjs # 20 项：路由/闸门/token 链/字段映射 + 降级判定 7 情形（stub 上游）
+ 额度条渲染（降级亮灯 / 正常不误报）+ 浏览器半契约冒烟
node scripts/http-check.mjs # 真起一个 http server，用真 fetch 打一遍三条路由

反代没在跑时依赖上游的用例会标 SKIP 而不是失败。

疑难排查

| 现象 | 原因 |
| 悬停提示正常但条一直不出现 | 当前模型不在 providers 里；改配置或开 matchModelPrefix |
| 额度条染成警告色 + ⚠️ | 最近一次请求被静默降级（响应体里看不出来，悬停看「请求 X 实际 Y」） |
| 降级判定一直是 unknown（不亮灯） | 上游没自报显示名，或该模型不在插件内置表里——这是刻意的，不是故障 |
| 控制台/路由 503 no admin token | token 四个来源都没命中 |
| 502 upstream ... | 反代没跑、端口不对、或 admin token 无效 |
| 面板整行都显示 — 并提示「按号查额度不支持」 | 反代的 /admin/api/quota 没打 ?account_id=N 扩展（见文件头说明） |
| 403 forbidden | 不是从回环地址/同源访问的 |
| 点「停用」提示 403 readOnly | 宿主配置里把 readOnly 设成了 true |
| 切号后发现请求还是走旧号 | 调度器每请求取一次号；已在飞的请求不会中断，下一条新请求才走新号 |
| 改了 client.js 界面没变 | client-hmr 对 link: 安装不一定生效，刷新页面（Cmd+R）最稳 |
| 改了 index.js（宿主半）界面没变 | 宿主半没有 HMR：需要重启 DSH（或插件页关掉再开启该组合包） |
| 刚发布的新版装不上（Already up to date） | pnpm「最小发布年龄」保护：加 --config.minimumReleaseAge=0，或等一段时间 |

卸载

插件页关掉组合包，或 dsh plugin --profile <profile> remove dsh-gemini-quota。

License

MIT