CodexSkin/安全

Codex 皮肤安全

安装之前，先知道什么会运行。

检查本地处理、安装包源码、CDP 风险和恢复路径。

检查源码阅读安全边界
CodexSkin Studio 展示本地 Codex 皮肤预览
图片浏览器本地处理
引擎开源且固定版本
官方应用不修改 app.asar
恢复安装包包含 Restore

你的图片留在当前设备。

浏览器会在本地解码、裁切并重新编码你选择的图片，压缩包也在浏览器内生成。制作皮肤不需要图片上传接口，也不需要账号。

网站仍可能接收什么普通网页请求可能包含隐私政策中说明的基础网络与统计数据。你选择的图片和生成的 ZIP 不会进入页面统计流程。

从图片到安装包，数据会经过这些步骤。

  1. 选择图片浏览器读取本地 PNG、JPEG 或 WebP，不会把文件提交给图片处理 API。
  2. 准备背景图Canvas 在当前设备裁切、定位并重新编码为 2560 × 1440 JPEG。
  3. 加载固定模板浏览器从 CodexSkin 存储下载公开的 macOS 或 Windows 安装模板。
  4. 生成并下载 ZIP图片与设置在本地写入模板，浏览器再计算最终压缩包的 SHA-256。

安装包边界

生成的 ZIP 包含本机代码。

生成包包含处理后的图片、主题设置、固定版本的开源 Dream Skin 引擎，以及可见的安装与恢复入口。它不是只有图片的数据包。运行前请检查上游源码和构建记录。

当前模板使用上游 1.2.0，提交为 5fd8af532efbaa87d2d0092297fd2d45cd56574e。Studio 会为每个生成的 ZIP 显示新的 SHA-256。

安装包内容作用会运行代码吗？
处理后的背景图在本地生成的 2560 × 1440 图片不会
主题配置名称、焦点、遮罩、模糊、安全区域和强调色不会
Dream Skin 引擎对运行中的 Codex 渲染器应用视觉层会
Install / Start 入口安装固定版本引擎并启动皮肤会话会
Verify / Restore 入口检查安装状态或恢复正常 Codex会
GENERATED.txt记录生成器、上游版本和源码提交不会

明确这套设计能保护什么，不能保证什么。

设计上提供的保护

  • 选择的图片不经过上传处理。
  • 不修改 Codex 官方应用包、app.asar 和代码签名。
  • 保留回到正常 Codex 外观的清晰路径。
  • 能够追溯固定版本引擎和源码提交。

不代表绝对安全

  • 可执行安装代码仍需要你的信任和检查。
  • CDP 运行时，同一用户的本机进程仍可能访问它。
  • 未来 Codex 或引擎更新可能改变兼容性。
  • 本地生成不会自动让未知图片或软件变安全。

回环地址上的 CDP 仍然具有高权限。

引擎通过绑定到 127.0.0.1 的 Chromium DevTools Protocol 启动 Codex 渲染器。这会阻止外部网络直接访问，但 CDP 没有同一用户身份验证。本机上以同一用户运行的恶意进程仍可能访问该调试端口。

  • 皮肤会话运行时，不要打开来源不明的本机程序。
  • 检查未知项目或工具前，先运行 Restore。
  • 及时更新 Codex 和开源引擎。
  • 不要把调试端口暴露到其他网络接口。

Codex 官方文件保持不变。

文档中的 macOS 和 Windows 流程不会替换官方应用包、修改 app.asar、写入 WindowsApps 或更改官方代码签名。皮肤会话单独启动，自定义文件保存在用户目录。

安装后先练习一次 Restore。

生成包会创建 Restore 入口，用于停止保存的 CDP 会话并正常打开 Codex。建议在一切正常时先测试一次，以便 Codex 更新或皮肤异常后快速恢复。

查看恢复步骤

供应链

校验你真正运行的版本。

先对照下方模板记录。Studio 生成个性化 ZIP 后，保存页面显示的 SHA-256，并在运行安装器前重新计算本机哈希。

macOSshasum -a 256 your-skin-macos-installable.zip
Windows PowerShell(Get-FileHash .\your-skin-windows-installable.zip -Algorithm SHA256).Hash
上游源码检查 Dream Skin 引擎与平台说明。构建记录确认固定版本和源码提交。模板校验值对照公开的安装模板哈希。

发现安全问题或记录不一致？请在不附带私人图片、凭据或敏感日志的前提下，提交上游 Issue。

使用 Codex 皮肤前常见的问题

Codex 皮肤安装安全吗？

CodexSkin 在浏览器本地处理图片，固定使用开源 Dream Skin 引擎版本，记录源码提交并包含 Restore。安装脚本和引擎仍然会在本机运行代码，因此请先检查源码，并在 CDP 运行时避免打开来源不明的本机程序。

CodexSkin 会修改 app.asar 或官方应用吗？

不会。文档中的 Mac 和 Windows 流程不会修改 app.asar、官方应用包、WindowsApps 文件或官方代码签名。

为什么 Codex 皮肤需要 CDP？

Dream Skin 引擎通过 Chromium DevTools Protocol 对运行中的 Codex 界面应用视觉样式。端口绑定到 127.0.0.1，但同一用户运行的其他本机进程仍可能访问该调试端口。

如何恢复 Codex 官方界面？

使用生成的 Mac 或 Windows 安装包中的 Restore 入口。它会停止已保存的皮肤会话，并正常打开 Codex。

Codex 皮肤会读取 API Key 或模型设置吗？

文档中的 CodexSkin 流程不会读取或修改 API Key、供应商设置或模型配置。它只准备视觉素材，并单独启动皮肤会话。

浏览器本地生成的 ZIP 就一定安全吗？

不一定。本地生成能保护图片隐私，但安装模板和内置引擎仍包含可执行代码。运行前应检查公开的构建记录、校验值和固定版本源码。