Agent Skills
返回列表
🔒

Token 配置有效性检测

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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,需要目录级批量扫描与报告