GitHub - arronfan23/Codex-Chinese: 一键开启 Codex 桌面版官方简体中文界面：asar 补丁 + 完整性哈希同步 + MSIX 包身份注入，纯 PowerShell，中英自由切换

开启 Codex 桌面版官方内置简体中文界面，一键安装，中英自由切换

🎬 项目介绍视频

约 78 秒了解 Codex-Chinese：内置中文界面、一键安装、中英切换，以及更新自动跟随。1080p 横屏，中文男声配音与字幕。

codex-chinese-intro.mp4

下载 MP4 · 下载中文字幕

✨ 特性

🌏 官方语言包 — 不做第三方翻译，直接开启 Codex 自带的 60+ 语言（含完整简体中文），翻译质量官方保障
🖱️ 一键安装 — 双击 install.cmd，全程进度条可视化，无需管理员权限，不碰原版安装
🔄 中英自由切换 — 设置 → General → Language，随时切回英文，原版图标/入口完全保留
🛡️ 完整性自适应 — 自动适配新版 Electron 的 asar 完整性校验（逐文件 SHA256 + exe 哈希同步）
🚀 直接启动 — 副本开箱即用，无需注入、无需提权，Store 版 / 官网 MSIX / 官网安装版通吃
⚡ 秒级重打 — 外科手术式定长补丁：不解包、不重打包，版本升级后重新汉化仅需约 30 秒
♻️ 更新自动跟随 — Codex 升级后启动器自动检测版本变化并重新打补丁，零干预

📸 效果

已实测版本：26.930.7945.0、26.1002.7124.0、26.1007.2314.0（Microsoft Store）、 26.915.4065.0、26.1029.7803.0（官网 MSIX 安装包）。26.1029 起字符串字面量改为双引号形态，已适配。

🚀 快速开始

git clone https://github.com/arronfan23/Codex-Chinese.git
cd Codex-Chinese
# 双击 install.cmd，或：
powershell -NoProfile -ExecutionPolicy Bypass -File src\install.ps1

也可以用网页右上角 Code → Download ZIP 下载解压后双击 install.cmd。

安装完成后：

用桌面新建的 「Codex」 快捷方式启动（指向中文副本，原版开始菜单入口不受影响）；
设置 → General → Language 选 中文（中国），立即生效。

还没装 Codex？Releases 中附带了官方 MSIX 安装包（26.915.4065.0，已实测兼容），也可从 Microsoft Store / 官网安装任意版本。

🍎 macOS 用户

macOS 版汉化工具已发布：Codex-Chinese-macOS —— 图形启动器一键汉化并启动，Apple 芯片 / Intel 通用，DMG 下载即用；同样完全离线、不修改原版、可随时卸载。

🔧 原理

Codex 桌面版官方自带完整的多语言翻译包（app.asar 内含 zh-CN.json 等），但多语言开关 enable_i18n 被实验开关默认关闭，界面因此永远是英文。本工具做的事：

Store/MSIX 版（受保护目录）        官网安装版（可写目录）
        │                                │
        │ 复制可写副本                    │ 直接补丁（自动备份）
        ▼                                ▼
  解包 app.asar ──▶ 开启 enable_i18n ──▶ 重打包（逐文件 integrity 校验哈希）
                          │
        ┌─────────────────┼──────────────────────────┐
        ▼                 ▼                          ▼
  默认语言回退       同步 exe 内嵌的              直接启动副本
  en → zh-CN       asar 完整性哈希              （无需注入/提权）

补丁按内容匹配（不依赖带哈希的文件名），混淆变量名随版本变化也能命中；关键补丁点未命中时会自动提取上下文片段，方便快速适配新版本。

⌨️ 命令行（可选）

# 只检测，不操作
powershell -NoProfile -ExecutionPolicy Bypass -File "src\install.ps1" -DryRun

# 手动指定安装路径（自动检测失败时）
powershell -NoProfile -ExecutionPolicy Bypass -File "src\install.ps1" -InstallPath "C:\path\to\codex\app"

# 强制重新本地化后启动
powershell -NoProfile -ExecutionPolicy Bypass -File "src\launch.ps1" -ForceUpdate

❓ 常见问题

问题	解决
启动时报 AccessViolation（Invoke-CommandInDesktopPackage）	该原生接口在部分机器上会崩溃，v1.5.1+ 已弃用身份注入，改为直接启动
每次 Codex 自动更新都要重新汉化，太慢	v1.4.0+ 已解决：快速通道补丁仅需约 30 秒，更新照收、等待归零。想彻底禁止更新：Win11 可用 `Set-AppxPackageAutoUpdateSettings -DisableUpdates`；Win10 可在 Microsoft Store 设置中全局关闭自动更新（会影响所有应用）
启动报 "找不到 ...\chrome_elf.dll 系统错误"	副本是上次中断留下的半成品。v1.3.6+ 会逐文件校验副本完整性，缺文件自动重拷并重打补丁，直接重跑 `install.cmd` 即可
报 "索引超出了数组界限"（Write-Host）	控制台 UTF-8 代码页下彩色中文输出触发的 conhost bug。v1.3.5+ 已移除 cmd 的 `chcp 65001` 并为全部输出/进度条加了兜底
报 "There is not enough space on the disk"	C 盘空间不足。安装峰值约需「副本大小 + 3× asar」≈ 3~4GB。v1.3.4+ 会在开始前预检并提示缺口；也可用 `setx CODEX_LOCALIZE_ROOT D:\codex-localized` 把工作目录换到其他盘（重开终端生效）
复制时报 "Access to the path ... is denied"	v1.3.3+ 已自动处理：副本后台进程会被按路径完全关闭；若仍失败，多为杀毒软件/勒索软件防护拦截 DLL 写入，放行 `powershell.exe` 后重试
启动报 "该进程没有程序包标识符"	旧版本已知问题，使用 v1.2.0+ 重跑 `install.cmd`（自动修复旧副本）
双击后进程一闪而过	同上，v1.2.0+ 已适配 asar 完整性校验
Codex 更新后界面回到英文	启动器会自动重打补丁；也可手动重跑 `install.cmd`
补丁点未命中	安装器会自动打印诊断片段，欢迎提 Issue 附上
完全卸载	删除 `%USERPROFILE%\.codex\codex-localized` 和桌面快捷方式即可，原版不受影响

📁 目录结构

├── install.cmd        # 双击安装
├── launch.cmd         # 手动启动本地化副本
├── docs/images/       # 横幅与实测截图
└── src/
    ├── install.ps1        # 安装器（检测 / 复制 / 补丁 / 完整性同步 / 配置）
    ├── launch.ps1         # 启动器（更新自动跟随 + 包身份注入启动）
    ├── patch-rules.ps1    # 补丁规则库（内容匹配 + 未命中自动诊断）
    ├── asar-util.ps1      # asar 解包 / 打包（纯 .NET：长路径 / 对齐 / 逐文件 integrity）
    └── smo-banner.ps1     # 终端像素字渐变横幅

📝 更新日志

v1.5.1 弃用 Invoke-CommandInDesktopPackage 身份注入（部分机器原生崩溃 AccessViolation），改为直接启动
v1.5.0 适配 26.1029 的双引号字面量形态（.get("enable_i18n",!1)），两种形态全渠道支持
v1.4.5 VC 运行库 DLL 被安全软件持续拦截时自动跳过并使用系统副本（不再整轮重试后中止安装）
v1.4.4 同步修复安装器现场生成的 launch.cmd（桌面快捷方式实际入口）的 PowerShell 路径解析
v1.4.3 启动器改用 PowerShell 完整路径，不再依赖 PATH（修复"'powershell' 不是内部或外部命令"）
v1.4.2 修复复制/解包/打包逐文件新建 8MB 缓冲区导致的内存碎片 OOM；改共享缓冲区后全流程提速约 4 倍
v1.4.1 复制重试窗口拉长至 ~67 秒（扛住杀毒软件扫描大文件的持锁），重试有提示；cmd 提示改纯 ASCII 修复乱码
v1.4.0 外科手术式定长补丁（快速通道）：不解包/不重打包，重新汉化从 ~7 分钟降到 ~30 秒；失败自动回退全量流程
v1.3.10 进程清理改为循环强杀+验证清空；复制遇文件占用按 0.5/2/5s 退避重试，修复"文件正由另一进程使用"
v1.3.9 补丁幂等识别：已汉化副本显示"已是目标状态"并跳过重打包（秒过），不再误报关键补丁点未命中
v1.3.8 进度条空段改用 ASCII -（GBK 控制台映射不出 ░ 会显示问号）
v1.3.7 进度条改为光标行内自绘（\r 回车刷新），不再覆盖顶部 SMO 横幅
v1.3.6 副本逐文件完整性校验，修复中断残留半成品导致的 chrome_elf.dll 缺失；重拷后强制重打补丁
v1.3.5 修复控制台 UTF-8 代码页下彩色中文输出触发的 conhost bug（Write-Host 索引越界）
v1.3.4 磁盘空间预检 + 补丁后即时清理临时目录 + CODEX_LOCALIZE_ROOT 换盘支持
v1.3.3 修复副本后台进程占用 DLL 导致的复制 Access Denied（按路径清理进程）
v1.3.2 品牌升级：README 横幅、中英双语、特性矩阵
v1.3.1 桌面快捷方式统一命名为 Codex
v1.3.0 全程进度条（复制 / 解包 / 校验 / 写盘）、终端横幅、README 完善
v1.2.0 修复三大启动障碍：asar 完整性校验（exe 哈希同步 + 逐文件 integrity）、asar 头部对齐、 MSIX 包身份注入启动；旧副本自动修复
v1.1.0 实测适配 26.915.4065.0（MSIX），Release 附带官方安装包
v1.0.0 首个版本：内容匹配补丁规则、长路径支持

English

Codex-Chinese enables the official built-in Simplified Chinese UI of the Codex desktop app (Microsoft Store / MSIX / EXE editions) with a one-click installer.

Codex ships 60+ official language packs but keeps enable_i18n off by default — this tool flips it on
Pure PowerShell, no third-party dependencies, no admin rights required, original install untouched
Handles Electron asar integrity validation (per-file SHA256 + embedded exe hash sync) and MSIX package-identity checks automatically
Switch between Chinese and English anytime in Settings → General → Language

git clone https://github.com/arronfan23/Codex-Chinese.git
cd Codex-Chinese
powershell -NoProfile -ExecutionPolicy Bypass -File src\install.ps1

Name		Name	Last commit message	Last commit date
docs		docs
src		src
.gitattributes		.gitattributes
LICENSE		LICENSE
README.md		README.md
install.cmd		install.cmd
launch.cmd		launch.cmd

Navigation Menu

Repository navigation

About

Repository files navigation

🎬 项目介绍视频

✨ 特性

📸 效果

🚀 快速开始

🍎 macOS 用户

🔧 原理

⌨️ 命令行（可选）

❓ 常见问题

📁 目录结构

📝 更新日志

English

📄 License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🎬 项目介绍视频

✨ 特性

📸 效果

🚀 快速开始

🍎 macOS 用户

🔧 原理

⌨️ 命令行（可选）

❓ 常见问题

📁 目录结构

📝 更新日志

English

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages