在 Windows 安装 Codex Dream Skin

支持与要求

• 已安装微软商店官方 Codex 的 Windows
• Node.js 22 或更高版本
• PowerShell
• 允许创建桌面和开始菜单快捷方式

安装启动器

.\scripts\install-dream-skin.ps1

安装器会记录现有外观值、设置配套基础主题，并在未使用 -NoShortcuts 时创建启动和恢复快捷方式。

启动主题会话

.\scripts\start-dream-skin.ps1

如果 Codex 已经打开但没有经过验证的 Dream Skin 端点，请先关闭它。命令行调用者只有明确添加 -RestartExisting 才会重启已打开窗口。

验证主题

.\scripts\verify-dream-skin.ps1 -ScreenshotPath "$env:USERPROFILE\Desktop\codex-dream-skin.png"

同时检查主页和普通任务页。缺少横幅、原生输入框、侧栏主题或运行时样式标记都属于验证失败。

恢复官方外观

.\scripts\restore-dream-skin.ps1 -RestoreBaseTheme

恢复流程会关闭记录的 CDP 会话、还原保存的外观项并重新打开官方应用。只有同时想移除快捷方式时才添加 -Uninstall。

常见问题

• 默认 9335 端口被占用时，普通启动器会选择空闲端口；明确指定了被占用端口则会停止。
• Codex 更新后重新运行安装和启动，让脚本重新发现当前商店包。
• 本机 CDP 会话运行时不要启动不可信软件。
• 主题没有出现时，通过 GitHub Issue 提交 verify 输出。

编辑复核说明

本页是帮助用户理解源码流程的独立阅读指南，不是安装包镜像。内容把上游公开工作流整理为准备、执行、验证和恢复四个阶段，让用户在运行脚本前知道每一步的目的、预期结果与停止条件。仓库可能在复核日期之后更新，所以操作前仍应对照当前 README、脚本内容、文件历史和问题区。如果命令名称、版本要求或行为已经变化，应以当前源码为调查依据，不要为了执行旧命令而降低系统安全设置。

运行 PowerShell 前核对来源

从本页上方链接打开原始仓库，核对浏览器地址、仓库所有者和 Windows 目录，不要从搜索结果下载名称相似的压缩包。依次阅读 install、start、verify 和 restore 脚本，把它们看作同一个生命周期，而不是只查看安装入口。GitHub 可以显示每个文件的提交历史；记录你所复核的提交或发布版本，后续排错才能基于同一份源码。PowerShell 脚本会以当前用户权限读取本机文件、启动进程并写入用户配置，因此短暂的源码检查非常重要。

• 确认官方 Codex 来自 Microsoft Store，并且在加入视觉层前能够单独正常打开。
• 检查近期 Issue 中是否有相同的商店包发现、端口占用或 Codex 更新问题。
• 保持 Windows Security 启用，不要为了运行陌生压缩包而关闭防护。
• 核对快捷方式、状态目录和脚本写入位置是否与源码说明一致。
• 记录所用提交、Node.js 主版本与命令参数，避免后续混用不同版本。

理解每个阶段的预期结果

准备阶段结束时，官方应用应该仍然可用但已关闭，Node.js 与 PowerShell 可由同一用户调用。安装阶段只应创建项目文档说明的用户文件、已保存外观状态和可选快捷方式。启动阶段通过文档记录的本机运行时样式路径打开 Codex，不应把官方应用替换成另一个可执行文件，也不应要求上传凭据。验证既要确认视觉变化，也要确认原生交互。恢复应回到普通外观，同时保留对话、项目、登录状态、模型供应商配置和微软商店签名包。

遇到意外结果时不要盲目重复命令。商店包缺失时先检查官方应用；端口占用时先识别占用进程，不要随意结束其他程序；首页有效但任务页无效时，记录具体页面和验证输出；恢复无法识别已记录会话时，正常关闭 Codex、保留状态目录，再阅读当前上游说明。不同异常对应不同调查路径，把所有问题都归结为重新安装反而会破坏证据。

Windows 验证清单

• 检查首页项目卡片、导航、账户控件和键盘焦点仍然是可交互的原生控件。
• 分别打开已有任务和新任务，确认正文、代码、链接、状态和报错文字没有被背景干扰。
• 聚焦底部输入框并输入未发送文字，确认输入区域边界清晰，不在截图中泄露敏感内容。
• 缩放到日常使用的最窄窗口，并在实际 Windows 显示缩放比例下检查裁切。
• 运行 verify 脚本并保存文本输出；截图只能辅助，不能代替诊断结果。
• 正式使用前执行一次恢复，确认可以退出视觉层并回到官方外观。

验证成功的标准不是看见背景，而是官方界面继续容易阅读和操作。任务历史、菜单、悬停态、弱化文字与输入框比空白首页更容易暴露对比度问题。背景应在左侧和正文区域保持低细节，避免高亮纹理与小字竞争。如果必须用大面积不透明遮罩才能阅读，应先简化原图，而不是继续堆叠样式。

更新后排查并提交有效问题

Microsoft Store 可能更新 Codex 安装包，上游项目也可能更新发现逻辑和视觉样式。原本可用的流程失效时，要把两条时间线分开：先恢复并确认官方 Codex 单独正常，再记录应用更新时间，并对比最初复核的上游提交。只有当前文档明确要求时才重新安装或应用。不要把旧 Issue 评论里的命令直接复制到新版本源码目录执行。

• 提供 Windows 版本、CPU 架构、Node.js 主版本，以及 Codex 是否来自 Microsoft Store。
• 写明脚本与参数，但移除用户名、令牌、可识别个人的路径和任务内容。
• 附上最小必要的 verify 输出和日志片段，并在公开前做脱敏。
• 说明官方外观在恢复后是否正常，以及端口是自动选择还是手动指定。
• 网站文案问题反馈给 CodexSkin；脚本运行问题提交上游，并附所用提交。