用量 (Usage Dash)

HanaAgent 插件：Token 消耗仪表盘。按 Agent、模型、时间维度查看用量统计与供应商余额。

完全独立实现的用量面板，不含任何第三方插件衍生代码。

功能

• 摘要卡片：总消耗、输入、输出、缓存命中率、请求次数
• 余额监控：自动读取供应商配置，显示 DeepSeek / GLM 余额，低余额预警
• 消耗趋势图：按天/小时柱状图（桌面+频道堆叠），叠加缓存命中率折线
• 模型占比：环形图展示各供应商/模型的消耗分布
• 筛选：今天/本周/本月/全部 + 自定义日期 + Agent + 模型
• 自动主题：跟随 HanaAgent 宿主暖纸/青夜主题

结构

usage-dash/
├── index.js              # 生命周期
├── manifest.json         # 插件元数据
├── lib/
│   ├── scanner.js        # 异步流式会话扫描 + 缓存
│   ├── aggregator.js     # 管道化数据聚合
│   └── balance.js        # 供应商余额查询
├── routes/
│   └── dashboard.js      # HTTP 路由
└── app/
    ├── index.html        # 页面模板
    ├── app.js            # 前端 SPA
    ├── layout.css        # 布局骨架
    └── palette.css       # 暖纸/青夜色板

安装

在 HanaAgent 设置 → 插件 → 本地安装，选择 usage-dash.zip。

配置

• 扫描间隔：默认 60 秒
• 余额预警阈值：DeepSeek 余额低于此值（元）时卡片变红

DeepSeek / GLM API Key 在 HanaAgent 设置中统一管理（added-models.yaml），插件自动读取。