前言¶
在 DeepSeek Harness（DSH）里跑多轮对话时，API 会返回 token usage，但界面默认不会把「这一轮大概花了多少钱」和「整段会话累计多少」摆在显眼位置。自己对照官方价目表、峰谷时段和缓存命中去心算，既慢也容易和账户实际扣款混在一起。
DeepSeek Cost Meter（npm 包名 deepseek-cost-meter）是社区维护的 DSH 插件，在每轮回复下方和输入框底栏展示基于已记录 usage 与配置价格的估算，不额外发起模型请求，也不读取账户余额。下面介绍它的定位、能力与安装配置方式。
这是什么¶
- 定位：Per-turn model cost estimates for DeepSeek Harness · 每轮对话费用统计插件。
- 维护者：luomuwen；源码与说明见 GitHub，目录页见 SkillHub。
- 许可证：MIT；独立社区插件，与 DeepSeek 官方无隶属关系。
- 当前 npm 版本：0.3.0（以 package.json 为准）。
插件沿用 dsh 的模型配置，不负责接入或切换模型；不需要 API Key。
核心功能¶
每轮费用条¶
在每轮回复下方显示类似 本轮模型费用约 CNY 0.012300 · 1 次调用 的摘要。点击可展开模型、token、单价、峰谷时段及截至该轮结束时的累计费用。正常完成、错误和中断的轮次都会处理。
底栏会话费用（0.3.0）¶
输入框下方展示当前会话累计费用估算（或「已知费用约 …」「套餐用量」等状态）。点击打开弹窗，查看本会话累计、最近完成一轮，以及按渠道/模型汇总的金额、调用次数与已记录 token。与 Harness 原生「会话统计」并列，不替换原有控件。生成过程中提示「本轮进行中，尚未计入」，避免把未完成请求当成实时账单。
多渠道与套餐¶
| dsh 渠道 | 行为概要 |
|---|---|
| DeepSeek 官方 / 账号 | 保留峰谷价格估算 |
Kimi 国内 API moonshotai-cn |
内置 6 个模型价格；K3 缓存写入价格不确定时显示已知部分 |
MiniMax 国内 minimax-cn |
内置 MiniMax-M3.1-Flash；其余模型显示用量，可配置价格 |
| 千问 Token Plan、Kimi Coding、智谱 Coding | 展示套餐用量，不估算逐次扣费 |
| 海外 API、转售、自定义兼容接口 | 展示已记录用量；按 provider/model 配置价格后可估算 |
其他模型只要 dsh 保存了 usage，也能展示 token，并可单独补充价格。没有匹配价格不会显示为免费。完整标识与价格来源见仓库内 多渠道使用说明。
计费口径（阅读数字前建议先看）¶
- 一轮对应
turn/start到turn/end，含会话内各步骤与已记录的重试。 - 使用 API 持久化 usage，不用字符数估 token；输入、缓存读、缓存写、输出分桶，推理 token 含在输出中不重复计。
- 不含子 Agent 独立会话、标题生成、Search/Fetch、其他工具费用及账户优惠；与账户账单不一致时属预期——插件只做 usage × 配置价的估算。
- 金额用定点计算；多币种分别显示，不自动换汇。
DeepSeek 默认人民币价表内置在插件中（核验日期 2026-10-29，来源为官方 API 定价页）；峰值为北京时间工作日 09:00–12:00、14:00–18:00。内置表只回算 2026-10-29 00:00（北京时间）及以后的记录。
安装与启用¶
需要已安装的 DeepSeek Harness。0.3.0 已在 macOS 桌面版 DeepSeek Harness 0.2.1-rc.5 真实运行时验证；其他版本需自行复验。
桌面版推荐通过 npm 包名安装：
dsh plugin --profile desktop add deepseek-cost-meter
macOS 若提示 dsh: command not found，可使用完整路径：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add deepseek-cost-meter
Web 版将 --profile desktop 改为 --profile web。安装后重启对应 Harness 应用或 Web 服务，完成一轮对话即可在回复下方看到费用。
更新到最新 npm 版：
dsh plugin --profile desktop add deepseek-cost-meter@latest
从旧包名 @local/deepseek-cost-meter 升级时，先保存自定义 config.rates，移除旧包再安装新包，不要同时启用两者：
dsh plugin --profile desktop remove @local/deepseek-cost-meter
dsh plugin --profile desktop add deepseek-cost-meter
市场展示名为 DeepSeek Cost Meter（每轮费用）；若市场信息滞后，可直接使用上述 npm 命令。
典型用法：界面与自定义价格¶
日常使用¶
- 安装并重启 Harness。
- 正常对话；每轮结束后在回复下方查看本轮估算，必要时展开明细。
- 在输入框底栏查看会话累计，点击弹窗按渠道/模型核对调用次数与 token。
补充非内置渠道价格¶
在个人配置中为插件条目添加 config.additionalRates，只覆盖需要的 provider/model，避免改安装包内文件（升级会被覆盖）。修改后重启 Harness。格式示例（数字需换成实际价）：
- id: local-deepseek-cost-meter
config:
additionalRates:
- provider: my-provider
models: [my-model]
currency: CNY
source: '填写实际价格来源'
effectiveFrom: '2026-11-01T00:00:00+08:00'
offPeak:
input: '1'
cacheRead: '0.02'
cacheWrite: null
output: '4'
provider / models 必须与 dsh 实际记录的标识一致。未知单价填 null；每条补充价格需 effectiveFrom。config.providerModes 可将渠道设为 metered、subscription 或 usage-only，详见 docs/providers.md。
适用场景与注意¶
适合：在 DSH 桌面版或 Web 版中长期调试 Agent、对比模型与渠道用量，希望在对话界面直接看到按轮与会话级费用估算的开发者。
注意：
- 插件以当前 dsh 进程权限运行；安装前建议浏览源码与 MIT 许可证，确认符合你的环境策略。
- 显示「不完整」或无金额时，检查该轮是否有 usage、价格是否配置、记录时间是否在价格与日历覆盖范围内；缺失数据不会按零费用处理。
- 价格配置变更会写入 Harness 存储域
local_turn_cost_prices的快照；卸载不删快照，且插件不是财务账本，丢失存储域后只能按剩余价格表回算。 - 卸载可在插件页关闭，或执行
dsh plugin --profile desktop remove对应条目（具体以 Harness 插件管理为准）。
结尾¶
DeepSeek Cost Meter 把 dsh 已记录的 usage 转成可读的每轮与会话费用投影，并支持 DeepSeek 峰谷价与多渠道扩展配置，适合需要「边聊边看估算成本」的场景。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库。
