headroom-stats-plugin

如果你已经在用 Headroom 压缩代理来降低 DeepSeek Harness 的 token 开销，你一定体会过那种小摩擦：节省数据安安静静写在一个 JSON 文件里，而 DSH 界面却什么都不显示。headroom-stats-plugin 就是来补上这一环的——它把数字拉到你真正会看的地方。设置页里有一块完整的仪表盘，展示累计 KPI（节省 token 数、压缩节省金额、缓存节省金额、请求总数）以及前 10 个项目明细表；聊天输入框下方则常驻一行统计，每 5 秒刷新一次，扫一眼就能看到当前会话的节省情况。

插件采用纯拉取、纯只读模型：每 5 秒读取一次 proxy_savings.json，从不写入 Headroom 目录，不发起网络请求，也不使用文件监听。数据文件缺失或解析失败时，统计行直接隐藏而非报错，数据恢复后 5 秒内自动回归。路径解析遵循 HEADROOM_SAVINGS_PATH、HEADROOM_WORKSPACE_DIR 和用户目录回退，无需硬编码。颜色全部由 DSW 设计令牌驱动，自动跟随明暗主题。安装为 profile 插件后跨重启持久生效，无需每次会话手动定义。

它面向的是日常在 DSH 与 Headroom 代理之间工作的开发者——想让 token 和成本节省一目了然，不必翻终端、不必另开浏览器标签页，打开设置或瞄一眼输入框下方就够了。