El Bot

RC 验收与支持范围 ​

当前候选版本为 1.0.0-rc.2，发布到 npm next。测试时建议固定版本，便于记录与复现：

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

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

安装与迁移 ​

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 或三组显式路径，先检查再启动，不重复初始化、不清空状态。 完整步骤见实例隔离与恢复和AI 接入。

库入口 el-bot、el-bot/nest 发布 ESM JavaScript 与类型声明，可由普通 Node.js 导入；旧框架启动器仍使用 Vite Node 加载 TypeScript 插件。 最低 Node.js 为 22.18.0，推荐仓库指定的 Node.js 24。发布流程先构建、安装和验证同一 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 联调。

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 上游问题。

RC.2 停止修复与验收 ​

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

  • 本地完整 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 管理、共享 app-server 和实验 API 需要显式配置，依赖宿主版本，不计入基础遥控的稳定性承诺。
  • 基础停止内部需要宿主支持实验终端控制协议，已测试 Codex CLI 0.154.0；不支持时明确失败。停止确认覆盖 Codex 跟踪的命令终端，不保证终止自行分离的进程或远程服务中的工作。
  • 群聊、频道、后台服务自动安装与开机启动尚未纳入基础范围；电脑、网络和遥控进程需要持续可用。
  • Mirai / NapCat 的旧框架与插件处于迁移维护阶段，编译后的库入口可用不代表所有旧插件已完成真实联调。剩余依赖告警与插件发布范围见已知限制。

进入正式版 ​

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

AGPL-3.0 Licensed

Copyright © 2020-present YunYouJun