vector-sunlight/dsh-token-usage0

dsh-token-usage

DSH web plugin: a per-session Token 用量 card for the dsh-better-sidebar right panel — cache hit/miss/output token counts, cache hit rate, and Beijing-time peak/valley cost estimation (2 decimals) synced from the official DeepSeek pricing page.

包名
dsh-token-usage
版本
1.0.0
许可证
MIT
最近更新
2026年8月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:vector-sunlight/dsh-token-usage

dsh-token-usage

dshfind

DSH Web 插件:在 dsh-better-sidebar(侧片卡片)右侧栏注册「⚡ Token 用量」标签页, 按会话独立统计当前会话的 token 用量与费用。

界面截图

Token 用量卡片(示例数据:缓存命中率 98.3%,全部为 2026-08-17 前旧价计费)

功能

  • 用量统计:缓存命中 / 非缓存命中 / 缓存写入 / 输出 / 推理 tokens、总输入、总计,以及缓存命中率进度条(深红 → 松石绿渐变,提醒提高缓存命中)
  • 峰谷分时计价:按北京时间(UTC+8,不依赖本机时区)判定高峰/低谷时段(高峰 9:00–12:00、14:00–18:00,其余低谷); 每条用量按发生时刻所在时段分别计价;2026-08-17 00:00(北京时间)前按旧价、之后按峰谷价
  • 计量重置规则:上下文压缩(compaction/end)之后从新计量; 距最后一条记录满一周(再无新记录)时旧计量清零、重新开始;卡片显示「计量自 … 起」及重置原因
  • 北京时间含月日:卡片顶部实时显示「北京时间 8月17日 15:04:21」
  • 官网价格同步:Host 半启动时抓取 DeepSeek 官网定价页(英文 / 中文),解析各模型高峰/低谷两套价格(USD/CNY 双币种)与时段区间, 每 6 小时自动刷新;同步失败回退内置价格并显示警告徽章
  • 费用两位小数:主币种随界面语言(中文 ¥ / 英文 $),副币种并排显示
  • 会话独立窗口:切换会话自动复用/新建该会话专属的 token 窗口,各会话统计互不串扰

⚠️ 前置依赖(下载安装前必读)

本插件依赖「侧边卡片」插件 dsh-better-sidebar(>= 0.12.0): Token 用量卡片显示在它提供的右侧栏里,没有它插件无法工作。

  • package.json 已声明 peerDependencies.dsh-better-sidebar
  • 一键安装脚本会在安装前自动检测:未安装侧边卡片时会明确提醒, 确认后自动代为安装;拒绝则中止安装(不会继续安装本插件)
  • 运行时亦有守卫:缺少侧边卡片服务时插件优雅跳过并在控制台提示

安装

一键脚本(推荐,自带依赖检查)