alanzhao0128/dsh-balance-monitor

README 摘要

English 简体中文 dsh-balance-monitor DeepSeek 余额与花费窗口，直接显示在 dsh 侧边栏底部。 一个极简的 DeepSeek Harness (dsh) 插件：在侧边栏底部（设置上方）显示你的 DeepSeek API 账户余额，以及 今日 / 7日 / 30日 三个花费窗口。有平台 token 时全部为 官方口径 （与 platform.deepseek.com 用量页一致）；没有 token 时今日回退为余额差值估算。样式完全使用官方设计令牌，克制内敛。 功能 功能 实现 实时余额 服务端调用 GET https://api.deepseek.com/user/balance ，使用 $DSH HOME/.credentials.yaml 中的 DEEPSEEK API KEY （环境变量优先） 今日/7日/30日花费（官方） 配置 DEEPSEEK PLATFORM TOKEN 后，服务端调用官方用量接口 platform.deepseek.com/api/v0/usage/cost （与平台用量页同一份数据），按日期窗口累加。7日 = 今天往前 6 天，30日 = 今天往前 29 天（均含今天）。不受「在其他环境使用 API」影响 余额差值回退 无平台 token 或官方接口失败时，今日花费回退为余额差值账本（只累计余额下降，充值不冲账）；7日/30日显示 — 渠道感知 卡片跟随当前会话的模型渠道（provider）自动显隐：DeepSeek 官方渠道显示余额/花费；其他渠道（如 OpenCode Go、百炼）显示「暂不支持此渠道」占位；无会话时不显示 位置 注册在官方 sidebar.footer.action 槽位 —— 设置上方，零 hack 折叠态 收起后变为 36px 圆形，显示紧凑余额 + tooltip 健壮性 60s 轮询 + 切回标签页时刷新；上游失败时保留上次数据（变淡标记 stale），不闪错误 安装 浏览器端 bundle 是手写的 classic script， 无构建步骤 ，git 安装无需 prepare 脚本： 或从 npm（发布后）： 然后重启 Web UI（ dsh --profile web ）。卡片出现在展开的侧边栏底部、设置按钮上方。 配置 两个凭证都在 $DSH HOME/.credentials.yaml （Web 界面 Models 页写入，或直接编辑文件）： 凭证 必需 用途 DEEPSEEK API KEY ✅ 查询余额 api.deepseek.com/user/balance DEEPSEEK PLATFORM TOKEN 可选 查询官方用量（今日/7日/30日）。获取：登录 platform.deepseek.com → DevTools Console …

分类