@cassius0924/dsh-usage-dashboard 0.8.3 → 0.9.1

package/README.md

@@ -5,13 +5,11 @@
 
 在 [DSH](https://github.com/deepseek-ai)（DeepSeek Harness）的 Web GUI 里，随时看得见 DeepSeek 的钱花在哪：
 **余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少、钱里有多少来自图片**，以及峰谷定价生效后把任务挪到闲时能省多少。
-还能给某个会话开**高峰暂停**：高峰时段自动暂停这个会话，18:00 后继续，不用你自己盯着时钟。
 
 ![dsh-usage-dashboard](docs/hero.png)
 
 装上之后 GUI 里多两样东西：右下角一个可拖动的**悬浮额度窗**，顶部栏多一个**「额度」tab**。
-还能在「额度 → 设置」里加一个**侧边栏额度入口**（顶部或底部，点开账号级额度页）、**拖动调整「额度」tab 的位置**，
-以及在对话输入框旁给本会话开启**高峰暂停**（见[高峰暂停](#高峰暂停到点自动停1800-继续)）。
+还能在「额度 → 设置」里加一个**侧边栏额度入口**（顶部或底部，点开账号级额度页）、**拖动调整「额度」tab 的位置**。
 额度页会收起聊天输入框，把整屏留给数据；「图片 / 多模态用量」并入用量趋势卡，切换 7 天 / 30 天 / 90 天 / 1 年
 时随图片有无平滑展开或收起。界面支持简体中文与 English，直接跟随 DSH 全局的「Settings → Language」设置；
 切换无需刷新，选择由 DSH 持久化。
@@ -67,56 +65,23 @@
 
 ### 高峰时段多付了多少
 
-<img src="docs/peak.png" width="860" alt="高峰 / 闲时分布">
+<img src="docs/peak.png" width="400" alt="高峰 / 闲时分布">
 
 DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00–12:00、14:00–18:00）价格是闲时的两倍。
 
 这张卡告诉你用量落在峰谷两侧的比例，以及**如果高峰用量都挪到闲时能省多少**——批量、可延后的任务放到闲时跑，同样的 token 只要一半的钱。
 
-### 高峰暂停：到点自动停，18:00 继续
-
-光看见「高峰多付了多少」还不够，这里还替你按下了暂停——而且是**按会话**控制的：
-对话输入框旁多一个「高峰暂停」开关（和「会话统计」「Token 用量」「会话费用」同一排）。
-开启后，这个会话里**你发起的回合**在 DeepSeek 高峰时段（北京时间周一至周五 09:00–12:00、14:00–18:00）
-走到步骤边界就会暂停，**18:00 自动继续**；12:00–14:00 的午间闲时也继续暂停，不来回折腾。
-
-开关三态一眼可辨：
-
-| 状态 | 开关显示 | 含义 |
-|---|---|---|
-| 关闭 | 描边图标 +「高峰暂停 · 关」 | 本会话不暂停 |
-| 开启 | 实心图标 + 主色 +「高峰暂停 · 开」 | 高峰时段会暂停本会话 |
-| 正在暂停 | 实心图标 + 警示色 +「已暂停 · 18:00」 | 本回合已停在步骤边界，18:00 继续 |
-
-<img src="docs/breaker-states.png" width="260" alt="高峰暂停开关三态">
-
-
-- 只对**普通会话**开放：定时任务、自动化任务、目标续跑这类自动触发的回合不受影响，没开启的会话也完全不受影响。
-- 额度页「设置」里有一个**总开关**：关掉后所有会话都不再暂停（每个会话自己的开关会保留）。
-- 额度页还有一张**「高峰暂停」**卡，管理所有已开启的会话：标题、是否正在暂停、单独关闭，
-  以及有挂起时的「立即全部继续」。没有任何会话开启时，卡片显示空态并提示去对话里打开。
-
-<img src="docs/breaker.png" width="720" alt="高峰暂停">
-
-几个边界：
-
-- 挂起发生在**步骤与步骤之间**，已经发出的模型调用不会被中断；被挂起的会话在 GUI 里仍显示「运行中」，
-  你可以随时手动停止。
-- 开关状态由宿主侧保存（`~/.dsh/storages/dsh-usage-dashboard/breaker.json`，存总开关和已开启的会话 id），
-  刷新页面、重启宿主后都还在。
-- 高峰暂停只管「什么时候跑」，不改变峰谷单价，也不会替你重算已发生的历史费用。
-
 ### 缓存替你省了多少
 
-<img src="docs/cache.png" width="860" alt="缓存命中与节省">
+<img src="docs/cache.png" width="400" alt="缓存命中与节省">
 
-前缀缓存的命中价只有未命中价的百分之一量级，是 DSH 这类高重复 prompt 负载上**最大的省钱杠杆**——上图这份用量实付 ¥14.64，缓存省下了 ¥458.15。
+前缀缓存的命中价只有未命中价的百分之一量级，是 DSH 这类高重复 prompt 负载上**最大的省钱杠杆**——上图这份用量实付 ¥50.61，缓存省下了 ¥1,220.87。
 
 命中率掉到 60% 以下时，文案会换成怎么把它救回来的建议。
 
 ### 钱里有多少来自图片
 
-> 截图待补拍：当前机器没有真实图片用量时，卡片显示的是空态，以下先以文字说明功能。
+<img src="docs/vision.png" width="860" alt="图片 / 多模态用量">
 
 `deepseek-v4-flash-vision-exp` 上线后，图片按尺寸折算成 token 与文本一并计费，但「看了一堆截图」和「纯文本」在账单里长得一模一样。
 
@@ -134,15 +99,19 @@ DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00
 
 <img src="docs/sessions.png" width="860" alt="会话成本排行">
 
-按模型、按天的视图告诉你「花在什么上」和「什么时候花的」；这张告诉你**是哪一次跑掉的**——对 agent 用户来说，这是唯一能直接动手改的东西：一个特别贵的会话，通常意味着一段值得看看的 prompt 或一个没收住的循环。上图里一个会话就占了总花费的 77.8%。
+按模型、按天的视图告诉你「花在什么上」和「什么时候花的」；这张告诉你**是哪一次跑掉的**——对 agent 用户来说，这是唯一能直接动手改的东西：一个特别贵的会话，通常意味着一段值得看看的 prompt 或一个没收住的循环。上图里最贵的会话占了近 30 天总花费的 24.4%，前 6 个会话合起来约 65%。
 
 会话标题直接从会话日志里读（`session/title` 事件），跟用量重放搭同一趟车，不额外读盘。
 
 ### 用量的时间分布
 
-<img src="docs/charts.png" width="860" alt="逐天柱状图与热力图">
+<img src="docs/charts.png" width="860" alt="逐天用量柱状图">
+
+近 30 天逐天、0–23 点逐小时（可按模型多选过滤，叠成分组柱状图）；逐天/逐小时切换、周期与指标都在这张卡上。hover 立刻出 tooltip，不用等系统那一秒。
 
-近 30 天逐天、0–23 点逐小时（可按模型多选过滤，叠成分组柱状图），外加近 12 周热力图。hover 立刻出 tooltip，不用等系统那一秒。
+<img src="docs/heatmap.png" width="860" alt="近一年用量热力图">
+
+热力图单独成卡，覆盖近一年每一天：一眼看出长期的使用节奏，而不是只看最近几周。
 
 ### 余额预警
 
@@ -150,11 +119,9 @@ DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00
 
 在「设置」里定一条预警线（默认 ¥10，填 0 关闭）。跌破时仪表盘顶部出现警示条——带上还能撑几天和充值入口——同时悬浮窗一起转警示色，两边不会各说各话：
 
-<img src="docs/alert.png" width="860" alt="余额低预警警示条">
-
 余额低于 ¥10、或跌破设置的预警线时，「预计可用」右侧还会出现一个实心的「去充值 ↗」按钮，点开在浏览器新标签页直达 DeepSeek 开放平台的充值页。预警线填 0 只关掉上面的警示条，不会关掉这个入口——余额快到零时，总该有个一键跳出去的地方：
 
-<img src="docs/top-up.png" width="860" alt="预计可用右侧的去充值按钮">
+<img src="docs/top-up.png" width="720" alt="预计可用右侧的去充值按钮">
 
 <img src="docs/widget-low.png" width="300" alt="悬浮窗的警示态">