CC Toolkit

AI 服务用量查询工具集，用于快速查询多家 AI 平台的账户余额和资源包使用情况。脚本以 JavaScript 对象字面量表达式形式编写，由 cc-switch 在 QuickJS 沙箱环境中加载并执行。

支持的平台

官方接口（API Key 认证）

自定义接口

项目结构

scripts/                                # 本地开发辅助脚本（Node.js 18+）
├── fetch.js                            # 余额查询（加载平台脚本 + 发请求 + 格式化输出）
└── raw-fetch.js                        # 裸 fetch 调试工具（轻量 curl 替代品）
.node-version                           # Node.js 版本锁定
.env                                    # 非敏感默认配置（PLATFORM、URL），提交到 git
.env.example                            # 敏感配置模板（API_KEY、COOKIE），复制为 .env.local 使用

src/
├── usage-query/
│   ├── official/                       # 官方 API 接口查询脚本
│   │   ├── DeepSeek/index.js
│   │   ├── Kimi/
│   │   │   ├── index.js                # 国内版
│   │   │   └── index-en.js             # 国际版
│   │   ├── Novita-AI/index.js
│   │   ├── OpenRouter/index.js
│   │   ├── SiliconFlow/
│   │   │   ├── index.js                # 国内版
│   │   │   └── index-en.js             # 国际版
│   │   └── StepFun/
│   │       ├── index.js                # 国内版
│   │       └── index-en.js             # 国际版
│   ├── custom/                         # 非官方 / 逆向工程接口查询脚本
│   │   ├── MiniMax/index.js
│   │   ├── Xiaomi-MiMo/
│   │   │   ├── index.js                # 余额
│   │   │   └── token-plan.js           # 套餐用量
│   │   └── Zhipu-GLM/
│   │       ├── index.js                # 余额
│   │       └── resource-package.js     # 资源包
│   ├── utils.js                        # 工具函数参考模板（各脚本内联实现）
│   └── JSON_RESPONSE_EXAMPLES.js       # 各平台响应格式示例
└── fetch-models/
    └── JSON_RESPONSE_EXAMPLES.js       # 模型列表响应格式示例

本地查询

项目提供两个 Node.js 脚本，无需 cc-switch 即可在本地直接查询余额：

# 首次使用：配置密钥
cp .env.example .env.local
# 编辑 .env.local，填入 API_KEY=sk-xxx（或 COOKIE=xxx）

# 查询余额（读 .env 的 PLATFORM + .env.local 的 API_KEY）
node scripts/fetch.js

# 指定平台
node scripts/fetch.js DeepSeek
node scripts/fetch.js Kimi --key=sk-xxx

# 裸 fetch 调试（直接传 URL）
node scripts/raw-fetch.js https://api.deepseek.com/user/balance -k sk-xxx

配置优先级：CLI 参数 > .env.local > .env。详见 node scripts/fetch.js -h。

脚本规范

每个查询脚本导出一个对象（必须用 () 包裹），包含 request 和 extractor 两个字段：

;({
  request: {
    url: 'https://api.example.com/v1/balance',
    method: 'GET',
    headers: {
      Authorization: 'Bearer {{apiKey}}',
      'User-Agent': 'cc-switch/1.0',
    },
  },
  extractor(response) {
    // 解析响应，返回单个套餐对象或套餐对象数组（所有字段均为可选）
    return {
      planName: '套餐名称',
      remaining: 100,
      total: 200,
      used: 100,
      unit: 'CNY',
      isValid: true,
      invalidMessage: undefined,
      extra: '详细信息字符串',
    }
  },
})

• {{apiKey}} 会在运行时自动替换；多数脚本使用硬编码 URL，{{baseUrl}} 为可选占位符
• Cookie 认证（Xiaomi MiMo）在 request.headers 中设置 Cookie，由 cc-switch 注入 Web 登录态
• extractor 可返回单个对象（单套餐）或对象数组（多币种、多资源包、多套餐）
• extractor 在 QuickJS 沙箱中执行，支持 ES2020+ 语法，不支持 Node.js API

开发细节（工具函数、开发模式、命名约定、测试方法）见 CLAUDE.md。

Star History

License

MIT © 5-seasons