@cassius0924/dsh-usage-dashboard 0.4.0 → 0.6.0

package/README.md

@@ -4,7 +4,7 @@
 [![license](https://img.shields.io/npm/l/@cassius0924/dsh-usage-dashboard?color=blue)](./LICENSE)
 
 在 [DSH](https://github.com/deepseek-ai)（DeepSeek Harness）的 Web GUI 里，随时看得见 DeepSeek 的钱花在哪：
-**余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少，以及 2026-08-17 峰谷定价之后账单会变成什么样。**
+**余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少、钱里有多少来自图片**，以及峰谷定价生效后把任务挪到闲时能省多少。
 
 ![dsh-usage-dashboard](docs/hero.png)
 
@@ -23,7 +23,8 @@
 | 今天花了多少？这个月呢？ | 只有「累计」，没有时间感 |
 | 钱花在哪个模型上？ | 不知道 |
 | 缓存到底帮我省了多少？ | 完全看不到 |
-| 8-17 涨价后我的账单会变成多少？ | 只能自己算 |
+| 钱里有多少来自图片？ | 多模态模型上线后更是看不见 |
+| 高峰时段多付了多少？ | 只能自己算 |
 
 这个插件把这些问题逐个翻译成一眼能看懂的数字。**费用全部为估算**，算法与单价公开可查（见[费用是怎么算的](#费用是怎么算的)）。
 
@@ -59,13 +60,13 @@
 
 展开**计价说明**能看到费用估算实际套用的单价表——估算不该是个黑箱。
 
-### 涨价之后会变成多少
+### 高峰时段多付了多少
 
 <img src="docs/peak.png" width="860" alt="高峰 / 闲时分布">
 
 DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00–12:00、14:00–18:00）价格是闲时的两倍。
 
-这张卡告诉你用量落在峰谷两侧的比例，并且**在新价生效前就把账单重算一遍**：上图这份用量现价 ¥14.64，新价下是 ¥45.84（+213%）。生效之后，这里会换成「把高峰用量挪到闲时能省多少」。
+这张卡告诉你用量落在峰谷两侧的比例，以及**如果高峰用量都挪到闲时能省多少**——批量、可延后的任务放到闲时跑，同样的 token 只要一半的钱。
 
 ### 缓存替你省了多少
 
@@ -75,6 +76,16 @@ DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00
 
 命中率掉到 60% 以下时，文案会换成怎么把它救回来的建议。
 
+### 钱里有多少来自图片
+
+> 截图待补拍：当前机器没有真实图片用量时，卡片显示的是空态，以下先以文字说明功能。
+
+`deepseek-v4-flash-vision-exp` 上线后，图片按尺寸折算成 token 与文本一并计费，但「看了一堆截图」和「纯文本」在账单里长得一模一样。
+
+这张卡重放会话日志时顺手数出图片：用户消息里的附件和 tool result 里的截图都会统计（不用读附件本体，日志里就有宽高）。每组数字给出**图片张数、按官方换算规则估算的 token 与费用，以及占窗口输入 / 费用的比例**，旁边是每天图片数的趋势和「图片最多的会话」排行——一个不停刷截图的循环会话，在这里一眼就能认出来。
+
+图片归属到随后一次模型调用，按该调用的时段与模型单价估算；实际 token 数以接口返回的用量为准。
+
 ### 钱花在哪个模型上
 
 <img src="docs/models.png" width="860" alt="模型成本排行">
@@ -129,23 +140,30 @@ dsh plugin --profile web add ./path/to/dsh-usage-dashboard
 
 装好后打开 GUI，**进入任意一个会话**（「额度」tab 挂在 `conversation.view` 上，New Session 首页没有 tab 栏），顶部就能看到 `Chat / Trajectory / 额度`。
 
+> 兼容性：同时支持两代宿主接口——旧版 `readFrom(id, 0)` 与新版 handle 化 `open(id, 'read')` / `read` / `close`。
+> 宿主升级到移除 `readFrom` 的版本后，插件无需更换版本，会话日志照常重放。
+
 ## 费用是怎么算的
 
 费用是**估算**，不是账单。规则都在 [`src/pricing.ts`](src/pricing.ts) 一个文件里：
 
-- 逐条用量记录按「**模型** + **是否落在高峰时段**」计价，而不是全局一套价。
-- 2026-08-17 00:00（北京时间）之前的记录按旧的固定价；之后按峰谷价，闲时为高峰的一半。
+- 逐条用量记录按「**模型** + **是否落在高峰时段** + **当时的价目表**」计价，而不是全局一套价。
+- 2026-08-17 00:00（北京时间）之前按旧的固定价；之后按峰谷价，闲时为高峰的一半。
+- 2026-09-10 12:00 起 Flash 系列降价（V4.1-Flash），高峰时段同时收紧为**周一至周五**。
+- 2026-09-14 12:00 起 `deepseek-v4-pro` 的请求由 V4.1-Flash 承接，按 Flash 价计费。
 - 高峰时段按**北京时间**判定，不随机器时区漂移。
 - 未识别的模型按 `deepseek-v4-pro`（较贵的一侧）计价。
 
-单价（CNY / 百万 tokens）：
+单价（CNY / 百万 tokens，与官方价目表的两档一致）：
 
 | 模型 | 时段 | 输入·缓存命中 | 输入·未命中 | 输出 |
 |---|---|---|---|---|
-| deepseek-v4-pro | 08-17 前固定 | 0.025 | 3 | 6 |
+| deepseek-flash | 高峰 / 闲时 | 0.04 / 0.02 | 2 / 1 | 8 / 4 |
 | deepseek-v4-pro | 高峰 / 闲时 | 0.3 / 0.15 | 9 / 4.5 | 27 / 13.5 |
-| deepseek-v4-flash | 08-17 前固定 | 0.02 | 1 | 2 |
-| deepseek-v4-flash | 高峰 / 闲时 | 0.1 / 0.05 | 3 / 1.5 | 9 / 4.5 |
+
+`deepseek-v4-flash`、`deepseek-v4-flash-vision-exp` 是旧模型名，现由 `deepseek-flash` 承接、按 Flash 价计费；2026-09-14 12:00 起 `deepseek-v4-pro` 的请求也路由到 V4.1-Flash，按 Flash 价计费。历史各时期单价：08-17 前 pro 0.025/3/6、flash 0.02/1/2；08-17 – 09-10 12:00 的 flash 高峰 0.1/3/9、闲时 0.05/1.5/4.5。
+
+图片不另外收费，而是按尺寸折算成 token 与文本一并计费：官方规则是先把图片按比例缩放到 ~800×800（小于 ~384×384 的放大），token 与缩放后面积成正比、每张上限 384 tokens。多模态卡的估算就套这条规则。
 
 DeepSeek 再调价时，只改这张表。
 
@@ -192,6 +210,7 @@ src/
 
 - 用量数据来自**本机** DSH 会话日志，不含其它机器/账户的用量。
 - 费用是估算：不含 DeepSeek 侧的折扣、赠金消耗顺序等因素，以官方账单为准。
+- 图片 token 按官方换算规则估算，且把图片归属到随后一次模型调用；若缺少图片宽高或图片后没有成功的调用，则不纳入估算（无调用即无计费）。
 - 首次加载用量需要重放全部会话日志（本机实测约 5 秒），因此有 5 分钟的服务端记忆化；界面在此期间显示骨架屏。
 
 ## License