Codex Continuer

监测 Codex 账户额度，在额度恢复后接续指定工作，或在当前工作完成后接续完成约定内容，并通过跟随 Codex 窗口的桌面挂件查看状态。

开发版本：0.7.0 · Windows x64 预览版 · GPL-3.0-only。

功能

• 显示短期、长期定量与重置倒计时；数据未知或超过 90 秒等待新样本
• 导入原聊天，确认前期并恢复后，向原聊天发送一次约定消息
• 监测是否形成完整回答，并发送约定消息
• 新建带目标并验收标准的工作，按限额、轮次上限和中间状态推进
• 提供简洁的仪表、任务面板、托盘、窗口紧随独立显示；隐藏时暂停界面订阅和动画
• 本地保存任务与备份，提供存储恢复；所有本地 API 都需要访问凭据

紧凑仪表	任务面板

截图使用演示数据，拍摄于旧版，仅供界面参考。

相对上版本的改动

• 你现在可以设置一个自定义消息，它会在你设定的工作区的那个对话形成完整回复后发送你编辑的消息，这样你就可以去做别的事情
• 额度显示兼容了更多的套餐，解决了非标准额度周期误标的问题
• 处理了一次性工作等待额度后卡住的问题
• 解决了语言切换后会解除提交锁的问题
• 处理了退出后重新启用无效的问题
• 解决了保存失败后重试会发生重复或卡住的问题
• 此外，还解决了14个比较次级的问题

安装

运行需要 Windows x64、Node.js 22.12+（推荐 24），以及已安装、登录并支持插件的 Codex CLI。原聊天接续还需要支持 queue --thread --message 的桌面 CLI。源码编译额外需要 Visual Studio Build Tools 的 MSBuild/Roslyn；便携包不需要编译工具。

从源码安装

git clone https://github.com/empty610/codex-continuer.git
cd codex-continuer
.\Install-Plugin.ps1

安装器先检查 Node/Codex 能力，再安装依赖和 Electron、构建插件、注册本地市场并打开挂件。首次安装后重载 Codex 插件或打开新聊天。打开挂件不会开启调度。

使用便携包

可从通过检查的 Actions 构建 下载 continuer-windows-portable 产物。完整解压后，在包含隐藏目录 .agents 的市场根目录执行：

.\Install-Portable.ps1 -Open

不要移动或删去包内文件。完整安装与卸载步骤见 便携包说明。

使用

1. 在 Codex 中让插件“打开 Continuer 挂件”，也可从源码或插件目录运行 Open-Widget.cmd。
2. 导入已有会话后保持暂停；检查所选聊天，再手动开启额度监测。新建工作需要填写项目绝对路径、目标和验收标准。
3. 明确开启调度或继续工作后才执行。点击仪表展开，拖动移动；Ctrl+Alt+C 展开面板，右键或托盘可调整跟随与显示。

两种模式的含义：

模式	接续行为	停止条件
导入原聊天	一次确认的耗尽恢复周期，向原聊天发送一次自定义续作消息，留空发送“继续”；备注保存在本地并展示在首页卡片	暂停、发送次数到限或发送结果不确定；不自动识别原聊天目标完成
新建工作	按原始目标启动执行轮次，要求结构化完成结果	完成、阻塞、无工具活动或轮次到限；模型报告完成仍需核对验收

Start-Continuer.ps1 打开原生挂件；浏览器凭据链接已停用。本地客户端通过固定证书校验服务身份后才发送凭据。隐藏到托盘仍保留运行；点击关闭按钮或选择“退出 Continuer”会保存状态、停止后台服务和监听器，并结束进程。停止超时后仅清理经安装路径核验的所属服务进程树。退出后，普通状态查询和自动启动不会重新拉起；手动打开挂件可恢复。

启用或关闭随 Codex 启动：

.\Enable-Autostart.ps1
.\Enable-Autostart.ps1 -Disable

卸载时在实际安装的插件目录运行 Uninstall-Plugin.ps1，依次关闭自启动、停止服务、退出挂件并移除插件。任务数据会保留。

开发与验证

npm ci
node node_modules/electron/install.js
npm run check
npm run check:public
npm test
npm run doctor
npm run build:release

doctor 只检查版本和帮助信息，不调用模型或发送消息。测试使用独立数据与模拟 RPC/队列，并包含隐藏 Electron 窗口检查。本机已通过 243 项回归；托管 CI 状态以上方徽章和对应提交的工作流结果为准。

build:release 生成便携压缩包、同版本源码归档、release.json 和 SHA256SUMS。分发二进制时须配套提供源码归档。编译器可通过 CONTINUER_CSC 指定。

范围与隐私

• 当前主要验证 Windows x64、Node.js 24、Codex CLI 协议基线 0.153.2；外部接口升级可能需要适配。
• 界面支持中文和英文；续作消息可在加入工作时自定义，每次额度恢复使用同一条消息，仍需在原聊天中确认工作进展和结果。
• 电脑、服务和原聊天执行端必须可用。排队成功不等于任务完成；已进入 Codex 队列的消息不能由本工具撤回。
• 跨机器、完整真实额度耗尽恢复和长期无人值守仍然需要验收；原生监听器尚未代码签名。
• 凭据由 Codex 管理；本工具的任务、输出、路径、备注和日志仍可能包含私人信息。不要上传 data/、.cache/、runtime.json、令牌或未脱敏诊断以及一切可能涉及安全问题的信息。
• 本地访问控制不防御能够读取同用户数据目录、浏览器会话或进程内存的程序，也不支持公网部署或多人共享。

更多内容见 文档索引、使用细节、运行与恢复、兼容性。

许可与反馈

项目按 GPL-3.0-only 分发。动画和像素数字改编自 Rhine，原件、来源提交与修改说明见 第三方声明 和 third_party/rhine/。

普通问题提交到 Issues；安全问题按 SECURITY.md 私下报告。参与开发见 CONTRIBUTING.md，版本变化见 CHANGELOG.md。