Token 用量仪表盘phungthien269/dsh-token-stats

dsh-token-stats

用于 DeepSeek Harness Web GUI 的 Token 用量仪表盘——直接显示在应用内。无需额外采集：它读取内置 Wallet 插件已经记录的 365 天本地账本（每次 AI 调用：模型、提供商、日期、输入/输出/缓存 token、有定价时的费用）。

English · Tiếng Việt · 中文

功能

Token 统计仪表盘

- 侧边栏入口“Token Statistics”——在中间栏打开一个全宽仪表盘（与 Task Board 插件相同的交互模式）；在展开的侧边栏和紧凑栏中均可使用。
- 四张汇总卡片——今日 / 本周 / 本月 / 全部时间（token + 有定价数据时的费用）。
- 堆叠柱状图——纯 SVG，每个模型一种颜色，按日（30 天）/ 按周（12 个 ISO 周）/ 按月（12 个月），每个模型悬停提示，K/M 缩放坐标轴。
- 按模型表格——输入、输出、缓存读取、总计、占比条；按总计排序。
- 4 语言 UI——English（主要）、Tiếng Việt、中文、日本語。仪表盘标题栏中有语言选择器；选择会被记住。
- 自动刷新——仪表盘打开时每 30 秒重新获取，另有手动刷新按钮。
- 零依赖，无需构建步骤——宿主端是纯 ESM Node；客户端是单个预打包的 CJS 模块。

安装

dsh plugin --profile web add dsh-token-stats

重启 dsh web（或使用市场的一键重启），然后在左侧边栏中查找 Token Statistics。

需要 dsh ≥ 0.1.1-rc.2（它所集成的侧边栏 DOM）。只读：该插件从不写入 Wallet 账本。

工作原理

- 宿主端注册 GET /api/token-stats/summary：全部时间总计来自 ~/.dsh/storages/wallet.json 的 sessions，日/周/月序列来自其 history.events（时区感知，mtime 缓存）。
- 客户端挂载侧边栏入口（自愈式 DOM 注入）和仪表盘 React 视图；图表为手写 SVG——无图表库。

数据说明

- 全部时间总计来自 Wallet 会话账本；日/周/月序列来自 Wallet 事件账本（由 Wallet 插件限制为 20,000 个事件 / 365 天）。没有定价的模型仅显示 token。

Tiếng Việt

Dashboard thống kê token cho web GUI của DeepSeek Harness — hiển thị trực tiếp trong ứng dụng. Đọc sổ ghi 365 ngày có sẵn của plugin Wallet (mỗi lần gọi AI: model, ngày, token input/output/cache, chi phí khi có). Thẻ tổng quan Hôm nay / Tuần này / Tháng này / Tổng tất cả; biểu đồ cột xếp lớp theo model; bảng chi tiết từng model. Giao diện đa ngôn ngữ: Tiếng Việt, English, 中文， 日本語 — đổi ngay trong dashboard. Cài đặt: dsh plugin --profile web add dsh-token-stats, khởi động lại dsh web, mở mục "Thống kê Token" ở thanh bên.

中文
DeepSeek Harness Web GUI 的 Token 用量仪表盘 — 直接显示在界面内。读取内置 Wallet 插件的 365 天本地账本（每次 AI 调用：模型、日期、输入/输出/缓存 token、可用时的费用）。今日 / 本周 / 本月 / 累计四张汇总卡片；按模型堆叠的柱状图；模型明细表。界面支持越南语 / 英语 / 中文 / 日语，可在仪表盘内切换。安装：dsh plugin --profile web add dsh-token-stats，重启 dsh web，在侧边栏打开 "Token 统计"。

提交到插件市场

参见 docs/market-submission.md — 发布到 npm，然后向 awesome-dsh-plugin 目录提交一个条目的 PR（市场会自动收录，通常一天内完成）。

许可证

MIT — 参见 LICENSE。