Skip to content

dsh-cost-overview

Verified

@dawn0608/dsh-cost-overview · v1.0.5 · MIT · Web UI

Estimate the current session cost and view model costs and the DeepSeek API balance below the composer.

Install

dsh plugin add @dawn0608/dsh-cost-overview

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

费用概览

功能

  • 当前会话产生 token 后,在输入框下方的内置统计旁显示费用和余额。
  • 按 DeepSeek 官方价格表 计算会话费用。未知模型保留自己的 ID 和明细行,按 Flash 价格估算,并在相关金额前标注「估算」。
  • 宿主使用已配置的 DeepSeek API Key 读取账户余额。点击统计按钮,可查看模型请求、网页请求、账户余额和赠送余额。

安装

在 Desktop「插件」页搜索 @dawn0608/dsh-cost-overview,或对目标 profile 执行以下命令。

dsh plugin --profile <profile> add @dawn0608/dsh-cost-overview

使用与配置

点击统计按钮打开明细。按 Escape、点击面板外部或再次点击按钮可关闭。一个会话使用多个模型时,每个模型单独显示一行。已有 token 的会话读取失败时,统计按钮仍可点击,金额显示为占位符,面板说明失败原因。

客户端通过认证连接读取状态。切换会话、token 计数变化、打开面板、每五分钟以及标签页重新可见时会刷新。宿主将余额读取结果缓存一分钟。

余额配置来自宿主的 llm-deepseek 路由。宿主凭据服务或启动环境按 apiKeyEnv 解析 API Key,并按 baseURL 请求 GET <baseURL>/user/balance。启动环境的回退配置为 COST_OVERVIEW_API_KEY_ENV 和 DEEPSEEK_BASE_URL,默认分别是 DEEPSEEK_API_KEY 和 https://api.deepseek.com。

计费方式

DeepSeek 提供单价和账户余额。插件根据宿主日志重建当前会话费用。

输入 来源
未命中输入、缓存读写与输出 assistant/message 的提供方用量、assistant/attempt 记录流的最后一个用量块,或 compaction/summary 的用量
模型和价格时段 日志中的模型路由与事件时间,按北京时间计算
搜索与抓取 成功的 web_search 按去重后的 query 数计算,成功的 web_fetch 每次计一笔

宿主从官方页面读取模型价格。成功读取后每隔 24 小时刷新,刷新失败时保留上一张表,并允许在一分钟后重试。首次读取失败时,面板会显示价格状态。可用的价格表缺少 Search 或 Fetch 单价时,最终兜底为每 1,000 次 ¥5。

环境要求与限制

  • 适用 DSH >=0.2.2-rc.1 <0.3.0。本地开发需要 Node.js 24 或更高版本。
  • 事件时间与提供方请求时间可能落在不同价格时段。法定节假日遇工作日时,按平常工作日的时段计费。
  • 当前会话费用不含标题生成、子会话和 Messages API 网页搜索。网页工具每次调用只报告一个结果。如果搜索结果标记为失败,即使上游有部分 query 成功,该次调用也计为零笔请求。
  • 宿主尚未载入的会话可能无法读取。余额依赖 API Key 路由,使用 DeepSeek 账户登录的会话可能显示未配置 API Key。
  • 账户余额反映全账户的活动,包括其他会话和进程。

开发

在仓库根目录运行 npm test -w @dawn0608/dsh-cost-overview 验证本插件,运行 npm run verify 执行全仓检查。构建将 src/index.js 与 src/client/index.js 打包成 lib/index.js 和 lib/client.js。本地重新构建后,重启 DSH 以加载构建产物。

宿主在 DSH 连接上注册 GET /api/cost-overview/state?session=<id>,客户端使用相对地址 api/cost-overview/state。响应包含余额、费用和价格状态。弹层使用 DSH 主题变量,定位逻辑按随包 MIT 许可证 改编自 DSH 0.2.2-rc.1 原生统计弹层。