DeepSeek Harness Cost Meter
English · 简体中文
独立社区插件，采用 MIT 许可证；与 DeepSeek 官方无隶属关系。
在每轮回复下方显示 本轮模型费用约 CNY 0.012300 · 1 次调用。点击展开模型、token、单价、峰谷时段及累计费用。支持正常完成、错误和中断轮次。
兼容性：已在 macOS 桌面版 DeepSeek Harness 0.2.1-rc.3 验证。使用 sessionProjections、storageDomain、conversation.chat.turnTail 和 useProjection；其他版本需要重新验证。
安装
需要已安装的 DeepSeek Harness。源码安装和开发需要 Node.js 22 或更新版本、npm 和 Git；已验证的 Harness 版本见上文。
git clone https://github.com/luomuwen/deepseek-cost-meter.git
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。
手动安装：
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 安装包：
dsh plugin --profile desktop add /absolute/path/local-deepseek-cost-meter-0.1.0.tgz
运行 npm pack 可自行打包。运行依赖 zod 随包分发；React 由 Harness 提供。npm 包名保留为 @local/deepseek-cost-meter 以兼容现有安装；本项目不发布到 npm registry。
计费口径
- 一轮为
turn/start 到 turn/end，包括本会话内各步骤和已记录的重试尝试。
- 读取 API 返回的持久化 usage，不使用字符数估算 token。不把多个累计 usage 样本相加。
- 输入、缓存读取、缓存写入、输出是互斥桶；推理 token 已包含在输出中，不重复收费。
- 默认缓存写入按未缓存输入价计算；若服务商采用其他规则，请显式配置。
- 缺少 usage、模型价格或缓存拆分时显示不完整；已知金额为部分合计，不代表最终账单。
- 不含子 Agent 独立会话、标题生成、Search/Fetch、其他工具费用及账户优惠。
- 金额用 BigInt 定点计算，持久状态用十进制字符串，显示六位小数。
- 分叉继承记录可显示，累计新增费用不重复包含继承历史。
- 每轮展示的累计值固定为截至该轮结束时的值。多币种分别显示，不自动换汇。
默认价格
核验日期：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 不自动套用官方价格，即使模型名称相同。
修改价格
首次安装可修改 rates.json。运行后修改该文件并重启，或通过个人配置中对应插件行的 config.rates 指定完整同结构价格表。示意：
- id: local-deepseek-cost-meter
config:
rates:
version: my-provider-2026-11-01
source: manual
effectiveFrom: '2026-11-01T00:00:00+08:00'
calendarThrough: '2027-12-31'
holidays: []
prices:
- provider: my-provider
models: [my-model]
currency: CNY
offPeak:
input: '1'
cacheRead: '0.02'
cacheWrite: '1'
output: '4'
不提供 peak 则全天使用 offPeak。价格以字符串填写，最多六位小数。配置是完整替换，需保留仍要使用的其他模型行；高峰日历需提供实际节假日，不应随意延长覆盖期。
每次价格配置变化会向 Harness 存储域 local_turn_cost_prices 追加不可变快照。首次快照从 effectiveFrom 回算；后续快照从加载新配置的时间生效。已保存的旧快照继续用于旧调用；卸载不会删除快照。更新算法或价格目录时投影缓存自动重建。丢失该存储域后只能按剩余价格表回算，因此此插件不是财务账本。
开发与验证
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 插件页关闭或移除“每轮费用”。也可运行：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop remove @local/deepseek-cost-meter
若当前进程未自动卸载，请重启应用。会话日志不会被插件改写。
参与贡献与许可
欢迎提交 Issue 和 Pull Request。请先阅读 贡献指南、安全政策 和 更新记录。详细架构见 架构说明，手动集成验证记录见 VERIFICATION.md。
采用 MIT License。DeepSeek Harness 是 deepseek-ai/deepseek-harness 项目；相关名称与商标归各自所有者所有。
