Codex Dream Skin · JARVIS 装甲研发工作台

中文 · English

把 Codex 桌面端改造成一套会呼吸、会扫描、会反馈状态的钢铁侠全息研发工作台。

这是基于 Fei-Away/Codex-Dream-Skin 的二次设计版本。保留原项目的本机 CDP 注入、主题恢复和安全边界，在此基础上新增 JARVIS 视觉系统、动态按键映射、全息投影、真实用量能量条和一键皮肤开关。

这不是一张静态皮肤图

侧栏、项目列表、任务内容、输入框和按钮仍然是 Codex 原生控件。主题只在运行时增加视觉层和 少量无障碍装饰节点，不修改 WindowsApps、app.asar 或官方代码签名。

我们重新设计了哪些元素

Codex 原生元素	JARVIS 映射	动态与交互
顶部区域	装甲皮肤 ON/OFF 开关	记住用户选择；开启时恢复整套装甲皮肤，关闭时回到 Codex 原生白色界面，无需重启
全窗口背景	高清钢铁侠装甲研发场景	按图片焦点、安全区和窗口宽度自适应；首页突出主视觉，任务页自动降低干扰
发送箭头	方舟反应堆	待机呼吸、可发送时充能旋转，保留原按钮语义和点击功能
停止按钮	高速方舟反应堆	任务运行时内外环反向旋转并提高呼吸频率，仍然执行原生“停止”操作
麦克风 / 听写按钮	钢铁侠头盔轮廓	使用定制 SVG 轮廓；悬停、按下和听写激活时有亮度与缩放反馈
输入区域	JARVIS 命令舱	玻璃面板、青色光边与仅位于输入框内部的扫描线；运行时扫描节奏加快
右下角空白区	钢铁侠全息投影	人物轻微 3D 转动、闪烁、纵向扫描，底座光环持续旋转；不拦截鼠标
原生用量数据	剩余用量能量条	读取 Codex 当前 rate-limit 数据，约每 2 秒刷新；低余量自动变为黄色/红色
原生上下文数据	背景信息能量条	显示当前上下文占用百分比；高占用自动预警
消息与任务区	全息工程面板	原生消息卡片、代码内容和交互仍可用，增加分层描边、玻璃和状态光效

全息投影与实时能量条

• 剩余用量优先读取 Codex 已加载的原生查询数据，并可回退到原生菜单显示值。
• 背景信息读取 Codex 暴露的上下文用量标签。
• 不保存或伪造历史百分比；数据暂时不可用时显示 --%。
• 能量条带扫光、平滑过渡和 nominal / warning / critical 三档状态色。

输入框控制映射

• 蓝色钢铁侠头盔轮廓对应原生麦克风/听写功能。
• 圆形方舟反应堆对应发送键；生成期间同一位置切换为动态停止反应堆。
• 所有映射只改变视觉，不替换按钮事件、快捷键、焦点或无障碍名称。

自适应与可用性

• 宽屏时全息投影位于右下角/右侧安全区，并自动避开首页输入框。
• 窗口收窄时投影缩小和降低透明度；低于 900px 时自动隐藏，优先保证输入区可用。
• 首页和任务页使用不同的背景遮罩、面板密度与可读性策略。
• 装饰层全部使用 pointer-events: none，不会挡住原生点击。
• 支持 prefers-reduced-motion；系统要求减少动画时会关闭大部分旋转与扫描。
• 顶部开关在皮肤关闭时仍然可见，随时可以重新开启。

Windows 安装

环境要求

• Windows 10 / 11 x64。
• 已从 Microsoft Store 安装并至少启动过一次官方 Codex 桌面应用。
• Windows PowerShell 5.1 或更高版本。
• 从源码安装时需要 Node.js 22 或更高版本。

从源码安装

先完全退出 Codex，再打开 PowerShell：

git clone https://github.com/SpiderXin68/Codex-Dream-Skin.git
cd Codex-Dream-Skin
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned `
  -File .\windows\scripts\install-dream-skin.ps1

安装完成后会创建三个快捷方式：

• Codex Dream Skin：以皮肤模式启动或重新应用。
• Codex Dream Skin - Tray：打开托盘主题控制。
• Codex Dream Skin - Restore：恢复官方界面。

首次启动推荐双击 Codex Dream Skin。如果 Codex 已经打开，启动器会要求确认重启。 随后在托盘菜单勾选 随 Codex 启动自动应用。启用后，Dream Skin 会随 Windows 登录在后台 启动；以后直接点官方 Codex 图标也会自动恢复注入环境和顶部皮肤开关。

命令行启动与验证

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned `
  -File .\windows\scripts\start-dream-skin.ps1 -PromptRestart

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned `
  -File .\windows\scripts\verify-dream-skin.ps1 `
  -ScreenshotPath "$env:TEMP\codex-dream-skin.png"

验证会检查：

• CDP 只监听 127.0.0.1，并确认端口属于官方 Codex 包。
• 皮肤运行时、顶部开关、原生侧栏和输入框是否存在。
• 装饰层是否会拦截交互。
• 当前页面的主题结构和注入状态是否正确。

日常使用

1. 首次运行 Codex Dream Skin - Tray，在托盘菜单勾选 随 Codex 启动自动应用。
2. 以后可以直接从官方 Codex 图标启动；监测器会自动恢复皮肤和顶部开关。
3. 使用窗口顶部的 装甲皮肤 ON/OFF 即时切换。
4. 关闭时进入 Codex 原生白色界面；再次开启会恢复背景、全息投影、能量条和按键映射。
5. 需要换背景或管理已保存主题时，打开 Codex Dream Skin - Tray。

开关只在本地保存一个布尔偏好，不会保存聊天内容、用量数据或账号信息。 由于 Chromium 的本机调试端口只能在进程启动时开启，通过官方图标启动的普通 Codex 会被监测器 快速重启一次；这是恢复注入所必需的，之后无需手动操作。取消托盘勾选即可关闭自动应用。

更新、恢复与卸载

更新源码后，先退出托盘和 Codex，再重新运行安装命令。活动主题、保存的主题与图片不会被删除。

恢复官方外观：

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned `
  -File .\windows\scripts\restore-dream-skin.ps1 `
  -RestoreBaseTheme -PromptRestart

同时移除 Dream Skin 快捷方式：

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned `
  -File .\windows\scripts\restore-dream-skin.ps1 `
  -RestoreBaseTheme -PromptRestart -Uninstall

设计与源码位置

内容	路径
JARVIS 主背景	windows/assets/arc-reactor-armor.png
钢铁侠全息投影	windows/assets/iron-man-hologram.png
麦克风头盔 SVG 源文件	windows/assets/iron-man-helmet.svg
主题配置	windows/assets/theme.json
统一视觉样式	runtime/dream-skin.css
开关、用量与投影逻辑	runtime/renderer-inject.js
Windows 注入器	windows/scripts/injector.mjs
Windows 详细文档	windows/README.md

runtime/ 是两端共用的规范源；同步脚本会生成 Windows 与 macOS 对应资源，避免两份运行时漂移。

开发与测试

# 同步统一运行时到两个平台
.\windows\runtime\node\node.exe .\tools\sync-runtime-assets.mjs

# Windows 配置事务、注入、安装器与运行时测试
$env:PATH = (Resolve-Path .\windows\runtime\node).Path + ";" + $env:PATH
.\windows\tests\run-tests.ps1

# 单独检查 macOS 渲染器运行时
.\windows\runtime\node\node.exe .\macos\tests\renderer-inject.test.mjs

本仓库不会提交本机 windows/runtime/、调试截图、日志或桌面快捷方式。

安全边界

• 只使用本机回环 CDP，不开放远程监听。
• 不修改官方 Codex 安装目录、二进制、app.asar 或代码签名。
• 不读取或改写 API Key、Base URL、模型供应商配置。
• 外观配置修改采用 UTF-8 原子事务，并保留安装前备份用于恢复。
• Codex 更新可能改变页面结构；升级后建议重新运行安装器和验证脚本。

致谢、许可与声明

• 上游项目：Fei-Away/Codex-Dream-Skin。
• 原项目与代码许可见 macos/LICENSE（MIT）及 macos/NOTICE.md。
• 本项目是非官方、非商业的界面主题实验，与 OpenAI、Marvel 或 Disney 无隶属或背书关系。
• Codex、Iron Man、JARVIS 及相关名称、角色和商标归各自权利人所有。
• 仓库中的钢铁侠背景与预览图仅作主题研究、学习和展示；公开再分发或商业使用前请自行确认素材与商标权利。