llm-dsh-token-usage
DSH 侧边栏令牌使用统计：当前配置文件中每个会话的每日令牌使用量。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ai-v5/LLMDSHPlugin_token-usage#ad04a8598bb3c24377cb7e21e54ce4eb82b09540Llm Dsh Token Usage 以 llm-dsh-token-usage 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness (DSH) 插件：在桌面端/Web 端侧边栏左下角增加 Token 统计，按天汇总当前 profile 下所有 Session 的 token 用量。
inputTokens、outputTokens、cacheReadTokens、cacheWriteTokens。~/.dsh/token-usage-ledger.json；Session 归档或删除后历史仍然保留。要求 DSH Desktop / Web 已安装，且 profile 中已启用 @deepseek-ai/dsh-base。
从本地目录安装到 Desktop profile：
dsh plugin --profile desktop add D:\WORK\ai-v5\LLMDSHPlugin_token-usage
或直接从 GitHub 安装：
dsh plugin --profile desktop add github:ai-v5/LLMDSHPlugin_token-usage
安装后重启 DSH Desktop。插件会出现在左侧栏底部 Settings 上方（同一区域还有 Cordis 入口）。如果终端里没有 dsh 命令，可使用 DSH Desktop 安装目录下的 resources\runtime\cli\bin\dsh.cmd。
从旧的 LLMDSHPlugin monorepo 迁移：重新执行上面的
add命令指向本仓库，旧的plugins\token-usage链接会失效。
卸载：
dsh plugin --profile desktop remove llm-dsh-token-usage
ctx.sessionQuery：先 listSessions()，再读取每个 Session 的完整事件日志。assistant/message 或 assistant/attempt 的 provider usage 都会计入；同一 turn/step 的后续样本会替换前一样本，llm/retry-started 之后的 attempt 单独累计。compaction/summary 自带的 usage 也会计入（压缩调用不在 agent loop 的 step 内，日志里只有这一条记录）。totalTokens = inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens，其中包含 prompt cache 命中读取；面板同时展示不含 cache read 的 inputOutputTokens。inheritedEventCount 排除。Host 端注册只读路由：
GET /api/llm-token-usage/stats?range=all&refresh=1
也兼容 ?days=7|14|30|90 的有界范围。返回：
{
"generatedAt": 1760000000000,
"days": 366,
"rangeKind": "all",
"seriesTruncated": false,
"range": { "from": "2025-10-19", "to": "2026-10-18" },
"today": { "date": "2026-10-18", "inputTokens": 0, "outputTokens": 0, "cacheReadTokens": 0, "cacheWriteTokens": 0, "totalTokens": 0, "inputOutputTokens": 0, "sessions": 0 },
"totals": { "...": "same shape as today" },
"allTime": { "...": "same shape as today" },
"series": [{ "date": "2025-10-19", "...": "same shape as today" }],
"sessionCount": 0,
"skippedSessions": 0,
"incomplete": false,
"activity": {
"turns": 0,
"steps": 0,
"generationMs": 0,
"timedOutputTokens": 0,
"tokensPerSecond": 0
}
}
activity 为全部历史汇总：turns/steps 来自 turn/start/step/start；tokensPerSecond = timedOutputTokens / (generationMs / 1000)，只统计带流式时间戳的 Assistant 调用。
Host 结果缓存 1 小时；refresh=1 跳过缓存并重新扫描。浏览器端在 localStorage 缓存最近一次成功结果：面板打开时优先显示缓存，缓存不足 1 小时不发请求，超过 1 小时才后台刷新；手动刷新不受此限制。
skippedSessions 提示。~/.dsh/token-usage-ledger.json 会重置历史汇总。node --test tests/stats.test.mjs
node --check lib/stats.js
node --check index.js
node --check client.js
项目本身不需要构建：index.js 是 Host 半部，client.js 是浏览器半部，locale/*.json 提供插件管理页显示名称。
设计上参考了 MIT 许可的 HaoyueQin/dsh-usage-statistics-panel 的按天口径与 footer 面板布局；本仓库代码是独立实现，没有复制其源码。
MIT