Codex Windows 商店版 app.asar 缺失：汉化与更新修复
排查 Windows 商店版 Codex 汉化或更新后的 app.asar 缺失、启动失败、修复和重置流程。
TL;DR：不要从网上下载 app.asar 覆盖商店目录
如果 Windows 商店版 Codex 在汉化、更新或启动时出现 app.asar missing、Cannot find module、资源文件缺失或类似提示，先关闭应用并停止第三方文件替换。商店应用使用 MSIX/AppX 包和注册机制，手动向安装目录塞入一个同名 app.asar，可能造成签名、版本和自动更新同时失效。
更稳妥的顺序是：记录错误信息与应用来源，更新 Microsoft Store，使用 Windows 设置里的 Repair，确认无效后再使用 Reset。Microsoft 说明，Repair 尽量保留应用数据，Reset 会删除应用数据并重新安装；重置前要准备好重新登录和重新设置。Windows 应用修复与重置官方说明
app.asar 缺失通常意味着什么？
app.asar 是部分 Electron 应用常见的资源归档名称，但“app.asar 缺失”不是 Microsoft 为某个 Codex 商店版本统一定义的官方错误码。商店版应用的真实包名、安装路径和内部文件布局会随版本变化，所以这篇文章把它作为一个现象入口，重点处理可复现的更新与包注册问题。
先记录四项信息
在执行修复前，保存以下信息，方便判断问题是在汉化之后出现，还是更新本身失败：
- 错误窗口中的完整文字和错误码，不要只截取
app.asar这一行。 - 应用是 Microsoft Store 安装、独立安装包安装，还是从其他来源复制而来。
- 问题发生在首次启动、切换中文、更新过程中，还是更新完成后。
- 当前 Windows 版本和应用版本。
如果问题只在替换资源或“汉化补丁”之后出现，优先撤销这次改动或直接修复应用，不要继续覆盖更多文件。
Windows 商店版 Codex 的标准修复流程
第一步：关闭应用和相关窗口
先退出 Codex、Microsoft Store 和可能打开该应用文件的资源管理器窗口。更新提示“文件正在使用”时，重启电脑后再操作一次。Microsoft 的 MSIX 排错资料将 0x80073D02 归为资源正在使用，关闭应用进程是第一处理动作。Microsoft MSIX 错误排查
第二步：让 Microsoft Store 重新检查更新
- 打开 Microsoft Store。
- 进入“库”或“Library”。
- 点击“获取更新”或检查应用更新。
- 等待 Codex 和相关依赖完成更新，再重新启动。
不要在更新过程中打开应用，也不要同时运行第三方汉化工具。Microsoft 的官方说明提供了在 Store 设置中开启应用自动更新的路径：开启 Microsoft Store 应用自动更新。
第三步：先 Repair，再考虑 Reset
Windows 11：打开“开始 > 设置 > 应用 > 已安装的应用”，找到 Codex，打开右侧菜单，进入“高级选项”，先点击 Repair。Windows 10 的入口通常是“设置 > 应用 > 应用和功能 > Codex > 高级选项”。
Repair 完成后重新启动应用。如果问题仍在，再回到同一页面执行 Reset。Reset 会删除应用数据、偏好和登录状态，属于有损操作；完成后需要重新登录，部分本地设置也要重新配置。微软对 MSIX 应用的说明也明确区分了 Repair 和 Reset：Repair 尽量保留数据，Reset 会清除数据并重新安装。MSIX 应用修复与重置机制
第四步：必要时重置 Microsoft Store 缓存
如果 Store 自己无法加载、更新按钮没有反应或应用列表状态异常，可以按 Win + R，输入：
wsreset.exe
等待窗口自动完成，再打开 Microsoft Store 检查更新。这个操作针对 Store 缓存，不是把第三方 app.asar 写入 Codex 安装目录。完成后仍然要回到“更新、Repair、Reset”的顺序。
常见错误码怎么判断？
下面的错误码来自 Microsoft 的 MSIX/AppX 排错资料，Codex 页面显示的具体文本可能不同。错误码只能帮助确定方向，最终原因应以事件查看器和应用实际提示为准。
| 错误码或现象 | 常见含义 | 优先处理 |
| --- | --- | --- |
| app.asar missing、Cannot find module | 应用资源缺失、版本不完整或第三方修改破坏了包内容 | 停止手动替换文件，先 Repair；无效再 Reset 或官方重新安装 |
| 0x80073CF0 | Windows 无法打开应用包，可能是包路径、文件损坏或访问权限问题 | 重新走 Microsoft Store 更新，不要使用来历不明的包文件；必要时查看部署日志 |
| 0x80073CF3 | 更新、依赖或冲突校验失败 | 先确认没有旧进程和并行安装，获取最新版本后再更新 |
| 0x80073CF6 | 应用包注册失败，可能涉及注册数据库或系统文件 | 先 wsreset.exe，再使用应用 Repair；仍失败时查看 AppX 部署日志 |
| 0x80073D02 | 应用包需要修改的资源正在被占用 | 关闭 Codex、Store 和相关后台进程，重启后再更新 |
| 0x80070002 | 找不到包中引用的文件或路径 | 不要补拷贝单个资源文件，使用 Repair/Reset 重新恢复完整包 |
Microsoft 建议在错误码不足以定位问题时查看“事件查看器 > 应用程序和服务日志 > Microsoft > Windows > AppxDeployment-Server”，并用 Get-AppxLog 获取最近的部署日志。Microsoft 官方部署排错说明
用 PowerShell 识别商店包，不要猜安装目录
如果设置页无法正常显示应用名称，可以用 PowerShell 只读查询当前用户已安装的相关包。这个命令不会修改系统：
Get-AppxPackage |
Where-Object { $_.Name -match 'OpenAI|ChatGPT|Codex' } |
Select-Object Name, PackageFullName, InstallLocation
商店版的包名可能并不包含你看到的产品名称。如果没有结果，不要据此判断可以直接删除目录；回到 Microsoft Store 的应用页面和 Windows 设置中确认实际应用名称。
只有在你明确知道目标包、理解会清除数据并且 Windows 设置中的 Reset 无法执行时，才考虑使用系统提供的包重置命令。先把查询结果保存下来，再选择准确的 PackageFullName：
$pkg = Get-AppxPackage |
Where-Object { $_.Name -match 'OpenAI|ChatGPT|Codex' } |
Select-Object -First 1
if ($pkg) {
Reset-AppxPackage -Package $pkg.PackageFullName
}
这一步可能删除应用数据和登录状态，优先使用设置里的 Repair/Reset，并确认筛选结果确实是目标应用。不要运行网上流传的批量删除所有 AppX 包脚本。
汉化后启动失败，应该怎么恢复？
如果问题是在替换资源、修改包内文件或运行第三方汉化工具之后出现，建议按以下路径恢复：
- 停止汉化工具和文件替换操作。
- 在 Windows 设置中对 Codex 执行 Repair。
- Repair 无效时执行 Reset，接受重新登录和配置丢失的影响。
- 打开 Microsoft Store，完成最新版本更新。
- 仍然失败时卸载并从官方 Desktop 下载入口重新安装，不要从论坛下载单独的
app.asar。
如果你只是需要中文界面，可以先阅读 Codex 设置中文与语言切换修复，使用应用自身的 Settings - General - Language 路径。语言设置无法生效时，优先修复网络和应用版本，不要先改包内文件。
常见问题与解决
| 问题 | 结论 |
| --- | --- |
| 可以从网上下载一个 app.asar 放回去吗？ | 不建议。文件可能与版本、签名和依赖不匹配，且会让商店更新继续失败。 |
| Repair 和 Reset 应该先用哪个？ | 先 Repair；确认无效后再 Reset。Reset 会清除应用数据和登录状态。 |
| Reset 后还是无法安装怎么办？ | 清理 Store 缓存、重启电脑、查看 AppX 部署日志，并从官方入口重新安装。 |
| PowerShell 找不到 Codex 包怎么办？ | 不要猜包名或安装路径，回到 Store 和“已安装的应用”确认实际名称。 |
| 汉化和更新冲突时应该保留哪个？ | 优先恢复官方完整包和正常更新链路，语言需求通过应用设置解决。 |
FAQ：Windows 商店版 Codex 启动与更新
app.asar missing 是不是一定要手动补文件？
不是。它更像是资源缺失或包内容不完整的现象提示。商店版应用应优先通过 Repair、Reset 或官方重新安装恢复完整包，不要手动下载和覆盖单个文件。
Windows 商店版 Codex 更新失败，先重置应用还是先更新？
先关闭应用并让 Microsoft Store 获取更新；如果应用已经能打开但功能异常，先 Repair。只有 Repair 无效时，才考虑会清除数据的 Reset。
Reset 会不会删除我的项目文件？
Windows 的应用 Reset 主要清除该应用的数据和设置，不等同于删除你在其他目录中的项目文件。但仍应先关闭应用、备份重要配置，并确认项目没有保存在应用专属数据目录内。
修改商店版文件做汉化安全吗？
不安全。商店包的文件、签名和版本更新存在关联，直接修改可能导致启动、更新或注册失败。优先使用应用自身语言选项；如果语言包失败，按中文设置排错页处理。
去哪里看更具体的 Windows 部署日志？
打开事件查看器，进入“应用程序和服务日志 > Microsoft > Windows > AppxDeployment-Server”，再结合 Get-AppxLog 查看最近一次部署失败的详细信息。记录错误码和时间点后，再决定是否 Repair 或 Reset。