xbyzzZ/dsh_token_usage

README 摘要

dsh-token-usage 面向 DeepSeek Harness 的本地用量看板插件。 它只读 $DSH HOME/sessions （默认 /.dsh/sessions ）里的 session.jsonl.zstd ，按最近 30 天汇总 provider 回报的 token usage，并在 Web 侧栏 设置上方 放一个入口。点击后打开用量弹窗：热力图 + 按模型表。 这是独立 bundle 插件，不改 DSH 源码，不替换整条侧栏，不引入 SQLite。 官方插件规范： - 工具插件开发 - 发布规范 - Cordis 基础 界面 - 入口： sidebar.footer.action ，在设置按钮上方 - 弹窗：最近 30 天热力图、新产生 / 有用量的天 / 会话 - 热力图：浅色白到蓝，暗色黑到蓝；没有用量为白 / 黑 - 模型表： provider + 模型名、步数、输入、输出、缓存读、缓存写、推理 - 空数据：还没有带 usage 的会话 - 失败：读不了本地 JSONL，可再扫一次 数字口径 只统计会话日志里的 assistant/message.usage （同 turn/step 后写覆盖前写）。 - 新产生 = inputTokens + outputTokens + cacheWriteTokens - 缓存读、推理单独列表，不并进热力图主数字 - 没有 usage 的旧会话不按字数估算 安装 进入这个插件目录后执行： 也可以传绝对路径： 这会： 1. 在 $DSH HOME/profiles/web 用 pnpm 装上 dsh-token-usage 2. 把它追加进 package.json 的 dsh.profile.bundles 装完重启 DSH。左下角设置上方会出现「用量」。 如果 dsh plugin add 报 pnpm v11.12.0 is a broken release ，那是 profile 的 packageManager 钉死了坏版本，把 $DSH HOME/profiles/web/package.json 里的 pin 改成 [email protected] （或更新的可用版本）后再跑同一条命令。这和插件包无关。 插件自带 cordis.patch.yml 。若要覆盖配置，记得 整段重写 config ： 开发 Host 在没有 connection 的 headless profile 里不会注册 RPC；Web profile 会通过 /token-usage 的 summary 接口取数。

分类