Agent Skills
返回列表
Codex 中文启动器

Codex 中文启动器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装规范名为 @user_dde237c9/setup-codex-zh 的 Codex 中文启动器技能到当前 AI 助手中。

技能介绍

要解决的问题

Windows 上的 Microsoft Store 版 Codex Desktop 并不保证始终处于完整中文界面;依赖 Codex++ 等启动 DeepSeek 模型的用户,也常遇到重启后语言回退、入口不统一的问题。setup-codex-zh 的目标很窄:把 Store 版 Codex 的桌面语言稳定锁到中文,并提供一个可持续使用的中文启动器。

核心能力

  • 自动定位 Store 版 Codex 与 OpenAI.Codex 包的 AUMID,不碰 WindowsApps 安装目录。
  • 检查 Node.js 环境,缺失时通过 winget 安装 Node.js LTS。
  • 将 bootstrap.mjs、launch-zh.mjs 和桌面脚本复制到 %USERPROFILE%\.codex\codex-zh-launcher\。
  • 在既有 %USERPROFILE%\.codex\config.toml 的 [desktop] 下仅追加 localeOverride = "zh-CN",保留其余配置。
  • 在桌面生成 启动中文版 Codex.ps1,后续用它进入完整中文界面。
  • 若此前用 Codex++ 等启动 DeepSeek,可先完成 DeepSeek 的 Codex 配置,再改用中文启动器。

使用流程与验证

首次运行前需完全退出 Codex(包括托盘图标),否则启动器会拒绝运行。右击桌面的 启动中文版 Codex.ps1 用 PowerShell 运行,看到 汉化完成:中文界面已生效。 即为生效;若脚本未运行,需先设置当前用户的 PowerShell 执行策略。验证标准是菜单栏出现 文件 / 编辑 / 视图 / 帮助,启动器日志出现 汉化完成。之后每次都用该桌面脚本启动 Codex。

适用边界

它不修改 app.asar,不需要管理员权限,不读取或改写账号、令牌和项目文件,只追加语言配置。若 Codex 正在运行,脚本不会强行注入,而是要求先退出。失败时按错误信息处理,必要时参考 references/technical-notes.md,其中记录了内部机制、验证方法与常见故障。

使用场景

  • 首次安装 Store 版 Codex 后,需要把桌面端菜单和界面切换为完整中文。
  • 日常使用 Windows 版 Codex 写代码,希望每次启动后中文界面都保持不回退。
  • 手动改 config.toml 后界面仍不是中文,需要确认 localeOverride 是否生效。
  • 通过 Codex++ 启动 DeepSeek,想换用中文启动器并保持模型配置不变。

适合人员

  • 在 Windows 上使用 Store 版 Codex Desktop 的开发者,想把界面固定为中文再开始工作。
  • 习惯用 Codex 并依赖 Codex++ 或 DeepSeek 的桌面用户,需要统一中文入口。
  • 帮同事配置 Codex 环境的技术负责人,想不修改安装目录也能启用中文界面。