正文内容
Codex 认证文件清理工具
通过 CPA 管理 API 清理无效的 codex 认证文件。零依赖(仅使用 Python 标准库)。
首次运行
运行配置向导,设置 CPA URL 与管理员密钥:
python3 scripts/codex_cleaner.py setup
配置将保存至 config.json(自动创建,已加入 .gitignore)。配置优先级:命令行参数 > 环境变量(CPA_URL / CPA_KEY)> config.json。
命令列表
# 查看当前状态
python3 scripts/codex_cleaner.py status
python3 scripts/codex_cleaner.py status --json
# 检查活跃文件,并禁用返回 401 的文件
python3 scripts/codex_cleaner.py check
# 对已禁用文件进行双重验证,随后删除确认为 401 的文件
python3 scripts/codex_cleaner.py delete
# 执行完整清理流程(check + delete),输出人类可读报告
python3 scripts/codex_cleaner.py clean --report
# 执行完整清理流程,输出 JSON 格式结果
python3 scripts/codex_cleaner.py clean --json
# 启动监控循环模式(默认间隔 300 秒)
python3 scripts/codex_cleaner.py monitor -i 300
工作流程
clean = check + delete
check: 获取活跃的 codex 文件 → 并发配额检查 → 禁用返回 401 的文件
delete: 获取已禁用的文件 → 第一次验证(是否仍返回 401?)→ 等待 2 秒 → 第二次验证(是否仍返回 401?)→ 删除
双重验证机制可防止误删临时性故障的文件。
Nanobot 集成
如需周期性监控,可通过 HEARTBEAT 或 cron 定期执行 clean --report,再使用 message 工具将标准输出报告发送给用户。
示例:
cd ~/.nanobot/workspace/skills/codex-cleaner && python3 scripts/codex_cleaner.py clean --report
报告格式