跳到正文

le-soleil-se-couche/dsh-token-cost

50最近提交 2026年8月14日

dsh-token-cost DSH 插件

该插件在对话页面底部显示会话费用,点击可查看明细弹窗;在设置页提供汇总卡片,支持时间筛选、统计卡和计价状态。数据来源于 DSH 持久会话日志,内置双计费方案并按记录时间自动切换。

如何安装 dsh-token-cost DSH 插件

dsh plugin --profile web add github:le-soleil-se-couche/dsh-token-cost

复制不会执行命令。安装 dsh-token-cost DSH 插件前请核对仓库和版本。

dsh-token-cost DSH 插件数据来源

dsh-token-cost DSH 插件快照日期:2026年8月16日

discovered

dsh-token-cost DSH 插件能做什么

  • 在对话页面底部状态行显示本会话费用,点击弹窗查看按请求的费用明细(时间、模型、缓存未命中/命中、输出、费用)。
  • 在设置页提供整体汇总,支持今天/昨天/最近7天/最近30天/本月/上月/自定义时间筛选(最多30天),展示费用、输入、输出、缓存命中率统计卡。
  • 显示当前生效的计价方案、下次切换时间及高峰时段。
  • 内置双方案(平价与峰谷定价),按记录时间自动切换;支持强制方案、自定义模型价格和币种切换(CNY/USD)。
  • 读取 DSH 会话日志并压缩缓存,仅重解析变化日志,配置项可在汇总卡片中编辑。

dsh-token-cost DSH 插件适合哪些场景

  • 实时监控单个对话的 Token 费用和缓存命中情况。
  • 按模型、会话、日期生成整体费用报告,用于预算分析。
  • 对比不同计价方案和高峰/闲时费用差异。
  • 追踪历史使用趋势,自定义日期范围(最多30天)。
  • 通过切换计价方案验证模型调价的影响。

dsh-token-cost DSH 插件适合谁

  • DSH Web GUI 用户,希望跟踪 API 费用。
  • 管理 DeepSeek API 使用预算的开发者和运维人员。
  • 需要详细了解 Token 用量和缓存性能的用户。

dsh-token-cost DSH 插件的限制

  • 费用基于 provider 上报用量估算,非官方账单,仅供参考。
  • 仅统计通过 DSH 发起的请求,其他工具/进程使用同一 API Key 的请求不会被计入。
  • 跨零点对话按浏览器本地日期切分,可能影响跨日统计数据。
  • 价格数据来源于 DeepSeek 官方页面(2026-08-14 抓取),若官方调价需手动确认(但支持追加新方案无需更新插件)。

dsh-token-cost DSH 插件的仓库 README 摘录

以下文字摘自 dsh-token-cost DSH 插件的上游仓库 le-soleil-se-couche/dsh-token-cost 的 README,版权归原作者,仅作引用。

DeepSeek Harness(DSH)Web GUI 的 Token 用量 / 缓存命中 / 费用统计插件:支持单对话视图与整体汇总,内置双计价方案并在 DeepSeek 调价后按记录时间自动切换。 ## 功能 - **单对话视图**:对话页面底部官方状态行(「首 token 平均 … · … tok/s」之后)直接嵌入本会话消耗费用,点击即可打开按请求的明细弹窗(时间 / 模型 / 缓存未命中 / 缓存命中 / 输出 / 费用,最新在上)。 <p align="center"> <img src="docs/screenshots/conversation-bottom.png" alt="对话底部状态行费用展示" width="90%"> </p> <p align="center"> <img src="docs/screenshots/cost-detail.png" alt="费用明细弹窗" width="80%"> </p> - **整体汇总**(设置 > 插件配置 > Web UI 插件 > Token 费用统计):时间筛选(今天 / 昨天 / 最近 7 天 / 最近 30 天 / 本月 / 上月 / 自定义,最多 30 天)+ 费用 / 输入 / 输出 / 缓存命中率统计卡,按模型、会话、日期分组。 - **计价状态**:当前生效方案、下次切换时间、高峰时段一目了然。 ## 数据来源 插件读取 DSH 的持久会话日志(`$DSH_HOME/sessions/<cwd>/<session-id>/session.jsonl.zstd`),把 provider 上报的 usage 事件折叠为按请求的计费记录(同一 turn/step 取最后一次,与官方 token-meter 投影语义一致)。紧凑账本(`$DSH_HOME/storages/dsh-token-cost/ledger.json`)缓存解析结果,只重解析变化的日志;zstd 解压使用 fzstd(纯 JS 零依赖)。 Token 字段遵循 Harness 约定:`inputTokens` = 缓存未命中部分,`cacheReadTokens` = 缓存命中部分(两者不相交,相加即计费输入)。 ## 价格引擎(双方案 + 自动切换) 内置官方价格表(api-docs.deepseek.com/quick_start/pricing,2026-08-14 抓取): - **方案 A**(平价,2026-08-16T16:00Z 前):deepseek-v4-flash / v4-pro 平价(CNY/USD),deepseek-chat / deepseek-reasoner 旧平价。 - **方案 B**(峰谷定价,2026-08-16T16:00Z

阅读完整 README仓库未声明许可,使用前请先与作者确认。

dsh-token-cost DSH 插件常见问题

如何安装 dsh-token-cost 插件?

在终端中执行命令 `dsh plugin --profile web add github:le-soleil-se-couche/dsh-token-cost`,然后重启 `dsh web` 服务。重启后进入设置页面,展开「Web UI 插件」即可看到插件卡片。

插件能统计历史会话的费用吗?

可以。插件会读取 DSH 持久化的会话日志文件,首次查询时会自动回填历史数据。后续只解析新增或变化的日志,避免重复计算。

如何切换显示币种?

在插件配置面板(设置 > Web UI 插件 > Token 费用统计)中,将 `currency` 选项设为 `'cny'` 或 `'usd'` 即可切换。默认值为 `'cny'`。

价格引擎的自动切换是什么意思?

插件内置了两个计价方案:方案 A(平价,适用于 2026-08-16T16:00Z 前)和方案 B(峰谷定价,适用于之后)。高峰时段为北京时间 9–12、14–18,闲时半价。每条记录按其时间取当时有效的方案计费。你也可以通过 `priceMode` 选项强制使用某个方案。

为什么显示的费用和官方账单不一致?

该插件根据 provider 上报的 Token 用量进行估算,并非官方计费工具。实际费用可能因四舍五入、优惠活动等因素存在差异,请以官方账单为准。