前言¶
DSH 的理念是“一切皆插件”。在 DSH web 中调用 DeepSeek API 时，当前会话花了多少、今天累计多少、账户还剩多少，通常分散在不同位置。bobcat848/dsh-calculator 解决的是这个显示问题：把 DeepSeek API 费用和账户余额放在 DSH web GUI 右上角的浮层卡片里，并且可以折叠成胶囊。
这是什么¶
下面介绍 bobcat848/dsh-calculator。
- 维护者：
bobcat848 - 许可证：
MIT - 当前版本：
1.3.4 - 定位：一个 DSH web 插件，在 DSH web GUI 右上角显示 DeepSeek API 费用和账户余额，可折叠为胶囊。
核心功能¶
- 在 DSH web GUI 右上角显示 DeepSeek API 费用卡片，点击
×可折叠为胶囊，点击胶囊可展开。 - 显示当前会话费用，按模型展示。
- 显示当天全部会话累计费用，按模型展示；按本地时区计算，当地午夜重置。
- 显示 DeepSeek API 账户余额，通过
GET /user/balance获取，30 秒缓存。 - 只对
deepseek-official路由计费，其他provider/model显示为未计费。 - 按北京峰谷计价；2026-08-23 起，周六、周日全天按半价计费。
- 跟随浏览器语言提供中英文界面（
zh/en）。
安装与启用¶
安装会写入插件目录：
~/.dsh/profiles/node_modules/dsh-calculator
并追加 loader 行到：
~/.dsh/profiles/web/cordis.patch.yml
macOS / Linux¶
在线安装：
curl -fsSL https://raw.githubusercontent.com/bobcat848/dsh-calculator/main/install.sh | bash
Windows PowerShell¶
在线安装：
irm https://raw.githubusercontent.com/bobcat848/dsh-calculator/main/install.ps1 | iex
本地克隆安装¶
先克隆仓库：
git clone https://github.com/bobcat848/dsh-calculator.git
进入仓库后，运行本地安装脚本：
bash install.sh
Windows PowerShell 中使用：
.\install.ps1
重启并查看¶
安装后执行以下命令重启 DSH web：
dsh web --port 3080
cordis.patch.yml 改动通常可通过 HMR 热更新。
打开或刷新：
http://127.0.0.1:3080
在右上角查看费用卡片。点击 × 折叠为胶囊，点击胶囊展开。
缺少 API key 时的行为¶
插件需要 DeepSeek API key，不需要额外配置。如果缺少 key，余额卡片会显示友好错误，费用面板继续工作。
卸载¶
删除插件目录：
rm -rf ~/.dsh/profiles/node_modules/dsh-calculator
并从：
~/.dsh/profiles/web/cordis.patch.yml
删除对应 insert 行。
适用场景与注意¶
适合在 DSH web 中使用 DeepSeek API，并希望在一个位置查看会话费用、当天累计费用和账户余额的开发者。
需要注意：
- 费用为估算值，与官方账单可能存在差异。
- 插件以当前
dsh进程权限运行；安装前应检查源码与许可证。 v1.2.0+只兼容提供shell.overlay插槽的 DSH 版本；旧版 DSH（含aside插槽）请使用v1.1.x。z-index修复将[data-shell-overlay]设置为z-index:60，低于模态/弹层。- 浏览器实测范围：
Chrome 151（Chromium）；Safari/Firefox 未验证。 - 社区目录是独立站点，与 DeepSeek 官方无从属关系。
- 本项目与 DeepSeek 官方无任何关联。
链接¶
社区目录：
https://www.skillhub.cn/plugins/bobcat848/dsh-calculator
GitHub：
https://github.com/bobcat848/dsh-calculator
