把兼容性当作有日期、可验证的结论
几个月前的截图或一次成功安装不能证明当前 Codex、操作系统和上游源码仍然配合。兼容性涉及官方应用分发、处理器架构、脚本前置条件、渲染行为、本机端点、图片处理和恢复。本页复核日期为 2026 年 7 月 20 日，不声称此后持续测试。使用前要查看当前原始仓库、近期提交与 Issue，并确认自己机器上的官方应用状态。保留源码提交和环境信息，使结果能够复现，而不是只有对我有效的模糊描述。
- 记录复核日期和源码提交。
- 写明官方应用分发来源。
- 包含系统和处理器架构。
- 相关组件更新后重新验证。
上游文档记录的 Windows 范围
复核时上游 Windows 指南面向 Microsoft Store 官方 Codex，并列出 Node.js 22 或更高版本与 PowerShell。其生命周期包含安装、启动、验证、通过当前 Windows 托盘界面选择背景和恢复。项目说明会核对包身份，并通过本机运行时样式连接工作，而不是重新打包签名 Store 应用。这些是归因于仓库的事实，不是 OpenAI 或 CodexSkin 保证。Windows 版本、商店包变化、受管设备策略、安全软件、固定端口与未来渲染变化仍可能影响结果。
- Microsoft Store 官方 Codex。
- Node.js 22+ 与 PowerShell。
- 安装、启动、验证和恢复分开。
- 商店或项目更新后重新核对。
上游文档记录的 macOS 范围
复核时 macOS 内容涉及 Apple Silicon 与 Intel，要求官方 Codex 至少启动过一次，并描述用户目录中的本机配置。文档说明该流程不要求额外全局 Node.js。Finder .command 启动器覆盖安装、启动、定制、验证和恢复，并提供可选菜单集成；图片处理支持若干常见格式与大小边界。这些仍取决于当前源码。Gatekeeper、架构、Finder 与 Terminal 的 PATH 差异、文件访问、受管策略和官方应用更新，会造成具体环境差异。
- 覆盖 Apple Silicon 与 Intel。
- 官方 Codex 应先正常启动。
- 文档不要求额外全局 Node.js。
- 权限与架构仍需按机器验证。
把本站实践观察与上游事实分开
CodexSkin 的第一方贡献是编辑整理、构图实践、可读性检查和公开源码文档复核。20:9 画布、右侧焦点、左侧 55% 安静区和避开底部输入框，都是同一图片兼顾首页与任务页的实践建议，不是平台要求。本站不分发或修改辅助工具，也不声称测试每一个官方 Codex 构建。看到背景不等于兼容；原生导航、任务阅读、输入框、焦点状态、验证输出和恢复都必须在用户真实环境中工作。
- 构图百分比属于实践建议。
- 显示背景不等于完整兼容。
- 原生交互和可读性必须通过。
- 恢复属于兼容测试的一部分。
诚实标记未知或未验证环境
如果当前上游没有明确文档，不要推断 Linux、非官方 Codex 构建、重新打包客户端、远程暴露调试、企业受管配置、预发布系统或未来处理器架构受到支持。Issue 中没有失败报告也不能证明兼容，一条社区评论更不能形成普遍结论。面对未知环境，应阅读源码，判断官方应用身份和平台入口是否匹配；如果流程要求绕过安全或修改签名安装，应停止。向上游确认之前，不要把临时做法公开成受支持方案。
- 未知不等于支持或不支持。
- 不要从单条反馈推广结论。
- 避免无签名镜像与重打包客户端。
- 广泛声明前先向上游确认。
建立自己的兼容性记录
正式依赖主题前，记录系统版本、架构、官方 Codex 来源、源码提交、前置版本、启动器、图片格式，以及首页、任务页、verify 和 restore 是否通过。任何更新后先恢复，独立确认官方应用，再比较发生变化的组件并重跑完整记录。失败时把脱敏证据提交负责的上游 Issue，删除任务内容、用户名、令牌、私人路径和背景图。兼容记录的价值不是永久绿色徽章，而是明确说明在什么日期检查了什么、哪些仍未知，以及如何安全返回官方外观。
- 准确记录环境与源码。
- 检查首页、任务、验证和恢复。
- 更新后完整重复。
- 保留未知状态，不做猜测。