@ds-hu/dsh-token-quota 2.5.0 → 2.6.0

package/README.md

@@ -1,13 +1,36 @@
 # dsh-token-quota
 
-DeepSeek Harness 用量监控插件。查看当前会话对应供应商的周期限额、账户余额、报告费用和今日 Token 用量，支持 Windows 桌面端与 Web 界面。
+[![npm](https://img.shields.io/npm/v/@ds-hu/dsh-token-quota)](https://www.npmjs.com/package/@ds-hu/dsh-token-quota)
+[![verify](https://github.com/ds-hu/dsh-usage-monitor/actions/workflows/verify.yml/badge.svg)](https://github.com/ds-hu/dsh-usage-monitor/actions/workflows/verify.yml)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![DSH](https://img.shields.io/badge/DSH-%E2%89%A5%200.1.7--rc.2-4c6ef5)](#安装)
 
-当前版本：**v2.5.0**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
+DeepSeek Harness 用量监控插件：查看当前会话对应供应商的周期限额、账户余额、报告费用与今日 Token 用量，
+也能统计任何未内置供应商的 Token 消耗。支持 Windows 桌面端与 Web 界面。
+
+中文 · [English](README.en.md)
+
+![用量监控概览：可查额度的供应商与一条「仅计量」行](docs/images/overview.png)
+
+当前版本：**v2.6.0**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
 
 Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图标是根目录 `icon.svg`，标题与一句话说明来自 `locale/zh.json` 与 `locale/en.json` 的 `meta`。
 
 [npm](https://www.npmjs.com/package/@ds-hu/dsh-token-quota) · [问题反馈](https://github.com/ds-hu/dsh-usage-monitor/issues)
 
+## v2.6.0 更新
+
+- **任意供应商的 Token 统计**：DSH 里未归属到内置供应商的 LLM 路由，跑过一次就在概览里多出一条
+  **「仅计量」**行——只有今日与近 N 天的 Token、五分量分布与归一比例，不查额度、不画百分比、
+  不发任何新的外部请求。此前这类路由的用量被整段丢弃。
+- **今日总量改为「概览列表里每一行之和」**：一行只要有今日用量就一定在列表里、也一定计入，
+  可以逐行相加核对；「当前」标从此只表示小组件在用哪一家，不再等于「计入」。
+- **DeepSeek 桌面登录与 API Key 合并成一行**：登录态产生的 Token 也计入今日用量，
+  只有额度查询仍需要 API Key。
+- 路由后来被插件支持时，`local:<route>` 的历史用量并入正式供应商，不从 0 开始；收编过程中
+  在途步骤的替换样本不再被重复计入。
+- 「近 N 天」的 N 取自用量保留期，不再一律写「近 7 天」。
+
 ## v2.5.0 更新
 
 - 展开行的「Today」换成选择器：可切「今天 / 近 7 天」，token 数、归一比例与五分量分布条一起换成该区间的合计；图表固定 7 天，不跟着变。
@@ -15,84 +38,11 @@ Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图
 - 估算按取样内的斜率折算（本地 token ÷ Δpp），不再除以累计已用%：月窗口比本地留存长时，旧算法只拿得到最近几天的 token，会把总量算成一半。
 - 修复图表柱值数字被折线压花：数字底下垫一层卡片底色，折线从数字背后穿过。
 
-## v2.4.1 更新
-
-- 包名改为 `@ds-hu/dsh-token-quota`：`dsh plugin add @ds-hu/dsh-token-quota` 直接安装，不必再下载压缩包；插件 id、设置命名空间与数据目录不变，升级不需要迁移。
-- 发布改由 CI 执行：`fork-vX.Y.Z` 标签触发测试与 `npm publish`，凭据走 OIDC 可信发布并附 provenance，仓库里不存 npm token。
-
-## v2.4.0 更新
-
-- 四个浮层收敛为单一面板：删除用量浮卡、供应商限额明细弹窗与用量统计弹窗，单击侧栏卡片直接打开「用量监控」；面板只剩「概览」「供应商」两个页签，原「设置」页签并入供应商页底部的折叠「全局设置」。卡片进入默认概览，宿主「设置 → 用量监控」进入默认供应商。
-- 明细与统计并入概览的供应商行：一次只展开一行，展开区给出分组指标表格、今日五分量分布与归一比例、DeepSeek 计费时段拆分与额度历史图；额度历史改为首次展开时按需取一次，同一面板会话内复用。
-- 默认视图不再常显解释文案：说明收进可展开的提示，`·` 拼接改为表格或徽标，词典键由 198 降到 158；会改变判断的告警（缺次年节假日、保存失败、取数失败）仍常显。
-- 移动端不再有独立分支：视口 < 1024px 也打开同一面板，不再有一次点击直达详情的窄屏路径。
-- 侧栏卡片补留白（横向 6px、上下 8px），长倒计时不再贴边被裁；修复指标表格列头与数值错位、展开明细重复画两条分布条、图表底部单独一行「近 N 天」，以及更新插件后样式仍是旧版的问题。
-
-## v2.3.0 更新
-
-- 统计图的额度折线补上采样锚点，并在换窗口（已用百分比回落）处用同色虚线把两段接上：断开表示换了窗口，不是画漏了；实线仍不跨窗口连线。
-- 统计图支持悬停读数：指针移到图上（聚焦后可用 ←/→，触屏点一下即固定）显示那一刻的时刻、当日 Token 与各窗口剩余百分比；读数取最近一次采样、不插值，靠近采样点会吸附到实际采样时刻。
-- 修复采样圆点被横向拉成椭圆的问题：锚点改画在不参与坐标拉伸的叠加层上，半径按像素。
-
-## v2.2.0 更新
-
-- 新增用量统计弹窗：从卡片标题行（供应商名 + 今日用量）或明细头部的「统计」进入，给出今日总量、五分量分布与归一比例，并把每日 Token 消耗（柱）与各窗口剩余额度（线）画在同一张时间图上，共用时间轴与日期刻度。
-- 新增额度历史采集：每次查询成功按「供应商 × 指标」记录已用百分比的变化点（不变的值不重复记），存 `$DSH_HOME/dsh-token-quota/quota.json`，磁盘保留 14 天；历史只在打开统计时随 `/state?quota=1` 传输。
-- 详情弹窗的今日用量旁显示归一比例「缓存命中 : 缓存未命中 : 输出」（如 `30.0 : 1.00 : 0.150`）与同色的三段分布条。
-- 新增关注限额：供应商配置页可勾选卡片要看哪些限额并调序，卡片第 2 行可多条并排，每条自带短标签、百分比与该窗口自己的重置倒计时。
-- 本地用量文件升级为版本 2：小时桶改存五项互不相交的分量，旧文件的总数归入「未细分」，不猜分布也不丢总量。
-- 密钥改存凭据引用（`apiKeyEnv`），本体不再落进 profile 配置；旧配置里的 `apiKey` 继续生效，无需迁移。
-- 手机／窄布局（视口 < 1024px）点击侧栏入口直达「供应商限额明细」；Plugins 面板显示「用量监控」名称与图标。
-
-## v2.1.0 更新
-
-- 新增 DeepSeek 峰谷计费时段：侧栏常显当前档位（峰价／谷价）与「下次切换」，浮卡与明细给出成因（法定节假日／周末）和北京时间，刷新历史新增「时段」列。时段判定在宿主侧完成，客户端只消费结论。
-- 新增今日用量时段拆分：DeepSeek 的当日用量按小时桶推导为高峰／空闲／未标记三段并给出占比，其他供应商不串用该口径。
-- 新增节假日覆盖表：设置页可粘贴 `YYYY-MM-DD` 清单替换内置表；缺次年安排时在同一处点名，不再静默把工作日假期当峰价。
-- 常驻卡片重新排版为四行：plan 名（不再显示模型名）、周窗口已用百分比进度条、今日 Token 用量与该窗口重置倒计时、计费时段档位。阈值颜色融入进度条，取消阈值圆点与插件标题行。
-- Token 量级统一 3 位有效数字（`1.32M`、`12.0K`、`999.6K → 1.00M`），不再固定一位小数；用量浮卡不再重复计费时段块。
-
-## v2.0.5 更新
-
-- 修复智谱／Z.ai Coding Plan 查询失效：供应商已把用量窗口的类型名由 `TOKENS_LIMIT` 改名为 `CREDIT_LIMIT`，插件此前只认旧名，窗口全部被跳过，供应商显示为「暂时无法获取」。
-- 窗口改按 `unit` 标识分类（5 小时窗口、周窗口、月度 MCP 上限），不再依赖数组位置；新增周窗口与供应商公布的重置时刻。新旧拼写并存时都能读取，重复或无法命名的窗口如实报错，不猜一个窗口顶上。
-- 业务失败改按响应信封判定：密钥失效（HTTP 200 响应体内的 `code:401`）报鉴权失败，不再误报成「响应缺少 data.limits」。
-
-## v2.0.4 更新
-
-- 修复 Command Code 等供应商未公布重置时刻时错误显示“1月1日”的问题。
-- 统一验证日期文案与原始时刻，零值、无效日期和误传入毫秒字段的秒级值显示为未知，不推算重置时间。
-- 保留有效毫秒、数字串和带时区日期的准确时刻，OpenCode Go 的正常窗口倒计时保持不变。
-
-## v2.0.3 更新
-
-- 点击侧栏打开贴在卡片上方的用量浮卡，显示供应商主指标、查询状态、刷新间隔和上次刷新时间。
-- 浮卡底部提供“详情”“设置”“关闭”；完整供应商明细和现有配置面板继续保留。
-- 浮卡适配完整、紧凑和图标侧栏，支持再次点击、Esc 和外部点击关闭，随窗口变化调整位置。
-
-## v2.0.2 更新
-
-- 修复停用、重新启用和宿主重启插件时的 `webserver: duplicate exact route` 启用失败。
-- 启动失败时释放已登记的资源；某项清理报错不会阻止其他资源释放。
-
-## v2.0.1 更新
-
-- 侧栏单击恢复独立「供应商限额明细」弹窗，按 v1.4.0 分栏展示已添加供应商与周期指标，刷新历史恢复为表格，沿用当前主题配色和按钮样式。
-- 详情中的「设置」按钮进入现有概览、供应商、设置面板；保留完整／紧凑侧栏和显示偏好。
-- 修复供应商扫描中的 `cannot get required service "settings" in inactive context` 错误；设置服务暂不可用时保留最近成功目录，恢复后可重新扫描。
-
-## v2.0.0 更新
-
-- 侧栏支持完整与紧凑显示，单击直接打开概览，显示偏好自动保存。
-- 用量监控面板提供「概览」「供应商」「设置」三个页签，侧栏入口与宿主设置入口使用相同内容。
-- 概览支持需关注筛选、自适应一列或两列布局，保留各周期与币种的独立指标。
-- 配置编辑保留未保存草稿，提供放弃修改确认；保存失败保留输入，避免旧请求覆盖新的编辑内容。
-- 查询失败时保留上次成功数据并标明状态；未知值与真实零值分别显示。
-- 适配 Windows 桌面端的当前会话选择、原生设置入口和侧栏收起／恢复。
+更早的逐版本记录见 [CHANGELOG](CHANGELOG.md)。
 
 ## 安装
 
-插件从 npm 安装：**`@ds-hu/dsh-token-quota`**。离线部署时可以在源码目录 `npm pack` 打出 `ds-hu-dsh-token-quota-2.5.0.tgz`，用压缩包安装。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
+插件从 npm 安装：**`@ds-hu/dsh-token-quota`**。离线部署时可以在源码目录 `npm pack` 打出 `ds-hu-dsh-token-quota-2.6.0.tgz`，用压缩包安装。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
 
 ### Windows 桌面端
 
@@ -107,7 +57,7 @@ $desktopCli = 'D:\AI\DeepSeek- Harness\resources\runtime\cli\bin\dsh.cmd'
 离线安装时把包名换成压缩包路径：
 
 ```powershell
-$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.5.0.tgz').Path
+$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.6.0.tgz').Path
 & $desktopCli plugin --profile desktop add "file:$archivePath"
 ```
 
@@ -129,14 +79,14 @@ dsh --profile web
 Linux / macOS：
 
 ```bash
-dsh plugin --profile web add "file:$(pwd)/ds-hu-dsh-token-quota-2.5.0.tgz"
+dsh plugin --profile web add "file:$(pwd)/ds-hu-dsh-token-quota-2.6.0.tgz"
 dsh --profile web
 ```
 
 Windows PowerShell：
 
 ```powershell
-$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.5.0.tgz').Path
+$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.6.0.tgz').Path
 dsh plugin --profile web add "file:$archivePath"
 dsh --profile web
 ```
@@ -179,20 +129,22 @@ dsh plugin --profile web add "link:$pluginDirectory"
 且**任一已填即视为手动接管**（扫描不再改动该供应商的密钥字段）。「测试连接」对编辑器里刚填、还没保存的引用
 也会先解析一次，不必先保存再测。
 
-**DeepSeek 桌面账户登录凭证与 API Key 不可互换。** 仅登录桌面账户时，请在现有 DeepSeek 供应商配置中填写同一账户的 API Key，或配置 Harness 的 DeepSeek API Key 路由后重新扫描。
+**DeepSeek 桌面登录的 Token 会计入，额度查询仍需要 API Key。** 登录态产生的调用以 `deepseek-account` 路由上报，插件把它并进同一行 DeepSeek，因此今日与近 N 天的 Token 不配 Key 也能看到；余额只能按 API Key 查——只想看额度时，请在现有 DeepSeek 供应商配置中填写同一账户的 API Key，或配置 Harness 的 DeepSeek API Key 路由后重新扫描。
 
 ## 侧栏与面板
 
-完整侧栏分三段：**plan 名**（供应商显示名，不显示模型名）、**关注限额进度条**（可多条并排，每条自带真名短标签、已用百分比与该窗口的重置倒计时）、以及常显的**计费时段档位**（峰价／谷价与下次切换）。阈值颜色直接落在进度条上：绿 < 警告 < 黄 < 临界 < 红；多条时每条按自己的百分比分档，并共享列宽严格对齐。没有配置关注限额时退回**周窗口**，没有周窗口才改用已用比例最高的有效窗口，只有余额或报告费用时保留文字而不画条；旧数据与已停用保持中性色。今日 Token 用量不再占侧栏一行，改在概览的供应商行里按供应商展示（无障碍标签仍可读到）。Token 数量一律 3 位有效数字（如 `1.32M`、`12.0K`）。紧凑侧栏保留供应商名与主指标文字。独立箭头切换显示状态，偏好保存在当前浏览器；宽度不足时自动使用紧凑显示，恢复宽度后恢复用户选择。
+完整侧栏分三段：**plan 名**（供应商显示名，不显示模型名）、**关注限额进度条**（可多条并排，每条自带真名短标签、已用百分比与该窗口的重置倒计时）、以及常显的**计费时段档位**（峰价／谷价与下次切换）。阈值颜色直接落在进度条上：绿 < 警告 < 黄 < 临界 < 红；多条时每条按自己的百分比分档，并共享列宽严格对齐。没有配置关注限额时退回**周窗口**，没有周窗口才改用已用比例最高的有效窗口，只有余额或报告费用时保留文字而不画条；旧数据与已停用保持中性色。今日 Token 用量不再占侧栏一行，改在概览的供应商行里按供应商展示（无障碍标签仍可读到）。没有可查询指标的「仅计量」行第 2 行不画条，改显这个窗口自己的量。Token 数量一律 3 位有效数字（如 `1.32M`、`12.0K`）。紧凑侧栏保留供应商名与主指标文字。独立箭头切换显示状态，偏好保存在当前浏览器；宽度不足时自动使用紧凑显示，恢复宽度后恢复用户选择。
 
 **关注限额**在「供应商 → 配置」页勾选：勾选顺序即卡片排列顺序，行内 ↑↓ 调整，未勾选 = 用默认规则。候选项来自上一次成功查询里带身份的可画条目（`5h 滚动`／`周用量`／`月用量`／`allowance` 等）；已勾选但这次查询没返回的项标注「当前不可用」并暂不画条，数据回来自动恢复。配置只影响侧栏卡片第 2 行，不改变概览、紧凑行与供应商明细里的主指标口径。
 
 单击侧栏卡片打开「用量监控」面板。面板只有「概览」「供应商」两个页签；卡片进入默认概览，宿主「设置 → 用量监控」进入默认供应商。对话框形态下按 Esc、点遮罩或「关闭」收起，焦点回到侧栏卡片。
 
-概览按已添加供应商列出名称、状态、主指标与今日量；一次只展开一行。展开后给出按额度、余额、报告分组的指标表格，今日五分量分布（只用一条五分量条）与**归一比例**（「缓存命中 : 缓存未命中 : 输出」，未命中固定为 1，例如 `30.0 : 1.00 : 0.150`，三段各保留 3 位有效数字），DeepSeek 的计费时段拆分，以及一张**把柱状图与折线图合成的时间图**：柱是每日 Token 消耗，每根有量的柱标出当日用量（窗口过长时只标峰值），图顶给出窗口合计；折线是各窗口的剩余额度，共用同一条时间轴；折线在额度回落处断开（说明换了新窗口），图例给出各窗口当前剩余百分比。首次展开时按需取一次额度历史，同一次面板会话内复用。默认收起的刷新历史表格最多展示最近 50 条。
+概览按已添加供应商列出名称、状态、主指标与今日量（「仅计量」行也在其中，状态写作「仅计量」），一次只展开一行；列表上方的今日总量就是这些行今日量之和，可以逐行相加核对。展开后给出按额度、余额、报告分组的指标表格，今日五分量分布（只用一条五分量条）与**归一比例**（「缓存命中 : 缓存未命中 : 输出」，未命中固定为 1，例如 `30.0 : 1.00 : 0.150`，三段各保留 3 位有效数字），DeepSeek 的计费时段拆分，以及一张**把柱状图与折线图合成的时间图**：柱是每日 Token 消耗，每根有量的柱标出当日用量（窗口过长时只标峰值），图顶给出窗口合计；折线是各窗口的剩余额度，共用同一条时间轴；折线在额度回落处断开（说明换了新窗口），图例给出各窗口当前剩余百分比。首次展开时按需取一次额度历史，同一次面板会话内复用。默认收起的刷新历史表格最多展示最近 50 条。
 
 「供应商」页签列出已添加目录、启用开关、配置入口与重新扫描；底部折叠「全局设置」（查询间隔、用量保留期、节假日覆盖表；缺次年时在摘要外点名告警）与侧栏显示偏好。可添加供应商默认收起。
 
+![供应商页：配置、启用与重新扫描](docs/images/providers.png)
+
 | 页签 | 内容 |
 | --- | --- |
 | 概览 | 今日总量、全部/需关注筛选、可展开的供应商明细、默认收起的刷新历史。 |
@@ -202,7 +154,7 @@ dsh plugin --profile web add "link:$pluginDirectory"
 
 ## 数据含义
 
-- **今日用量**：当前供应商通过 Harness 产生的当日 Token 用量，按宿主本地日统计。独立 CLI 或其他应用中的调用不计入。
+- **今日用量**：概览列表里每一行（已添加供应商，含仅计量行）通过 Harness 产生的当日 Token 用量之和，按宿主本地日统计。一行只要有今日用量就必然在列表里，所以这个合计可以逐行相加核对。独立 CLI 或其他应用中的调用不计入。
 - **用量分布**：今日用量按 DSH 的互不相交口径拆成五项（未缓存输入、输出、缓存命中、缓存写入、未细分），五项之和恒等于今日总量。比例只取前三项并归一到「缓存未命中 = 1」。
 - **剩余额度**：按 `100 − 已用百分比` 派生。额度在一个窗口内只增不减，因此百分比回落即表示换了新窗口，折线在此断开。只对带百分比的窗口（`5h`／`周`／`月` 等）成立；余额与报告费用没有百分比，不进折线。
 - **周期限额**：百分比表示已用比例；常驻卡片第 2 行画的是用户配置的**关注限额**（可多条、按配置顺序），没配置时固定取周窗口、没有周窗口再取已用比例最高的有效窗口；每条的重置时间始终对应它自己的窗口。概览与紧凑侧栏的主指标仍取已用比例最高的有效窗口。
@@ -231,6 +183,20 @@ dsh plugin --profile web add "link:$pluginDirectory"
 
 普通 API Key、Management Key 与 Admin Key 分别配置。插件不会将普通聊天密钥用于组织管理接口，也不会覆盖手动填写的密钥或重新启用显式关闭的供应商。
 
+### 任意供应商（仅计量）
+
+上表没有的供应商也有 token 统计：DSH 里未归属到上表的 LLM 路由，产生过一次真实调用后就会在概览里出现一条
+**「仅计量」**行——只有今日与近 N 天的 Token、五分量分布与归一比例，不查额度、不画百分比、不发新的外部请求。
+此前这类路由的用量被整段丢弃，「今日总量」因此比真实调用少一块。
+
+- 行由流量产生：不能手工添加，也不能停用（没有可关掉的采集器）；在「供应商」页可改名，默认名取路由 id 或 DSH 的显示名。
+  行跟着本地用量一起进退：保留期（默认 7 天）内没有新用量、旧桶被清理后，这一行也随之消失。
+- 卡片的第 1 行仍是名字与今日数，第 2 行没有进度条，给的是这个窗口（近 N 天，N 取保留期）的量。
+- 这些行恒进「今日总量」，但不属于「需关注」，也不进关注限额与阈值分档；明细里没有指标表，也没有「数据时间」——它从不查询。
+- 路由后来被本插件支持时，`local:<route>` 的历史用量并入正式供应商，不从 0 开始，并入前后今日总量不变。
+- DeepSeek 桌面登录（`deepseek-account`）与 API Key 是同一条账户的两条路，合并成同一行 DeepSeek，不会出现两行重复记账；
+  只有登录态、没有可查额度的 Key 时，这一行照样出现在概览里并计入今日总量（只是状态显示「未查询」）。
+
 官方查询仅接受对应的 HTTPS 主机与已知基础路径；不符合要求的地址不会发送请求。OpenCode 与 Command Code 使用兼容接口，其可用性取决于供应商接口。表格表示插件支持的查询能力，不代表所有真实账户均已完成验证。
 
 ## 数据保存与升级
@@ -248,6 +214,7 @@ dsh plugin --profile web add "link:$pluginDirectory"
 ## 限制
 
 - 仅观测经过 Harness 的调用；本机 Codex CLI 登录状态和独立 CLI 用量不在范围内。
+- 「仅计量」行只有 Token：没有额度、余额与百分比可看，也不能手工添加或停用。
 - 供应商未返回重置时间时，不推算或补造时间；无限额度和未知余额保留未知。
 - 趋势图只覆盖本地记录：额度折线依赖插件运行期间采样，装插件之前的历史无从补录；额度历史磁盘保留 14 天，展示窗口跟随用量保留期（默认 7 天），期间没有查询就没有点。
 - 本地用量统计与供应商账单可能因周期、时区和统计范围不同而不同。
@@ -269,14 +236,14 @@ npm pack
 真实宿主验收使用独立数据目录与 profile，不修改日常配置：
 
 ```powershell
-npm run test:desktop -- --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.5.0.tgz' --output '.scratch/desktop-v2-check'
-node scripts/verify-web.mjs --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.5.0.tgz' --output '.scratch/web-v2-check'
+npm run test:desktop -- --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.6.0.tgz' --output '.scratch/desktop-v2-check'
+node scripts/verify-web.mjs --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/ds-hu-dsh-token-quota-2.6.0.tgz' --output '.scratch/web-v2-check'
 npm run test:lifecycle -- --app 'C:/path/DeepSeek Harness.exe' --output '.scratch/lifecycle-v2-check'
 ```
 
 输出目录需为未使用过的目录。供应商解析测试使用模拟响应；真实 Desktop 与 Web 验收检查安装、界面、配置持久化和重新扫描，不发送聊天消息或配置真实供应商密钥。
 
-[桌面兼容性说明](docs/windows-desktop-adaptation.md) · [单一面板重构记录](docs/single-panel-refactor-execution.md) · [ADR-0002](docs/adr/0002-single-monitor-surface.md) · [侧栏与设置实施记录](docs/sidebar-settings-iteration-plan.md) · [v2.5.0 发布记录](docs/v2.5.0-release-execution.md)
+[桌面兼容性说明](docs/windows-desktop-adaptation.md) · [单一面板重构记录](docs/single-panel-refactor-execution.md) · [ADR-0002](docs/adr/0002-single-monitor-surface.md) · [侧栏与设置实施记录](docs/sidebar-settings-iteration-plan.md) · [v2.5.0 发布记录](docs/v2.5.0-release-execution.md) · [v2.6.0 发布记录](docs/v2.6.0-release-execution.md)
 
 ## 来源与致谢
 
@@ -286,4 +253,4 @@ npm run test:lifecycle -- --app 'C:/path/DeepSeek Harness.exe' --output '.scratc
 
 ## 许可证
 
-MIT。
+MIT。完整文本见 [LICENSE](LICENSE)，其中一并保留了上游 shxtmaker 的版权声明。

package/lib/client.js

@@ -98,7 +98,17 @@
           tone: supplier.state === "err" || supplier.enabled === false || status === "unknown" ? "neutral" : status,
           warning: supplier.state !== "err" && supplier.enabled !== false && ["warn", "crit"].includes(status) ? tr(status === "crit" ? "stateCrit" : "stateWarn") : null };
       };
-      const selectPrimaryMetric = (supplier, tr = (key) => key) => {
+      /** 仅计量供应商：只有本地 token，没有任何可查询的额度。 */
+      const isMeteredSupplier = (supplier) => supplier?.queryable === false;
+      /** 仅计量行「近 N 天」的合计：与图表同一份 usageDays，不另算口径。 */
+      const weekTokensOf = (supplier) => (Array.isArray(supplier?.usageDays)
+        ? supplier.usageDays.reduce((sum, day) => sum + (Number(day?.total) || 0), 0) : 0);
+      const selectPrimaryMetric = (supplier, tr = (key) => key, windowDays = 7) => {
+        // 仅计量行没有指标可选：主指标就是它自己的量。今日在行尾另给一次是既有版式。
+        if (isMeteredSupplier(supplier)) {
+          const text = tr("windowTokens", { d: windowDays, n: fmtBig(weekTokensOf(supplier)) });
+          return { kind: "usage", value: text, label: "", name: "", reset: null, tone: "neutral", more: 0, text };
+        }
         const entries = supplier?.entries || [];
         const entry = tightestOf(entries) || entries.find(e => e.kind === "bal") || entries.find(e => e.kind === "cost") || entries[0];
         if (!entry) return { kind: "unknown", value: "—", label: "", name: "", reset: null, tone: "neutral", more: 0, text: "—" };
@@ -134,10 +144,12 @@
           columns: [{ key: "name", labelKey: "colMetric" }, ...METRIC_COLUMNS[kind]], rows,
         }));
       };
-      const supplierStatus = (s, tr) => s?.state === "err"
+      const supplierStatus = (s, tr) => isMeteredSupplier(s) ? tr("meteredOnly") : s?.state === "err"
         ? tr(s.entries?.length ? "staleFailure" : "unavailable")
         : s?.enabled === false ? tr("disabled") : !s?.entries?.length ? tr("notQueried") : tr(stateToken(s));
-      const todayTotal = (state) => (state?.suppliers || []).filter(s => s.current)
+      // 今日总量 = 列表里各行的和（口径可对账）：只要这一行有 token，它就在列表里、也在总量里。
+      // 旧口径只加 current 行，于是「未配置但在跑」的供应商 token 会既看不见也不算数。
+      const todayTotal = (state) => (state?.suppliers || []).filter(s => s.added !== false)
         .reduce((sum, s) => sum + (typeof s.todayTokens === "number" ? s.todayTokens : 0), 0);
 
       // ---------- 今日 Token 分布（数据来自宿主 todayUsage / usageDays，五分量互不相交） ----------
@@ -716,6 +728,8 @@
         enabled: !!sup.enabled, baseUrl: sup.baseUrl || sup.baseUrlDefault || "",
         warnPct: sup.warnPct ?? 80, critPct: sup.critPct ?? 95,
         apiKeyEnv: sup.apiKeyEnv || "",
+        // 仅计量行只有一个可改的东西：显示名（存进 config.meteredNames[route]）。
+        ...(isMeteredSupplier(sup) ? { name: sup.name || "" } : {}),
         // 关注限额：有序数组；空数组 = 未配置（卡片走默认规则）。草稿复制一份，避免直接改 state。
         displayKeys: Array.isArray(sup.displayKeys) ? [...sup.displayKeys] : [],
         ...Object.fromEntries((sup.meta?.needs || []).map((need) => [need.key, need.secret ? "" : (sup[need.key] ?? "")])),
@@ -751,9 +765,15 @@
         const compact = narrow || preference === "compact";
         const active = state?.active;
         const supplier = active && state?.suppliers?.find(s => s.id === active.supplierId);
-        const metric = selectPrimaryMetric(supplier, t);
+        // 「近 N 天」的 N 来自保留期（retentionDays < 7 时窗口确实更短），不是写死的 7。
+        const windowDays = state?.poll?.usageHistoryDays || 7;
+        const metric = selectPrimaryMetric(supplier, t, windowDays);
         const name = active?.name || t("noneActive");
         const todayCount = typeof supplier?.todayTokens === "number" ? supplier.todayTokens : 0;
+        // 仅计量行没有条也没有百分比：第 2 行直接给这个窗口里它自己的量（今日 chip 已在第 1 行）。
+        const metricText = isMeteredSupplier(supplier)
+          ? t("windowTokens", { d: windowDays, n: fmtBig(weekTokensOf(supplier)) })
+          : metric.text;
         const bars = selectBarMetrics(supplier, t);
         const resetText = bars.length ? bars.map(bar => bar.reset).filter(Boolean).join(" · ") : metric.reset;
         const failure = loadError ? t(state ? "staleFailure" : "unavailable") : supplier?.state === "err" ? supplierStatus(supplier, t) : "";
@@ -766,7 +786,7 @@
             seasonUsesBeijingNote() ? t("seasonBeijingOnly") : null].filter(Boolean).join(" · ")
           : "";
         // 卡片上的可见文字只留数据；完整状态（今日口径、连接、峰谷成因）进 aria/title。
-        const title = [name, metric.text, resetText, seasonTitle, failure, t("todayScope"), t("today", { n: state ? fmtBig(todayTotal(state)) : "—" }), connText].filter(Boolean).join(" · ");
+        const title = [name, metricText, resetText, seasonTitle, failure, t("todayScope"), t("today", { n: state ? fmtBig(todayTotal(state)) : "—" }), connText].filter(Boolean).join(" · ");
         return h(React.Fragment, null,
           !wide ? h("button", { type: "button", ref: entryRef, "data-qm-entry": "", className: "qm-rail", "aria-label": t("title"), "aria-haspopup": "dialog", "aria-expanded": !!panel.host, title, onClick: activateEntry }, "◉") :
           h("div", { "data-qm-linerow": "", "data-qm-density": compact ? "compact" : "expanded", ref: widthRef, className: "qm-footer" },
@@ -791,7 +811,7 @@
                     h("i", { className: `qm-bar-fill ${bar.tone}`, style: { width: `${Math.max(0, Math.min(100, bar.entry.pct))}%` } })),
                   h("span", { key: `p${i}`, className: "qm-bar-pct" }, pctText(bar.entry.pct)),
                   bar.reset ? h("span", { key: `r${i}`, className: "qm-bar-reset" }, bar.reset) : null,
-                ])) : h("div", { className: "qm-l2" }, h("span", { className: "qm-primary", title: metric.text }, metric.text)),
+                ])) : h("div", { className: "qm-l2" }, h("span", { className: "qm-primary", title: metricText }, metricText)),
                 season ? h("div", { className: `qm-season ${season.peak ? "peak" : "valley"}`, "data-qm-season": season.tier, title: seasonTitle },
                   h("span", { className: `qm-season-dot ${season.peak ? "peak" : "valley"}` }),
                   h("b", null, seasonTierOf(season, t)),
@@ -825,9 +845,10 @@
         const { state, loadError, refresh, refreshing, sessionKey } = useQuotaState();
         const snap = useSurface();
         const [expandedId, setExpandedId] = React.useState(null);
-        // 没有本地用量行的供应商不画图，也就不必为它取额度历史。
+        // 没有本地用量行的供应商不画图，也就不必为它取额度历史；仅计量行从不查询，同样不必取。
         const expandedSupplier = (state?.suppliers || []).find((sup) => sup.id === expandedId);
-        const quota = useQuotaHistory(sessionKey, Array.isArray(expandedSupplier?.usageDays) && expandedSupplier.usageDays.length > 0);
+        const quota = useQuotaHistory(sessionKey, expandedSupplier?.queryable !== false
+          && Array.isArray(expandedSupplier?.usageDays) && expandedSupplier.usageDays.length > 0);
         const dialog = host === "dialog";
         // Escape / 外部点击必须走 controller 的未保存确认；useDialog 只拿到这个稳定转发器。
         const closeRef = React.useRef(() => {});
@@ -1039,7 +1060,8 @@
           const sup = (state?.suppliers || []).find((s) => s.id === supplierId);
           if (!sup) return;
           const warn = Number(form.warnPct), crit = Number(form.critPct);
-          if (!Number.isFinite(warn) || !Number.isFinite(crit) || warn < 1 || warn >= crit || crit > 100) {
+          if (!isMeteredSupplier(sup)
+            && (!Number.isFinite(warn) || !Number.isFinite(crit) || warn < 1 || warn >= crit || crit > 100)) {
             setSaveError(t("invalidThreshold")); setAdvanced(true);
             requestAnimationFrame(() => advancedRef.current?.querySelector('input[type="number"]')?.focus()); return;
           }
@@ -1051,8 +1073,10 @@
           opBusyRef.current = true;
           setOpBusy(true);
           try {
-            const p = supplierPatch(sup, form);
-            await post(`${API}/settings`, { suppliers: { [supplierId]: p } });
+            // 仅计量行不改任何查询参数：只有名字，写进 config.meteredNames[route]。
+            await post(`${API}/settings`, isMeteredSupplier(sup)
+              ? { meteredNames: { [sup.route]: String(form.name || "").trim() } }
+              : { suppliers: { [supplierId]: supplierPatch(sup, form) } });
             await reload();
             outcome = { ok: true };
             if (!latest()) return;
@@ -1164,13 +1188,14 @@
           shown.length
             ? h("div", { className: "qm-rows" }, shown.map(sup => h(SupplierRow, {
               key: sup.id, sup, t, season: state.season, quota: quotaOf(sup.id),
+              windowDays: state.poll?.usageHistoryDays || 7,
               expanded: expandedId === sup.id, onToggle: () => onExpand(expandedId === sup.id ? null : sup.id), onEdit })))
             : h(Empty, { text: t(filter === "attention" ? "noAttention" : "overviewEmpty"), action: filter === "all" ? t("manageSuppliers") : null, onAction: onManage }),
           h(HistoryTable, { rows: (state.history || []).slice(0, 50), t }));
       }
 
-      function SupplierRow({ sup, t, season, quota, expanded, onToggle, onEdit }) {
-        const metric = selectPrimaryMetric(sup, t);
+      function SupplierRow({ sup, t, season, quota, windowDays, expanded, onToggle, onEdit }) {
+        const metric = selectPrimaryMetric(sup, t, windowDays);
         const todayNumber = typeof sup.todayTokens === "number" ? sup.todayTokens : 0;
         const error = String(sup.error?.message || sup.error?.code || "");
         const detailId = `qm-detail-${sup.id}`;
@@ -1188,7 +1213,9 @@
           h("button", { type: "button", className: "qm-row-head", "data-qm-row": "", "aria-expanded": expanded, "aria-controls": detailId, onClick: onToggle },
             h("span", { className: `qm-dot ${stateClass(sup)}` }),
             h("b", { className: "qm-row-name" }, sup.name),
-            sup.current ? h("span", { className: "qm-cur" }, t("current")) : null,
+            // 「当前」= 在用/计入今日总量的那个；仅计量行恒计入总量，但不是一个「当前供应商」，
+            // 给它打这个标会让每一行都读作当前，所以只对注册表行显示。
+            sup.current && !isMeteredSupplier(sup) ? h("span", { className: "qm-cur" }, t("current")) : null,
             h("span", { className: `qm-pill ${stateClass(sup)}` }, supplierStatus(sup, t)),
             h("span", { className: "qm-row-metric" }, metric.value),
             h("span", { className: "qm-row-today" }, `${t("todayLabel")} ${fmtBig(todayNumber)}`),
@@ -1196,15 +1223,16 @@
           expanded ? h("div", { id: detailId, className: "qm-row-detail", role: "region", "aria-label": `${sup.name} ${t("detailTitle")}` },
             sup.state === "err" ? h("div", { className: "ci-err", role: "status" }, supplierStatus(sup, t), error ? `：${error.slice(0, 180)}` : "",
               error.length > 180 ? h("details", null, h("summary", null, t("errorDetails")), h("p", null, error)) : null) : null,
+            // 仅计量行不查询，所以没有「最后成功」也可能没有指标表——空白不是失败态，是这类行的常态。
             sup.lastSuccessAt ? h("div", { className: "qm-data-time" }, `${t("lastSuccess")} ${new Date(sup.lastSuccessAt).toLocaleString()}`) : null,
-            h(MetricTable, { supplier: sup, t }),
+            isMeteredSupplier(sup) ? null : h(MetricTable, { supplier: sup, t }),
             h(TodayLine, {
               sup, t, tokens: scopedTokens, usage: scopedUsage,
-              range, onRange: setRange, mode: estMode, onMode: setEstMode,
+              range, onRange: setRange, mode: estMode, onMode: setEstMode, windowDays,
             }),
             h(UsageSplit, { usage: scopedUsage, t }),
             h(SeasonBlock, { season, split: sup.seasonSplit, t }),
-            h("div", { className: "qm-row-actions" }, h("button", { type: "button", onClick: () => onEdit(sup.id) }, t("openPage"))),
+            h("div", { className: "qm-row-actions" }, h("button", { type: "button", onClick: () => onEdit(sup.id) }, t(isMeteredSupplier(sup) ? "rename" : "openPage"))),
             Array.isArray(sup.usageDays) && sup.usageDays.length
               ? h(UsageChart, { sup, days: sup.usageDays, quota, windowTotal: sup.usageDays.reduce((sum, day) => sum + (Number(day?.total) || 0), 0), t })
               : null) : null);
@@ -1227,7 +1255,7 @@
        * 今日行：区间选择器 + 数量 + 归一比例 + 窗口估算。
        * 「Today」两个字换成选择器后，同一行读作「哪个区间、多少 token、什么比例、各窗口还能用多少」。
        */
-      function TodayLine({ sup, t, tokens, usage, range, onRange, mode, onMode }) {
+      function TodayLine({ sup, t, tokens, usage, range, onRange, mode, onMode, windowDays = 7 }) {
         const total = fmtBig(tokens || 0);
         const ratio = usageRatioOf(usage);
         const detailText = ratio ? t("ratioAria", { hit: fmtBig(ratio.hitValue), miss: fmtBig(ratio.missValue), out: fmtBig(ratio.outValue) }) : "";
@@ -1240,7 +1268,7 @@
               onChange: (ev) => onRange(ev.target.value === "7d" ? "7d" : "today"),
             },
               h("option", { value: "today" }, t("todayLabel")),
-              h("option", { value: "7d" }, t("range7d")))),
+              h("option", { value: "7d" }, t("statsWindow", { n: windowDays })))),
           h("span", { className: "qm-today-text" }, text),
           ratio ? h("span", { className: "qm-ratio", title: detailText },
             h("b", { className: "r-hit" }, ratio.hit), " : ", h("b", { className: "r-miss" }, ratio.miss), " : ", h("b", { className: "r-out" }, ratio.out)) : null,
@@ -1352,7 +1380,7 @@
               h("span", { className: "chip" }, t("connectedChip", { n: added.length })),
               h("button", { type: "button", className: `qm-rescan-btn${ctl.scanBusy ? " busy" : ""}`, disabled: ctl.scanBusy, onClick: ctl.runRescan }, `⟳ ${t("rescan")}`))),
           h("div", { className: "qm-scanline" }, scanLine()),
-          added.length ? orderedRows(added, t, ctl) : h(Empty, { text: t("emptyAdded"), action: t("rescan"), onAction: ctl.runRescan }),
+          added.length ? orderedRows(added, t, ctl, state.poll?.usageHistoryDays || 7) : h(Empty, { text: t("emptyAdded"), action: t("rescan"), onAction: ctl.runRescan }),
           addable.length ? h("details", { className: "qm-addable", open: addableOpen, onToggle: (e) => setAddableOpen(e.currentTarget.open) },
             h("summary", null, h("span", null, t("addableTitle")), h("span", { className: "cnt" }, addable.length)),
             h("div", { className: "addable-list" }, addable.map((a) => h("div", { key: a.id, className: `qm-add-row${ctl.freshIds.includes(a.id) ? " fresh" : ""}` },
@@ -1380,20 +1408,24 @@
               h("option", { value: "expanded" }, t("expanded")), h("option", { value: "compact" }, t("compact")))));
       }
 
-      function orderedRows(added, t, ctl) {
-        return h("div", { className: "qm-page-list" }, added.map((sup) =>
-          h("div", { key: sup.id, "data-supplier": sup.id, className: "qm-page-row" },
+      function orderedRows(added, t, ctl, days = 7) {
+        return h("div", { className: "qm-page-list" }, added.map((sup) => {
+          const metered = isMeteredSupplier(sup);
+          return h("div", { key: sup.id, "data-supplier": sup.id, className: "qm-page-row" },
             h("div", { className: "qm-page-main" },
               h("span", { className: `qm-dot ${stateClass(sup)}` }),
-              h("span", { className: "qm-page-name", title: sup.meta?.compat ? t("compatSource") : undefined }, sup.name),
-              h("span", { className: "qm-row-metric" }, selectPrimaryMetric(sup, t).value),
+              h("span", { className: "qm-page-name", title: sup.meta?.compat ? t("compatSource") : metered ? sup.route : undefined }, sup.name),
+              h("span", { className: "qm-row-metric" }, selectPrimaryMetric(sup, t, days).value),
               h("span", { className: `qm-pill ${stateClass(sup)}` }, supplierStatus(sup, t)),
-              h("span", { className: "qm-page-pill" }, t(sup.meta?.credentialLabelKey || "apiKey"))),
+              // 仅计量行没有凭据类别可标：它的凭据就是宿主自己的路由，插件不持有任何密钥。
+              metered ? null : h("span", { className: "qm-page-pill" }, t(sup.meta?.credentialLabelKey || "apiKey"))),
             h("div", { className: "qm-page-actions" },
-              h("label", { className: "qm-page-toggle" },
+              // 没有可启用/停用的东西：行是流量的产物，不是一个可以关掉的采集器。
+              metered ? null : h("label", { className: "qm-page-toggle" },
                 h("input", { type: "checkbox", checked: !!sup.enabled, disabled: !!ctl.toggling[sup.id] || [...settingsWrites].some(operation => operation.supplierId === sup.id), onChange: () => ctl.toggleEnabled(sup) }),
                 h("span", null, t("enable"))),
-              h("button", { type: "button", className: "s-test qm-pri-soft", onClick: () => ctl.openSupplier(sup.id) }, t("openPage"))))));
+              h("button", { type: "button", className: "s-test qm-pri-soft", onClick: () => ctl.openSupplier(sup.id) }, t(metered ? "rename" : "openPage"))));
+        }));
       }
 
       // ---------- 供应商配置子页 ----------
@@ -1421,6 +1453,23 @@
         const editor = ctl.editor;
         if (!sup || !editor) return h("div", { className: "qm-sub", role: "status" }, t("loading"));
         const f = editor.form;
+        // 仅计量子页：没有凭据、没有阈值、没有关注限额——只有名字与它挂在哪条路由上。
+        if (isMeteredSupplier(sup)) {
+          return h(React.Fragment, null,
+            h("div", { className: "qm-page-head" },
+              h("button", { type: "button", className: "s-test", onClick: ctl.closeEditor }, `← ${t("back")}`),
+              h("b", null, sup.name),
+              h("span", { className: "qm-pill" }, t("meteredOnly"))),
+            h("div", { className: "s-group" },
+              h("label", null, h("span", null, t("meteredName")),
+                h("input", { type: "text", value: f.name || "", maxLength: 60, placeholder: sup.route, disabled: ctl.opBusy,
+                  onChange: (e) => ctl.setEditorField("name", e.target.value) })),
+              h("p", { className: "qm-empty-line" }, `${t("meteredRoute")} · ${sup.route}`)),
+            h("div", { className: "s-actions" },
+              ctl.saved === sup.id ? h("span", { className: "s-saved" }, t("saved")) : null,
+              h("button", { type: "button", onClick: ctl.closeEditor, disabled: ctl.opBusy }, t("cancel")),
+              h("button", { type: "button", className: "qm-pri", onClick: ctl.saveSupplier, disabled: ctl.opBusy }, t("save"))));
+        }
         const needsInputs = (sup.meta?.needs || []).map((need) =>
           h("label", { key: need.key }, needsLabel(sup, need, t),
             h("input", {
@@ -1711,7 +1760,7 @@
           disabled: "未启用",
           notQueried: "尚未查询",
           lastSuccess: "数据时间",
-          todayScope: "当前供应商的今日 Token 用量，按宿主本地日统计",
+          todayScope: "已添加供应商的今日 Token 用量合计，按宿主本地日统计",
           eventsObserved: "已观测到调用事件",
           previewSaved: "已保存配置的最近查询结果；编辑草稿不会改变此预览。",
           advanced: "高级选项",
@@ -1772,7 +1821,6 @@
           statsWindow: "近 {n} 天",
           remainLabel: "剩余 {n}%",
           rangeLabel: "统计区间",
-          range7d: "近 7 天",
           estLeft: "剩余",
           estTotal: "套餐总量",
           estNoData: "本地样本不足",
@@ -1793,6 +1841,12 @@
           stateCrit: "临界",
           stateErr: "取数失败",
           stateOff: "未配置",
+          // 仅计量供应商：只有经过 Harness 的 token，没有可查询的额度与百分比
+          meteredOnly: "仅计量",
+          windowTokens: "近 {d} 天 {n}",
+          rename: "改名",
+          meteredName: "名称",
+          meteredRoute: "DSH 路由",
           quota: "限额",
           usedShort: "已用",
           detailTitle: "明细",
@@ -1849,7 +1903,7 @@
           critPct: "临界阈值 %",
           interval: "轮询间隔（秒，10–3600）",
           retention: "用量保留期（天，1–90）",
-          unmapped: "另探测到 DSH 内已添加但本插件暂不支持的供应商",
+          unmapped: "另探测到 DSH 内已添加、但没有额度查询的供应商",
         },
         en: {
           current: "Current",
@@ -1883,7 +1937,7 @@
           disabled: "Disabled",
           notQueried: "Not queried yet",
           lastSuccess: "Data updated",
-          todayScope: "Today's Token usage for current suppliers, measured by the host local day",
+          todayScope: "Today's Token usage across every listed supplier, measured by the host local day",
           eventsObserved: "Call events observed",
           previewSaved: "Latest query for the saved configuration. Draft edits do not change this preview.",
           advanced: "Advanced options",
@@ -1943,7 +1997,6 @@
           statsWindow: "Last {n} days",
           remainLabel: "{n}% left",
           rangeLabel: "Range",
-          range7d: "Last 7 days",
           estLeft: "Left",
           estTotal: "Total",
           estNoData: "Not enough local samples",
@@ -1964,6 +2017,11 @@
           stateCrit: "Critical",
           stateErr: "Fetch failed",
           stateOff: "Not configured",
+          meteredOnly: "Usage only",
+          windowTokens: "{d}d {n}",
+          rename: "Rename",
+          meteredName: "Name",
+          meteredRoute: "DSH route",
           quota: "Limit",
           usedShort: "Used",
           detailTitle: "Details",
@@ -2020,7 +2078,7 @@
           critPct: "Critical threshold %",
           interval: "Poll interval (s, 10–3600)",
           retention: "Usage retention (days, 1–90)",
-          unmapped: "Detected DSH suppliers this plugin does not support yet",
+          unmapped: "Detected DSH suppliers with no quota query",
         },
       };