前言¶
在使用 DeepSeek Harness (DSH) 进行开发或日常交互时，实时掌握账户余额和模型调用消耗至关重要。本插件旨在提供这些信息，通过显示余额、模型消耗量及官方高峰/空闲定价，帮助用户控制成本。
它是什么¶
dsh-balance-and-cost 是 DeepSeek Harness (DSH) 的一个标准客户端插件。
- 维护者：boooooooer
- 类别：客户端
- 许可证：MIT
- 核心价值：显示 DeepSeek 账户余额、模型消耗量及官方分时段定价。
核心功能¶
该插件具备以下功能：
-
余额查询
通过api.deepseek.com/user/balance接口查询余额，显示总余额 / 充值 / 赠送 / 可用状态。接口端返回 60 秒缓存。 -
消耗量统计
监听llm/stream事件，实时累计 DeepSeek 模型调用。按官方三档口径统计（输入·缓存未命中 / 缓存命中 / 输出），区分总计与当前会话，数字按 M/K 缩略。 -
按模型计价
根据实际调用的模型匹配官方价格表（支持版本后缀如deepseek-v4-pro-0813前缀匹配）；未收录模型按deepseek-v4-flash估算。 -
分时段计价
区分高峰时段与空闲时段定价。高峰时段为北京时间 9:00-12:00、14:00-18:00，其余为空闲时段（价格约为高峰一半）。 -
会话明细
在插件中心查看按模型和按会话的统计，每个会话显示真实标题、总计行与分模型行。 -
三档悬停
在主页摘要条悬停 token 数字，查看三档明细（含各档费用）；悬停模型名查看两个主要模型（flash/pro）的实际消耗对比。 -
导出明细
支持一键导出 CSV 文件（按模型 + 按会话，三档口径，带 BOM 可直接用 Excel 打开）。 -
重置记录
一键清空全部统计、余额基线与缓存，支持持久化落盘。 -
持久化
统计数据保存在$DSH_HOME/dsh-balance-and-cost.json，进程重启后自动恢复。 -
实时更新
通过 SSE 实时推送用量变化，浏览器立即刷新；15 秒轮询作为断连兜底。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add github:boooooooer/dsh-balance-and-cost
安装后需要重启 dsh 以加载插件。
使用示例¶
- 主页摘要条：在输入框下方显示
DeepSeek 余额 ¥xx.xx CNY · 本会话（模型） xx.xM tok ≈¥x.xxx · 总计 xx.xM tok ≈¥x.xxx · [高峰/空闲]。模型名跟随会话最近调用，费用从安装或重置记录起计算。 - 悬停查看：鼠标悬停在 token 数字上，显示输入·缓存未命中 / 缓存命中 / 输出的三档明细。
- 插件中心：进入「设置 → 插件」的「DeepSeek 用量」标签页，查看余额明细、按模型/会话统计、导出 CSV。
注意事项¶
- 统计范围：插件只统计 provider 含
deepseek的模型调用（例如deepseek-official路由）。 - 费用估算：显示的费用为估算值（官方单价 × token 用量），实际扣费以 DeepSeek 账单为准。
- 重放调用：重放（replay）的模型调用可能重复计入。
- 会话模型显示：会话显示的是最近调用模型的名称，而非当前选中但未调用的模型。
生态背景¶
DeepSeek Harness (DSH) 采用「一切皆插件」的理念。本插件由社区开发者维护，与 DeepSeek / 幻方无官方从属关系。
