npm - dsh-token-gauge - Versions diffs - 1.1.0 → 1.1.1 - Mend

dsh-token-gauge 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 liumiaozhi
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 liumiaozhi
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md CHANGED Viewed

@@ -1,95 +1,102 @@
-# dsh-token-gauge · Token Gauge Dashboard
-<p align="center">
-  <img src="screenshots/single-classical.png" alt="Single gauge · Vintage skin" width="48%">
-  <img src="screenshots/dual-starfield.png" alt="Dual gauge · Starfield skin" width="48%">
-</p>
-<p align="center">
-  <img src="screenshots/styles.png" alt="Vintage / Macaron / Minimal / Starfield skins" width="78%">
-</p>
-<p align="center">
-  <a href="https://github.com/liumiaozhi/dsh-token-gauge/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
-  <a href="LICENSE"><img alt="License MIT" src="https://img.shields.io/github/license/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
-  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-Web%20Plugin-4f46e5?style=flat-square">
-</p>
-A sidebar Token gauge for **DeepSeek Harness (DSH)**. Four skins — Vintage, Macaron, Minimal and Starfield — turn token speed, session/today usage and spend, and cache hit rate into a quick car-dashboard read.
-> Preview images use sample data. Real values are aggregated from local DSH session logs; nothing is fabricated.
-## Features
-- **Two structures**
-  - **Single**: token-speed gauge on the left, current-session / today tokens and spend on the right, cache-hit progress bar at the bottom.
-  - **Dual**: token-speed gauge and cache-hit gauge side by side on top; current-session and today tokens / spend below.
-- **Four skins**: Vintage (warm amber), Macaron, Minimal, Starfield. Structure and skin combine freely — eight presentations.
-- **Live speed**: reads streaming output deltas from the current session and moves the needle smoothly across 0–500 tokens/s.
-- **Cache gauge**: 70–100% range with 70 / 75 / 100 ticks; below 70% the needle parks at 70% while the readout keeps the real value.
-- **Token formatting**: always in **k (thousand tokens)**, two decimals and thousands separators, e.g. `15,098.77k`.
-- **Settings**: the slider icon at the card's top-right opens structure/skin choices; selections persist in `localStorage`.
-- **Theme-aware** and dependency-free: no billing plugin, no chart library, no external CDN. The Host half aggregates DSH session logs itself.
-## Install
-The plugin ships its own Host half: it reads DSH's `sessionPersistence` logs and aggregates usage locally. **No billing plugin is required.**
-```bash
-dsh plugin --profile web add dsh-token-gauge
-```
-From source (current repository version):
-```bash
-git clone https://github.com/liumiaozhi/dsh-token-gauge.git
-dsh plugin --profile web add "link:<absolute-path-to-repo>"
-```
-> If npm still serves an older `dsh-token-gauge`, install from source until 1.1.0 is published.
-Restart or hard-refresh DSH Web. The card replaces the original billing trigger at the same sidebar-footer slot without needing that plugin.
-## Usage
-1. Click the slider icon at the **top-right** of the card.
-2. Choose **Single / Dual** under Layout.
-3. Pick one of **Vintage / Macaron / Minimal / Starfield**.
-4. Start a conversation; speed follows streaming output and usage refreshes every 1.5s.
-<p align="center">
-  <img src="screenshots/settings.png" alt="Settings: layout and four skins" width="62%">
-</p>
-## Data
-| Metric | Source |
-| --- | --- |
-| Token speed | Streaming text / reasoning / tool-call deltas of the current session, estimated over a 0–500 tokens/s scale |
-| Current-session tokens | `input + output` over all turns of the current session |
-| Today tokens | Today's `input + output` from the plugin's own `byDay` aggregate |
-| Current-session spend | Estimated from successful model calls in the current session |
-| Today spend | Estimated from DeepSeek Flash / Pro list prices with peak/off-peak bands |
-| Cache hit rate | Today's `cacheHit / (cacheHit + cacheMiss)`, gauge range 70–100% |
-The Host half reads `assistant/message.usage` from DSH `sessionPersistence`, adds 0.02 CNY per web-search call, and prices DeepSeek Flash (2 / 0.04 / 8 CNY per million tokens) and Pro (9 / 0.3 / 27). Peak hours are weekdays 09–12 and 14–18; weekends and off-peak are half price. Unknown models fall back to Flash rates. Amounts are estimates, not an official invoice.
-## Development
-```bash
-git clone https://github.com/liumiaozhi/dsh-token-gauge.git
-cd dsh-token-gauge
-dsh plugin --profile web add "link:$PWD"
-```
-`client.js` is a hand-written Client bundle; no build step. DSH Client HMR reloads it after edits; refresh the page if HMR is unavailable.
-## Compatibility
-- DSH Web (`platform: web`), requiring `@deepseek-ai/dsh-client-ui-sidebar` and `@deepseek-ai/dsh-client-ui-session`.
-- Host half uses DSH's built-in `sessionPersistence` and `webServer`; no billing plugin.
-- Preview images are generated from the actual component styles with sample data.
-## License
-[MIT](LICENSE) © 2026 liumiaozhi
+# dsh-token-gauge · Token Gauge Dashboard
+<p align="center">
+  <img src="screenshots/single-classical.png" alt="Single gauge · Vintage skin" width="48%">
+  <img src="screenshots/dual-starfield.png" alt="Dual gauge · Starfield skin" width="48%">
+</p>
+<p align="center">
+  <img src="screenshots/styles.png" alt="Vintage / Macaron / Minimal / Starfield skins" width="78%">
+</p>
+<p align="center">
+  <a href="https://github.com/liumiaozhi/dsh-token-gauge/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
+  <a href="LICENSE"><img alt="License MIT" src="https://img.shields.io/github/license/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
+  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-Web%20Plugin-4f46e5?style=flat-square">
+</p>
+A sidebar Token gauge for **DeepSeek Harness (DSH)**. Four skins — Vintage, Macaron, Minimal and Starfield — turn token speed, session/today usage and spend, and cache hit rate into a quick car-dashboard read.
+> Preview images use sample data. Real values come from local DSH sessions through the billing plugin; nothing is fabricated.
+## Features
+- **Two structures**
+  - **Single**: token-speed gauge on the left, current-session / today tokens and spend on the right, cache-hit progress bar at the bottom.
+  - **Dual**: token-speed gauge and cache-hit gauge side by side on top; current-session and today tokens / spend below.
+- **Four skins**: Vintage (warm amber), Macaron, Minimal, Starfield. Structure and skin combine freely — eight presentations.
+- **Live speed**: reads streaming output deltas from the current session and moves the needle smoothly across 0–500 tokens/s.
+- **Cache gauge**: 70–100% range with 70 / 75 / 100 ticks; below 70% the needle parks at 70% while the readout keeps the real value.
+- **Token formatting**: always in **k (thousand tokens)**, two decimals and thousands separators, e.g. `15,098.77k`.
+- **Settings**: the slider icon at the card's top-right opens structure/skin choices; selections persist in `localStorage`.
+- **Theme-aware** and dependency-free: no billing plugin, no chart library, no external CDN. The Host half aggregates DSH session logs itself.
+## Install
+The plugin ships its own Host half: it reads DSH's `sessionPersistence` logs and aggregates usage locally. **No billing plugin is required.**
+```bash
+dsh plugin --profile web add dsh-token-gauge
+```
+From source (current repository version):
+```bash
+git clone https://github.com/liumiaozhi/dsh-token-gauge.git
+dsh plugin --profile web add "link:<absolute-path-to-repo>"
+```
+> If npm still serves an older `dsh-token-gauge`, install from source until 1.1.0 is published.
+Restart or hard-refresh DSH Web. The card replaces the original billing trigger at the same sidebar-footer slot without needing that plugin.
+## Usage
+1. Click the slider icon at the **top-right** of the card.
+2. Choose **Single / Dual** under Layout.
+3. Pick one of **Vintage / Macaron / Minimal / Starfield**.
+4. Start a conversation; speed follows streaming output and usage refreshes every 1.5s.
+<p align="center">
+  <img src="screenshots/settings.png" alt="Settings: layout and four skins" width="62%">
+</p>
+## Data
+| Metric | Source |
+| --- | --- |
+| Token speed | Streaming text / reasoning / tool-call deltas of the current session, estimated over a 0–500 tokens/s scale |
+| Current-session tokens | `input + output` over all turns of the current session |
+| Today tokens | Today's `input + output` from the plugin's own `byDay` aggregate |
+| Current-session spend | Estimated from successful model calls in the current session |
+| Today spend | Estimated from DeepSeek Flash / Pro list prices with peak/off-peak bands |
+| Cache hit rate | Today's `cacheHit / (cacheHit + cacheMiss)`, gauge range 70–100% |
+The Host half reads `assistant/message.usage` from DSH `sessionPersistence`, adds 0.02 CNY per web-search call, and prices DeepSeek Flash (2 / 0.04 / 8 CNY per million tokens) and Pro (9 / 0.3 / 27). Peak hours are weekdays 09–12 and 14–18; weekends and off-peak are half price. Unknown models fall back to Flash rates. Amounts are estimates, not an official invoice.
+## Development
+```bash
+git clone https://github.com/liumiaozhi/dsh-token-gauge.git
+cd dsh-token-gauge
+dsh plugin --profile web add "link:$PWD"
+```
+`client.js` is a hand-written Client bundle; no build step. DSH Client HMR reloads it after edits; refresh the page if HMR is unavailable.
+## Compatibility
+- DSH Web (`platform: web`), requiring `@deepseek-ai/dsh-client-ui-sidebar` and `@deepseek-ai/dsh-client-ui-session`.
+- Host half uses DSH's built-in `sessionPersistence` and `webServer`; no billing plugin.
+- Preview images are generated from the actual component styles with sample data.
+## Changelog
+### 1.1.1
+- Fix a startup failure on DSH 0.2.x: the Client bundle now registers under its package name `dsh-token-gauge` instead of `dsh-cost-dashboard`. The loader matches module factories by package name, so the old id left the row unregistered, the bundle was re-requested and executed twice, and the second registration threw `duplicate factory registration` — surfacing as `web boot: 1 entry did not activate` / `dsh-token-gauge: import failed`.
+- Declare `engines.dsh` and `dsh.compatibility` for DSH `>=0.2.0-rc.1 <0.3.0-0`, so an incompatible runtime is rejected at install time with a clear message instead of surfacing as a boot failure.
+## License
+[MIT](LICENSE) © 2026 liumiaozhi

package/README.md CHANGED Viewed

@@ -1,115 +1,122 @@
-# dsh-token-gauge · 费用仪表盘
-<p align="center">
-  <img src="screenshots/single-classical.png" alt="单表 · 古典风格" width="48%">
-  <img src="screenshots/dual-starfield.png" alt="双表 · 星空风格" width="48%">
-</p>
-<p align="center">
-  <img src="screenshots/styles.png" alt="古典 / 马卡龙 / 极简 / 星空四种皮肤" width="78%">
-</p>
-<p align="center">
-  <a href="https://github.com/liumiaozhi/dsh-token-gauge/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
-  <a href="LICENSE"><img alt="License MIT" src="https://img.shields.io/github/license/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
-  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-Web%20Plugin-4f46e5?style=flat-square">
-  <img alt="Token Gauge" src="https://img.shields.io/badge/UI-Token%20Gauge-0ea5e9?style=flat-square">
-</p>
-一个给 **DeepSeek Harness（DSH）** 用的侧边栏 Token 费用仪表盘。用老式车机 / 马卡龙 / 极简 / 星空四种皮肤，把 Token 输出速度、当前会话与今日消耗、缓存命中率做成一眼能读懂的仪表。
-> 界面预览使用示例数据；实际数据来自 DSH 本地会话日志聚合，不伪造样本。
-## 特性
-- **两种结构**
-  - **单表**：左侧 Token 速度仪表盘，右侧当前会话 / 今日 Token 与金额，底部缓存命中率进度条。
-  - **双表**：上方左侧 Token 速度、右侧缓存命中率两个仪表盘；下方并列展示当前会话与今日的 Token 量、金额。
-- **四种皮肤**：古典（老式车机琥珀色）、马卡龙、极简、星空。结构 × 皮肤可自由组合，共 8 种呈现。
-- **实时 Token 速度**：读取当前会话的流式输出增量，指针在 0–500 token/秒之间平滑摆动。
-- **缓存命中率表盘**：量程 70–100%，刻度 70 / 85 / 100；低于 70% 时指针停在 70%，中央数字仍显示真实值。
-- **Token 口径**：统一以 **k（千 token）** 显示，保留两位小数并带千分位，例如 `15,098.77k`。
-- **设置入口**：卡片右上角滑杆图标；选择结构与皮肤后立即生效，并写入 `localStorage`，刷新后保留。
-- **主题自适应**：颜色来自 DSH 主题令牌，深浅色模式均可读；不引入图表库、不请求外部 CDN。
-## 安装
-本插件自带 Host 半边，直接从 DSH 的 `sessionPersistence` 读取本地会话日志并聚合用量，**不依赖任何计费插件**。
-```bash
-dsh plugin --profile web add dsh-token-gauge
-```
-从源码安装（本仓库当前版本）：
-```bash
-git clone https://github.com/liumiaozhi/dsh-token-gauge.git
-dsh plugin --profile web add "link:<本仓库绝对路径>"
-```
-> npm 上的 `dsh-token-gauge` 若仍为旧版，请先用源码安装；发布 1.1.0 后可直接按名称安装。
-安装后重启或硬刷新 DSH Web，侧边栏底部会出现「费用仪表盘」。插件以 slot 优先级覆盖原计费卡片，但不需要计费插件本身。
-## 使用
-1. 点击卡片**右上角**的滑杆图标打开设置。
-2. 在「结构」中选择 **单表 / 双表**。
-3. 在下方四种皮肤中选择 **古典 / 马卡龙 / 极简 / 星空**。
-4. 开始对话，Token 速度表会随流式输出更新；会话与今日数据每 1.5 秒刷新。
-<p align="center">
-  <img src="screenshots/settings.png" alt="设置面板：结构 + 四种皮肤" width="62%">
-</p>
-## 数据与口径
-| 指标 | 来源 / 口径 |
-| --- | --- |
-| Token 速度 | 当前会话 `assistant/live-chunk` 文本 / reasoning / tool-call 增量估算，0–500 token/秒 |
-| 当前会话 Token | 当前会话所有轮次的 `input + output` |
-| 今日 Token | 本插件 `byDay` 中今天的 `input + output` |
-| 当前会话金额 | 当前会话所有成功模型调用按单价估算 |
-| 今日金额 | 本插件按 DeepSeek Flash / Pro 列表价与峰谷时段估算的今日费用 |
-| 缓存命中率 | 今日 `cacheHit / (cacheHit + cacheMiss)`，仪表盘量程 70–100% |
-Host 半边读取 DSH 的 `sessionPersistence` 会话日志，按 `assistant/message.usage` 聚合；搜索调用按 0.02 元/次估算。DeepSeek Flash（2 / 0.04 / 8 元每百万 token）与 Pro（9 / 0.3 / 27）使用官方列表价，工作日高峰外与周末按半价；其他模型回退到 Flash 价格估算。金额是参考值，不是官方账单。
-## 目录结构
-```text
-dsh-token-gauge/
-├── package.json          # DSH bundle + Client 声明
-├── cordis.patch.yml      # 插入 token-gauge 行
-├── index.js              # Host 半边：注册 /api/token-gauge/usage-stats
-├── usage-server.js       # 会话日志聚合 + DeepSeek 峰谷计价
-├── client.js             # Client 半边：仪表盘 / 设置 / 样式
-├── locale/
-│   ├── zh.json           # 插件市场中文标题与描述
-│   └── en.json
-├── icon.svg              # 插件图标
-├── screenshots/          # README 预览图
-└── README.md / README.en.md / LICENSE
-```
-## 开发
-```bash
-git clone https://github.com/liumiaozhi/dsh-token-gauge.git
-cd dsh-token-gauge
-# 本插件是手写 Client bundle，无构建步骤
-dsh plugin --profile web add "link:$PWD"
-```
-修改 `client.js` 后，DSH 的 Client HMR 会在文件变化后重新加载模块；没有热更新时刷新页面即可。
-## 兼容与限制
-- 面向 DSH Web（`platform: web`），需要 `@deepseek-ai/dsh-client-ui-sidebar` 与 `@deepseek-ai/dsh-client-ui-session`。
-- Host 半边依赖 DSH 自带的 `sessionPersistence` 与 `webServer` 服务；不需要计费插件。
-- 缓存命中率低于 70% 时指针停在 70% 刻度，中央数字保留真实值，避免表盘外推。
-- README 图片为按实际组件样式生成的示例预览，数据为演示值。
-## 许可
-[MIT](LICENSE) © 2026 liumiaozhi
+# dsh-token-gauge · 费用仪表盘
+<p align="center">
+  <img src="screenshots/single-classical.png" alt="单表 · 古典风格" width="48%">
+  <img src="screenshots/dual-starfield.png" alt="双表 · 星空风格" width="48%">
+</p>
+<p align="center">
+  <img src="screenshots/styles.png" alt="古典 / 马卡龙 / 极简 / 星空四种皮肤" width="78%">
+</p>
+<p align="center">
+  <a href="https://github.com/liumiaozhi/dsh-token-gauge/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
+  <a href="LICENSE"><img alt="License MIT" src="https://img.shields.io/github/license/liumiaozhi/dsh-token-gauge?style=flat-square"></a>
+  <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-Web%20Plugin-4f46e5?style=flat-square">
+  <img alt="Token Gauge" src="https://img.shields.io/badge/UI-Token%20Gauge-0ea5e9?style=flat-square">
+</p>
+一个给 **DeepSeek Harness（DSH）** 用的侧边栏 Token 费用仪表盘。用老式车机 / 马卡龙 / 极简 / 星空四种皮肤，把 Token 输出速度、当前会话与今日消耗、缓存命中率做成一眼能读懂的仪表。
+> 界面预览使用示例数据；实际数据来自 DSH 本地会话与计费插件聚合，不伪造样本。
+## 特性
+- **两种结构**
+  - **单表**：左侧 Token 速度仪表盘，右侧当前会话 / 今日 Token 与金额，底部缓存命中率进度条。
+  - **双表**：上方左侧 Token 速度、右侧缓存命中率两个仪表盘；下方并列展示当前会话与今日的 Token 量、金额。
+- **四种皮肤**：古典（老式车机琥珀色）、马卡龙、极简、星空。结构 × 皮肤可自由组合，共 8 种呈现。
+- **实时 Token 速度**：读取当前会话的流式输出增量，指针在 0–500 token/秒之间平滑摆动。
+- **缓存命中率表盘**：量程 70–100%，刻度 70 / 85 / 100；低于 70% 时指针停在 70%，中央数字仍显示真实值。
+- **Token 口径**：统一以 **k（千 token）** 显示，保留两位小数并带千分位，例如 `15,098.77k`。
+- **设置入口**：卡片右上角滑杆图标；选择结构与皮肤后立即生效，并写入 `localStorage`，刷新后保留。
+- **主题自适应**：颜色来自 DSH 主题令牌，深浅色模式均可读；不引入图表库、不请求外部 CDN。
+## 安装
+本插件自带 Host 半边，直接从 DSH 的 `sessionPersistence` 读取本地会话日志并聚合用量，**不依赖任何计费插件**。
+```bash
+dsh plugin --profile web add dsh-token-gauge
+```
+从源码安装（本仓库当前版本）：
+```bash
+git clone https://github.com/liumiaozhi/dsh-token-gauge.git
+dsh plugin --profile web add "link:<本仓库绝对路径>"
+```
+> npm 上的 `dsh-token-gauge` 若仍为旧版，请先用源码安装；发布 1.1.0 后可直接按名称安装。
+安装后重启或硬刷新 DSH Web，侧边栏底部会出现「费用仪表盘」。插件以 slot 优先级覆盖原计费卡片，但不需要计费插件本身。
+## 使用
+1. 点击卡片**右上角**的滑杆图标打开设置。
+2. 在「结构」中选择 **单表 / 双表**。
+3. 在下方四种皮肤中选择 **古典 / 马卡龙 / 极简 / 星空**。
+4. 开始对话，Token 速度表会随流式输出更新；会话与今日数据每 1.5 秒刷新。
+<p align="center">
+  <img src="screenshots/settings.png" alt="设置面板：结构 + 四种皮肤" width="62%">
+</p>
+## 数据与口径
+| 指标 | 来源 / 口径 |
+| --- | --- |
+| Token 速度 | 当前会话 `assistant/live-chunk` 文本 / reasoning / tool-call 增量估算，0–500 token/秒 |
+| 当前会话 Token | 当前会话所有轮次的 `input + output` |
+| 今日 Token | 本插件 `byDay` 中今天的 `input + output` |
+| 当前会话金额 | 当前会话所有成功模型调用按单价估算 |
+| 今日金额 | 本插件按 DeepSeek Flash / Pro 列表价与峰谷时段估算的今日费用 |
+| 缓存命中率 | 今日 `cacheHit / (cacheHit + cacheMiss)`，仪表盘量程 70–100% |
+Host 半边读取 DSH 的 `sessionPersistence` 会话日志，按 `assistant/message.usage` 聚合；搜索调用按 0.02 元/次估算。DeepSeek Flash（2 / 0.04 / 8 元每百万 token）与 Pro（9 / 0.3 / 27）使用官方列表价，工作日高峰外与周末按半价；其他模型回退到 Flash 价格估算。金额是参考值，不是官方账单。
+## 目录结构
+```text
+dsh-token-gauge/
+├── package.json          # DSH bundle + Client 声明
+├── cordis.patch.yml      # 插入 token-gauge 行
+├── index.js              # Host 半边：注册 /api/token-gauge/usage-stats
+├── usage-server.js       # 会话日志聚合 + DeepSeek 峰谷计价
+├── client.js             # Client 半边：仪表盘 / 设置 / 样式
+├── locale/
+│   ├── zh.json           # 插件市场中文标题与描述
+│   └── en.json
+├── icon.svg              # 插件图标
+├── screenshots/          # README 预览图
+└── README.md / README.en.md / LICENSE
+```
+## 开发
+```bash
+git clone https://github.com/liumiaozhi/dsh-token-gauge.git
+cd dsh-token-gauge
+# 本插件是手写 Client bundle，无构建步骤
+dsh plugin --profile web add "link:$PWD"
+```
+修改 `client.js` 后，DSH 的 Client HMR 会在文件变化后重新加载模块；没有热更新时刷新页面即可。
+## 兼容与限制
+- 面向 DSH Web（`platform: web`），需要 `@deepseek-ai/dsh-client-ui-sidebar` 与 `@deepseek-ai/dsh-client-ui-session`。
+- Host 半边依赖 DSH 自带的 `sessionPersistence` 与 `webServer` 服务；不需要计费插件。
+- 缓存命中率低于 70% 时指针停在 70% 刻度，中央数字保留真实值，避免表盘外推。
+- README 图片为按实际组件样式生成的示例预览，数据为演示值。
+## 更新日志
+### 1.1.1
+- 修复在 DSH 0.2.x 上无法启动：Client bundle 的注册 id 由 `dsh-cost-dashboard` 改为包名 `dsh-token-gauge`。加载器按包名匹配模块工厂，旧 id 不被识别，该行会被判定缺失并重新拉取 bundle，导致同一个 bundle 执行两次并抛出 `duplicate factory registration`，最终表现为 `web boot: 1 entry did not activate` / `dsh-token-gauge: import failed`。
+- 新增 `engines.dsh` 与 `dsh.compatibility` 声明，限定 DSH `>=0.2.0-rc.1 <0.3.0-0`。不兼容的运行时会在安装阶段被 DSH 拦下并给出明确提示，而不是等到启动失败才暴露。
+## 许可
+[MIT](LICENSE) © 2026 liumiaozhi