dsh-token-usage

dsh-token-usage

Token 用量看板插件，用于 DSH（DeepSeek Harness）。

按本机时区记录每次模型调用的 token 消耗，并把「攒了多少」做成看得见的方块墙。

• 方块墙：每 10M tokens 填一格，100 格一页，累计只增不减
• 桌宠：常驻角落里的小面板，一个充能块 + 一个池，可拖动
• 消耗分布：按工作区 / 模型 / 厂商三档切换
• 设置页：区间汇总表，支持按天 / 周 / 月 / 渠道 / 模型 / 类型分组
• 历史回填：从已有会话日志补齐历史，不是装上才开始记
• 实时捕获：之后每次模型调用即时入账

---

安装

本插件以 Cordis bundle 形式发布，宿主是 DSH 的 Web profile。

方式一：放进 profile 的依赖目录

## 配置

在 profile 的 `cordis.patch.yml` 里覆盖，插件升级不会丢：

```yaml
- id: dsh-token-usage
  name: 'dsh-token-usage'
  config:
    keepDays: 400              # 保留天数（落盘时淘汰更早的日键）
    includeSubagents: true     # 计入子代理 / 团队 / workflow 子会话
    includeAuxiliary: true     # 计入压缩等辅助调用
    statusBarEnabled: true     # 是否允许显示输入框上方的横幅
    statusBarRefreshMs: 1000   # 轮询间隔，最小 1000
    backfillOnStart: true      # 启动时回填历史

    # 可选：手动声明模型别名（认不出的模型可以在这里归类）
    modelAliases:
      dfmodel:
        vendor: deepseek
        model: deepseek-v4.1-flash

开关有两层，分别管什么

	位置	生效方式	用途
config.statusBarEnabled	cordis.patch.yml	重启 DSH	部署期的硬开关
设置页三个开关	$DSH_HOME/token-usage/prefs.json	立即生效	日常调整

设置页那三个开关存在独立文件里，是因为改 Cordis config 要重启，而「我想把桌宠关掉」显然不该重启。

---