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

package/README.md

@@ -1,91 +1,48 @@
 # 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.4.1**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
+DeepSeek Harness 用量监控插件：查看当前会话对应供应商的周期限额、账户余额、报告费用与今日 Token 用量，
+也能统计任何未内置供应商的 Token 消耗。支持 Windows 桌面端与 Web 界面。
 
-Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图标是根目录 `icon.svg`，标题与一句话说明来自 `locale/zh.json` 与 `locale/en.json` 的 `meta`。
-
-[GitHub 下载](https://github.com/shxtmaker/dsh-token-quota/releases/latest) · [问题反馈](https://github.com/shxtmaker/dsh-token-quota/issues)
-
-## 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 更新
+中文 · [English](README.en.md)
 
-- 修复智谱／Z.ai Coding Plan 查询失效：供应商已把用量窗口的类型名由 `TOKENS_LIMIT` 改名为 `CREDIT_LIMIT`，插件此前只认旧名，窗口全部被跳过，供应商显示为「暂时无法获取」。
-- 窗口改按 `unit` 标识分类（5 小时窗口、周窗口、月度 MCP 上限），不再依赖数组位置；新增周窗口与供应商公布的重置时刻。新旧拼写并存时都能读取，重复或无法命名的窗口如实报错，不猜一个窗口顶上。
-- 业务失败改按响应信封判定：密钥失效（HTTP 200 响应体内的 `code:401`）报鉴权失败，不再误报成「响应缺少 data.limits」。
+![用量监控概览：可查额度的供应商与一条「仅计量」行](docs/images/overview.png)
 
-## v2.0.4 更新
+当前版本：**v2.6.0**。要求 **DSH ≥ 0.1.7-rc.2**；真实桌面及 Web 验收环境为 **DSH 0.2.0-rc.2**。
 
-- 修复 Command Code 等供应商未公布重置时刻时错误显示“1月1日”的问题。
-- 统一验证日期文案与原始时刻，零值、无效日期和误传入毫秒字段的秒级值显示为未知，不推算重置时间。
-- 保留有效毫秒、数字串和带时区日期的准确时刻，OpenCode Go 的正常窗口倒计时保持不变。
-
-## v2.0.3 更新
-
-- 点击侧栏打开贴在卡片上方的用量浮卡，显示供应商主指标、查询状态、刷新间隔和上次刷新时间。
-- 浮卡底部提供“详情”“设置”“关闭”；完整供应商明细和现有配置面板继续保留。
-- 浮卡适配完整、紧凑和图标侧栏，支持再次点击、Esc 和外部点击关闭，随窗口变化调整位置。
+Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图标是根目录 `icon.svg`，标题与一句话说明来自 `locale/zh.json` 与 `locale/en.json` 的 `meta`。
 
-## v2.0.2 更新
+[npm](https://www.npmjs.com/package/@ds-hu/dsh-token-quota) · [问题反馈](https://github.com/ds-hu/dsh-usage-monitor/issues)
 
-- 修复停用、重新启用和宿主重启插件时的 `webserver: duplicate exact route` 启用失败。
-- 启动失败时释放已登记的资源；某项清理报错不会阻止其他资源释放。
+## v2.6.0 更新
 
-## v2.0.1 更新
+- **任意供应商的 Token 统计**：DSH 里未归属到内置供应商的 LLM 路由，跑过一次就在概览里多出一条
+  **「仅计量」**行——只有今日与近 N 天的 Token、五分量分布与归一比例，不查额度、不画百分比、
+  不发任何新的外部请求。此前这类路由的用量被整段丢弃。
+- **今日总量改为「概览列表里每一行之和」**：一行只要有今日用量就一定在列表里、也一定计入，
+  可以逐行相加核对；「当前」标从此只表示小组件在用哪一家，不再等于「计入」。
+- **DeepSeek 桌面登录与 API Key 合并成一行**：登录态产生的 Token 也计入今日用量，
+  只有额度查询仍需要 API Key。
+- 路由后来被插件支持时，`local:<route>` 的历史用量并入正式供应商，不从 0 开始；收编过程中
+  在途步骤的替换样本不再被重复计入。
+- 「近 N 天」的 N 取自用量保留期，不再一律写「近 7 天」。
 
-- 侧栏单击恢复独立「供应商限额明细」弹窗，按 v1.4.0 分栏展示已添加供应商与周期指标，刷新历史恢复为表格，沿用当前主题配色和按钮样式。
-- 详情中的「设置」按钮进入现有概览、供应商、设置面板；保留完整／紧凑侧栏和显示偏好。
-- 修复供应商扫描中的 `cannot get required service "settings" in inactive context` 错误；设置服务暂不可用时保留最近成功目录，恢复后可重新扫描。
+## v2.5.0 更新
 
-## v2.0.0 更新
+- 展开行的「Today」换成选择器：可切「今天 / 近 7 天」，token 数、归一比例与五分量分布条一起换成该区间的合计；图表固定 7 天，不跟着变。
+- 同一行右侧给出各窗口的 token 估算（5h / 周 / 月），可在「剩余」与「套餐总量」之间切换；悬停显示取样区间、分子分母与 ±1pp 区间。
+- 估算按取样内的斜率折算（本地 token ÷ Δpp），不再除以累计已用%：月窗口比本地留存长时，旧算法只拿得到最近几天的 token，会把总量算成一半。
+- 修复图表柱值数字被折线压花：数字底下垫一层卡片底色，折线从数字背后穿过。
 
-- 侧栏支持完整与紧凑显示，单击直接打开概览，显示偏好自动保存。
-- 用量监控面板提供「概览」「供应商」「设置」三个页签，侧栏入口与宿主设置入口使用相同内容。
-- 概览支持需关注筛选、自适应一列或两列布局，保留各周期与币种的独立指标。
-- 配置编辑保留未保存草稿，提供放弃修改确认；保存失败保留输入，避免旧请求覆盖新的编辑内容。
-- 查询失败时保留上次成功数据并标明状态；未知值与真实零值分别显示。
-- 适配 Windows 桌面端的当前会话选择、原生设置入口和侧栏收起／恢复。
+更早的逐版本记录见 [CHANGELOG](CHANGELOG.md)。
 
 ## 安装
 
-插件有两个来源：npm 包 **`@ds-hu/dsh-token-quota`**，或 Release 里的安装包 **`dsh-token-quota-2.4.0.tgz`**（源码包为 `dsh-token-quota-2.4.0-source.tar.gz`）。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
+插件从 npm 安装：**`@ds-hu/dsh-token-quota`**。离线部署时可以在源码目录 `npm pack` 打出 `ds-hu-dsh-token-quota-2.6.0.tgz`，用压缩包安装。插件包不包含 DeepSeek Harness；首次安装可能需要联网下载依赖。
 
 ### Windows 桌面端
 
@@ -93,15 +50,15 @@ Plugins 面板中显示为 **用量监控**（英文 **Usage monitor**）：图
 
 ```powershell
 $desktopCli = 'D:\AI\DeepSeek- Harness\resources\runtime\cli\bin\dsh.cmd'
-$archivePath = (Resolve-Path './dsh-token-quota-2.4.0.tgz').Path
-& $desktopCli plugin --profile desktop add "file:$archivePath"
+& $desktopCli plugin --profile desktop add @ds-hu/dsh-token-quota
 & $desktopCli plugin --profile desktop list --depth 0
 ```
 
-插件已在 npm 上，用一条命令安装即可，不必先下载压缩包：
+离线安装时把包名换成压缩包路径：
 
 ```powershell
-& $desktopCli plugin --profile desktop add @ds-hu/dsh-token-quota
+$archivePath = (Resolve-Path './ds-hu-dsh-token-quota-2.6.0.tgz').Path
+& $desktopCli plugin --profile desktop add "file:$archivePath"
 ```
 
 重新打开桌面应用，展开左侧栏即可看到用量组件；也可从「设置 → 用量监控」进入。安装到 `web` profile 的插件不会自动出现在桌面端。桌面侧栏收起后组件随侧栏隐藏，展开后恢复。
@@ -117,19 +74,19 @@ dsh plugin --profile web add @ds-hu/dsh-token-quota
 dsh --profile web
 ```
 
-从 Release 的压缩包安装：
+离线安装（先 `npm pack` 得到压缩包）：
 
 Linux / macOS：
 
 ```bash
-dsh plugin --profile web add "file:$(pwd)/dsh-token-quota-2.4.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 './dsh-token-quota-2.4.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
 ```
@@ -141,8 +98,8 @@ dsh --profile web
 ### 从源码安装
 
 ```bash
-git clone https://github.com/shxtmaker/dsh-token-quota.git
-cd dsh-token-quota
+git clone https://github.com/ds-hu/dsh-usage-monitor.git
+cd dsh-usage-monitor
 npm ci
 dsh plugin --profile web add "link:$(pwd)"
 dsh --profile web
@@ -172,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)
+
 | 页签 | 内容 |
 | --- | --- |
 | 概览 | 今日总量、全部/需关注筛选、可展开的供应商明细、默认收起的刷新历史。 |
@@ -195,7 +154,7 @@ dsh plugin --profile web add "link:$pluginDirectory"
 
 ## 数据含义
 
-- **今日用量**：当前供应商通过 Harness 产生的当日 Token 用量，按宿主本地日统计。独立 CLI 或其他应用中的调用不计入。
+- **今日用量**：概览列表里每一行（已添加供应商，含仅计量行）通过 Harness 产生的当日 Token 用量之和，按宿主本地日统计。一行只要有今日用量就必然在列表里，所以这个合计可以逐行相加核对。独立 CLI 或其他应用中的调用不计入。
 - **用量分布**：今日用量按 DSH 的互不相交口径拆成五项（未缓存输入、输出、缓存命中、缓存写入、未细分），五项之和恒等于今日总量。比例只取前三项并归一到「缓存未命中 = 1」。
 - **剩余额度**：按 `100 − 已用百分比` 派生。额度在一个窗口内只增不减，因此百分比回落即表示换了新窗口，折线在此断开。只对带百分比的窗口（`5h`／`周`／`月` 等）成立；余额与报告费用没有百分比，不进折线。
 - **周期限额**：百分比表示已用比例；常驻卡片第 2 行画的是用户配置的**关注限额**（可多条、按配置顺序），没配置时固定取周窗口、没有周窗口再取已用比例最高的有效窗口；每条的重置时间始终对应它自己的窗口。概览与紧凑侧栏的主指标仍取已用比例最高的有效窗口。
@@ -224,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 使用兼容接口，其可用性取决于供应商接口。表格表示插件支持的查询能力，不代表所有真实账户均已完成验证。
 
 ## 数据保存与升级
@@ -241,6 +214,7 @@ dsh plugin --profile web add "link:$pluginDirectory"
 ## 限制
 
 - 仅观测经过 Harness 的调用；本机 Codex CLI 登录状态和独立 CLI 用量不在范围内。
+- 「仅计量」行只有 Token：没有额度、余额与百分比可看，也不能手工添加或停用。
 - 供应商未返回重置时间时，不推算或补造时间；无限额度和未知余额保留未知。
 - 趋势图只覆盖本地记录：额度折线依赖插件运行期间采样，装插件之前的历史无从补录；额度历史磁盘保留 14 天，展示窗口跟随用量保留期（默认 7 天），期间没有查询就没有点。
 - 本地用量统计与供应商账单可能因周期、时区和统计范围不同而不同。
@@ -262,15 +236,21 @@ npm pack
 真实宿主验收使用独立数据目录与 profile，不修改日常配置：
 
 ```powershell
-npm run test:desktop -- --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/dsh-token-quota-2.4.0.tgz' --output '.scratch/desktop-v2-check'
-node scripts/verify-web.mjs --app 'C:/path/DeepSeek Harness.exe' --package 'C:/path/dsh-token-quota-2.4.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)
+[桌面兼容性说明](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)
+
+## 来源与致谢
+
+本仓库是 [shxtmaker/dsh-token-quota](https://github.com/shxtmaker/dsh-token-quota) 的 fork，在 npm 上以
+`@ds-hu/dsh-token-quota` 发布。插件 id、设置命名空间、数据目录与各家供应商的查询规则都沿用上游，
+行为变更逐条记在 [CHANGELOG](CHANGELOG.md)。上游没有 npm 包，需要它的原始版本请用上游的 Releases。
 
 ## 许可证
 
-MIT。
+MIT。完整文本见 [LICENSE](LICENSE)，其中一并保留了上游 shxtmaker 的版权声明。