必须在项目根目录执行codex运行jest测试，支持tui交互、命令行直跑和源码绑定三种方式，自动处理referenceerror、typeerror及超时失败等常见问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在终端里用Codex自动运行Jest测试，必须确保项目已配置好Jest且测试文件可执行，Codex不会创建测试，只读取、执行并分析现有测试结构。
前置检查：确认环境与项目结构
打开终端，进入项目根目录，运行 codex --version 确认 CLI 版本 ≥ 2.4.0；旧版本不支持 sandbox 模式下的 Jest 自动执行。
执行 ls jest.config.js vitest.config.ts，至少存在其一；若都不存在，Codex 将默认使用 Jest + TypeScript 模板，但测试文件必须放在 tests/ 目录下且命名符合 xxx.test.ts 规范。
【必须在项目根目录执行，不能在 src/ 或 tests/ 子目录下启动】 否则 Codex 无法解析模块路径，后续所有 Jest 执行都会报 Cannot find module。
三种运行方式任选其一
方法一：交互式 TUI 中运行
输入 codex 启动全屏界面 → 在底部输入框键入 “运行所有 Jest 测试” → 按回车 → Codex 自动检测配置 → 执行 jest -v --runInBand（加 --runInBand 避免并发导致的内存溢出）→ 输出解析为失败摘要与修复建议。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：命令行直跑（适合 CI 或脚本集成）
终端输入：codex "run jest tests/" --approval-mode auto-edit。这会跳过人工确认，直接执行，并对判定为“可安全修复”的断言偏差或语法错误自动编辑测试文件——但仅限于 Jest 报错中明确指向某行 expect(...).toBe(...) 的场景。
方法三：绑定源码精准执行单个测试文件
若只想验证 src/utils/date.ts 对应的测试，运行：codex "run tests/utils/date.test.ts" src/utils/date.ts。Codex 会先解析 date.ts 导出的函数签名，再动态注入 --testPathPattern=tests/utils/date.test.ts 和 --collectCoverageFrom=src/utils/date.ts，避免覆盖率统计漏掉新增逻辑。
处理 Jest 执行失败
第一步：识别 ReferenceError: describe is not defined
说明 Jest 运行时未加载全局 API，Codex 会自动追加 --env=jest-environment-jsdom 参数重试；若仍失败，则提示你检查 jest.config.js 中是否遗漏 setupFilesAfterEnv 配置。
第二步：定位 TypeError: Cannot read property 'xxx' of undefined
Codex 不会直接修改测试中的 mockReturnValue，而是先检查 src/utils/date.ts 是否导出了被调用的函数，再比对 describe 块内 it 用例数量与实际导出函数数量是否匹配——不匹配则生成缺失用例补全提示。
第三步：修复超时类失败（如 Timeout - Async callback was not invoked）
Codex 默认将 jest.setTimeout(5000) 改为 jest.setTimeout(30000)，并在测试文件顶部添加注释 // increased due to slow CI env；但仅当当前目录存在 .github/workflows/ 且检测到 runs-on: ubuntu-latest 时才触发该行为。
