dsh-token-pulse

English: 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 已运行）。

安装

# 从 npm（推荐，最短）
dsh plugin --profile web add dsh-token-pulse

# 或从 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

截图

功能

常见问题

• 显示 0？ 确认 $DSH_HOME/sessions 下有含 usage 字段的会话日志。
• 会联网吗？ 不会，纯本地统计。
• 时区？ 固定北京时区，周一为周起始。
• 如何重置？ 设置页右上角 ⋯ → 「重置历史」。

开发

pnpm install && npx tsdown   # 构建
node --test src/             # 运行测试

License

MIT