01 CODEX · DREAM SKIN

给 Codex 做一张
会呼吸的脸

不改官方一个字节：本机 CDP 注入 CSS/壁纸，原生控件照常点，氛围每天可换。

CDP 注入本地 Canvas 可逆恢复 codexskin

02 PAIN

每天八小时 · 灰色边框也会把人磨钝

8h

日陪 Codex

工具是效率
也是情绪场

15%+

专注时长

个性化环境
可抬持续投入

3

传统死路

改安装包
改 asar · 只改色

0

官方插件

无开放插件系
需要旁路扩展

传统做法

一更新就失效

改安装包 / asar → 升级覆盖
第三方主题只能改配色
氛围与背景动不了

Dream Skin

CDP 运行时注入

不碰官方文件与签名
可换全窗背景图
一键恢复原样

03 WHAT

Dream Skin = 外部主题注入引擎

四条硬边界

不改官方文件：不动 .app / asar / WindowsApps
本机回环 CDP：只绑 127.0.0.1
装饰不抢事件：pointer-events: none
本地图像分析：Canvas 估亮度/主色/焦点

一句话本质

不是替换 Codex UI，而是在窗口后面贴一张会呼吸的壁纸——侧栏、输入框、新建对话全部还活着。

theme.json

→

引擎启动

→

CDP 注入

→

CSS + 壁纸

→

正常写码

04 CONTRACT

theme.json · 调色盘的核心契约

{
  "appearance": "auto",
  "art": {
    "focusX": 0.72,
    "focusY": 0.45,
    "safeArea": "left",
    "taskMode": "ambient"
  }
}

APPEARANCE

auto

跟随系统亮暗，文字可读性自适应

FOCUS

0.72 / 0.45

控制背景定位，主体落在右侧

SAFE AREA

left

左侧留白给原生内容区

TASK MODE

ambient

任务页降低干扰，专注对话

05 WHY

换肤不只好看 · 三项非功能收益

品牌归属

团队 Logo 配色进主题；新人第一天就知道这是谁的战场。

疲劳管理

换一张背景 ≈ 换一间办公室；对抗灰色侧栏的惯性钝化。

DX 溢价

工具既是效率也是情绪；愿用 → 多用 → 更高产出。

工具终将同质化，氛围是你的

审美不是附属品——它直接关联持续投入。

06 ARCHITECTURE

一张图看懂 · 用户 → 引擎 → CDP → 皮肤

07 INSTALL

五分钟穿上新衣 · Win / macOS

Windows

git clone .../Codex-Dream-Skin
cd windows
# 安装引擎（一次）
scripts\install-dream-skin.ps1
# 启动皮肤
scripts\start-dream-skin.ps1

托盘：换背景 · 切主题 · 暂停/恢复

macOS

cd macos
./scripts/install-dream-skin-macos.sh \
  --no-launch
# 切预设主题
switch-theme-macos.sh \
  --id preset-arina-hashimoto

也可双击 Install .command 一键装

恢复：restore-dream-skin.ps1 / Restore.command

GitHub：Fei-Away/Codex-Dream-Skin

08 HANDS-ON

自制主题三步 · 图 + 契约 + 验证

01

生图 2560×1440

纯壁纸、无文字 UI。左侧 0–52% 低信息，右侧 62–88% 放主体。

02

写 theme.json

id 与目录一致；image 文件名；focus / safeArea / taskMode 配齐。

03

导入并验收

首页连续壁纸；控件可点；任务页降干扰；明暗可读。

检查项	通过标准
首页	16:9 壁纸连续，无撕裂
交互	项目选择器 / 输入框 / 新建对话可点
任务页	ambient 降干扰，文字仍清晰

09 INSIGHT 1

CDP 注入 · 被低估的扩展范式

没有官方插件时，旁路扩展仍可安全。

不改二进制 · 不碰签名 · 不走网络——边界比“黑改安装包”清晰一个量级。

不改官方文件

无更新覆盖风险

按需加载

轻量，用完可停

本机安全

127.0.0.1 网络隔离

10 INSIGHT 2-3

本地分析隐私 · 审美即竞争力

图像分析留本机

Canvas 估亮度 / 主色 / 焦点
像素不出机器，无外传 API
企业敏感场景照片也可当壁纸

DX → 产出闭环

开发者体验抬情绪投入
情绪投入抬持续使用
持续使用抬真实产出

DX

→

情绪

→

持续投入

→

更高产出

11 PLAYBOOK

方法论速查 · 六步闭环

步骤	动作	核心要点
1	生图	2560×1440 纯背景，左侧留白 ≥50%
2	配置	theme.json：id=目录名，image=文件名
3	安装	Win .ps1 / macOS .command，引擎装一次
4	切换	托盘 / 菜单栏多主题快切
5	验证	首页+任务页；控件可点；明暗可读
6	恢复	restore 脚本，一秒回官方

安全模型

CDP + 本地分析

图像即主题

一张好图 + 契约

可逆可恢复

无后遗症

12 CTA

立刻动手 · 给工作日换一张心情

打开 Fei-Away/Codex-Dream-Skin

按平台跑安装脚本

生成一张 2560×1440 纯背景

导入保存主题并验收控件

别再盯着灰色侧栏过八小时

codexskin · 基于《AI IDE 换肤全指南》· md2ppthtml

给 Codex 做一张会呼吸的脸