> 查询各平台 Coding Plan 的套餐用量和重置倒计时，推荐搭配 [ccstatusline](https://github.com/sirmalloc/ccstatusline) / [ccstatusline-zh](https://github.com/huangguang1999/ccstatusline-zh) 的自定义命令放在 Claude Code 状态栏查看。
## 支持的套餐
| 套餐 | 获取方式 |
| :-------------------------------: | :---------------------: |
| 火山方舟 Coding Plan / Agent Plan | 火山引擎 OpenAPI(AK/SK) |
| Ollama Cloud | 页面 HTML 解析(cookie) |
| OpenCode Go | 页面 HTML 解析(cookie) |
| 阿里云千问 Token Plan | 控制台内部 API(cookie) |
## 效果预览
> 运行 `scripts/preview.cmd`（或 `node src/tools/preview.mjs`）可用模拟数据预览显示效果。
## 项目结构
```text
coding-plan-usage-query/
├── config/
│ ├── config.example.json # 配置模板
│ └── config.schema.json # JSON Schema 校验
├── docs/
│ ├── CHANGELOG.md # 更新日志
│ ├── README_EN.md # 英文版 README
│ └── preview.png # 效果预览图
├── scripts/
│ ├── login-opencode.cmd # Windows 双击登录 OpenCode Go
│ ├── login-qwen.cmd # Windows 双击登录千问
│ ├── preview.cmd # Windows 双击预览显示效果
│ └── query-usage-all.cmd # Windows 双击运行（UTF-8 chcp 65001）
├── src/
│ ├── login/
│ │ ├── login-opencode.mjs # OpenCode Go 登录
│ │ └── login-qwen.mjs # 千问登录
│ ├── query/
│ │ ├── query-usage-all.mjs # 查询全部套餐（并行）
│ │ ├── query-usage-ark.mjs # 火山方舟用量查询
│ │ ├── query-usage-ollama.mjs # Ollama Cloud 用量查询
│ │ ├── query-usage-opencode-go.mjs # OpenCode Go 用量查询
│ │ ├── query-usage-qwen.mjs # 千问 Token Plan 用量查询
│ │ └── query-usage-smart.mjs # 智能查询：根据实际使用的套餐自动匹配（带缓存）
│ ├── tools/
│ │ ├── colorful-tokens.mjs # 上下文 token 数按阈值着色
│ │ ├── get-actual-model-name.mjs # 获取实际模型名称
│ │ ├── get-actual-provider-name.mjs # 获取实际供应商名称
│ │ └── preview.mjs # 生成模拟用量预览输出
│ └── utils/
│ ├── utils-cc-switch.mjs # CC-Switch 工具
│ ├── utils-login.mjs # 登录公共逻辑（Playwright、profile、写回 config）
│ └── utils-query-usage.mjs # 共享工具函数
├── test/ # 单元测试（node --test）
└── tmp/ # 查询结果缓存与登录 profile（自动生成，已 gitignore）
```
各查询脚本为「导出函数 + CLI 壳」双入口：既可直接 `node` 运行，也被 `smart`/`all` 以进程内函数调用，避免子进程启动开销。
## 前置要求
- Node.js 22.13 或更高版本（使用 `node:sqlite` 内置模块，实验性警告已自动屏蔽）
## 快速开始
### 1. 创建配置文件
将 `config/config.example.json` 复制为 `config/config.json`。
### 2. 填写配置文件
打开 `config.json`，按 `config.schema.json` 中的字段说明填入凭据：
- **火山方舟 Coding Plan / Agent Plan**：在火山引擎控制台创建 AccessKey，填入 `accessKeyId` 和 `secretAccessKey`
- **Ollama Cloud**：根据 `config.schema.json` 提示填写 `cookie`
- **OpenCode Go**：运行 `login-opencode.cmd` 自动写入 `authCookie` 和 `workspaceID`，或根据 `config.schema.json` 提示填写
- **阿里云千问 Token Plan**：运行 `login-qwen.cmd` 自动写入 `cookie`，或根据 `config.schema.json` 提示填写
详细说明见下方 [配置文件说明](#配置文件说明)。
### 3. 运行查询
```bash
# 智能查询：根据实际使用的套餐自动匹配（带缓存）
node src/query/query-usage-smart.mjs
# 查询所有套餐
node src/query/query-usage-all.mjs
# 火山方舟（用账号 type 配置，默认 coding）
node src/query/query-usage-ark.mjs
# 火山方舟 Agent Plan（强制指定）
node src/query/query-usage-ark.mjs --type agent
# Ollama Cloud
node src/query/query-usage-ollama.mjs
# OpenCode Go
node src/query/query-usage-opencode-go.mjs
# 阿里云千问
node src/query/query-usage-qwen.mjs
# 使用浏览器登录千问，自动读取凭据
node src/login/login-qwen.mjs
# 使用浏览器登录 OpenCode Go，自动读取凭据
node src/login/login-opencode.mjs
# 指定账号位置（从 0 开始）
node src/query/query-usage-ark.mjs --position 1
# 预览显示效果
node src/tools/preview.mjs
```
> 上述命令也可通过 npm scripts 快捷运行：`npm run query`（smart）、`npm run query:all`、`npm run query:ark`/`query:ollama`/`query:opencode`/`query:qwen`（各套餐）、`npm run login:qwen`/`login:opencode`（登录）。透传参数时需加 `--`，如 `npm run query:ark -- --type agent`。
## 命令行参数
查询脚本支持以下参数：
| 参数 | 缩写 | 说明 |
| :---------------------------: | :--: | ------------------------------------------------------------------------------------------------------------------ |
| `--display` | `-d` | 显示模式：`auto`（默认，`a`）/ `long`（`l`）/ `short`（`s`） |
| `--type` | `-t` | 火山方舟套餐类型：`coding`（`c`）/ `agent`（`a`），未传时用账号 `type` 配置，再回退 `coding`（all/smart 脚本忽略） |
| `--position` | `-p` | 账号位置（从 0 开始，默认 0） |
| `--hide-on-monthly-exhausted` | - | 月额度耗尽时隐藏该条查询（`true`/`false`，默认 `false`，smart 脚本忽略该参数） |
| `--hide-on-no-active-plan` | - | 无活跃套餐时隐藏该条查询（`true`/`false`，默认 `false`，仅 `all` 脚本生效） |
> 登录脚本（`login-qwen`/`login-opencode`）仅支持 `--position`/`-p` 参数。`position` 取 0~N（N 为当前账号数）：`< N` 更新已有账号，`= N` 新建第 N+1 个账号；越界时会提示重新输入，开浏览器前会要求确认。
## 配置文件说明
配置文件 `config/config.json` 顶层为 JSON 对象，包含 `ark`、`ollama`、`opencode`、`qwen` 四个数组，分别对应火山方舟、Ollama、OpenCode、千问的账号列表，每个数组支持多账号。`apiKey` 字段用于 `query-usage-smart.mjs` 匹配当前供应商，不使用 smart 脚本可不填。
### 火山方舟 Coding Plan / Agent Plan
```json
{
"ark": [
{
"shortLabel": "Coding",
"longLabel": "火山Coding",
"apiKey": "xxx",
"type": "coding",
"accessKeyId": "xxx",
"secretAccessKey": "xxx"
},
{
"shortLabel": "Agent",
"longLabel": "火山Agent",
"apiKey": "xxx",
"type": "agent",
"accessKeyId": "xxx",
"secretAccessKey": "xxx"
}
]
}
```
| 字段 | 必填 | 说明 |
| :------------------------: | :--: | -------------------------------------------------------------- |
| `type` | 否 | 套餐类型：`coding`（默认）或 `agent` |
| `longLabel` / `shortLabel` | 否 | 显示标签，不填使用默认值（火山Coding/Coding、火山Agent/Agent） |
| `accessKeyId` | 是 | 火山引擎 AccessKey ID |
| `secretAccessKey` | 是 | 火山引擎 SecretAccessKey |
| `apiKey` | 否 | CC-Switch 里填的 API Key，smart 脚本据此匹配账号 |
在火山引擎控制台