yingjunnan/dsh-deepseek-quota

dsh-deepseek-quota

一个 DeepSeek Harness (DSH) 网页界面插件：在页面右下角固定的悬浮卡片中显示你剩余的 DeepSeek API 额度（余额） 和 今日消费。

dsh-deepseek-quota 截图

中文文档在前，英文说明见下文。 / 中文文档在前，英文说明见下文。

中文说明

一个给 DeepSeek Harness（DSH）网页界面用的插件：在页面右下角悬浮显示你的 DeepSeek API 额度（余额） 与 今日消费。

功能

- 右下角悬浮卡片（注册在框架级 shell.overlay 槽位，纯叠加、不遮挡应用）。
- 显示总余额、可用状态、当前对话费用、今日已消费、赠送余额与充值余额。
- 当前对话费用：宿主侧对每条 assistant/message 按官方价格表计价（含 2026-08-17 起峰谷定价；定价引擎移植自 dsh-web-billing，MIT），通过 GET /api/deepseek-session-cost?sessionId= 返回当前会话累计费用——按持久化日志全量回放，包含安装前（重启前）的历史。把鼠标放到费用后面的圆圈叹号 ⓘ 上，会显示代入真实数值的计算公式（输入/缓存命中/输出 tokens × 单价 = 小计，单价为加权有效价 ¥/M）。
- 余额每 60 秒自动刷新、对话费用每 5 秒刷新，也可手动刷新。
- 峰谷时段提示：显示当前处于 DeepSeek 的高峰（工作日 09:00–12:00 / 14:00–18:00，北京时间）还是空闲时段（2026-08-17 起；周六、周日全天空闲），让你知道现在跑模型更贵还是更便宜；随余额每 60 秒刷新。
- 可折叠为小钱包图标：点卡头右下角的箭头即可把卡片收成右下角的一个小钱包图标（点击可展开）；折叠态下钱包图标会以颜色标识当前峰谷（高峰=红、空闲=绿、常规=灰）或错误状态，颜色随余额每 60 秒刷新。
- 自动跟随应用浅色/深色主题（使用 --dsw- 设计变量）。
- 明确的错误状态：未配置 Key、网络失败、接口报错等。
- API Key 不出本机：浏览器只访问本地路由（由宿主侧注册）。

安装

需要 pnpm。

已安装 dsh CLI：
dsh plugin --profile web add dsh-deepseek-quota

未安装 dsh CLI（例如通过 npx 启动）：
npx @deepseek-ai/dsh plugin --profile web add dsh-deepseek-quota

该包声明了 dsh.bundle，dsh plugin 会自动把它加进 profile 的 bundle 层（无需手动改配置）。之后：

1. 重启网页应用：dsh web（若无 dsh CLI，用 npx @deepseek-ai/dsh web；bundle 层在启动时读取）。
2. 打开 http://127.0.0.1:3080 并刷新页面。
3. 右下角即出现额度卡片。

手动方式：把包放进 profile 的 node_modules，并在 ~/.dsh/profiles/web/cordis.patch.yml 中加一条：

- insert:
- id: deepseek-quota
name: dsh-deepseek-quota

配置

插件读取的正是 harness 自己在用的那个 Key：DEEPSEEK_API_KEY（通过凭证服务解析；在 设置 → 模型 页面填写，存于 ~/.dsh/.credentials.yaml，或在启动环境中导出）。

今日消费（今日已消费）

DeepSeek 官方 API 没有开放用量查询接口，所以插件按优先级使用两种来源：

1. 官方数据（优先）——与平台控制台相同的可按日期筛选的数据。需要配置可选的平台会话令牌：

获取令牌：登录 https://platform.deepseek.com，打开 DevTools → Console，执行：
JSON.parse(localStorage.getItem('userToken')).value
然后把值写入凭证（例如追加到 ~/.dsh/.credentials.yaml）：
DEEPSEEK_PLATFORM_TOKEN:

配置后，宿主侧调用 platform.deepseek.com/api/v0/usage/cost?month=&year= 并取"今天"那一行。卡片显示 今日已消费 ¥X.XX。

2. 估算（兜底）——未配置令牌时，宿主侧按余额差值估算（max(0, 当天期初余额 − 当前余额)，状态存于 ~/.dsh/storages/deepseek-quota-day.json）。卡片显示 今日约消费 ≈¥X.XX，避免被误认为官方数字。

无需其它配置。

工作原理

| 部分 | 文件 | 作用 |
|---|---|---|
| 宿主侧 | lib/index.js | Cordis 插件（inject: credentials, webServer），注册 GET /api/deepseek-balance（余额+今日消费+当前峰谷计价时段）与 GET /api/deepseek-session-cost?sessionId=（当前对话费用）；订阅 session/event 对每条 assistant/message 计价。 |
| 定价 | lib/pricing.js | DeepSeek 官方价格引擎（政策时间表 + 峰谷定价，周末全天低峰），移植自 dsh-web-billing（MIT）。 |
| 浏览器侧 | lib/client.js | dsh.client 网页包，把组件注册进 shell.overlay；余额每 60 秒轮询（含峰谷时段徽章）、当前会话费用每 5 秒轮询。 |
| 组合层 | cordis.patch.yml | dsh.bundle 补丁层，插入加载项。 |

开发

git clone
cd dsh-deepseek-quota
修改 lib/index.js（宿主）/ lib/client.js（浏览器侧）
本地安装测试：
dsh plugin --profile web add .          # 无 dsh CLI 时：npx @deepseek-ai/dsh plugin --profile web add .

修改 lib/client.js 后需重启 dsh web（无 dsh CLI 时用 npx @deepseek-ai/dsh web）以重新生成引导哈希（rev），再强制刷新页面。

协议

MIT

English

一个用于 DeepSeek Harness（DSH）网页 GUI 的插件，在页面右下角固定的浮动卡片中显示你剩余的 DeepSeek API 配额（余额）。

功能

- 右下角悬浮卡片（注册进框架级的 shell.overlay 插槽——增量式，绝不阻塞应用）。
- 显示总余额、可用性、当前对话费用、今日消耗，以及赠送 / 充值余额。
- 当前对话费用（当前对话费用）：宿主使用 DeepSeek 官方价格表（含自 2026-08-17 起的峰谷定价；定价引擎移植自 dsh-web-billing，MIT）为每条 assistant/message 计价，并通过 GET /api/deepseek-session-cost?sessionId= 报告当前会话的累计费用——整个对话会从其持久化日志中重放，因此该数值包含插件安装之前的历史记录。将鼠标悬停在数值旁带圈的 ⓘ 上，可查看带真实数字的实时公式（输入/缓存命中/输出 tokens × 单价 = 小计，并附有效的混合 ¥/M 费率）。
- 每 60 秒（余额）/ 5 秒（对话费用）自动刷新，另有一个手动刷新按钮。
- 峰谷时段提示（峰谷时段提示）：显示当前时间是否处于 DeepSeek 的高峰（高峰）、空闲（空闲）或常规（常规）定价时段（自 2026-08-17 起，北京时间工作日 09:00–12:00 / 14:00–18:00；周末全天为低峰），让你能判断一次运行会更贵还是更便宜。随余额一起刷新（60 秒）。
- 可折叠为一个小钱包图标：点击卡片标题栏中的箭头，可将卡片折叠为右下角的小钱包图标（点击展开）；在折叠状态下，图标会根据当前峰谷状态（高峰 = 红色，低峰 = 绿色，常规 = 灰色）或错误状态着色，并随余额一起刷新（60 秒）。
- 跟随应用的浅色/深色主题（--dsw- 令牌）。
- 明确的错误状态：缺少 API 密钥、网络故障、提供商错误。
- API 密钥绝不会离开你的机器——浏览器只与宿主半部分注册的本地路由通信。

安装

需要 pnpm。

已安装 dsh CLI 时：
dsh plugin --profile web add dsh-deepseek-quota
未安装 dsh CLI 时（例如通过 npx 运行）：
npx @deepseek-ai/dsh plugin --profile web add dsh-deepseek-quota

该包声明了 dsh.bundle，因此 dsh plugin 会自动将其添加到 profile 的 bundle 层中（无需手动编辑 patch）。然后：

1. 重启 Web 应用：dsh web（或未安装 CLI 时使用 npx @deepseek-ai/dsh web；bundle 层在启动时读取）。
2. 打开 http://127.0.0.1:3080 并刷新页面。
3. 余额卡片会出现在右下角。

手动替代方案：将包安装到 profile 的 node_modules 中，并向 ~/.dsh/profiles/web/cordis.patch.yml 添加一个 loader 条目：

yaml
- insert:
- id: deepseek-quota
name: dsh-deepseek-quota

配置

该插件读取 harness 已经在使用的同一个 API key：DEEPSEEK_API_KEY，通过 credentials 服务解析（在 Settings → Models 页面设置；它存储在 ~/.dsh/.credentials.yaml 中，或在启动环境中导出）。

今日消费（今日已消费）

DeepSeek 官方 API 未提供用量查询端点，因此该组件按顺序使用两个来源：

1. 官方（首选） —— 与平台控制台显示的相同的可按日期筛选的数据。配置可选的平台会话 token：

sh
获取 token：登录 https://platform.deepseek.com，打开 DevTools → Console，运行：
JSON.parse(localStorage.getItem('userToken')).value
然后将其存储为凭据（例如添加到 ~/.dsh/.credentials.yaml）：
DEEPSEEK_PLATFORM_TOKEN:

设置 token 后，宿主会查询 platform.deepseek.com/api/v0/usage/cost?month=&year= 并选取今天的行。卡片显示 今日已消费 ¥X.XX。

2. 估算（回退） —— 没有 token 时，宿主会对余额进行计量（max(0, 当日开盘余额 − 当前余额)），并持久化到 ~/.dsh/storages/deepseek-quota-day.json。卡片显示 今日约消费 ≈¥X.XX，因此绝不会被误认为是官方数字。请注意，官方用量页面也可以筛选为“今天”——平台 token 可解锁同一份数据。

无需其他配置。

工作原理

| 部分 | 文件 | 作用 |
|---|---|---|
| 宿主端 | lib/index.js | Cordis 插件（inject: credentials, webServer），注册 GET /api/deepseek-balance（余额 + 今日消费 + 当前高峰/低谷计价时段）和 GET /api/deepseek-session-cost?sessionId=（当前对话成本）；订阅 session/event 为每条 assistant/message 计价。 |
| 计价 | lib/pricing.js | 官方 DeepSeek 价格表引擎（策略时间线 + 高峰/低谷，周末全天低谷），移植自 dsh-web-billing（MIT）。 |
| 浏览器端 | lib/client.js | dsh.client Web bundle，将组件注册到 shell.overlay；每 60 秒轮询余额（包括高峰/低谷徽标），每 5 秒轮询当前会话的成本。 |
| 组成 | cordis.patch.yml | 插入加载器条目的 dsh.bundle 补丁层。 |

开发
sh
git clone
cd dsh-deepseek-quota
编辑 lib/index.js（宿主端）/ lib/client.js（浏览器端）
本地安装并测试：
dsh plugin --profile web add .          # 不使用 CLI 时：npx @deepseek-ai/dsh plugin --profile web add .

修改 lib/client.js 后，重启 dsh web（或 npx @deepseek-ai/dsh web），以便重新生成启动图哈希（rev），然后强制刷新页面。

许可证

MIT