feat(theme): S5 学院蓝主题改造（管理端）——homeLayout编辑器/主题参数表单/站点设置/类型 + 单测

src/types/cms.ts

@@ -227,4 +227,46 @@ export interface LinkVo {
     status: number;
 }
 
+/* ===== 皮肤包（ThemeVo，S1 交接契约：参数值为包级）===== */
+
+/** select 型参数的候选项 */
+export interface ThemeParamOption {
+    value: string;
+    label: string;
+}
+
+/** 参数 schema 项（后端 ThemeVo.ThemeParamVo）：schema 只来自包内 theme.json */
+export interface ThemeParamVo {
+    key: string;
+    /** color 型才有，CSS 变量名（如 --primary） */
+    cssVar?: string;
+    label: string;
+    /** color | select | image | text */
+    type: string;
+    /** 包内默认值：前端「已修改」标记与恢复默认的基准 */
+    defaultValue?: string;
+    options?: ThemeParamOption[];
+}
+
+/** 皮肤包（GET/PUT /api/theme/**） */
+export interface ThemeVo {
+    /** 标识名 = 主题路径段，创建后不可改 */
+    name: string;
+    title: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    bannerSize?: string;
+    /** 预览图（管理端资产代理 /api/theme/{name}/asset/screenshot.png） */
+    screenshotUrl?: string;
+    params: ThemeParamVo[];
+    /** 包级参数值（工作项 T）：只含被微调过的 key，存 themes/.meta/{name}.json；缺项按 defaultValue 回落 */
+    paramValues?: Record<string, string>;
+    /** builtin=内置（模板/资产只读）/ external=外部可管 */
+    source?: string;
+    inUseCount?: number;
+    editable?: boolean;
+    usedBySiteNames?: string[];
+}
+
 /* ===== 事项库（svc，事项库详细设计 §7.4）===== */