English | 中文
dsh-session-cost
DeepSeek Harness（dsh）Web 界面的会话花费插件：把当前会话的 DeepSeek API 累计花费显示为输入框旁的一个小徽标。
特性
- 输入框实时花费：在
conversation.input.right 槽位（模型选择器左侧）显示当前会话的 DeepSeek API 花费（¥），每 5 秒刷新。
- 严格模型门槛：仅当会话当前模型为 DeepSeek 时生效；使用其他模型（MiniMax、Kimi 等）时徽标自动隐藏，且非 DeepSeek 模型的请求完全不计价、不进入统计。
- 悬停浮窗：弹出与项目风格一致的浮窗，展示：
- 会话花费明细表格：输入(未命中) / 缓存命中 / 输出 × 数量 × 有效单价 = 金额；
- 今日(DSH) 用量：本机 DSH 会话今日（北京时间）消耗的 DeepSeek 花费；
- 账户余额：读 DSH 凭证中的
DEEPSEEK_API_KEY，经 DeepSeek 官方 user/balance 接口获取。
- 官方计价引擎：按 DeepSeek 官方价格时间表对每条
assistant/message 消息按其发生时刻逐条计价，自动应用 2026-08-17 起的高峰/空闲定价（北京时间 09:00–12:00 / 14:00–18:00 为高峰，其余时段半价），并包含插件安装之前的历史。
- 性能友好：会话日志按 revision 缓存（5 秒轮询 = 一次 stat 比对，不重复解压解析）；今日/余额独立 60 秒节奏。
安装
dsh plugin --profile web add @phynez_1103/dsh-session-cost
⚠️ 注意：本插件的 npm 包名是带 scope 的 @phynez_1103/dsh-session-cost。npm 上的裸名包 dsh-session-cost（ChengChe106/dsh-session-cost）是另一个同名插件，与本仓库无关——dsh plugin add dsh-session-cost 装到的是它，不是本插件。
也可以直接从 GitHub 仓库安装：
dsh plugin --profile web add github:Lzh3070/dsh-session-cost
国内网络可走 Gitee 镜像：
dsh plugin --profile web add https://gitee.com/lzh10602042_gitee/dsh-session-cost/repository/archive/master.zip
装完重启 dsh web 服务，浏览器硬刷新（Ctrl+Shift+R）。
首次使用：设置 → 模型 中需配置 DEEPSEEK_API_KEY（余额与今日统计读取该凭证；未配置时余额显示 --，会话花费不受影响）。
界面
输入框右侧的小徽标（¥0.12），悬停弹出浮窗：
会话花费截图
浮窗内容示例：
当前会话花费 ¥6.55
项目 数量 单价 金额
输入(未命中) 3.5M ¥1.000/M ¥3.49
缓存命中 111.8M ¥0.020/M ¥2.24
输出 410.5K ¥2.00/M ¥0.821
──────────────────────────────
今日(DSH) ¥0.356
账户余额 ¥197.66
价格说明
内置 DeepSeek 官方政策时间表（元 / 百万 tokens）：
| 模型 | 阶段 | 输入(未命中) | 缓存命中 | 输出 |
|---|
| deepseek-v4-flash | 当前价（2026-05-22 起） | 1 | 0.02 | 2 |
| deepseek-v4-flash | 2026-08-17 起·高峰 | 3 | 0.1 | 9 |
| deepseek-v4-flash | 2026-08-17 起·空闲 | 1.5 | 0.05 | 4.5 |
| deepseek-v4-pro | 当前价（2026-05-22 起） | 3 | 0.025 | 6 |
| deepseek-v4-pro | 2026-08-17 起·高峰 | 9 | 0.3 | 27 |
| deepseek-v4-pro | 2026-08-17 起·空闲 | 4.5 | 0.15 | 13.5 |
价格表位于 lib/index.js 的 OFFICIAL_PRICING_POLICIES，官方调价时按 since 时间轴追加条目即可。
结构
cordis.patch.yml inserts the plugin row into the host composition
dsh.plugin.json plugin metadata (entry id + client platform)
lib/index.js host entry: SessionCostRuntime (TypertRemoteService) +
official pricing engine + strict Typert manifest
lib/client.js single-file client bundle (ModuleLoader handshake):
composer cost chip + hover popover (class component)
lib/invariant.js invariants companion entry
数据流
- 宿主
sessionCost(sessionId)：经 sessionPersistence.readRaw 回放会话日志，逐条计价，按日志 revision 缓存。
- 宿主
accountSummary()：回放全部会话统计今日（北京时间）DeepSeek 用量；凭证 DEEPSEEK_API_KEY → 官方 user/balance 取余额。
- 客户端：
conversation.input.right 槽位注册，5s 轮询 + 60s 账户节奏 + 悬停浮窗。
许可
MIT。计价引擎移植自 dsh-deepseek-quota（MIT，其本身移植自 bpc-oss/dsh-web-billing MIT）。
