feat: publish Codex 429 auto-continue plugin

This commit is contained in:
2026-09-11 01:29:34 +08:00
commit 6661bf26f1
14 changed files with 990 additions and 0 deletions
+60
View File
@@ -0,0 +1,60 @@
# Codex 429 自动继续
[English](README.md)
这是一个 Codex Desktop 插件。当 Codex 内置重试耗尽并以 HTTP 429 中断任务时,插件会自动继续原任务。
## 功能
- 只识别结构化的 `response_too_many_failed_attempts` HTTP 429 失败记录。
- 每次续跑统一等待 3 秒;同一失败链最多由插件发起四次续跑。
- Codex 提供原生重试或继续工具时优先使用;否则只向原任务发送“继续”。
- 通过 `SessionStart` 支持新建和重新打开的任务,通过 `UserPromptSubmit` 为安装前已经加载的任务补启动监听。
- 如果 Codex 或用户已经开始新一轮任务,取消当前等待中的续跑。
- 每个任务只运行一个监听进程,避免重复续跑。
## 运行要求
- Windows 版 Codex Desktop。
- `PATH` 中可以直接调用 `node`。
插件目前依赖 Codex Desktop 的本地内部任务工具管道。这个接口不是稳定的公开 API,Codex 更新后可能需要同步适配。
## 安装
```powershell
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 事件日志和锁文件保存在:
```text
%USERPROFILE%\.codex\plugin-data\codex-429-auto-continue
```
插件不会自行发起网络请求。它只读取本地 Codex 会话记录,并通过本地 Codex Desktop 任务工具管道继续任务。
## 开发
```powershell
npm test
```
可安装插件位于 `plugins/codex-429-auto-continue`,marketplace 清单位于 `.agents/plugins/marketplace.json`。
## 许可证
[MIT](LICENSE)