前言¶
在 DeepSeek Harness 里跑对话和子代理时，token 会随每次模型调用累加，但界面默认不会把「今天花了多少」「当前会话花了多少」摆在眼前。要对照官方价目自己心算，或等平台账单，既慢也不利于调 prompt 和控成本。
下面介绍社区插件 dsh-api-cost-meter（维护者 mzqmzqmzqmzq）：在输入框下方加一行常驻读数，按会话日志里的 usage 推算人民币费用，并通过 SSE 在每次调用结束后推送更新。插件归类为 admin-security，源码与说明见 GitHub，社区目录页：https://www.skillhub.cn/plugins/mzqmzqmzqmzq/dsh-api-cost-meter。
这是什么¶
dsh-api-cost-meter 是面向 DSH Web 界面（dsh web）的只读计量插件：展示今日（本机时区当天 00:00 起、含子代理会话的合计）与本窗口（当前会话从第一条消息起的合计，切换会话即切换）两档 API 调用费用。金额由 Host 根据 assistant/message 上的 token 用量与内置价目结算，不向外网发送对话内容。
界面与交互¶
安装成功后，输入框下方会出现类似读数：
今日 ¥0.5488 · 本窗口 ¥0.1372
点击读数会在其上方弹出明细面板（position: fixed，不改变对话区布局），列出分模型的费用、调用次数，以及输入 / 缓存命中 / 输出 token。点面板外、按 Esc 或再次点击读数可关闭。
模型调用进行中（llm/stream 在途）时，读数左侧会有呼吸小圆点表示「正在生成」——此时金额尚未计入，需等该次调用返回 usage 后才结算。金额变化以约 420ms 缓动滚动，避免硬跳。
实时更新机制¶
Host 在每次模型调用结束时通过 SSE 推送一帧，前端路径为 /plugin/cost-meter/stream，不做高频轮询。SSE 不可用时自动退回 1.5 秒轮询；单次快照可用 GET /plugin/cost-meter/state?sessionId=<SessionId>。
费用如何计算¶
每次模型调用在会话日志中留下 assistant/message，其 usage 含 inputTokens、cacheReadTokens、cacheWriteTokens、outputTokens。插件按 README 记载的官方价目（人民币 / 百万 tokens）逐条累加：
| 模型 | 缓存命中输入 | 缓存未命中输入 | 输出 |
|---|---|---|---|
deepseek-flash |
空闲 0.02 / 高峰 0.04 | 空闲 1 / 高峰 2 | 空闲 4 / 高峰 8 |
deepseek-v4-pro |
空闲 0.15 / 高峰 0.30 | 空闲 4.5 / 高峰 9 | 空闲 13.5 / 高峰 27 |
高峰时段为北京时间周一至周五 09:00–12:00、14:00–18:00；其余为空闲时段（价格为高峰的一半）。法定节假日未内置日历，按高峰计价。deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-chat、deepseek-reasoner 按 deepseek-flash 计价。价目来源见 DeepSeek 官方定价文档（README 标注 2026-11 抓取）；调价后需更新 index.js 顶部 PRICES。
未收录的模型仍统计 token 与调用次数，费用记 0，读数旁会以「未配置价格」提示模型名。
数据从哪来¶
- 实时：Host 订阅
session/event，仅对assistant/message做 O(1) 累加。 - 历史：加载时通过
sessionPersistence从磁盘日志回填当天用量（最多最近 200 个会话，自日志尾部回读）；重启不会清零当天已计费用。session/created时也会补读旧会话。
实时与回填用各自 seq 下界去重，避免重复计费。
安装与启用¶
要求 DSH Web 界面；插件无第三方运行时依赖。安装命令如下：
dsh plugin add dsh-api-cost-meter
或在 Harness Web UI 的 设置 → 插件 → 添加 中粘贴包名 dsh-api-cost-meter。装好后输入框下方应出现读数；若没有，刷新页面一次。
隐私与 Host 路由¶
插件只读本地会话日志。Host 仅注册两条只读本机路由，均只接受 GET；sec-fetch-site 非 same-origin 时返回 403。响应仅含费用与 token 统计，不含对话正文。
适用场景与注意¶
适合长期在本地或内网用 DSH 开发智能体、需要即时感知 token 成本、又不想把会话内容发到第三方的开发者。
务必知晓：
- 插件以当前 dsh 进程权限运行；安装前请自行查看源码与 MIT 许可证。
- 金额是按 token 用量推算的费用，不等于 DeepSeek 平台账单；实际扣费以平台账单为准。
- 仅覆盖
deepseek-flash与deepseek-v4-pro两档官方价目；其他模型显示 token 但不计价。
DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤，你可以在对话输入框旁持续看到今日与本窗口的 API 费用，并在需要时展开分模型明细。进一步细节见 GitHub README 与 SkillHub 目录页。
