AI Quota Dashboard

VSCode 扩展插件 — AI Coding Plan 配额用量仪表盘。实时追踪 GLM Coding Plan、Kimi Membership、Xiaomi MiMo Token Plan 等 AI 服务的配额消耗情况，帮助开发者避免超额使用。

功能特性

支持的服务

安装

从源码安装

# 克隆仓库
git clone https://github.com/Zheng404/ai_quota_dashboard_vscode.git
cd ai_quota_dashboard_vscode

# 安装依赖
npm install

# 编译
npm run compile

# 在 VSCode 中按 F5 启动调试，或打包安装

VSCode 市场（待发布）

搜索 "AI Quota Dashboard" 并安装。

快速开始

1. 安装插件后，点击左侧活动栏的 脉冲图标 (AI 配额) 打开仪表盘
2. 切换到「设置」标签，添加你的 AI 服务：
   • GLM: 输入 API Key（从 GLM 开放平台 获取）
   • Kimi: 输入浏览器 Cookie 中的 JWT Token（按 F12 → Application → Cookies → kimi.com → 复制 kimi-auth 的值）
   • MiMo: 输入浏览器 Cookie（按 F12 → Application → Cookies → platform.xiaomimimo.com → 复制任意 Cookie 值）
3. 返回「仪表盘」标签查看实时配额使用情况

使用指南

命令面板

按 Ctrl+Shift+P (macOS: Cmd+Shift+P)，输入以下命令：

全局设置

在「设置 → 全局设置」中可以调整：

开发

# 编译 TypeScript
npm run compile

# 监听模式开发
npm run watch

# ESLint 检查
npm run lint

# 运行测试
npm test

# 监听模式运行测试
npm run test:watch

环境要求

• VSCode 1.80+
• Node.js 18+

架构

项目采用 ServiceDescriptor 注册表模式，每个 AI 服务是一个完整的「包」：

src/
├── extension.ts              # 扩展入口
├── core/                     # 核心模块
│   ├── types.ts              # 基础类型
│   ├── config.ts             # 配置管理
│   ├── fetch.ts              # HTTP 工具
│   ├── format.ts             # 格式化
│   ├── cache.ts              # 内存缓存 (60s TTL)
│   ├── afk.ts                # AFK 检测器
│   └── *.test.ts             # 单元测试
├── services/                 # 服务层
│   ├── registry.ts           # 服务注册表
│   ├── types.ts              # 接口定义
│   ├── glm/                  # GLM 服务包
│   ├── kimi/                 # Kimi 服务包
│   └── mimo/                 # MiMo 服务包
├── storage/
│   └── persistence.ts        # 历史数据持久化
├── ui/
│   ├── statusbar.ts          # 状态栏管理
│   └── statusBarRenderer.ts  # 状态栏渲染器接口
├── dashboard/                # 侧边栏 Webview
│   ├── webviewView.ts        # WebviewViewProvider
│   ├── styles.ts             # 通用样式
│   └── templates/            # 模板系统
│       ├── index.ts          # 模板组装入口
│       ├── shared.ts         # 共享渲染函数
│       └── settings.ts       # 设置页渲染
├── commands/
│   └── index.ts              # 命令注册
└── test/
    └── mocks/
        └── vscode.ts         # VSCode API mock

新增 AI 服务

1. 在 src/services/ 创建新目录（结构参考 glm/、kimi/ 或 mimo/）
2. 实现 QuotaProvider 接口（provider.ts）
3. 定义扩展数据类型（types.ts）
4. 编写仪表盘卡片模板（template.ts，需注册到 serviceTemplates.{kind}）
5. 编写专属样式（styles.ts）
6. 编写设置元数据（settings.ts）
7. 可选：实现 StatusBarRenderer 接口（statusBar.ts），否则状态栏显示 ?
8. 可选：实现 DetailProvider 接口（provider.ts）+ mergeDetailData，支持仪表盘详情懒加载。两者需同时提供
9. 组装 ServiceDescriptor（index.ts）
10. 在 src/services/registry.ts 注册

数据流

pollAll() 定时触发
    │
    ├─ AFK 检测（超阈值则跳过）
    ├─ 遍历启用的 ServiceProfile
    │   ├─ 检查内存缓存 (60s TTL)
    │   ├─ resolveProvider(kind) → QuotaProvider.fetch(key, endpoint)
    │   ├─ 返回 ServiceData
    │   └─ attachHistory() 合并历史数据
    │
    ├─ StatusBar.feed() → flush()
    ├─ DashboardWebviewViewProvider.update() → postMessage
    └─ saveHistory() → globalState 持久化

配置存储

技术栈

已知问题

1. 配置未完全接入 VSCode Settings API — 代码仍读写 globalState
2. Webview JS 为字符串拼接，无类型检查
3. warnThreshold 配置声明但未实际触发警告通知

License

MIT © Zheng404