这是社区维护的 Agent Skill，提供诊断流程与修复脚本，不是官方客户端，也不是适用于所有版本的一键安装器。
Warning
仅支持 Windows。部分修复包含重新安装 Codex 的步骤。 期间应用会关闭，当前对话可能中断；安装完成后重新打开 Codex，回到原修复对话发送“继续”即可接着处理。具体见重装说明。
| 问题 | 覆盖范围 |
|---|---|
| 模型与速度选项缺失 | Fast Mode、被隐藏的已有模型、Power 拖动条、Ultra 开关 |
| 界面与插件异常 | 语言重置、Goal 等入口消失、插件市场与安装按钮不可用、客户端过滤隐藏的 Image-guided Assets |
| 浏览器不可用 | 内置浏览器、Chrome 控制、自定义供应商下特定的登录依赖错误 |
| 电脑操控异常 | Computer Use / Any App、跨调用窗口操作、部分 Win10 截图故障 |
| 手机远控失效 | 入口、二维码、配对和版本过期问题，保留第三方 API 主使用方式 |
| 会话异常 | 新建对话 inputSchema 报错、切换供应商后历史消失、恢复后目录缺失 |
| 配置管理 | 配置、技能和市场的备份恢复 |
| 配置听话水 | 配置 skill 内置的系统提示词文件及 model_instructions_file |
手机远控和听话水配置（model_instructions_file）均为可选流程，不会随普通修复自动启用。
补丁是否适用取决于当前版本和文件内容，不能把旧补丁强套到未知版本。模型仍需由你的供应商提供，本项目不提供模型 API 或额度。会话恢复以本地历史数据仍在为前提；修复缺失目录不会找回被删除的项目文件。
准备好 Windows 版 Codex Desktop、Git，以及支持 Agent Skills 的 AI 助手。在 PowerShell 中执行：
$SkillRoot = "$env:USERPROFILE\.codex\skills\codex-windows-fast-patch"
git clone https://github.com/chen0416ccc-cpu/codex-windows-fast-patch-skill.git $SkillRoot这一步只安装 skill，不会重装 Codex。完成后重启使用它的 AI 助手，让其加载技能。
Claude Code 可将目标改为 $env:USERPROFILE\.claude\skills\codex-windows-fast-patch；其他客户端使用各自的 skills 目录。后续命令中的 $SkillRoot 都应指向你的实际安装位置。已经安装过的副本直接按下文更新，不要重复克隆。
安装后，直接向 AI 助手描述问题，例如：
使用 codex-windows-fast-patch，检查并修复 Codex 更新后的模型列表、
浏览器和电脑操控问题。保留我的配置与会话，完成后做后台核验并清理临时文件。
默认采用后台只读验收，不自动打开计算器等测试应用，不切换原生窗口焦点或发送鼠标键盘输入。运行时、插件、窗口枚举等检查会分别报告；真实截图和原生输入测试仅在你明确要求或同意后执行，未执行时会如实注明。
需要手机远控时单独提出：
使用 codex-windows-fast-patch 修复手机远控，
保留我的第三方 API 配置、原有登录和会话记录。
“听话水”就是本 skill 内置的系统提示词。把下面这句话发送给智能体：
帮我进行听话水相关的配置
智能体会使用 assets/system-prompt.md，配置系统提示词文件，并在 config.toml 中设置 model_instructions_file。完成后按提示开启新会话或重启 Codex，使配置生效。
Chrome 是否需要额外登录？
对于明确配置 requires_openai_auth=false 的供应商，支持修复特定版本的 Codex auth token is unavailable 错误，且保持代理请求头开启、不借用手机授权。这不是所有登录问题的通用绕过，具体条件见Chrome 兼容说明。
每次更新打补丁前，先拉取并审查自己的远端 main 与上游 main，对比本机技能和已有 PR；远端已覆盖的修复直接复用，只补充有实际证据支持的缺失修复或优化。通过 git clone 安装的副本可在审查后快进更新：
git -C $SkillRoot fetch origin
git -C $SkillRoot fetch upstream
git -C $SkillRoot pull --ff-only先核实 origin 是自己的 fork、upstream 是原仓库；没有该 remote 时按远端审查与发布流程配置。非 Git 安装副本也要通过持久源码 checkout 对比，保留本机 overlay，不能跳过远端审查。
这是更新修复工具，不是更新 Codex 客户端。必要增量验证后必须提交、推送自己的 main 并创建或更新上游 PR，在修复记录中写明 commit、base/head 和 PR URL。已有有效提交/PR 则复用，避免空提交和重复 PR；网络或认证阻塞须明确记录。
是否重装取决于故障原因，不是每次使用 skill 都会重装：
| 修复内容 | 通常的处理方式 |
|---|---|
| Fast Mode、Power/Ultra、客户端过滤导致的模型不显示 | 修改客户端后重新安装 |
| 语言重置、Goal / 插件 / 浏览器 / Any App 的客户端入口异常 | 修改客户端后重新安装 |
手机远控的入口、配对或版本问题，新建对话 inputSchema 报错 |
需要修改客户端或原生程序时重新安装 |
| Chrome / Computer Use 的缓存、运行时路径、市场配置，以及已支持的 Chrome 登录依赖错误 | 通常只修本地环境，不重装 |
| 模型目录补全、历史会话可见性、缺失工作目录、备份与听话水配置、配对后的 API 地址 | 通常只改配置或数据，不重装 |
同样是“浏览器不能用”或“模型不显示”，也可能只是缓存或配置问题，以实际检查结果为准。
可以直接在当前 Codex 对话里发起修复。 需要安装时，由智能体安排独立安装进程接手，让安装在 Codex 窗口关闭后仍能继续。
- 开始前，智能体应说明本次是否需要重装，先备份并保存修复进度；需要管理员权限时，按 Windows 提示授权。
- 重装期间，Codex 窗口会退出，当前修复对话可能中断，应用会暂时无法使用。这是安装过程中的预期现象，不代表配置或会话记录被清空。
- 安装完成后，若 Codex 没有自动打开，就手动打开它，回到原来的修复对话发送“继续”，让智能体检查安装结果、完成验收和清理，不必重新开一轮修复。
这里的“重装”采用保留用户数据的原位更新，不是先卸载再安装。如果安装明确报错，或安装完成后仍打不开，就需要按失败处理并排查，不能当作正常等待。
可恢复安装器会在日志旁保留独立的状态文件，记录源版本、目标版本、安装进程、验收和清理结果。重启后可用 scripts/get-model-experience-repair-status.ps1 -StatePath <状态文件路径> 只读查询；如果又更新了 Codex，应先确认新版本是否已替代旧修复，避免重复安装。详细步骤和配置变更核对见更新后续接与验收。
ASAR 解包和打包优先复用 npm 缓存中可运行的本地工具，不依赖 npm 的在线索引或离线索引元数据；仅在没有可用工具时沿用 npx/pnpm 获取方式。已选定工具执行失败时直接停止，不通过重新下载掩盖归档错误。正式打包在复制应用目录之前检查 Windows SDK 工具，避免完成耗时补丁后才发现缺少打包依赖；现有有效 SDK 缓存可复用。
| 想了解什么 | 文档 |
|---|---|
| 完整执行流程、参数和备份操作 | SKILL.md，供智能体与维护者按需查阅 |
| 模型、浏览器、插件或安装故障 | 常见问题排查 |
| 手机远控的授权、配对和 API 问题 | 手机远控排查 |
| Win10 截图的适用版本与验证范围 | Win10 截图兼容说明 |
| 本机是 Win11，如何分析和验证 Win10 截图问题 | Win10 客体与独立验证工具 |
仍有问题请提交 issue，附上 Windows / Codex 版本、问题现象和脱敏日志。不要上传 auth.json、API key、OAuth token 或浏览器资料；敏感信息处理见 SECURITY.md。
感谢 LinuxDo 社区 的讨论与反馈。