Mu-scorpio/token-usage-counter

Token 用量统计插件

为 DeepSeek Harness 提供持久、准确的 Token 用量统计，以及自定义 Provider 的模型推理强度配置。插件读取 provider 上报的真实用量，区分输入（未命中）、 输入（命中）、缓存写入和输出，并提供累计统计、今日数据、热力图、分模型统计、 推理等级同步以及 /tokens 命令。

功能

安装

推荐安装已经发布到 npm 的 DSH Bundle。下面的命令会把插件安装到 web profile，并自动维护 profile 的 Bundle 列表：

dsh plugin --profile web add -w --config.auto-install-peers=false dsh-token-usage-counter

安装后可以先检查最终配置，再启动 Web：

dsh --profile web --dump-config
dsh web

-w 用于允许 pnpm 把包添加到 profile workspace；--config.auto-install-peers=false 用于避免 pnpm 试图从 npm 安装 Harness 内部提供的 peer 包。安装完成后， dsh.profile.bundles 会自动加入该 Bundle，不需要再手写 cordis.patch.yml。

Bundle 内含 dsh.bundle manifest 和 cordis.patch.yml。安装时会禁用内置的 host-side usage-stats 累加器，再挂载本插件；这样两套累加逻辑不会同时写入 同一个 settings 命名空间。

Web 设置页的展示组件属于 Harness 自带的 ui-usage-stats，本插件提供的是 数据统计与持久化服务，不会重复安装一套前端页面。界面语言跟随 Harness 的 当前语言设置；本仓库默认 README 使用中文。

配置模型推理强度

安装 Bundle 后，插件会自动提供推理强度同步能力，但不会猜测你的 Provider， 也不会覆盖已经手工声明的 reasoningEfforts。在自己的 cordis.yml 或最后 应用的 patch 中，为同一个 token-usage-counter 条目补充配置：

- id: token-usage-counter
  name: dsh-token-usage-counter
  config:
    providers:
      cliproxyapi:
        api: openai-responses
        reasoning: high       # 可选：Provider 默认等级
        efforts:              # 可选：覆盖默认的 wire 值
          low: low
          medium: medium
          high: high
          xhigh: xhigh
          max: max
      jyld:
        api: openai-completions
        models:
          deepseek-v4-flash-0731:
            efforts:
              low: low
              medium: medium
              high: high
              xhigh: xhigh
              max: max

规则如下：

• api 只用于选择默认的协议映射；网关使用特殊字符串时，用 efforts 覆盖。
• reasoning 会设置 Provider 级默认推理等级；不填写时由模型选择器决定。
• models.<id>.efforts 可以单独覆盖某个模型，disabled: true 可以显式关闭。
• 已存在的 reasoningEfforts 和 reasoningEfforts: false 永远不会被覆盖。
• Provider 必须已经存在于 @deepseek-ai/dsh-llm-pi-ai 设置中，插件只补齐缺失字段。

如果当前设置里已经有模型推理等级声明，插件会保持现状；因此可以安全地与已有 的手写配置一起使用。

本地开发

直接使用 checkout 中的源码时，在仓库根目录执行：

dsh web --patch ./cordis.yml

或者在自己的 cordis.yml 中加入：

- id: usage-stats
  disabled: true

- insert:
    - id: token-usage-counter
      name: './src/index.ts'

手动挂载时不要同时启用 @deepseek-ai/dsh-usage-stats，否则会产生 settings 命名空间冲突。

从源码构建

仓库提交了生成后的 lib/index.js，从 npm 或 GitHub 安装时不需要安装阶段的 构建授权。修改源码后，在仓库根目录执行：

pnpm install --config.auto-install-peers=false
pnpm build

统计规则

插件监听持久化的 session/event 事件流，并在加载时接管已经存在的会话。只有 成功完成的锚点才会提交用量：

• assistant/message.usage 只计入一次；
• compaction/summary.usage 也会作为一次 provider 调用计入；
• 单独的 assistant/chunk 会等待匹配的 assistant/message 到达；
• 同一个 (turn, step) 同时出现 chunk 和最终消息时，以最终值替换早期样本；
• 失败请求、重试请求和 fork 会话的种子历史不会重复计入。

因此页面展示的是已完成的 provider 工作量，而不是原始流事件数量。

API

插件提供 ctx.tokenUsageCounter：

ctx.tokenUsageCounter.getSummary()
ctx.tokenUsageCounter.getSession(sessionId)
ctx.tokenUsageCounter.getModel(provider, model)
ctx.tokenUsageCounter.formatSummary()

摘要包含全局、Provider / 模型、会话三个层级的统计。每个计数器都保留四个互不 重叠的 provider 用量分桶，以及 totalTokens 和 calls。

搜索关键词

DeepSeek Harness 插件 · DSH plugin · Token 用量统计 · Token analytics · LLM 用量分析 · AI 用量统计 · Prompt Cache 追踪 · 模型用量仪表盘 · 每日 Token 热力图 · 模型推理强度 · reasoning effort · reasoningEfforts · 自定义 Provider · TypeScript Cordis 插件 · 本地优先可观测性 · Provider Token 计费

相关链接

• npm 包
• GitHub 仓库
• DSH Bundle 安装文档
• DSH 社区插件目录 PR

许可证

MIT