chen0416ccc-cpu/codex-windows-fast-patch-skill

Codex Windows 快速补丁技能

让 AI 助手修复 Windows 版 Codex Desktop 更新后失效的模型列表、浏览器、电脑操控等功能。

中文  /  英文

能修复什么  ·  安装  ·  使用  ·  更新  ·  重装说明  ·  更多帮助

这是社区维护的 Agent Skill，提供诊断流程与修复脚本，不是官方客户端，也不是适用于所有版本的一键安装器。

[!警告] 仅支持 Windows。部分修复包含重新安装 Codex 的步骤。 期间应用会关闭，当前对话可能中断;安装完成后重新打开 Codex，回到原修复对话发送“继续”即可接着处理。具体见重装说明。

能修复什么

手机远控和听话水配置（model_instructions_file）均为可选流程，不会随普通修复自动启用。

补丁是否适用取决于当前版本和文件内容，不能把旧补丁强套到未知版本。模型仍需由你的供应商提供，本项目不提供模型 API 或额度。会话恢复以本地历史数据仍在为前提；修复缺失目录不会找回被删除的项目文件。

安装

准备好 Windows 版 Codex Desktop、Git，以及支持 Agent Skills 的 AI 助手。在 PowerShell 中执行：

这一步只安装 skill，不会重装 Codex。完成后重启使用它的 AI 助手，让其加载技能。

这是社区维护的 Agent Skill，提供诊断流程与修复脚本，不是官方客户端，也不是适用于所有版本的一键安装器。

[!WARNING] 仅支持 Windows。部分修复包含重新安装 Codex 的步骤。 期间应用会关闭，当前对话可能中断；安装完成后重新打开 Codex，回到原修复对话发送“继续”即可接着处理。具体见重装说明。

能修复什么

手机远控和听话水配置（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 更新后的模型列表、
浏览器和电脑操控问题。保留我的配置与会话，完成后做后台核验并清理临时文件。

默认采用后台只读验收，不自动打开计算器等测试应用，不切换原生窗口焦点或发送鼠标键盘输入。运行时、插件、窗口枚举等检查会分别报告；真实截图和原生输入测试仅在你明确要求或同意后执行，未执行时会如实注明。

更新后统一检查与恢复

项目现在包含统一入口，不需要从某次聊天复制临时脚本：

& "$SkillRoot\scripts\codex-after-update.ps1"
& "$SkillRoot\scripts\codex-after-update.ps1" -CheckApp
& "$SkillRoot\scripts\codex-after-update.ps1" -RepairPlugins -RepairApp

第一条只检查当前包的安装事务、实时模型目录和插件/运行时；没有当前包的验收记录时，会明确返回 app-check-needed，不会因为插件正常就宣称应用补丁正常。第二条还会对当前包运行完整补丁试运行，逐项检查语言、插件、浏览器/电脑控制、Fast 和 Ultra 路径，并清理本次临时副本；可用 -CheckRoot 'D:\CodexChecks' 指定空间充足的临时目录。第三条显式修复插件，并在试运行确认需要且兼容时调用带回退保护的完整非手机安装器，会请求正常 UAC 并重启 Codex。已安装但未验收的事务只续做验收；安装器运行中或状态不明时不会再启动一个。