Codex 2006

把 Codex Desktop 装进一扇 2006 年的蓝色 QQ 窗口里。

Windows 正式主题合成图	macOS 正式主题合成图

上图由同一套正式主题在 Windows/macOS 平台分支的 1448 × 1085 synthetic 合成宿主中生成，用于说明视觉方向，不是运行中 Codex 的截图，也不是兼容性或安装验收证据。图中的导航、任务、代码块、Composer、审批和停止按钮来自测试夹具，不冒充当前 Codex 的真实 DOM。macOS 分支只为系统原生 traffic lights 预留标题栏区域，不仿造窗口按钮；正式运行时主题只添加不可交互的背景与装饰，并把当前 Codex 原生 DOM 保留为唯一交互层。

Codex 2006 是一个 clean-room 实现的轻量桌面皮肤。它以 QQ 2006 的经典蓝、双层描边、密集工具栏和分组节奏为视觉母版，参考 QQ 2000–2010 的界面演变处理层级与窄屏退让。外置脚本只负责验证官方应用、注入样式和撤下样式；项目不创建第二套应用、假窗口、假导航或业务逻辑。

正式运行时没有后台服务、后端、数据库或独立账户系统。src/ 只是仓库内的开发预览，不进入受管运行时 release，也不替代 Codex。

Important

本项目不是腾讯或 OpenAI 的官方产品，也不包含从 QQ 客户端提取的原图、图标、提示音或其他专有资源。仓库中的正式主题资产均为原创或代码绘制。皮肤依赖 Codex Desktop 的内部 DOM，Codex 更新后可能需要同步适配。

能做什么

• 以原创 CSS 和资产重建 2006 年前后 QQ 的蓝色 chrome、双层描边、工具栏与分组氛围，同时让装饰层对指针事件透明。
• 保留现有 Codex 原生界面作为唯一交互层；为语义视觉分类，短暂检查候选原生控件（包括原生弹层内控件）的可访问名称、属性和最多 240 个字符的控件文本，以及页面标题和最多 6 个任务导航标签。数据不持久化、不上传，也不修改控件值。
• 正式运行时没有第三方依赖，只部署平台启动器、零依赖核心脚本、主题 CSS 和两个原创图片资产。
• Windows 与 macOS 启动器提供相同的 install / start / status / doctor / verify / restore / uninstall / purge 命令；当前证据边界仍按平台分别记录。
• 安装默认 --no-launch；不会在安装时关闭或重启你正在使用的 Codex。
• 只连接 127.0.0.1，拒绝远程 WebSocket、普通网页、DevTools 页和不符合 Codex 指纹的页面。
• 不修改 app.asar、WindowsApps、macOS .app 包、代码签名或系统完整性保护。

一句话交给 Codex 安装

把以下文字和仓库链接发给 Codex：

请阅读这个仓库的 INSTALL_WITH_CODEX.md，确认当前系统和官方 ChatGPT Desktop（Codex 视图）身份，
先执行 doctor 和安装 dry-run；结果通过后再执行 install --no-launch，最后 verify。
不要修改 app.asar 或应用签名，不要替我启动或重启 Codex。
仓库：https://github.com/rrrrrredy/Codex-skin

当前仓库是公开仓库，任何人都可以读取、审查和克隆。公开链接只解决源码获取，不会绕过目标电脑上的 doctor、dry-run、用户确认、应用身份校验或签名检查。

完整代理安装契约见 INSTALL_WITH_CODEX.md。

手动安装

先克隆仓库。以下命令部署受管 release、状态和启动器，但不启动 Codex，也不应用皮肤。

Windows 10/11

要求：Windows 10 17763+（x64/arm64）、Microsoft Store 版官方 ChatGPT Desktop（包身份 OpenAI.Codex，包含 Codex 视图）和 Windows PowerShell 5.1。运行时使用官方应用随附的可执行文件作为 Node，不要求全局安装 Node。版本号只记录“这版是否做过兼容性实测”：未知的新官方版本会显示 warning，但不会仅因版本号变化而拒绝；应用身份、Store 状态、包内可执行文件、回环 listener 和当前 Codex 页面仍是硬检查。

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 doctor
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 install --dry-run --no-launch
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 install --no-launch
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 verify

如果 doctor 报告 cdp_endpoint.state=untrusted，立即停止，不要自动终止、接管或复用占用该端口的进程。查明冲突后，经用户确认选择一个确实未被监听的高位 TCP 端口，用同一个 --port N 重新运行 doctor、install、start、status、restore 和 uninstall；只有新的 doctor 返回 ok=true 才能继续。

需要启用时：

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 start

macOS 14+

要求：macOS 14+，官方应用位于 /Applications 或 ~/Applications，bundle 名为 ChatGPT.app 或 Codex.app。安装器检查 Info.plist、bundle ID com.openai.codex、签名 Identifier、Team ID 2DC432GLL2、codesign --verify --deep --strict 和 Gatekeeper spctl，再使用 Info.plist 指定的可执行文件。如果两个候选同时存在，脚本会拒绝猜测并要求显式传入 --app-bundle PATH。未知版本会标记为未实测并给出 warning，不会取代这些身份与运行时硬检查。

./install.sh doctor
./install.sh install --dry-run --no-launch
./install.sh install --no-launch
./install.sh verify

如果 doctor 返回 app_ambiguous，确认要使用的官方应用后，在上述每条命令末尾添加例如 --app-bundle /Applications/ChatGPT.app；脚本仍会执行同一组签名、Team ID 与 Gatekeeper 硬检查。

如果 doctor 报告 cdp_endpoint.state=untrusted，同样必须停止，不得杀掉或复用未知 listener。经用户确认选定一个已验证空闲的高位 TCP 端口后，在后续生命周期命令中始终传入同一个 --port N。

需要启用时：

./install.sh start

恢复和卸载

restore 只移除当前页面的皮肤和后续导航 hook，不关闭或重启 Codex；现有本机 CDP listener 会保留到你正常退出该 Codex 进程。uninstall 先恢复，再移除启动器和受管引擎；purge 还会删除本项目管理的状态与日志，需要双重确认。

# Windows
.\install.ps1 status
.\install.ps1 restore
.\install.ps1 uninstall
.\install.ps1 purge --yes --confirm PURGE-CODEX-QQ-SKIN

# macOS
./install.sh status
./install.sh restore
./install.sh uninstall
./install.sh purge --yes --confirm PURGE-CODEX-QQ-SKIN

本地视觉预览

预览应用不会连接或修改 Codex，只适合开发时审查 synthetic 视觉合成与装饰层行为；它不是正式产品界面，也不能证明真实 Codex 兼容。

corepack enable
pnpm install --frozen-lockfile
pnpm dev

质量检查：

pnpm release:check

本仓库不依赖 GitHub Actions。发布检查在开发机器本地执行；实际安装时，目标电脑上的 Codex 仍必须依次运行 doctor、install --dry-run --no-launch、install --no-launch 和 verify，任一步硬检查失败即停止。这样验证的是目标电脑上的真实官方应用身份与安装结果，而不是云端 Runner 的模拟环境。

正式主题的双平台渲染夹具维护一份 75 项合成原生控件合同，覆盖导航、Composer、审批、附件、模型、代码、工具、Browser、Computer Use、当前能力入口和 Settings 代表项；每一项都必须真正触发可观察状态并保留点击/输入能力，而不只是“看得见”。该夹具仍是 synthetic 测试环境，不能代替真实 Codex 版本、账户能力和真实 macOS/Windows 窗口的最终 smoke test。当前证据、证据清单与未闭环边界见 本地验证记录。研究依据见 QQ 2000–2010 视觉谱系报告，安全边界见 SECURITY.md，实现结构见 docs/ARCHITECTURE.md。

当前兼容策略

外置注入比修改安装包更容易恢复，但它仍然依赖 Codex 视图的页面结构。Windows 26.715.4045.0 与 macOS 26.715.4045 只是自动化 fixture 使用的版本标记，不代表实机兼容，也不是启动授权名单。官方客户端升级后，doctor 会报告新版本尚未实测；start 仍必须重新验证官方身份、回环 CDP 进程、受约束的 app:///包内 file:// 文档、Codex 标题和唯一的 Codex DOM 锚点。任何真实硬检查失败都会停止，皮肤不会猜测注入。

v1.0.0 冻结的是源码、主题合同和双平台安装器接口，可作为稳定分发版本；它不包含真实目标机兼容认证。Windows 尚未在真实应用上完成 install→start→restore→uninstall/purge 闭环，macOS 也尚未在真实签名应用上验证 Gatekeeper、traffic lights 与完整生命周期，因此当前官方客户端仍应显示 version_certified=false，安装者必须逐机执行 doctor、dry-run 和运行时硬检查。这里的“稳定”不表示所有 Codex 版本或电脑已经实测兼容，完整证据边界见 本地验证记录。

License

代码和原创资产使用 MIT License。产品名称和商标归各自权利人所有。