前言¶
DeepSeek Harness（DSH）底部读数行会汇总 token 用量、缓存命中率等，但不会直接给出「花了多少钱」。DeepSeek 官方定价又分峰谷时段，且缓存命中、未命中输入与输出三类 token 单价不同；若自己用计算器粗算，结果往往和账单对不上。
下面介绍社区插件 dsh-cost-meter（仓库 mmd134312/dsh-cost-manager）。它在原生读数行末尾多一格「已用人民币 X」，按官方峰谷价目实时累加，且只统计 DeepSeek 官方 provider 路由，走第三方中转时不显示、不猜测。维护者为 mmd134312，许可证 MIT，当前 package 版本 1.2.1，分类为 DSH 扩展（extension，展示名「花费计量」）。
这是什么¶
dsh-cost-meter 是给 DSH 装上的「会话级电表」：每个 session 独立账本，底部与原生 stats 同一行、样式对齐；悬停仅灰底，点击后在上方面板展示明细（三类 token、峰谷、价目版本、模型等）。计费数据落在 ${DSH_HOME}/dsh-cost/ledger.json（v2 schema）。
核心功能¶
只认官方 provider 路由¶
是否计费看 provider 路由名，不看模型名。默认识别例如 deepseek-official、deepseek-account、deepseek、deepseek-api-key，以及以 deepseek- 开头的自有路由。第三方中转（如某些聚合站里的 DeepSeek 模型名）不计费、不改变读数行。额外路由可写入 cost-config.json 的 providers。
峰谷与三类 token¶
- 峰谷：北京时间
Asia/Shanghai；工作日 9:00–12:00、14:00–18:00 为高峰（相对空闲档单价 ×2），其余为空闲（约为高峰一半）；周末与可配置节假日按空闲处理。 - 三类 token：缓存命中输入、未命中输入、输出分别计价；命中率与计费同源（命中 / (命中 + 未命中)）。
- 价目表：带来源版本（如 README 示例中的
2026-09-10），按effectiveFrom分段，历史调用不被新价追溯；未知模型记「未计价」，不编造金额。
记账方式¶
- 每会话一本账：子代理有独立 session id，底部显示的是当前会话金额。
- 增量累加：平时每次
llm/stream见到 usage 只加一笔（同一调用多个 usage 时只记最后一个一次）。 - 回溯补齐：会话首次记账时，可从
${DSH_HOME}/sessions/<slugified-cwd>/<sessionId>/*.jsonl.zstd按帧解压，按各条消息时间与 usage 补历史；明细会标注「含回溯 N 次」。 - 价目指纹变化：仅在定价指纹变更时对历史 token 精确重算一次，且只认贵不认便宜，避免已展示金额缩水。
界面¶
插件注册在 conversation.composer.dock，排在原生 session-stats 之后（order: 10）。样式对齐 @deepseek-ai/dsh-client-ui-chat 的 StatsPills 与官方 stat 面板 CSS，避免与原生读数行视觉脱节。
安装与启用¶
插件是 profile bundle，会出现在「设置 → 插件」中，可启用、停用、卸载。要求 DSH ≥ 0.2.0-rc.2（README 写明已在 0.2.0-rc.2 Windows 桌面端验证），Node ≥ 22.19.0。装完后需重启 DSH（非纯运行时热加载整包）。
dsh plugin --profile <你的 profile> add dsh-cost-meter
dsh plugin --profile <你的 profile> add <git-url-or-path> # 或从仓库/本地目录
卸载：
dsh plugin --profile <你的 profile> remove dsh-cost-meter
开发时从本地目录链接安装（改 client.js 可 HMR；改宿主 dsh-cost-meter.mjs 需重启 DSH）：
dsh plugin --profile desktop add link:/path/to/dsh-cost-meter
engines.dsh 仅为声明，装在不兼容的 DSH 上可能无安装期告警，表现为运行时报错，安装前请核对版本。
典型用法¶
- 按上文命令安装并重启 DSH。
- 在官方 DeepSeek 通道下正常对话；底部读数行末尾会出现类似：
1 轮 · 3 步 · 12 tok/s 48.2K tok · 缓存命中 93% 已用人民币 0.42 26%
- 点击「已用人民币 …」一格，查看明细（本会话花费、缓存命中、未缓存输入、缓存读取、输出、单价、计费调用次数与回溯次数、当前峰谷档与切换倒计时、价目版本、模型等）。
- 若需追加法定节假日或自定义官方网关，可选创建
${DSH_HOME}/dsh-cost/cost-config.json：
{
"holidays": ["2027-01-01", "2027-02-06"],
"providers": ["my-official-gateway"],
"currency": "CNY",
"showPeakBadge": true
}
README 还提到只读 HTTP 接口 GET /dsh-cost/api（文档在仓库内，按需查阅）。
适用场景与注意¶
适合：日常在 DSH 官方账号或官方 API Key 路由上开发、调试，需要会话内实时对照 DeepSeek 峰谷价与缓存结构的用户。
不适合或需注意：
- 主要走第三方中转时，插件故意不显示花费，读数行与未装时一致。
- 插件以当前 DSH 进程权限运行，会读取会话日志与写入账本；安装前应查看源码与 MIT 许可证，确认符合你的环境策略。
- 2026 年节假日在插件内为按规律预排，非国务院原文；误判某天为高峰只会影响当天几次调用的计价档位，可在
holidays中修正。 - 社区目录 SkillHub 插件页 与 GitHub 为社区分发渠道，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文事实以仓库 README 与 package 声明为准。
结尾¶
dsh-cost-meter 补的是 DSH 原生读数行缺失的一维：官方通道、按峰谷与三类 token 口径的会话人民币花费，并支持回溯与价目版本分段。需要进一步了解实现细节、测试（README 称 108 项离线断言）或变更记录，请直接阅读仓库文档。
