pythonshiyi/dsh-plugin-tokenmeter

README 摘要

dsh-plugin-tokenmeter English 中文 DeepSeek Harness 网页端词元消耗显示插件 —— 在每条已完成的助手回复下方，实时显示本轮消耗的输入/输出词元、缓存命中率与会话累计。 功能特性 - 每条 已完成的助手轮次（turn） 底部显示词元消耗徽标： - ↑ 输入 / ↓ 输出 ：整轮 所有步骤 （含工具调用步骤——每步都会重发完整上下文并单独计费）的计费合计 - 缓存命中率 ：缓存读取 ÷ 计费输入，缓存命中越高成本越低 - 会话累计 ：来自 Harness 的 tokenUsage 投影——基于整个持久化日志、随事件实时更新、不重复计数 - 悬停明细 ：缓存读取/写入、思考词元（输出的子集，不重复累加）、步骤数 - 纯客户端实现 ：数据直接来自会话快照，无 Host 往返，消息完成即动态出现/更新 - 样式使用主题变量，自动适配明暗主题 环境要求 - DeepSeek Harness web 版 （ dsh --profile web ） - 标准 web 插件列表（会话/对话 UI） 安装 方式一：npm（发布后可用） 方式二：本地目录或 Git 仓库 然后注册到你的 profile 补丁，例如 /.dsh/profiles/web/cordis.patch.yml ： 重启应用（ dsh --profile web ）并刷新页面即可生效。 卸载 从 cordis.patch.yml 删除该行，或直接禁用： 重启并刷新。 工作原理 环节 说明 槽位 conversation.chat.assistant-actions （增量列表槽， id: token-usage ， order: 5 ） 轮次定位 关闭消息 id → chat.legacy.nodes → turn 编号 轮次聚合 chat.locations.getTurn(turn) → assistant-step 节点 data.usage / finalNode.usage （降级：legacy 节点扫描） 计费输入 inputTokens + cacheReadTokens + cacheWriteTokens （不重叠计数；DeepSeek 适配器已将缓存命中从 prompt tokens 中剔除） 思考词元 是 outputTokens 的子集——仅展示，绝不重复累加 会话累计 useProjection('tokenUsage') —— Host 端对整个持久化日志的增量折叠 常见问题 为什么多步工具轮次的数字很大？ 每调用一次工具，模型都会重发完整上下文并单独计费（输入侧），本插件如实聚合了整轮所有步骤的消耗。 为什么某些消息没有徽标？ 只有模型上报了 usage 数据的调用才会显示；窗口外的历史消息同样无法统计。 支持与品牌 公众号：十一…

分类