API-Meter

API 余额桌面看板 — 一站式监控多家 AI 服务商账户余额

---

简介

API-Meter 是一款轻量级桌面应用，用于实时监控多家 AI API 服务商的账户余额。支持系统托盘常驻、自动刷新、本地安全存储，让你随时掌握各平台消费情况。

功能特性

• 多服务商支持 — DeepSeek、小米 MiMo、Kimi、SiliconFlow、通义千问、百川等
• 自定义服务商 — 可添加任意兼容的 API 服务商
• 实时余额查询 — 一键获取各平台余额明细（总余额、可用余额、赠送额度、充值余额）
• 自动定时刷新 — 支持 30s / 1min / 5min 间隔自动同步
• 系统托盘常驻 — 最小化到托盘，支持右键菜单快速操作
• 本地安全存储 — API Key 通过系统密钥链（Windows Credential Manager / macOS Keychain / Linux Secret Service）加密存储
• 余额数据缓存 — 离线时仍可查看上次同步的余额快照

截图

技术栈

层级	技术
前端框架	Vue 3 + TypeScript
构建工具	Vite 6
UI 组件库	Naive UI
状态管理	Pinia
桌面框架	Tauri 2 (Rust)
HTTP 客户端	Reqwest (Rust)
凭据存储	keyring crate

快速开始

环境要求

• Node.js >= 18
• Rust >= 1.75
• Tauri 2 Prerequisites

安装依赖

# 安装前端依赖
npm install

# Rust 依赖会在首次构建时自动拉取

开发模式

npm run tauri:dev

启动后会同时运行 Vite 开发服务器和 Tauri 窗口，支持前端热更新。

生产构建

npm run tauri:build

构建产物位于 src-tauri/target/release/bundle/，包含安装包和可执行文件。

项目结构

API-Meter/
├── src/                        # 前端源码
│   ├── components/             # Vue 组件
│   │   ├── ApiOverviewGrid.vue # 服务商卡片网格
│   │   ├── BalanceOverview.vue # 余额总览面板
│   │   ├── ApiKeyPanel.vue     # API Key 管理
│   │   ├── RefreshPanel.vue    # 刷新策略配置
│   │   └── MetricTile.vue      # 指标卡片
│   ├── stores/balance.ts       # Pinia 状态管理
│   ├── lib/tauri.ts            # Tauri API 桥接
│   ├── App.vue                 # 根组件
│   └── styles.css              # 全局样式
├── src-tauri/                  # Rust 后端
│   ├── src/
│   │   ├── main.rs             # Tauri 入口
│   │   ├── tray.rs             # 系统托盘
│   │   ├── commands/           # Tauri 命令
│   │   └── providers/          # 各服务商 API 适配
│   ├── Cargo.toml
│   └── tauri.conf.json         # Tauri 配置
├── scripts/                    # 工具脚本
│   └── generate_icons.py       # 图标生成
├── package.json
└── README.md

支持的服务商

服务商	状态	说明
DeepSeek	已支持	完整余额查询
小米 MiMo	已支持	仅状态探测（官方暂未开放余额接口）
Kimi (Moonshot)	已支持	完整余额查询
SiliconFlow	已支持	完整余额查询
通义千问 (Qwen)	已支持	完整余额查询
百川	已支持	完整余额查询
自定义服务商	已支持	用户自行配置 API 端点

配置说明

添加自定义服务商

1. 点击主界面右下角「+ 添加服务商」
2. 填写服务商名称、API 端点 URL 和认证方式
3. 保存后即可在卡片网格中查看余额

API Key 存储

所有 API Key 均通过操作系统原生密钥链存储：

• Windows: Windows Credential Manager
• macOS: Keychain
• Linux: Secret Service (GNOME Keyring / KWallet)

应用本身不保存任何明文凭据。

开发

常用命令

# 前端开发（仅浏览器预览，使用 mock 数据）
npm run dev

# Tauri 开发模式（完整桌面应用）
npm run tauri:dev

# 类型检查
npm run build

# 生产构建
npm run tauri:build

Mock 数据

在浏览器中运行 npm run dev 时，应用会自动使用 mock 数据进行预览，无需 Tauri 运行时。Mock 代码仅在开发环境生效，生产构建中会被完全移除。

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 开启 Pull Request

许可证

本项目基于 MIT License 开源。

致谢

• Tauri — 轻量级跨平台桌面应用框架
• Vue.js — 渐进式 JavaScript 框架
• Naive UI — Vue 3 组件库