JavaScript · 项目报告

Fei-Away/Codex-Dream-Skin

Codex Dream Skin

已完成 打开 GitHub
F
11,482星标
1,165Fork
119Issue
未知许可证

分析结果

项目分析

Codex Dream Skin 是一个面向 Codex 桌面端的外部主题/换肤工具,通过本机 CDP 注入方式为 Codex UI 添加可定制背景与视觉主题,不修改官方安装包、app.asar、WindowsApps 或代码签名。项目提供 macOS 与 Windows 脚本,支持换图、自定义主题和一键恢复官方外观。该项目非 OpenAI 官方产品。

适用领域 桌面端工具 / AI 编程工具生态 / UI 美化与主题定制 / Codex 客户端增强 / PowerShell/脚本自动化 / 本地 CDP 调试注入
配置难度 中等。普通开发者按照 README 执行脚本即可使用;但涉及 PowerShell、macOS 脚本权限、本地 CDP 注入和故障恢复,非技术用户可能需要额外指导。
商业价值 该项目主要价值在于提升 Codex 桌面端的个性化体验和使用氛围,适合个人开发者、AI 编程工具重度用户、内容创作者和演示场景。商业价值偏工具增强和生态周边,直接变现能力有限,但可作为主题市场、企业定制皮肤、开发者工作台美化插件或 AI 工具分发入口的基础。由于非官方和存在 UI 兼容风险,若用于商业化需要重点处理授权、稳定性、安全审计和官方政策合规问题。
01

技术亮点

  • 不修改官方 Codex 安装目录、二进制文件、app.asar 或 WindowsApps,相对降低破坏性。
  • 通过本机 CDP 注入实现主题化,官方客户端更新后理论上更容易恢复。
  • 支持 macOS Apple Silicon、Intel Mac 与 Windows。
  • 保留 Codex 原生控件交互,不是简单用整窗截图覆盖。
  • 可换图,可根据个人喜好快速定制主题。
  • 提供一键恢复官方外观能力。
  • README 展示了多种视觉主题示例,降低用户理解成本。
  • 项目关注度较高,已有 5000+ stars 和数百 forks。
02

目标用户

  • 正在使用 Codex 桌面端的开发者
  • 希望美化 AI 编程工具界面的用户
  • 喜欢自定义桌面应用主题的个人开发者
  • 需要在不修改官方安装包前提下进行 UI 主题化的用户
  • 熟悉 macOS 或 Windows 脚本执行的技术用户
03

配置要求

  • 需要已安装 Codex 桌面端。
  • macOS 需要允许执行 .command 脚本,可能需要终端权限或安全设置放行。
  • Windows 需要可执行 PowerShell 脚本,可能需要调整 ExecutionPolicy。
  • 主题注入依赖本机回环地址 127.0.0.1 的 CDP 连接。
  • 主题运行期间不建议同时运行来源不明的本机程序,以降低本地 CDP 暴露风险。
  • 项目不会自动修改 API Key、Base URL 或模型供应商配置。
  • 自定义图片需要用户自行准备,并注意图片版权、肖像权、商标/IP 授权问题。
04

适用场景

  • 给 Codex 桌面端更换背景图和主题风格
  • 在保留原生交互控件的情况下增强 Codex 界面氛围感
  • 快速切换不同视觉主题,如粉系、科幻、黑金、动漫风等
  • 通过一键恢复将 Codex 还原为官方默认外观
  • 为个人工作流或直播/演示场景定制更有辨识度的 Codex 界面
05

部署与配置

  • 确认本机已安装 Codex 桌面端,并能正常运行。
  • 克隆或下载该 GitHub 仓库。
  • macOS 用户进入 macos/ 目录,双击 Install Codex Dream Skin.command 安装,按提示完成授权或执行流程。
  • Windows 用户进入 windows/ 目录,先运行 scripts/install-dream-skin.ps1,再运行 start-dream-skin.ps1 启动主题。
  • 根据仓库文档选择或替换主题图片。
  • 如需还原官方外观,运行项目提供的 Restore/还原脚本或按平台文档执行恢复流程。
  • 遇到问题时,先参考 macos/README.md、windows/SKILL.md、docs/platforms.md,并运行 Verify/Restore 自检。
06

风险与注意事项

  • 该项目非 OpenAI 官方产品,Codex 更新后可能导致脚本失效或 UI 注入异常。
  • CDP 注入虽然绑定 127.0.0.1,但本质仍涉及本地调试接口,若本机存在恶意程序可能有安全风险。
  • Windows PowerShell 脚本执行可能被安全策略、杀毒软件或企业终端管控拦截。
  • 主题图片中的人物、动漫 IP、商标等若用于商用或公开分发,可能存在版权、肖像权或商标风险。
  • 项目 license 信息在仓库元数据中为空,README 指向 macos/LICENSE 为 MIT,但整体仓库授权边界需要进一步确认。
  • 依赖 Codex 桌面端内部 UI 结构,官方界面改版可能导致样式错位。
  • 安装和恢复流程对非技术用户仍有一定门槛。

历史记录

热榜历史快照

2026-07-22 第1名 新收录 · github_search
2026-07-21 第2名 新收录 · github_search
2026-07-20 第2名 新收录 · github_search
2026-07-19 第2名 新收录 · github_search
2026-07-18 第2名 新收录 · github_search
2026-07-17 第2名 新收录 · github_search