dsh-token-pulse 0.2.2-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hou-DL
+
+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

@@ -0,0 +1,69 @@
+# dsh-token-pulse
+
+> 中文版：见 [README.md](./README.md)
+
+A local Token usage heatmap plugin for DSH Web — GitHub-style calendar views, built into the Settings pane.
+
+## Requirements
+
+- **Node.js ≥ 23.8** (built-in `node:zlib` zstd decoding, no extra install); on older Node it falls back to an external `zstd` CLI (`sudo apt install zstd` / `brew install zstd`).
+- A running **DSH Web profile** (`dsh web`).
+
+## Install
+
+
+```bash
+# From GitHub
+dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
+
+# Or from Gitee (faster in China)
+dsh plugin --profile web add "git+https://gitee.com/HouDL/dsh-token-pulse.git"
+```
+
+Restart, then open **Settings → Token Pulse**. 
+
+- **Zero network, zero billing** — reads local session logs only, never touches billing/balance APIs
+- **Persistent** — history is stored on disk; deleting sessions never loses data
+- **Multiple views** — Week (per-hour) / Month (calendar) / Quarter (last ~90 days) / Year (full year, two rows)
+- **Stats** — Today / This week / This month / All time + Top 5 by model and by provider
+
+## Screenshots
+
+<p align="center">
+  <img src="assets/screenshot-week.png" alt="Week view" width="60%">
+  <br><br>
+  <img src="assets/screenshot-month.png" alt="Month view" width="60%">
+  <br><br>
+  <img src="assets/screenshot-quarter-year.png" alt="Quarter / Year view" width="60%">
+</p>
+
+## Features
+
+| Module | Description |
+| --- | --- |
+| View switcher | Week / Month / Quarter / Year, colored with a view-adaptive 25 / 50 / 75 / 100% palette |
+| Week view | 24 hourly bars per day to spot peak hours; click a row to see that day's Top 5 |
+| Month view | Calendar cells showing date and daily usage |
+| Quarter / Year | GitHub-style grids; quarter is enlarged for readability, year laid out in two rows |
+| Top stats | Today / Week / Month / All-time, M / k abbreviated |
+| Top 5 models | By model or provider, switching with the view window / clicked date |
+| Refresh | Manual refresh + auto refresh (5 / 10 / 30 / 60 min, or off) |
+| Language | 中 / English switch |
+
+## FAQ
+
+- **Everything shows 0?** Make sure `~/.dsh/sessions` contains session logs with a `usage` field.
+- **Does it go online?** No. Fully local.
+- **Timezone?** Fixed to Asia/Shanghai, weeks start on Monday.
+- **How to reset?** Settings page → ⋯ menu (top-right) → Reset history.
+
+## Development
+
+```bash
+pnpm install && npx tsdown   # build
+node --test src/             # run tests
+```
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,69 @@
+# dsh-token-pulse
+
+> English: [README.en.md](./README.en.md)
+
+本地 Token 用量热图插件，GitHub 风格日历视图，内置于 DSH Web 设置页。
+
+## 环境要求
+
+- **Node.js ≥ 23.8**（内置 `node:zlib` 的 zstd 解码，无需额外安装）；更早版本会回退到外部 `zstd` CLI（`sudo apt install zstd` / `brew install zstd`）。
+- **DSH Web profile**（`dsh web` 已运行）。
+
+## 安装
+
+
+```bash
+# 从 GitHub
+dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
+
+# 或从 Gitee（国内访问更快）
+dsh plugin --profile web add "git+https://gitee.com/HouDL/dsh-token-pulse.git"
+```
+
+重启后打开 **设置 → Token Pulse** 即可。
+
+- **零网络、零计费**：只读本地会话日志，不触碰任何计费 / 余额接口
+- **持久化**：历史落盘，删除会话不丢数据
+- **多视图**：周（按小时展开）/ 月（日历）/ 季度（近 90 天）/ 年（整年双行）
+- **统计**：今日 / 本周 / 本月 / 累计 + 按模型与供应商的 Top 5
+
+## 截图
+
+<p align="center">
+  <img src="assets/screenshot-week.png" alt="周视图" width="60%">
+  <br><br>
+  <img src="assets/screenshot-month.png" alt="月视图" width="60%">
+  <br><br>
+  <img src="assets/screenshot-quarter-year.png" alt="季度 / 年度视图" width="60%">
+</p>
+
+## 功能
+
+| 模块 | 说明 |
+| --- | --- |
+| 视图切换 | 周 / 月 / 季度 / 年，颜色按视图内 25% / 50% / 75% / 100% 四档分档 |
+| 周视图 | 每天 24 个小时柱，看高峰时段；可点击行查看当日 Top 5 |
+| 月视图 | 日历格显示日期与当日用量 |
+| 季度 / 年度 | GitHub 风格栅格，季度放大便于观察，年度双行排布 |
+| 顶部统计 | 今日 / 本周 / 本月 / 累计，M / k 缩写 |
+| 模型 Top 5 | 按模型或供应商查看，随视图窗口 / 点击日期动态切换 |
+| 刷新 | 手动刷新 + 自动刷新（5 / 10 / 30 / 60 分钟，可关闭） |
+| 语言 | 中 / 英文切换 |
+
+## 常见问题
+
+- **显示 0？** 确认 `~/.dsh/sessions` 下有含 `usage` 字段的会话日志。
+- **会联网吗？** 不会，纯本地统计。
+- **时区？** 固定北京时区，周一为周起始。
+- **如何重置？** 设置页右上角 ⋯ → 「重置历史」。
+
+## 开发
+
+```bash
+pnpm install && npx tsdown   # 构建
+node --test src/             # 运行测试
+```
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,33 @@
+# dsh-token-pulse
+
+本地 Token 用量热图插件，GitHub 风格日历视图，内置于 DSH Web 设置页。
+
+## 环境要求
+
+- **Node.js ≥ 23.8**（内置 zstd 解码，无需额外安装）；更早版本需外部 `zstd` CLI。
+
+## 安装
+
+
+```bash
+# 从 GitHub
+dsh plugin --profile web add github:Hou-DL/dsh-token-pulse
+# 或从 Gitee
+dsh plugin --profile web add "git+https://gitee.com/HouDL/dsh-token-pulse.git"
+```
+
+重启后打开 **设置 → Token Pulse**。
+
+
+- **零网络、零计费**：只读本地会话日志
+- **持久化**：历史落盘，删除会话不丢数据
+- **多视图**：周（按小时）/ 月（日历）/ 季度（近 90 天）/ 年（整年双行）
+- **Top 5**：按模型与供应商统计
+
+## 常见问题
+
+- **会联网吗？** 不会，纯本地统计。
+- **时区？** 固定北京时区，周一为周起始。
+- **如何重置？** 设置页右上角 ⋯ → 「重置历史」。
+
+完整文档：[README.md](./README.md) · [README.en.md](./README.en.md)

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-token-pulse
+      name: dsh-token-pulse