本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-balance

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @pinkbanana/dsh-balance

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 查看总余额、充值余额和赠送余额
• 在聊天框下方持续显示余额摘要
• 查看当前 API Key 可用的模型
• 缓存查询结果并支持手动刷新
• 依据 DeepSeek 峰谷定价，在高峰时段（北京时间 9:00–12:00、14:00–18:00）将聊天框下方的余额指示灯变为橙色

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后看不到余额页面怎么办？

API Key 是查询余额的前提，需要先在 DSH 设置 → 模型 中保存 DeepSeek API 密钥，或设置环境变量 DEEPSEEK_API_KEY，否则接口会返回 401 MISSING_API_KEY，余额页面会显示"未配置 DeepSeek API 密钥"。

这个插件会向浏览器泄露 API Key 吗？

不会。API Key 只在本机 Host 端被读取（通过 DSH 凭据服务 ctx.credentials.resolve），浏览器只通过同源接口 /dsh-balance/api/balance 与 /dsh-balance/api/models 拿到余额和模型数据，密钥从不离开本机进程。

聊天下方的指示灯什么时候会变成橙色？

余额指示灯在北京时间 09:00–12:00 和 14:00–18:00 这两个高峰时段显示为橙色，其他时段为绿色；高峰期 API 价格是低谷的两倍，2026-08-17 起按 DeepSeek 官方峰谷定价生效。

为什么我的请求被拒 403？

插件默认仅允许本机（127.0.0.1/localhost/[::1]）访问这两个接口，非本机访问会直接返回 403 FORBIDDEN；如果确实需要在同网段其他机器访问，可将配置 allowRemote 设为 true。

数据多久刷新一次？

聊天框下方的余额指示灯默认 60 秒刷新一次，设置页面点击"刷新"按钮可绕过 30 秒缓存立即拉取；后端 Host 默认 30 秒缓存（cacheMs）。

余额数字多久会变成最新值？

设置面板与聊天指示灯都遵循同一个 30 秒缓存；点击"刷新"按钮或在请求 URL 后加 ?refresh=1 可绕过缓存立刻拿到最新值。

支持哪些语言？

原生提供简体中文和英文两套字典，会跟随 DSH 系统语言自动切换；切换逻辑在客户端的 locale 注册处完成。

如何卸载这个插件？

通过 dsh plugin --profile web remove @pinkbanana/dsh-balance 卸载，插件只在内存中缓存查询结果，不写入任何本地文件或凭据，卸载即彻底清除。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=20
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则