dsh-balance-widget
Balance & cost widget for the dsh web GUI: a sidebar footer card shows the DeepSeek account balance and today's costs; clicking opens a popover with a five-tier cost breakdown (last prompt with session name / today-this-session / today-this-workspace / to
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add dsh-balance-widget@0.5.3
Balance Widget is published as dsh-balance-widget and currently resolves to version 0.5.3. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
中文 | English
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-09-10 峰谷价表，启动时与每 12h 自动从官方页刷新 | 部分支持 |
| 安全性 | ✅ API key 仅在宿主进程，loopback-only 守卫 | 参差不齐 |
一句话：零依赖、Node 24 就绪、永不拖垮 dsh web 启动的余额/成本小部件。
GET /user/balance，展示 ¥ 余额；余额数字按阈值自动变色（充足 / 低于 lowThreshold 变黄 / 低于 criticalThreshold 变红）；API key 只在宿主进程内读取（凭据服务），浏览器不接触密钥。deepseek-v4-flash，可在配置中改为 deepseek-v4-pro）与北京时间高峰/空闲时段自动切换。~/.dsh/sessions/ 下所有工作区的所有会话，累加今天的 token 用量 × 单价。lowThreshold）→ 红色（低于 criticalThreshold），一眼判断余额健康度。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 生效。
如果主要使用 DeepSeek-V4-Pro 模型，把计价模型改掉，成本估算更准：
- id: balance-widget
name: dsh-balance-widget
config:
modelId: deepseek-v4-pro
注意：官方已公告 V4-Pro 将于北京时间 2026-09-14 12:00 下线——此后 V4-Pro 请求会被路由到 V4.1-Flash 并按 Flash 计费。若在这之后仍配置 deepseek-v4-pro，估算会偏高，建议使用默认的 Flash 档。
提示：cordis.patch.yml 可能有其他插件的配置行，追加时注意不要改动已有的行，只加新内容。
内置 DeepSeek 官方 2026-09-10 峰谷定价（元 / 百万 tokens），高峰时段为北京时间周一至周五 09:00–12:00、14:00–18:00（周末全天为空闲时段），价格为空闲时段两倍：
| 模型 | 时段 | 缓存命中(输入) | 缓存未命中(输入) | 输出 |
|---|---|---|---|---|
| V4.1-Flash | 空闲 | 0.02 | 1.0 | 4.0 |
| V4.1-Flash | 高峰 | 0.04 | 2.0 | 8.0 |
| V4-Pro | 空闲 | 0.15 | 4.5 | 13.5 |
| V4-Pro | 高峰 | 0.30 | 9.0 | 27.0 |
官方页当前只列 deepseek-flash 与 deepseek-v4-pro 两列；deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-chat 等旧名仍可调用，按 Flash 价计费。插件在启动时与每 12h 从官方页重新解析，只有解析失败才回退上表。成本为估算值，实际以官方账单为准。
本节面向 DSH Store / 插件审计，列出依赖、运行时权限、外部服务与失败边界。
依赖与兼容
@deepseek-ai/* 包，宿主端无第三方依赖peerDependencies["@deepseek-ai/dsh"]: >=0.1.2-rc.1 <0.2.0（DSH 兼容范围）engines.node: ^22.19.0 || >=24.0.0peerDependencies["react"]: ^18.2.0（仅浏览器端渲染）运行时权限
files：只读 ~/.dsh/sessions/ 下的会话 JSONL（成本统计）；不写入、不修改任何会话文件network：仅请求 DeepSeek 官方端点——api.deepseek.com（GET /user/balance 余额）与 api-docs.deepseek.com 定价页（每 12h 抓取）；不走任何第三方代理commands：spawn zstd -d -c 解压会话文件（macOS 需 brew install zstd）；不执行其他命令credentials：读取 DEEPSEEK_API_KEY（经宿主凭据服务解析），仅宿主进程使用、loopback-only 路由守卫；浏览器不接触密钥外部服务
GET /user/balance（点击/60s 刷新时调用）失败边界
pricingSource 标记为 default（解析成功则为 synced）zstd 缺失：返回可读错误提示（指引安装），而非静默失败session.v3.jsonl.zstd，插件此前只认 session.jsonl.zstd，导致升级后新建的会话全部不可见——查看这类会话时弹层出现红色报错，今日成本也漏算（实测少约 36%）。现按「每个会话目录取最高代」发现日志；迁移会话保留的旧文件是新代的子集，因此只读最高代，避免整个会话被重复计算deepseek-flash 并下调价格，插件按模型名定位价格块的锚点因此落到页面脚注，同步"成功"却静默沿用旧高价，成本被高估约 1.7 倍。现改为按价格表行标签锚定，并把该列价格套用到全部 Flash 系名称pricingSource 取值为 default / synced（此前误写为 builtin）~/.dsh/sessions/ 下所有会话，累加今天（自然日）用量session- 前缀均可解析）/user/balance）+ 本会话成本（估算）+ Token 用量dsh --profile web --dump-config 应出现 balance-widget 条目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 }MIT