har文件是接口测试的原始依据，需通过chrome network面板完整操作业务流程后导出，codex解析其请求路径、方法、headers、参数及响应结构，前提是至少含一个200响应的api请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当开发未提供接口文档，但你需要立刻开展接口测试、生成JMeter脚本或编写用户手册时，Codex必须先“看到”结构化的接口定义才能执行后续任务——它不接受模糊描述或截图，只认可可解析的原始输入格式。
用HAR文件让Codex自动识别真实接口
打开浏览器开发者工具（F12）→ 切换到Network标签页 → 完整操作一遍目标业务流程（如登录→进入列表→点击详情）→ 右键任意请求 → “Save all as HAR with content” → 保存为traffic.har。
在Codex项目中，点击左侧「+ New Project」→ 选择「Upload file」→ 上传该HAR文件。Codex会立即解析出全部HTTP请求路径、方法、Headers、Query参数、JSON Body结构及响应示例。
这一步是关键前提：【HAR文件必须包含至少一个200响应的POST或GET请求，否则Codex无法推断出有效接口边界】。若你只抓了静态资源（js/css），它将返回“未检测到API调用”。
用OpenAPI/Swagger YAML或JSON直接喂给Codex
方法一：已有现成OpenAPI文件
将openapi.yaml或swagger.json拖入Codex已连接的项目窗口。Codex自动识别paths、components.schemas和responses区块，无需额外指令。
方法二：没有现成文件但有Swagger UI页面
访问https://your-api-domain/swagger-ui/index.html → 打开浏览器控制台 → 输入swaggerSpec（Swagger v2）或JSON.stringify(window.ui.specs[0].spec)（Swagger v3）→ 复制输出的JSON → 新建文件swagger-from-ui.json → 上传至Codex。
注意：Codex只解析标准OpenAPI 3.0+或Swagger 2.0格式；若字段名含非标准前缀（如x-custom-auth），需在配置中声明映射规则，否则会被忽略。
从代码注释实时提取接口定义
第一步：确认项目中已存在标准注释
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
FastAPI项目需有@router.get("/users", response_model=List[User])及Pydantic模型字段description；Spring Boot需含@Operation(summary = "获取用户列表")和@Parameter(name = "page", description = "页码")。
第二步：执行CLI命令生成文档
在项目根目录终端运行：codex run "扫描src/目录下所有Python/Java文件，生成openapi.yaml，包含完整路径、参数类型、响应体schema和200/400/500状态码说明"。
第三步：检查生成结果
生成的openapi.yaml中，每个responses.200.content.application/json.schema必须指向实际模型定义；【若某接口缺少response_model或@Schema注解，Codex将留空该响应体并插入# MANUAL REVIEW REQUIRED注释】，不可跳过人工核查。
用Skill快速补全缺失文档
方法1：针对cURL片段
复制一段真实调用的cURL命令（含-X POST -H "Content-Type: application/json" -d '{"name":"test"}'），在Codex对话框中输入：“请将以下cURL转换为OpenAPI 3.0 YAML格式，path设为/api/v1/users，requestBody要求必填name字段，响应体示例为{"id":1,"name":"test"}”。
方法2：使用jmeter-generator Skill
在Codex中输入：/jmeter-generator --input-format curl --output jmx → 粘贴cURL → 回车。该Skill会先反向解析cURL生成临时OpenAPI结构，再套用JMX模板输出可执行脚本。
这一步操作起来很简单，直接把cURL粘贴进去就行。但注意：cURL中-d参数必须是合法JSON字符串，含单引号或未转义双引号会导致解析失败。
