@cassius0924/dsh-usage-dashboard 0.8.1 → 0.9.0

package/README.md

@@ -11,7 +11,7 @@
 装上之后 GUI 里多两样东西：右下角一个可拖动的**悬浮额度窗**，顶部栏多一个**「额度」tab**。
 还能在「额度 → 设置」里加一个**侧边栏额度入口**（顶部或底部，点开账号级额度页）、**拖动调整「额度」tab 的位置**。
 额度页会收起聊天输入框，把整屏留给数据；「图片 / 多模态用量」并入用量趋势卡，切换 7 天 / 30 天 / 90 天 / 1 年
-时随图片有无平滑展开或收起。界面支持中文与 English，直接跟随 DSH 全局的「Settings → Language」设置；
+时随图片有无平滑展开或收起。界面支持简体中文与 English，直接跟随 DSH 全局的「Settings → Language」设置；
 切换无需刷新，选择由 DSH 持久化。
 
 ---
@@ -65,7 +65,7 @@
 
 ### 高峰时段多付了多少
 
-<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）价格是闲时的两倍。
 
@@ -73,15 +73,15 @@ DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00
 
 ### 缓存替你省了多少
 
-<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 与文本一并计费，但「看了一堆截图」和「纯文本」在账单里长得一模一样。
 
@@ -99,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 点逐小时（可按模型多选过滤，叠成分组柱状图），外加近 12 周热力图。hover 立刻出 tooltip，不用等系统那一秒。
+近 30 天逐天、0–23 点逐小时（可按模型多选过滤，叠成分组柱状图）；逐天/逐小时切换、周期与指标都在这张卡上。hover 立刻出 tooltip，不用等系统那一秒。
+
+<img src="docs/heatmap.png" width="860" alt="近一年用量热力图">
+
+热力图单独成卡，覆盖近一年每一天：一眼看出长期的使用节奏，而不是只看最近几周。
 
 ### 余额预警
 
@@ -115,6 +119,10 @@ DeepSeek 从 2026-08-17 00:00 起改峰谷定价，高峰（北京时间 09:00
 
 在「设置」里定一条预警线（默认 ¥10，填 0 关闭）。跌破时仪表盘顶部出现警示条——带上还能撑几天和充值入口——同时悬浮窗一起转警示色，两边不会各说各话：
 
+余额低于 ¥10、或跌破设置的预警线时，「预计可用」右侧还会出现一个实心的「去充值 ↗」按钮，点开在浏览器新标签页直达 DeepSeek 开放平台的充值页。预警线填 0 只关掉上面的警示条，不会关掉这个入口——余额快到零时，总该有个一键跳出去的地方：
+
+<img src="docs/top-up.png" width="720" alt="预计可用右侧的去充值按钮">
+
 <img src="docs/widget-low.png" width="300" alt="悬浮窗的警示态">
 
 ---
@@ -146,6 +154,17 @@ dsh plugin --profile web add ./path/to/dsh-usage-dashboard
 > 兼容性：同时支持两代宿主接口——旧版 `readFrom(id, 0)` 与新版 handle 化 `open(id, 'read')` / `read` / `close`。
 > 宿主升级到移除 `readFrom` 的版本后，插件无需更换版本，会话日志照常重放。
 
+## 界面语言
+
+跟随 DSH 全局的 **Settings → Language**，切换即时生效、无需刷新，选择由 DSH 持久化：
+
+- **简体中文** —— DSH 内置 `zh`；
+- **English** —— DSH 内置 `en`。
+
+插件只提供这两种语言，与宿主内置语言保持一致，**不额外注册语言包**：语言目录属于宿主的设置面，
+插件私自加一门宿主没翻译的语言，会让宿主界面和仪表盘说两种语言（宿主只能回落到简中）。
+日期与数字格式化按当前语言取对应的 `Intl` 标签（`zh-CN` / `en-US`），不随浏览器区域设置漂移。
+
 ## 费用是怎么算的
 
 费用是**估算**，不是账单。规则都在 [`src/pricing.ts`](src/pricing.ts) 一个文件里：
@@ -199,7 +218,7 @@ src/
     ├── dashboard.tsx # 「额度」tab
     ├── charts.tsx  # 柱状图 / 热力图 / tooltip
     ├── locales.ts  # 中英文完整词典
-    ├── i18n.tsx    # DSH locale 桥接与翻译上下文
+    ├── i18n.tsx    # DSH locale 桥接与 Intl 标签映射
     ├── styles.ts   # 全部样式
     ├── api.ts      # fetch + 客户端缓存
     ├── cache.ts    # TTL 缓存（含 localStorage 持久化）