dsh-balance-widget

September 5, 2026 · View on GitHub

DeepSeek Harness (DSH) Web GUI 的余额与成本小部件：侧边栏底部常驻卡片显示账户余额与今日花费，点击弹出五层级成本明细（余额 / 最近提问·标注会话名 / 今日·本会话 / 今日·本工作区 / 今日·所有工作区）。

效果预览

侧边栏卡片（左下角常驻）	点击弹出五层级成本

与同类插件的区别

特点	本插件	同类插件（dsh-balance / dsh-token-price 等）
零外部依赖	✅ 不 import 任何 `@deepseek-ai/*` 包，无原生模块	❌ 多数依赖 dsh SDK 包
Node 24 兼容	✅ 天然兼容（零依赖设计），任何 profile 布局可加载	⚠️ 不少社区插件在 Node 24 下报错
启动稳定性	✅ 用官方 `ctx.webServer` 注册路由，不与 apiproxy 冲突	⚠️ 有的自建 HTTP 服务导致 dsh web 启动崩溃
常驻自动刷新	✅ 侧边栏卡片每 60s 自动刷新余额与成本，弹框点击即强刷	有的常驻徽章定时刷新
峰谷定价	✅ 内置官方 2026-08-17 峰谷价表，自动按时段切换	部分支持
安全性	✅ API key 仅在宿主进程，loopback-only 守卫	参差不齐

一句话：零依赖、Node 24 就绪、永不拖垮 dsh web 启动的余额/成本小部件。

功能

账户余额 — 点击图标时经宿主代理查询 DeepSeek 官方 GET /user/balance，展示 ¥ 余额；余额数字按阈值自动变色（充足 / 低于 lowThreshold 变黄 / 低于 criticalThreshold 变红）；API key 只在宿主进程内读取（凭据服务），浏览器不接触密钥。
最近一次提问成本（估算） — 从最近活跃会话文件解析最后一个 turn 的 token 用量 × 单价，回答"刚才那条提问花了多少"；下方标注该会话的会话名。
今日·本会话成本（估算） — 当前会话今天（自然日）产生的 token 用量 × DeepSeek 官方峰谷定价表计算，随当前会话模型（默认 deepseek-v4-flash，可在配置中改为 deepseek-v4-pro）与北京时间高峰/空闲时段自动切换。
今日·本工作区成本（估算） — 遍历当前工作区（由当前会话锚定）下的所有会话，累加今天的 token 用量 × 单价。
今日·所有工作区成本（估算） — 遍历 ~/.dsh/sessions/ 下所有工作区的所有会话，累加今天的 token 用量 × 单价。
峰谷状态标签 — 卡片与弹框边框按当前时段着色（峰时橙色 / 谷时绿色），弹框标题旁显示「峰时/谷时」标签，悬停可查看当前价格档位（输入/输出单价）。
Token 用量 — 同时展示输入（含缓存命中）/ 输出 token 数。
一键充值 — 弹层底部「去充值」链接直达 DeepSeek 官方充值页（platform.deepseek.com/top_up），新窗口打开。
侧边栏常驻卡片 — 侧边栏底部（设置上方）显示余额 + 今日花费，全局可见；每 60 秒自动刷新（余额走官方接口、成本为本地会话解析），打开弹框时也会立即刷新一次，无需手动操作。
余额数字变色预警 — 余额数字按三档着色：充足（默认色）→ 琥珀（低于 lowThreshold）→ 红色（低于 criticalThreshold），一眼判断余额健康度。
官方价格自动同步 — 启动时 + 每 12 小时抓取 DeepSeek 官方定价页，改价自动跟进；失败回退内置价目表。
模型工具查询 — 新增 deepseek_billing 工具，可直接问模型"余额多少/今天花了多少"。

架构

host 半区 (lib/index.js)
  ctx.webServer.register:
    GET /api/dsh-balance/balance     → 官方 /user/balance（loopback-only 守卫）
    GET /api/dsh-balance/active-cost → 最近活跃会话的最近提问 + 今日·本会话（含会话名）
    GET /api/dsh-balance/today-cost  → 今日成本（双值：当前工作区 + 所有工作区）
  依赖：零外部 @deepseek-ai/* import，任何 profile 布局均可解析
  另有 deepseek_billing 工具供模型直接查询余额/成本

client 半区 (lib/client.js)
  ctx.slots.inject("sidebar.footer.action")
    → 侧边栏底部常驻卡片（余额 + 今日花费，峰/谷时段描边着色）
    → 点击弹出五层级成本明细 + 峰谷标签 + ⓘ 名词解释

安装

npm 安装（发布后）：

dsh plugin --profile web add dsh-balance-widget

GitHub 仓库安装（开发调试）：

git clone https://github.com/LL-cmyk-so/dsh-balance-widget.git
cd dsh-balance-widget
dsh plugin --profile web add "link:$(pwd)"

装完重启 dsh web 生效。

配置

配置文件在哪

DSH 的插件配置统一放在这个文件里：

~/.dsh/profiles/web/cordis.patch.yml

说明：~ 是你的用户主目录（macOS 是 /Users/你的用户名）。

全部配置项

在 cordis.patch.yml 中追加以下内容（只改你需要的那几行，其余保持默认即可）：

- id: balance-widget
  name: dsh-balance-widget
  config:
    balanceBaseURL: https://api.deepseek.com   # 官方余额接口（一般不用改）
    balanceApiKeyEnv: DEEPSEEK_API_KEY          # 凭据服务中的密钥 ref（一般不用改）
    requestTimeoutMs: 5000                      # 余额查询超时（毫秒）
    modelId: deepseek-v4-flash                  # 成本计价模型（可改 deepseek-v4-pro）
    lowThreshold: 5                             # 余额低于此值（¥）图标变黄提醒
    criticalThreshold: 1                        # 余额低于此值（¥）图标变红警告

示例：调整余额预警阈值

默认余额 低于 ¥5 变黄、低于 ¥1 变红。想改成"低于 ¥10 提醒、低于 ¥3 警告"：

- id: balance-widget
  name: dsh-balance-widget
  config:
    lowThreshold: 10
    criticalThreshold: 3

改完重启 dsh web 生效。

示例：成本按 V4-Pro 计价

如果主要使用 DeepSeek-V4-Pro 模型，把计价模型改掉，成本估算更准：

- id: balance-widget
  name: dsh-balance-widget
  config:
    modelId: deepseek-v4-pro

提示：cordis.patch.yml 可能有其他插件的配置行，追加时注意不要改动已有的行，只加新内容。

定价说明

内置 DeepSeek 官方 2026-08-17 峰谷定价（元 / 百万 tokens），高峰时段为北京时间 09:00–12:00、14:00–18:00，价格为空闲时段两倍：

模型	时段	缓存命中(输入)	缓存未命中(输入)	输出
V4-Flash	空闲	0.05	1.5	4.5
V4-Flash	高峰	0.10	3.0	9.0
V4-Pro	空闲	0.15	4.5	13.5
V4-Pro	高峰	0.30	9.0	27.0

deepseek-chat / deepseek-reasoner 别名分别映射到 Flash / Pro 价格。成本为估算值，实际以官方账单为准。

版本历史

v0.5.1 — 冷启动提速与代码清理

🚀 性能：今日成本冷启动从 ~5.4s 降至 ~0.01s——只解压当天活跃的会话文件（按 mtime 过滤）+ 解压结果按 (path, mtime) 长期缓存 + 并行解析
⏰ 轮询口径：README 与代码统一——常驻卡片每 60s 自动刷新（此前文档"无轮询"表述自相矛盾，已更正）
🌏 峰谷时区修正：峰/谷判断改为显式按北京时间（UTC+8）计算，不再依赖宿主机时区
🧹 清理：移除客户端一套从未调用的死计价代码（PRICING/priceSession），计价统一走宿主
📐 定价解析加固：峰价改为从官方页面显式解析（不再硬编码"谷价 ×2"）；解析不到缓存命中价时整表回退内置价目表，避免静默按 0 计价
🏷️ 卡片语义：卡片底部"今日"改为"今日·全部"，明确是全局（所有工作区）口径
🎨 外观：💰 换 SVG 钱包图标、弹框/卡片微交互动画、层级弱化（详情见 v0.5.1 diff）

v0.5.0 — 五层级成本与峰谷状态

✨ 新增：成本明细改为五层级——余额 / 最近一次提问 / 今日·本会话 / 今日·本工作区 / 今日·所有工作区
- 最近一次提问下方标注会话名（基于最近活跃会话）
- 「今日·本会话」= 当前会话今天产生的费用；「今日·本工作区」= 当前工作区今天所有会话合计（由当前会话锚定工作区）；「今日·所有工作区」= 全部工作区今天合计
✨ 新增：峰/谷时段状态可视化——卡片与弹框边框按时段着色（峰时橙色 / 谷时绿色），弹框标题旁显示「峰时/谷时」标签，悬停查看当前价格档位
🎨 调整：移除余额剩余比例条，改为余额数字按阈值直接变色（充足 / 黄 / 红）
🗑️ 移除：弹框中的「本会话成本」（会话全程累计）行

v0.2.0 — 最近一次提问与今日总成本

✨ 新增：弹层增加「最近一次提问成本」与「今天总成本」两项
- 最近一次提问：解析当前会话最后一个 turn 的 token 用量 × 单价
- 今天总成本：遍历 ~/.dsh/sessions/ 下所有会话，累加今天（自然日）用量
🐛 修复：last-cost 路由的 session-id 前缀重复问题（带/不带 session- 前缀均可解析）

v0.1.0 — 初始版本

🎉 账户余额（官方 /user/balance）+ 本会话成本（估算）+ Token 用量
按需刷新：无轮询，点击才查询，不消耗 token

验证

配置树：dsh --profile web --dump-config 应出现 balance-widget 条目
余额路由：重启 dsh web 后 curl -s http://127.0.0.1:3080/api/dsh-balance/balance 应返回 { ok, balance_infos, modelId }
会话成本：curl -s http://127.0.0.1:3080/api/dsh-balance/active-cost 应返回 { lastPrompt, todaySession, title, sessionId, peak, workspaceName, ... }；加 ?session=SESSION_ID 可指定会话
今日成本：curl -s http://127.0.0.1:3080/api/dsh-balance/today-cost 应返回 { workspace: { cost, ..., cwd }, all: { cost, ... }, modelId }
兼容旧路由：curl -s "http://127.0.0.1:3080/api/dsh-balance/last-cost?session=SESSION_ID" 仍可用，返回 { cost, inputTokens, outputTokens, modelId }

License

MIT