# Codex 429 自动继续

[English](README.md)

这是一个 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 更新后可能需要同步适配。

## 安装

```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)