Codex需介入执行层而非仅编辑层:先用codex --debug status确认工作目录正确,再复现错误(如@Browser访问localhost:3000查控制台与Network),强制并发触发死锁并dump分析,最后通过调用搜索、真实路径验证和增强测试确认修复生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex说“任务已完成”,但项目一启动就报错、页面空白或功能完全不可用,说明它只完成了代码修改,没完成真实运行验证。必须让Codex介入执行层,而不是停留在编辑层。
先确认项目是否在正确目录下启动
打开终端,进入你认为的项目根目录(含AGENTS.md和src/),运行:codex --debug status。
检查输出中的Working Directory字段——如果路径不是你预期的根目录,Codex根本没读到你的代码,后续所有调试都是空中楼阁。这一步跳过,后面全白忙。
若路径错误,立刻cd到真实物理路径:执行pwd -P确认无符号链接,再cd "$(pwd -P)",然后重试codex status。
让Codex复现失败现场,而非直接改代码
在ChatGPT桌面端中启用@Browser插件,输入指令:
使用@Browser打开http://localhost:3000 → 等待页面加载完成 → 检查控制台是否有Uncaught SyntaxError或Failed to load resource → 截图当前页面状态 → 记录Network标签页中第一个失败的请求URL与响应状态码。
注意:不要写“修复登录失败”,要写“复现登录失败”。Codex若未经复现就改认证逻辑,大概率改错了地方。
这一步操作起来很简单,直接把本地开发服务器地址喂给Browser就行。
强制触发并发错误以暴露锁竞争
打开三个全新PowerShell窗口(不能复用),全部执行:codex session list→确认输出为空→三窗口同时敲回车运行:codex run --file src/utils.ts --fix。
不复现就调试,等于在修一个不存在的Bug。如果只跑一次没卡住,清空会话后重试3~5轮。
一旦出现卡死或session_id not found提示,立即停止所有窗口,在新窗口中运行:codex session dump --all > concurrent-dump.json。
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI,等待编码任务完成,并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时,使用此功能。
打开concurrent-dump.json,搜索"lock_state": "held_by_task_7"和"waiting_for": "session_lock"是否共存——共存即为死锁铁证。
验证修改是否真正生效
方法一:全局搜索调用方
告诉Codex:“请搜索函数getUserProfile在项目中所有被调用的位置,列出每个调用处的上下文代码,并标出哪几处仍按旧返回结构string处理,而你现在已改为返回{username, avatar}。”
方法二:走通真实用户路径
要求Codex:“按以下步骤验证:①打开http://localhost:3000/profile;②等待DOM加载完成;③执行document.querySelector('#avatar').src;④检查该值是否为有效URL;⑤若为空或404,定位是前端未适配还是后端未返回。”
方法三:检查测试覆盖盲区
运行:npm test -- --testPathPattern=profile → 若仅通过正常流程测试,追加执行:npm test -- --testPathPattern=profile --runInBand --detectOpenHandles,强制暴露异步资源泄漏。
修复组织策略加载失败导致的启动中断
若Codex桌面版启动时弹出“无法加载组织设置”,先关闭所有Codex进程,然后检查:%LOCALAPPDATA%\Codex\runtimes\目录下是否存在runtime-signature.cert文件。
若缺失或文件大小不等于3127字节,从官方发布页下载对应版本的All-in-One Runtimes安装包,手动解压并提取该证书文件,覆盖放入上述目录。
【证书文件损坏会导致启动器在校验环节直接退出,不输出任何日志】
完成后重启Codex桌面端,观察是否仍报相同错误。

















