DeepSeek Harness dsh-cost-meter 技术深度解析：AI 会话费用实时统计与峰谷计价的架构实现
插件简介
dsh-cost-meter 是 DeepSeek Harness 生态中的会话费用统计插件，由 Han-1413141 开发维护。GitHub 仓库地址：https://github.com/Han-1413141/dsh-cost-meter，当前星标 298，综合评分 65.9，最近更新时间 2026-09-15，周下载量 18,196。
该插件的核心定位是「DeepSeek Harness 会话费用统计插件，界面中英双语」。它通过拦截宿主 llm/stream 上报的 usage 块，实现逐次调用的精确计费，支持会话级、日级、月级、累计级四个维度的费用统计，内置 90+ 模型价格目录，并完整实现了 DeepSeek 官方 2026 年 8 月起执行的峰谷两档计价方案。
技术架构与核心原理
计费数据采集层
dsh-cost-meter 的计费数据来源于宿主 DeepSeek Harness 通过 llm/stream 接口上报的 usage 块。每个 usage 块包含输入 token、缓存命中 token、缓存写 token、输出 token 等细分维度。插件在宿主启动时注册 usage 监听器，每次流式调用完成后即时捕获 usage 数据并写入本地账本。
关键设计点在于：子代理、压缩、标题生成等辅助调用的 usage 同样被纳入统计，因为这些调用也通过宿主 llm/stream 上报。但如果其他插件（如记忆插件）直接请求外部 API 而未向宿主上报 usage，则这部分消耗无法被统计——这是当前架构的已知边界。
计费引擎层
计费引擎实现了完整的 DeepSeek 官方定价规则：
- 价格单位：美元 / 1M tokens，与官方文档一致
- 成本公式：未命中输入 × cache-miss + 输出 × output + (缓存读 + 缓存写) × cache-hit
- 峰谷两档计价：峰时段（UTC 01:00–04:00、06:00–10:00）按峰时价，其余按谷时价（谷时价 = 峰时价的一半）
- 周末全谷价：2026-08-23 起，周六周日（北京时间）全天按谷价计费
- 历史分界：2026-08-16 16:00 UTC 之前的调用按基础价计费，之后按峰谷两档
峰谷档位按请求发起时刻判定，而非完成时刻。这是因为流式调用可能跨峰谷边界整点，以完成时刻归档会把数分钟前发起的请求算进另一个峰位，导致计费不准确。
账本存储层
账本金额恒以美元存储，币种和汇率仅影响显示（默认 1 USD = 7.2 CNY，可自定义）。配置即时自动保存，支持官方价格同步（抓取解析官方定价页，一键应用）和清除历史数据。
历史重算（会话投影回放 / 按模型回填）一律按 2026-08-16 16:00 UTC 分界判档，确保峰时历史事件不会被按谷价半价重算。此前被污染的存量账本在升级时自动钳制修复（幂等迁移）。
功能机制详解
实时费用显示
插件在多个位置显示费用信息：
- 输入区下方或会话标题栏（可切换）：本会话费用 + token 明细
- 侧边栏底部：「今日 ¥x」，悬停见调用次数与 token 明细
- 设置页汇总卡片：今日 / 本月 / 累计费用与调用次数
- 今日会话明细：每个会话的调用次数、输入/缓存/输出 token 与费用
预算管理
预算图框显示预算、已用百分比、进度条、今日费用与占预算百分比、已用/额度。达到 80% 时预警，达到 100% 时标记超支。支持自定义日期区间（今日/本月/累计/自定义）。
Token 用量热图
类 Codex 的 26 周每日用量方格热图，横向铺满设置页宽度，悬停可见当日明细。无用量日显示为半透明玻璃格。同时统计历史累计 token 总量（输入/缓存/输出/调用）。
峰谷计价提醒
距进入峰/谷时段不足设定提前量（默认 2 分钟，1-30 可配）时，全屏色条徽标弹窗提醒。弹窗位置可选右下角或屏幕中心，提醒类型可选（进入峰/进入谷/峰和谷），同一切换点只提醒一次。可选同步发送浏览器系统通知（页面最小化也能收到，需授权通知权限）。
OpenCode Go 额度与余额查询
支持 OpenCode Go 额度三档（5小时/周/月）进度条显示，以及官方余额查询（总余额/赠送/充值）。还支持自定义 Provider 余额（编辑 URL / Headers / extract 配置）。
安装与配置
dsh-cost-meter 已发布到 npm registry，安装简单：
# 安装 DSH CLI 引擎（如未安装）
npm install -g @deepseek-ai/dsh
# 一键安装 dsh-cost-meter
dsh plugin --profile web add dsh-cost-meter
# 安装后重启 dsh web
dsh web
也可通过 PowerShell 一键脚本安装（固定到 v1.7.22）：
irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.7.22/install.ps1 | iex
安装后无需额外配置，在 DSH Web UI 的侧边栏和设置页即可看到费用统计面板。可在设置 → 费用中配置预算、峰谷提醒、显示方式等。
兼容性与避坑指南
Node 版本要求
package.json 声明 Node >=20，低于 20 的环境无法安装。执行 node -v 确认版本。
pnpm 最小发布年龄限制（最大坑）
安装时可能遇到 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION 错误。原因是环境启用了「最小发布年龄」供应链保护，lockfile 中发布时间距今小于阈值的包被拒绝。
解决方案：
1. 升级到最新版插件（v1.7.22 已将独立运行依赖 zod 保持精确锁版，@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-home-paths 改由宿主通过 peer dependency 提供）
2. 若仍出现，可在 profile 的 pnpm-workspace.yaml 中加入单项排除：
minimumReleaseAgeExclude:
- '@'
安装后必须重启
插件行、Typert 清单与客户端 bundle 均在启动时扫描，安装后必须执行 dsh web 重启才能生效。
计费覆盖范围有限
仅统计通过宿主 llm/stream 上报 usage 的调用。其他插件直接请求外部 API 未上报 usage 的部分无法统计。子会话按自己的 sessionId 记录，不并入父会话徽章。
宿主版本兼容
宿主适配验证覆盖 DSH 0.1.2-rc.1、0.1.3-alpha.2、0.1.5-alpha.1 的安装、启动、模块复用和卸载。0.1.3-alpha.1 暂标记为未知。
适合人群
适合：重度使用 DeepSeek API 的开发者和研究人员；需要精确控制 AI 预算的团队和个人；关注峰谷计价以降低成本的用户；使用 OpenCode Go 额度的用户；需要 Token 用量可视化的用户。
不适合：仅偶尔使用 AI 对话且不关心费用的普通用户；Node 版本无法升级到 20+ 的环境；其他插件大量直接请求外部 API 导致计费不完整的场景。
总结
dsh-cost-meter 是 DeepSeek Harness 生态中功能最完整的费用统计插件，实现了逐次调用精确计费、峰谷两档计价、预算管理、Token 热图、OpenCode Go 额度查询等核心能力。其技术架构设计严谨，特别是峰谷档位按请求发起时刻判定、历史分界幂等迁移等细节体现了对计费准确性的深度思考。对于重度 DeepSeek 用户来说，这是一个不可或缺的成本管理工具。
---
dsh-cost-meter 应用实践：AI 费用可视化与预算管控的 5 个核心场景
插件简介
dsh-cost-meter 是 DeepSeek Harness 的会话费用统计插件，298 星，周下载量 18,196，支持会话/日/月/累计四维费用统计、峰谷计价、预算预警、Token 用量热图和 OpenCode Go 额度查询。安装命令：dsh plugin --profile web add dsh-cost-meter。
核心应用场景
场景一：实时监控单次会话费用
在进行复杂的多轮对话或代码生成任务时，用户往往不知道这一次会话到底花了多少钱。dsh-cost-meter 在输入区下方或会话标题栏实时显示本会话费用，格式为「本会话 ¥5.5939 · 输入 321K · 缓存 119M · 输出 235K」。
实践技巧：在进行大型代码重构或长文档生成前，先看一眼当前会话费用，设置心理预算上限。如果费用增长过快，可以考虑切换到更便宜的模型，或者拆分任务分批执行。
场景二：峰谷计价优化，降低 API 成本
DeepSeek 官方自 2026 年 8 月起执行峰谷两档计价，谷时价仅为峰时价的一半。峰时段为 UTC 01:00–04:00、06:00–10:00（北京时间 09:00–12:00、14:00–18:00），其余时间为谷时。周末（北京时间周六周日）全天按谷价计费。
dsh-cost-meter 的峰谷时段条实时显示当前档位（峰时/谷时）和距下次切换的倒计时。在设置页可配置峰谷切换弹窗提醒（默认提前 2 分钟，1-30 分钟可配），可选同步发送浏览器系统通知。
实践技巧：
- 将非紧急的大批量任务（如批量文档处理、代码库分析）安排在谷时段或周末执行，可节省 50% 费用
- 配置峰谷切换提醒，在即将进入峰时段时保存进度，避免任务跨峰谷边界导致费用翻倍
- 利用周末全谷价窗口执行大型实验或批量推理任务
场景三：预算管控与超支预警
对于需要严格控制 AI 费用的团队或个人，dsh-cost-meter 的预算管理功能非常实用。在设置页顶部可设置预算额度和周期（今日/本月/累计/自定义日期区间），侧边栏底部的预算图框实时显示已用百分比、进度条和今日费用占比。
当预算使用达到 80% 时触发预警，达到 100% 时标记超支。图框在窄栏（rail）模式下收窄为百分比方块，不占用过多侧边栏空间。
实践技巧：
- 按月设置预算，将月度 API 费用控制在预期范围内
- 对于团队共享的 API Key，按周设置预算，避免某个人过度使用导致整月超支
- 结合今日费用显示，每天检查费用进度，及时调整使用策略
场景四：Token 用量分析与模型选型
dsh-cost-meter 的 Token 用量统计功能提供历史累计 token 总量（输入/缓存/输出/调用）和类 Codex 的 26 周每日用量方格热图。热图横向铺满设置页宽度，悬停可见当日明细，无用量日显示为半透明玻璃格。
通过分析 Token 用量分布，可以：
- 识别哪些天用量异常高，回溯当时执行了什么任务
- 分析输入/缓存/输出 token 的比例，优化提示词以减少输入 token
- 评估缓存命中率，判断是否需要调整会话策略
实践技巧：如果发现缓存命中率很低（缓存 token 占比小），可以考虑在同一会话中连续执行相关任务，提高缓存复用率，降低费用。
场景五：OpenCode Go 额度管理与多供应商余额查询
对于使用 OpenCode Go 订阅的用户，dsh-cost-meter 支持三档额度（5小时/周/月）进度条显示，主档位高亮，可手动刷新。未订阅时显示中性提示，可一键关闭。
同时支持官方余额查询（总余额/赠送/充值）和自定义 Provider 余额（通过配置 URL / Headers / extract 规则）。右下角（dock）可显示额度/预算 chips，四项独立开关。
实践技巧：
- 在右下角开启 5h 额度 chip，实时关注滚动 5 小时额度使用情况
- Go 额度与预算同时开启时自动合并为一张卡片，Go 在上、预算在下，节省侧边栏空间
- 对于使用多个 API 供应商的用户，配置自定义 Provider 余额，统一查看各平台余额
实战案例演示
案例：用峰谷计价将月度费用降低 40%
某开发者团队使用 DeepSeek API 进行日常开发，月度费用约 200 美元。安装 dsh-cost-meter 后：
1. 通过 Token 热图发现，团队的大批量代码库分析任务主要在工作日下午（峰时段）执行
2. 将这些非紧急任务调整到晚上（谷时段）和周末执行
3. 配置峰谷切换提醒，避免任务跨峰谷边界
4. 设置月度预算 150 美元，达到 80% 时预警
调整后月度费用降至约 120 美元，降低 40%，且不影响开发效率。
最佳实践与技巧
1. 安装后立即配置预算：不要等超支了才设置预算，安装后第一时间在设置页配置月度预算
2. 开启峰谷系统通知：在设置 → 费用 → 峰谷计价中开启浏览器系统通知，即使页面最小化也能收到提醒
3. 定期查看 Token 热图：每周查看一次 26 周热图，识别用量异常和优化机会
4. 简化侧栏显示：如果侧边栏空间紧张，可在设置 → 费用 → 显示中开启「简化侧栏显示」，面板高度限制为视口的 38%
5. 官方价格同步：定期在设置页执行「官方价格同步」，确保价格表与官方定价一致，支持美元和人民币两种币种
安装与配置
npm install -g @deepseek-ai/dsh
dsh plugin --profile web add dsh-cost-meter
dsh web
安装后在 DSH Web UI 侧边栏即可看到费用统计面板，设置 → 费用中可进行详细配置。
适合人群
适合：重度 DeepSeek API 用户；需要控制 AI 预算的团队和个人；关注峰谷计价优化成本的用户；使用 OpenCode Go 订阅的用户；需要 Token 用量可视化分析的开发者。
不适合：偶尔使用 AI 且不关心费用的用户；Node 版本低于 20 的环境。
总结
dsh-cost-meter 不仅仅是一个费用显示插件，更是一个完整的 AI 成本管理工具。通过实时费用监控、峰谷计价优化、预算管控、Token 分析和多供应商余额查询五大核心场景，它帮助用户从「不知道花了多少钱」转变为「精确掌控每一分钱」。对于重度 DeepSeek 用户来说，安装这个插件的投资回报率极高——仅峰谷计价优化一项就能节省 30-50% 的 API 费用。
---