在 DSH 侧边栏品牌行下方显示 DeepSeek API 账户余额,每 60 秒刷新一次;圆点绿色表示账户可用,红色表示不可用,橙色表示请求失败。余额经宿主提供的同源端点获取,该端点会拒绝不受信任的请求,API Key 与账号 token 都不会进入浏览器。已登录 DeepSeek 账号时余额来自账号钱包(充值 + 赠送额度按币种求和),否则回退到 DEEPSEEK_API_KEY 的余额接口。金额右侧会标注当前处于 DeepSeek 峰时还是谷时定价。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/happyde2b/dsh-balance-display-simple/releases/latest/download/dsh-balance-display-simple.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:happyde2b/dsh-balance-display-simple
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH 侧边栏顶部品牌行下方实时显示 DeepSeek API 账户余额。
名字里的
simple是实话:只做「查余额、显示余额」。没有图表、历史记账、多供应商切换。
功能
- 侧边栏 deepseek 标题正下方显示
API 余额 ¥19.74,多币种用·拼接 - 每 60 秒自动刷新;点击余额条立即刷新
- 状态圆点:绿 = 正常,红 = 账户不可用,橙 = 查询失败(保留上次数值)
- 侧边栏折叠成 rail 时自动隐藏
- 跟随主题配色
安全设计
浏览器 / 渲染进程不接触 API Key:
- Host 半区(
lib/index.js)注册同源端点GET /api/deepseek-balance-simple,通过credentials服务解析DEEPSEEK_API_KEY(来源:进程环境 ><DSH_HOME>/.credentials.yaml>.env), 由服务端调用https://api.deepseek.com/user/balance(15 秒超时,cache-control: no-store)。 - Client 半区(
lib/client.js)只请求这个本地端点,经 MutationObserver 在侧边栏品牌行后注入余额条, React 重渲染后自动重新挂载。
安装
前置:Node.js 20+;DSH_HOME 指向 DSH 数据家,或用 --dsh-home 显式传入。
方式 A:手动复制(不需要 pnpm)
git clone https://github.com/happyde2b/dsh-balance-display-simple.git
cd dsh-balance-display-simple
node install.js # → <DSH_HOME>\profiles\desktop\node_modules\dsh-balance-display-simple
node install.js --profile web # 指定 profile
# 同时更新 profile 的 package.json(dependencies + dsh.profile.bundles)
方式 B:官方插件管理器
node install.js --pack # 产物:<DSH_HOME>\downloads\dsh-balance-display-simple-<版本>.tgz
# 在 DSH「插件 → 添加插件」里填该 tgz 的绝对路径,安装后启用
安装后重启 DSH 桌面端生效。
配置
暂无配置项。轮询间隔在 lib/client.js 顶部 REFRESH_MS = 60000,改后重启桌面端。
验证
node --check lib/index.js
node --check lib/client.js
桌面端运行中可直接查端点:
curl http://127.0.0.1:<DSH Web 端口>/api/deepseek-balance-simple
# {"ok":true,"fetchedAt":...,"is_available":true,"balance_infos":[{"currency":"CNY","total_balance":"19.74"}]}
目录结构
lib/index.js Host 半区:注册余额端点
lib/client.js Client 半区:侧边栏余额条
cordis.patch.yml bundle 配置层(插入插件行)
install.js 手动安装 / 打包脚本
许可
MIT
链接
同类插件
bowenliang123/dsh-context★ 5364
DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。
Han-1413141/dsh-cost-meter★ 737
会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。
wssfk12138/dsh-damage-pulse★ 290
在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。
zh667/TokenLedger★ 205
侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。
Ychris12138/dsh-usage-stats★ 192
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
PolinniZhong/dsh-personal-center★ 115
DeepSeek Harness 个人中心:跨会话用量统计(按供应商/模型分别统计,自动读取已配置模型)、按模型成本估算、全局自定义指令、数据驱动的桌面宠物(位图/矢量皮肤)与会话状态概览,纯本地离线运行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。