61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# 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)
|