boooooooer/dsh-balance-and-cost

dsh-balance-and-cost

DeepSeek Harness（DSH）标准 bundle 插件：显示 DeepSeek 账户余额 与 模型消耗量。

• 主页输入框下方实时摘要条（与系统自带 stats 行同一套 pill 排版，单行居中、不换行）：DeepSeek 余额 ¥xx.xx CNY · 本会话（模型） xx.xM tok ≈¥x.xxx · 总计 xx.xM tok ≈¥x.xxx · 高峰/空闲（模型名跟随会话最近调用，token 按官方三档口径 M/K 缩略，悬停查看明细）
• 插件中心（设置 → 插件）「DeepSeek 用量」标签页：余额明细、按模型/按会话统计、计价缓存按小时明细、三档悬停、导出 CSV、重置记录
• 花费按消耗发生时刻的时段单价结算并写入计价缓存后冻结——高峰/空闲切换不会再让历史花费跳变；价格表同步到官方 2026-09-10 起的 V4.1-Flash 新价（模型改名与工作日高峰规则一并同步）

纯 JavaScript、零依赖、零构建——GitHub 直装无需构建授权。

界面预览

主页摘要条（输入框下方）

摘要条静息状态（显示会话最近使用的模型，费用记录从安装插件/重置记录起计算，无法加载历史记录）：

实际使用中的摘要条（调用次数、token 与估算费用实时更新）：

悬停 token 数字：当前模型在本会话的三档消耗明细（输入·缓存未命中 / 缓存命中 / 输出，与官方计费口径一致，三档之和 = 合计）：

悬停模型名：本会话中 deepseek-v4-flash / deepseek-v4-pro 两个模型的实际消耗对比：

插件中心「DeepSeek 用量」面板（设置 → 插件）

静息状态（安装/重置后尚未使用，无明细）：

使用示例（展示余额明细、按模型明细、各会话消耗明细，支持导出为CSV文件）：

功能特性

计价缓存（为什么花费不会突变）

DeepSeek 价格分高峰/空闲两档。如果展示时用「当前时间」的单价去重算历史 token， 那么每次时段切换（北京 09:00 / 12:00 / 14:00 / 18:00）已经产生的花费都会突然翻倍或腰斩—— 数字变了，账单没变。

本插件因此维护一份计价缓存（cost ledger）：每次 llm/stream 上报用量时， 按消耗发生的那一刻结算并把结果记下来：

2026-09-14T09（北京时间整点）· 高峰
  deepseek-v4-flash  单价：未命中 ¥3/M · 命中 ¥0.1/M · 输出 ¥9/M
  3 次调用 · 1.2M tok · ≈¥3.6042   ← 该数值从此固定，不再随任何时段变化

• 摘要条与本会话/总计费用 = 缓存里各整点费用之和（不再用当前时间重算）；
• 缓存保留最近 720 个整点（30 天），更早的分桶折叠成归档合计——只丢时间粒度、不丢费用；
• 升级前落盘的旧数据没有时间记录，其费用仍取已记录的真实花费， 只有三档拆分按权重估算并在界面标注「含无时间记录的历史 token」——合计永远等于真实花费。

价格表（内置，人民币 / 百万 tokens）

来源：DeepSeek 官方定价（价格可能变动，请以官方页面为准；编辑 src/index.js 的 PRICES / MODEL_ALIASES 即可更新）

当前生效：v2（2026-09-10 12:00 起） —— DeepSeek V4.1 Flash 发布后的新价格。

• 高峰时段 = 北京时间周一至周五 9:00-12:00、14:00-18:00，其余（含周末全天）为空闲时段，空闲价为高峰价的一半。
• 模型改名同步：官方已把 Flash 更名为 deepseek-flash；旧名 deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v4-flash-vision-exp 仍可调用，但请求由 V4.1-Flash 提供服务，因此按 Flash（deepseek-flash）单价计费，统计里也归并到 deepseek-flash 一行。
• 缓存写入按输入未命中计价；未收录模型按 deepseek-flash 估算并在界面标注。
• 换表迁移：PRICING_VERSION 递增（价格表变动）时，启动会按计价缓存里各分桶记录的时间用新表重算一次——时间取自记录、只换表，所以不会出现「按当前时段重算历史」的突变；没有时间记录的历史 token（0.2.0 之前的聚合值）保持原记录费用，界面标注为估算拆分。

安装

# GitHub 直装（纯 JS 零依赖，无需 allowBuilds 构建授权）
dsh plugin --profile web add github:boooooooer/dsh-balance-and-cost

# 或本地目录 / tarball
dsh plugin --profile web add ./dsh-balance-and-cost
pnpm pack   # 生成 tarball 后：dsh plugin --profile web add ./dsh-balance-and-cost-0.1.0.tgz

安装后重启 dsh（bundle 层在启动时组合）。卸载：dsh plugin --profile web remove dsh-balance-and-cost。

配置

• API Key：插件通过 DSH 的 credentials 服务解析 DEEPSEEK_API_KEY（~/.dsh/.credentials.yaml 或同名环境变量），代码中不含任何密钥
• 统计文件：$DSH_HOME/dsh-balance-and-cost.json（可在设置页「重置记录」一键清空，或直接删除文件）

目录结构

dsh-balance-and-cost/
├── package.json        # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml    # bundle 补丁层：insert 插件行
├── src/
│   ├── index.js        # node half：llm/stream 统计、计价缓存、余额查询、HTTP/SSE 路由
│   └── client.js       # browser half：摘要条 + 设置页（__ModuleLoader__ 加载）
├── test/
│   ├── smoke.mjs           # 单元冒烟：manifest / 计价 / 计价缓存回归
│   └── host-integration.mjs # 端到端：假 ctx 挂载 → 统计 → 快照 → 落盘 → 恢复
├── assets/             # 界面截图
├── README.md
└── LICENSE

工作原理

费用在 Host 端按消耗到达时刻的时段单价结算并写入计价缓存（ledger）后冻结： 摘要条与本会话/总计的三档拆分都是对缓存的求和，因此跨时段、跨天、重启后的历史花费都精确不变； 统计按会话隔离读取（会话日志），进程重启后从持久化恢复。

开发与测试

npm test                          # 下面三个用例一起跑
node test/smoke.mjs               # manifest / 两端模块加载 / 分时段计价 / 计价缓存（时段切换不跳变）
node test/host-integration.mjs    # 假 ctx 端到端：llm/stream 统计 → /usage 快照 → 落盘 → 重启恢复 → 重置
node test/client-render.mjs       # 假 React/slots 渲染：槽位注册 + 摘要条 + 设置页（含计价缓存区块）

改动记录见 CHANGELOG.md，安全设计见 SECURITY.md。

已知限制

• 只统计 provider 含 deepseek 的模型调用（deepseek-official 等路由）
• 费用为估算值（官方单价 × token 用量），实际扣费以 DeepSeek 账单为准
• 重放（replay）的模型调用可能重复计入（近似）
• 升级前落盘的历史 token 没有时间记录，其三档拆分是估算值（合计仍为真实花费，界面有标注）；价格表更新时这部分历史费用不会被重算
• 计价缓存只保留最近 720 个整点（30 天）的时间粒度，更早的折叠为归档合计（同样不参与换表重算）
• 会话的进程内「当前选中但未调用」模型为 DSH 私有状态，插件侧显示会话最近调用模型（requestHeader）或全局默认

License

MIT