用 AI 快速接入
可以把下面的提示词交给能执行本机命令的 AI 助手，例如 Codex 或 Claude Code。 助手使用现有 CLI 完成环境检查、项目配置和连接诊断，不需要额外模型 API Key。 QQ 平台登录、密钥填写和首次 /pair 绑定由你在自己的设备上完成。
版本与实例
使用 el-bot@next，或固定 el-bot@1.0.0-rc.2。先检查版本和子命令，再按安装说明继续。 新实例推荐使用 --profile personal；独立 Codex 登录、AppID 校验与恢复见实例隔离与恢复。无需 YunLeFun 账户。
复制给你的 AI 助手
把项目路径替换为真实路径。已有实例请说明正在使用的 profile 或自定义路径。
请帮我把 QQ 官方机器人接入本机 Codex，使用 el-bot codex 子命令。
目标项目绝对路径：<替换为自己的项目目录>
项目名称：my-project
新实例名称：personal（已有实例时使用其原 profile 或路径）
可选的 el-bot 源码目录或本地 tgz：<有则填写>
先阅读当前版本的 docs/codex/ai-setup.md、docs/codex/instances.md 和 docs/development/codex-remote.md。
源码不可用时，读取 https://docs.bot.elpsy.cn/llms.txt 中的 Markdown 链接；
在线文档未部署或与安装包版本不同，使用对应 Git revision 的文档，不猜测参数。
请按以下步骤实际操作，并在缺少用户登录或凭据时说明当前需要我完成什么：
1. 检查操作系统、Node.js（22.18+）、包管理器、项目是否存在，以及 codex --version 和 codex login status。
2. 执行 el-bot --version 和 el-bot codex --help 确认支持子命令。旧版不支持时安装 el-bot@next，
或指定本地包、在源码目录使用 pnpm cli codex；不要在我的目标项目克隆工具仓库。
3. 用 codex --profile personal paths 核对配置、凭据、状态和 codexHome 路径。已有实例使用原参数，保留绑定、会话和其他项目，
不重复 init，不覆盖或删除状态，不启动第二个使用同一状态的实例。
4. 未初始化时执行 el-bot codex --profile personal init --project "目标项目绝对路径" --name my-project --no-prompt。
让我在本机交互终端或私有编辑器填写凭据。不要索要、读取、打印或上传 AppSecret、Token、完整凭据文件和状态内容；
不把密钥写入聊天、命令参数、项目文件或 Git。只报告路径和脱敏结果。
profile 使用独立 Codex 目录；设置 paths 中的 CODEX_HOME 后让我自己执行 codex login，不复制已有登录文件。
5. 检查 codex check；登录或凭据未完成就保留进度并提示我。完成后执行 codex check --all。
优先执行 check --all --json，读取所有 checks 的 status、summary 和 actions；退出码 1 不代表所有项目都失败。
这些检查不启动模型任务、不发送 QQ 消息。按报告处理出口 IP 白名单、独立 Codex 目录登录、model 或指定项目会话；不删除状态或自动执行 recover。
6. 引导我在 q.qq.com 启用 WebSocket、设置出口 IP 白名单，并让测试 QQ 能添加机器人。
如果原来使用 Webhook，说明切换会影响旧服务，让我决定是否切换或使用另一机器人。
7. 本地与 QQ 检查通过后，在我可见的终端运行 codex start，保持前台运行。
让我自己把终端的 /pair 绑定码私聊发给机器人，不发送给其他人，不设置开机启动。
8. 给我 QQ 验收步骤：/help 或 /menu 打开快捷菜单、/projects 点选项目（也可 /project my-project）、/status，随后由我发送
“请只回复 QQ_CODEX_READY，不使用工具、不修改文件”，最后用 /result 查询。
最后报告已执行命令、检查结果、配置路径和仍待我完成的步骤。
以上 codex 命令均使用 el-bot codex 前缀；源码模式使用 pnpm cli codex。
每一步使用相同的 --profile；已有默认实例不要擅自改为新 profile。自定义 --config、--credentials、--state 时，每一步使用同样的路径，参数放在 codex 后。
如果检查发现归档或目录变化，解释 /diagnose、/new 项目 和停止服务后 recover --project 项目的区别，保留历史，不自动重试任务。助手的执行顺序
| 阶段 | 助手可以完成 | 用户完成 |
|---|---|---|
| 检查环境 | 检测版本、项目路径、CLI 帮助、Codex 登录状态 | 必要时在本机登录 Codex |
| 初始化 | 使用 init --no-prompt 创建项目配置与凭据模板 | 在本机填写 AppID / AppSecret |
| 检查连接 | check、check --all；输出脱敏诊断 | QQ 平台设置与登录 |
| 绑定和验收 | 在可见终端启动，解释 QQ 命令和预期结果 | 私聊发送绑定码与测试提示词 |
init --no-prompt 没有读取到凭据时会生成空模板；这属于“初始化完成、QQ 凭据待填写”，不能报告已接通。 check --all 成功说明本机 Codex 已连接、账户信息与模型配置通过预检，且 QQ AccessToken 和网关地址可获取；网络、额度与模型服务权限仍需真实任务验证。只有 QQ 私聊收到结果并能 /result 查询，才能确认端到端接通。 测试提示词会调用一次 Codex 模型，可能产生账户用量；只有用户发送后才执行。
非交互初始化示例
已安装新 CLI 时：
el-bot codex --help
el-bot codex paths
codex login status
el-bot codex init --project /absolute/path/to/my-project --name my-project --no-prompt
el-bot codex check凭据填写与平台设置完成后：
el-bot codex check --all
el-bot codex start已有配置时跳过 init。使用 --config 指定新配置时，还需要显式选择对应的 --credentials 与 --state； 仅换配置不会创建独立状态。不要把状态文件放到目标项目中。
AI 可读的文档入口
文档构建从当前 Markdown 源文件生成以下产物，内容随版本一起更新：
- llms.txt：接入导航与各页 Markdown 链接。
- llms-full.txt：AI 接入、完整协议/命令、迁移与发布文档的合集。
- 本页 Markdown：可直接交给本机助手阅读。
- 完整接入 Markdown：配置、权限、命令与排错。
llms.txt 是社区提出的 AI 文档格式，不会自动赋予助手账户权限或代替 QQ 平台授权。 文档与安装版本不一致时，让助手读取对应 Git revision 的原始 Markdown。