dsh-token-usage

DeepSeek Harness 的 Token 消耗看板插件，挂载在 设置 → Token 用量

功能

• 总览：总量、输入(未缓存)、缓存读、缓存写、输出、请求数卡片，近 14 天趋势图，模型占比
• 按日期：近 120 天每日堆叠图与明细表
• 按模型：provider/model 明细与占比
• 数据源为会话日志 assistant/message 事件的 provider 上报用量；fork 会话继承历史不重复计数；服务端 60 秒缓存
• 界面全部走 --dsw-* 主题 token，与宿主深浅色主题一致；文案随 locale 中英切换

安装

要求：DSH 0.1.0-rc 系列，dsh web 部署，node 在 PATH

git clone git@github.com:felixzhang-glitch/dsh-token-usage.git
cd dsh-token-usage
./install.sh

脚本自动完成

1. 复制插件包到 ~/.dsh/profiles/web/dsh-token-usage/
2. 建立模块解析符号链接（profile 树 + DSH 运行树 node_modules，运行树自动探测）
3. 在 ~/.dsh/profiles/web/cordis.patch.yml 幂等追加挂载行

完成后重启 DSH，刷新页面，设置 → Token 用量

运行树自动探测失败时手动指定：./install.sh <含 @deepseek-ai/dsh 的 node_modules 根目录>

卸载

./uninstall.sh [DSH_ROOT]

移除挂载行（留备份 cordis.patch.yml.bak-uninstall）、符号链接与插件目录，重启生效

结构

package.json      # 双面声明：exports + dsh.client
lib/index.js      # host 半：注册 GET /token-usage/stats，扫描会话日志聚合
lib/client.js     # client 半：settings.section 三视图 UI
install.sh        # 安装脚本（幂等）
uninstall.sh      # 卸载脚本

兼容性

• 依赖契约：sessionQuery.listSessions/readSession、webServer.register、settings.section 槽位、--dsw-* token、ModuleLoader 包装格式
• 验证版本：DSH 0.1.0-rc.6

维护

dsh 经 npx 升级会重建缓存目录，运行树符号链接失效，启动时该行加载失败；重跑 install.sh 即修复

开发·维护·部署文档见 dsh-plugin-guide.md（发布包内），插件市场见 github.com/topics/dsh-plugin