dsh-cost-meter

dsh-cost-meter 是面向 dsh / DeepSeek Harness 的多厂商 LLM Token 费用仪表插件。它把本机观察到的请求用量转换为可追溯的本地账本，并在 dsh Web profile 中提供实时小票、会话账单和用量分析。

[!WARNING] 这是本地观测、估算和回放工具，不是 DeepSeek、OpenAI、Anthropic、xAI 或其他厂商的官方账单。流式阶段会先估算，收到 provider usage 后再校正；实际扣费、发票和账户余额请以厂商控制台为准。

当前版本

当前发布包为 @mymeter/dsh-cost-meter@0.2.2。近期版本的重点是：

• 全局用量概览支持今日、最近 7 天和最近 30 天，显示费用、Token、请求数、计价覆盖率和主要模型。
• Token计费 页面统一会话、费用树和趋势/异常视图；趋势图按模型着色并提供范围切换，账本可导出为 JSON/CSV。
• DeepSeek 价格快照新增 deepseek-v4-flash-vision-exp，图片 Token 沿用 provider usage，并继续按北京时间峰谷价格计费。
• 账本默认使用 JSON；可显式选择 append 格式。余额刷新失败时保留最近一次可用结果并显示状态。

完整变更见 CHANGELOG，价格快照和覆盖范围见价格目录文档。

快速开始

从 npm 安装（推荐）

dsh plugin --profile web add @mymeter/dsh-cost-meter

从源码验证或开发

npm ci
npm run build
npm run pack:plugin
npm run verify:package
dsh plugin --profile web add ./mymeter-dsh-cost-meter-0.2.2.tgz

重新加载对应的 dsh Web profile 后，打开一个会话即可使用。运行环境要求 Node.js ^22.19.0 || >=24.0.0，以及启用 Web bundle 的 dsh profile。

完整安装、配置、更新、卸载和排错流程见安装与使用。

使用路径

运行中的请求

对话页右上角的 Token 小浮窗会显示当前请求的 Token 和费用。流式输出期间金额是临时估算；最终 assistant/message.usage 到达后，同一请求会被校正为已结算事件。小浮窗点击后可进入完整的 Token计费 页面。

会话账单

会话详情按阶段和轮次展示：

• 输入 Token（无缓存）、输入 Token（缓存）、输出 Token，以及包含在输出费用中的推理 Token；
• 当前请求、已结算金额、估算金额、失败/未知状态和模型价格版本；
• 预算阈值、缓存命中节省、DeepSeek 当前峰谷时段和下一次切换倒计时；
• 多币种原币金额。需要人民币折算时，可手动查询 USD/CNY 汇率，折算只影响展示，不改写账本。

全局会话与分析

全局 Token计费 页面使用统一的视图 Tab：

趋势范围为今日按小时、7 天或 30 天按自然日；多模型柱状图按模型着色并提供图例。分析和费用树通过按需 Remote 加载，不会塞进每次轻量快照。页面还可以下载安全字段 allowlist 内的 JSON/CSV 账本，不包含提示词、回复正文、工具内容或 API Key。

界面与演示

以下素材来自 dsh Web profile，余额、会话、Token 和金额均为模拟数据，不代表实际账户或厂商账单。

Token 计费页

没有可用 usage 或无法匹配价格时，页面会明确显示估算、未知或不可用状态，不会用 ¥0.000 冒充精确费用。

对话页与 Token 小浮窗

视频文件位于 docs/assets，可直接播放：

• 深色主题下的小浮窗基础交互（约 15 秒）
• 浅色主题下的小浮窗生成过程（约 23 秒）

计费与价格

Token 口径

• 计费事件按 (sessionId, turnId, stepId, attemptId) 去重；最终 usage 会替换同一次请求的流式估算，而不是与估算相加。
• 推理 Token 是输出 Token 的子集，展示出来便于核对，但不会重复收费。
• 没有最终 usage 时，流式文本、推理和工具增量只能用于输出 Token 的临时估算；输入缓存分桶要等 provider usage 才能补齐。
• 订阅、Code Plan、代理、云平台和 gateway route 没有独立单价时，按能唯一识别的底层厂商 API 价格做等价估算，不代表套餐实际扣费。

DeepSeek 官方快照

当前版本为 deepseek-official-pricing-2026-08-21，单价为每百万 Token 的人民币价格。高峰时段为北京时间 09:00-12:00、14:00-18:00，其余为闲时。

视觉模型的图片由 DeepSeek 换算成输入 Token；本项目直接使用 provider 返回的 Token 用量，不在插件内重复估算图片 Token。

已登记厂商

价格目录包含 DeepSeek、xAI、OpenAI、Anthropic、Google Gemini、Moonshot/Kimi、MiniMax、Mistral、Groq、Together、Fireworks 和 Cerebras。海外目录保留 USD 原币，并使用版本化汇率生成兼容的人民币金额；实时汇率只在用户手动查询时用于展示折算。

route alias（例如 openai-codex、kimi-coding、google-vertex、azure-openai-responses）会映射到底层公开 API 目录。无法唯一归属或尚未登记价格的模型会显示未知/不可用，不会套用 DeepSeek 价格。

本地数据与边界

• 发布包默认将账本写入 $DSH_HOME/mymeter/ledger.json，格式默认为 json；可在 dsh profile 配置中显式使用 ledgerFormat: append。
• JSON 与 append 都只允许一个 dsh 进程写入同一个 ledgerPath。切换格式时会保留 legacy/恢复/隔离文件，备份或清理时应将相邻文件作为一组处理。
• API Key、账本文件和余额请求只在 Host 侧；Client/Remote 只接收脱敏 DTO。prompt、completion、消息正文和工具参数不会进入账本或导出文件。
• 当前生产余额 adapter 只支持 DeepSeek 官方 /user/balance；余额不可用不影响本地费用账本。
• 价格目录随插件发布，不会自动联网热更新。仓库中的签名清单、HTTPS 下载和 SHA-256 校验目前只是库级能力，生产插件尚未接线。

文档导航

• 安装与使用：安装、首次验证、配置、凭据、更新、卸载、备份清理和排错。
• 计费口径：估算与结算、Token 分桶、峰谷价格、币种和目录解析。
• 价格目录来源与覆盖范围：厂商价格快照、route alias 和未知模型处理。
• 数据与隐私：本地数据、凭据边界、网络请求、删除方式和自更新权限。
• 常见问题：金额差异、余额、历史账本、账本格式和安装问题。
• 架构与实现：模块边界、事件流、账本、Remote 和构建发布。
• CHANGELOG：版本变更和验证记录。
• English README：英文首页。

状态与限制

当前版本已通过插件构建、类型检查、测试、包校验、tarball 消费者检查，以及隔离 dsh profile 的安装/Web/卸载/重装验收。仍需注意：

• 尚未使用真实 DeepSeek API Key 完成生产 usage/金额对账，也尚未用真实账户核对余额数值。
• 全局分析和导出依赖当前 dsh 版本提供对应 Remote 能力；旧版本会显示不可用。
• 多宽度自动化视觉回归、完整键盘路径和无障碍回归仍需补齐。

社区与许可证

欢迎通过 issue 或 PR 补充厂商价格、余额 adapter、真实对账结果、视觉/无障碍回归和文档示例。提交价格或余额能力变更时，请附上官方来源、快照日期和测试覆盖。

• 贡献指南
• 支持指南
• 安全策略
• 社区行为准则

dsh-cost-meter 采用 MIT License 发布。