这个目录放 Codex Dream Skin 的内置预设主题。安装时 install-dream-skin-macos.sh 会把每个 preset-*/ 幂等地播种到用户主题库 ~/Library/Application Support/CodexDreamSkinStudio/themes/，装完即可在**菜单栏「已保存的主题」**或 switch-theme-macos.sh --id <id> 里直接切换。
This folder holds the bundled preset themes. Install seeds each
preset-*/into the user theme library, so a fresh install ships with ready-to-use skins.
当前内置 preset-gothic-void-crusade/（Gothic Void Crusade）与
preset-arina-hashimoto/（桥本有菜 / Arina Hashimoto）两套实机验证主题。
前者是社区作者提供的原创哥特科幻背景；后者使用一张
2560 × 1440（16:9）纯背景：左侧低信息留白承载 Codex 原生标题，人物和花卉主视觉集中在右侧。浅色与暗色截图均来自真实 Codex 注入，不是 AI 绘制的整窗 UI。
来源尺寸必须如实区分：归档的用户源图（不随 preset 播种）是 1672 × 941 PNG；preset 内的 background.jpg 保持其近 16:9 构图，标准化导出为 2560 × 1440 JPEG，并不代表补回或新增了源图细节。派生文件使用 sips -z 1440 2560 -s format jpeg -s formatOptions 90 生成。
- 可导入/可播种的主题素材只有
background.jpg与theme.json。 - 用户提供的 byte-identical 源 PNG 单独归档在
docs/images/presets/arina-hashimoto-source.png，不放进 preset pack，因此不会被安装脚本播种为多余文件。 - 当前浅色、暗色实测文档截图均为
2308 × 1572Retina JPEG（CSS viewport1154 × 786），来自同一真实 Codex 首页；为保护未发送草稿，截图时仅用临时本地样式隐藏输入文字并收起编辑区，没有修改草稿内容或伪造皮肤效果。它们包含真实侧栏、项目工具栏和输入框，只作预览，绝不能当背景导入。 - 背景是用户提供的 AI 生成示例，不代表 OpenAI/Codex 官方视觉或背书；公开分发前仍需确认人物、模型输出与素材使用权。
- 该维护者提供的精选预设是单独记录的发行例外，不纳入 MIT 软件许可；文件清单和限制见
../NOTICE.md。这不表示以后可以提交其他可识别真人素材。
安装后可直接切换：
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
--id preset-arina-hashimotopreset-<slug>/
├── theme.json # schemaVersion 1，与 assets/theme.json 同一格式
└── background.jpg # 背景图（横向，JPEG）
- 目录名与
theme.json的id必须都是preset-<slug>形式（slug用小写英文 + 连字符）。播种只管理preset-*，绝不会碰用户自己「换一张图」保存的custom-*主题。 image字段只能是本目录内的文件名（不能是路径），格式png/jpg/jpeg/webp，≤ 10 MB（建议 < 1 MB）。appearance必须如实声明背景图成立的模式（这是规范，不是可选项）："auto"——仅限浅色、暗色外壳下都协调的图，且两种模式都实测过。皮肤跟随 Codex 客户端的浅暗设置切换外壳。"dark"/"light"——单模专属图（如深色大教堂、纯白极简）。皮肤外壳固定为该模式，不随客户端切换。- 暗色专属画作声明
auto是缺陷不是偏好：客户端处于浅色时，Codex 原生组件（差异卡片、任务条等）按浅色渲染，会与暗图直接打架（#134 曾因此返修）。拿不准就按图的实际明暗写死，不要照抄模板默认值。
- 人物/场景背景优先提交
2560 × 1440（16:9）母版；主视觉放在右侧约 58%～88%，左侧约 50%～58% 保持低信息、低对比。禁止把效果截图、窗口 mockup 或任何带 UI 的图片命名为background.*。
以 preset-gothic-void-crusade/theme.json 为参考模板。除标注「可选」外均建议如实填写；文案留空会退回内置默认值，不会报错但会显得敷衍。
| 字段 | 显示位置 |
|---|---|
name |
首页标题上方的主题名眉标（强调色小字） |
tagline |
首页标题下方一行副标语 |
quote |
首页右下角手写体口号（斜排，随强调色） |
brandSubtitle / statusText |
皮肤 chrome 的品牌角标与状态文案（部分布局下隐藏） |
projectPrefix / projectLabel |
「选择项目」按钮的前缀与占位文案 |
promoTitle / promoSub / promoUrl |
分享/宣传场景使用，可选 |
所有键都会被注入为主题变量，整套皮肤 UI 跟着走：
| 键 | 用途 |
|---|---|
background |
整窗兜底底色（背景图未盖住的区域、body 底） |
panel / panelAlt |
半透明面板底：侧栏、卡片、composer、右侧工具面板的毛玻璃都从它调透明度 |
accent / accentAlt |
强调色：建议卡圆圈与图标、主题名眉标、口号、状态点、聚焦描边 |
secondary / highlight |
次强调/高亮（粒子、渐变、hover 等点缀） |
text |
正文字色（标题、卡片文字都强制跟随） |
muted |
次要文字与大多数描边（卡片/面板边框按它调透明度） |
line |
分隔线与细描边 |
- 颜色必须与背景图协调：
accent建议直接从画面主体取色（Gothic 取的是烛金#c8a55a）。 - 声明
appearance: dark的主题请给暗底亮字；light反之；auto主题两种模式都要自查对比度。
art.focusX / art.focusY（0..1，画面主体位置）、art.safeArea（auto | left | right | center | none，低信息留白侧）、art.taskMode（auto | ambient | banner | full | off，任务页呈现）。显式值优先于引擎自动分析；拿不准可先不填，实测后补。
内置预设会随仓库分发，不是「个人本地示意」。为避免把维护者和使用者拖进法律风险，只接受：
- ✅ 原创或你拥有授权的图像；
- ✅ 明确 CC0 / 公有领域 / 允许再分发的素材；
- ✅ 纯程序化生成的抽象 / 渐变 / 几何背景。
- ✅ 原创虚构的成年人物形象，且能说明生成/授权来源、没有模仿可识别真人。
除非维护者事先完成独立权利审核并在 NOTICE.md 逐项记录，否则不接受（PR 会被拒绝）：
- ❌ 真人肖像（明星、网红、AV 演员等）——涉肖像权，且本仓库带 MIT 与商业赞助；
- ❌ 受版权保护的动漫 / 游戏 / 影视角色与截图；
- ❌ 任何你无权再分发的第三方素材。
提交预设即视为你声明：对该素材拥有分发与再授权的权利。
没有 mac 或想用自制原图，也可以直接放 preset-<slug>/background.jpg + 手写 theme.json（照抄任一现有预设改配色即可）。
生成纯背景前建议直接使用 docs/reference-background-prompt-guide.md 的 16:9 通用模板、浅/暗兼容约束和负面词；八种概念图的逐张拆解另见 docs/background-generation-prompts.md。
# 单独校验一套预设是否是合法可注入的主题包
node macos/scripts/injector.mjs --check-payload --theme-dir macos/presets/preset-<slug>/
# 跑完整测试（含预设合法性 + 播种幂等）
cd macos && npm testtheme.json 字段含义见 ../assets/theme.json 与 scripts/write-theme.mjs；colors 十个键请与背景图协调（accent / secondary / highlight 会体现在原生控件的强调色上）。
脚本自检通过后，请在实机至少过一遍以下路由（PR 里附截图）：
- 首页：主题名眉标、标题、tagline、右下口号、四张建议卡（图标应在圆圈正中）；
- 输入框聚焦后的建议下拉（应为紧凑行，不是大空卡）；
- Pull Requests 页与「Toggle side panel」打开的 Review · Terminal · Browser · Files 侧面板（应为毛玻璃，不是原生黑底）；
- 任务页（按
taskMode检查横幅/环境模式）； appearance: auto的主题需浅、暗两种外壳各跑一遍上述路由。