MusicFree 桌面版主题包开发

核心认知

MusicFree 主题包的本质是 CSS Custom Properties 覆盖层。

应用内置一套默认暗色主题（定义在 global.scss 的 :root 中，约 150+ CSS 变量），主题包通过 index.css 中的 :root {} 选择性覆盖这些变量来实现换肤。未覆盖的变量自动继承默认暗色值。

行为准则

以下规则在整个主题开发过程中始终生效：

1. 视觉产物无法预览：AI 无法看到主题的实际渲染效果，因此每一步重要决策都必须与用户确认，不要自行判断"好看"
2. 先确认再动手：调色板、变量覆盖范围、背景风格等关键决策，必须描述清楚并获得用户同意后再生成代码
3. 解释技术术语：用户可能是零基础社区贡献者，所有专业概念必须用通俗语言解释
4. 最小覆盖原则：只覆盖需要改变的 CSS 变量，不要为了"完整性"覆盖所有变量
5. 浅色主题例外：浅色主题必须覆盖全部 Background / Fill / Text / Border 类变量，否则会出现暗色残留
6. 资源体积优先：图片必须压缩（推荐 WebP），避免不必要的大文件