Skip to content

install-windows.md

Latest commit

 

History

History
95 lines (65 loc) · 5.69 KB

install-windows.md

File metadata and controls

95 lines (65 loc) · 5.69 KB
Raw

Windows 安装与更新

本页面向只想使用主题的普通用户。Release 安装器包含所需运行时，不需要 clone 仓库、安装全局 Node.js 或执行 PowerShell 脚本。

首次安装

先从 Microsoft Store 安装官方 ChatGPT / Codex 桌面应用，至少启动一次后退出。

  1. 在 GitHub 的 Releases 下载最新的 CodexDreamSkin-Setup-vX.Y.Z.exe。SHA256SUMS.txt 是可选的完整性校验文件。
  2. 双击安装器，按向导完成安装。默认安装到当前用户的 LocalAppData，不需要管理员权限；安装前 请先退出 Codex。
  3. 安装完成后，从开始菜单启动 Codex Dream Skin，系统托盘会显示主题图标。

为什么有时会看到“Windows 已保护你的电脑”

公开发行包目前没有购买代码签名证书。Windows SmartScreen 会综合下载来源、文件的 “来自互联网”标记（Mark of the Web）和 Microsoft 的信誉数据作判断，因此同一个版本在不同电脑、 浏览器或下载时间可能表现不同。你很少遇到提示是正常的：文件已有信誉、来自组织分发，或浏览器 没有保留该标记时，SmartScreen 可能直接放行。

如果 SmartScreen 显示蓝色警告：

  1. 点击 更多信息。
  2. 核对文件名、下载来源；需要时再对照 Release 提供的 SHA-256。未签名版本会显示未知发布者。
  3. 确认来源无误后点击 仍要运行。

不要为了安装而关闭 Defender、SmartScreen 或系统的 Smart App Control。如果组织策略没有“仍要运行”， 请联系管理员或使用受组织批准的分发方式；不要下载来路不明的替代安装器。

安装器本身不应要求提升到管理员权限。若出现意外的管理员密码提示，取消并核对下载地址、版本和 文件属性后再报告问题。

日常使用

使用“Codex Dream Skin”快捷方式启动，使用托盘菜单换图、导入主题 ZIP、保存主题、暂停或恢复。主题和运行状态 保存在 %LOCALAPPDATA%\CodexDreamSkin，安装目录可以更新而不会删除这些数据。

安装后的快捷方式使用受限的 RemoteSigned 策略；普通用户不需要打开 PowerShell，也不需要手动 运行 .ps1 文件。

下载到 .zip 主题包后，选择“导入主题 ZIP…”。只接受普通 .zip，不接受 .dreamskin。正式 Studio 包包含 manifest.json、非空 theme.json、非空 theme.css、恰好一张 background.webp|jpg|png，并可选带 LICENSE.txt、manifest.sig；这些文件可直接位于根目录或只包一层主题目录。导入器会核对平台、最低 客户端版本以及清单中每个负载文件的大小和 SHA-256。theme.css 会在本机导入和应用时复验，通过后只 作用于注册部件；预留签名当前不验证。本地简化包也必须恰好包含 theme.json、theme.css 与引用图片。 导入只加入主题库，不会自动应用。ZIP 最大 32 MiB、最多 32 个条目、解压后最多 64 MiB；路径穿越、 链接/reparse、嵌套压缩包、Windows 保留路径及不符合主题/图片约束的内容会在写入前被拒绝。

手动方式：从托盘选择“打开主题文件夹”，把已经解压且直接包含 theme.json、theme.css 与背景图的完整目录放入 %LOCALAPPDATA%\CodexDreamSkin\themes\，再重新打开托盘菜单。不要只移动图片，也不要让目录里再套 一层主题目录。手动目录不经过 ZIP 导入器的归档校验，请只移动可信内容。

手动更新

更新是覆盖安装，不是重新配置：

  1. 从 Releases 下载新的 CodexDreamSkin-Setup-vX.Y.Z.exe。
  2. 退出 Dream Skin 托盘，并关闭 Codex。
  3. 运行新的安装器，按向导覆盖现有安装。
  4. 重新启动快捷方式；活动主题、已保存主题、图片和配置备份会保留。

SmartScreen 的决定针对下载到本机的具体文件。你对某个安装器点击“仍要运行”后，通常不会在每次 启动已安装快捷方式时再弹一次；但每次下载新的未签名 Setup.exe 都可能重新出现一次警告，不能把 “只安装一次”理解为所有未来版本都自动获得信任。更新不需要再次运行 PowerShell 放行命令。

托盘中的“检查更新”只在用户点击时访问 GitHub Releases；不会后台轮询、自动 下载或静默替换安装包。

卸载与恢复

在“设置 → 应用 → 已安装的应用”中卸载 Codex Dream Skin。卸载器会先恢复 Codex 官方外观并关闭 CDP；恢复失败时会停止卸载，不会直接删除运行文件。默认保留 %LOCALAPPDATA%\CodexDreamSkin 中的 主题和图片，方便重新安装；确认不再需要时再手动删除该数据目录。

常见问题

没有“仍要运行”

这通常是企业策略或 Windows 11 Smart App Control 在阻止未签名程序。不要关闭安全策略；改用组织 批准的机器/分发渠道，或把完整的 SmartScreen 画面、Windows 版本和安装器 SHA-256 提交 Issue。

安装后仍提示找不到 Node.js

确认使用的是 Release Setup.exe，而不是仓库脚本安装方式。Release 安装器会带上固定的 Node 运行时； 若问题持续，请保留安装日志并报告版本，不要随意从第三方网站下载 node.exe 覆盖安装目录。

Codex 更新后主题失效

退出托盘后重新运行最新 Setup.exe，再使用 Dream Skin 快捷方式启动。安装器会重新发现当前注册的 官方 Store 包，用户主题和图片不会被删除。

开发者和高级用户仍可参阅 windows/README.md 的仓库安装章节；普通用户应 优先使用 Release Setup.exe。