轮次费用计量 luomuwen/deepseek-cost-meter

DeepSeek Harness 费用计量插件

English · 简体中文

npm 安装包 · dsh market · 版本发布 · 问题反馈

独立社区插件，采用 MIT 许可证；与 DeepSeek 官方无隶属关系。

在每轮回复下方显示 本轮模型费用约 CNY 0.012300 · 1 次调用。点击展开模型、token、单价、峰谷时段及累计费用。支持正常完成、错误和中断轮次。

0.3.0 新增底栏费用入口： 输入框下方直接展示当前会话的累计费用估算。点击后查看最近完成一轮、各渠道/模型费用、调用次数与已记录 token。与原生会话统计并列显示，不替换原有控件。

0.2.0 新增多渠道支持： DeepSeek、Kimi 国内 API、部分 MiniMax 模型可估算金额；千问 Token Plan、Kimi Coding、智谱 Coding 等套餐显示用量。其他模型只要 dsh 保存了 usage，也能展示已记录 token，并可单独补充价格。插件沿用 dsh 的模型配置，不负责接入或切换模型。

兼容性：0.3.0 已在 macOS 桌面版 DeepSeek Harness 0.2.1-rc.5 的真实运行时中验证。使用 sessionProjections、storageDomain、conversation.chat.turnTail、conversation.composer.dock 和 useProjection；其他版本需要重新验证。

| dsh 渠道 | 0.2.0 行为 |
| DeepSeek 官方 / 账号 | 保留原有峰谷价格估算 |
| Kimi 国内 API moonshotai-cn | 内置 6 个模型价格；K3 系列缓存写入价格不确定时显示已知部分 |
| MiniMax 国内 minimax-cn | 内置 MiniMax-M3.1-Flash；其余模型显示用量，等待配置价格 |
| 千问 Token Plan、Kimi Coding、智谱 Coding | 展示套餐用量，不估算逐次扣费 |
| 海外 API、转售平台、自定义兼容接口 | 展示已记录用量，按精确 provider/model 配置价格后估算金额 |

完整模型、渠道标识与价格来源见 多渠道使用说明。没有匹配价格不会显示为免费。

安装

需要已安装的 DeepSeek Harness；已验证版本见上文。插件不需要 API Key，不会发起额外模型请求。

推荐通过 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 版使用 dsh plugin --profile web add deepseek-cost-meter。安装后重启对应的 Harness 应用或 Web 服务，完成一轮对话后即可在回复下方查看费用。

市场展示名为 DeepSeek Cost Meter（每轮费用），npm 包名为 deepseek-cost-meter。市场的 npm 信息由其定时任务自动同步；若市场仍展示旧版安装包，可直接使用上面的 npm 命令。

更新 npm 版

dsh plugin --profile desktop add deepseek-cost-meter@latest

更新后重启 Harness。Web 用户改用 --profile web；查看本机安装版本可运行 dsh plugin --profile desktop list --depth 0。

从 0.1.0 升级

旧包名是 @local/deepseek-cost-meter。请先保存自行配置的 config.rates，移除旧包再安装新包，不要同时启用两者：

dsh plugin --profile desktop remove @local/deepseek-cost-meter
dsh plugin --profile desktop add deepseek-cost-meter

安装后重新应用自定义价格并重启 Harness。存储域和投影标识保持不变，可继续使用原有价格快照。

源码或安装包

需要已安装的 DeepSeek Harness。源码安装和开发需要 Node.js 22 或更新版本、npm 和 Git；已验证的 Harness 版本见上文。

git clone https://github.com/luomuwen/deepseek-cost-meter.gitsh
cd deepseek-cost-meter
npm ci --ignore-scripts
bash scripts/install-local.sh

安装脚本优先使用 macOS 桌面版自带 CLI；其他环境使用 PATH 中的 dsh，默认安装到 web profile。可以用 bash scripts/install-local.sh desktop 指定 profile。这是本地链接安装，请保留源码目录。若界面未立即更新，退出并重新打开 Harness。

手动安装： sh
dsh plugin --profile desktop add "$PWD"

Web profile:

dsh plugin --profile web add "$PWD"

macOS 桌面版若没有全局 dsh，使用 /Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh 替代命令。插件不需要 API Key，不会发起额外模型请求。

也可以从 Releases 下载 .tgz 安装包： sh
dsh plugin --profile desktop add /absolute/path/deepseek-cost-meter-0.3.0.tgz

运行 npm pack 可自行打包。运行依赖 zod 随包分发；React 由 Harness 提供。npm 包名为 deepseek-cost-meter，公开发布到 npm registry；市场展示名保持“DeepSeek Cost Meter（每轮费用）”。

底栏会话费用

- 输入框下方新增“费用约 CNY …”；存在未计价或套餐调用时显示“已知费用约 …”，全套餐会话显示“套餐用量”。
- 点击打开费用弹窗，查看本会话累计、最近完成一轮，以及按渠道/模型汇总的金额、调用次数和已记录 token。
- 与每轮费用复用同一份投影结果；每轮结束后更新。生成过程中提示“本轮进行中，尚未计入”，不会把未完成请求显示成实时账单。
- 多币种分别列出；分叉继承历史不重复计入。底栏金额显示四位小数，详情保留六位，小额不会因四舍五入显示成免费。
- 按 Esc、点击关闭按钮或点击外部关闭；切换会话自动关闭旧弹窗。支持深浅主题和窄窗口。
- 原生“会话统计”弹窗与每轮费用栏继续保留。插件不读取账户余额，也不增加模型请求。

计费口径

- 一轮为 turn/start 到 turn/end，包括本会话内各步骤和已记录的重试尝试。
- 读取 API 返回的持久化 usage，不使用字符数估算 token。不把多个累计 usage 样本相加。
- 输入、缓存读取、缓存写入、输出是互斥桶；推理 token 已包含在输出中，不重复收费。
- 缓存写入价格按渠道单独配置。未知价格保留为空；例如 Kimi K3 的缓存写入按 TTL 分档，而 dsh 的统一 usage 没有保留该拆分。
- 缺少 usage、模型价格或缓存拆分时显示不完整；已知金额为部分合计，不代表最终账单。
- 不含子 Agent 独立会话、标题生成、Search/Fetch、其他工具费用及账户优惠。
- 金额用 BigInt 定点计算，持久状态用十进制字符串，显示六位小数。
- 分叉继承记录可显示，累计新增费用不重复包含继承历史。
- 每轮展示的累计值固定为截至该轮结束时的值。多币种分别显示，不自动换汇。

DeepSeek 默认价格

核验日期：2026-10-29；来源：DeepSeek 官方人民币定价。币种 CNY，单位元 / 百万 token。

| 模型 | 时段 | 未缓存输入 | 缓存命中 | 输出 |
| deepseek-flash | 空闲 | 1 | 0.02 | 4 |
| deepseek-flash | 高峰 | 2 | 0.04 | 8 |
| deepseek-v4-pro | 空闲 | 4.5 | 0.15 | 13.5 |
| deepseek-v4-pro | 高峰 | 9 | 0.30 | 27 |

峰值窗口为北京时间周一至周五 09:00–12:00、14:00–18:00，周末和配置中的节假日除外。按 step/start / llm/retry-started 时间近似请求开始时间；跨边界请求仍属于估算。

内置表只回算 2026-10-29 00:00（北京时间）及以后的记录。该日期前不猜测历史价。内置节假日日历覆盖到 2026-12-31，此覆盖区间内无中国法定节假日；进入 2027 年后会提示更新日历，避免套用未经核验的时段规则。

deepseek-v4-flash、deepseek-v4-flash-vision-exp 按官方别名规则使用 Flash 价格。支持 Harness 官方路由 deepseek-official、登录账号路由 deepseek-account，以及 deepseek；前两者没有显式价格行时使用 deepseek 价格。账号路由也仅按公开 API 价格估算，不读取账户实际扣款。其他 provider 不自动套用官方价格，即使模型名称相同。

修改价格

推荐在个人配置中对应插件行添加 config.additionalRates，只补充或覆盖指定的 provider/model，保留其他内置价格。避免直接修改已安装包的文件后被升级覆盖。修改后重启 Harness。以下数字仅为格式示例，应替换成实际服务商价格： yaml
- 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 实际记录的标识完全一致；模型名相同不代表价格相同。不提供 peak 则全天使用 offPeak。价格以字符串填写，最多六位小数；未知单价填 null，只有明确免费才填 '0'。每条补充价格必须有 effectiveFrom，可用 source 标明来源。

config.providerModes 可将指定渠道设为 metered（按量）、subscription（套餐）或 usage-only（只统计用量）。套餐渠道即使有价格行，也不会计算金额，除非显式改为 metered。配置示例见 多渠道使用说明。

旧版 config.rates 完整替换方式继续兼容；使用它时需自行保留所需模型、套餐模式与峰谷日历。源码开发也可修改 rates.json。高峰日历需提供实际节假日，不应随意延长覆盖期。

每次价格配置变化会向 Harness 存储域 local_turn_cost_prices 追加不可变快照。首次快照从 effectiveFrom 回算；后续快照从加载新配置的时间生效。已保存的旧快照继续用于旧调用；卸载不会删除快照。更新算法或价格目录时投影缓存自动重建。丢失该存储域后只能按剩余价格表回算，因此此插件不是财务账本。

因此，从旧版升级后，新渠道价格和套餐模式从加载新版起应用；升级前的记录继续使用当时保存的规则。新增模型还受各自价格行的生效时间限制。

下载统计

- npm 包页面可查看版本和下载量；顶部徽章展示最近一个月的 npm 下载量。
- 最近一周下载量 JSON和最近一个月下载量 JSON可用于自己的统计工具。
- GitHub Releases安装包下载与 npm 下载分别统计。npm 下载次数不等于独立用户数或活跃安装数，CI、重复安装和缓存都会影响统计。

插件本身不上传使用遥测。新发布包的下载统计和市场展示可能延迟更新；统计 API 暂时返回 404 或徽章暂无数据，不代表安装包未发布。

常见问题

- 安装后没有费用栏： 确认安装到了正在使用的 desktop 或 web 配置档，重启 Harness 后完成一轮对话，并确认未同时启用旧版 @local/deepseek-cost-meter。
- 显示「不完整」或没有金额： 检查该轮是否有 usage、provider/model 是否有对应价格，以及记录时间是否在价格和日历覆盖范围内。缺失数据不会按零费用处理。
- 与账户扣费不同： 本插件按已记录 usage 和配置价格估算模型费用，不读取账户账单；优惠、其他工具费用及独立子会话等不在该金额中。

开发与验证 sh
npm ci
npm run build
npm run check
ELECTRON_RUN_AS_NODE=1 '/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness' \
--expose-internals scripts/runtime-smoke.cjs

- src/pricing.js：价格校验、峰谷规则、定点计算。
- src/projection.js：增量处理调用尝试、轮次汇总和分叉边界。
- index.js：价格快照与 Host 投影注册。
- src/client-factory.js：原生插槽组件；client.js 是生成产物。
- locale/：中英文文案；icon.svg：原创图标。

统计状态只保存每轮聚合明细，不复制提示词、回答、工具结果或 API Key。空间随轮数和不同模型/价格组合数增长。客户端通过投影读取结果，不扫描聊天 DOM，不修改对话内容。插件不增加模型 token，也不改变 KV Cache。

卸载

可在 Harness 插件页关闭或移除「每轮费用」。也可运行： sh
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop remove deepseek-cost-meter

若当前进程未自动卸载，请重启应用。会话日志不会被插件改写。

参与贡献与许可

欢迎提交 Issue 和 Pull Request。请先阅读 贡献指南、安全政策 和 更新记录。详细架构见 架构说明，手动集成验证记录见 VERIFICATION.md。

采用 MIT License。DeepSeek Harness 是 deepseek-ai/deepseek-harness 项目；相关名称与商标归各自所有者所有。