必须先统一文件编码为utf-8无bom、扁平化存放、避免非法字符；上传限20个/批；处理结果在【processing queue】查看，支持页面跳转详览或【files】页内联预览；导出json报告需全量completed后勾选导出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Codex中批量导入代码文件并实时查看每份文件的处理结果，必须先确保所有待处理文件已整理为统一编码格式（推荐UTF-8），且不包含路径过长或非法字符的文件名，否则导入过程会静默失败。
准备待导入的代码文件
将所有需分析的.py、.js、.ts等源码文件放入同一个本地文件夹，不要嵌套子文件夹；Codex当前版本不递归扫描子目录，放入子文件夹中的文件会被跳过。
检查每个文件首行是否含BOM头——若存在，Codex可能误判文件编码导致解析中断；用VS Code或Notepad++打开→编码→转为“UTF-8 无BOM”并保存。
通过Web界面批量上传
登录Codex Web控制台→点击左侧导航栏【Files】→右上角点Upload →在弹出窗口中按住Ctrl多选全部目标文件→松开后立即点击Open。
上传完成后页面不会自动跳转，需手动点击顶部导航栏的【Processing Queue】标签页；这里会列出所有待处理文件及其当前状态（queued / processing / completed / failed）。
这一步操作起来很简单，直接把文件拖进去就行，但注意：一次最多上传【20个文件】，超量会触发前端拦截且无提示，需分批上传。
查看单个文件的结构化处理结果
方法一：在【Processing Queue】页找到状态为completed的条目→点击右侧的「View Result」按钮→进入新页面后，左侧显示原始代码高亮，右侧同步生成函数签名、依赖图、潜在漏洞标记三栏面板。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法二：回到【Files】页→找到对应文件名→悬停后出现「▶」图标→点击展开内联预览，仅显示摘要级信息（如函数数量、最长行数、是否含eval调用），适合快速筛查。
注意：内联预览不刷新实时结果，仅显示该文件最后一次成功处理的缓存摘要；若刚上传完就点它，可能看到的是旧数据。
导出全部处理结果为结构化报告
第一步：确保所有目标文件状态均为completed；若有failed项，先点击其右侧「Retry」重试，失败三次后需下载日志排查编码或语法问题。
第二步：在【Processing Queue】页顶部勾选全部completed条目→点击右上方「Export JSON Report」按钮。
第三步：浏览器自动下载report_YYYYMMDD_HHMMSS.json文件；该文件为标准JSON数组，每个元素含filename、ast_summary、security_flags、processed_at字段，可直接被Python脚本或jq命令解析。
导出动作不可逆，但不会删除原始文件或队列记录；若中途关闭页面，已生成的JSON文件仍保留在服务器临时区24小时，可通过【Exports】二级菜单重新获取下载链接。
