用途：指导从零开发 MusicFree 桌面版主题包。主题包本质是 CSS Custom Properties 覆盖层，应用内置约 150+ 默认暗色变量，主题通过 index.css 的 :root {} 选择性覆盖实现换肤，未覆盖变量继承默认值。
主要能力：覆盖需求采集、风格定调、调色板生成、CSS 变量映射、增强层（背景渐变、阴影调整、自定义图片、iframe 动态背景）、打包测试、迭代优化与提交主题市场。变量分必须覆盖、建议覆盖、禁止覆盖（z-index、排版、间距、布局、控件尺寸、图标尺寸、动效等结构性 token）三级；浅色主题须覆盖全部 Background/Fill/Text/Border 类变量。
使用方式：按流程与用户确认方案后生成 index.css 与 config.json，打包为 .mftheme（ZIP 改扩展名），在 MusicFree 桌面版「主题」页安装测试。提交市场需 Fork MusicFreeThemePacks，基于 v1/source 建分支，在 themes/ 下建文件夹，补充 tags，运行 npm install 与 npm run validate:theme your-theme-name 后提 PR。
限制：AI 无法预览渲染效果，需用户反馈迭代；单图 ≤500 KB，单视频 ≤5 MB，主题包 ≤10 MB；@/ 为路径别名，运行时替换为绝对路径；id 字段由系统管理，勿手动添加。具体收费与价格暂未提供。