Token Config Checker

---

name: token-config-checker description: 批量检测 token / auth JSON 配置文件有效性，并可对 access token 做在线轻量探测，自动输出脱敏报告。适用于排查 Codex/OpenAI/OpenAI 兼容客户端导出的登录配置、会话凭据文件、token 缓存文件。支持把配置分为 valid / no_quota / invalid 三类并分别保存。 Also validates token/auth JSON files such as Codex/OpenAI/OpenAI-compatible exported session configs, supports online probing, redacted reports, and saving valid / no_quota / invalid configs into separate directories.

---

token-config-checker

简体中文 | English

---

简体中文

用于检测包含 access_token / refresh_token / id_token 的 JSON 配置文件是否还有效。

提供内容

scripts/check_token_configs.py：基础版，支持离线检测和可选在线探测

scripts/check_token_configs_plus.py：增强版，支持脱敏输出、失败原因分类、三分类保存、写入报告文件

快速用法

#### 检测单个文件

python3 scripts/check_token_configs.py /path/to/file.json

#### 批量检测目录

python3 scripts/check_token_configs.py /path/to/dir

#### 在线探测 access_token

python3 scripts/check_token_configs.py /path/to/file.json --probe

#### 增强版：按 valid / no_quota / invalid 三分类保存

python3 scripts/check_token_configs_plus.py ./tokens \
  --probe \
  --probe-url https://api.openai.com/v1/models \
  --save-valid-dir ./valid_configs \
  --save-no-quota-dir ./no_quota_configs \
  --save-invalid-dir ./invalid_configs \
  --group-by-type \
  --out report.txt

输出重点

valid_offline：离线结构和过期时间是否正常

online_valid：在线探测是否通过

failure_class：失败分类，例如 token_expired / online_invalid_or_revoked

bucket：最终分类（valid / no_quota / invalid）

注意事项

这类配置文件非常敏感，不要分享原始文件。

对 Codex 配置，在线结果通常比离线判断更重要。

默认探测地址使用 OpenAI 官方接口；如果你使用私有中转或自定义面板，请手动传入 --probe-url。

建议开启 --out 输出报告，便于复查。

---

English

Use this skill to validate JSON config files containing access_token / refresh_token / id_token.

Included scripts

scripts/check_token_configs.py: basic version with offline checks and optional online probing

scripts/check_token_configs_plus.py: enhanced version with redacted output, failure classification, three-bucket saving, and report generation

Quick usage

#### Check one file

python3 scripts/check_token_configs.py /path/to/file.json

#### Batch scan a directory

python3 scripts/check_token_configs.py /path/to/dir

#### Online probe access_token

python3 scripts/check_token_configs.py /path/to/file.json --probe

#### Enhanced: save configs into valid / no_quota / invalid buckets

python3 scripts/check_token_configs_plus.py ./tokens \
  --probe \
  --probe-url https://api.openai.com/v1/models \
  --save-valid-dir ./valid_configs \
  --save-no-quota-dir ./no_quota_configs \
  --save-invalid-dir ./invalid_configs \
  --group-by-type \
  --out report.txt

Key outputs

valid_offline: whether the file looks structurally valid offline

online_valid: whether online probing succeeded

failure_class: failure reason classification

bucket: final bucket (valid / no_quota / invalid)

Notes

These files are highly sensitive. Do not share raw configs.

For Codex-style configs, online probe results are usually more important than offline checks.

Default probe target uses the OpenAI official endpoint; if you use a private relay or custom panel, pass your own --probe-url explicitly.

Prefer --out to generate a reusable report.

These files are highly sensitive. Do not share raw configs.

For Codex-style configs, online probe results are usually more important than offline checks.

Default probe target uses the OpenAI official endpoint; if you use a private relay or custom panel, pass your own --probe-url explicitly.

Prefer --out to generate a reusable report.