统一主题家族 · 运行时编译 · 完整性
.cctheme 格式：一份统一主题家族，由客户端 Adapter 编译
了解 family.json、unified-theme.json、白名单素材、完整性校验，以及 CodeX、WorkBuddy、豆包与 Kimi 客户端路径中的运行时 Adapter 编译。
架构核验日期
归档必需根目录
family.json 标识主题家族与受支持契约；unified-theme.json 包含共享设计数据；assets/ 保存设计使用的已声明本地媒体。
这套架构取代旧模型：不再为每个用户主题包嵌入单独编译目标目录与准确客户端版本。
- family.json — 家族身份与契约
- unified-theme.json — 共享设计数据
- assets/ — 白名单声明媒体
- manifest 与 integrity — 文件清单与哈希
运行时 Adapter 编译
CC Theme App 先校验并导入主题包，再识别受支持客户端，让用户选择客户端卡片；选中的 Adapter 只编译自己支持的能力。
当前公开主题包目标使用对应 ChatGPT Desktop/CodeX 模式的 mac-codex，以及对应腾讯 WorkBuddy 的 mac-workbuddy。mac-doubao 属于验证路径；mac-kimi 在 Manager 注册与真实 QA 证据完整前属于实验适配。
- 主题家族 ID
- Adapter ID
- Adapter 能力版本
- 兼容矩阵中的准确客户端证据
会被拒绝的内容
主题归档是数据，不是任意应用代码。导入应拒绝路径穿越、绝对或未声明路径、脚本、原始 CSS、HTML、SVG、远程媒体 URL、不支持文件签名与完整性不一致。
- 不包含 JavaScript、Shell 或 PowerShell
- 不包含原始 CSS、HTML 或 SVG
- 不包含远程媒体 URL
- 主题中不包含可执行安装器
兼容性与完整性彼此独立
SHA-256 可以说明主题包是否匹配公开产物；兼容记录说明准确客户端 + Adapter + 主题组合是否通过。两者都不能只靠文件名推断。
- EVA WorkBuddy 已验证
- EVA CodeX 视觉验证未通过
- 不支持 Intel Mac 与 Windows
- App 软件信任单独评估
.cctheme 格式常见问题
一份主题包只对应一个准确应用版本吗？
不是。统一主题设计不保存真实宿主版本；运行时上下文提供 Adapter 能力与兼容证据。
同一主题包能为两个客户端编译吗？
可以，但两个 Adapter 都要支持声明能力，并且准确主题 × 目标组合必须通过验证。
这能保证像素完全一致吗？
不能。宿主表面不同；可复现是指同一主题包与编译输入可检查，不代表两个客户端渲染完全一致。
CC Theme App 在主题归档里吗？
不在。主题数据与 App/Adapter 软件属于不同信任边界。
能在网站导入主题包吗？
网站用于浏览主题与文档。请下载 CC Theme，并在统一 Mac App 中导入主题包。
架构与契约
统一架构文档与经过审查的契约是事实来源。