zcode-usage-stats — token usage stats panel（Token 用量统计面板）

[Amer-CN]

Hi all 👋 — sharing zcode-usage-stats, a plugin that adds a token usage statistics panel to DSH (Settings → Usage Stats).

It scans your full local session history and renders:

• 📅 Time ranges — today / yesterday / last 7 & 30 days / this & last month / all-time / custom range
• 🔥 Activity heatmap — one dot per day, dot area ∝ daily tokens; daily / weekly / cumulative modes, peak day ringed
• 📈 Usage trends — one line per model, peaks labeled, legend toggles models
• 🍩 Model breakdown — 100-tick gauge ring (100 ticks = 100%), hover for per-model details
• 🧮 Top stats — total tokens, peak day, longest session, current & longest activity streaks

Light & dark themes follow the harness:

☀️ Light	🌙 Dark

Install

dsh plugin --profile web add zcode-usage-stats

(Or from GitHub: dsh plugin --profile web add github:Amer-CN/zcode-usage-stats)

Implementation notes

• Charts are hand-written SVG — zero chart-library dependencies.
• Charts are drawn 1:1 against the measured container width (no viewBox scaling), so font sizes stay readable at any panel width.
• Dual-track palette: 6 categorical hues for model identity + a single-hue ordinal ramp for magnitudes; both themes pass WCAG AA contrast checks.
• The repo ships its sources and a 15-check acceptance suite (bash tests/acceptance.sh): geometry assertions, WCAG contrast and palette conformance, with a deterministic synthetic-data fallback so it runs on any machine.
• All data stays local — it aggregates via the host sessionPersistence service; nothing leaves your machine.

MIT licensed. Feedback and PRs welcome!

---

大家好 👋 — 分享 zcode-usage-stats：给 DSH 加一个 Token 用量统计面板（设置 → 使用统计）。

它会扫描本机全部历史会话并渲染：

• 📅 时间范围 — 今天 / 昨天 / 近 7 天 / 近 30 天 / 本月 / 上月 / 全部 / 自定义区间
• 🔥 活跃热力图 — 一格一天，点面积 ∝ 当日 Token；每日 / 每周 / 累计三档，峰值日虚线圈标注
• 📈 用量趋势 — 一条线一个模型，峰值直接标数，图例可点击显隐
• 🍩 模型用量 — 100 刻度环仪表盘（100 刻 = 100%），悬停查看各模型明细
• 🧮 顶部指标 — 累计 Token / 单日峰值 / 最长会话 / 当前与历史最长连续活跃天数

深浅主题跟随宿主：

☀️ 浅色	🌙 深色

安装

dsh plugin --profile web add zcode-usage-stats

（或从 GitHub 源安装：dsh plugin --profile web add github:Amer-CN/zcode-usage-stats）

实现要点

• 图表为手写 SVG，零图表库依赖；
• 图表按实测容器宽度 1:1 出图（不做等比缩放），任何面板宽度下字号都可读；
• 双轨配色：6 个类目色区分模型身份 + 单色相明度阶承载用量大小，明暗两套主题均满足 WCAG AA 对比度；
• 仓库自带源码与 15 项验收套件（bash tests/acceptance.sh）：几何断言、对比度核算、色板合规，内置确定性合成数据兜底，任何机器 clone 即可跑；
• 数据纯本地聚合（宿主 sessionPersistence 服务），不上传任何数据。

MIT 协议，欢迎反馈与 PR！