@liuguangzhe/dsh-token-usage
统计本机全部 DSH 会话的历史 token 总消耗，按 message.id 去重，支持按天、模型、Provider 和项目分组。所有 DSH 对话的全局 token 使用总量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @liuguangzhe/dsh-token-usage@0.1.1Token Usage 以 @liuguangzhe/dsh-token-usage 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
统计本机全部 DSH 会话的历史 token 总消耗。与
dsh-context（只看单个会话）互补，只回答一个问题：我一共花了多少 token？
message.id 消除 v0/v3 与 resume/fork 副本（否则虚高约 3 倍）@deepseek-ai/*$DSH_HOME/dsh-token-usage/ 写自己的缓存与额度配置，不联网数据来自会话日志中每条最终 assistant 消息的 usage 字段：
| 字段 | 含义 |
|---|---|
| input | 非缓存输入 token |
| output | 输出 token（reasoning 已含在内） |
| cacheRead | 缓存读取 token |
| total | input + output + cacheRead |
| calls | LLM 调用次数 |
同一步的 streaming
assistant/chunkusage 与最终assistant/messageusage 重复，只计后者。该口径已与dsh-usage账本逐项对拍验证（9/8、9/9、9/10 完全吻合）。
本插件是可本地安装的 bundle，无第三方运行时依赖、已内置构建产物。
dsh plugin --profile desktop add /Users/d/Personal_Project/dsh-token-usage
然后重启 DSH Desktop（host 代码与 profile bundle 变更需要重启，刷新页面不够）。
也可以先装到一个隔离 profile 验证：
dsh plugin --profile plugin-lab add /Users/d/Personal_Project/dsh-token-usage dsh --profile plugin-lab --dump-config # 应看到 dsh-token-usage 层与插件行
dsh plugin --profile desktop add @liuguangzhe/dsh-token-usage
重启后打开 设置 → Token 统计：
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /dsh-token-usage/summary?range=all&groupBy=day | 汇总 + 分组 |
| GET | /dsh-token-usage/quota | 已配置接入方的额度与本周期已用/剩余，附可添加的候选列表 |
| POST | /dsh-token-usage/quota | 保存配置 { providers: { <id>: { enabled, amount, unit, refreshDay, label } } } |
| POST | /dsh-token-usage/rescan | 立即重新扫描 |
| GET | /dsh-token-usage/health | 扫描状态与覆盖信息 |
range：all｜today｜7d｜30d｜month｜cycle（本额度周期）。
也可只传 from / to（YYYY-MM-DD），Host 会自动推断为自定义区间——只传 from 表示起始至今，只传 to 表示截止之前全部。
groupBy：day｜model｜provider｜project｜session。
node scripts/report.mjs # Markdown 全量报表
node scripts/report.mjs --range 30d # 近 30 天
node scripts/report.mjs --from 2026-09-08 --to 2026-09-08 --json
node scripts/report.mjs --group day,model,project
多家订阅 / 网关混用时，额度要分开算。卡片里的接入方与「模型」页已添加的接入方严格一致——数据源是同一个 LLM 注册表（ctx.llm.listProviders()，即模型页渲染「已添加」列表时用的那批已注册接入方）：
额度配置按 provider id 存在
quota.json：某个接入方暂时从模型页移除时，它不会显示，但配置会保留，等它回到模型页时自动恢复。若 LLM 注册表不可用（例如非 Web 组合），则回退为「settings.yaml+ 历史用量」推断。全局用量仍可在上方表格的「按 Provider」分组查看。
配置只保存在本机 $DSH_HOME/dsh-token-usage/quota.json，不上传、不写入会话。示例：datagrand 每月 20 亿、每月 1 日刷新 → 添加该行后额度填 20、单位 亿、刷新日 1；deepseek-official 是官方 API 按量计费，不添加或不启用即可。
旧版单额度配置会在首次读取时自动迁移到用量最大的接入方，不会丢失。
在 cordis.patch.yml 的插件行上可覆盖（整段 config 替换）：
- insert:
- id: dsh-token-usage
name: '@liuguangzhe/dsh-token-usage'
config:
timeZone: Asia/Shanghai # 分天时区
scanIntervalMs: 60000 # 后台增量刷新间隔
cache: true # 结果落盘缓存
homes: [] # 额外扫描的 DSH home（默认自动发现）
lib/
├── index.js # Host：扫描生命周期 + HTTP 路由
├── client.js # Client：设置页 UI（__ModuleLoader__，仅 require('react')）
└── core/
├── zstd.js # 多帧 zstd 结构解析与逐帧解码
├── paths.js # 发现所有 DSH home
├── scan.js # 会话枚举 + usage 提取 + message.id 去重
├── aggregate.js # 时区分天 / 范围过滤 / 汇总 / 分组
└── store.js # 内存快照 + 磁盘缓存 + 增量刷新
难点与对策：
message.id，直接累加约虚高 3 倍。按 message.id 全局去重。assistant/chunk 的 usage，只计 assistant/message。node_modules 不含 @deepseek-ai/*，因此 Host 零内核导入。node --test "test/**/*.test.mjs" # 12 项测试
node scripts/report.mjs # 端到端报表
验证矩阵：
| 验收项 | 方法 | 结果 |
|---|---|---|
| 多帧 zstd 解码 | 单测：两帧拼接解码等于原文 | ✅ |
| message.id 去重 | 单测：v0/v3 副本折叠为 1 条 | ✅ |
| 口径正确 | 实盘 vs ~/.dsh/dsh-usage/usage-ledger.json（9/8、9/9、9/10） | ✅ 逐项吻合 |
| Host 路由 | 单测：注册 4 条路由并返回 JSON | ✅ |
| Client 贡献 | 单测：注册 settings.section | ✅ |
| 自定义区间 | 单测：单边/双边窗口与 cycle 刷新日（含 2 月收敛） | ✅ |
| 按接入方额度 | 单测：已配置/候选项分离、合成 provider 隔离计费、启用开关、配置落盘、旧配置迁移 | ✅ |
| 性能 | 61.6MB / 99 文件全量扫描 | ✅ ~1.4s |
本项目按 DSH 插件规范声明，可用 dsh plugin add 安装，也可被插件市场索引：
dsh.bundle.patch 指向 cordis.patch.ymldsh.client.platform = "web"，浏览器半通过 exports["./client"] 暴露dsh.compatibility.dshReleases 标注已在 0.1.5-rc.1 验证keywords 含 dsh-plugin / deepseek-harness，并声明 repository / homepage / bugsdsh-plugin，供市场 discovery 扫描ctx.effect / ctx.webServer.register / ctx.slots 接口。@deepseek-ai/*；Client 只 import React，桌面壳可安全加载。assistant/message 口径；compaction/summary 默认不计（与 dsh-usage 账本一致）。MIT