用途:对 omo Codex Light 版(packages/omo-codex,发布名 lazycodex)本身做 QA,在真实 Codex 中只运行本插件,不触碰用户真实 ~/.codex。
主要能力:所有会启动 codex 的脚本都使用隔离的 CODEX_HOME(由 cqa_mk_isolated_home 创建)和本地 mock 模型(cqa_start_mock),不访问真实模型 API;每个脚本自带 --self-test,既是 QA 工具也是回归检查;脚本会对 ~/.codex/config.toml 做前后 sha 校验,证明真实 home 未被改动。
使用方式:先进入技能目录并运行 bash scripts/lib/common.sh --self-check 确认依赖与隔离环境。默认 QA 面为 Docker,脚本为 script/agent/qa-docker.sh;Docker 不可用或 Windows 时用本地脚本。按场景选择:验证插件 hook 在真实 Codex 回合中触发用 scripts/app-server-drive.sh --plugin;验证驱动本身用 --self-test;安装本地构建到隔离 home 用 scripts/install-verify.sh --self-test;单组件 hook 逻辑用 scripts/hook-unit-probe.sh --self-test;TUI 冒烟用 scripts/tui-smoke.sh --self-test。证据写入 .omo/evidence/<YYYYMMDD>-<slug>/,该目录被 gitignore。TUI 视觉 QA 需按文档用 xterm.js 网页终端渲染,而非 tmux capture-pane。
适用场景:组件/hook 逻辑、安装器与 config.toml、影响实时会话的 hooks/agents/MCP 接线等改动范围的验证。
限制:资料标注验证环境为 codex-cli 0.140.0(macOS 上的 node、jq、tmux、bun);交互式 codex 是注入 --profile quotio 的 shell 函数,脚本应绕过它使用真实二进制;手动运行 codex 前须先 export CODEX_HOME 并确保目录已存在;Codex 中没有 /debugging 命令,观察运行需用 app-server 通知流、RUST_LOG=debug、$CODEX_HOME 下的日志 SQLite、TUI 的 /debug-config 及 codex debug 子命令。bun run install:codex-dev 会写入真实 home,不属于隔离 QA 流程。