🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

linfengyu94/dsh-balance-panel

DeepSeek Harnessspec-screened扫描:低风险在 GitHub 查看 ↗
需源码安装

DeepSeek 充值余额悬浮面板 - DSH 插件:悬浮显示充值余额,带可视化进度条与动态按钮动画

暂不能直接安装(需源码编译或环境不满足):仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/9/1 · 已提供中文文档
综合分
28.9
GitHub 分
28.9
用户评分
—
★ Stars
1
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add linfengyu94/dsh-balance-panel
仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
信任档位:已验证本站已于 0 天前真实安装成功
是什么
dsh 原生插件 · other
装得上吗
本站已真实安装成功(非静态推断)
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 24 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/19(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-balance-panel(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

仓库 package.json 标记 private,未发布到 npm,需从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/24 00:04:06

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
💰 DeepSeek 充值余额悬浮面板

极简 · 可视化 · 动态动画 | 一眼看清你的 DeepSeek 充值余额

一个运行在 DeepSeek Harness Web GUI 中的轻量悬浮面板插件:悬浮展示你的 DeepSeek 充值余额,带可视化进度条、水位变色与动态按钮动画,可拖动、可折叠、自动刷新,让余额状态一目了然。

🔥 功能特性

- 充值余额查询:官方余额接口实时查询,无需打开平台页面
- 可视化进度条:余额占比一目了然,按水位自动变色(🟢 ≥60% / 🟡 ≥30% / 🔴  进度条填充比例 = 充值余额 ÷ 参考额度(默认 ¥100,可在设置中修改)

✅ 环境要求

- DeepSeek Harness(Web 模式,dsh web)——插件随 web profile 加载
- 无需额外依赖;Host 半面使用 Node 内置全局 fetch 直连官方接口

🚀 快速开始

1. 获取代码:克隆本仓库或下载源码包

git clone https://github.com/linfengyu94/dsh-balance-panel.git

2. 安装插件包到 DSH:把克隆下来的 dsh-balance-panel 目录(即插件包本体)安装到 DSH profiles 的回退目录
($DSH_HOME/profiles/node_modules,Windows 下 $DSH_HOME 默认为 C:\Users\\.dsh)。
以下任选其一:

- 软链接(推荐,改代码即生效):

Windows(junction 无需管理员权限)
New-Item -ItemType Junction -Path "$env:DSH_HOME\profiles\node_modules\dsh-balance-panel" -Target "D:\你的路径\dsh-balance-panel"

macOS / Linux
ln -s /你的路径/dsh-balance-panel ~/.dsh/profiles/node_modules/dsh-balance-panel

- 或直接复制目录:cp -r dsh-balance-panel ~/.dsh/profiles/node_modules/dsh-balance-panel

3. 注册插件行:在 web profile 的补丁层($DSH_HOME/profiles/web/cordis.patch.yml)追加:

- insert:
- id: dsh-balance-panel
name: dsh-balance-panel

4. 重启 dsh web(dsh web)后生效:Host 半面随进程挂载,浏览器半面经 dsh-client-modules 扫描 dsh.client 标记自动加载。

💡 安装并重启后,面板默认出现在页面右上角

📖 使用指南

1. 打开面板「设置」,填入 DeepSeek API Key(登录 platform.deepseek.com → API Keys 创建),点「保存 Key」
2. (可选)修改「参考额度」校准进度条基准(默认 100)
3. 头部「刷新」按钮点击立即刷新;面板每 60 秒自动刷新
4. 按住头部可拖动面板(位置自动记忆),「收起」可折叠为精简条

📂 项目结构

dsh-balance-panel/
├── package.json      # dsh.client 标记 + exports("." → Host 半面,"./client" → 浏览器半面)
├── lib/
│   ├── index.js      # Host 半面:balance / selftest 接口 + /ds-balance/api 本地路由
│   └── client.js     # 浏览器半面:shell.overlay 悬浮面板(内联样式 + 动画样式注入)
├── preview.svg       # README 效果图
├── LICENSE           # MIT 开源许可
└── README.md

⚙️ 原理说明

| 模块 | 说明 |
| --- | --- |
| 数据来源 | 官方余额接口 GET https://api.deepseek.com/user/balance(topped_up_balance) |
| 通信方式 | 浏览器半面通过同源 HTTP 路由 /ds-balance/api 与 Host 半面通信 |
| 网络通道 | 部署未挂载 web fetch provider(防 SSRF),Host 半面用 Node 全局 fetch 直连(与官方 Loader 插件同路径) |
| 安全 | 本地路由仅接受回环地址(127.0.0.1/::1)请求,局域网内他人无法调用 |

🔄 更新

- 拉取最新代码后重启 dsh web 即可生效(若使用软链接安装,无需重新安装)

git pull

❓ 常见问题

Q:为什么显示「API Key 无效」?
余额接口返回 HTTP 401,请检查 Key 是否正确、账户是否有余额查询权限。

Q:进度条比例不对?
进度条基准 = 参考额度,在「设置」中修改即可(例如常充 ¥200 就填 200)。

Q:安装后面板没出现?
确认 patch 行已添加、插件目录在 profiles\node_modules 下且包名可解析;重启 dsh web 后仍未出现,请查看启动日志中的 dsh-balance-panel 行。

🧹 卸载

- 移除 cordis.patch.yml 中 dsh-balance-panel 的 insert 行
- 删除安装时创建的链接或目录(Windows:Remove-Item "$env:DSH_HOME\profiles\node_modules\dsh-balance-panel")
- 重启 dsh 即可;浏览器 localStorage 键 dsh.dsbalance.v1 可手动清除(含 API Key、参考额度、位置)

🤝 贡献

- 欢迎提交 Issue 反馈问题或建议,Pull Request 参与改进
- 反馈问题时请附:DSH 版本、面板显示的错误信息、相关日志

📜 版权与声明

- 本项目基于 MIT License 开源,欢迎自由使用与二次开发
- 插件仅查询官方余额接口,不收集、不上传任何数据;API Key 仅保存在本机浏览器 localStorage
- 界面样式使用 DSH 主题变量,随深浅色主题自动适配

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群