ArcanePivot/dsh-api-balance
DeepSeek Harness Web UI widget for viewing DeepSeek API balance from the host side.
安装Install
dsh plugin --profile web add github:ArcanePivot/dsh-api-balance把 ArcanePivot/dsh-api-balance 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
API $$
DeepSeek API 余额、分模型 Token 用量与费用估算，常驻 DSH 侧边栏。
不切网页，不把 API Key 交给浏览器，同时看清两款模型在不同时段用了多少、预计花了多少。
简体中文 · English · v0.4.2 · 快速安装 · 完整安装手册 · 安全说明 · 更新日志
[!IMPORTANT]
v0.4.2仅支持@deepseek-ai/dsh@0.1.0-rc.6。这是非官方、版本锁定的补丁包，不是原生 Cordis 插件；安装器遇到其他 DSH 版本或已被修改的目标文件会拒绝执行。
实际效果
| 中文界面 | English UI |
|---|---|
 |
 |
查看 390 px 移动端窄屏效果
截图按实机验收后的 DSH Web UI 制作；余额、用量、费用、时间和会话数量均为演示数据。
为什么装它
| 余额与用量同屏 | Key 留在宿主端 | 随时可以还原 |
|---|---|---|
| 侧边栏常驻当前余额与今日预估费用，点击查看余额明细、本机 Token 用量和每日趋势。 | 浏览器只请求同源 DSH 接口，API Key 不进入网页请求，也不会返回前端。 | 首次安装保存带 SHA-256 的官方原件；成功卸载恢复原件并删除全部安装状态。 |
- 中文常驻显示
API 余额 ¥xx · 今日使用 ¥xx，英文显示API Balance ¥xx · Today ¥xx - 余额低于
20 CNY时显示警示色 - 汇总今日、本周、本月和累计 Token；本周从周一开始
- 可点选
全部 / V4 Flash / V4 Pro，分别查看 Token、调用次数和每日趋势 - 按请求发生时刻套用 DeepSeek 官方人民币单价，估算今日、本周、本月与累计费用
- 可切换查看生效前、空闲和高峰价；当前价档、北京时间高峰区间与官方价格链接均在面板内显示
- 显示今日缓存命中率，以及可切换月份的每日用量柱状图
- 自动回溯本机仍保留的 DSH 会话，并排除分叉会话复制的历史前缀
- 支持手动刷新、点击外部关闭和
Esc关闭 - 兼容缺少
crypto.randomUUID()的 HTTP 与旧版 Safari 环境 - Windows 与 macOS 都有安装、卸载和重启辅助脚本
快速安装
1. 准备 DSH 和 API Key
本补丁只识别 npm 全局安装的指定版本；只用 npx 临时启动 DSH 时，安装器无法定位目标文件。
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
启动 DSH 后，可在 设置 -> 模型 的 DeepSeek 卡片中保存 API Key；也可以让 DSH 进程从环境变量 DEEPSEEK_API_KEY 读取。
2. 获取项目
git clone --branch v0.4.2 --depth 1 https://github.com/ArcanePivot/dsh-api-balance.git
cd dsh-api-balance
也可以从 v0.4.2 发布页 下载源码包并在解压目录中执行下列命令。固定版本可以避免以后 main 更新时意外安装尚未发布的代码。
3A. Windows
.\install.ps1 -WhatIf # 先检查版本、文件和备份条件，不修改任何内容
.\install.ps1 # 备份官方原件、安装并复核 SHA-256
.\relaunch-dsh-web.ps1 # 重启默认 127.0.0.1:3080 的手动 DSH 进程
若 DSH 由计划任务管理，请重启原任务，保留它已有的环境变量、权限和后台窗口设置：
.\relaunch-dsh-web.ps1 -TaskName "<你的 DSH 计划任务名>"
3B. macOS
./install.sh --dry-run # 先检查，不修改
./install.sh # 备份官方原件、安装并复核 SHA-256
./relaunch-dsh-web.sh # 重启默认 127.0.0.1:3080 的手动 DSH 进程
若 DSH 由 launchd 管理，请重启原服务：
./relaunch-dsh-web.sh --launchd-label "<你的 launchd label>"
安装后普通刷新一次浏览器即可，不需要清除站点数据或对话记录。自定义端口、PowerShell 执行策略、卸载、升级和常见报错见完整安装手册。
工作方式
浏览器 DSH 宿主端
POST /api/llm.balance -----------> 解析 DEEPSEEK_API_KEY
不携带 API Key GET {baseURL}/user/balance
<------------- 返回规范化余额字段
POST /api/llm.usage -----------> 读取本机保留的 DSH 会话日志
月份 + 浏览器时区 仅在宿主内汇总，不请求外部服务
<------------- 返回分模型 Token、费用估算、日期与覆盖范围
宿主端从 llm-deepseek 设置和 DSH 凭据服务读取 baseURL、apiKeyEnv 与 API Key。若配置了自定义 baseURL，密钥会发送到该地址，这与 DSH DeepSeek 模型适配器的行为一致；只应使用可信端点。
用量统计采用浏览器时区归日；本周从周一零点开始。模型来自每次 DSH 回复的真实来源字段。费用把缓存命中、缓存未命中和输出 Token 分开，按请求实际发生时刻匹配DeepSeek 官方人民币价格：北京时间 2026-08-17 00:00 前使用旧价，之后高峰为 09:00–12:00、14:00–18:00，其余为空闲价。
这些数字只覆盖本机仍保留的 DSH 会话，不包含已删除日志、其他客户端的调用，也不是 DeepSeek 官方账单。价格可能变化，项目使用带来源日期的版本化价格表；最终扣费始终以官方账单为准。侧边栏展开后会在后台回溯现存会话，以便显示今日预估费用；当前 DSH 进程内会缓存未变化会话的汇总结果。
余额与用量都属于账户信息。任何能访问该 DSH Web UI 的人都能看到这些汇总，但看不到 API Key、提示词或回复正文。请继续用原有访问控制保护 DSH Web UI，详见安全说明。
兼容性
| 项目 | 支持范围 |
|---|---|
| DSH | 仅 0.1.0-rc.6 |
| Windows | Windows 10 / 11；Windows PowerShell 5.1 或 PowerShell 7 |
| macOS | macOS 自带 Bash 3.2 或更新版本；Node.js 与 npm 必须可用 |
| 界面语言 | 简体中文、英文 |
| Windows 实机验收 | Windows 10、Node 24、DSH 0.1.0-rc.6 |
| macOS 生命周期验收 | macOS Bash 3.2、Node 22、隔离的官方 rc.6 npm 文件副本 |
Windows 与 macOS 安装器均在隔离环境跑完预检、安装、卸载、重复卸载、篡改拦截和零残留校验。真实机器仍应先运行
-WhatIf或--dry-run。
卸载与升级
Windows：
.\uninstall.ps1 -WhatIf
.\uninstall.ps1
macOS：
./uninstall.sh --dry-run
./uninstall.sh
成功卸载会把两份 DSH 文件恢复到安装前的 SHA-256，并删除项目创建的 backup/ 或 backup-macos/ 及校验清单。随后必须重启原 DSH 进程，才能清除内存中已加载的旧代码。源码目录是用户自行下载的安装介质，脚本不会冒险自删；确认不再需要后可正常删除整个源码目录。
升级 DSH 前必须先卸载本补丁、恢复官方文件。不要把旧补丁重新套到新版本 DSH 上；等待本项目发布匹配的新版本。
从 API $$ v0.2.0、v0.3.0、v0.4.0-rc.1、v0.4.0 或 v0.4.1 升级时，推荐在原安装目录切换到 v0.4.2 后重跑安装器，这样能复用经过校验的官方备份；运行文件已相同时只会提升备份清单版本。使用全新目录时应先用旧目录卸载。完整步骤见安装手册。
验证
持续集成与本地验证会：
- 从 npm 获取官方
0.1.0-rc.6包 - 验证两个最小补丁可以干净应用
- 验证“官方文件 + 补丁”与
files/中完整文件逐字节一致 - 运行跨会话用量与费用测试：模型拆分、涨价生效点、峰谷边界、周一周界、时区、闰年、缓存和分叉去重
- 跑完 Windows 与 macOS 安装、幂等、卸载、回滚、篡改拦截和零残留测试
- 检查 Bash、PowerShell、JavaScript 语法及常见密钥和个人路径
./scripts/verify-patches.sh
文档
| 文档 | 内容 |
|---|---|
| 完整安装手册 | 下载、安装、重启、验证、卸载、升级和故障排查 |
| 安全说明 | Key 与余额数据流、可信端点和漏洞报告方式 |
| 更新日志 | 发布状态与版本变化 |
| 第三方声明 | DeepSeek Harness 修改产物的来源与许可证 |
| 参与贡献 | 报告问题、提交修改与隐私注意事项 |
项目边界
安装器只覆盖两个已编译文件：宿主余额/用量路由和侧边栏界面。DSH 已提供 sidebar.footer.action 插槽和 Client-to-Host 私有调用机制；后续版本计划迁移到官方扩展点，取消覆盖核心编译文件。
API $$ 是产品显示名称；仓库、安装目录和代码标识继续使用 dsh-api-balance，避免 $ 在命令行中被解释为特殊字符。
许可证
本项目新增代码采用 MIT 许可证。仓库包含的 DeepSeek Harness 修改产物仍保留原始 MIT 许可与版权，见第三方声明。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…