codex-skin.dev

Codex Dream Skin Windows 安装教程（含报错排查）

原理与安全边界

Codex Dream Skin 通过 Chromium DevTools Protocol 为 Microsoft Store 安装的官方 Codex 应用注入可逆的渲染器皮肤。它绝不替换或取得 WindowsApps 下文件的所有权，保持安装安全并维护官方包签名。

所有原生功能保持完整：侧边栏、建议卡片、项目选择器、编辑器和菜单均完全可交互。仅装饰性横幅与背景图层被定制。

前置条件

分步安装

1. 下载 Dream Skin 仓库

打开 PowerShell 或命令提示符，克隆仓库：

git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin\windows

2. 关闭正在运行的 Codex

继续之前确保 Codex 完全关闭。检查任务管理器确认没有 Codex 进程运行。

3. 运行安装脚本

在 windows 目录中打开 PowerShell 并运行：

.\scripts\install-dream-skin.ps1

该脚本会：

4. 启动皮肤

双击桌面上的 Start Codex Dream Skin.lnk，或运行：

.\scripts\start-dream-skin.ps1

脚本会：

**注意：**如果 Codex 已在运行，快捷方式会在重启前询问。CLI 用户必须显式添加 -RestartExisting 标志。

验证生效

启动后，检查以下标志：

  1. 自定义横幅：顶部出现 Dream 风格粉紫横幅
  2. 主题背景：任务视图显示 Dream 皮肤背景
  3. 原生控件保留：侧边栏、项目选择器、编辑器按钮正常工作
  4. 注入标记：检查窗口标题或开发者工具是否有皮肤标记

你也可以使用验证脚本：

.\scripts\verify-dream-skin.ps1 -ScreenshotPath "C:\path\to\screenshot.png"

脚本会检查横幅、原生编辑器、侧边栏皮肤和注入标记。

恢复官方外观

双击桌面上的 Restore Codex Official Theme.lnk，或运行：

.\scripts\restore-dream-skin.ps1

这会：

如需同时恢复原始外观设置的备份：

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

你的配置、对话历史和身份验证状态不受影响。

常见问题排查

Microsoft Store 版报「拒绝访问」错误

**症状：**启动皮肤时看到「拒绝访问」（Access Denied）错误。

**原因：**Store 安装的 Codex 可执行文件有受限的启动权限，标准路径无法绕过。

**解决方法：**最新版 Dream Skin 仓库包含修复，使用 shell:AppsFolder 方法正确启动 Store 应用。应用修复：

  1. 拉取最新仓库更改： 
    cd Codex-Dream-Skin
git pull
  2. 重新运行安装脚本： 
    cd windows
.\scripts\install-dream-skin.ps1
  3. 再次启动皮肤

如果已是最新版仍有此错误，请查看仓库 issues 获取更新。

Windows SmartScreen 拦截脚本

**症状：**运行 PowerShell 脚本时，SmartScreen 显示警告，如「Windows 已保护你的电脑」或「Microsoft Defender SmartScreen 阻止了无法识别的应用启动」。

**发生原因：**脚本未经数字签名，SmartScreen 将其标记为潜在不安全。

解决方法：

  1. 先验证来源：确保你从官方仓库克隆（https://github.com/Fei-Away/Codex-Dream-Skin）
  2. 在 SmartScreen 对话框中点击**「更多信息」**
  3. 点击**「仍要运行」**

**重要：**不要全局禁用 SmartScreen。这是有用的安全功能。只为你信任的已验证来源的脚本绕过它。

PowerShell 显示 NativeCommandError 或红色文本

**症状：**在 PowerShell 5.1 中运行脚本时，看到红色错误文本，提到 NativeCommandError 或 stderr 重定向问题，即使脚本看起来工作正常。

**原因：**PowerShell 5.1 将原生可执行文件（如 Node.js）的 stderr 输出包装成 ErrorRecord 对象，导致表面错误，但不反映实际失败。

解决方法：

官方 Codex 更新后皮肤失效

这是预期行为。Codex 更新可能改变内部渲染器目标或包路径。解决方法：

  1. 拉取最新版 Dream Skin 仓库： 
    cd Codex-Dream-Skin
git pull
  2. 重新运行安装脚本： 
    cd windows
.\scripts\install-dream-skin.ps1
  3. 再次启动皮肤

如果仍然无效，请回到本画廊查看兼容性状态更新，或等待上游适配。

找不到 Node.js

**症状：**脚本报告 Node.js 未安装或找不到。

**解决方法：**从 nodejs.org 安装 Node.js 22 或更新版本。安装后，关闭并重新打开 PowerShell 以刷新 PATH，然后重试。

皮肤出现但某些元素看起来不对

查看仓库中 references/qa-inventory.md 的参考 QA 清单，了解预期与非预期的渲染。在仓库 issues 中报告意外行为。

端口被占用

**症状：**脚本报告默认端口 9335 被占用。

**解决方法：**脚本会自动寻找空闲端口。如果仍有问题，检查哪个程序占用了端口：

netstat -ano | findstr :9335

然后决定是关闭占用程序还是让脚本使用其他端口（自动处理）。

相关资源：