codex-429-auto-continue/README.zh-CN.md

Codex 429 自动继续

English

这是一个 Codex Desktop 插件。当 Codex 内置重试耗尽并以 HTTP 429 中断任务时，插件会自动继续原任务。

功能

• 只识别结构化的 response_too_many_failed_attempts HTTP 429 失败记录。
• 每次续跑统一等待 3 秒；每条结构化 429 都会继续触发下一次续跑，不设总次数上限。
• Codex 提供原生重试或继续工具时优先使用；否则只向原任务发送“继续”。
• 通过 SessionStart 支持新建和重新打开的任务，通过 UserPromptSubmit 为安装前已经加载的任务补启动监听。
• 如果 Codex 或用户已经开始新一轮任务，取消当前等待中的续跑。
• 每个任务只运行一个监听进程，避免重复续跑。

运行要求

• Windows 版 Codex Desktop。
• PATH 中可以直接调用 node。

插件目前依赖 Codex Desktop 的本地内部任务工具管道。这个接口不是稳定的公开 API，Codex 更新后可能需要同步适配。

安装

codex plugin marketplace add https://git.crash.work/cneicy/codex-429-auto-continue.git
codex plugin add codex-429-auto-continue@codex-429-auto-continue

安装后新建或重新打开一个任务。如果 Codex 要求审查 hook，请在 /hooks 中批准。

工作方式

监听进程持续读取任务会话记录。发现结构化 429 失败后，先等待 3 秒，再检查是否已经开始新一轮任务；如果没有，就优先调用原生继续能力，不可用时发送“继续”。

任务成功完成后会重置失败链；连续 15 分钟没有由插件发起续跑也会重置。任务结束或会话记录连续 24 小时没有变化时，监听进程退出。

用户提示、助手回复或工具输出中仅仅出现 429 字样，不会触发插件。

本地数据

每个任务的 JSONL 事件日志和锁文件保存在：

%USERPROFILE%\.codex\plugin-data\codex-429-auto-continue

插件不会自行发起网络请求。它只读取本地 Codex 会话记录，并通过本地 Codex Desktop 任务工具管道继续任务。

开发

npm test

可安装插件位于 plugins/codex-429-auto-continue，marketplace 清单位于 .agents/plugins/marketplace.json。

许可证

MIT