四种方式，塑造不同氛围
Codex 背景：用图片、视频、水波与动态画面营造氛围
为工作空间选择合适的 CC Theme 背景，从安静图片和氛围 MP4，到响应式水波与方向 WebP 画面。
核验日期
静态图片背景
适合安静、低耗电、回退最稳定的个性化。选择本地 PNG、JPEG 或 WebP，在 Studio 调整位置，并在任务、终端、Diff 与设置预览中检查文字可读性。
- 本地图片上限 16 MiB
- 不接受远程 URL
- 可作为水波与已配置视频的静态兜底
MP4 视频背景
适合短小、克制的氛围循环。当前已验证 Codex 与 WorkBuddy macOS 目标接受不超过 256 MiB 的 MP4；较小、码率较低的循环可以降低启动、解码和耗电成本。
- 视频可选且按目标打包
- 不能与水波或方向模式组合
- 应保留可读遮罩与静态兜底
水波背景
适合让一张图片对指针短暂响应。效果在交互时唤醒，水波能量衰减后停止，不会一直占用连续渲染。
- 需要一张本地背景图
- 支持白名单强度、半径、质量和遮罩参数
- 减少动态效果会关闭水波并保留静态图
方向 WebP 图集
适合已经准备多角度画面的素材。上传一张完成的静态 WebP 图集，Studio 根据声明的网格、原点与首方向角度，从指针方向选择帧。
- 支持 8、16 或 32 帧
- 列数 × 行数必须等于帧数且能整除
- 上限 32 MiB、3200 万像素、单边 16384 像素
- 减少动态效果固定到 idle 帧；CC Theme 不自动生成素材
Codex 背景常见问题
应该选择哪种背景模式？
追求简单选图片，需要轻量循环选 MP4，需要单图短暂交互选水波，已经有多帧 WebP 图集时再选方向模式。
水波和视频能组合吗？
不能。媒体、水波与方向互斥，让导出包和适配器始终只有一个权威行为。
动态背景会影响耗电吗？
可能。视频解码和交互渲染成本高于静态图片，应使用短小压缩素材、合理预览质量与减少动态效果回退。
CC Theme 会自动生成 16 或 32 个方向画面吗？
不会。用户需要提供完成的静态 WebP 图集，编辑器负责校验与预览。
这些模式在 WorkBuddy 中可用吗？
已验证的 WorkBuddy 5.2.6 macOS 适配器可以使用；客户端更新后仍应重新检查兼容矩阵。