👁️ 205
👍 68
📅 2026-06-13 收录
🔄 2026-06-13 更新

正文内容

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

报告格式