# RC 验收与支持范围

本页保留 `1.0.0-rc.1` / `1.0.0-rc.2` 的 Codex 验收记录，不作为当前 npm 版本说明。复现 RC.2 时可固定版本：

```bash
pnpm add -g el-bot@1.0.0-rc.2
```

RC 用于验证新用户安装和持续运行。基础范围是 QQ 官方 C2C 私聊与本机 stdio Codex：本人绑定、项目白名单、任务与结果、Markdown / 文字回复、审批与停止、实例隔离、连接诊断和明确恢复。

当前源码新增 CodeBuddy / dsh ACP 接入与本机程序按钮，能力和验证范围见[程序选择](https://docs.bot.elpsy.cn/codex/agents)与[客户端](https://docs.bot.elpsy.cn/development/client-tool)。ACP 已完成本机握手和模拟协议测试，尚未完成真实 QQ 模型任务验收；本页的 Codex 记录不适用于其他程序。安装前按[完整接入](https://docs.bot.elpsy.cn/development/codex-remote#安装-cli)核对实际版本与帮助。

## 安装与迁移

```bash
pnpm add -g el-bot@next
el-bot --version
el-bot codex --profile personal init --project /absolute/path/to/project
el-bot codex --profile personal paths
el-bot codex --profile personal check --all --json
```

新 profile 在独立 Codex 目录登录；按检查报告的登录命令操作，AppSecret 只在本机填写。已有实例沿用原 profile 或三组显式路径，先检查再启动，不重复初始化、不清空状态。
完整步骤见[实例隔离与恢复](https://docs.bot.elpsy.cn/codex/instances)和[AI 接入](https://docs.bot.elpsy.cn/codex/ai-setup)。

库入口 `el-bot`、`el-bot/nest` 发布 ESM JavaScript 与类型声明，可由普通 Node.js 导入；旧框架启动器仍使用 Vite Node 加载 TypeScript 插件。
最低 Node.js 为 22.18.0，推荐仓库 `.node-version` 指定的当前 LTS Node.js 26。发布流程先构建、安装和验证同一 tarball，再验证 Node.js 22.18.0 的 Linux / Windows / macOS 安装结果，最后执行 npm OIDC 发布。

## 真实 QQ 验收

| 项目 | 操作与预期 |
| --- | --- |
| 首次接入 | 本人在私聊发送 `/pair`，重启后仍保持原绑定 |
| 任务与结果 | 提交测试提示词，收到完成结果，`/result` 可再次查询 |
| 审批同意 | 查看全部请求详情，确认明确的测试操作，只执行一次 |
| 审批拒绝 | 拒绝测试操作；检查文件或命令确实没有执行 |
| 停止 | 执行中 `/stop`，确认命令终止；等待超过原定运行时间，确认没有延迟文件写入。旧停止按钮不停止后来的任务 |
| 重连与重启 | 网关断开后恢复；历史消息不重复启动任务，退出期间的任务不自动重放 |
| 归档恢复 | `/diagnose` 明确报告归档；`/new` 或停机后的 `recover` 只清除指定项目索引，保留主人与历史 |
| 多实例 | 两个 profile 的路径不同；错误 AppID / 环境 / Codex 目录被拒绝且原状态保留 |

自动化协议测试与真实 QQ / Codex 验收分别记录。`check --all` 通过只说明预检成功；有 QQ 返回结果才能确认端到端接通。
基础链路的已有记录见[真实 API 联调](https://docs.bot.elpsy.cn/development/codex-remote#真实-api-联调记录)。

### RC.1 验证记录

2026-10-05 的本机验证使用同一候选 tarball：

- 完整 lint、类型检查、构建、文档构建与 132 项测试通过。
- Node.js 22.18.0 与 24.18.0 的干净安装通过，包括库 / Nest 原生导入、严格 TypeScript 消费端检查、CLI、图片渲染与 JSON 诊断。
- 真实配置中的两个旧会话已归档；报告逐项标记失败，仍继续完成 QQ 鉴权与网关预检，返回非零退出码。
- 官方 QQ 网关已验证强制断线后恢复连接，两次收到就绪事件；该测试未发送 QQ 消息或提交模型任务。
- 已发布 tarball 的真实 QQ 任务完成并返回 `QQ_CODEX_RC_E2E_OK`；拒绝审批后，目标文件没有生成。
- 停止验收发现缺陷：QQ 报告中断后，原 shell 仍在 90 秒后写出了结束文件。RC.1 的停止验收失败，应升级 RC.2。此行为也见 [Codex 上游问题](https://github.com/openai/codex/issues/42717)。

### RC.2 停止修复与验收

RC.2 在 `turn/interrupt` 后，只终止当前任务命令编号对应的 Codex 终端，并再次查询确认。确认失败时报告 `stop-unconfirmed`，暂停执行入口，保留历史查询；不会误清理其他任务的终端。详见[执行与审批](https://docs.bot.elpsy.cn/development/codex-remote#执行与审批)。

- 本地完整 lint、类型检查、构建与 135 项测试通过。新增回归测试覆盖延迟写入、保留其他终端、取消时命令到达的竞争和终止失败。
- 本机 Codex CLI 0.154.0 验证中断与终端终止，并观察超过原定命令时间，未产生延迟文件写入。
- 真实 QQ 停止验收通过：60 秒命令开始写入后发送 `/stop`，收到终止确认；观察 90 秒后，结束文件仍未生成。
- 停止旧服务、安装 RC.2 tarball、沿用同一状态文件启动后，QQ `/result` 返回原任务的 `QQ_CODEX_RC_E2E_OK`。主人绑定保留，原测试文件修改时间未变化，没有重放该任务。
- 单文件变更审批同意通过：QQ 查看全部两页，单次批准只新增一行 `QQ_CODEX_RC_FILE_APPROVED`。请求的 `grantRoot` 为空，没有授予目录权限；重复使用旧审批编号被拒绝。
- 命令审批拒绝通过：QQ `/reject` 后返回 `QQ_CODEX_RC_REJECTED`，目标文件不存在。待审批期间，旧任务的停止编号被拒绝，没有中断当前任务。
- RC.2 同版本正常退出、重启后，QQ 再次查询已批准任务并收到原结果；任务历史和主人绑定保留，已批准文件内容与修改时间均未变化。验收使用独立配置、项目与状态，原实例状态未被修改。

同意验收使用有限的单文件补丁；沙箱外 shell 命令的同意未执行，不能据此声称已验证该执行类型。所有实机记录使用 macOS QQ 与本机 Codex CLI 0.154.0。跨平台 CI 验证打包与协议测试，不代替其他系统上的真实 QQ 联调。

这些记录不代替 GitHub 发布门禁；发布任务还需安装同一 tarball，通过最低 Node.js 版本在 Linux / Windows / macOS 上的兼容性验证。

## 实验与维护范围

- 默认 Markdown 保留复制和审批详情；图片模式只有完成当前机器人和 QQ 客户端的上传、展示、按钮与降级验证后，才能声明已接通。
- [Desktop 管理](https://docs.bot.elpsy.cn/codex/desktop)、共享 app-server 和实验 API 需要显式配置，依赖宿主版本，不计入基础遥控的稳定性承诺。
- 基础停止内部需要宿主支持实验终端控制协议，已测试 Codex CLI 0.154.0；不支持时明确失败。停止确认覆盖 Codex 跟踪的命令终端，不保证终止自行分离的进程或远程服务中的工作。
- 群聊、频道、后台服务自动安装与开机启动尚未纳入基础范围；电脑、网络和遥控进程需要持续可用。
- Mirai / NapCat 的旧框架与插件处于迁移维护阶段，编译后的库入口可用不代表所有旧插件已完成真实联调。剩余依赖告警与插件发布范围见[已知限制](https://docs.bot.elpsy.cn/development/monorepo#旧依赖的已知限制)。

## 进入正式版

候选版发布到 npm `next`，正式版发布到 `latest`。完成支持范围内的真实验收、迁移验证和依赖风险说明后，再发布 `1.0.0`；实验功能仍保留显式标记。
不承诺原样重放失败任务、自动取消归档或自动扩大执行权限。
