bobcat848/dsh-calculator

dsh-calculator

一个 DeepSeek Harness (DSH) Web 插件，在 DSH Web GUI 右上角的浮动卡片中显示你的 DeepSeek API 花费 和
账户余额
（可折叠为胶囊）。

- 当前会话费用 — 你正在查看的会话的费用（按模型）
- 当天全部会话累计 — 当天所有会话的总花费（按模型，
使用你的本地时区；在本地午夜重置）
- 胶囊实时费用 — 折叠后的胶囊实时显示当天总花费
- 账户余额 — 来自 DeepSeek API 的实时余额（GET /user/balance）
- 第三方模型不计费 — 仅 DeepSeek 官方路由（deepseek-official
与视觉专用 deepseek-vision）计费；任何其他提供商/模型
均列为不计费
- 峰谷计价 — 按北京峰谷时段表对事件计价（高峰
09:00–12:00 与 14:00–18:00，低谷 = 半价）；2026-08-17 之前的事件
仍按当时的统一费率计费
- 中英文界面 — 面板跟随你的浏览器语言（zh / en）

安装

DSH 是一个 Cordis 应用。该插件包含宿主半部分（事件记账 +
余额获取）和浏览器半部分（右上角浮层卡片）。将其安装到
web 配置中：

一条命令在线安装（推荐，无需克隆仓库）

直接在你的机器上执行（脚本会从 GitHub 下载插件文件并完成安装）：

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
cd dsh-calculator

macOS / Linux
bash install.sh

Windows PowerShell
.\install.ps1

两种方式等价：都会把插件装进
~/.dsh/profiles/node_modules/dsh-calculator 并在
~/.dsh/profiles/web/cordis.patch.yml 追加 loader 行（幂等：重复执行安全，
已有行不会重复添加）。

手动安装

1. copy the package into the profile's hoisted node_modules
mkdir -p ~/.dsh/profiles/node_modules/dsh-calculator
cp -r lib package.json ~/.dsh/profiles/node_modules/dsh-calculator/

2. append the loader row to the web profile patch (once)
edit ~/.dsh/profiles/web/cordis.patch.yml and add:
- insert:
- id: dsh-calculator
name: 'dsh-calculator'
config: {}

重启生效

Plugins are discovered at boot, so restart DSH web after installing
（cordis.patch.yml 改动也会被 DSH 的用户层 HMR 热更新，通常无需重启）：

dsh web --port 3080

打开（或刷新）http://127.0.0.1:3080，你应该会看到
右上角的 DeepSeek API 费用 卡片；点击 × 将其折叠
为胶囊，点击胶囊可再次展开。

v1.2.0 适配说明：DSH 0.1.0-rc.6 的布局不再提供 aside 插槽（右侧栏），
浏览器半改为注入框架级 shell.overlay 插槽（右上角浮层卡片），并移除了
不存在的 ctx.layout.closeAside()。host 半（记账 + 余额端点
/dsh-calculator）保持不变。

配置

该插件除了你的 DeepSeek API 密钥外无需任何配置，DSH
已通过其凭据服务存储该密钥（Models 页面会将其写入
~/.dsh/.credentials.yaml 作为 DEEPSEEK_API_KEY，或者你可以在
启动环境）。余额功能读取同一凭据。

如果密钥缺失，余额卡片会显示友好的错误提示，费用面板仍可正常工作。

计价口径

费率为 DeepSeek 官方价格（人民币元 / 每 1M tokens）。自 2026-08-17
起适用高峰/低谷时段表（高峰 09:00–12:00 与 14:00–18:00 北京时间；
低谷 = 高峰价格的一半）。自北京时间 2026-08-23 00:00 起，高峰
时段仅适用于周一至周五；周六和周日全天为低谷（半价）：

| 模型 | 缓存命中输入（高峰/半价） | 缓存未命中输入（高峰/半价） | 输出（高峰/半价） |
|---|---|---|---|
| deepseek-v4-flash | ¥0.10 / ¥0.05 | ¥3.0 / ¥1.5 | ¥9.0 / ¥4.5 |
| deepseek-v4-pro | ¥0.30 / ¥0.15 | ¥9.0 / ¥4.5 | ¥27.0 / ¥13.5 |
| deepseek-v4-flash-vision-exp | ¥0.10 / ¥0.05 | ¥3.0 / ¥1.5 | ¥9.0 / ¥4.5 |

- 2026-08-17 之前的会话事件按当时费率计费（flash ¥0.02 / ¥1.0 / ¥2.0，pro
¥0.025 / ¥3.0 / ¥6.0）
- 2026-08-23 00:00 起，周六、周日全天按半价（低谷价）计费；周末高峰
时段不再区分，2026-08-23 之前的周末仍按当时的高峰/空闲时段计费
- 输出 token 包含推理 token，与普通输出同价
- 费用为估算值，与官方账单可能存在差异（缓存命中 token 量大时尤其明显）

2026-09-10 起 flash 系列降价（v1.4.1）

北京时间 2026-09-10 12:00 起，flash 系列（含 deepseek-v4-flash-vision-exp）
按新价计费（高峰 = 空闲 ×2）；pro 系列本次未调整，仍按上表价格：

| flash 时段 | 缓存命中输入 | 缓存未命中输入 | 输出 |
|---|---|---|---|
| 高峰（周一至五 9–12 / 14–18） | ¥0.04 | ¥2.0 | ¥8.0 |
| 空闲（其余时间，含周末全天） | ¥0.02 | ¥1.0 | ¥4.0 |

2026-09-10 12:00 之前的 flash 事件仍按上一时段费率（¥0.10/¥0.05 命中、
¥3.0/¥1.5 未命中、¥9.0/¥4.5 输出）；当天中午 12:00 前后分界，上午旧价、
下午新价各自独立记账，不会混算。周末空闲规则不变（高峰窗口仍仅周一至周五）。

数据来源

- 费用：host 半订阅 DSH 会话事件（assistant/message 的 usage +
message.source），按 (provider, model) 记账；fork 子会话的拷贝事件按
message.id 全局去重，避免重复计费
- 余额：GET https://api.deepseek.com/user/balance（30 秒缓存）

已知问题与兼容性

层叠上下文（z-index）遮挡 — v1.2.2 修复

现象：费用卡片标题栏的 × 关闭按钮被右侧文件面板的搜索框遮住，不可见、
不可点，卡片无法折叠为胶囊（issue #1）。

根因（层叠上下文问题，非渲染 bug）：

- 插件挂载进框架的 shell.overlay 挂载层 [data-shell-overlay]
（.pI_x6G_overlayLayer），DSH rc.6 将该层写死为
position: absolute; z-index: 20
- 右侧文件面板列（第三方组件，如 aionui-explorer-col）为
position: static; z-index: 30 —— 作为同级的 flex 子项，z-index 依然参与
层叠比较，且 30 > 20
- 卡片自身的 z-index: 1200 只在挂载层内部的层叠上下文生效，无法越过
同为 pI_x6G_frame 子级的文件面板 —— 于是搜索框压住了卡片的 × 按钮

修复：插件 CSS 注入一条规则，把挂载层提到 60：

html [data-shell-overlay]{z-index:60}

- 用框架的稳定属性选择器 [data-shell-overlay]，不依赖哈希类名；
特异性 0-1-1 高于框架类选择器的 0-1-0，无需 !important
- 为什么是 60：> 30（文件面板）解决遮挡；< 100（DSH 模态/弹层）不抢
模态层级，弹窗、命令面板（z-index: 1000）仍能正常盖住卡片
- 纯 CSS，无需 DOM 轮询 workaround

后续注意：

- 若 DSH 未来调整布局 z-index 层级，或引入 z-index ≥ 60 的常驻面板，需要
重新评估该值（在 30 ~ 100 区间内调整即可，不要超过 100 以免盖住模态层）
- 其他第三方右侧面板若 z-index 高于 60，同样会遮挡卡片；可把 60 调大
（仍建议 < 100）

布局接口版本 — v1.2.0 起

- DSH 0.1.0-rc.6 的布局不再提供 aside 插槽（右侧栏），浏览器半从
v1.2.0 起改为注入框架级 shell.overlay 插槽（右上角浮层卡片，可折叠），
并移除了已不存在的 ctx.layout.closeAside()
- v1.2.0+ 只兼容有 shell.overlay 插槽的 DSH 版本；旧版 DSH（含
aside 插槽）请使用 v1.1.x
- 若升级 DSH 大版本后卡片消失，先检查布局是否仍提供 shell.overlay

浏览器实测范围
- 实测：Chrome 151（Chromium）。Edge 同为 Chromium 内核，预计行为一致，
未逐一实测；Safari / Firefox 未验证，如遇样式问题请反馈

卸载

rm -rf ~/.dsh/profiles/node_modules/dsh-calculator
并从 ~/.dsh/profiles/web/cordis.patch.yml 删除对应 insert 行

免责声明

本项目与 DeepSeek 官方无任何关联，价格与余额为接口实时数据，费用为估算。