Skip to content

v0.1.3 - 首个正式版本

Choose a tag to compare

@congwa congwa released this 03 Apr 03:08
· 9 commits to main since this release

核心亮点

围绕 Codex CLI 的永动机包装器:开一个 codex 对话把任务给它,模型干一部分活停了,自动 resume 同一个对话说"继续",循环直到全部做完。

⚠️ 重要:prompt.md 必须包含规划章节

prompt.md 必须明确说明当前状态、从哪里开始、做什么任务,否则大模型会自己幻想。

推荐格式:

## 当前推进状态与建议施工顺序

按当前目录看,已落地文档与待写文档可以这样管理:

- 已完成:
  - 第 12 章 `12-REPL状态流转.md` 
  - 第 13 章 `13-输入框与模式系统.md` 
  - ...

- 待写:
  - 第 22-26 章:继续写会话长期化阶段...
  - 第 27-35 章:作为执行能力层连续完成...
  - ...

从待写开始写

关键点:

  • 已完成 列表:让模型知道哪些不用重复
  • 待写 列表:让模型知道接下来要做什么
  • 从待写开始写 这句很重要:明确指示起点

安装

从 npm 全局安装(推荐)

npm install -g codex-autoresearch
codex-autoresearch --help

从源码安装

git clone https://github.com/congwa/codex-autoresearch.git
cd codex-autoresearch
npm install
npm run build
npm install -g .
codex-autoresearch --help

使用方式

1. prompt.md + CLI(推荐)

站在目标项目目录里,准备好一个 prompt.md 文件:

codex-autoresearch --prompt-file ./prompt.md

2. 直接传任务文本

codex-autoresearch "请检查当前仓库 TODO,补齐缺失测试并更新 README"

3. Shell 薄包装 codex-keep-running.sh

./codex-keep-running.sh ./prompt.md
cat ./prompt.md | ./codex-keep-running.sh -

环境变量:

变量 作用
WORKDIR 实际执行目录
STATE_DIR 状态根目录
INTERVAL 重试间隔
MODEL 模型
USE_FULL_AUTO 是否开启 --full-auto

恢复、查看状态

# 恢复最近一次任务
codex-autoresearch session resume --last

# 查看最近任务状态
codex-autoresearch session status --last

# 按 session id 继续
codex-autoresearch session resume <session-id>

工作流程

用户 → codex-autoresearch → Codex CLI (Worker)
                              ↓
                        永动机循环:exec → resume "继续" → exec → ...

关键设计:

  • 永动机核心循环:codex exec → 退出 → codex exec resume "继续" → 退出 → 循环
  • resume prompt 就一个字——"继续",不塞行为约束,不重复任务描述
  • CLI 阻塞直到任务完成

状态模型

统一执行引擎把状态写到 .codex-run/<job-id>/,包含:

  • meta.json - 任务元信息
  • events.jsonl - Codex JSON 事件流
  • runner.log - 执行日志
  • last-message.txt - 最近一轮输出

Completion Protocol

执行引擎要求 Codex 在真正完成时严格输出两行:

  1. 基于 nonce 反转后的 done token
  2. CONFIRMED: all tasks completed

只有完全匹配才会标记为 completed。

完整更新日志

详见 CHANGELOG.md