Token 配置有效性检测
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/joe12801-token-config-checker-114。
技能介绍
这类配置文件为什么容易「看上去能用」
本地堆着一批 access_token、refresh_token、id_token 混在一起的 JSON(常见于 Codex 或各类 API 中转配置)。仅靠肉眼看文件还在、字段齐全,并不能判断令牌是否已过期、是否被吊销,或账号是否已无配额。等到真正发起调用时才发现 401,排查成本很高。
技能如何帮你做校验
技能提供两条 Python 脚本路径,可按场景选用:
scripts/check_token_configs.py:基础版,支持单文件与目录批量扫描,先做离线结构校验与过期时间判断,并可选择对access_token做在线探测。scripts/check_token_configs_plus.py:增强版,在基础能力上增加脱敏输出、失败原因分类(如token_expired、online_invalid_or_revoked),并按valid/no_quota/invalid三分类归档,同时可写入报告文件(建议配合--out)。
你会在输出里看到几个关键字段:valid_offline(离线是否通过)、online_valid(在线探测是否成功)、failure_class(失败归类)、bucket(最终分桶)。对 Codex 一类配置,在线结果往往比纯离线判断更可信。
边界与注意点
配置文件含长期凭证,不要分享原始文件或把未脱敏内容贴进工单。默认在线探测走 OpenAI 官方接口;若你用的是私有中转或自建面板,需要自行传入 --probe-url,否则在线结论会对不上真实环境。
使用场景
- 迁移或轮换 API 密钥前,需要批量确认机器上遗留的 JSON 令牌配置哪些仍可调用
- 在 Codex 中转环境里排查间歇性 401,要先区分是过期、吊销还是配额耗尽
- 整理 `~/.config` 下多份 token 配置文件,按 valid / no_quota / invalid 归档便于后续删除或续期
- 发布运维变更后复查敏感配置目录,生成脱敏报告留档而不暴露原始 token
适合人员
- 负责多台开发机或跳板机上 API 配置文件巡检的 SRE,需要离线加在线结论而不是手测 curl
- 维护公司内部 Codex / OpenAI 中转面板的后端工程师,要在用户报错前筛出失效 token
- 安全合规同事定期抽查开发者本机 token 配置文件,要求脱敏输出与分类归档
- 每次密钥轮换后要清点遗留 JSON 配置文件的 DevOps,需要目录级批量扫描与报告