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 移动端窄屏效果

API $$ 在 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 许可与版权，见第三方声明。

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 移动端窄屏效果

API $$ 在 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、费用估算、日期与覆盖范围

兼容性

项目	支持范围
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 前必须先卸载本补丁、恢复官方文件。不要把旧补丁重新套到新版本 DSH 上；等待本项目发布匹配的新版本。

验证

持续集成与本地验证会：

从 npm 获取官方 0.1.0-rc.6 包
验证两个最小补丁可以干净应用
验证“官方文件 + 补丁”与 files/ 中完整文件逐字节一致
运行跨会话用量与费用测试：模型拆分、涨价生效点、峰谷边界、周一周界、时区、闰年、缓存和分叉去重
跑完 Windows 与 macOS 安装、幂等、卸载、回滚、篡改拦截和零残留测试
检查 Bash、PowerShell、JavaScript 语法及常见密钥和个人路径

./scripts/verify-patches.sh

文档

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

项目边界

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

许可证

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

dsh-api-balance

API $$

实际效果

为什么装它

快速安装

1. 准备 DSH 和 API Key

2. 获取项目

3A. Windows

3B. macOS

工作方式

兼容性

卸载与升级

验证

文档

项目边界

许可证

Community comments

dsh-api-balance

API $$

实际效果

为什么装它

快速安装

1. 准备 DSH 和 API Key

2. 获取项目

3A. Windows

3B. macOS

工作方式

兼容性

卸载与升级

验证

文档

项目边界

许可证

Community comments