ZhengDaoWang/dsh-token-usage-observer

README 摘要

dsh-token-usage-observer 统计本机 DeepSeek Harness / Codex (ChatGPT) / OpenCode 的 token 用量与预计费用，提供 agent 工具（ usage stats ）与 WebUI 侧边栏「Token 统计」看板。 Collect and summarize local token usage from DeepSeek Harness, Codex (ChatGPT) and OpenCode logs, exposed as a DeepSeek Harness plugin: an agent tool ( usage stats ) plus a WebUI sidebar dashboard tab. 功能 / Features - 聚合三个来源的 token 用量：输入（缓存未命中）、输入（缓存命中）、缓存写入、输出，并计算缓存命中率与预计费用 - WebUI 侧边栏新增「Token 统计」入口：打开中心列看板，支持按来源、时间段（ YYYY-MM-DD ）、分类（模型 id / agent preset）与分组维度筛选，单价可在看板内实时调整 - 看板提供总量分布图表（按来源 / 分类 / 日期的堆叠条形图）与逐会话明细列表（各来源每个会话的会话名称、token 消耗、命中率与费用，按费用降序） - agent 工具 usage stats ：同样的统计管线，支持按来源 / 分类 / 日期 / 不分组四种分组维度，并附会话明细表（含会话名称） - 会话名称自动解析：Harness 取 session/title 事件、Codex 取 session index.jsonl 的 thread name 、OpenCode 取 session.title ；缺失时回落为会话 ID - 费用单价可配置（默认按 DeepSeek 公开价：输入 $0.14 / 缓存命中 $0.014 / 输出 $0.28，每百万 token；缓存写入默认 $0，全部默认 0） - 只读本地日志，不修改任何数据；对损坏/无法读取的文件静默跳过 安装 / Install 通过 dsh 插件命令安装（bundle 形态，构建产物随仓库分发，无需本地构建）： 更新 / 移除： 安装 / 更新后需重启 dsh web ，侧边栏「Token 统计」入口与看板才会加载。 WebUI 看板 / Dashboard 安装并重启后，侧边栏出现「Token 统计」入口（New Session 按钮下方、与任务看板 / SSH 入口同一区块）。点击打开中心列看板： - 筛选栏 ：来源（全部 / DeepSeek Harness / Codex / OpenCode）、起始 / 结束日期、分类（模型或 preset 子串）、图…

分类