ArcanePivot/dsh-api-balance

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 |
| --- | --- |
| 中文 API 余额、分模型 Token 与峰谷价格 | English API Balance, per-model Token usage, and peak pricing |

查看 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 ""

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 ""

安装后普通刷新一次浏览器即可，不需要清除站点数据或对话记录。自定义端口、PowerShell 执行策略、卸载、升级和常见报错见完整安装手册。

工作方式

浏览器                               DSH 宿主端
POST /api/llm.balance  ----------->  解析 DEEPSEEK_API_KEY
不携带 API Key                       GET {baseURL}/user/balance
读取本机保留的 DSH 会话日志
月份 + 浏览器时区                    仅在宿主内汇总，不请求外部服务
Windows 与 macOS 安装器均在隔离环境跑完预检、安装、卸载、重复卸载、篡改拦截和零残留校验。真实机器仍应先运行 -WhatIf 或 --dry-run。

卸载与升级

Windows：
powershell
.\uninstall.ps1 -WhatIf
.\uninstall.ps1

macOS：
bash
./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 语法及常见密钥和个人路径
bash
./scripts/verify-patches.sh

文档

| 文档 | 内容 |
| --- | --- |
| 完整安装手册 | 下载、安装、重启、验证、卸载、升级和故障排查 |
| 安全说明 | Key 与余额数据流、可信端点和漏洞报告方式 |
| 更新日志 | 发布状态与版本变化 |
| 第三方声明 | DeepSeek Harness 修改产物的来源与许可证 |
| 参与贡献 | 报告问题、提交修改与隐私注意事项 |

项目边界

安装器只覆盖两个已编译文件：宿主余额/用量路由和侧边栏界面。DSH 已提供 sidebar.footer.action 插槽和 Client-to-Host 私有调用机制；后续版本计划迁移到官方扩展点，取消覆盖核心编译文件。

API $$ 是产品显示名称；仓库、安装目录和代码标识继续使用 dsh-api-balance，避免 $ 在命令行中被解释为特殊字符。

许可证

本项目新增代码采用 MIT 许可证。仓库包含的 DeepSeek Harness 修改产物仍保留原始 MIT 许可与版权，见第三方声明。