QEDQCD/dsh-token-stats

README 摘要

dsh-token-stats 一个 DeepSeek Harness 插件 （bundle），自动记录并统计 token 用量，支持按天 / 周 / 月 汇总，可按模型、日期区间过滤。这是 claude-token-stats （Claude Code / Codex 版）在 DeepSeek Harness 上的对应实现。 解决什么问题 DeepSeek Harness 的 dsh-token-meter 提供实时 token 计量，但没有跨会话的聚合报表。 用户想知道「本月用了多少 token」「哪个模型最费 token」时，需要手动翻日志或自行统计。 本插件从根上解决：监听 session 事件，在每次 assistant/message 带 provider usage 时 自动写入 /.dsh/token usage.jsonl ，并提供 token report 工具让模型查询聚合报表。 工作机制 - 监听 ： session/event 事件，每次 assistant/message 带 usage 字段时写入一条记录。 - 存储 ：纯 JSONL 文件，每行一条记录；文件小（每会话一行），内存聚合。 - 工具 ： token report ，模型侧 schema，返回文本表格。支持 day / week / month / all 聚合， model / since / until 过滤， local / utc 时区。 - 系统提示段 ： tool:token-stats ，引导模型在用户询问 token 用量时调用 token report 。 安装 系统要求 项目 说明 操作系统 Linux 或 macOS（Windows 未测试） DeepSeek Harness dsh CLI 与一个 profile（如 headless / web ） 一句话让 Agent 帮你装 把下面整段复制给你的 Agent（Claude Code / Cursor / Codex 均可）： 请先阅读 https://github.com/QEDQCD/dsh-token-stats 的 README.md「系统要求」， 确认本机满足（Linux/macOS、有 dsh CLI 与一个 profile 如 headless ）。 满足后：克隆到任意目录，在该目录内运行 pnpm install && pnpm build ， 再运行 node scripts/install.mjs --profile headless （profile 名按我实际用的改）， 验证 dsh --profile headless --dump-config grep token-stats 能输出。 构建并安装到 profile 安装脚本（幂等）把 bundle 拷入 $D…

分类