演示动图
新版仪表盘八个分区逐个切换（概览 / 队列 / 账单 / 用量 / 趋势 / 智能体 / 费率 / 设置）：
演示
✨ 为什么选它
市面计费插件大多停在「token 数 × 单价」。dsh-ui-usage-billing 把计费做成一条可对账的账本链路——用量是真的、价格是活的、峰谷跟着模型走。
账是真的，还能对账
用量从持久化会话日志实时聚合，绝不伪造样本（数据到达前显示空快照）；官方余额当日变动与本地账本交叉对账，偏差超阈值主动提示核对——账单经得起质疑。
|
价格是活的，历史不重算
models.dev 实时目录 + 内置 25 厂商 241 款模型 + 设置面板自定义单价（可按中转站绑定同模型不同价），新模型无需等发版；DeepSeek 分时价按官方变更节点分段计价（8-17 前基础价、8-17~8-23 周末计峰、8-23 起周末全谷），价格调整永不回写旧账。
|
峰谷全感知，提醒跟着模型走
计费通道按当前会话使用的模型自动识别：DeepSeek 按量走分时价（工作日 9-12 / 14-18 高峰 ×2、周末全天低谷），智谱 Coding Plan 走积分峰谷（工作日 14-18 高峰全额、非高峰积分 5 折），通道层可扩展、更多厂商逐步接入；切档前弹窗 / 系统通知自动提醒，且只有当前模型真正涉及峰谷才会提醒、费用条才显示档位——不用你盯时间表。
|
订阅、余额、额度一屏闭环
DeepSeek / Kimi / 智谱 GLM / 腾讯云 TokenHub 等 7 家官方余额、Coding Plan 额度、中转站滚动额度窗口、自声明端点，再加余额差对账——订阅扣的和余额扣的同屏可查、交叉验证。
|
更多能力，一处收口
| 费用归因 | 自动化与入口 |
|---|
| 缓存命中、官方 / 三方、工作区 / 会话 / 中转站逐级下钻；子智能体按委派链合并，TTFT、生成速度与费用突增都有据可查。 | 低谷任务队列支持草稿与 JSON 批量入队；会话行可跳回宿主对话，/usage 直接打开仪表盘。 |
| 计价与模型 | 体验与隐私 |
未收录模型明确标注，可用别名和自定义单价补全；可选 usage_stats 只读工具默认关闭。 | 中文 / English、¥ / $ / € 独立切换；无图表库、无外部 CDN，默认不注入系统提示。 |
📊 仪表盘
侧栏与即时反馈
- 触发卡：今日 / 本周 / 本月主数字、近 7 天趋势与当日水位；支持完整卡片、紧凑图标、完全隐藏，悬停可看速览。
- 费用条与提醒：常驻本轮 / 会话费用，按当前模型显示峰谷和订阅额度预警；切档与会话完成可发系统通知。
侧边栏触发卡：今日消耗金额、涨跌徽章与迷你趋势
八个分区，共享统一口径
概览 / 队列 / 账单 / 用量 / 趋势 / 智能体 / 费率 / 设置。Hero 与 KPI 支持今天、近 7 天、本周、本月、累计和自定义日期；趋势、热力图、预算、费率与全文搜索设置都使用同一份真实账本。
概览：按所选范围显示的 Hero、本年 / 今日 / 本月预计、KPI 与用量热力图
队列、智能体与设置细节
- 队列：显示峰谷倒计时和待执行 / 执行中 / 需核对 / 已完成任务；JSON 单批最多 50 条，任一无效则整批不写入。文件锁与租约避免同一
DSH_HOME 多实例重复提交。
- 智能体：按委派关系还原父对话 → 子智能体树，每行同时给出自身费用与包含全部后代的链合计。
- 设置：全文搜索、全局与按模型预算、峰谷提醒、自定义单价、原生设置页和插件信息卡；侧栏隐藏后可从宿主设置恢复。
💰 计费引擎
- 按通道归账：官方、直连、中转与未知路由分开统计；路由别名和模型别名可修复历史归属。
- 按发生时刻计价：models.dev 实时目录、内置 25 厂商 241 款模型、分段峰谷价与实时汇率；调价不回写旧账。
- 按实际支出修正：同模型可按中转站设置不同单价，未收录模型也能明确补价。
- 按预算提醒：全局与按模型预算、50 / 80 / 100% 分档提醒、余额预警和最近 40 轮费用突增归因。
费率：模型单价表（峰谷分时与实时汇率）
🔌 订阅与余额
- 订阅额度：自动识别 Kimi、Z.ai、OpenCode Go、MiniMax、Claude、CommandCode 等通道，展示剩余额度与重置时间；订阅模型费用记 0。
- 官方余额：覆盖 DeepSeek、Kimi、阶跃星辰、硅基流动、xAI、智谱 GLM、腾讯云 TokenHub，并按近 7 天消耗估算可用天数。
- 中转与对账：同站多 key 合并，识别 New API / Sub2API 滚动额度；自定义端点与官方余额差可和本地账本交叉验证。
账单：提供商计费与订阅（余额、套餐额度、模型用量）与会话明细
各渠道的识别方式、端点、凭据要求与排查顺序见 适配矩阵。
📈 用量可视化
- 下钻：会话、项目、工作区与站点逐级查看；月 / 半年 / 年热力图展示费用或 Token 强度。
- 分析：每日 Token 按结构或模型拆解，工具调用排行、TTFT / P50 / P90、生成速度和成本构成同屏可查。
- 趋势：7 / 30 天费用与调用趋势、最近 40 轮费用、峰谷占比与低谷节省金额。
- 导出：按日 / 会话 / 站点 CSV、每日 Token CSV 与全量 JSON；无图表库、无外部 CDN。
趋势：每日费用趋势、每轮费用与峰谷时段占比
🛡️ 健壮性与隐私
- 真实聚合：增量读取持久会话日志，单会话损坏容错，快照与独立账本可回退；未收录和估算价明确标注。
- 默认只读：不注入系统提示、不创建会话、不提交 Prompt；只有用户显式入队才会写入新会话，权限仍由宿主控制。
- 回环安全：HTTP 同时校验 peer socket 与 Host，写操作再校验 Origin、Content-Type 和 body 上限；CSV 防公式注入。
- 体验完整：中英文与三种币种独立持久化，统一键盘焦点，厂商健康状态同时使用形状、颜色与文字。
🚀 快速开始
当前维护 DSH 0.1.2-alpha.1 ~ 0.2.2-alpha.3 的一份代码。正式版与预览版共享同一兼容矩阵：正式版使用 npm latest，预览版使用 alpha。当前 latest 指向 1.8.2 正式版；alpha 仍指向 1.8.2-alpha.2（1.8.2 预览线已毕业，下一轮预览从 1.8.3-alpha.x 起）。
dsh plugin add 需要显式 --profile，且建议钉具体版本号，避免包管理器的发布冷静期解析到其他版本。当前正式版安装命令：
dsh plugin --profile web add npm:@kenz1117/dsh-ui-usage-billing@1.8.2
默认安装也可使用 @latest。可用 dsh --version 或 npm ls -g @deepseek-ai/dsh 确认宿主版本。
也可以在宿主 cordis.patch.yml 中手动加入：
- insert:
- id: ui-usage-billing
name: '@kenz1117/dsh-ui-usage-billing'
启动宿主后，侧边栏设置上方即出现计费入口。无需额外配置；sessionPersistence 可用时自动聚合真实用量。
🛒 从 DSH Community Market 安装
本插件同时按 DSH Community Market 的 Path A 标准来源发布目录条目。在 DSH 的
「设置 → 插件 → 插件商店 → 来源管理 → 添加来源」粘贴下面的 manifest URL，即可把本目录
加为来源，随后在市场里浏览并一键安装：
https://kenz1117.github.io/dsh-ui-usage-billing/catalog-source.json
市场托管安装只走 npm registry 的精确发行版本（安装目标由 Host 解析 npm latest 决定，
目录里列出的版本仅用于展示）。目录文件在本仓 catalog/ 下，改动由 CI 校验后随
GitHub Pages 发布。
📚 进阶参考
工作原理、计费细节、模型目录、HTTP API、配置、开发、发布、权限与已知限制
⚙️ 工作原理
插件由服务端与浏览器端两部分组成：
浏览器端 服务端（Node）
│ │
├─ GET /api/billing/usage-stats ────────▶ ├─ sessionPersistence 遍历持久化会话日志
│ ├─ 按 request/header 归属模型
│ ├─ token 按缓存命中 / 未命中分桶
│ └─ 按实时单价表估算费用（人民币）
├─ GET /api/billing/pricing ────────────▶ ├─ models.dev 模型价 + 腾讯财经汇率（逐级降级）
├─ GET /api/billing/balance ────────────▶ ├─ DeepSeek 官方余额 API（凭据 seam 取 key）
├─ llm.models 健康探测 ─────────────────▶ └─ 返回聚合统计 JSON
└─ 渲染仪表盘
- 服务端（
src/index.ts）：注入 webServer、sessionPersistence 与 credentials，注册用量、定价、余额、订阅、中转站、完成提醒、工具开关及 GET/POST /api/billing/task-queue 等回环端点。聚合器按会话缓存折叠结果并持久化独立用量账本。任务队列通过 ctx.get() 探测可选的 sessionController / workspaceRegistry，不把它们列为启动注入依赖；能力缺席时宿主与仪表盘照常工作。
- 浏览器端（
src/client/）：请求上述接口渲染仪表盘，通过 llm.models 探测各厂商连接状态。真实数据到达前显示全零空快照，不展示伪造样本。
💡 计费细节
单价表（src/client/pricing.ts）采用原生币种存储：国内厂商直接录入人民币价格，国外厂商录入美元价格。费用统一以人民币计算与展示——美元模型按实时汇率折算，国内模型全程不经过汇率换算。启动时服务端拉取实时汇率与模型价（src/pricing-fetch.ts）：USD→CNY 优先腾讯财经行情（免 key、国内可达），失败依次降级 open.er-api 与内置默认值；之后每 6 小时后台刷新，单价表弹窗标注「今日汇率」与实时 / 内置徽标。金额与费率表的展示币种跟随用户所选：切 ¥ / $ 时把每条每百万 token 单价经 convertUnitPrice 按实时汇率换算到目标币种再显示（汇率缺失时回退原生币种）。
cost（CNY）= (missInput × p_input + cacheHit × p_cacheHit + output × p_output) / 10⁶
—— 价格为原生币种；美元模型按实时 USD → CNY 汇率折算
统计中的 input 为总输入（cacheHit + cacheMiss），估算按命中 / 未命中分拆计价，避免重复计费。支持双档计费的模型按 DEFAULT_PEAK_SHARE（默认 0.5）混合高峰与低谷档；周末（北京时间周六 / 周日）全天按低谷价计费。
联网搜索请求按次估算（issue #15）：DSH 的联网搜索绕过对话通道直连官方 api.deepseek.com，会话日志只记请求、无用量事件，而开放平台照常计费。插件对这类 web/deepseek-search-llm-request 事件按次估值计入费用（默认 0.02 元/次，配置 searchCallEstimateCny 可调整；设 0 关闭），并单独累计 searchCalls 供面板提示估算口径。
「本月预计」的口径：本月已发生 + 近 7 个自然日节奏 × 本月剩余天数。只外推还没发生的天数，近期没花钱就不虚增——早期版本拿「本月有记录的天数」当分母求日均再乘整月天数，稀疏使用的月份会被放大数倍（实测 4 天记录、其余 19 天没用的月份被外推成实际值的 4 倍）。
自定义单价（设置 Tab，issue #16）：结构化条目表（模型 + 可选来源 + 输入/缓存命中/输出 + 币种），不再手编 JSON。来源（中转站域名）留空 = 该模型默认价；填入中转站域名（如 https://api.my-relay.com）= 仅该来源的同名模型用此价（同名模型可同时存在默认价与多个来源价，互不覆盖）。显示层按「模型 × 来源」精确匹配重算，命中不到来源时回落该模型默认价，再无则用内置目录价。
❤️ Contributors
DSH Usage Billing contributors
查看具体贡献记录
- @lucagiftzek — 费率表 CSS 修整（PR #59）、
trustedHosts 反代支持（PR #60）、币种偏好持久化（PR #58）、费率表搜索（PR #67）、峰谷指示点与固定到输入框（PR #68）、EUR 展示币种与界面语言解耦（PR #70）、首次价目表拉取前置到预热回放（PR #55）、models.dev 收录按证据取舍（PR #56）、硬编码 UI 文案入词典（PR #61）
- @hwangjunjie — 腾讯云 TokenHub / Token Plan 订阅额度适配（
src/tc3.ts）、提供商优先通道分组与网关徽标、routeAliases / modelKeyAliases 配置（PR #35）、订阅徽标按三维格逐通道判定（PR #83）
- @ciphoo — MiniMax 国内域 Token Plan 订阅额度支持（PR #5）、
minimax-cn 订阅凭据接线（PR #12）、Windows 下账本并发写入 MoveFileExW EPERM 修复（PR #11）
- @fabulousyuann-tech — 会话删除后用量保留的持久 ledger 功能（PR #8）
- @hi-fangj — Token 每日图悬停精确明细（PR #21）、平价消耗胶囊开关（PR #22）、Token 每日图按模型视角与图例聚焦（PR #23）、性能面板按模型对比曲线（PR #24）
- @aizhimoran — 峰谷分档支持中国法定节假日与调休：DeepSeek 按量分时把法定节假日全天按空闲时段计费（官方 2026-09-19 口径），含 10 天倒计时扫描窗（issue #73、PR #74）
- @kidbird — 接入国际版 Z.ai Coding Plan（
zai-coding）订阅额度，两条路由各自固定区域与 key 双字段分离（PR #79）
- @yuxu4468-hash — 中转站裸模型 id 计费补录：Grok 4.5/4.6、GPT-5.5、GPT-6.1 Sol、Claude Opus 4.7/4.8、Fable 5（PR #87），GPT 绘图模型
gpt-image-2 / gpt-image-2.5-sunburst（PR #88）
- @JinruiWang — workbuddy adapter 通道计价与「折叠早于实时价目表」双口径修复：已知通道名单、惰性补折三门（账本 / cache 命中 / 增量游标）与 stable-stamp 复现测试（issue #90）
- @gitfangj —
sync.sh 在 macOS 缺省 bash 3.2 下的花括号变量兼容修复
📄 许可证
MIT © 2026 KenZ (kenz1117)
