@lmber/dsh-token-usage-stats
DeepSeek Harness 的令牌使用统计插件：记录每次调用的令牌使用量，并在设置页面中显示
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @lmber/dsh-token-usage-stats@0.4.5Token Usage Stats 以 @lmber/dsh-token-usage-stats 发布，当前版本为 0.4.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 DeepSeek Harness 提供 token 用量统计的第三方插件：自动记录每次模型调用的 token 消耗（含速度指标），在设置页提供独立查看界面，并可把账本增量同步到远程聚合服务，实现多设备用量集中统计。
安装不需要改动 DSH 源码，配置持久保存在 $DSH_HOME，重启后继续生效。
deviceId、事件时间戳、durationMs、firstTokenMs、outputTokensPerSec）<input type="month"> + 上/下月快捷按钮），也支持自定义起止日期总输出 tokens ÷ 总解码耗时 聚合，而非各次调用速度的算术平均），附带首字延迟与平均耗时，可直接比较各模型快慢remoteUrl 与鉴权 token（无需改 cordis 配置）；账本增量推送到远程服务（按 deviceId 隔离存储、可跨设备聚合），面板可切换「本机 / 远程汇总」数据源，并展示同步状态（待同步条数、上次同步时间、失败原因）k / M / B / T），卡片、表格、图例、悬停提示统一缩写dsh plugin --profile web add @lmber/dsh-token-usage-stats
然后重启 DSH。插件自带自挂载配置（dsh.bundle.patch），装上即生效，不需要手写任何 cordis 配置。
打开设置，左侧应出现「Token 使用统计」一栏。
dsh plugin --profile web remove @lmber/dsh-token-usage-stats
重启后插件及其设置页消失。账本文件会保留，需要的话手动删除。
默认写入 $DSH_HOME/token-usage-ledger.jsonl（DSH_HOME 未设置时为 ~/.dsh）。
每行一条 JSON 记录（schema v2）：
{
"type": "model-call",
"v": 2,
"ts": 1787102662243,
"iso": "2026-08-19T01:24:22.243Z",
"deviceId": "dev-8f2a…",
"sessionId": "session-xxx",
"provider": "deepseek-official",
"model": "deepseek-chat",
"inputTokens": 1000,
"outputTokens": 500,
"cacheReadTokens": 0,
"cacheWriteTokens": 0,
"reasoningTokens": 0,
"totalTokens": 1500,
"durationMs": 4210.5,
"firstTokenMs": 380.2,
"outputTokensPerSec": 92.4,
"workspacePath": "D:/work/repo",
"workspaceTitle": "repo"
}
totalTokens 是计费 token 总量：inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens，四项互不重叠，其中 inputTokens 只含未命中缓存的输入；reasoningTokens 已包含在 outputTokens 内，不重复计入。ts 取会话事件自身的 time 字段（精确到每次调用的完成时刻）。计时指标自 v0.4.3 起按当前 DSH 会话格式推导：每次调用的起点锚定在最近的 step/start / request/header（工具循环中会被 tool/result / assistant/attempt 推进），首字时间取自 assistant/message 内嵌流（format v2+，text-chunks / reasoning-chunks / tool-call-chunks 的首个 token 记录）与 assistant/message 完成时间的差值，分别得到 durationMs（请求发出到完成）与 firstTokenMs（首字延迟）、outputTokensPerSec（本次调用的输出速度，outputTokens ÷ (durationMs − firstTokenMs)）。旧版本 DSH 的 assistant/chunk 事件流仍受支持。账本行保留每次调用的原始速度；面板与接口展示的速度是聚合值（Σ输出 tokens ÷ Σ解码耗时，与 DSH 原生会话统计一致），单个「首字几乎等于完成时间」的调用不会拉高整体读数。v 与速度/设备字段，读取时自动兼容；速度类指标只在有新字段的记录上统计。账本是纯 JSONL，可以直接用其他工具分析：
# 总调用次数
wc -l < ~/.dsh/token-usage-ledger.jsonl
方式一：设置面板（推荐） — 打开「Token 使用统计」，在「远程同步配置」卡片填写服务地址与可选的鉴权 token，点击「保存配置」。配置立即生效并持久化到 $DSH_HOME/token-usage-config.json（token 输入框留空表示保持不变）。
方式二：cordis 配置（部署时预设）— profile 的 cordis.patch.yml：
- id: token-usage-stats
config:
remoteUrl: "https://stats.example.com"
remoteToken: "your-token" # 可选；与远程服务端 DSH_TS_TOKEN 对应
# deviceId: "my-laptop" # 可选；覆盖自动生成的 UUID
# deviceName: "办公笔记本" # 可选；默认取主机名
# syncIntervalMs: 60000 # 可选；推送间隔，默认 60 秒
remoteUrl 时行为与旧版完全一致：仅本地记账与展示。syncIntervalMs）把未同步的账本行批量 POST 到 {remoteUrl}/api/v1/ledger/upload，并持久化水位（token-usage-sync.json），失败自动留待下次重试，绝不影响本地记账。remoteUrl 会重新建立推送水位（新目标从头同步）。$DSH_HOME/token-usage-device.json，可用 deviceId 配置覆盖。本包附带一个零依赖的 Node 聚合服务（server/index.js），存储按设备隔离（<dataDir>/<deviceId>.jsonl），查询时跨设备聚合。可用于任何一台常开的机器：
node server/index.js
# 环境变量：
# PORT 监听端口（默认 8787）
# DSH_TS_DATA_DIR 数据目录（默认 ./data）
# DSH_TS_TOKEN 鉴权 token；设置后所有请求需带 Authorization: Bearer <token>
服务端接口（与插件本机路由同语义）：
POST /api/v1/ledger/upload — 设备推送账本行 { deviceId, deviceName, rows }GET /api/v1/ledger/summary?range=&from=&to=&devices= — 跨设备汇总（devices=all 或指定 deviceId）GET /api/v1/ledger/series?granularity=&limit=&devices= — 连续窗口时序GET /api/v1/ledger/series-by-model?granularity=&limit=&devices= — 按模型时序GET /api/v1/ledger/devices — 设备列表与各自统计主机端注册了只读路由，浏览器界面通过它取数据，也可以自己调用：
GET /api/token-usage-stats?range=day|yesterday|day-before|week|month|all|YYYY-MM
GET /api/token-usage-stats?from=YYYY-MM-DD&to=YYYY-MM-DD
GET /api/token-usage-stats?source=local|remote
range=YYYY-MM 直接选择某个月（如 2026-08），from/to 按本地时区解析，含首尾两天，两者都可省略。day / yesterday / day-before 各覆盖对应那一个本地日；week / month / all 从各自起点到当前时刻。非法参数返回 400。source=remote 时本机插件代理到远程服务做同样的查询（需要已配置 remoteUrl）。柱状图与模型趋势的数据来自分桶时间序列接口：
GET /api/token-usage-stats/series?granularity=day|hour|month&limit=N&source=
GET /api/token-usage-stats/series-by-model?granularity=day|hour|month&limit=N&source=
{ tokens: 0, calls: 0 }，柱状图因此不跳天。day 窗口止于今天，month 止于本月，limit 只返回最新 N 桶（默认按最早记录起算）。每个桶额外携带 avgTokensPerSec（该窗口内所有调用的输出速度，按 Σ输出 tokens ÷ Σ解码耗时 聚合；无速度数据时为 null）。series-by-model 返回 { granularity, buckets, series }，所有模型共享同一窗口便于对齐。byProvider / byModel 每行额外携带 avgOutputTokensPerSec、avgFirstTokenMs、avgDurationMs（仅统计有对应数据的行）。avgOutputTokensPerSec 与 DSH 原生会话统计同义：Σ输出 tokens ÷ Σ(durationMs − firstTokenMs)，首字延迟与完成时间几乎重合的调用（如纯工具调用响应）不会像"各调用速度算术平均"那样把读数拉高。设备与同步状态：
GET /api/token-usage-stats/meta
返回 deviceId、deviceName、entryCount 与 sync 状态（enabled、pendingCount、lastSyncAt、lastError）。
远程同步配置（设置面板读写）：
GET /api/token-usage-stats/config
PUT /api/token-usage-stats/config # body: { "remoteUrl": "...", "remoteToken": "..." }
GET 返回 remoteUrl、remoteUrlSet、remoteTokenSet（不含 token 明文）。PUT 应用并持久化配置；remoteUrl 传空字符串停用远程；不传 remoteToken 字段表示保持原值。切换 remoteUrl 会重置推送水位并立即重启同步。该路由绑定在 DSH web 服务器上，跟随其监听地址（默认仅本机 127.0.0.1）。它没有独立鉴权，与 DSH web 界面本身共享同一信任范围 —— 如果把 DSH 暴露到非本机地址，这份用量数据同样会被暴露。
node tests/smoke.mjs # 聚合逻辑冒烟测试（真实账本，无账本时用合成数据）
node tests/integration.mjs # cordis 集成测试：真实运行时内验证记账/路由/远程同步全链路
node server/index.js # 启动参考聚合服务
tests/integration.mjs 在隔离的 cordis Context 中加载插件的 apply()，驱动模拟的 session/event 事件流（既含 format v2+ 的 step/start → request/header → 内嵌流 assistant/message → tool/result 工具循环，也覆盖旧版 assistant/chunk 事件流），断言账本行的时间/速度/路由/工作区字段、HTTP 路由响应，并起一个临时参考服务验证增量推送、水位持久化与远程代理查询。需要本机存在 DSH profile 安装（用于定位 @deepseek-ai/cordis），否则自动跳过。
依赖 DSH 的 session/event 事件流、webServer 服务和 settings.section 插槽。DSH 尚未正式发版，这些接口仍可能变动；插件在这些接口变更后可能需要同步更新。
webServer 服务缺失时（例如 headless profile）只记录账本，不注册 HTTP 路由；远程推送在 webServer 缺失时仍然工作（记账与推送不依赖 webServer）。
Σ输出 tokens ÷ Σ解码耗时）；账本行保留每次调用原始速度（outputTokensPerSec），需要逐次分析时直接读账本。durationMs − firstTokenMs 会非常小、单次 outputTokensPerSec 会异常高——这是记录本身的真实时序，聚合展示已消除其影响；若需要单次速度请以账本行为准并结合 firstTokenMs/durationMs 判断。MIT