MetAPI 用量监视器

这是一个用于 KDE Plasma 6 面板的小部件，提供：

• 面板中的滚动用量提示

• 今日金额、令牌用量、成功率、活动账号

• 鼠标悬浮时显示全方位监控面板：

  • 今日指标概览
  • 可用站点观测（实时延迟与可用性）
  • 热门模型分布分析
  • 最新 N 条代理日志（支持应用/模型分列与图标展示）

安装

在仓库根目录执行。

安装到当前用户：

kpackagetool6 -t Plasma/Applet -i "$(pwd)"

修改后升级：

kpackagetool6 -t Plasma/Applet -u "$(pwd)"

也可以直接用脚本：

./install.sh

卸载：

./uninstall.sh

使用

1. 在 Plasma 面板中添加 MetAPI 用量监视器。
2. 打开小部件设置。
3. 填写 主域名（例如 https://ai.icu.im）和 API 令牌。
4. 设置刷新间隔、悬浮日志条数和日志筛选条件。
5. 面板中的滚动条会显示今日用量。
6. 鼠标悬浮时会显示全方位监控仪表盘。
7. 点击小部件会手动触发一次全局刷新。

图标自定义与路由映射

悬浮窗支持根据接口返回的数据自动匹配本地图标库。

1. 添加图标文件

将图标文件（推荐透明 .png 格式）放入以下目录：
contents/ui/assets/

2. 配置路由映射表

编辑 contents/ui/ToolTipContents.qml 文件顶部的 iconMap 属性。映射逻辑基于关键词包含检测（不区分大小写）：

readonly property var iconMap: {
    "models": {
        "openai": "openai",
        "claude": "claude-color",     // 包含 "claude" / "anthropic"
        "zhipu": "zhipu-color",       // 包含 "zhipu" / "glm"
        "qwen": "qwen-color",
        "gemini": "gemini-color",     // 包含 "gemini" / "google"
        "moonshot": "moonshot",       // 包含 "moonshot" / "kimi"
        "minimax": "minimax-color",   // 包含 "minimax" / "abab"
        "microsoft": "microsoft-color", // 包含 "microsoft" / "azure" / "phi"
        "gpt": "openai"               // 通用 GPT 兜底，自动按主题切换 openai-light/openai-dark
    },
    "apps": {
        "vscode": "vscode",   // 应用 ID 包含 "vscode" 时，加载 assets/vscode.png
        "cli": "terminal"
    }
}

3. 主题自适应

代码内置了对 openai 图标的特殊处理：

• 系统为深色模式时，自动加载 openai-light.png
• 系统为浅色模式时，自动加载 openai-dark.png

技术说明

• 接口拼接：只需填写主域名，系统会自动按模块拼接并并发请求 /api/stats/dashboard 与 /api/stats/proxy-logs。
• 数据过滤：站点观测列表会自动过滤掉当日请求数为 0 的非活跃站点。
• 本地计价：为了准确性，金额会基于每条日志的 promptTokens 与 completionTokens 在本地重算。
• 安全：API 令牌加密保存在本地 Plasma 配置中，请勿在公共机器泄露。