Token 雷达 Robortshen/dsh-token-radar

dsh-token-radar · Token 雷达

DeepSeek Harness 的前台 token 计量插件：输入框下方常驻一条计量条，点开是完整的消耗面板。

收起态

展开态

它显示什么

收起态（默认就在输入框下面那一行，紧挨状态栏，胶囊形，约 240px 宽）

● Token 雷达 · 本次会话 530k 新输入 28.8k 命中率 94.5% 估算费用 ¥0.107 ▁▂▃▅▆ 详情

最后的小柱状图是最近 18 次调用的消耗序列。

展开态

| 区块 | 内容 |
| 三张卡 | 本次会话（蓝）/ 今日（橙）/ 累计（紫）：总量、步数、费用、新输入、缓存命中、输出、命中率 |
| 本次会话 · 每一步消耗 | 左右两张图：总消耗（含缓存重发）与可计费部分（新输入+输出）；每根柱是一次调用，悬停看明细 |
| 配色 | 新输入=蓝 #2563eb、缓存命中=浅蓝 #8ec5fb、输出=橙 #f59e0b、累计/费用=紫 #7c3aed，不依赖主题色 |
| 最近 14 天 | 每日堆叠柱 |
| 子代理消耗 | 按父子树列出每个子代理的步数、token、费用（无子代理时自动隐藏） |
| 工具开销归因 | 每次工具调用的次数与「后续上下文增量」分摊值 |
| 按模型 | 各模型的 token、费用、占比 |

数据每 8 秒自动刷新（页面隐藏时暂停），也可点「刷新」。

口径

- 数字全部来自会话日志里模型返回的 usage（inputTokens / cacheReadTokens / cacheWriteTokens / outputTokens / reasoningTokens），不是估算。
- 新输入 = 未命中缓存的输入；缓存命中 = 命中前缀缓存的输入（约为前者 1/30 价）；输出 含推理。
- 工具本身不调用模型、不计费；「工具开销归因」是把 下一步上下文增量 − 上一步输出 按各工具结果长度分摊的估算值。
- 子代理是独立会话，带 parentSession，已按父子树汇总。
- 费用按 off-peak 价估算（flash 0.007 / 0.22 / 0.66 USD per 1M，pro 0.022 / 0.66 / 1.98），×7.2 折算人民币。

去重（否则会翻倍）

日志里有两类重复，插件都处理了：

1. 同一 session id 存在 v0/v3/v4 迁移副本 → 取步数最多、版本最高的一份；
2. 子代理/继续会话的日志把父会话历史整段复制（时间戳完全相同）→ 按 (时间, 轮, 步, 输入, 缓存命中, 缓存写入, 输出) 全局去重。

校验：与管理端 cost-meter 账本逐日比对，10 天里 5 天完全一致，其余差 1 次内部小调用（约 0.01%）。

结构

| 文件 | 作用 |
| index.js | Host 半：读 ~/.dsh/sessions//.zstd（自实现多帧 zstd 解码）、解析、去重、聚合，注册 GET /dsh-token-meter/stats |
| client.js | Client 半：胶囊注册在 conversation.composer.dock、面板注册在 conversation.input.dock，两者共用模块级 store，fetch 同源路由，纯 CSS 图表，无第三方依赖 |
| cordis.patch.yml | 插入插件行 token-radar |
| locale/.json | 插件市场/设置里显示的名称与说明（中英） |
| icon.svg | 插件图标 |

安装与生效

dsh plugin --profile <你的 profile> add dsh-token-radar
本地目录安装：
dsh plugin --profile <你的 profile> add /path/to/dsh-token-radar

本机已通过 plugin_manager install_bundle 安装进 desktop profile（~/.dsh/profiles/desktop/package.json 里以 link: 方式指向本目录）。

安装完成后需要重启 Harness：desktop profile 的 bundle 列表在进程启动时组合，运行中的进程不会热加载新 bundle。菜单栏 DeepSeek Harness → 重启应用与 Host 即可，不必手动退出。

客户端模块同样在页面启动时按 revision 装配，且该应用没有刷新快捷键，因此改完 client.js 也要走一次「重启应用与 Host」。

版式分两处注册：

- 收起态：conversation.composer.dock（输入框下面那一行），做成约 240px 的胶囊 ● Token 雷达 530k 新 28.8k ¥0.107 ▸，只放总量/新输入/费用，完整数字在悬停提示里，窄窗口自动隐藏次要字段，不会把状态栏文字挤成省略号；
- 展开态：conversation.input.dock（输入框上方），在文档流内向上生长、挤压对话区，所以详情面板不会盖住底部状态栏，也不会被窗口底边裁掉——输入框在最下方，向下没有空间，向上是唯一不遮挡的选择。

性能

首次扫描 142 个日志文件（71 MB 压缩）约 2.2 秒；之后按文件 size+mtime 做增量，命中缓存时一次请求约 10–30 ms。文档缓存 TTL 2.5 秒，避免轮询反复扫描。