fix(ci): 构建容器名唯一化 + npm 走国内镜像源（避免并发互踩 exit 137）

- 删自写 svcitem/config/OpenApiAuthEnforceConfiguration（yh-app-auth starter 版
  RequireAppSignFilter 承接，order+11 行为等价；/oapi/site/list 面无签名即 401）
- yh.app-auth.server.enforce-patterns=[/oapi/*] + trust-registry=true（中央密钥链组合：
  trusted-apps 100018 先、Redis sign:app:* 链后，Notice/flow-center 同款）
- data-redis 自 test scope 提升编译期（yh-app-auth 侧 optional 不传递，生产 classpath
  此前并无该依赖）；management.health.redis.enabled=false 防 Redis 抖动拉 DOWN 健康
- 测试 yml 同步 enforce-patterns：删自写副本后 SiteOapiIT 的 /oapi/** 401 断言由
  starter 过滤器承接；trust-registry 不进测试配置（IT 密封性，签名用例 100018 走
  trusted-apps 命中）

门禁：mvn test -Dskip.tests=false 413/413 绿（含 SiteOapiIT 6/6，本机 MySQL8+Redis）

.gitea/workflows/build.yml

@@ -25,7 +25,10 @@ jobs:
       options: --network infra-infra-net
     steps:
       - name: 安装 git / curl（alpine）
-        run: apk add --no-cache git curl
+        run: |
+          # 统一走 aliyun 源：dl-cdn 时段性被拦会卡满 60s×2（2026-10-20 事故）
+          sed -i 's#dl-cdn.alpinelinux.org#mirrors.aliyun.com#g' /etc/apk/repositories
+          apk add --no-cache git curl
 
       # 内网 Gitea 无法访问 GitHub 拉 actions/checkout，手动 clone 本仓库
       - name: 拉取源码（内网无 GitHub，手动 clone 本仓库）
@@ -55,18 +58,24 @@ jobs:
       - name: 构建 jar（maven 容器，复用宿主 m2 缓存）
         run: |
           set -e
-          docker rm -f mavenbuild 2>/dev/null || true
-          docker run -d --name mavenbuild \
+          # 构建容器名必须全局唯一：runner 挂的是宿主 docker.sock，容器名在整个 daemon 上共享
+          # 命名空间。固定名会在多仓/多条 workflow 并发时互相 docker rm -f 掉对方正在构建的
+          # 容器，表现为无编译报错的 exit 137（SIGKILL，2026-10-21 实测复现）。
+          # GITHUB_RUN_ID 实例级唯一，再拼时间戳兜底。
+          BUILD_CONTAINER="mavenbuild-${GITHUB_RUN_ID:-0}-$(date +%s)"
+          echo "BUILD_CONTAINER=${BUILD_CONTAINER}"
+          docker rm -f "$BUILD_CONTAINER" 2>/dev/null || true
+          docker run -d --name "$BUILD_CONTAINER" \
             --network infra-infra-net \
             -v /opt/docker/projman-m2:/root/.m2 \
             -w /build maven:3.6.3-jdk-8 sleep 3600
-          docker cp "${PWD}/." mavenbuild:/build/
-          docker exec mavenbuild sh -c "printf '%s' '<settings><profiles><profile><id>nexus-repo</id><repositories><repository><id>nexus-internal</id><url>http://nexus:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots></repository></repositories></profile></profiles><activeProfiles><activeProfile>nexus-repo</activeProfile></activeProfiles></settings>' > /root/.m2/settings.xml"
-          docker exec mavenbuild sh -c 'cd /build && mvn -B -DskipTests clean package'
-          docker exec mavenbuild sh -c 'cd /build/target && cp *.jar app.jar'
+          docker cp "${PWD}/." "$BUILD_CONTAINER":/build/
+          docker exec "$BUILD_CONTAINER" sh -c "printf '%s' '<settings><profiles><profile><id>nexus-repo</id><repositories><repository><id>nexus-internal</id><url>http://nexus:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots></repository></repositories></profile></profiles><activeProfiles><activeProfile>nexus-repo</activeProfile></activeProfiles></settings>' > /root/.m2/settings.xml"
+          docker exec "$BUILD_CONTAINER" sh -c 'cd /build && mvn -B -DskipTests clean package'
+          docker exec "$BUILD_CONTAINER" sh -c 'cd /build/target && cp *.jar app.jar'
           mkdir -p "${PWD}/target"
-          docker cp mavenbuild:/build/target/app.jar "${PWD}/target/app.jar"
-          docker rm -f mavenbuild
+          docker cp "$BUILD_CONTAINER":/build/target/app.jar "${PWD}/target/app.jar"
+          docker rm -f "$BUILD_CONTAINER"
 
       - name: 构建并推送镜像
         run: |

pom.xml

@@ -103,11 +103,14 @@
             <artifactId>spring-boot-starter-test</artifactId>
             <scope>test</scope>
         </dependency>
-        <!-- 单测专用：验证方案 §12「缓存切 Redis 仅改配置」的演进承诺（生产仍为 Caffeine，零影响） -->
+        <!-- 入站验签走中央密钥链（注册表模式 yh.app-auth.trust-registry）必须编译期引入 data-redis：
+             yh-app-auth 的该依赖是 optional、不传递（Notice/flow-center/svc-hall 同款，2026-10-05 自
+             test scope 提升）。副作用是 RedisHealthIndicator 会被装配，故 yml 里关掉
+             management.health.redis.enabled，防 Redis 抖动把 /actuator/health 拉成 DOWN(503)。
+             RedisCacheEvolutionIT（缓存演进验证）继续复用本依赖。 -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-data-redis</artifactId>
-            <scope>test</scope>
         </dependency>
     </dependencies>
 

sql/edge_seed_visual.sql

@@ -21,9 +21,10 @@ WHERE code = 'demo';
 UPDATE cms_banner SET status = 0 WHERE id = 5;
 
 -- 2) 院系子站（demo 的子站：header 出"专业院系"下拉；不配 public_base_url=按请求派生）
+--    主题应用：jdx→academic-navy（学府藏蓝）、xxgc→campus-azure（青蓝校园）——两套高校官网风皮肤随种子落地可视验收
 INSERT INTO cms_site (id, code, parent_site_id, sch_id, sch_name, name, theme, config_json, status, create_by, create_time) VALUES
-(6, 'jdx', 1, 990001, '云海大学', '机电学院', 'default', '{"copyright": "机电学院"}', 1, 'cmssuper', NOW()),
-(7, 'xxgc', 1, 990001, '云海大学', '信息工程学院', 'default', '{"copyright": "信息工程学院"}', 1, 'cmssuper', NOW());
+(6, 'jdx', 1, 990001, '云海大学', '机电学院', 'academic-navy', '{"copyright": "机电学院"}', 1, 'cmssuper', NOW()),
+(7, 'xxgc', 1, 990001, '云海大学', '信息工程学院', 'campus-azure', '{"copyright": "信息工程学院"}', 1, 'cmssuper', NOW());
 INSERT INTO cms_category (id, site_id, parent_id, name, type, link_url, content, sort_no, status, create_by, create_time) VALUES
 (61, 6, 0, '学院概况', 2, NULL, '<p>机电学院（视觉精修种子）。</p>', 1, 1, 'cmssuper', NOW()),
 (62, 6, 0, '学院新闻', 1, NULL, NULL, 2, 1, 'cmssuper', NOW()),

sql/upgrade_theme_academic_skins.sql

@@ -0,0 +1,21 @@
+-- ============================================================
+-- 皮肤升级脚本：粉/紫两包下线 → 高校官网风两包接管（幂等，存量库执行一次即可）
+-- 背景：cherry-bloom（樱语粉韵）/ violet-iris（鸢尾紫韵）不符合高校门户视觉，已从模板库删除；
+--       存量站点若仍指向这两个主题，ThemeRegistry 匹配不到会静默回落 default（皮肤全丢），
+--       故必须把 theme 列改到新包：academic-navy（学府藏蓝）/ campus-azure（青蓝校园）。
+-- 目标库：存量 bsch_cms（生产/预发）；干净环境无需本脚本
+-- 顺序：备份查询 → 回填 → 校验
+-- ============================================================
+
+-- 1) 先看受影响站点（人工确认后再执行第 2 步）
+SELECT id, path, name, theme FROM cms_site WHERE theme IN ('cherry-bloom', 'violet-iris');
+
+-- 2) 回填：粉韵→学府藏蓝，紫韵→青蓝校园（仅命中旧值，重复执行无副作用）
+UPDATE cms_site SET theme = 'academic-navy' WHERE theme = 'cherry-bloom';
+UPDATE cms_site SET theme = 'campus-azure' WHERE theme = 'violet-iris';
+
+-- 3) 校验（应返回 0 行）
+SELECT id, path, theme FROM cms_site WHERE theme IN ('cherry-bloom', 'violet-iris');
+
+-- 备注：站点快照走 Caffeine CacheNames.SITE，TTL 30 分钟（±60s 抖动，见 CacheConfig），
+--       实测改库后 400s 门户仍是旧皮肤——改库后请重启服务，或在管理端重新保存一次站点（换肤会主动清缓存）。

src/main/java/com/yunhai/cms/controller/api/PersonController.java

@@ -0,0 +1,43 @@
+package com.yunhai.cms.controller.api;
+
+import com.yunhai.cms.model.dto.DeleteRequest;
+import com.yunhai.cms.model.dto.PersonSaveRequest;
+import com.yunhai.cms.model.vo.PersonVo;
+import com.yunhai.cms.service.impl.PersonService;
+import com.yunhai.platform.utils.model.BoaUser;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.validation.Valid;
+import java.util.List;
+
+/**
+ * 名师风采人物管理（docs/20 D-7，people 区块数据源）。
+ */
+@RestController
+@RequestMapping("/api/person")
+@RequiredArgsConstructor
+public class PersonController {
+
+    private final PersonService personService;
+
+    @GetMapping("/list")
+    public List<PersonVo> list(BoaUser authUserWithDept, @RequestParam("siteId") Integer siteId) {
+        return personService.list(authUserWithDept, siteId);
+    }
+
+    @PostMapping("/save")
+    public PersonVo save(BoaUser authUserWithDept, @Valid @RequestBody PersonSaveRequest request) {
+        return personService.save(authUserWithDept, request);
+    }
+
+    @PostMapping("/delete")
+    public void delete(BoaUser authUserWithDept, @Valid @RequestBody DeleteRequest request) {
+        personService.delete(authUserWithDept, request);
+    }
+}

src/main/java/com/yunhai/cms/controller/api/ThemeController.java

@@ -69,13 +69,14 @@ public class ThemeController {
     }
 
     /** W1（G4）+ 任务四：编辑元数据——外部包写 theme.json（title/描述/参数 schema），
-     *  内置包显示名/描述写 .meta 覆盖层（参数 schema 拒改），保存后引用站点立即生效 */
+     *  内置包显示名/描述写 .meta 覆盖层（参数 schema 拒改），保存后引用站点立即生效。
+     *  工作项 T：paramValues（包级参数值）两种来源统一写 .meta 覆盖层，null=不改 */
     @PutMapping("/{name}/meta")
     public com.yunhai.cms.model.vo.ThemeVo updateMeta(BoaUser authUserWithDept,
             @PathVariable("name") String name,
             @RequestBody com.yunhai.cms.model.dto.ThemeMetaRequest req) {
         ThemeInfo info = themePackageService.updateMeta(authUserWithDept, name,
-                req.getTitle(), req.getDescription(), req.getParams());
+                req.getTitle(), req.getDescription(), req.getParams(), req.getParamValues());
         return themeService.voOf(info);
     }
 

src/main/java/com/yunhai/cms/controller/oapi/site/SiteOapiController.java

@@ -2,6 +2,7 @@ package com.yunhai.cms.controller.oapi.site;
 
 import com.yunhai.cms.entity.CmsSite;
 import com.yunhai.cms.repository.CmsSiteRepository;
+import com.yunhai.cms.utils.ExtJsonUtils;
 import com.yunhai.platform.apistd.BizException;
 import com.yunhai.platform.utils.exception.ErrorCode;
 import lombok.Data;
@@ -11,7 +12,9 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Map;
 
 /**
  * 站点目录开放接口（/oapi/site/list，appKey 签名访问；V2.0 Part C.3）。
@@ -51,14 +54,34 @@ public class SiteOapiController {
         vo.setSiteCode(site.getCode());
         vo.setName(site.getName());
         vo.setSchId(site.getSchId() == null ? null : site.getSchId().longValue());
+        // T1 主题联动（2026-10-03）：theme 空=default；themeParams=config_json.theme_params
+        // 原样键值（解析写法对齐 PortalSiteSnapshot.of），未配=空对象（消费方免判空两写）
+        vo.setTheme(site.getTheme() == null || site.getTheme().isEmpty()
+                ? "default" : site.getTheme());
+        Map<String, Object> config = ExtJsonUtils.parse(site.getConfigJson());
+        Object tp = config == null ? null : config.get("theme_params");
+        Map<String, String> params = new LinkedHashMap<>();
+        if (tp instanceof Map) {
+            for (Map.Entry<?, ?> e : ((Map<?, ?>) tp).entrySet()) {
+                if (e.getKey() != null && e.getValue() != null) {
+                    params.put(String.valueOf(e.getKey()), String.valueOf(e.getValue()));
+                }
+            }
+        }
+        vo.setThemeParams(params);
         return vo;
     }
 
-    /** 站点选项（siteCode 为办事大厅侧定位键；schId 用于权限与租户定界） */
+    /** 站点选项（siteCode 为办事大厅侧定位键；schId 用于权限与租户定界；
+     * theme/themeParams raw 透传——消费方（svc-hall hall 用户面）按皮肤声明自行过滤） */
     @Data
     public static class SiteOptionVo {
         private String siteCode;
         private String name;
         private Long schId;
+        /** CMS 皮肤包名（空已兜底为 default） */
+        private String theme;
+        /** CMS config_json.theme_params 原样键值（未配置=空对象） */
+        private Map<String, String> themeParams = new LinkedHashMap<>();
     }
 }

src/main/java/com/yunhai/cms/controller/portal/PortalController.java

@@ -19,6 +19,7 @@ import com.yunhai.cms.svcitem.model.vo.PortalServiceItem;
 import com.yunhai.cms.svcitem.model.vo.PortalServiceListData;
 import com.yunhai.cms.svcitem.service.SvcItemQuery;
 import com.yunhai.cms.utils.PortalUrlHelper;
+import com.yunhai.cms.utils.SvcHallLinks;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Value;
@@ -491,18 +492,15 @@ public class PortalController {
         // "我要办理"三态（§5.3）：① ext_json.apply_url 手填外链（最高优先）
         // ② 未填且站点配了 svc_hall_base 且事项开通在线办理（onlineFlag=1 且绑流程，§3.7——
         //    与 svc-hall 侧 submit 校验"未开通在线办理"口径对齐，线下/纯指南事项不再渲染按钮）
+        //    ——深链带 from=指南页回跳地址，hall 据此显示"返回门户"按钮（T4 闭环）
         // ③ 其余 → 不注入（模板不渲染按钮）
         String applyUrl = item.getApplyUrl();
         boolean onlineHandlable = item.getOnlineFlag() != null && item.getOnlineFlag() == 1
                 && StringUtils.hasText(item.getFlowGuid());
         if ((applyUrl == null || applyUrl.trim().isEmpty()) && onlineHandlable
                 && site.getSvcHallBase() != null && !site.getSvcHallBase().trim().isEmpty()) {
-            String base = site.getSvcHallBase().trim();
-            while (base.endsWith("/")) {
-                base = base.substring(0, base.length() - 1);
-            }
-            applyUrl = base + "/#/apply?siteCode=" + urlEncodeValue(site.getCode())
-                    + "&itemCode=" + urlEncodeValue(item.getItemCode());
+            applyUrl = SvcHallLinks.build(site.getSvcHallBase(), site.getCode(),
+                    item.getItemCode(), url.serviceItem(itemId));
         }
         if (applyUrl != null && !applyUrl.trim().isEmpty()) {
             model.addAttribute("applyUrl", applyUrl);
@@ -687,14 +685,6 @@ public class PortalController {
         return trimmed.isEmpty() ? null : trimmed;
     }
 
-    private static String urlEncodeValue(String value) {
-        try {
-            return java.net.URLEncoder.encode(value == null ? "" : value, "UTF-8");
-        } catch (java.io.UnsupportedEncodingException e) {
-            return value;
-        }
-    }
-
 
     /**
      * 站点身份解析（W4）：优先按门户 path（siteSnapshotByPath）；

src/main/java/com/yunhai/cms/controller/portal/PortalPageRenderer.java

@@ -23,6 +23,7 @@ import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.regex.Pattern;
 
 /**
  * 门户页面装配组件（方案 §5.5，P1 抽取重构）：PortalController 与主题预览接口共用，
@@ -41,6 +42,8 @@ public class PortalPageRenderer {
 
     private final CmsArticleRepository articleRepository;
     private final ThemeRegistry themeRegistry;
+    /** docs/20 D-7：people 区块数据源 */
+    private final com.yunhai.cms.repository.CmsPersonRepository personRepository;
 
     /**
      * M0 可选模板整页回退（事项库详细设计 §四）：目标主题缺该页模板（如 service.html/guide.html
@@ -288,6 +291,8 @@ public class PortalPageRenderer {
     private static final int LAYOUT_SIZE_MAX = 20;
     private static final int LAYOUT_LIST_SIZE_DEFAULT = 8;
     private static final int LAYOUT_TICKER_SIZE_DEFAULT = 6;
+    /** 区块内手填链接：http(s) 绝对地址或站内根相对路径（与 SiteService 保存期校验同契约，拒绝伪协议） */
+    private static final Pattern LAYOUT_LINK_URL = Pattern.compile("^(https?://\\S+|/.+)$");
 
     /**
      * home_layout → 模板区块序列。null = 无布局/结构非法（回落现状装配，D2）。
@@ -341,20 +346,46 @@ public class PortalPageRenderer {
                 return buildGalleryBlock(site, spec, url);
             case "links":
                 return buildLinksBlock(site, spec);
+            case "quick_links":
+                return buildQuickLinksBlock(spec);
+            case "notice_bar":
+                return buildNoticeBarBlock(spec);
+            // ===== docs/20 D-1~D-9 新组件（空数据返回 null = 整块不渲染，R-44）=====
+            case "stats_band":
+                return buildStatsBandBlock(spec);
+            case "featured_topics":
+                return buildFeaturedTopicsBlock(site, spec, url);
+            case "video_tour":
+                return buildVideoTourBlock(spec, url);
+            case "events":
+                return buildEventsBlock(site, spec, url);
+            case "people":
+                return buildPeopleBlock(site, spec, treeIds);
+            case "badges":
+                return buildBadgesBlock(spec);
             default:
                 return null; // 白名单外的脏数据跳过，不打挂渲染
         }
     }
 
-    /** 区块公共头：type/title，并合成为 category.name 供主题 fragment 复用（block.category.name 取标题） */
+    /** 区块公共头：type/title，并合成为 category.name 供主题 fragment 复用（block.category.name 取标题）。
+     *  F2（docs/20）：透传区块 id（编辑器实时预览 postMessage 重排的 DOM 锚点 data-plb-id）。
+     *  D-4（docs/20）：subtitle 全类型通用（中英双语栏目标题——主题 titleStyle 参数控制展示开关）。 */
     private Map<String, Object> baseBlock(Map<String, Object> spec, String type, String fallbackTitle) {
         Map<String, Object> block = new HashMap<>();
         block.put("type", type);
+        if (spec.get("id") != null) {
+            block.put("id", String.valueOf(spec.get("id")));
+        }
         String title = spec.get("title") == null ? "" : String.valueOf(spec.get("title")).trim();
         if (title.isEmpty()) {
             title = fallbackTitle;
         }
         block.put("title", title);
+        String subtitle = spec.get("subtitle") == null ? "" : String.valueOf(spec.get("subtitle")).trim();
+        if (!subtitle.isEmpty()) {
+            block.put("subtitle", subtitle);
+        }
         Map<String, Object> category = new HashMap<>();
         category.put("name", title);
         block.put("category", category);
@@ -443,7 +474,11 @@ public class PortalPageRenderer {
         if (subtitle.isEmpty()) {
             subtitle = str(config.get("gallery_subtitle"), "Online Exhibition Hall");
         }
-        block.put("subtitle", subtitle);
+        if (!subtitle.isEmpty()) {
+            block.put("subtitle", subtitle);
+        }
+        // D-8（docs/20）：campus_wall 布局开关（grid 规整网格 / masonry 瀑布流）
+        block.put("layout", "masonry".equals(str(spec.get("layout"), "")) ? "masonry" : "grid");
         block.put("items", activeBanners(site, "gallery", url));
         return block;
     }
@@ -463,8 +498,261 @@ public class PortalPageRenderer {
         return block;
     }
 
+    /**
+     * 快捷入口宫格（v2 手册 §2.8 类型 A；docs/20 D-2 升级图标宫格）：数据是区块内联数组，不读任何外部表。
+     * 保存期已校验 url/icon 白名单，装配期对脏数据（直改库/历史配置）再容错一次——不合法项静默丢弃，不打挂渲染。
+     */
+    private Map<String, Object> buildQuickLinksBlock(Map<String, Object> spec) {
+        List<Map<String, Object>> links = new ArrayList<>();
+        Object raw = spec.get("items");
+        if (raw instanceof List) {
+            for (Object o : (List<?>) raw) {
+                if (!(o instanceof Map)) {
+                    continue;
+                }
+                Map<?, ?> item = (Map<?, ?>) o;
+                String name = str(item.get("name"), "").trim();
+                String linkUrl = str(item.get("url"), "").trim();
+                if (name.isEmpty() || !LAYOUT_LINK_URL.matcher(linkUrl).matches()) {
+                    continue;
+                }
+                Map<String, Object> link = new HashMap<>();
+                link.put("name", name);
+                link.put("url", linkUrl);
+                // D-2：可选图标标识符（未选时骨架渲染首字徽章兜底）
+                String icon = str(item.get("icon"), "").trim();
+                if (!icon.isEmpty() && icon.matches("^[a-z0-9-]{1,30}$")) {
+                    link.put("icon", icon);
+                }
+                links.add(link);
+            }
+        }
+        Map<String, Object> block = baseBlock(spec, "quick_links", "快捷通道");
+        block.put("quickLinks", links);
+        return block;
+    }
+
+    /** 公告条（v2 手册 §2.8 类型 B）：站点单条手填通告；level 白名单外归一 info，url 不合法则退化为纯文本 */
+    private Map<String, Object> buildNoticeBarBlock(Map<String, Object> spec) {
+        String linkUrl = str(spec.get("url"), "").trim();
+        if (!LAYOUT_LINK_URL.matcher(linkUrl).matches()) {
+            linkUrl = "";
+        }
+        Map<String, Object> block = baseBlock(spec, "notice_bar", "公告");
+        block.put("noticeText", str(spec.get("text"), "").trim());
+        block.put("noticeUrl", linkUrl);
+        block.put("noticeLevel", "warn".equals(str(spec.get("level"), "").trim()) ? "warn" : "info");
+        return block;
+    }
+
+    // ===== docs/20 D 新组件装配（空数据返回 null → buildLayoutBlocks 跳过 = 整块不渲染，R-44）=====
+
+    /** stats_band（D-1 数字计数带）：stats 内联数组透传（骨架共享 count-up 动画）；空/无有效项 → 不渲染 */
+    private Map<String, Object> buildStatsBandBlock(Map<String, Object> spec) {
+        List<Map<String, Object>> stats = new ArrayList<>();
+        Object raw = spec.get("stats");
+        if (raw instanceof List) {
+            for (Object o : (List<?>) raw) {
+                if (!(o instanceof Map)) {
+                    continue;
+                }
+                Map<?, ?> item = (Map<?, ?>) o;
+                String label = str(item.get("label"), "").trim();
+                String value = str(item.get("value"), "").trim();
+                if (label.isEmpty() || value.isEmpty()) {
+                    continue;
+                }
+                Map<String, Object> stat = new HashMap<>();
+                stat.put("label", label);
+                stat.put("value", value);
+                String unit = str(item.get("unit"), "").trim();
+                if (!unit.isEmpty()) {
+                    stat.put("unit", unit);
+                }
+                String icon = str(item.get("icon"), "").trim();
+                if (!icon.isEmpty() && icon.matches("^[a-z0-9-]{1,30}$")) {
+                    stat.put("icon", icon);
+                }
+                stats.add(stat);
+            }
+        }
+        if (stats.isEmpty()) {
+            return null;
+        }
+        Map<String, Object> block = baseBlock(spec, "stats_band", "数说学校");
+        block.put("stats", stats);
+        return block;
+    }
+
+    /** featured_topics（D-3 专题大卡）：数据 = banner 表 topic 展示位（描述/CTA 扩展列）；无在展数据 → 不渲染 */
+    private Map<String, Object> buildFeaturedTopicsBlock(PortalSiteSnapshot site, Map<String, Object> spec,
+                                                         PortalUrlHelper url) {
+        List<Map<String, Object>> items = new ArrayList<>();
+        for (PortalBanner b : site.getBanners()) {
+            if (!"topic".equals(b.getPosition()) || !isActiveNow(b)) {
+                continue;
+            }
+            Map<String, Object> item = new HashMap<>();
+            item.put("title", b.getTitle());
+            item.put("imageUrl", url.upload(b.getImageUrl()));
+            item.put("linkUrl", resolveBannerLink(b, url));
+            if (hasText(b.getDescription())) {
+                item.put("description", b.getDescription());
+            }
+            if (hasText(b.getCtaText())) {
+                item.put("ctaText", b.getCtaText());
+            }
+            if (hasText(b.getCtaUrl())) {
+                item.put("ctaUrl", b.getCtaUrl());
+            }
+            items.add(item);
+        }
+        if (items.isEmpty()) {
+            return null;
+        }
+        Map<String, Object> block = baseBlock(spec, "featured_topics", "专题推荐");
+        block.put("items", items);
+        return block;
+    }
+
+    /** video_tour（D-5 视频/VR 校园）：cover 资产补基准 + url + title；脏数据（缺 cover/url）→ 不渲染 */
+    private Map<String, Object> buildVideoTourBlock(Map<String, Object> spec, PortalUrlHelper url) {
+        String cover = str(spec.get("cover"), "").trim();
+        String videoUrl = str(spec.get("url"), "").trim();
+        if (!ASSET_URL_PATTERN.matcher(cover).matches() || !LAYOUT_LINK_URL.matcher(videoUrl).matches()) {
+            return null;
+        }
+        Map<String, Object> block = baseBlock(spec, "video_tour", "云端校园");
+        block.put("cover", url.upload(cover));
+        block.put("videoUrl", videoUrl);
+        return block;
+    }
+
+    /** events（D-6 学术日历/活动）：数据 = banner 表 event 展示位（event_date/location 扩展列）；无在展数据 → 不渲染 */
+    private Map<String, Object> buildEventsBlock(PortalSiteSnapshot site, Map<String, Object> spec,
+                                                 PortalUrlHelper url) {
+        List<PortalBanner> events = new ArrayList<>();
+        for (PortalBanner b : site.getBanners()) {
+            if ("event".equals(b.getPosition()) && isActiveNow(b)) {
+                events.add(b);
+            }
+        }
+        // 活动日历语义：按活动日期升序（无日期的排后按 sortNo），最多 6 条
+        events.sort(java.util.Comparator
+                .comparing((PortalBanner b) -> b.getEventDate() == null ? java.time.LocalDateTime.MAX : b.getEventDate())
+                .thenComparing(PortalBanner::getSortNo, java.util.Comparator.nullsLast(Integer::compareTo)));
+        if (events.size() > 6) {
+            events = events.subList(0, 6);
+        }
+        if (events.isEmpty()) {
+            return null;
+        }
+        List<Map<String, Object>> items = new ArrayList<>();
+        for (PortalBanner b : events) {
+            Map<String, Object> item = new HashMap<>();
+            item.put("title", b.getTitle());
+            item.put("linkUrl", resolveBannerLink(b, url));
+            if (b.getEventDate() != null) {
+                item.put("eventDate", b.getEventDate());
+            }
+            if (hasText(b.getLocation())) {
+                item.put("location", b.getLocation());
+            }
+            items.add(item);
+        }
+        Map<String, Object> block = baseBlock(spec, "events", "学术活动");
+        block.put("items", items);
+        return block;
+    }
+
+    /** people（D-7 名师风采）：cms_person 启用数据（categoryId 可选过滤，须在本站栏目树内）；无数据 → 不渲染 */
+    private Map<String, Object> buildPeopleBlock(PortalSiteSnapshot site, Map<String, Object> spec,
+                                                 Set<Integer> treeIds) {
+        Integer categoryId = null;
+        Object rawCategory = spec.get("categoryId");
+        if (rawCategory instanceof Number && ((Number) rawCategory).intValue() > 0
+                && treeIds.contains(((Number) rawCategory).intValue())) {
+            categoryId = ((Number) rawCategory).intValue();
+        }
+        List<com.yunhai.cms.entity.CmsPerson> people = new ArrayList<>();
+        for (com.yunhai.cms.entity.CmsPerson p
+                : personRepository.findBySiteIdAndStatusOrderBySortNoAscIdAsc(site.getId(), 1)) {
+            if (categoryId != null && !categoryId.equals(p.getCategoryId())) {
+                continue;
+            }
+            people.add(p);
+            if (people.size() >= 12) {
+                break;
+            }
+        }
+        if (people.isEmpty()) {
+            return null;
+        }
+        List<Map<String, Object>> items = new ArrayList<>();
+        for (com.yunhai.cms.entity.CmsPerson p : people) {
+            Map<String, Object> item = new HashMap<>();
+            item.put("name", p.getName());
+            if (hasText(p.getTitle())) {
+                item.put("title", p.getTitle());
+            }
+            if (hasText(p.getBio())) {
+                item.put("bio", p.getBio());
+            }
+            if (hasText(p.getAvatar())) {
+                item.put("avatar", p.getAvatar());
+            }
+            items.add(item);
+        }
+        Map<String, Object> block = baseBlock(spec, "people", "名师风采");
+        block.put("items", items);
+        return block;
+    }
+
+    /** badges（D-9 排名/学科评估徽章带）：badgeItems 内联数组透传；空 → 不渲染 */
+    private Map<String, Object> buildBadgesBlock(Map<String, Object> spec) {
+        List<Map<String, Object>> items = new ArrayList<>();
+        Object raw = spec.get("badgeItems");
+        if (raw instanceof List) {
+            for (Object o : (List<?>) raw) {
+                if (!(o instanceof Map)) {
+                    continue;
+                }
+                Map<?, ?> m = (Map<?, ?>) o;
+                String label = str(m.get("label"), "").trim();
+                String image = str(m.get("image"), "").trim();
+                if (label.isEmpty() || !ASSET_URL_PATTERN.matcher(image).matches()) {
+                    continue;
+                }
+                Map<String, Object> item = new HashMap<>();
+                item.put("label", label);
+                item.put("image", image);
+                String desc = str(m.get("desc"), "").trim();
+                if (!desc.isEmpty()) {
+                    item.put("desc", desc);
+                }
+                items.add(item);
+            }
+        }
+        if (items.isEmpty()) {
+            return null;
+        }
+        Map<String, Object> block = baseBlock(spec, "badges", "实力声誉");
+        block.put("items", items);
+        return block;
+    }
+
+    /** banner 时间窗过滤（activeBanners 同语义，供 topic/event 位复用；快照内 banner 已过滤启用态） */
+    private boolean isActiveNow(PortalBanner b) {
+        java.time.LocalDateTime now = java.time.LocalDateTime.now();
+        return (b.getStartTime() == null || !now.isBefore(b.getStartTime()))
+                && (b.getEndTime() == null || now.isBefore(b.getEndTime()));
+    }
+
     // ===== 布局装配工具 =====
 
+    /** 区块内图片资产 URL 形态（与 SiteService ASSET_PATTERN 同语义） */
+    private static final Pattern ASSET_URL_PATTERN = Pattern.compile("^(/.+|https?://\\S+)$");
+
     private static String str(Object v, String fallback) {
         return v == null ? fallback : String.valueOf(v);
     }

src/main/java/com/yunhai/cms/entity/CmsBanner.java

@@ -59,4 +59,27 @@ public class CmsBanner extends BaseEntity {
     /** 状态：0=停用 1=启用 */
     @Column(name = "status", nullable = false)
     private Integer status = 1;
+
+    // ===== docs/20 D-3/D-6：banner 表扩展（topic=专题大卡位 / event=学术活动位）=====
+    // 仅对应展示位消费；home/gallery 位忽略。可空列，ddl-auto=update 自动补列（SQL 脚本另附 resources/sql）。
+
+    /** 专题大卡描述文案（position=topic） */
+    @Column(name = "description", length = 500)
+    private String description;
+
+    /** 专题大卡 CTA 按钮文字（position=topic，如「进入专题」） */
+    @Column(name = "cta_text", length = 100)
+    private String ctaText;
+
+    /** 专题大卡 CTA 跳转地址（position=topic） */
+    @Column(name = "cta_url", length = 500)
+    private String ctaUrl;
+
+    /** 活动日期（position=event，学术日历大日期块） */
+    @Column(name = "event_date")
+    private LocalDateTime eventDate;
+
+    /** 活动地点（position=event） */
+    @Column(name = "location", length = 200)
+    private String location;
 }

src/main/java/com/yunhai/cms/entity/CmsPerson.java

@@ -0,0 +1,56 @@
+package com.yunhai.cms.entity;
+
+import lombok.Getter;
+import lombok.Setter;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Index;
+import javax.persistence.Table;
+
+/**
+ * 名师风采人物（docs/20 D-7：首页 people 区块数据源，新表）。
+ * 人物按站点隔离、可挂栏目分组（category_id 可空 = 未分组）；头像走附件上传通道。
+ * DDL：hibernate ddl-auto=update 自动建表；DBA 审阅脚本见 resources/sql/cms_person.sql（不自动执行）。
+ */
+@Getter
+@Setter
+@Entity
+@Table(name = "cms_person", indexes = {
+        @Index(name = "idx_person_site", columnList = "site_id, status, sort_no"),
+        @Index(name = "idx_person_category", columnList = "category_id")
+})
+public class CmsPerson extends BaseEntity {
+
+    /** 所属站点 */
+    @Column(name = "site_id", nullable = false)
+    private Integer siteId;
+
+    /** 姓名 */
+    @Column(name = "name", nullable = false, length = 100)
+    private String name;
+
+    /** 头衔/职称（如 教授、长江学者） */
+    @Column(name = "title", length = 100)
+    private String title;
+
+    /** 一句话简介 */
+    @Column(name = "bio", length = 500)
+    private String bio;
+
+    /** 头像 URL（附件上传，/cms/upload/** 或 http(s)） */
+    @Column(name = "avatar", length = 500)
+    private String avatar;
+
+    /** 所属栏目外键（可空 = 未分组；people 区块按此过滤） */
+    @Column(name = "category_id")
+    private Integer categoryId;
+
+    /** 同级排序（升序） */
+    @Column(name = "sort_no", nullable = false)
+    private Integer sortNo = 0;
+
+    /** 状态：0=停用 1=启用 */
+    @Column(name = "status", nullable = false)
+    private Integer status = 1;
+}

src/main/java/com/yunhai/cms/model/dto/BannerSaveRequest.java

@@ -8,7 +8,7 @@ import javax.validation.constraints.Size;
 import java.time.LocalDateTime;
 
 /**
- * 轮播保存（校验 link_type/link_value，方案 §9.2）。
+ * 轮播保存（校验 link_type/link_value，方案 §9.2；docs/20 D-3/D-6 扩展 topic/event 位字段）。
  */
 @Data
 public class BannerSaveRequest {
@@ -49,4 +49,25 @@ public class BannerSaveRequest {
 
     /** 0=停用 1=启用 */
     private Integer status = 1;
+
+    // ===== docs/20 D-3/D-6：topic/event 展示位扩展（仅对应位消费，其余位忽略）=====
+
+    /** 专题大卡描述（position=topic） */
+    @Size(max = 500, message = "专题描述过长")
+    private String description;
+
+    /** 专题大卡 CTA 按钮文字（position=topic） */
+    @Size(max = 100, message = "按钮文字过长")
+    private String ctaText;
+
+    /** 专题大卡 CTA 跳转地址（position=topic） */
+    @Size(max = 500, message = "按钮地址过长")
+    private String ctaUrl;
+
+    /** 活动日期（position=event） */
+    private LocalDateTime eventDate;
+
+    /** 活动地点（position=event） */
+    @Size(max = 200, message = "活动地点过长")
+    private String location;
 }

src/main/java/com/yunhai/cms/model/dto/PersonSaveRequest.java

@@ -0,0 +1,42 @@
+package com.yunhai.cms.model.dto;
+
+import lombok.Data;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotNull;
+import javax.validation.constraints.Size;
+
+/**
+ * 名师风采人物保存（docs/20 D-7）。
+ */
+@Data
+public class PersonSaveRequest {
+
+    /** 修改时必填 */
+    private Integer id;
+
+    @NotNull(message = "siteId 不得为空")
+    private Integer siteId;
+
+    @NotBlank(message = "姓名不得为空")
+    @Size(max = 100, message = "姓名过长")
+    private String name;
+
+    @Size(max = 100, message = "头衔过长")
+    private String title;
+
+    @Size(max = 500, message = "简介过长")
+    private String bio;
+
+    /** 头像（/cms/upload/** 或 http(s)；可空 = 首字徽章兜底） */
+    @Size(max = 500)
+    private String avatar;
+
+    /** 所属栏目（可空 = 未分组；须属于本站点） */
+    private Integer categoryId;
+
+    private Integer sortNo = 0;
+
+    /** 0=停用 1=启用 */
+    private Integer status = 1;
+}

src/main/java/com/yunhai/cms/model/dto/SiteSaveRequest.java

@@ -44,9 +44,12 @@ public class SiteSaveRequest {
     private String configJson;
 
     /**
-     * 主题微调参数（方案 §5.3）：仅接收所选主题 theme.json 声明过的 key；
-     * 服务端校验后合并进 config_json.theme_params（保留其余键），非法 key/值服务端丢弃。
+     * 主题微调参数（方案 §5.3）。
+     *
+     * @deprecated 工作项 T：参数微调已上移为皮肤包级（{@code PUT /api/theme/{name}/meta} 的
+     *             {@code paramValues}），站点不再持有参数值，服务端忽略本字段。字段保留仅为老前端不报错。
      */
+    @Deprecated
     private Map<String, String> themeParams;
 
     /** 0=停用 1=启用 */

src/main/java/com/yunhai/cms/model/dto/ThemeMetaRequest.java

@@ -4,6 +4,7 @@ import com.yunhai.cms.theme.ThemeParam;
 import lombok.Data;
 
 import java.util.List;
+import java.util.Map;
 
 /** W1 皮肤包元数据编辑请求（PUT /api/theme/{name}/meta）；任务四增 description 并放开内置包改名（走 .meta 覆盖层） */
 @Data
@@ -16,4 +17,10 @@ public class ThemeMetaRequest {
 
     /** 参数 schema 整体替换（key/label/type/默认值/色值合法性服务端强校验）；null=不改；内置包拒改 */
     private List<ThemeParam> params;
+
+    /**
+     * 包级参数值（工作项 T：参数微调迁皮肤包级）：null=不改，非 null=整体替换（空 Map=恢复 theme.json 默认值）；
+     * 未声明 key 与非法值按包 schema 丢弃；内置包与外部包统一写 .meta 覆盖层。
+     */
+    private Map<String, String> paramValues;
 }

src/main/java/com/yunhai/cms/model/portal/PortalBanner.java

@@ -34,6 +34,22 @@ public class PortalBanner {
     /** 下线时间（渲染方过滤） */
     private LocalDateTime endTime;
 
+    // ===== docs/20 D-3/D-6：topic/event 展示位扩展字段 =====
+    /** 专题大卡描述（position=topic） */
+    private String description;
+
+    /** 专题大卡 CTA 按钮文字（position=topic） */
+    private String ctaText;
+
+    /** 专题大卡 CTA 跳转地址（position=topic） */
+    private String ctaUrl;
+
+    /** 活动日期（position=event，学术日历大日期块） */
+    private LocalDateTime eventDate;
+
+    /** 活动地点（position=event） */
+    private String location;
+
     public static PortalBanner of(CmsBanner b) {
         PortalBanner item = new PortalBanner();
         item.setId(b.getId());
@@ -45,6 +61,11 @@ public class PortalBanner {
         item.setSortNo(b.getSortNo());
         item.setStartTime(b.getStartTime());
         item.setEndTime(b.getEndTime());
+        item.setDescription(b.getDescription());
+        item.setCtaText(b.getCtaText());
+        item.setCtaUrl(b.getCtaUrl());
+        item.setEventDate(b.getEventDate());
+        item.setLocation(b.getLocation());
         return item;
     }
 }

src/main/java/com/yunhai/cms/model/vo/BannerVo.java

@@ -34,6 +34,13 @@ public class BannerVo {
 
     private Integer status;
 
+    // ===== docs/20 D-3/D-6：topic/event 展示位扩展字段 =====
+    private String description;
+    private String ctaText;
+    private String ctaUrl;
+    private java.time.LocalDateTime eventDate;
+    private String location;
+
     public static BannerVo of(CmsBanner b) {
         BannerVo vo = new BannerVo();
         vo.setId(b.getId());
@@ -47,6 +54,11 @@ public class BannerVo {
         vo.setStartTime(b.getStartTime());
         vo.setEndTime(b.getEndTime());
         vo.setStatus(b.getStatus());
+        vo.setDescription(b.getDescription());
+        vo.setCtaText(b.getCtaText());
+        vo.setCtaUrl(b.getCtaUrl());
+        vo.setEventDate(b.getEventDate());
+        vo.setLocation(b.getLocation());
         return vo;
     }
 }

src/main/java/com/yunhai/cms/model/vo/PersonVo.java

@@ -0,0 +1,39 @@
+package com.yunhai.cms.model.vo;
+
+import com.yunhai.cms.entity.CmsPerson;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/** 名师风采人物（docs/20 D-7） */
+@Data
+public class PersonVo {
+
+    private Integer id;
+    private Integer siteId;
+    private String name;
+    private String title;
+    private String bio;
+    private String avatar;
+    private Integer categoryId;
+    private Integer sortNo;
+    private Integer status;
+    private LocalDateTime createTime;
+    private LocalDateTime updateTime;
+
+    public static PersonVo of(CmsPerson p) {
+        PersonVo vo = new PersonVo();
+        vo.setId(p.getId());
+        vo.setSiteId(p.getSiteId());
+        vo.setName(p.getName());
+        vo.setTitle(p.getTitle());
+        vo.setBio(p.getBio());
+        vo.setAvatar(p.getAvatar());
+        vo.setCategoryId(p.getCategoryId());
+        vo.setSortNo(p.getSortNo());
+        vo.setStatus(p.getStatus());
+        vo.setCreateTime(p.getCreateTime());
+        vo.setUpdateTime(p.getUpdateTime());
+        return vo;
+    }
+}

src/main/java/com/yunhai/cms/model/vo/ThemeVo.java

@@ -5,6 +5,7 @@ import com.yunhai.cms.theme.ThemeParam;
 import lombok.Data;
 
 import java.util.List;
+import java.util.Map;
 
 /**
  * 主题包 VO（管理端主题列表，方案 §5.2）。
@@ -30,6 +31,12 @@ public class ThemeVo {
     /** 可调参数 schema（管理端表单按此动态生成，方案 §6.3） */
     private List<ThemeParamVo> params;
 
+    /**
+     * 包级参数值（工作项 T）：仅含被微调过、写在 .meta 覆盖层里的 key；
+     * 缺项由前端按 params[].defaultValue 回落展示（值不再存站点 config_json.theme_params）。
+     */
+    private Map<String, String> paramValues;
+
     /** 包来源（W1，G1）：builtin=内置只读 / external=外部可管 */
     private String source;
 
@@ -82,6 +89,8 @@ public class ThemeVo {
         for (ThemeParam p : info.getParams()) {
             vo.getParams().add(ThemeParamVo.of(p));
         }
+        vo.setParamValues(info.getParamValues() == null
+                ? new java.util.LinkedHashMap<>() : new java.util.LinkedHashMap<>(info.getParamValues()));
         return vo;
     }
 }

src/main/java/com/yunhai/cms/repository/CmsPersonRepository.java

@@ -0,0 +1,16 @@
+package com.yunhai.cms.repository;
+
+import com.yunhai.cms.entity.CmsPerson;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+/** 名师风采（docs/20 D-7） */
+public interface CmsPersonRepository extends JpaRepository<CmsPerson, Integer> {
+
+    /** 管理端：站点全量（含停用，按排序） */
+    List<CmsPerson> findBySiteIdOrderBySortNoAscIdAsc(Integer siteId);
+
+    /** 门户：启用人物（可选栏目过滤），按排序 */
+    List<CmsPerson> findBySiteIdAndStatusOrderBySortNoAscIdAsc(Integer siteId, Integer status);
+}

src/main/java/com/yunhai/cms/service/impl/AttachmentService.java

@@ -68,11 +68,11 @@ public class AttachmentService {
 
     /**
      * 上传 scene 白名单（B2 附件引用模型）：banner=轮播 / link=友链 / site=站点配置 /
-     * category=单页栏目贴图。svc_item/svc_item_asset 两个事项场景已随事项库迁出办事大厅
-     * （V2.0，见 docs/19 §九），CMS 侧下线。
+     * category=单页栏目贴图 / person=名师头像（docs/20 D-7）。svc_item/svc_item_asset 两个事项场景
+     * 已随事项库迁出办事大厅（V2.0，见 docs/19 §九），CMS 侧下线。
      */
     private static final List<String> ALLOWED_SCENES =
-            Arrays.asList("banner", "link", "site", "category");
+            Arrays.asList("banner", "link", "site", "category", "person");
 
     private final CmsAttachmentRepository attachmentRepository;
     private final SiteService siteService;

src/main/java/com/yunhai/cms/service/impl/BannerService.java

@@ -81,6 +81,12 @@ public class BannerService {
             throw new BizException(ErrorCode.PARAM_ERROR, "下线时间不能早于上线时间");
         }
         banner.setStatus(req.getStatus() == null ? 1 : req.getStatus());
+        // docs/20 D-3/D-6：topic/event 位扩展字段透传（其余位一并落库，渲染端按位消费）
+        banner.setDescription(req.getDescription());
+        banner.setCtaText(req.getCtaText());
+        banner.setCtaUrl(req.getCtaUrl());
+        banner.setEventDate(req.getEventDate());
+        banner.setLocation(req.getLocation());
         banner = bannerRepository.save(banner);
         // B2 附件引用：先解引用再回写新图（编辑换图时旧图回未使用）；幂等
         attachmentService.release("banner", banner.getId());

src/main/java/com/yunhai/cms/service/impl/CategoryService.java

@@ -80,8 +80,7 @@ public class CategoryService {
         if (StringUtils.hasText(req.getHomeStyle()) && !HOME_STYLE_VALUES.contains(req.getHomeStyle())) {
             throw new BizException(ErrorCode.PARAM_ERROR,
                     "首页展示形态非法：" + req.getHomeStyle() + "（仅支持 news_grid / media_focus）");
-        }
-        CmsCategory category;
+        }        CmsCategory category;
         if (req.getId() == null) {
             category = new CmsCategory();
             category.setSiteId(site.getId());
@@ -98,7 +97,9 @@ public class CategoryService {
         category.setType(type.getCode());
         category.setLinkUrl(req.getLinkUrl());
         category.setTemplate(req.getTemplate());
-        category.setHomeStyle(StringUtils.hasText(req.getHomeStyle()) ? req.getHomeStyle() : null);
+        // F3（docs/20 §四）：「首页展示形态」唯一入口收敛到首页布局编辑器，栏目管理不再编辑该字段——
+        // 入参缺省时保留已有值（存量数据不清除，无布局站点的回落渲染仍消费）；显式传值仍校验（API 兼容）
+        category.setHomeStyle(StringUtils.hasText(req.getHomeStyle()) ? req.getHomeStyle() : category.getHomeStyle());
         category.setContent(HtmlSanitizer.clean(req.getContent()));
         category.setSortNo(req.getSortNo() == null ? 0 : req.getSortNo());
         category.setSeoTitle(req.getSeoTitle());

src/main/java/com/yunhai/cms/service/impl/PersonService.java

@@ -0,0 +1,94 @@
+package com.yunhai.cms.service.impl;
+
+import com.yunhai.cms.entity.CmsCategory;
+import com.yunhai.cms.entity.CmsPerson;
+import com.yunhai.cms.event.SiteContentChangedEvent;
+import com.yunhai.cms.model.dto.DeleteRequest;
+import com.yunhai.cms.model.dto.PersonSaveRequest;
+import com.yunhai.cms.model.vo.PersonVo;
+import com.yunhai.cms.repository.CmsCategoryRepository;
+import com.yunhai.cms.repository.CmsPersonRepository;
+import com.yunhai.platform.apistd.BizException;
+import com.yunhai.platform.utils.exception.ErrorCode;
+import com.yunhai.platform.utils.model.BoaUser;
+import lombok.RequiredArgsConstructor;
+import org.springframework.context.ApplicationEventPublisher;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * 名师风采人物管理（docs/20 D-7）：站点级 CRUD + people 区块数据源。
+ * 头像附件引用走 scene=person（B2 模型）；categoryId 须属于本站点（防跨站注入）。
+ */
+@Service
+@RequiredArgsConstructor
+public class PersonService {
+
+    private final CmsPersonRepository personRepository;
+    private final CmsCategoryRepository categoryRepository;
+    private final SiteService siteService;
+    private final AttachmentService attachmentService;
+    private final ApplicationEventPublisher eventPublisher;
+
+    public List<PersonVo> list(BoaUser user, Integer siteId) {
+        siteService.requireManageable(user, siteId);
+        return personRepository.findBySiteIdOrderBySortNoAscIdAsc(siteId).stream()
+                .map(PersonVo::of)
+                .collect(Collectors.toList());
+    }
+
+    @Transactional
+    public PersonVo save(BoaUser user, PersonSaveRequest req) {
+        siteService.requireManageable(user, req.getSiteId());
+        if (req.getCategoryId() != null) {
+            CmsCategory category = categoryRepository.findById(req.getCategoryId())
+                    .orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "所属栏目不存在"));
+            if (!category.getSiteId().equals(req.getSiteId())) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "所属栏目不属于本站点");
+            }
+        }
+        CmsPerson person;
+        if (req.getId() == null) {
+            person = new CmsPerson();
+            person.setSiteId(req.getSiteId());
+        } else {
+            person = personRepository.findById(req.getId())
+                    .orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "人物不存在"));
+            if (!person.getSiteId().equals(req.getSiteId())) {
+                throw new BizException(ErrorCode.FORBIDDEN, "无权修改该人物");
+            }
+        }
+        person.setName(req.getName());
+        person.setTitle(req.getTitle());
+        person.setBio(req.getBio());
+        person.setAvatar(req.getAvatar());
+        person.setCategoryId(req.getCategoryId());
+        person.setSortNo(req.getSortNo() == null ? 0 : req.getSortNo());
+        person.setStatus(req.getStatus() == null ? 1 : req.getStatus());
+        person = personRepository.save(person);
+        // B2 附件引用：先解引用再回写新头像（编辑换图时旧图回未使用）；幂等
+        attachmentService.release("person", person.getId());
+        if (StringUtils.hasText(req.getAvatar())) {
+            attachmentService.markUsed(req.getSiteId(), req.getAvatar(), "person", person.getId());
+        }
+        eventPublisher.publishEvent(new SiteContentChangedEvent(req.getSiteId(), "person"));
+        return PersonVo.of(person);
+    }
+
+    @Transactional
+    public void delete(BoaUser user, DeleteRequest req) {
+        CmsPerson person = personRepository.findById(req.getId())
+                .orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "人物不存在"));
+        siteService.requireManageable(user, req.getSiteId());
+        if (!person.getSiteId().equals(req.getSiteId())) {
+            throw new BizException(ErrorCode.FORBIDDEN, "无权删除该人物");
+        }
+        personRepository.delete(person);
+        attachmentService.release("person", person.getId());
+        eventPublisher.publishEvent(new SiteContentChangedEvent(req.getSiteId(), "person"));
+    }
+}

src/main/java/com/yunhai/cms/service/impl/PortalQueryService.java

@@ -75,12 +75,24 @@ public class PortalQueryService {
             return null;
         }
         PortalSiteSnapshot snapshot = PortalSiteSnapshot.of(site);
-        snapshot.setTheme(resolveTheme(snapshot.getTheme(), snapshot.getCode()));
+        String originalTheme = snapshot.getTheme();
+        snapshot.setTheme(resolveTheme(originalTheme, snapshot.getCode()));
         derivePublicBaseUrl(site, snapshot);
         // 微调参数注入（方案 §5.3）：按已解析主题 schema 过滤，回退主题与参数过滤天然一致
         com.yunhai.cms.theme.ThemeInfo themeInfo = themeRegistry.get(snapshot.getTheme());
         java.util.Map<String, String> themeParams =
                 themeInfo.filterValidValues(rawParamsMap(snapshot));
+        // docs/20 E（R-46）：站点用下架主题 → 强制对应 colorScheme 预设（保持原视觉近似）；
+        // 站点保存归一化后 theme 已是保留主题，改由 config.theme_params.colorScheme 站点级驱动
+        com.yunhai.cms.theme.ThemeRegistry.AliasInfo alias =
+                com.yunhai.cms.theme.ThemeRegistry.aliasOf(originalTheme);
+        String siteScheme = siteColorScheme(snapshot.getConfig());
+        if (alias != null && alias.colorScheme != null) {
+            themeParams.put("colorScheme", alias.colorScheme);
+        } else if (siteScheme != null && themeInfo.param("colorScheme") != null
+                && themeInfo.param("colorScheme").isValidValue(siteScheme)) {
+            themeParams.put("colorScheme", siteScheme);
+        }
         snapshot.setThemeParams(themeParams);
         snapshot.setThemeVarsCss(com.yunhai.cms.theme.ThemeVarsCss.build(themeInfo, themeParams));
 
@@ -280,18 +292,47 @@ public class PortalQueryService {
         }
     }
 
-    /** 皮肤包存在性检查：委托 ThemeRegistry（theme.json + 4 模板齐全校验，方案 §5.1 重构，缺省回退 default） */
+    /**
+     * 皮肤包存在性检查：委托 ThemeRegistry；docs/20 E 后下架主题按别名表映射到保留主题
+     * （R-46：门户不断渲染），未知主题回退 default。
+     */
     private String resolveTheme(String theme, String siteCode) {
         if (themeRegistry.contains(theme)) {
             return theme;
         }
+        com.yunhai.cms.theme.ThemeRegistry.AliasInfo alias =
+                com.yunhai.cms.theme.ThemeRegistry.aliasOf(theme);
+        if (alias != null) {
+            log.warn("皮肤包 {} 已下架（docs/20 E 清场），映射到 {}（colorScheme={}）site={}",
+                    theme, alias.target, alias.colorScheme, siteCode);
+            return alias.target;
+        }
         log.warn("皮肤包 {} 未注册（site={}），回退 default", theme, siteCode);
         return com.yunhai.cms.theme.ThemeRegistry.DEFAULT_THEME;
     }
 
-    /** config_json.theme_params 原始值（非对象形态按无参数处理） */
+    /** 站点级 colorScheme（config_json.theme_params.colorScheme，仅归一化保存后的别名站点使用） */
+    private static String siteColorScheme(java.util.Map<String, Object> config) {
+        if (config == null) {
+            return null;
+        }
+        Object tp = config.get("theme_params");
+        if (tp instanceof Map) {
+            Object v = ((Map<?, ?>) tp).get("colorScheme");
+            if (v != null) {
+                String s = String.valueOf(v);
+                return s.isEmpty() ? null : s;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * 参数原始值（工作项 T：参数微调上移为皮肤包级）：取当前主题的包级 {@code paramValues}
+     * （{@code themes/.meta/{name}.json} 覆盖层）。站点 {@code config_json.theme_params} 已退役、不再读取
+     * （存量残留由 SiteService 的 RESERVED 键容忍，不影响门户）。
+     */
     private Map<?, ?> rawParamsMap(PortalSiteSnapshot snapshot) {
-        Object raw = snapshot.getConfig() == null ? null : snapshot.getConfig().get("theme_params");
-        return raw instanceof Map ? (Map<?, ?>) raw : null;
+        return themeRegistry.paramValuesOf(snapshot.getTheme());
     }
 }

src/main/java/com/yunhai/cms/service/impl/SiteService.java

@@ -60,15 +60,39 @@ public class SiteService {
             java.util.Collections.unmodifiableSet(new java.util.HashSet<>(java.util.Arrays.asList("theme_params")));
     private static final int CONFIG_VALUE_MAX_LEN = 500;
 
-    /** home_layout（docs/16 §4.6）结构约束：类型白名单与规模上限（与前端 homeLayout.ts 同契约） */
+    /** home_layout（docs/16 §4.6 + v2 手册 §2.8 + docs/20 D 组件库扩展）结构约束：类型白名单与规模上限（与前端 homeLayout.ts 同契约） */
     private static final Set<String> HOME_LAYOUT_BLOCK_TYPES =
             java.util.Collections.unmodifiableSet(new java.util.HashSet<>(java.util.Arrays.asList(
-                    "article_list", "ticker", "gallery", "links")));
+                    "article_list", "ticker", "gallery", "links", "quick_links", "notice_bar",
+                    // docs/20 D-1~D-9 新组件
+                    "stats_band", "featured_topics", "video_tour", "events", "people", "badges")));
     private static final int HOME_LAYOUT_MAX_BLOCKS = 30;
     private static final int HOME_LAYOUT_MAX_BLOCK_KEYS = 32;
     private static final int HOME_LAYOUT_MAX_TEXT = 100;
     private static final int HOME_LAYOUT_SIZE_MIN = 1;
     private static final int HOME_LAYOUT_SIZE_MAX = 20;
+    /** quick_links（§2.8 类型 A）：内联入口宫格上限与单项 name 长度 */
+    private static final int HOME_LAYOUT_MAX_QUICK_LINKS = 12;
+    private static final int HOME_LAYOUT_MAX_LINK_NAME = 20;
+    /** notice_bar（§2.8 类型 B）：公告正文上限 */
+    private static final int HOME_LAYOUT_MAX_NOTICE_TEXT = 200;
+    /** 区块内手填链接：仅放行 http(s) 绝对地址或站内根相对路径（拒绝 javascript: 等伪协议） */
+    private static final Pattern HOME_LAYOUT_LINK_PATTERN = Pattern.compile("^(https?://\\S+|/.+)$");
+    /** notice_bar 提示级别白名单（缺省 info） */
+    private static final Set<String> HOME_LAYOUT_NOTICE_LEVELS =
+            java.util.Collections.unmodifiableSet(new java.util.HashSet<>(java.util.Arrays.asList("info", "warn")));
+    // ===== docs/20 D 组件库新增约束 =====
+    /** stats_band.stats 项数上限 */
+    private static final int HOME_LAYOUT_MAX_STATS = 8;
+    /** featured_topics.items 项数上限 */
+    private static final int HOME_LAYOUT_MAX_TOPICS = 6;
+    /** badges.items 项数上限 */
+    private static final int HOME_LAYOUT_MAX_BADGES = 8;
+    /** 区块内图标标识符（D-2 内置图标集 key） */
+    private static final Pattern HOME_LAYOUT_ICON_PATTERN = Pattern.compile("^[a-z0-9-]{1,30}$");
+    /** gallery 布局形态（D-8 campus_wall） */
+    private static final Set<String> HOME_LAYOUT_GALLERY_LAYOUTS =
+            java.util.Collections.unmodifiableSet(new java.util.HashSet<>(java.util.Arrays.asList("grid", "masonry")));
 
     /** custom_css 上限与黑名单（B3）：服务端强校验，前端仅提示；黑名单为防御下限（方案风险表） */
     private static final int CUSTOM_CSS_MAX_LEN = 10240;
@@ -167,14 +191,30 @@ public class SiteService {
         site.setSchId(req.getSchId());
         site.setSchName(req.getSchName());
         site.setName(req.getName());
-        String resolvedTheme = StringUtils.hasText(req.getTheme())
+        String requestedTheme = StringUtils.hasText(req.getTheme())
                 ? req.getTheme() : com.yunhai.cms.theme.ThemeRegistry.DEFAULT_THEME;
+        // docs/20 E：下架主题名按别名表归一化为保留主题（保存后 theme 字段收敛到 3 套注册包）
+        com.yunhai.cms.theme.ThemeRegistry.AliasInfo alias =
+                com.yunhai.cms.theme.ThemeRegistry.aliasOf(requestedTheme);
+        String resolvedTheme = requestedTheme;
         if (!themeRegistry.contains(resolvedTheme)) {
-            throw new BizException(ErrorCode.PARAM_ERROR, "皮肤包未注册：" + resolvedTheme);
+            if (alias != null) {
+                resolvedTheme = alias.target;
+            } else {
+                throw new BizException(ErrorCode.PARAM_ERROR, "皮肤包未注册：" + resolvedTheme);
+            }
         }
         site.setTheme(resolvedTheme);
-        validateConfigJson(req.getConfigJson(), site.getId());
-        site.setConfigJson(mergeThemeParams(req, resolvedTheme));
+        String configJson = req.getConfigJson();
+        if (alias != null && alias.colorScheme != null) {
+            // 原配色写入站点级 theme_params.colorScheme（渲染端据此套用预设，保留原视觉近似）
+            configJson = withSiteColorScheme(configJson, alias.colorScheme);
+            req.setConfigJson(configJson);
+        }
+        validateConfigJson(configJson, site.getId());
+        // 工作项 T：参数微调上移为皮肤包级，站点不再持有参数值——themeParams 入参直接忽略
+        // （config_json 原样入库；theme_params 仍是 RESERVED 键以容忍存量/老前端提交，不报错）
+        site.setConfigJson(req.getConfigJson());
         site.setStatus(req.getStatus() == null ? 1 : req.getStatus());
         site = siteRepository.save(site);
         // B2 附件引用：config_json 的 logo/favicon 指向上传文件时回写场景引用（换图/清空自动解引用旧值）
@@ -183,6 +223,26 @@ public class SiteService {
         return SiteVo.of(site);
     }
 
+    /**
+     * docs/20 E：站点级 colorScheme 写入 config_json.theme_params（仅 colorScheme 键，
+     * 其余 theme_params 内容原样保留；theme_params 为 RESERVED 键不参与常规校验）。
+     */
+    private String withSiteColorScheme(String configJson, String colorScheme) {
+        java.util.Map<String, Object> config = ExtJsonUtils.parse(configJson);
+        Object tp = config.get("theme_params");
+        java.util.Map<String, Object> themeParams = new java.util.LinkedHashMap<>();
+        if (tp instanceof java.util.Map) {
+            ((java.util.Map<?, ?>) tp).forEach((k, v) -> themeParams.put(String.valueOf(k), v));
+        }
+        themeParams.put("colorScheme", colorScheme);
+        config.put("theme_params", themeParams);
+        try {
+            return CONFIG_MAPPER.writeValueAsString(config);
+        } catch (Exception e) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "站点配置序列化失败");
+        }
+    }
+
     /**
      * W4 门户 path 计算（唯一入口，前后端各一份纯函数语义：front/src/utils/sitePath.ts 同构）：
      * 顶层（parentSiteId≤0）=code；子站=父站 path + '/' + code。
@@ -240,29 +300,6 @@ public class SiteService {
         }
     }
 
-    /**
-     * themeParams 服务端合并（方案 §5.3，对应评审 R6）：仅替换 config_json.theme_params 键，
-     * 保留 logo/contact/domain 等其余键；未声明 key 与非法值按所选主题 schema 丢弃（不回传错误）。
-     * SPA 不再手拼 configJson 中的该节点。
-     */
-    private String mergeThemeParams(SiteSaveRequest req, String theme) {
-        if (req.getThemeParams() == null) {
-            return req.getConfigJson();
-        }
-        Map<String, Object> config = new java.util.LinkedHashMap<>(ExtJsonUtils.parse(req.getConfigJson()));
-        Map<String, String> filtered = themeRegistry.get(theme).filterValidValues(req.getThemeParams());
-        if (filtered.isEmpty()) {
-            config.remove("theme_params");
-        } else {
-            config.put("theme_params", filtered);
-        }
-        try {
-            return new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsString(config);
-        } catch (Exception e) {
-            throw new BizException(ErrorCode.PARAM_ERROR, "站点配置序列化失败");
-        }
-    }
-
     /**
      * 院系子站层级校验（《院系子站方案》）：上级必须存在、必须为顶层站（层级固定两层）、
      * 与子站同校；子站缺省继承主站的学校信息；已挂子站的顶层站禁止改挂为子站（防锚点悬空）。
@@ -381,7 +418,8 @@ public class SiteService {
 
     /**
      * home_layout 结构校验（docs/16 §4.6）：{version:int, blocks:array}；blocks ≤30、每块 ≤32 键；
-     * type 白名单（article_list/ticker/gallery/links）、size 1~20、字符串字段（title/subtitle）≤100；
+     * type 白名单（article_list/ticker/gallery/links/quick_links/notice_bar）、size 1~20、字符串字段（title/subtitle）≤100；
+     * quick_links / notice_bar 另有分支校验（见 {@link #validateQuickLinksBlock} / {@link #validateNoticeBarBlock}）；
      * categoryIds 数组且每项为正整数，且**必须属于本站点栏目树**（防跨站注入）。
      * 新建站点（siteId=null）不允许携带 categoryIds（尚无栏目可引）。
      */
@@ -411,6 +449,25 @@ public class SiteService {
             if (type == null || !type.isTextual() || !HOME_LAYOUT_BLOCK_TYPES.contains(type.asText())) {
                 throw new BizException(ErrorCode.PARAM_ERROR, "首页布局区块类型不合法：" + (type == null ? "缺省" : type.asText()));
             }
+            if ("quick_links".equals(type.asText())) {
+                validateQuickLinksBlock(block);
+            } else if ("notice_bar".equals(type.asText())) {
+                validateNoticeBarBlock(block);
+            } else if ("stats_band".equals(type.asText())) {
+                validateStatsBandBlock(block);
+            } else if ("featured_topics".equals(type.asText())) {
+                validateFeaturedTopicsBlock(block);
+            } else if ("video_tour".equals(type.asText())) {
+                validateVideoTourBlock(block);
+            } else if ("badges".equals(type.asText())) {
+                validateBadgesBlock(block);
+            } else if ("gallery".equals(type.asText())) {
+                JsonNode layout = block.get("layout");
+                if (layout != null && (!layout.isTextual()
+                        || !HOME_LAYOUT_GALLERY_LAYOUTS.contains(layout.asText()))) {
+                    throw new BizException(ErrorCode.PARAM_ERROR, "gallery layout 只能是 grid 或 masonry");
+                }
+            }
             JsonNode size = block.get("size");
             if (size != null && (!size.isNumber() || size.intValue() < HOME_LAYOUT_SIZE_MIN
                     || size.intValue() > HOME_LAYOUT_SIZE_MAX)) {
@@ -434,6 +491,14 @@ public class SiteService {
                     referencedIds.add(id.intValue());
                 }
             }
+            // people 区块（docs/20 D-7）：categoryId 单值，同走跨站注入防护
+            JsonNode categoryId = block.get("categoryId");
+            if (categoryId != null) {
+                if (!categoryId.isNumber() || categoryId.intValue() <= 0) {
+                    throw new BizException(ErrorCode.PARAM_ERROR, "首页布局 categoryId 必须为正整数");
+                }
+                referencedIds.add(categoryId.intValue());
+            }
         }
         if (!referencedIds.isEmpty()) {
             if (siteId == null) {
@@ -452,6 +517,181 @@ public class SiteService {
         }
     }
 
+    /** quick_links（v2 手册 §2.8 类型 A；docs/20 D-2 升级图标宫格）：items 必填、1~12 项，每项 {name ≤20 字, url 合法, icon 可选标识符} */
+    private void validateQuickLinksBlock(JsonNode block) {
+        JsonNode items = block.get("items");
+        if (items == null) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "quick_links 区块必须包含 items（入口列表）");
+        }
+        if (!items.isArray()) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "quick_links items 必须是数组");
+        }
+        if (items.size() == 0) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "quick_links items 至少 1 项");
+        }
+        if (items.size() > HOME_LAYOUT_MAX_QUICK_LINKS) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "quick_links items 不能超过 " + HOME_LAYOUT_MAX_QUICK_LINKS + " 项");
+        }
+        for (JsonNode item : items) {
+            if (!item.isObject()) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "quick_links items 每项必须是对象（{name, url}）");
+            }
+            JsonNode name = item.get("name");
+            if (name == null || !name.isTextual() || name.asText().trim().isEmpty()
+                    || name.asText().trim().length() > HOME_LAYOUT_MAX_LINK_NAME) {
+                throw new BizException(ErrorCode.PARAM_ERROR,
+                        "quick_links 项 name 须为不超过 " + HOME_LAYOUT_MAX_LINK_NAME + " 字的文本");
+            }
+            requireLayoutLink(item.get("url"), "quick_links 项");
+            JsonNode icon = item.get("icon");
+            if (icon != null && (!icon.isTextual() || icon.asText().isEmpty()
+                    || !HOME_LAYOUT_ICON_PATTERN.matcher(icon.asText()).matches())) {
+                throw new BizException(ErrorCode.PARAM_ERROR,
+                        "quick_links 项 icon 须为内置图标标识符（小写字母/数字/短横线，如 zhaosheng）");
+            }
+        }
+    }
+
+    /** notice_bar（v2 手册 §2.8 类型 B）：text 必填 ≤200 字；url 可选；level 可选且限 info/warn */
+    private void validateNoticeBarBlock(JsonNode block) {
+        JsonNode text = block.get("text");
+        if (text == null || !text.isTextual() || text.asText().trim().isEmpty()) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "notice_bar 区块必须填写 text（公告正文）");
+        }
+        if (text.asText().length() > HOME_LAYOUT_MAX_NOTICE_TEXT) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "notice_bar text 不能超过 " + HOME_LAYOUT_MAX_NOTICE_TEXT + " 字");
+        }
+        if (block.has("url")) {
+            requireLayoutLink(block.get("url"), "notice_bar");
+        }
+        JsonNode level = block.get("level");
+        if (level != null && (!level.isTextual() || !HOME_LAYOUT_NOTICE_LEVELS.contains(level.asText()))) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "notice_bar level 只能是 info 或 warn");
+        }
+    }
+
+    /** 区块内手填链接统一校验（quick_links 项 / notice_bar url / featured_topics ctaUrl / video_tour url） */
+    private void requireLayoutLink(JsonNode url, String what) {
+        if (url == null || !url.isTextual() || !HOME_LAYOUT_LINK_PATTERN.matcher(url.asText().trim()).matches()) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    what + " url 须为 http(s):// 地址或站内路径（/ 开头）");
+        }
+    }
+
+    /** 区块内图片资产校验（站点上传路径 / 开头或 http(s) 地址） */
+    private void requireLayoutAsset(JsonNode asset, String what) {
+        if (asset == null || !asset.isTextual() || !ASSET_PATTERN.matcher(asset.asText().trim()).matches()) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    what + " 须为站点上传路径（/ 开头）或 http(s) 地址");
+        }
+    }
+
+    /** stats_band（docs/20 D-1）：stats 数组 1~8 项，每项 {label ≤20, value ≤10, unit ≤10, icon 可选} */
+    private void validateStatsBandBlock(JsonNode block) {
+        JsonNode stats = block.get("stats");
+        if (stats == null || !stats.isArray() || stats.size() == 0) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "stats_band 区块必须填写 stats（统计项数组）");
+        }
+        if (stats.size() > HOME_LAYOUT_MAX_STATS) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "stats_band stats 不能超过 " + HOME_LAYOUT_MAX_STATS + " 项");
+        }
+        for (JsonNode item : stats) {
+            if (!item.isObject()) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "stats_band stats 每项必须是对象（{label, value, unit}）");
+            }
+            JsonNode label = item.get("label");
+            if (label == null || !label.isTextual() || label.asText().trim().isEmpty()
+                    || label.asText().trim().length() > 20) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "stats_band 项 label 须为不超过 20 字的文本");
+            }
+            JsonNode value = item.get("value");
+            if (value == null || !value.isTextual() || value.asText().trim().isEmpty()
+                    || value.asText().trim().length() > 10) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "stats_band 项 value 须为不超过 10 字的数字文本（如 3.2 万）");
+            }
+            JsonNode unit = item.get("unit");
+            if (unit != null && (!unit.isTextual() || unit.asText().length() > 10)) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "stats_band 项 unit 须为不超过 10 字的文本");
+            }
+            JsonNode icon = item.get("icon");
+            if (icon != null && (!icon.isTextual() || icon.asText().isEmpty()
+                    || !HOME_LAYOUT_ICON_PATTERN.matcher(icon.asText()).matches())) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "stats_band 项 icon 须为内置图标标识符");
+            }
+        }
+    }
+
+    /** featured_topics（docs/20 D-3）：items 1~6 项，每项 {title ≤50, description ≤200, image 资产, ctaText ≤20, ctaUrl 链接} */
+    private void validateFeaturedTopicsBlock(JsonNode block) {
+        JsonNode items = block.get("items");
+        if (items == null || !items.isArray() || items.size() == 0) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "featured_topics 区块必须填写 items（专题卡数组）");
+        }
+        if (items.size() > HOME_LAYOUT_MAX_TOPICS) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "featured_topics items 不能超过 " + HOME_LAYOUT_MAX_TOPICS + " 项");
+        }
+        for (JsonNode item : items) {
+            if (!item.isObject()) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "featured_topics items 每项必须是对象");
+            }
+            JsonNode title = item.get("title");
+            if (title == null || !title.isTextual() || title.asText().trim().isEmpty()
+                    || title.asText().trim().length() > 50) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "featured_topics 项 title 须为不超过 50 字的文本");
+            }
+            JsonNode description = item.get("description");
+            if (description != null && (!description.isTextual() || description.asText().length() > 200)) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "featured_topics 项 description 不能超过 200 字");
+            }
+            requireLayoutAsset(item.get("image"), "featured_topics 项 image");
+            JsonNode ctaText = item.get("ctaText");
+            if (ctaText != null && (!ctaText.isTextual() || ctaText.asText().length() > 20)) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "featured_topics 项 ctaText 不能超过 20 字");
+            }
+            if (item.has("ctaUrl")) {
+                requireLayoutLink(item.get("ctaUrl"), "featured_topics 项");
+            }
+        }
+    }
+
+    /** video_tour（docs/20 D-5）：cover 资产 + url 链接 + title ≤100 */
+    private void validateVideoTourBlock(JsonNode block) {
+        requireLayoutAsset(block.get("cover"), "video_tour cover");
+        requireLayoutLink(block.get("url"), "video_tour");
+    }
+
+    /** badges（docs/20 D-9）：badgeItems 1~8 项，每项 {label ≤20, desc ≤50, image 资产}
+     *  （键名与前端 cleanBlock 序列化一致——避免与 quick_links/featured_topics 的 items 语义混淆） */
+    private void validateBadgesBlock(JsonNode block) {
+        JsonNode items = block.get("badgeItems");
+        if (items == null || !items.isArray() || items.size() == 0) {
+            throw new BizException(ErrorCode.PARAM_ERROR, "badges 区块必须填写 items（徽章数组）");
+        }
+        if (items.size() > HOME_LAYOUT_MAX_BADGES) {
+            throw new BizException(ErrorCode.PARAM_ERROR,
+                    "badges items 不能超过 " + HOME_LAYOUT_MAX_BADGES + " 项");
+        }
+        for (JsonNode item : items) {
+            if (!item.isObject()) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "badges items 每项必须是对象");
+            }
+            JsonNode label = item.get("label");
+            if (label == null || !label.isTextual() || label.asText().trim().isEmpty()
+                    || label.asText().trim().length() > 20) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "badges 项 label 须为不超过 20 字的文本");
+            }
+            JsonNode desc = item.get("desc");
+            if (desc != null && (!desc.isTextual() || desc.asText().length() > 50)) {
+                throw new BizException(ErrorCode.PARAM_ERROR, "badges 项 desc 不能超过 50 字");
+            }
+            requireLayoutAsset(item.get("image"), "badges 项 image");
+        }
+    }
+
     /**
      * custom_css 校验（B3，服务端强校验）：长度 ≤10240；黑名单忽略大小写拒绝
      * {@code </style}（逃逸内联 style 块）、{@code <script}、{@code @import}（外链样式注入）、

src/main/java/com/yunhai/cms/svcitem/config/OpenApiAuthEnforceConfiguration.java

@@ -1,49 +0,0 @@
-package com.yunhai.cms.svcitem.config;
-
-import com.yunhai.platform.appauth.AppAuthFilter;
-import org.springframework.boot.web.servlet.FilterRegistrationBean;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.core.Ordered;
-
-import javax.servlet.Filter;
-import javax.servlet.FilterChain;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-import java.io.IOException;
-
-/**
- * 开放接口签名强制（事项库详细设计 §3.4，照 UserBase OpenApiAuthEnforceConfiguration 范式）：
- * yh-app-auth 的 {@link AppAuthFilter}（order +10，全路由）设计为「无签名头则放行」以兼容浏览器
- * CAS 流；本过滤器（order +11）只挂 /oapi/**，校验其写入的请求属性——已验签放行，否则 401。
- * CMS 的 /oapi/** 无用户会话语义，一律应用签名（X-App-Key/X-Timestamp/X-Signature 三件套）。
- */
-@Configuration
-public class OpenApiAuthEnforceConfiguration {
-
-    @Bean
-    public FilterRegistrationBean<RequireAppSignFilter> requireAppSignFilter() {
-        FilterRegistrationBean<RequireAppSignFilter> bean = new FilterRegistrationBean<>();
-        bean.setFilter(new RequireAppSignFilter());
-        bean.addUrlPatterns("/oapi/*");
-        bean.setOrder(Ordered.HIGHEST_PRECEDENCE + 11);
-        return bean;
-    }
-
-    public static class RequireAppSignFilter implements Filter {
-        @Override
-        public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
-                throws IOException, ServletException {
-            HttpServletRequest req = (HttpServletRequest) request;
-            HttpServletResponse res = (HttpServletResponse) response;
-            if (req.getAttribute(AppAuthFilter.APP_AUTH_ATTR) == null) {
-                res.sendError(HttpServletResponse.SC_UNAUTHORIZED, "missing app signature");
-                return;
-            }
-            chain.doFilter(request, response);
-        }
-    }
-}

src/main/java/com/yunhai/cms/svcitem/service/impl/SvcHallClient.java

@@ -15,7 +15,7 @@ import java.util.Map;
 
 /**
  * 办事大厅开放接口客户端（V2.0 Part C.3）：经 SDK {@link YschOpenCall} 命名目标
- * {@code svchall}（服务目录 {@code yh.open.services.svchall}）调 svc-hall {@code /oapi/svc/**}；
+ * {@code svc-hall}（服务目录 {@code yh.open.services.svc-hall}）调 svc-hall {@code /oapi/svc/**}；
  * 出站签名/信封解包/错误映射全部由 SDK 承载——本应用零专属地址配置
  * （《子应用配置优化方案》§4.2）。<br><br>
  * <b>为何不能再用共享 {@code IDHttp}</b>：svc-hall 带 context-path {@code /svc-hall}，而共享
@@ -26,7 +26,7 @@ import java.util.Map;
  * <b>错误语义</b>：业务失败信封 {@code code!=0} → {@code DException}（携带 OpenApiErrorCode，
  * 办事大厅"不存在/未发布"= code 2）；传输/HTTP 失败 → {@code OpenApiException}；401/403 →
  * {@code DException("验签失败")}。降级判定见 {@code SvcItemRemoteQuery}。<br><br>
- * 目录未显式配置时回落 legacy {@code yh.svchall.base-url}（迁移期兼容）；两者皆无则构造期
+ * 目录未显式配置时回落 legacy {@code yh.svc-hall.base-url}（迁移期兼容）；两者皆无则构造期
  * fail-fast——不给"沉默连不上 localhost"的假象。
  */
 @Component
@@ -35,9 +35,9 @@ public class SvcHallClient {
     private static final Logger log = LoggerFactory.getLogger(SvcHallClient.class);
 
     /** 服务目录命名目标（svc-hall 未晋升 PlatformService 枚举，按名直调） */
-    static final String DIRECTORY_KEY = "svchall";
+    static final String DIRECTORY_KEY = "svc-hall";
 
-    private static final String LEGACY_KEY = "yh.svchall.base-url";
+    private static final String LEGACY_KEY = "yh.svc-hall.base-url";
 
     private final YschOpenCall openCall;
     private final IDHttp http;
@@ -46,7 +46,7 @@ public class SvcHallClient {
 
     public SvcHallClient(YschOpenCall openCall,
                          IDHttp http,
-                         @Value("${yh.svchall.base-url:}") String baseUrl) {
+                         @Value("${yh.svc-hall.base-url:}") String baseUrl) {
         this.openCall = openCall;
         this.http = http;
         this.directoryResolved = openCall != null && openCall.hasTarget(DIRECTORY_KEY);

src/main/java/com/yunhai/cms/theme/ThemeInfo.java

@@ -36,6 +36,13 @@ public class ThemeInfo {
 
     private List<ThemeParam> params = new ArrayList<>();
 
+    /**
+     * 包级参数值（工作项 T：参数微调从站点级上移为皮肤包级）。
+     * 值不写 jar 内 theme.json，一律落 {@code {cms.theme.dir}/.meta/{name}.json} 覆盖层，
+     * 由 {@link ThemeRegistry#applyMetaOverride} 在装载时叠加；缺项回落 params[].defaultValue。
+     */
+    private Map<String, String> paramValues = new LinkedHashMap<>();
+
     public String screenshotPath() {
         return screenshot == null || screenshot.isEmpty() ? "assets/screenshot.png" : screenshot;
     }

src/main/java/com/yunhai/cms/theme/ThemePackageService.java

@@ -24,6 +24,7 @@ import java.util.Arrays;
 import java.util.Comparator;
 import java.util.HashSet;
 import java.util.List;
+import java.util.Map;
 import java.util.Set;
 import java.util.regex.Pattern;
 import java.util.zip.ZipEntry;
@@ -306,6 +307,7 @@ public class ThemePackageService {
                 root.put("description", description);
             }
             Files.write(json, mapper.writerWithDefaultPrettyPrinter().writeValueAsBytes(root));
+            copyMetaParamValues(sourceName, newName);
             themeRegistry.reload();
             publishThemeChanged();
             log.info("皮肤包 {} 派生为 {}（外部包）", sourceName, newName);
@@ -318,6 +320,28 @@ public class ThemePackageService {
         }
     }
 
+    /**
+     * 派生时复制源包的 paramValues（v1 §3.4）：参数值存 <code>.meta/{name}.json</code> 覆盖层、
+     * 不在包目录内，复制包体天然带不过去 → 不显式带则新包回落 theme.json 默认值，
+     * "复制包做差异化" 就得重调一遍参数。仅复制 paramValues 节点（title/description 由派生表单写入新包 theme.json）。
+     */
+    private void copyMetaParamValues(String sourceName, String newName) throws IOException {
+        Path source = Paths.get(themeDir, ".meta", sourceName + ".json");
+        if (!Files.isRegularFile(source)) {
+            return;
+        }
+        com.fasterxml.jackson.databind.ObjectMapper mapper = new com.fasterxml.jackson.databind.ObjectMapper();
+        com.fasterxml.jackson.databind.JsonNode values = mapper.readTree(source.toFile()).path("paramValues");
+        if (!values.isObject() || values.size() == 0) {
+            return;
+        }
+        Path target = Paths.get(themeDir, ".meta", newName + ".json");
+        Files.createDirectories(target.getParent());
+        com.fasterxml.jackson.databind.node.ObjectNode root = mapper.createObjectNode();
+        root.set("paramValues", values);
+        Files.write(target, mapper.writerWithDefaultPrettyPrinter().writeValueAsBytes(root));
+    }
+
     /** 内置包（可能在 jar 内）复制：PathMatchingResourcePatternResolver 遍历其全部资源 */
     private void copyClasspathPackage(String sourceName, Path target) throws IOException {
         PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
@@ -354,9 +378,25 @@ public class ThemePackageService {
     /**
      * 元数据编辑（任务四放开内置包）：外部包直写 theme.json；内置包 theme.json 在 jar 内只读，
      * 显示名/描述写 {@link ThemeRegistry} 的 .meta 覆盖层。内容（模板/资产）两种来源都不可经此修改。
+     * 兼容签名：不改包级参数值。
      */
     public ThemeInfo updateMeta(BoaUser user, String name, String title, String description,
                                 List<ThemeParam> params) {
+        return updateMeta(user, name, title, description, params, null);
+    }
+
+    /**
+     * 元数据 + 包级参数值编辑（工作项 T：参数微调从站点级迁到皮肤包级）。
+     *
+     * <p>title/description/params 语义与任务四一致（内置包 schema 拒改）；{@code paramValues} 则
+     * <b>内置包与外部包统一写 .meta 覆盖层</b>——值不属于包体内容，包体（theme.json + 模板 + 资产）
+     * 保持只读语义不变，「同包不同配色」的差异化仍由复制皮肤包承担。
+     *
+     * @param paramValues null=不改；非 null=整体替换（空 Map=清空、恢复 theme.json 默认值）；
+     *                    未声明 key 与非法值按包 schema 丢弃（同批改 schema 时以新 schema 为准）
+     */
+    public ThemeInfo updateMeta(BoaUser user, String name, String title, String description,
+                                List<ThemeParam> params, Map<String, String> paramValues) {
         requireSuperAdmin(user);
         if (!themeRegistry.contains(name)) {
             throw new BizException(ErrorCode.PARAM_ERROR, "皮肤包未注册：" + name);
@@ -365,6 +405,15 @@ public class ThemePackageService {
         if (!external && params != null) {
             throw new BizException(ErrorCode.PARAM_ERROR, "内置包参数 schema 不可修改（仅显示名称/描述可改）");
         }
+        Map<String, String> filteredValues = null;
+        if (paramValues != null) {
+            ThemeInfo schema = themeRegistry.get(name);
+            if (external && params != null) {
+                schema = new ThemeInfo();
+                schema.setParams(params);
+            }
+            filteredValues = schema.filterValidValues(paramValues);
+        }
         try {
             if (external) {
                 Path json = Paths.get(themeDir, name, "theme.json");
@@ -388,8 +437,11 @@ public class ThemePackageService {
                     root.set("params", mapper.valueToTree(params));
                 }
                 Files.write(json, mapper.writerWithDefaultPrettyPrinter().writeValueAsBytes(root));
+                if (filteredValues != null) {
+                    writeMetaOverride(name, null, null, filteredValues);
+                }
             } else {
-                writeBuiltinMetaOverride(name, title, description);
+                writeMetaOverride(name, title, description, filteredValues);
             }
             themeRegistry.reload();
             publishThemeChanged();
@@ -402,12 +454,16 @@ public class ThemePackageService {
     }
 
     /**
-     * 内置包元数据覆盖层写入（任务四）：title/description 全空 = 删除覆盖层（恢复默认），
-     * 否则合并写入 {themeDir}/.meta/{name}.json（title 空且 description 非空时保留已有 title）。
+     * .meta 覆盖层写入：title/description/paramValues 合并进 {themeDir}/.meta/{name}.json。
+     * 三者全空且未提交 paramValues（即任务四的"恢复默认"手势）→ 删除覆盖层；
+     * 显式提交空 paramValues 只摘掉 paramValues 节点，保留覆盖层里既有的 title/description。
      */
-    private void writeBuiltinMetaOverride(String name, String title, String description) throws IOException {
+    private void writeMetaOverride(String name, String title, String description,
+                                   Map<String, String> paramValues) throws IOException {
         Path overlay = Paths.get(themeDir, ".meta", name + ".json");
-        if (!StringUtils.hasText(title) && (description == null || description.trim().isEmpty())) {
+        boolean noTitle = !StringUtils.hasText(title);
+        boolean noDesc = description == null || description.trim().isEmpty();
+        if (noTitle && noDesc && paramValues == null) {
             try {
                 Files.deleteIfExists(overlay);
             } catch (IOException e) {
@@ -433,6 +489,13 @@ public class ThemePackageService {
         if (description != null) {
             root.put("description", description);
         }
+        if (paramValues != null) {
+            if (paramValues.isEmpty()) {
+                root.remove("paramValues");
+            } else {
+                root.set("paramValues", mapper.valueToTree(paramValues));
+            }
+        }
         Files.createDirectories(overlay.getParent());
         Files.write(overlay, mapper.writerWithDefaultPrettyPrinter().writeValueAsBytes(root));
     }

src/main/java/com/yunhai/cms/theme/ThemePackageValidator.java

@@ -1,22 +1,40 @@
 package com.yunhai.cms.theme;
 
+import java.util.ArrayList;
+import java.util.HashSet;
 import java.util.List;
+import java.util.Set;
+import java.util.function.Function;
 import java.util.function.Predicate;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
 
 /**
  * 主题包规范校验（W1 重构点，方案 §5.5：校验语义收敛于本类，Registry 与 PackageService 共用，
  * 杜绝两套校验漂移）。原 ThemeRegistry.validate 的规则原文平移：
  * specVersion=1、name 规范、name=目录名、必备模板（home/list/detail/single）、
- * fragments/head.html、param 规范、screenshot 存在。
- * existsFn 判定资源存在：classpath 包用 ClassPathResource、外部包用 Files.exists（§5.4 步骤 1）。
+ * fragments/head.html、首页区块引用一致性（§2.5 坑⑤）、param 规范、screenshot 存在。
+ * existsFn 判定资源存在：classpath 包用 ClassPathResource、外部包用 Files.exists（§5.4 步骤 1）；
+ * readFn 读资源文本（UTF-8），读不到返回 null（不臆断，交由存在性校验与模板引擎兜底）。
  */
 public final class ThemePackageValidator {
 
+    /** 本包首页区块模板（自研形态承载体） */
+    private static final String HOME_BLOCKS = "fragments/home-blocks.html";
+
+    /** Thymeleaf 模板引用对：~{<路径表达式> :: <fragment>( */
+    private static final Pattern TEMPLATE_REF =
+            Pattern.compile("~\\{([\\s\\S]*?)\\s*::\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*\\(");
+
+    /** fragment 定义：th:fragment="name(...)"（空格/逗号分隔的多签名一律取标识符） */
+    private static final Pattern FRAGMENT_DEF = Pattern.compile("th:fragment\\s*=\\s*\"([^\"]*)\"");
+
     private ThemePackageValidator() {
     }
 
     /** 校验不通过抛 IllegalArgumentException（bad package 语义，Registry 剔除 + log.warn） */
-    public static void validate(ThemeInfo info, String dirName, Predicate<String> existsFn) {
+    public static void validate(ThemeInfo info, String dirName, Predicate<String> existsFn,
+                                Function<String, String> readFn) {
         if (info == null) {
             throw new IllegalArgumentException("清单为空");
         }
@@ -38,6 +56,7 @@ public final class ThemePackageValidator {
         if (!existsFn.test("fragments/head.html")) {
             throw new IllegalArgumentException("缺 fragments/head.html 公共片段");
         }
+        validateHomeBlockFragmentRefs(dirName, readFn);
         validateParams(info);
         String shot = info.screenshotPath();
         if (!existsFn.test(shot)) {
@@ -72,4 +91,75 @@ public final class ThemePackageValidator {
             }
         }
     }
+
+    /**
+     * 首页区块门禁（v2 手册 §2.5 坑⑤）：home-blocks **不是**包的必需项——B 档包整段走
+     * themes/common 兜底骨架属正常形态，强制"8 形态齐全"会把它们剔除并静默回落 default（重大事故）。
+     * 只校验**引用一致性**：home.html 每把一种形态分发给本包 fragments/home-blocks
+     * （${themeBase} 拼接或 themes/&lt;目录名&gt;/ 字面两种写法），该文件就必须存在并定义被引用的
+     * fragment，否则门户首页渲染整页 500。缺项清单写进异常消息，由 Registry 剔除分支 log.warn 带出。
+     */
+    static void validateHomeBlockFragmentRefs(String dirName, Function<String, String> readFn) {
+        String home = readFn.apply("home.html");
+        if (home == null || home.isEmpty()) {
+            return;
+        }
+        List<String> referenced = ownHomeBlockRefs(home, dirName);
+        if (referenced.isEmpty()) {
+            return;
+        }
+        String blocks = readFn.apply(HOME_BLOCKS);
+        if (blocks == null) {
+            throw new IllegalArgumentException("home.html 把区块分发给本包 " + HOME_BLOCKS
+                    + "，但该文件不存在（引用形态：" + join(referenced) + "）");
+        }
+        Set<String> defined = fragmentNamesOf(blocks);
+        List<String> missing = new ArrayList<>();
+        for (String name : referenced) {
+            if (!defined.contains(name)) {
+                missing.add(name);
+            }
+        }
+        if (!missing.isEmpty()) {
+            throw new IllegalArgumentException("本包 " + HOME_BLOCKS + " 缺 fragment 定义：" + join(missing)
+                    + "（home.html 已引用这些形态，门户首页渲染会整页 500）");
+        }
+    }
+
+    /** home.html 中指向**本包** home-blocks 的 fragment 名（按出现顺序去重；common 兜底引用不计入） */
+    static List<String> ownHomeBlockRefs(String homeHtml, String dirName) {
+        List<String> names = new ArrayList<>();
+        Matcher matcher = TEMPLATE_REF.matcher(homeHtml);
+        while (matcher.find()) {
+            String target = matcher.group(1);
+            if (!target.contains("/fragments/home-blocks") || target.contains("themes/common/")) {
+                continue;
+            }
+            boolean ownPackage = target.contains("themeBase") || target.contains("themes/" + dirName + "/");
+            String fragment = matcher.group(2);
+            if (ownPackage && !names.contains(fragment)) {
+                names.add(fragment);
+            }
+        }
+        return names;
+    }
+
+    /** 模板文本内声明的全部 fragment 名 */
+    static Set<String> fragmentNamesOf(String templateText) {
+        Set<String> names = new HashSet<>();
+        Matcher matcher = FRAGMENT_DEF.matcher(templateText);
+        while (matcher.find()) {
+            for (String signature : matcher.group(1).trim().split("[\\s,]+")) {
+                String name = signature.split("\\(")[0].trim();
+                if (!name.isEmpty()) {
+                    names.add(name);
+                }
+            }
+        }
+        return names;
+    }
+
+    private static String join(List<String> names) {
+        return String.join("、", names);
+    }
 }

src/main/java/com/yunhai/cms/theme/ThemeParam.java

@@ -5,6 +5,7 @@ import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Data;
 
 import java.util.List;
+import java.util.Map;
 import java.util.regex.Pattern;
 
 /**
@@ -47,6 +48,13 @@ public class ThemeParam {
 
     private List<Option> options;
 
+    /**
+     * docs/20 E（colorScheme 配色预设）：select 参数可携带「选项值 → CSS 变量组」映射——
+     * 选中某选项时整组变量并入 :root{}（值逐一过 COLOR_PATTERN，非法丢弃）。
+     * 供伪主题合并：色皮档 4 套并 default、骨架克隆档 6 套并 scholar-blue。
+     */
+    private Map<String, Map<String, String>> presets;
+
     /** 值是否合法（按参数类型；null/空一律不合法，方案 §5.3） */
     public boolean isValidValue(String value) {
         if (value == null || value.isEmpty()) {

src/main/java/com/yunhai/cms/theme/ThemeRegistry.java

@@ -9,9 +9,12 @@ import org.springframework.core.io.FileSystemResource;
 import org.springframework.core.io.Resource;
 import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
 import org.springframework.stereotype.Component;
+import org.springframework.util.StreamUtils;
 
 import javax.annotation.PostConstruct;
 import java.io.IOException;
+import java.io.InputStream;
+import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
@@ -41,6 +44,44 @@ public class ThemeRegistry {
     public static final String SOURCE_BUILTIN = "builtin";
     public static final String SOURCE_EXTERNAL = "external";
 
+    /**
+     * docs/20 E（激进清场）下架主题别名表：原主题名 → [保留主题, colorScheme 预设值]。
+     * 存量站点 theme 仍写下架名时按本表解析（R-46：门户不断渲染，不 404）；
+     * 站点下次保存时由 SiteService 归一化为保留主题 + config.theme_params.colorScheme。
+     */
+    private static final java.util.Map<String, String[]> DEPRECATED_ALIASES = java.util.Collections.unmodifiableMap(
+            new java.util.LinkedHashMap<String, String[]>() {{
+                // 色皮档 4 套 → default 预设
+                put("blue-white", new String[] {DEFAULT_THEME, "blue-white"});
+                put("classic-red", new String[] {DEFAULT_THEME, "classic-red"});
+                put("fresh-mint", new String[] {DEFAULT_THEME, "fresh-mint"});
+                put("warm-kinder", new String[] {DEFAULT_THEME, "warm-kinder"});
+                // 骨架克隆档 6 套 → scholar-blue 预设
+                put("academic-navy", new String[] {"scholar-blue", "navy"});
+                put("campus-azure", new String[] {"scholar-blue", "azure"});
+                put("poly-blue", new String[] {"scholar-blue", "poly"});
+                put("agri-forest", new String[] {"scholar-blue", "agri"});
+                put("jade-normal", new String[] {"scholar-blue", "jade"});
+                put("mint-breeze", new String[] {"scholar-blue", "mint"});
+            }});
+
+    /** 下架别名解析结果：target=保留主题名；colorScheme=对应预设值（可能为 null） */
+    public static final class AliasInfo {
+        public final String target;
+        public final String colorScheme;
+
+        AliasInfo(String target, String colorScheme) {
+            this.target = target;
+            this.colorScheme = colorScheme;
+        }
+    }
+
+    /** 下架别名解析：非别名返回 null */
+    public static AliasInfo aliasOf(String name) {
+        String[] mapped = name == null ? null : DEPRECATED_ALIASES.get(name);
+        return mapped == null ? null : new AliasInfo(mapped[0], mapped[1]);
+    }
+
     /** 包名与目录名约束（方案 §4.1） */
     private static final Pattern NAME_PATTERN = Pattern.compile("^[a-z][a-z0-9-]{1,30}[a-z0-9]$");
 
@@ -113,8 +154,9 @@ public class ThemeRegistry {
             String dirName = dirNameOf(resource);
             try {
                 ThemeInfo info = MAPPER.readValue(resource.getInputStream(), ThemeInfo.class);
-                ThemePackageValidator.validate(info, dirName, rel ->
-                        new ClassPathResource("templates/themes/" + dirName + "/" + rel).exists());
+                ThemePackageValidator.validate(info, dirName,
+                        rel -> new ClassPathResource("templates/themes/" + dirName + "/" + rel).exists(),
+                        rel -> readClasspath("templates/themes/" + dirName + "/" + rel));
                 applyMetaOverride(info);
                 loaded.put(info.getName(), info);
                 loadedSources.put(info.getName(), SOURCE_BUILTIN);
@@ -130,7 +172,9 @@ public class ThemeRegistry {
             Path json = pkg.resolve("theme.json");
             try {
                 ThemeInfo info = MAPPER.readValue(json.toFile(), ThemeInfo.class);
-                ThemePackageValidator.validate(info, dirName, rel -> Files.exists(pkg.resolve(rel)));
+                ThemePackageValidator.validate(info, dirName,
+                        rel -> Files.exists(pkg.resolve(rel)),
+                        rel -> readTextFile(pkg.resolve(rel)));
                 if (loaded.containsKey(info.getName())) {
                     log.warn("外部主题包 {} 与内置包同名，忽略外部包（内置只读、优先，D1）", dirName);
                     continue;
@@ -222,6 +266,24 @@ public class ThemeRegistry {
         return REQUIRED_TEMPLATES;
     }
 
+    /** 读 classpath 包内文本（UTF-8）；读不到返回 null（区块门禁据此跳过，不臆断） */
+    private static String readClasspath(String location) {
+        try (InputStream in = new ClassPathResource(location).getInputStream()) {
+            return StreamUtils.copyToString(in, StandardCharsets.UTF_8);
+        } catch (IOException e) {
+            return null;
+        }
+    }
+
+    /** 读外部包内文本（UTF-8）；读不到返回 null */
+    private static String readTextFile(Path file) {
+        try {
+            return new String(Files.readAllBytes(file), StandardCharsets.UTF_8);
+        } catch (IOException e) {
+            return null;
+        }
+    }
+
     // ===== 资源定位 =====
 
     /** classpath 内置包扫描（protected：测试可屏蔽以构造外部-only 场景，T-W1-04） */
@@ -235,8 +297,8 @@ public class ThemeRegistry {
     }
 
     /**
-     * 元数据覆盖层（任务四）：包加载后读 {themeDir}/.meta/{name}.json 覆写 title/description——
-     * 内置包 theme.json 在 jar 内只读，显示名/描述改名走此通道；损坏的覆盖层忽略（按原始元数据注册）。
+     * 元数据覆盖层（任务四）：包加载后读 {themeDir}/.meta/{name}.json 覆写 title/description/paramValues——
+     * 内置包 theme.json 在 jar 内只读，显示名/描述改名与包级参数值均走此通道；损坏的覆盖层忽略（按原始元数据注册）。
      */
     private void applyMetaOverride(ThemeInfo info) {
         if (themeDir == null || themeDir.isEmpty() || info.getName() == null) {
@@ -254,11 +316,26 @@ public class ThemeRegistry {
             if (meta.getDescription() != null) {
                 info.setDescription(meta.getDescription());
             }
+            if (meta.getParamValues() != null && !meta.getParamValues().isEmpty()) {
+                info.setParamValues(new LinkedHashMap<>(meta.getParamValues()));
+            }
         } catch (Exception e) {
             log.warn("元数据覆盖层 {} 读取失败，按原始元数据注册：{}", overrideFile, e.getMessage());
         }
     }
 
+    /**
+     * 包级参数值（工作项 T）：主题不存在返回空 Map（调用方免判空）。
+     * 返回不可变视图——参数值的唯一写入口是 {@code ThemePackageService.updateMeta}。
+     */
+    public Map<String, String> paramValuesOf(String name) {
+        ThemeInfo info = name == null ? null : themes.get(name);
+        if (info == null || info.getParamValues() == null) {
+            return java.util.Collections.emptyMap();
+        }
+        return java.util.Collections.unmodifiableMap(info.getParamValues());
+    }
+
     /** W1：外部目录包扫描（themeDir 下各包的 theme.json；目录不存在视为空） */
     protected List<Path> scanExternalPackages() {        List<Path> packages = new ArrayList<>();
         if (themeDir == null || themeDir.isEmpty()) {

src/main/java/com/yunhai/cms/theme/ThemeVarsCss.java

@@ -23,15 +23,23 @@ public final class ThemeVarsCss {
         }
         StringBuilder sb = new StringBuilder(":root{");
         for (ThemeParam p : theme.getParams()) {
-            if (!p.isCssVarParam()) {
-                continue;
-            }
             String value = params.get(p.getKey());
-            // 双重校验（方案 §9 注入面）：入口已过滤，此处仍只拼通过 color 正则的值
             if (value == null || !p.isValidValue(value)) {
                 continue;
             }
-            sb.append(p.getCssVar()).append(':').append(value).append(';');
+            if (p.isCssVarParam()) {
+                // 双重校验（方案 §9 注入面）：入口已过滤，此处仍只拼通过 color 正则的值
+                sb.append(p.getCssVar()).append(':').append(value).append(';');
+            } else if (p.getPresets() != null && p.getPresets().containsKey(value)) {
+                // docs/20 E：select 参数携带 presets（colorScheme → 变量组）时，选中值对应的
+                // 整组变量并入输出（每个值仍过 COLOR_PATTERN，非法丢弃——注入面与 color 参数同标）
+                p.getPresets().get(value).forEach((cssVar, color) -> {
+                    if (cssVar != null && cssVar.matches("^--[a-zA-Z][\\w-]*$")
+                            && color != null && ThemeParam.COLOR_PATTERN.matcher(color).matches()) {
+                        sb.append(cssVar).append(':').append(color).append(';');
+                    }
+                });
+            }
         }
         return sb.length() == 6 ? "" : sb.append('}').toString();
     }

src/main/java/com/yunhai/cms/utils/SvcHallLinks.java

@@ -0,0 +1,44 @@
+package com.yunhai.cms.utils;
+
+import java.io.UnsupportedEncodingException;
+import java.net.URLEncoder;
+
+/**
+ * 「我要办理」深链构造器（T4 回跳闭环，2026-10-03 执行方案）。
+ * 纯函数无状态：base 尾斜杠裁剪、参数 UTF-8 urlencode、from 缺省不追加。
+ */
+public final class SvcHallLinks {
+
+    private SvcHallLinks() {
+    }
+
+    /**
+     * 「我要办理」深链（双端契约：hall/src/router/routes.ts 依赖此形态，改参数名两侧同步）。
+     *
+     * @param base     svc-hall hall 部署基地址（站点 svc_hall_base，尾斜杠容忍）
+     * @param siteCode 站点编码
+     * @param itemCode 事项编码
+     * @param fromUrl  指南页绝对 URL（回跳地址；null/空=不追加 from 段，hall 不显示返回门户）
+     */
+    public static String build(String base, String siteCode, String itemCode, String fromUrl) {
+        String url = trimTail(base) + "/#/apply?siteCode=" + enc(siteCode)
+                + "&itemCode=" + enc(itemCode);
+        return fromUrl == null || fromUrl.isEmpty() ? url : url + "&from=" + enc(fromUrl);
+    }
+
+    private static String trimTail(String url) {
+        String s = url == null ? "" : url.trim();
+        while (s.endsWith("/")) {
+            s = s.substring(0, s.length() - 1);
+        }
+        return s;
+    }
+
+    private static String enc(String value) {
+        try {
+            return URLEncoder.encode(value, "UTF-8");
+        } catch (UnsupportedEncodingException e) {
+            return value;
+        }
+    }
+}

src/main/resources/application.yml

@@ -60,8 +60,18 @@ yh:
     # UserBase 注册后分配（进白名单），与 yh.open 保持一致；生产由 projman 注入
     app-key: 100005
     app-secret: 2c7885de594742cc840b8762910b2d2e
-    # 入站验签白名单：办事大厅 svc-hall（站点目录 /oapi/site/list 消费方，appKey=100018；
-    # P0-1 修复）。secret 与 svc-hall application.yml yh.app-auth.app-secret 逐字一致（联调态），
+    # 提供方强制验签（两级模型 §4.1，flow-center/Notice 同款）：本地 svcitem/config/
+    # OpenApiAuthEnforceConfiguration 副本已删（2026-10-05），换此一行——/oapi/**（站点目录
+    # /oapi/site/list）无签名三件套即 401（starter 版 RequireAppSignFilter，order +11 行为等价）
+    server:
+      enforce-patterns: [/oapi/*]
+    # 中央密钥链（两级模型 §4.2）：trusted-apps 先（确定性兜底），未命中走 SignKeyResolver
+    # （Redis sign:app:* → Caffeine → UserBase 兜底端点）——任何在 UserBase 注册过的 appKey
+    # 自动可验。需 data-redis 编译期依赖（yh-app-auth 侧 optional 不传递，pom 已提升 scope）
+    trust-registry: true
+    # 入站验签白名单（组合链第一层，Redis 停摆时确定性工作）：办事大厅 svc-hall
+    # （站点目录 /oapi/site/list 消费方，appKey=100018；P0-1 修复）。
+    # secret 与 svc-hall application.yml yh.app-auth.app-secret 逐字一致（联调态），
     # 生产两侧由 projman/Nacos 注入同一密钥对
     trusted-apps:
       "100018": "svc-hall-dev-secret-100018"
@@ -74,11 +84,11 @@ yh:
     # per-target base-path 与提供方 context-path 对齐 → 签名天然一致）。
     # 容器直连形态（生产）：http://svc-hall-service:10007/svc-hall（网关无 /oapi 路由）。
     services:
-      svchall: http://localhost:8086
+      svc-hall: http://localhost:8086
   # 办事大厅（svc-hall）对接（V2.0 Part C.3）：门户 service/guide 数据源。
   # 双向信任：CMS 出站签名用 yh.app-auth 身份（appKey=100005，办事大厅侧须在 UserBase
   # 注册表内可用）；入站收 svc-hall 站点目录调用（appKey=100018，见上方 trusted-apps）。
-  # 地址不再单独配置：见上方 yh.open.services.svchall（原 yh.svchall.base-url 已删）。
+  # 地址不再单独配置：见上方 yh.open.services.svc-hall（私有 legacy 回落键已随 D1 目录键归一同步改名）。
   # env-config 管理端运行时配置（免登录 GET /api/env-config?target=admin，数据源见
   # config/PropertyEnvConfigSource：聚合 starter 自动装配，有 bean 即注册端点）。
   # 本地无需配值（前端 dev 走 .env.dev）；线上值经环境变量 YH_ENV_CONFIG_SOURCE_ADMIN
@@ -104,7 +114,7 @@ cms:
     item:
       # 【V2.0 拆分遗留说明】事项库已迁独立"办事大厅"应用（svc-hall），CMS 侧 SvcItemQuery
       # 由 SvcItemRemoteQuery 经 oapi 调办事大厅；本配置已废弃（部门口径归办事大厅
-      # svchall.item.dept-group-type）。保留注释防误解。
+      # svc-hall.item.dept-group-type）。保留注释防误解。
       dept-group-type: 7
 
 
@@ -120,6 +130,11 @@ management:
   endpoint:
     health:
       show-details: never
+  # 密钥链验签依赖 Redis（sign:app:*）。关掉 Redis 健康指标：Redis 抖动不应把 /actuator/health
+  # 拉成 DOWN(503)，否则部署健康检查与探活会误判整机不可用（Notice/flow-center/svc-hall 同口径）
+  health:
+    redis:
+      enabled: false
 
 # 文件上传（同 UserHome 双 key 约定，方案 §7.3）
 # FILE_WEB_PATH 只接受相对路径（默认 /cms/upload/，含 context-path）或公网可达绝对地址；

src/main/resources/sql/docs20_home_components.sql

@@ -0,0 +1,31 @@
+-- ============================================================
+-- docs/20 D-3/D-6/D-7：首页新组件库数据结构变更（DDL 供 DBA 审阅，不自动执行）
+-- 日期：2026-09-28
+-- 说明：应用侧由 JPA ddl-auto=update 自动建列/建表；本脚本为生产发布前
+--       人工变更单底稿。执行前请备份相关表。
+-- ============================================================
+
+-- ① cms_banner 扩展列（D-3 专题大卡位 topic / D-6 学术活动位 event；均可空，老数据不受影响）
+ALTER TABLE cms_banner
+    ADD COLUMN description VARCHAR(500) NULL COMMENT '专题大卡描述（position=topic）' AFTER status,
+    ADD COLUMN cta_text    VARCHAR(100) NULL COMMENT '专题大卡 CTA 按钮文字（position=topic）' AFTER description,
+    ADD COLUMN cta_url     VARCHAR(500) NULL COMMENT '专题大卡 CTA 跳转地址（position=topic）' AFTER cta_text,
+    ADD COLUMN event_date  DATETIME     NULL COMMENT '活动日期（position=event）' AFTER cta_url,
+    ADD COLUMN location    VARCHAR(200) NULL COMMENT '活动地点（position=event）' AFTER event_date;
+
+-- ② cms_person 新表（D-7 名师风采，people 区块数据源）
+CREATE TABLE cms_person (
+    id          INT AUTO_INCREMENT PRIMARY KEY,
+    site_id     INT          NOT NULL COMMENT '所属站点（cms_site.id）',
+    name        VARCHAR(100) NOT NULL COMMENT '姓名',
+    title       VARCHAR(100) NULL COMMENT '头衔/职称',
+    bio         VARCHAR(500) NULL COMMENT '一句话简介',
+    avatar      VARCHAR(500) NULL COMMENT '头像 URL（/cms/upload/** 或 http(s)，空=首字徽章兜底）',
+    category_id INT          NULL COMMENT '所属栏目外键（cms_category.id，空=未分组）',
+    sort_no     INT          NOT NULL DEFAULT 0 COMMENT '同级排序（升序）',
+    status      INT          NOT NULL DEFAULT 1 COMMENT '0=停用 1=启用',
+    create_time DATETIME     NULL,
+    update_time DATETIME     NULL,
+    KEY idx_person_site (site_id, status, sort_no),
+    KEY idx_person_category (category_id)
+) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '名师风采人物（docs/20 D-7）';

src/main/resources/templates/error/400.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="zh-CN">
+<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -20,7 +20,7 @@
     <div class="code">400</div>
     <h1>请求参数有误</h1>
     <p>页面地址中的参数不正确（如页码格式错误）。<br>请修正后重试，或返回门户首页继续浏览。</p>
-    <a href="/cms/portal/">返回门户首页</a>
+    <a th:href="@{/portal/}" href="/portal/">返回门户首页</a>
 </div>
 </body>
 </html>

src/main/resources/templates/error/404.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="zh-CN">
+<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -20,7 +20,7 @@
     <div class="code">404</div>
     <h1>页面不存在或已下线</h1>
     <p>您访问的页面可能已被删除、更改地址或暂时不可用。<br>请检查网址是否正确，或返回门户首页继续浏览。</p>
-    <a href="/cms/portal/">返回门户首页</a>
+    <a th:href="@{/portal/}" href="/portal/">返回门户首页</a>
 </div>
 </body>
 </html>

src/main/resources/templates/error/500.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="zh-CN">
+<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -20,7 +20,7 @@
     <div class="code">500</div>
     <h1>服务暂时不可用</h1>
     <p>系统开小差了，工程师正在抢修。<br>请稍后刷新重试，或返回门户首页继续浏览。</p>
-    <a href="/cms/portal/">返回门户首页</a>
+    <a th:href="@{/portal/}" href="/portal/">返回门户首页</a>
 </div>
 </body>
 </html>

src/main/resources/templates/error/error.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="zh-CN">
+<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -20,7 +20,7 @@
     <div class="code">:(</div>
     <h1>出错了</h1>
     <p>请求处理出现异常，请稍后重试。<br>如持续出现，请联系管理员。</p>
-    <a href="/cms/portal/">返回门户首页</a>
+    <a th:href="@{/portal/}" href="/portal/">返回门户首页</a>
 </div>
 </body>
 </html>

src/main/resources/templates/themes/blue-white/README.md

@@ -1,23 +0,0 @@
-# blue-white 皮肤包
-
-由 default 派生的演示皮肤（方案 §7）。**升级随版本发布，不在站点间复制目录**。
-
-## 数据契约（模板可取用的 model 属性全集，§4.3）
-
-| 页面 | 属性 |
-| --- | --- |
-| 全部 | `site`（快照：config/分类树/轮播/友链组/院系子站）、`url`（PortalUrlHelper：home/category/article/asset/search/siteHome）、`themeBase`（=`themes/blue-white`）、`navCategories`、`pageTitle`、`seoDescription`、`canonical`、`themeParams`（微调参数，仅 theme.json 声明过的 key）、`themeVarsCss`（服务端预构建 `:root{}` 覆盖串，无参数为空） |
-| home | `banners`（时间窗内 home 位）、`topArticles`（置顶+最新 6）、`categoryBlocks`（LIST 型根栏目块，各 top 8） |
-| list / search | `listData`（分页）、`category`（list）、`q` + `searchMode`（search） |
-| detail | `article`、`prevArticle`、`nextArticle`、`currentCategoryId` |
-| single | `category`（含 `content`）、`currentCategoryId` |
-
-原则：皮肤不得假设"首页一定有轮播"，对空集合优雅降级。
-
-## 轮播图尺寸约定（bannerSize）
-
-1920x560（管理端上传端按此引导裁剪，D2 决策点）。
-
-## 可调参数
-
-见 `theme.json` 的 `params`（color 进 CSS 变量；select 供模板 `th:if` 分支布局）。

src/main/resources/templates/themes/blue-white/assets/css/main.css

@@ -1,370 +0,0 @@
-/* ============================================================
- * blue-white 皮肤包样式（default 派生）（方案 §8.2）
- * 换肤 = 拷贝 default 目录改 CSS 变量与布局，零后端代码。
- * 轮播图设计尺寸约定：1920×560（管理端上传端按此引导裁剪，D2 决策点确认）。
- * ============================================================ */
-:root {
-  --primary: #2f6bd8;
-  --primary-dark: #1d4fae;
-  --text: #333;
-  --text-light: #777;
-  --bg: #f7f9fc;
-  --card-bg: #fff;
-  --border: #e3e9f2;
-  --max-width: 1200px;
-}
-
-* { box-sizing: border-box; }
-body {
-  margin: 0;
-  font-family: "PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif;
-  color: var(--text);
-  background: var(--bg);
-}
-a { color: inherit; text-decoration: none; }
-a:hover { color: var(--primary); }
-img { max-width: 100%; }
-time, .item-meta { color: var(--text-light); font-size: 13px; }
-.empty { color: var(--text-light); text-align: center; padding: 32px 0; }
-
-/* ===== 头部 ===== */
-.site-header { background: var(--card-bg); border-bottom: 1px solid var(--border); }
-.header-inner {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 18px 16px;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 16px;
-}
-.site-brand { display: flex; align-items: center; gap: 12px; }
-.site-logo { height: 44px; }
-.site-name { font-size: 26px; font-weight: 700; color: var(--primary); }
-.site-search { display: flex; }
-.site-search input {
-  border: 1px solid var(--border);
-  border-right: none;
-  padding: 8px 12px;
-  width: 220px;
-  outline: none;
-}
-.site-search button {
-  border: none;
-  background: var(--primary);
-  color: #fff;
-  padding: 8px 18px;
-  cursor: pointer;
-}
-
-/* ===== 专业院系下拉（院系子站切换，《院系子站方案》） ===== */
-/* 悬停展开白底纵向列表，右对齐 + 超高滚动（院系数十个子站场景） */
-.site-colleges { position: relative; }
-.site-colleges .colleges-toggle {
-  display: flex;
-  align-items: center;
-  gap: 4px;
-  border: 1px solid var(--border);
-  padding: 8px 14px;
-  cursor: pointer;
-  color: var(--primary);
-  font-weight: 600;
-  white-space: nowrap;
-}
-.site-colleges .colleges-arrow { font-style: normal; font-size: 12px; color: var(--text-light); }
-.site-colleges .colleges-menu {
-  display: none;
-  position: absolute;
-  top: 100%;
-  right: 0;
-  min-width: 200px;
-  max-height: 420px;
-  overflow-y: auto;
-  margin: 0;
-  padding: 6px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-top: 2px solid var(--primary);
-  box-shadow: 0 6px 16px rgba(0, 0, 0, .12);
-  z-index: 110;
-}
-.site-colleges:hover .colleges-menu { display: block; }
-.site-colleges .colleges-menu li a {
-  display: block;
-  padding: 9px 16px;
-  color: var(--text);
-  white-space: nowrap;
-}
-.site-colleges .colleges-menu li a:hover { background: #f2f6fc; color: var(--primary); }
-.site-colleges .colleges-menu li.active a { color: var(--primary); font-weight: 600; }
-.site-nav { background: var(--primary); }
-.site-nav ul {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 0 16px;
-  list-style: none;
-  display: flex;
-  flex-wrap: wrap;
-}
-.site-nav li a {
-  display: block;
-  padding: 12px 22px;
-  color: #fff;
-}
-.site-nav li:hover a, .site-nav li.active a { background: var(--primary-dark); }
-
-/* ===== 二级下拉导航 ===== */
-/* 面板为白底纵向列表：需整体覆盖 .site-nav ul 的横向 flex 与内边距 */
-.site-nav > ul > li { position: relative; }
-.site-nav li.has-sub > a::after { content: " ▾"; font-size: 12px; opacity: .85; }
-.site-nav ul.sub-nav {
-  display: none;
-  position: absolute;
-  top: 100%;
-  left: 0;
-  min-width: 168px;
-  max-width: none;
-  margin: 0;
-  padding: 6px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-top: 2px solid var(--primary);
-  box-shadow: 0 6px 16px rgba(0, 0, 0, .12);
-  z-index: 100;
-}
-.site-nav li:hover > .sub-nav { display: block; }
-.site-nav .sub-nav li a {
-  padding: 9px 16px;
-  color: var(--text);
-  white-space: nowrap;
-  background: none;
-}
-.site-nav .sub-nav li a:hover { background: #f2f6fc; color: var(--primary); }
-.site-nav .sub-nav li.active a { color: var(--primary); font-weight: 600; }
-
-/* ===== 首页轮播 ===== */
-.banner { position: relative; max-width: var(--max-width); margin: 16px auto; overflow: hidden; }
-.banner-slides { position: relative; height: 420px; }
-.banner-slide { display: none; position: absolute; inset: 0; }
-.banner-slide.active { display: block; }
-.banner-slide img { width: 100%; height: 100%; object-fit: cover; }
-.banner-title {
-  position: absolute;
-  left: 0; right: 0; bottom: 0;
-  padding: 12px 20px;
-  color: #fff;
-  background: linear-gradient(transparent, rgba(0, 0, 0, .6));
-}
-.banner-dots {
-  position: absolute;
-  bottom: 12px; right: 20px;
-  display: flex; gap: 8px;
-}
-.banner-dots button {
-  width: 10px; height: 10px;
-  border-radius: 50%;
-  border: none;
-  background: rgba(255, 255, 255, .6);
-  cursor: pointer;
-}
-.banner-dots button.active { background: #fff; }
-
-/* ===== 通用区块 ===== */
-.top-strip, .category-block {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 20px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.section-title, .block-head h2 {
-  margin: 0 0 12px;
-  font-size: 20px;
-  border-left: 4px solid var(--primary);
-  padding-left: 10px;
-}
-.block-head { display: flex; align-items: baseline; justify-content: space-between; }
-.more { font-size: 13px; color: var(--text-light); }
-.top-strip ul, .block-list { list-style: none; margin: 0; padding: 0; }
-.top-strip li, .block-list li {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 9px 0;
-  border-bottom: 1px dashed var(--border);
-}
-.top-strip li:last-child, .block-list li:last-child { border-bottom: none; }
-.top-strip li a, .block-list li a {
-  flex: 1;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.top-badge {
-  flex: none;
-  color: #fff;
-  background: var(--primary);
-  font-size: 12px;
-  padding: 1px 6px;
-  border-radius: 2px;
-}
-
-/* ===== 列表页 ===== */
-.list-main {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 24px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.breadcrumb { color: var(--text-light); font-size: 13px; margin-bottom: 16px; }
-.breadcrumb a { margin-right: 8px; }
-.breadcrumb span { margin-left: 8px; }
-.page-title {
-  font-size: 22px;
-  border-left: 4px solid var(--primary);
-  padding-left: 10px;
-  margin: 0 0 18px;
-}
-.article-list { list-style: none; margin: 0; padding: 0; }
-.article-list li { padding: 14px 0; border-bottom: 1px dashed var(--border); }
-.item-title { font-size: 17px; }
-.item-summary {
-  color: var(--text-light);
-  font-size: 14px;
-  margin: 6px 0;
-  overflow: hidden;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-}
-.item-meta { display: flex; gap: 10px; align-items: center; }
-
-/* ===== 分页 ===== */
-.pagination { display: flex; gap: 6px; justify-content: center; padding: 24px 0 4px; }
-.pagination a {
-  min-width: 34px;
-  text-align: center;
-  padding: 6px 10px;
-  border: 1px solid var(--border);
-  background: var(--card-bg);
-}
-.pagination a.active { background: var(--primary); color: #fff; border-color: var(--primary); }
-
-/* ===== 详情/单页 ===== */
-.detail-main {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 32px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.article-title { margin: 8px 0 12px; font-size: 26px; text-align: center; }
-.article-meta {
-  display: flex;
-  gap: 18px;
-  justify-content: center;
-  flex-wrap: wrap;
-  color: var(--text-light);
-  font-size: 13px;
-  padding-bottom: 18px;
-  border-bottom: 1px solid var(--border);
-}
-.article-content { line-height: 1.9; font-size: 16px; padding-top: 20px; word-break: break-word; }
-.article-content img { height: auto; }
-.article-content table { border-collapse: collapse; width: 100%; }
-.article-content table td, .article-content table th { border: 1px solid var(--border); padding: 6px 10px; }
-.article-sibling { display: flex; flex-direction: column; gap: 8px; margin-top: 28px; font-size: 14px; }
-
-/* ===== 页脚 ===== */
-.site-footer { margin-top: 32px; background: var(--primary-dark); color: rgba(255, 255, 255, .85); }
-.footer-links {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 18px 16px 0;
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.links-group { display: flex; flex-wrap: wrap; gap: 14px; align-items: center; font-size: 13px; }
-.group-name { font-weight: 600; margin-right: 4px; }
-.footer-info {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 12px 16px 20px;
-  text-align: center;
-  font-size: 13px;
-}
-.footer-info p { margin: 4px 0; }
-
-/* ===== 移动端适配 ===== */
-@media (max-width: 768px) {
-  .header-inner { flex-direction: column; align-items: stretch; }
-  .site-search input { flex: 1; width: auto; }
-  .site-colleges { align-self: flex-start; }
-  .site-colleges .colleges-menu { left: 0; right: auto; min-width: 100%; }
-  .banner-slides { height: 200px; }
-  .detail-main, .list-main { padding: 18px 14px; }
-  .article-title { font-size: 22px; }
-  /* 触屏无 hover：子菜单静态平铺（缩进列表），不做浮层 */
-  .site-nav ul.sub-nav {
-    display: block;
-    position: static;
-    border: none;
-    box-shadow: none;
-    background: transparent;
-    min-width: 0;
-    padding: 0 0 6px;
-  }
-  .site-nav .sub-nav li a { color: rgba(255, 255, 255, .9); padding: 8px 16px 8px 34px; }
-  .site-nav .sub-nav li a:hover { background: var(--primary-dark); color: #fff; }
-}
-
-
-/* ===== blue-white 主题差异层（方案 §7：差异仅限 CSS + fragments）===== */
-/* 细线顶栏 + 大留白 + 卡片化列表 */
-.site-header { border-bottom: 1px solid var(--border); box-shadow: none; }
-.home-main, .list-main, .detail-main { padding-top: 36px; padding-bottom: 56px; }
-.article-list .article-title, .block-head, .page-title { letter-spacing: .02em; }
-.article-list li, .banner, .banner-title { border-radius: 4px; }
-
-/* B4 友链 Logo：与名称并排小图（高度 ~20px，垂直居中；过宽截断不撑破页脚） */
-.links-group a .link-logo,
-.sp-links-row a .link-logo {
-    height: 20px;
-    width: auto;
-    max-width: 64px;
-    object-fit: contain;
-    vertical-align: middle;
-    margin-right: 4px;
-    border-radius: 2px;
-}
-
-
-/* ===== 左侧栏目导航（docs/11）：有二级节点的模块，栏目/文章页左侧展示兄弟目录 ===== */
-.list-main.has-sidenav, .detail-main.has-sidenav { display: flex; align-items: flex-start; gap: 24px; }
-.has-sidenav .list-body { flex: 1; min-width: 0; }
-.side-nav { flex: none; width: 220px; background: var(--card-bg, #fff); border: 1px solid var(--border); overflow: hidden; }
-.side-nav-head { background: var(--primary); color: #fff; font-size: 20px; font-weight: 700; text-align: center; padding: 18px 12px; letter-spacing: 2px; }
-.side-nav-list { list-style: none; margin: 0; padding: 0; }
-.side-nav-item + .side-nav-item { border-top: 1px dashed var(--border); }
-.side-nav-item a { display: block; padding: 12px 16px; color: var(--text); text-decoration: none; font-size: 15px; transition: background .15s ease, color .15s ease; }
-.side-nav-item a:hover { color: var(--primary); background: var(--bg); }
-.side-nav-item.active a { background: var(--primary); color: #fff; font-weight: 600; text-decoration: none; }
-/* 顶导航二级下拉当前项高亮（docs/11 顺带） */
-.site-nav ul.sub-nav li.active a { color: var(--primary); }
-@media (max-width: 768px) {
-  .list-main.has-sidenav, .detail-main.has-sidenav { flex-direction: column; gap: 12px; }
-  .side-nav { width: 100%; }
-  .side-nav-list { display: flex; overflow-x: auto; -webkit-overflow-scrolling: touch; }
-  .side-nav-item { flex: none; }
-  .side-nav-item + .side-nav-item { border-top: none; border-left: 1px dashed var(--border); }
-  .side-nav-item a { white-space: nowrap; }
-}
-@media print {
-  .side-nav { display: none; }
-  .list-main.has-sidenav, .detail-main.has-sidenav { display: block; }
-}

src/main/resources/templates/themes/blue-white/assets/favicon.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
-  <defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-    <stop offset="0" stop-color="#5486df"/><stop offset="1" stop-color="#214b97"/>
-  </linearGradient></defs>
-  <rect width="64" height="64" fill="url(#bg)"/>
-  <circle cx="32" cy="25" r="10" fill="#ffffff"/>
-  <path d="M 16 49.3 Q 32 30.7 48 49.3 Z" fill="#ffffff" opacity="0.92"/>
-</svg>

src/main/resources/templates/themes/blue-white/assets/js/main.js

@@ -1,40 +0,0 @@
-/* default 皮肤包脚本：仅首页轮播自动播放与圆点切换，无任何外部依赖 */
-(function () {
-  var slides = document.querySelectorAll('.banner-slide');
-  var dots = document.querySelectorAll('.banner-dots button');
-  if (!slides.length) {
-    return;
-  }
-  var current = 0;
-  var timer = null;
-
-  function show(index) {
-    slides[current].classList.remove('active');
-    if (dots[current]) {
-      dots[current].classList.remove('active');
-    }
-    current = (index + slides.length) % slides.length;
-    slides[current].classList.add('active');
-    if (dots[current]) {
-      dots[current].classList.add('active');
-    }
-  }
-
-  function start() {
-    if (slides.length > 1) {
-      timer = window.setInterval(function () {
-        show(current + 1);
-      }, 5000);
-    }
-  }
-
-  dots.forEach(function (dot, index) {
-    dot.addEventListener('click', function () {
-      window.clearInterval(timer);
-      show(index);
-      start();
-    });
-  });
-
-  start();
-})();

src/main/resources/templates/themes/blue-white/detail.html

@@ -1,58 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node : ${categoryPath}">
-            <a class="crumb-parent" th:href="${url.category(node.id)}" th:text="${node.name}">栏目</a>
-        </th:block>
-        <span>正文</span>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${article.title}">文章标题</h1>
-        <div class="article-meta">
-            <time th:if="${article.publishTime != null}"
-                  th:text="${'发布时间：' + #temporals.format(article.publishTime, 'yyyy-MM-dd HH:mm')}">2026-01-01 10:00</time>
-            <span th:if="${!#strings.isEmpty(article.authorName)}"
-                  th:text="'作者：' + ${article.authorName}">作者</span>
-            <span th:if="${!#strings.isEmpty(article.source)}"
-                  th:text="'来源：' + ${article.source}">来源</span>
-            <span th:text="'浏览量：' + ${article.viewCount}">浏览量</span>
-        </div>
-        <!-- 正文：入库前已经 jsoup 白名单清洗（方案 §8.5），此处允许 utext；
-             其余字段一律 th:text 转义输出 -->
-        <div class="article-content" th:utext="${article.content}">正文</div>
-    </article>
-
-    <nav class="article-sibling">
-        <a th:if="${prevArticle != null}" class="prev"
-           th:href="${url.article(prevArticle.id)}"
-           th:text="'上一篇：' + ${prevArticle.title}">上一篇</a>
-        <a th:if="${nextArticle != null}" class="next"
-           th:href="${url.article(nextArticle.id)}"
-           th:text="'下一篇：' + ${nextArticle.title}">下一篇</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/blue-white/fragments/footer.html

@@ -1,21 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共页脚：联系信息 + 友情链接（分组渲染，方案 §8.1：友链不设独立路由） -->
-<footer class="site-footer" th:fragment="footer">
-    <div class="footer-links" th:if="${!#lists.isEmpty(site.linkGroups)}">
-        <div class="links-group" th:each="group : ${site.linkGroups}">
-            <span class="group-name" th:text="${group.groupName}">分组</span>
-            <a th:each="link : ${group.links}" th:href="${link.linkUrl}" target="_blank" rel="noopener">
-                    <img th:if="${link.logoUrl != null and !#strings.isEmpty(link.logoUrl)}" class="link-logo"
-                         th:src="${url.upload(link.logoUrl)}" th:alt="${link.name}" loading="lazy">
-                    <span th:text="${link.name}">链接</span>
-                </a>
-        </div>
-    </div>
-    <div class="footer-info">
-        <p th:if="${site.config['contact'] != null}" th:text="${site.config['contact']}">联系方式</p>
-        <p th:if="${site.config['copyright'] != null}" th:text="${site.config['copyright']}">版权信息</p>
-        <p th:if="${site.config['beian'] != null}" th:text="${site.config['beian']}">备案号</p>
-    </div>
-</footer>
-</html>

src/main/resources/templates/themes/blue-white/fragments/head.html

@@ -1,24 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<!-- 公共 head 片段：SEO（title/description/canonical）+ 主题资产（方案 §8.3/§8.6） -->
-<head th:fragment="head">
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title th:text="${pageTitle}">页面标题</title>
-    <meta name="description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}"
-          th:content="${seoDescription}">
-    <link rel="canonical" th:if="${canonical != null}" th:href="${canonical}">
-    <!-- og 标签基本三件（C-7，方案 §8.6 canonical/og 同基准） -->
-    <meta property="og:title" th:if="${pageTitle != null}" th:content="${pageTitle}">
-    <meta property="og:description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}" th:content="${seoDescription}">
-    <meta property="og:image" th:if="${ogImage != null}" th:content="${ogImage}">
-    <link rel="stylesheet" th:href="${url.asset('css/main.css')}">
-    <!-- 微调参数 CSS 变量覆盖（方案 §5.3）：位于皮肤 CSS 之后层叠覆盖；值由服务端预构建并校验 -->
-    <style th:if="${not #strings.isEmpty(themeVarsCss)}" th:utext="${themeVarsCss}"></style>
-    <!-- 站点级自定义样式（B3）：位于皮肤 CSS 与微调变量之后层叠覆盖；内容经服务端黑名单强校验后直出 -->
-    <style th:if="${not #strings.isEmpty(customCss)}" th:utext="${customCss}"></style>
-    <!-- favicon：管理端配置了 favicon 键用上传图，未配置输出主题内置兜底 icon（assets/favicon.png） -->
-    <link rel="icon" type="image/png"
-          th:href="${site.config['favicon'] != null ? url.upload(site.config['favicon']) : url.asset('favicon.png')}">
-</head>
-</html>

src/main/resources/templates/themes/blue-white/fragments/header.html

@@ -1,54 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共头部：站点名 + 栏目导航 + 站内搜索 + 专业院系下拉（院系子站切换，《院系子站方案》） -->
-<header class="site-header" th:fragment="header">
-    <div class="header-inner">
-        <div class="site-brand">
-            <img th:if="${site.config['logo'] != null}" class="site-logo"
-                 th:src="${url.upload(site.config['logo'])}" th:alt="${site.name}">
-            <a class="site-name" th:href="${url.home()}" th:text="${site.name}">站点名称</a>
-        </div>
-        <form class="site-search" th:action="${url.search('', null)}" method="get">
-            <input type="text" name="q" placeholder="站内搜索" aria-label="站内搜索">
-            <button type="submit">搜索</button>
-        </form>
-        <!-- 专业院系下拉：顶层站取其子站、院系子站取兄弟站（含自身）；无子站不渲染；文案经 config_json.colleges_label 覆盖 -->
-        <div class="site-colleges" th:if="${!site.colleges.isEmpty()}"
-             th:with="collegesLabel=${site.config['colleges_label'] ?: '专业院系'}">
-            <span class="colleges-toggle">
-                <a href="javascript:void(0)" th:text="${collegesLabel}">专业院系</a>
-                <i class="colleges-arrow">▾</i>
-            </span>
-            <ul class="colleges-menu">
-                <li th:each="col : ${site.colleges}" th:classappend="${col.path == site.path} ? 'active'">
-                    <a th:href="${url.siteHome(col.path, col.publicBaseUrl)}"
-                       th:title="${col.name}" th:text="${col.name}">学院名称</a>
-                </li>
-            </ul>
-        </div>
-    </div>
-    <nav class="site-nav">
-        <ul>
-            <li th:classappend="${currentCategoryId == null and navServiceActive == null} ? 'active'">
-                <a th:href="${url.home()}">首页</a>
-            </li>
-            <li th:each="cat : ${navCategories}"
-                th:classappend="${((currentCategoryId == cat.id or navTopId == cat.id) ? 'active' : '') + (!cat.children.isEmpty() ? ' has-sub' : '')}">
-                <!-- 外链栏目直接外跳；其余进栏目页（方案 §8.1） -->
-                <a th:if="${cat.type == 3}" th:href="${cat.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${cat.name}">栏目</a>
-                <a th:unless="${cat.type == 3}" th:href="${url.category(cat.id)}" th:text="${cat.name}">栏目</a>
-                <!-- 二级下拉：悬停展开（样式见 assets/css/main.css .sub-nav） -->
-                <ul class="sub-nav" th:if="${!cat.children.isEmpty()}">
-                    <li th:each="sub : ${cat.children}"
-                        th:classappend="${sub.id == currentCategoryId} ? 'active'">
-                        <a th:if="${sub.type == 3}" th:href="${sub.linkUrl}" target="_blank" rel="noopener"
-                           th:text="${sub.name}">子栏目</a>
-                        <a th:unless="${sub.type == 3}" th:href="${url.category(sub.id)}" th:text="${sub.name}">子栏目</a>
-                    </li>
-                </ul>
-            </li>
-        </ul>
-    </nav>
-</header>
-</html>

src/main/resources/templates/themes/blue-white/home.html

@@ -1,68 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="home-main">
-    <!-- 首页轮播位（cms_banner position=home；设计尺寸约定 1920×560，见 assets/css 注释） -->
-    <section class="banner" th:if="${!#lists.isEmpty(banners)}">
-        <div class="banner-slides">
-            <a class="banner-slide" th:each="b, stat : ${banners}"
-               th:classappend="${stat.first} ? 'active'"
-               th:href="${b.linkUrl}" th:title="${b.title}">
-                <img th:src="${b.imageUrl}" th:alt="${b.title}">
-                <span class="banner-title" th:text="${b.title}">标题</span>
-            </a>
-        </div>
-        <div class="banner-dots" th:if="${#lists.size(banners) > 1}">
-            <button th:each="b, stat : ${banners}" th:classappend="${stat.first} ? 'active'"
-                    th:aria-label="${'第' + (stat.count) + '张'}"></button>
-        </div>
-    </section>
-
-    <!-- 首页布局模式（docs/16 §4.4）：home_layout 落库后按区块序列渲染（common 兜底骨架，本主题不另设形态） -->
-    <th:block th:if="${layoutBlocks != null}">
-        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: style}" />
-        <th:block th:each="block : ${layoutBlocks}">
-            <th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" />
-        </th:block>
-    </th:block>
-
-    <!-- 回落分支（docs/16 D2）：无 home_layout 时按现状渲染 -->
-    <th:block th:unless="${layoutBlocks != null}">
-    <!-- 置顶/头条区（cms_article topmost 优先） -->
-    <section class="top-strip" th:if="${!#lists.isEmpty(topArticles)}">
-        <h2 class="section-title">头条推荐</h2>
-        <ul>
-            <li th:each="item : ${topArticles}">
-                <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-    </section>
-
-    <!-- 一级栏目区块（每栏目 top 8） -->
-    <section class="category-block" th:each="block : ${categoryBlocks}">
-        <div class="block-head">
-            <h2 th:text="${block.category.name}">栏目名</h2>
-            <a class="more" th:href="${block.moreUrl}">更多 &gt;</a>
-        </div>
-        <ul class="block-list" th:if="${!#lists.isEmpty(block.items)}">
-            <li th:each="item : ${block.items}">
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-        <p class="empty" th:if="${#lists.isEmpty(block.items)}">暂无内容</p>
-    </section>
-    </th:block>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/blue-white/list.html

@@ -1,68 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="list-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb" th:if="${searchMode != true}">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-    <nav class="breadcrumb" th:if="${searchMode == true}">
-        <a th:href="${url.home()}">首页</a>
-        <span>搜索结果</span>
-    </nav>
-
-    <h1 class="page-title" th:if="${searchMode != true}" th:text="${category.name}">栏目名</h1>
-    <h1 class="page-title" th:if="${searchMode == true}" th:text="'搜索：' + ${q}">搜索词</h1>
-
-    <ul class="article-list">
-        <li th:each="item : ${listData.items}">
-            <a class="item-title" th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-            <p class="item-summary" th:if="${!#strings.isEmpty(item.summary)}" th:text="${item.summary}">摘要</p>
-            <div class="item-meta">
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-                <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-            </div>
-        </li>
-    </ul>
-    <p class="empty" th:if="${#lists.isEmpty(listData.items)}">暂无内容</p>
-
-    <!-- 分页（列表页/搜索页共用） -->
-    <nav class="pagination" th:if="${listData.totalPages > 1}"
-         th:with="cur=${listData.page}, total=${listData.totalPages}">
-        <a th:if="${cur > 1}"
-           th:href="${searchMode == true} ? ${url.search(q, cur - 1)} : ${url.category(listData.categoryId) + '?page=' + (cur - 1)}">上一页</a>
-        <a th:each="p : ${#numbers.sequence(1, total)}"
-           th:classappend="${p == cur} ? 'active'"
-           th:href="${searchMode == true} ? ${url.search(q, p)} : ${url.category(listData.categoryId) + '?page=' + p}"
-           th:text="${p}">1</a>
-        <a th:if="${cur < total}"
-           th:href="${searchMode == true} ? ${url.search(q, cur + 1)} : ${url.category(listData.categoryId) + '?page=' + (cur + 1)}">下一页</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/blue-white/single.html

@@ -1,41 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${category.name}">栏目名</h1>
-        <!-- 单页栏目内容（type=2，入库前已 jsoup 清洗） -->
-        <div class="article-content" th:utext="${category.content}">单页内容</div>
-        <p class="empty" th:if="${#strings.isEmpty(category.content)}">暂无内容</p>
-    </article>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/blue-white/theme.json

@@ -1,16 +0,0 @@
-{
-  "specVersion": 1,
-  "name": "blue-white",
-  "title": "蓝白简约",
-  "version": "1.0.0",
-  "author": "yunhai",
-  "description": "细线顶栏 + 卡片化列表 + 大留白，适合高校与职业院校（方案 §7）。",
-  "screenshot": "assets/screenshot.png",
-  "bannerSize": "1920x560",
-  "params": [
-    { "key": "primary",     "cssVar": "--primary",      "label": "主色",       "type": "color", "default": "#2f6bd8" },
-    { "key": "primaryDark", "cssVar": "--primary-dark", "label": "主色加深",   "type": "color", "default": "#1d4fae" },
-    { "key": "bg",          "cssVar": "--bg",           "label": "页面底色",   "type": "color", "default": "#f7f9fc" },
-    { "key": "border",      "cssVar": "--border",       "label": "边框色",     "type": "color", "default": "#e3e9f2" }
-  ]
-}

src/main/resources/templates/themes/campus-glow/assets/css/main.css

@@ -400,3 +400,257 @@ button { font-family: inherit; cursor: pointer; }
   .cg-gallery-item img { height: 230px; }
   .cg-qr:hover img { transform: scale(1.6); }
 }
+
+
+/* =====================================================================
+   首页布局模式区块补齐（v2 手册 §A.3 · P-A3，S7）
+   对应 fragments/home-blocks.html 新增的 5 个 fragment：compact / image_wall / links / quick_links / notice_bar。
+   本包三条硬约束说明：
+     · §2.5 坑③（全宽区块根补 grid-column）在本包**不适用**：.cg-home 无任何布局规则（非网格），
+       区块用"全幅 section > .cg-container"惯用结构天然占满整行——补 grid-column 只会留死声明。
+     · 网格轨道一律 minmax(0,1fr)（本包 .cg-news-grid/.cg-media-grid 基线用的是裸 1fr，
+       新节按记忆教训改用 minmax，避免中文 min-content 撑破窄视口；不动既有两行以守住"已有形态不改"）。
+     · 颜色只用本包既有令牌；#fff 与 color-mix() 是本包既有习惯（顶栏/导航/侧栏已如此写），未新增色值。
+   ===================================================================== */
+
+/* 区块壳：与 .cg-block-card / .cg-media-card 同值（本包习惯是各形态各写一份，不合并选择器） */
+.cg-compact, .cg-wall, .cg-friend, .cg-quick { padding: 40px 0 0; }
+.cg-sec-card {
+  background: var(--cg-card-bg); border: 1px solid var(--cg-border);
+  border-radius: var(--cg-radius); box-shadow: var(--cg-shadow); padding: 26px 30px;
+}
+
+/* 形态四 compact：圆角日期块 + 单行标题 */
+.cg-compact-list { display: grid; grid-template-columns: 1fr 1fr; column-gap: 48px; }
+.cg-compact-list li {
+  display: flex; align-items: center; gap: 14px; min-width: 0;
+  padding: 11px 2px; border-bottom: 1px dashed var(--cg-border);
+}
+.cg-compact-list li:nth-last-child(-n+2) { border-bottom: 0; }
+.cg-date-chip {
+  flex: none; display: inline-flex; flex-direction: column; align-items: center; justify-content: center;
+  width: 56px; line-height: 1.25; color: #fff; border-radius: 10px;
+  background: linear-gradient(135deg, var(--cg-primary), var(--cg-primary-dark));
+  box-shadow: 0 3px 8px rgba(10, 98, 68, .22);
+}
+.cg-date-chip b { font-size: 20px; font-weight: 700; }
+.cg-date-chip i { font-style: normal; font-size: 11px; opacity: .82; letter-spacing: .5px; }
+.cg-compact-title {
+  flex: 1; min-width: 0; font-size: 15px; color: var(--cg-text);
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+.cg-compact-title:hover { color: var(--cg-primary); }
+
+/* 形态五 image_wall：四列图墙 + 底部渐变题注（渐变写法同 .cg-gallery-cap，色值为该规则既有） */
+.cg-wall-grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 14px; }
+.cg-wall-item { position: relative; border-radius: 10px; overflow: hidden; }
+.cg-wall-item a { display: block; }
+.cg-wall-item img {
+  width: 100%; height: 156px; object-fit: cover;
+  transition: transform .3s ease, box-shadow .3s ease;
+}
+.cg-wall-item:hover img { transform: translateY(-4px); box-shadow: 0 14px 28px rgba(10, 98, 68, .22); }
+.cg-wall-cap {
+  position: absolute; left: 0; right: 0; bottom: 0; padding: 26px 12px 9px;
+  color: #fff; font-size: 14px;
+  background: linear-gradient(180deg, rgba(0, 0, 0, 0), rgba(0, 0, 0, .55));
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+
+/* 形态六 links：友情链接分组（分组标题带强调色竖条；logo 用页脚同款 .cg-link-logo） */
+.cg-friend-group {
+  margin: 16px 0 8px; padding-left: 10px; font-size: 14px; font-weight: 600;
+  color: var(--cg-primary-dark); border-left: 3px solid var(--cg-accent);
+}
+.cg-friend-group:first-of-type { margin-top: 0; }
+.cg-friend-links { display: flex; flex-wrap: wrap; gap: 8px 12px; }
+.cg-friend-links li { flex: none; }
+.cg-friend-links a {
+  display: inline-flex; align-items: center; gap: 6px; padding: 5px 14px;
+  font-size: 13px; color: var(--cg-text); background: var(--cg-bg);
+  border: 1px solid var(--cg-border); border-radius: 999px; transition: color .2s, border-color .2s;
+}
+.cg-friend-links a:hover { color: var(--cg-primary); border-color: var(--cg-primary); }
+
+/* 新区块一 quick_links：六列宫格 → 三列 → 两列（入口名居中，悬停走本包渐变语言） */
+.cg-quick-grid { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 12px; }
+.cg-quick-link {
+  display: flex; align-items: center; justify-content: center; min-height: 58px; padding: 8px 10px;
+  font-size: 14px; text-align: center; color: var(--cg-text);
+  background: var(--cg-bg); border: 1px solid var(--cg-border); border-radius: 10px;
+  transition: color .2s, background .2s, transform .2s, box-shadow .2s;
+}
+.cg-quick-link:hover {
+  color: #fff; background: linear-gradient(135deg, var(--cg-primary), var(--cg-primary-dark));
+  border-color: var(--cg-primary); transform: translateY(-3px); box-shadow: var(--cg-shadow);
+}
+
+/* 新区块二 notice_bar：整幅横条（与 .cg-ticker 同层级，不是卡片）。
+   info 用主色浅底、warn 用强调色浅底——本包有 --cg-accent 令牌，故不需要像 mint-breeze 那样自持 warn 三件套。 */
+.cg-notice { border-top: 1px solid var(--cg-border); border-bottom: 1px solid var(--cg-border); background: var(--cg-card-bg); }
+.cg-notice-inner { display: flex; align-items: center; flex-wrap: wrap; gap: 12px; padding-top: 12px; padding-bottom: 12px; font-size: 14px; }
+.cg-notice-tag {
+  flex: none; font-size: 13px; font-weight: 600; color: #fff; padding: 4px 14px; border-radius: 0 0 10px 10px;
+  background: linear-gradient(135deg, var(--cg-primary), var(--cg-primary-dark));
+}
+.cg-notice-link, .cg-notice-text { flex: 1; min-width: 0; color: var(--cg-text); }
+.cg-notice-link { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.cg-notice-link:hover { color: var(--cg-primary); text-decoration: underline; text-underline-offset: 3px; }
+.cg-notice-info { border-top-color: color-mix(in srgb, var(--cg-primary) 30%, var(--cg-border)); background: color-mix(in srgb, var(--cg-primary) 7%, var(--cg-card-bg)); }
+.cg-notice-warn { border-top-color: color-mix(in srgb, var(--cg-accent) 45%, var(--cg-border)); background: color-mix(in srgb, var(--cg-accent) 9%, var(--cg-card-bg)); }
+.cg-notice-warn .cg-notice-tag { background: linear-gradient(135deg, var(--cg-accent), #ff9f4d); }
+.cg-notice-warn .cg-notice-link:hover { color: var(--cg-accent); }
+
+@media (max-width: 992px) {
+  .cg-sec-card { padding: 20px 18px; }
+  .cg-wall-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .cg-quick-grid { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+}
+@media (max-width: 768px) {
+  .cg-compact-list { grid-template-columns: 1fr; }
+  .cg-compact-list li:nth-last-child(-n+2) { border-bottom: 1px dashed var(--cg-border); }
+  .cg-compact-list li:last-child { border-bottom: 0; }
+  .cg-compact, .cg-wall, .cg-friend, .cg-quick { padding-top: 26px; }
+  .cg-quick-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .cg-notice-inner { flex-direction: column; align-items: flex-start; gap: 4px; }
+  .cg-notice-link { white-space: normal; }
+}
+
+/* =====================================================================
+   服务中心 / 事项指南（v2 手册 §A.3 · P-A3，S7 新建 service.html + guide.html）
+   页壳、面包屑、页题、分页、空态、标题/元信息/正文全部复用本包既有
+   .cg-list-main / .cg-page-card / .cg-breadcrumb / .cg-page-title / .cg-pagination /
+   .cg-empty / .cg-article-title / .cg-article-meta / .cg-article-content，
+   本节只补事项特有的件；色值只用本包令牌（#fff、#ff9f4d 为本包既有习惯）。
+   ===================================================================== */
+
+/* 筛选面板：分组行 + 胶囊选项（active 走本包主色渐变） */
+.cg-svc-filters {
+  border: 1px solid var(--cg-border); border-radius: 10px;
+  background: var(--cg-bg); padding: 8px 14px; margin-bottom: 18px;
+}
+.cg-svc-filter-group { display: flex; align-items: flex-start; gap: 12px; padding: 7px 0; }
+.cg-svc-filter-group + .cg-svc-filter-group { border-top: 1px dashed var(--cg-border); }
+.cg-svc-filter-label { flex: none; min-width: 60px; font-size: 13px; font-weight: 600; color: var(--cg-primary-dark); padding-top: 3px; }
+.cg-svc-filter-options { display: flex; flex-wrap: wrap; gap: 8px; min-width: 0; }
+.cg-chip {
+  display: inline-flex; align-items: center; gap: 5px; padding: 2px 12px;
+  font-size: 13px; color: var(--cg-text-light);
+  background: var(--cg-card-bg); border: 1px solid var(--cg-border); border-radius: 999px;
+  transition: color .2s, border-color .2s, background .2s;
+}
+.cg-chip em { font-style: normal; font-size: 12px; opacity: .75; }
+.cg-chip:hover { color: var(--cg-primary); border-color: var(--cg-primary); }
+.cg-chip.active {
+  color: #fff; border-color: var(--cg-primary);
+  background: linear-gradient(135deg, var(--cg-primary), var(--cg-primary-dark));
+}
+
+/* 工具条：搜索框（圆角同 .cg-site-search，但方角贴合卡片）+ 清除筛选 */
+.cg-svc-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 16px; }
+.cg-svc-search { display: flex; flex: 1; min-width: 0; }
+.cg-svc-search input {
+  flex: 1; min-width: 0; padding: 9px 14px; font-size: 14px; font-family: inherit;
+  border: 1px solid var(--cg-border); border-right: 0; border-radius: 8px 0 0 8px;
+  background: var(--cg-bg); color: var(--cg-text); outline: none;
+}
+.cg-svc-search input:focus { border-color: var(--cg-primary); background: var(--cg-card-bg); }
+.cg-svc-search button {
+  flex: none; padding: 9px 24px; border: 0; border-radius: 0 8px 8px 0;
+  background: var(--cg-primary); color: #fff; font-size: 14px; transition: background .2s;
+}
+.cg-svc-search button:hover { background: var(--cg-primary-dark); }
+.cg-svc-clear { flex: none; font-size: 13px; color: var(--cg-primary); }
+.cg-svc-clear:hover { color: var(--cg-accent); text-decoration: underline; text-underline-offset: 3px; }
+
+/* 事项卡网格：三列 → 两列 → 单列；轨道 minmax(0,·) 防中文 min-content 撑破窄视口 */
+.cg-svc-list { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 16px; }
+.cg-svc-item {
+  display: flex; gap: 14px; align-items: flex-start; min-width: 0; padding: 16px;
+  background: var(--cg-card-bg); border: 1px solid var(--cg-border); border-radius: 10px;
+  transition: transform .25s ease, box-shadow .25s ease, border-color .25s ease;
+}
+.cg-svc-item:hover { transform: translateY(-3px); border-color: var(--cg-primary); box-shadow: var(--cg-shadow); }
+.cg-svc-item-cover { flex: none; width: 108px; border-radius: 8px; overflow: hidden; }
+.cg-svc-item-cover img { width: 100%; height: 72px; object-fit: cover; }
+.cg-svc-item-body { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 6px; }
+.cg-svc-item-title { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; min-width: 0; }
+.cg-svc-item-name {
+  font-size: 15px; font-weight: 600; color: var(--cg-text); line-height: 1.5;
+  display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden;
+}
+.cg-svc-item:hover .cg-svc-item-name { color: var(--cg-primary); }
+.cg-svc-item-summary {
+  font-size: 13px; color: var(--cg-text-light);
+  display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden;
+}
+.cg-svc-item-meta { margin-top: auto; display: flex; flex-wrap: wrap; gap: 4px 12px; font-size: 12px; color: var(--cg-text-light); }
+
+/* 标签：办理方式用主色浅底；"可在线办理"是第二优先级信息，用强调色描边区分而不是引入新色相 */
+.cg-tag {
+  flex: none; font-size: 12px; line-height: 1.6; padding: 1px 9px; border-radius: 4px;
+  color: var(--cg-primary); background: color-mix(in srgb, var(--cg-primary) 10%, var(--cg-card-bg));
+}
+.cg-tag.online { color: var(--cg-accent); background: transparent; border: 1px solid color-mix(in srgb, var(--cg-accent) 55%, transparent); }
+
+/* 指南页：办理按钮、基本信息表、章节题、附件、跳转条、相关服务 */
+.cg-svc-apply { display: flex; align-items: center; gap: 14px; margin: 18px 0; }
+.cg-svc-apply-btn {
+  display: inline-block; padding: 10px 32px; font-size: 15px; color: #fff;
+  border-radius: 999px; background: linear-gradient(135deg, var(--cg-primary), var(--cg-primary-dark));
+  box-shadow: 0 6px 16px rgba(10, 98, 68, .26); transition: transform .2s ease, box-shadow .2s ease;
+}
+.cg-svc-apply-btn:hover { transform: translateY(-2px); box-shadow: 0 10px 22px rgba(10, 98, 68, .34); }
+.cg-svc-apply-hint { font-size: 13px; color: var(--cg-text-light); }
+.cg-svc-summary { font-size: 15px; color: var(--cg-text-light); line-height: 1.85; margin-bottom: 18px; }
+
+.cg-svc-info { width: 100%; border-collapse: collapse; margin-bottom: 18px; font-size: 14px; }
+.cg-svc-info th, .cg-svc-info td { border: 1px solid var(--cg-border); padding: 10px 14px; text-align: left; vertical-align: top; }
+.cg-svc-info th { width: 132px; font-weight: 500; color: var(--cg-text-light); background: var(--cg-bg); }
+
+.cg-svc-section { margin-top: 22px; }
+.cg-svc-section h2 {
+  font-size: 18px; font-weight: 600; color: var(--cg-primary-dark);
+  padding-left: 12px; margin-bottom: 10px; border-left: 4px solid var(--cg-accent);
+}
+.cg-svc-section .cg-article-content { padding-top: 0; }
+.cg-svc-attachments > ul { display: flex; flex-direction: column; gap: 8px; }
+.cg-svc-attachments a { font-size: 14px; color: var(--cg-primary-dark); }
+.cg-svc-attachments a:hover { color: var(--cg-primary); text-decoration: underline; text-underline-offset: 3px; }
+.cg-svc-att-size { margin-left: 8px; font-size: 12px; color: var(--cg-text-light); }
+
+.cg-svc-links { display: flex; flex-wrap: wrap; gap: 12px; margin-top: 24px; padding-top: 18px; border-top: 1px dashed var(--cg-border); }
+.cg-svc-links a {
+  padding: 4px 18px; font-size: 14px; color: var(--cg-primary);
+  border: 1px solid var(--cg-primary); border-radius: 999px; transition: color .2s, background .2s;
+}
+.cg-svc-links a:hover { color: #fff; background: var(--cg-primary); }
+
+.cg-svc-related { margin-top: 30px; padding: 18px 20px; border: 1px solid var(--cg-border); border-radius: 10px; background: var(--cg-bg); }
+.cg-svc-related-title { font-size: 17px; font-weight: 600; color: var(--cg-primary-dark); margin-bottom: 6px; }
+.cg-svc-related-list > li + li { border-top: 1px dashed var(--cg-border); }
+.cg-svc-related-list a { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 10px 0; min-width: 0; }
+.cg-svc-related-name { flex: 1; min-width: 0; font-size: 14px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.cg-svc-related-list a:hover .cg-svc-related-name { color: var(--cg-primary); }
+.cg-svc-related-meta { flex: none; display: inline-flex; align-items: center; gap: 8px; font-size: 12px; color: var(--cg-text-light); }
+
+/* 表格 caption 仅面向读屏（本包 .cg-skip-link 是跳转链接专用，语义不同，不复用） */
+.cg-visually-hidden {
+  position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0;
+  overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; border: 0;
+}
+
+@media (max-width: 992px) {
+  .cg-svc-list { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+@media (max-width: 768px) {
+  .cg-svc-list { grid-template-columns: minmax(0, 1fr); }
+  .cg-svc-toolbar { flex-direction: column; align-items: stretch; }
+  .cg-svc-clear { align-self: flex-start; }
+  .cg-svc-info th { width: 92px; padding: 9px 10px; }
+  .cg-svc-info td { padding: 9px 10px; }
+  .cg-svc-item { flex-direction: column; }
+  .cg-svc-item-cover { width: 100%; }
+  .cg-svc-item-cover img { height: 158px; }
+  .cg-svc-apply { flex-wrap: wrap; gap: 8px; }
+}

src/main/resources/templates/themes/campus-glow/fragments/header.html

@@ -31,10 +31,19 @@
                  th:src="${url.upload(site.config['logo'])}" th:alt="${site.name}">
             <a class="cg-site-name" th:href="${url.home()}" th:text="${site.name}">站点名称</a>
         </div>
-        <form class="cg-site-search" th:action="${url.search('', null)}" method="get" role="search">
+        <!-- D-10（docs/20）：searchStyle=overlay 换全屏搜索浮层；none 隐藏；inline/缺省保留原表单。
+     坑④：th:replace 优先级(100)先于 th:if(300)——条件必须放外层 th:block，replace 放子元素 -->
+        <th:block th:if="${themeParams != null and themeParams['searchStyle'] == 'overlay'}">
+            <th:block th:replace="~{'themes/common/fragments/search' :: overlay(${url})}" />
+        </th:block>
+        <th:block th:if="${themeParams == null or themeParams['searchStyle'] == null or themeParams['searchStyle'] == 'inline'}">
+<form class="cg-site-search"
+             
+              th:action="${url.search('', null)}" method="get" role="search">
             <input type="text" name="q" placeholder="站内搜索" aria-label="站内搜索">
             <button type="submit">搜索</button>
         </form>
+        </th:block>
     </div>
 
     <nav class="cg-nav" aria-label="栏目导航">

src/main/resources/templates/themes/campus-glow/fragments/home-blocks.html

@@ -148,3 +148,133 @@
         </div>
     </div>
 </section>
+
+<!-- ===== 以下 5 个 fragment 为 v2 手册 §A.3 · P-A3 补齐（S7）=====
+     补齐原因：本包原先只有 5 个自持形态，compact/image_wall/links 三处直接借 themes/common 的 plb 骨架
+     （首页换肤只换页头页脚、正文落骨架 = 手册 §2.2 线上事故根因），quick_links/notice_bar 两个新区块类型则完全没有。
+     上面 5 个形态保持原样未重写；本段沿用本包既有惯例：
+       · 结构 = 全幅 <section class="cg-形态名"> > .cg-container > 卡本体（故本包 main 不是网格，§2.5 坑③ 不适用，见 audit-A.md A3 证据）
+       · 空态 = 内联 <div class="cg-empty"> + th:if 同元素（本包 news_grid / media_focus / card 三形态既有写法如此；不引用 :: empty fragment，
+         因而不新增 fragment 名，S4 门禁 validateHomeBlockFragmentRefs 的"引用 ⊆ 声明"仍成立）；
+         links 与 scholar-blue / mint-breeze 定型同构（分组遍历，不设空态卡）；notice_bar 无文本时整条隐藏（本包 ticker / gallery 既有"无数据即隐藏"写法）
+       · 可选 Map 键一律 block['key'] 括号访问（坑②）
+-->
+<!-- 形态四：日期方块行（homeStyle=compact）——圆角日期块 + 单行标题（原借 common :: plbCompact） -->
+<section class="cg-compact" th:fragment="compact(block)" aria-label="栏目区块">
+    <div class="cg-container">
+        <div class="cg-sec-card">
+            <div class="cg-sec-head">
+                <h2 th:text="${block.category.name}">通知公告</h2>
+                <a class="cg-more-circle" th:href="${block.moreUrl}" aria-label="更多">
+                    <svg viewBox="0 0 24 24" width="18" height="18" focusable="false" aria-hidden="true">
+                        <path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
+                              stroke-linejoin="round" d="M5 12h14M13 6l6 6-6 6"/>
+                    </svg>
+                </a>
+            </div>
+            <ul class="cg-compact-list" th:if="${!#lists.isEmpty(block.items)}">
+                <li th:each="item : ${block.items}">
+                    <span class="cg-date-chip" th:if="${item.publishTime != null}" th:with="d=${item.publishTime}">
+                        <b th:text="${#temporals.format(d, 'dd')}">01</b>
+                        <i th:text="${#temporals.format(d, 'yyyy-MM')}">2026-01</i>
+                    </span>
+                    <a class="cg-compact-title" th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
+                    <span class="cg-top-badge" th:if="${item.topmost == 1}">置顶</span>
+                </li>
+            </ul>
+            <div class="cg-empty" th:if="${#lists.isEmpty(block.items)}">
+                <p>栏目暂无内容</p>
+                <p class="cg-empty-hint">内容发布后将在此展示</p>
+            </div>
+        </div>
+    </div>
+</section>
+
+<!-- 形态五：图片墙（homeStyle=image_wall）——四列格 + 底部渐变题注，仅取有封面的条目（原借 common :: plbImageWall） -->
+<section class="cg-wall" th:fragment="image_wall(block)" aria-label="栏目区块">
+    <div class="cg-container">
+        <div class="cg-sec-card">
+            <div class="cg-sec-head">
+                <h2 th:text="${block.category.name}">图片新闻</h2>
+                <a class="cg-more-circle" th:href="${block.moreUrl}" aria-label="更多">
+                    <svg viewBox="0 0 24 24" width="18" height="18" focusable="false" aria-hidden="true">
+                        <path fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"
+                              stroke-linejoin="round" d="M5 12h14M13 6l6 6-6 6"/>
+                    </svg>
+                </a>
+            </div>
+            <ul class="cg-wall-grid" th:if="${!#lists.isEmpty(block.items)}">
+                <li class="cg-wall-item" th:each="item : ${block.items}" th:if="${item.coverImage != null}">
+                    <a th:href="${url.article(item.id)}" th:title="${item.title}">
+                        <img th:src="${url.upload(item.coverImage)}" th:alt="${item.title}" loading="lazy">
+                        <span class="cg-wall-cap" th:text="${item.title}">图片标题</span>
+                    </a>
+                </li>
+            </ul>
+            <div class="cg-empty" th:if="${#lists.isEmpty(block.items)}">
+                <p>栏目暂无内容</p>
+                <p class="cg-empty-hint">内容发布后将在此展示</p>
+            </div>
+        </div>
+    </div>
+</section>
+
+<!-- 形态六：友情链接分组（type=links，block.linkGroups 由渲染端按 group 过滤）——原借 common :: plbLinks。
+     语义与 quick_links 分开：links 读友情链接表（带 logo），quick_links 读区块内联数组（手册 §2.8 类型 A）。 -->
+<section class="cg-friend" th:fragment="links(block)" aria-label="友情链接">
+    <div class="cg-container">
+        <div class="cg-sec-card">
+            <div class="cg-sec-head">
+                <h2 th:text="${block.title}">友情链接</h2>
+            </div>
+            <th:block th:each="grp : ${block.linkGroups}">
+                <p class="cg-friend-group" th:if="${!#strings.isEmpty(grp.groupName)}" th:text="${grp.groupName}">分组</p>
+                <ul class="cg-friend-links">
+                    <li th:each="l : ${grp.links}">
+                        <a th:href="${l.linkUrl}" target="_blank" rel="noopener">
+                            <img th:if="${l.logoUrl != null and !#strings.isEmpty(l.logoUrl)}" class="cg-link-logo"
+                                 th:src="${url.upload(l.logoUrl)}" th:alt="${l.name}" loading="lazy">
+                            <span th:text="${l.name}">链接名</span>
+                        </a>
+                    </li>
+                </ul>
+            </th:block>
+        </div>
+    </div>
+</section>
+
+<!-- 新区块一：快捷通道（quick_links，手册 §2.8 类型 A）——区块内联入口数组，不读友情链接表。
+     渲染端已丢弃 name 空 / url 非法项（PortalPageRenderer:477-500），模板只判 #lists.isEmpty -->
+<section class="cg-quick" th:fragment="quick_links(block)" aria-label="快捷通道">
+    <div class="cg-container">
+        <div class="cg-sec-card">
+            <div class="cg-sec-head">
+                <h2 th:text="${block.title}">快捷通道</h2>
+                <a class="cg-more-text" th:if="${block.moreUrl != null}" th:href="${block.moreUrl}">更多 &gt;</a>
+            </div>
+            <ul class="cg-quick-grid" th:if="${!#lists.isEmpty(block['quickLinks'])}">
+                <li th:each="l : ${block['quickLinks']}">
+                    <a class="cg-quick-link" th:href="${l.url}" th:text="${l.name}">入口名</a>
+                </li>
+            </ul>
+            <div class="cg-empty" th:if="${#lists.isEmpty(block['quickLinks'])}">
+                <p>暂无可用入口</p>
+                <p class="cg-empty-hint">请在首页布局中配置快捷通道</p>
+            </div>
+        </div>
+    </div>
+</section>
+
+<!-- 新区块二：公告条（notice_bar，手册 §2.8 类型 B）——站点单条手填通告，非滚动非文章列表。
+     整幅横条（与本包 .cg-ticker 同层级，不是卡片）；noticeLevel 渲染端已归一 info|warn；noticeUrl 非法时为空串 → 退化纯文本 -->
+<div class="cg-notice" th:fragment="notice_bar(block)" role="note"
+     th:if="${!#strings.isEmpty(block['noticeText'])}"
+     th:classappend="${block['noticeLevel'] == 'warn' ? 'cg-notice-warn' : 'cg-notice-info'}">
+    <div class="cg-container cg-notice-inner">
+        <span class="cg-notice-tag" th:text="${block.title}">公告</span>
+        <a class="cg-notice-link" th:if="${!#strings.isEmpty(block['noticeUrl'])}"
+           th:href="${block['noticeUrl']}" th:text="${block['noticeText']}">公告正文</a>
+        <span class="cg-notice-text" th:unless="${!#strings.isEmpty(block['noticeUrl'])}"
+              th:text="${block['noticeText']}">公告正文</span>
+    </div>
+</div>

src/main/resources/templates/themes/campus-glow/guide.html

@@ -0,0 +1,135 @@
+<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
+<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
+<body>
+<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
+
+<!-- 事项指南页（事项库 §6.2 契约 · P-A3 换皮）：item / attachments[] / relatedItems[] /
+     faqCategoryUrl·noticeCategoryUrl·ruleCategoryUrl（可空）/ applyUrl（可空，空则不渲染"我要办理"）。
+     三个富文本字段已在保存期过 jsoup 白名单、渲染期补 URL 基准，此处允许 utext。
+     svcUnavailable=true（P1-4 停机降级）：只渲染骨架+空态，不渲染事项内容与"我要办理"。
+     标题/元信息/正文沿用本包既有 .cg-article-title / .cg-article-meta / .cg-article-content，
+     数据绑定与 default、poly-blue 同构，仅换皮。 -->
+<main class="cg-list-main cg-container" id="main-content">
+    <div class="cg-page-card">
+        <nav class="cg-breadcrumb" aria-label="面包屑">
+            <a th:href="${url.home()}">首页</a>
+            <span class="cg-crumb-sep" aria-hidden="true">/</span>
+            <a th:href="${url.serviceList()}">服务中心</a>
+            <span class="cg-crumb-sep" aria-hidden="true">/</span>
+            <span class="cg-current" th:text="${svcUnavailable} ? '服务中心' : ${item.title}">事项名称</span>
+        </nav>
+
+        <!-- P1-4 停机空态：svc-hall 不可达时降级渲染（200），不出 500 错误页 -->
+        <div class="cg-empty" th:if="${svcUnavailable}">
+            <p>事项服务暂时不可用，请稍后再试</p>
+            <p class="cg-empty-hint">事项数据服务暂不可达，稍后刷新即可恢复</p>
+        </div>
+
+        <article th:if="${!svcUnavailable}">
+            <h1 class="cg-article-title" th:text="${item.title}">事项名称</h1>
+            <div class="cg-article-meta">
+                <span th:if="${!#strings.isEmpty(item.deptName)}"
+                      th:text="${'办理部门：' + item.deptName}">办理部门</span>
+                <span th:text="${item.handleMode == 1 ? '线上办理' : (item.handleMode == 2 ? '线下办理' : '线上线下均可办理')}">办理方式</span>
+                <time th:if="${item.publishTime != null}"
+                      th:text="${'发布时间：' + #temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
+                <span th:text="${'浏览量：' + item.viewCount}">浏览量</span>
+            </div>
+
+            <!-- 我要办理：三态（手填外链 > svc_hall_base 生成 > 不渲染），按钮外链新窗口打开 -->
+            <div class="cg-svc-apply" th:if="${applyUrl != null}">
+                <a class="cg-svc-apply-btn" th:href="${applyUrl}" target="_blank" rel="noopener">我要办理</a>
+                <span class="cg-svc-apply-hint">进入服务大厅在线办理</span>
+            </div>
+
+            <p class="cg-svc-summary" th:if="${!#strings.isEmpty(item.summary)}" th:text="${item.summary}">简介</p>
+
+            <table class="cg-svc-info">
+                <caption class="cg-visually-hidden">事项基本信息</caption>
+                <tbody>
+                <tr th:if="${!#strings.isEmpty(item.objectName)}">
+                    <th scope="row">服务对象</th>
+                    <td th:text="${item.objectName}">服务对象</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.categoryName)}">
+                    <th scope="row">事项类别</th>
+                    <td th:text="${item.categoryName}">事项类别</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.handlePlace)}">
+                    <th scope="row">办理地点</th>
+                    <td th:text="${item.handlePlace}">办理地点</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.handleTimeLimit)}">
+                    <th scope="row">办理时限</th>
+                    <td th:text="${item.handleTimeLimit}">办理时限</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.promiseTimeLimit)}">
+                    <th scope="row">承诺时限</th>
+                    <td th:text="${item.promiseTimeLimit}">承诺时限</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.contactPhone)}">
+                    <th scope="row">咨询电话</th>
+                    <td th:text="${item.contactPhone}">咨询电话</td>
+                </tr>
+                <tr th:if="${!#strings.isEmpty(item.supervisePhone)}">
+                    <th scope="row">监督投诉</th>
+                    <td th:text="${item.supervisePhone}">监督投诉电话</td>
+                </tr>
+                </tbody>
+            </table>
+
+            <section class="cg-svc-section" th:if="${!#strings.isEmpty(item.processHtml)}">
+                <h2>办理流程</h2>
+                <div class="cg-article-content" th:utext="${item.processHtml}">办理流程</div>
+            </section>
+            <section class="cg-svc-section" th:if="${!#strings.isEmpty(item.materialHtml)}">
+                <h2>所需材料</h2>
+                <div class="cg-article-content" th:utext="${item.materialHtml}">所需材料</div>
+            </section>
+            <section class="cg-svc-section" th:if="${!#strings.isEmpty(item.noticeHtml)}">
+                <h2>注意事项</h2>
+                <div class="cg-article-content" th:utext="${item.noticeHtml}">注意事项</div>
+            </section>
+
+            <section class="cg-svc-section cg-svc-attachments" th:if="${!#lists.isEmpty(attachments)}">
+                <h2>相关材料下载</h2>
+                <ul>
+                    <li th:each="att : ${attachments}">
+                        <a th:href="${url.upload(att.webUrl)}" th:download
+                           th:text="${att.fileName}">材料文件</a>
+                        <span class="cg-svc-att-size" th:if="${att.fileSize != null}"
+                              th:text="${#numbers.formatDecimal(att.fileSize / 1024.0, 1, 1) + ' KB'}">12.3 KB</span>
+                    </li>
+                </ul>
+            </section>
+
+            <nav class="cg-svc-links" th:if="${faqCategoryUrl != null or noticeCategoryUrl != null or ruleCategoryUrl != null}">
+                <a th:if="${faqCategoryUrl != null}" th:href="${faqCategoryUrl}">常见问题</a>
+                <a th:if="${noticeCategoryUrl != null}" th:href="${noticeCategoryUrl}">公告信息</a>
+                <a th:if="${ruleCategoryUrl != null}" th:href="${ruleCategoryUrl}">文件规定</a>
+            </nav>
+        </article>
+
+        <aside class="cg-svc-related" th:if="${!svcUnavailable and !#lists.isEmpty(relatedItems)}">
+            <h2 class="cg-svc-related-title">相关服务</h2>
+            <ul class="cg-svc-related-list">
+                <li th:each="rel : ${relatedItems}">
+                    <a th:href="${rel.url}">
+                        <span class="cg-svc-related-name" th:text="${rel.title}">相关事项</span>
+                        <span class="cg-svc-related-meta">
+                            <span th:if="${!#strings.isEmpty(rel.deptName)}" th:text="${rel.deptName}">部门</span>
+                            <span class="cg-tag"
+                                  th:text="${rel.handleMode == 1 ? '线上' : (rel.handleMode == 2 ? '线下' : '线上线下')}">方式</span>
+                        </span>
+                    </a>
+                </li>
+            </ul>
+        </aside>
+    </div>
+</main>
+
+<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
+<script th:src="${url.asset('js/main.js')}"></script>
+</body>
+</html>

src/main/resources/templates/themes/campus-glow/home.html

@@ -23,24 +23,36 @@
         </div>
     </section>
 
-    <!-- 首页布局模式（docs/16 §4.4）：home_layout 落库后按区块序列渲染。
-         article_list 三种形态走主题自有 fragment（compact/image_wall 与未实现类型落 common 兜底骨架）。
-         注意：th:replace（优先级100）先于 th:case（300）执行——case 必须放父元素、replace 放子元素 -->
-    <th:block th:if="${layoutBlocks != null}" th:each="block : ${layoutBlocks}">
-        <th:block th:switch="${block.type}">
-            <th:block th:case="'article_list'">
-                <th:block th:switch="${block.homeStyle}">
-                    <th:block th:case="'news_grid'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: news_grid(${block})}" /></th:block>
-                    <th:block th:case="'media_focus'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: media_focus(${block})}" /></th:block>
-                    <th:block th:case="'compact'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbCompact(${block})}" /></th:block>
-                    <th:block th:case="'image_wall'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbImageWall(${block})}" /></th:block>
-                    <th:block th:case="*"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: card(${block})}" /></th:block>
+    <!-- 首页布局模式（docs/16 §4.4 · v2 手册 §A.3 P-A3）：home_layout 落库后按区块序列渲染。
+         本包为 A 档：8 形态 + quick_links/notice_bar 全部自持（fragments/home-blocks.html），
+         compact/image_wall/links 三处不再借 themes/common 的 plb 骨架（借骨架 = 换肤只换页头页脚，手册 §2.2 事故根因）；
+         只有白名单外的未知类型才落 common 兜底骨架——故 common 的 :: style 样式段必须引入（R-32：本包此前缺这段，兜底区块裸奔）。
+         注意坑④：th:replace（优先级 100）先于 th:case（300）执行——case 必须放父元素、replace 放子元素。 -->
+    <th:block th:if="${layoutBlocks != null}">
+        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: style}" />
+        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: previewScript}" />
+        <!-- D-8（docs/20）：骨架共享入场动效 + count-up；主题参数 animation=off 关闭 -->
+        <th:block th:if="${themeParams == null or themeParams['animation'] != 'off'}" th:replace="~{'themes/common/fragments/home-blocks' :: motionScript}" />
+        <th:block th:each="block : ${layoutBlocks}">
+            <div class="plb-anchor" th:attr="data-plb-id=${block['id']}" style="display:contents">
+            <th:block th:switch="${block.type}">
+                <th:block th:case="'article_list'">
+                    <th:block th:switch="${block.homeStyle}">
+                        <th:block th:case="'news_grid'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: news_grid(${block})}" /></th:block>
+                        <th:block th:case="'media_focus'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: media_focus(${block})}" /></th:block>
+                        <th:block th:case="'compact'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: compact(${block})}" /></th:block>
+                        <th:block th:case="'image_wall'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: image_wall(${block})}" /></th:block>
+                        <th:block th:case="*"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: card(${block})}" /></th:block>
+                    </th:block>
                 </th:block>
+                <th:block th:case="'ticker'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: ticker(${block})}" /></th:block>
+                <th:block th:case="'gallery'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: gallery(${block})}" /></th:block>
+                <th:block th:case="'links'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: links(${block})}" /></th:block>
+                <th:block th:case="'quick_links'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: quick_links(${block})}" /></th:block>
+                <th:block th:case="'notice_bar'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: notice_bar(${block})}" /></th:block>
+                <th:block th:case="*"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" /></th:block>
             </th:block>
-            <th:block th:case="'ticker'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: ticker(${block})}" /></th:block>
-            <th:block th:case="'gallery'"><th:block th:replace="~{${themeBase} + '/fragments/home-blocks' :: gallery(${block})}" /></th:block>
-            <th:block th:case="'links'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbLinks(${block})}" /></th:block>
-            <th:block th:case="*"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" /></th:block>
+            </div>
         </th:block>
     </th:block>
 

src/main/resources/templates/themes/campus-glow/service.html

@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
+<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
+<body>
+<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
+
+<!-- 服务中心（事项库 §6.1 契约 · P-A3 换皮）：serviceList / serviceFilters / activeFilters / q；
+     筛选与分页 URL 全部后端预生成（facets[].url / pageUrls[].url），模板禁止手拼 query。
+     页壳/面包屑/页题/分页/空态沿用本包既有 .cg-list-main / .cg-page-card / .cg-breadcrumb /
+     .cg-page-title / .cg-pagination / .cg-empty；无侧栏，故不进 .cg-page-cols 网格。
+     数据绑定与 default、poly-blue 同构，仅换皮。 -->
+<main class="cg-list-main cg-container" id="main-content">
+    <div class="cg-page-card">
+        <nav class="cg-breadcrumb" aria-label="面包屑">
+            <a th:href="${url.home()}">首页</a>
+            <span class="cg-crumb-sep" aria-hidden="true">/</span>
+            <span class="cg-current">服务中心</span>
+        </nav>
+
+        <h1 class="cg-page-title">服务中心</h1>
+
+        <!-- P1-4 停机空态：svc-hall 不可达时降级渲染（200），不出 500 错误页 -->
+        <div class="cg-empty" th:if="${svcUnavailable}">
+            <p>事项服务暂时不可用，请稍后再试</p>
+            <p class="cg-empty-hint">事项数据服务暂不可达，稍后刷新即可恢复</p>
+        </div>
+
+        <div class="cg-svc-filters"
+             th:if="${!svcUnavailable and (!#lists.isEmpty(serviceFilters.objects) or !#lists.isEmpty(serviceFilters.categories) or !#lists.isEmpty(serviceFilters.depts))}">
+            <div class="cg-svc-filter-group" th:if="${!#lists.isEmpty(serviceFilters.objects)}">
+                <span class="cg-svc-filter-label">服务对象</span>
+                <div class="cg-svc-filter-options">
+                    <a class="cg-chip" th:each="opt : ${serviceFilters.objects}"
+                       th:classappend="${opt.active} ? 'active'" th:href="${opt.url}">
+                        <span th:text="${opt.name}">对象</span><em th:text="${opt.count}">0</em>
+                    </a>
+                </div>
+            </div>
+            <div class="cg-svc-filter-group" th:if="${!#lists.isEmpty(serviceFilters.categories)}">
+                <span class="cg-svc-filter-label">事项类别</span>
+                <div class="cg-svc-filter-options">
+                    <a class="cg-chip" th:each="opt : ${serviceFilters.categories}"
+                       th:classappend="${opt.active} ? 'active'" th:href="${opt.url}">
+                        <span th:text="${opt.name}">类别</span><em th:text="${opt.count}">0</em>
+                    </a>
+                </div>
+            </div>
+            <div class="cg-svc-filter-group" th:if="${!#lists.isEmpty(serviceFilters.depts)}">
+                <span class="cg-svc-filter-label">服务部门</span>
+                <div class="cg-svc-filter-options">
+                    <a class="cg-chip" th:each="opt : ${serviceFilters.depts}"
+                       th:classappend="${opt.active} ? 'active'" th:href="${opt.url}">
+                        <span th:text="${opt.name}">部门</span><em th:text="${opt.count}">0</em>
+                    </a>
+                </div>
+            </div>
+        </div>
+
+        <div class="cg-svc-toolbar" th:if="${!svcUnavailable}">
+            <form class="cg-svc-search" th:action="${url.serviceList()}" method="get" role="search">
+                <input type="search" name="q" th:value="${q}" placeholder="搜索事项名称 / 简介" maxlength="64">
+                <button type="submit">搜索</button>
+            </form>
+            <a class="cg-svc-clear" th:if="${activeFilters.hasAny}" th:href="${activeFilters.clearUrl}">清除筛选</a>
+        </div>
+
+        <ul class="cg-svc-list" th:if="${!svcUnavailable}">
+            <li th:each="it : ${serviceList.items}">
+                <a class="cg-svc-item" th:href="${url.serviceItem(it.id)}">
+                    <span class="cg-svc-item-cover" th:if="${it.coverImage != null}">
+                        <img th:src="${url.upload(it.coverImage)}" th:alt="${it.title}">
+                    </span>
+                    <span class="cg-svc-item-body">
+                        <span class="cg-svc-item-title">
+                            <span class="cg-svc-item-name" th:text="${it.title}">事项名称</span>
+                            <span class="cg-tag online" th:if="${it.onlineFlag == 1}">可在线办理</span>
+                            <span class="cg-tag"
+                                  th:text="${it.handleMode == 1 ? '线上办理' : (it.handleMode == 2 ? '线下办理' : '线上线下')}">办理方式</span>
+                        </span>
+                        <span class="cg-svc-item-summary" th:if="${!#strings.isEmpty(it.summary)}"
+                              th:text="${it.summary}">简介</span>
+                        <span class="cg-svc-item-meta">
+                            <span th:if="${!#strings.isEmpty(it.deptName)}" th:text="${it.deptName}">部门</span>
+                            <span th:if="${!#strings.isEmpty(it.categoryName)}" th:text="${it.categoryName}">类别</span>
+                            <time th:if="${it.publishTime != null}"
+                                  th:text="${#temporals.format(it.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
+                        </span>
+                    </span>
+                </a>
+            </li>
+        </ul>
+        <div class="cg-empty" th:if="${!svcUnavailable and #lists.isEmpty(serviceList.items)}">
+            <p th:if="${activeFilters.hasAny}">未找到符合条件的服务事项</p>
+            <p th:if="${!activeFilters.hasAny}">服务中心暂未上架事项</p>
+            <p class="cg-empty-hint" th:if="${activeFilters.hasAny}">换个筛选条件或关键词试试</p>
+            <p class="cg-empty-hint" th:if="${!activeFilters.hasAny}">事项发布后将在此展示</p>
+        </div>
+
+        <!-- 分页：URL 由后端预生成（携带当前筛选，pageUrls[].active 标记当前页）；停机态 totalPages=0 自然隐藏 -->
+        <nav class="cg-pagination" th:if="${!svcUnavailable and serviceList.totalPages > 1}" aria-label="分页">
+            <a th:each="p : ${serviceList.pageUrls}"
+               th:classappend="${p.active} ? 'active'"
+               th:href="${p.url}"
+               th:aria-label="${'第' + p.page + '页'}"
+               th:aria-current="${p.active} ? 'page'"
+               th:text="${p.page}">1</a>
+        </nav>
+    </div>
+</main>
+
+<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
+<script th:src="${url.asset('js/main.js')}"></script>
+</body>
+</html>

src/main/resources/templates/themes/campus-glow/theme.json

@@ -8,19 +8,152 @@
   "screenshot": "assets/screenshot.png",
   "bannerSize": "1920x560",
   "params": [
-    { "key": "primary",     "cssVar": "--cg-primary",      "label": "主色",       "type": "color", "default": "#0e8a5f" },
-    { "key": "primaryDark", "cssVar": "--cg-primary-dark", "label": "主色加深",   "type": "color", "default": "#0a6244" },
-    { "key": "accent",      "cssVar": "--cg-accent",       "label": "强调色",     "type": "color", "default": "#ff7a1a" },
-    { "key": "text",        "cssVar": "--cg-text",         "label": "正文文字色", "type": "color", "default": "#2b2f33" },
-    { "key": "textLight",   "cssVar": "--cg-text-light",   "label": "次要文字色", "type": "color", "default": "#7a8288" },
-    { "key": "bg",          "cssVar": "--cg-bg",           "label": "页面底色",   "type": "color", "default": "#f4f7f5" },
-    { "key": "cardBg",      "cssVar": "--cg-card-bg",      "label": "卡片底色",   "type": "color", "default": "#ffffff" },
-    { "key": "border",      "cssVar": "--cg-border",       "label": "边框色",     "type": "color", "default": "#e3e8e4" },
-    { "key": "galleryCols", "label": "展厅每行列数", "type": "select", "default": "4",
+    {
+      "key": "primary",
+      "cssVar": "--cg-primary",
+      "label": "主色",
+      "type": "color",
+      "default": "#0e8a5f"
+    },
+    {
+      "key": "primaryDark",
+      "cssVar": "--cg-primary-dark",
+      "label": "主色加深",
+      "type": "color",
+      "default": "#0a6244"
+    },
+    {
+      "key": "accent",
+      "cssVar": "--cg-accent",
+      "label": "强调色",
+      "type": "color",
+      "default": "#ff7a1a"
+    },
+    {
+      "key": "text",
+      "cssVar": "--cg-text",
+      "label": "正文文字色",
+      "type": "color",
+      "default": "#2b2f33"
+    },
+    {
+      "key": "textLight",
+      "cssVar": "--cg-text-light",
+      "label": "次要文字色",
+      "type": "color",
+      "default": "#7a8288"
+    },
+    {
+      "key": "bg",
+      "cssVar": "--cg-bg",
+      "label": "页面底色",
+      "type": "color",
+      "default": "#f4f7f5"
+    },
+    {
+      "key": "cardBg",
+      "cssVar": "--cg-card-bg",
+      "label": "卡片底色",
+      "type": "color",
+      "default": "#ffffff"
+    },
+    {
+      "key": "border",
+      "cssVar": "--cg-border",
+      "label": "边框色",
+      "type": "color",
+      "default": "#e3e8e4"
+    },
+    {
+      "key": "galleryCols",
+      "label": "展厅每行列数",
+      "type": "select",
+      "default": "4",
       "options": [
-        { "value": "3", "label": "3 列" },
-        { "value": "4", "label": "4 列" },
-        { "value": "5", "label": "5 列" }
+        {
+          "value": "3",
+          "label": "3 列"
+        },
+        {
+          "value": "4",
+          "label": "4 列"
+        },
+        {
+          "value": "5",
+          "label": "5 列"
+        }
+      ]
+    },
+    {
+      "key": "animation",
+      "label": "首页动效",
+      "type": "select",
+      "default": "on",
+      "options": [
+        {
+          "value": "on",
+          "label": "开启（滚动入场 + 数字计数）"
+        },
+        {
+          "value": "off",
+          "label": "关闭（静态呈现）"
+        }
+      ]
+    },
+    {
+      "key": "titleStyle",
+      "label": "栏目标题语言",
+      "type": "select",
+      "default": "cn",
+      "options": [
+        {
+          "value": "cn",
+          "label": "仅中文"
+        },
+        {
+          "value": "bilingual",
+          "label": "中英双语（大中文 + 斜体英文副题）"
+        }
+      ]
+    },
+    {
+      "key": "iconShape",
+      "label": "图标形状语言",
+      "type": "select",
+      "default": "circle",
+      "options": [
+        {
+          "value": "circle",
+          "label": "圆形徽章"
+        },
+        {
+          "value": "hexagon",
+          "label": "六边形"
+        },
+        {
+          "value": "square",
+          "label": "圆角方形"
+        }
+      ]
+    },
+    {
+      "key": "searchStyle",
+      "label": "门户搜索样式",
+      "type": "select",
+      "default": "inline",
+      "options": [
+        {
+          "value": "none",
+          "label": "不显示搜索"
+        },
+        {
+          "value": "inline",
+          "label": "通栏搜索条（banner 下方白色大搜索条）"
+        },
+        {
+          "value": "overlay",
+          "label": "全屏搜索浮层（右上放大镜唤起）"
+        }
       ]
     }
   ]

src/main/resources/templates/themes/classic-red/README.md

@@ -1,23 +0,0 @@
-# classic-red 皮肤包
-
-由 default 派生的演示皮肤（方案 §7）。**升级随版本发布，不在站点间复制目录**。
-
-## 数据契约（模板可取用的 model 属性全集，§4.3）
-
-| 页面 | 属性 |
-| --- | --- |
-| 全部 | `site`（快照：config/分类树/轮播/友链组/院系子站）、`url`（PortalUrlHelper：home/category/article/asset/search/siteHome）、`themeBase`（=`themes/classic-red`）、`navCategories`、`pageTitle`、`seoDescription`、`canonical`、`themeParams`（微调参数，仅 theme.json 声明过的 key）、`themeVarsCss`（服务端预构建 `:root{}` 覆盖串，无参数为空） |
-| home | `banners`（时间窗内 home 位）、`topArticles`（置顶+最新 6）、`categoryBlocks`（LIST 型根栏目块，各 top 8） |
-| list / search | `listData`（分页）、`category`（list）、`q` + `searchMode`（search） |
-| detail | `article`、`prevArticle`、`nextArticle`、`currentCategoryId` |
-| single | `category`（含 `content`）、`currentCategoryId` |
-
-原则：皮肤不得假设"首页一定有轮播"，对空集合优雅降级。
-
-## 轮播图尺寸约定（bannerSize）
-
-1920x560（管理端上传端按此引导裁剪，D2 决策点）。
-
-## 可调参数
-
-见 `theme.json` 的 `params`（color 进 CSS 变量；select 供模板 `th:if` 分支布局）。

src/main/resources/templates/themes/classic-red/assets/css/main.css

@@ -1,372 +0,0 @@
-/* ============================================================
- * classic-red 皮肤包样式（default 派生）（方案 §8.2）
- * 换肤 = 拷贝 default 目录改 CSS 变量与布局，零后端代码。
- * 轮播图设计尺寸约定：1920×560（管理端上传端按此引导裁剪，D2 决策点确认）。
- * ============================================================ */
-:root {
-  --primary: #b01a2e;
-  --primary-dark: #7f1224;
-  --text: #333;
-  --text-light: #777;
-  --bg: #f7f5f2;
-  --card-bg: #fff;
-  --border: #e5e6eb;
-  --max-width: 1200px;
-}
-
-* { box-sizing: border-box; }
-body {
-  margin: 0;
-  font-family: "PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif;
-  color: var(--text);
-  background: var(--bg);
-}
-a { color: inherit; text-decoration: none; }
-a:hover { color: var(--primary); }
-img { max-width: 100%; }
-time, .item-meta { color: var(--text-light); font-size: 13px; }
-.empty { color: var(--text-light); text-align: center; padding: 32px 0; }
-
-/* ===== 头部 ===== */
-.site-header { background: var(--card-bg); border-bottom: 1px solid var(--border); }
-.header-inner {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 18px 16px;
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 16px;
-}
-.site-brand { display: flex; align-items: center; gap: 12px; }
-.site-logo { height: 44px; }
-.site-name { font-size: 26px; font-weight: 700; color: var(--primary); }
-.site-search { display: flex; }
-.site-search input {
-  border: 1px solid var(--border);
-  border-right: none;
-  padding: 8px 12px;
-  width: 220px;
-  outline: none;
-}
-.site-search button {
-  border: none;
-  background: var(--primary);
-  color: #fff;
-  padding: 8px 18px;
-  cursor: pointer;
-}
-
-/* ===== 专业院系下拉（院系子站切换，《院系子站方案》） ===== */
-/* 悬停展开白底纵向列表，右对齐 + 超高滚动（院系数十个子站场景） */
-.site-colleges { position: relative; }
-.site-colleges .colleges-toggle {
-  display: flex;
-  align-items: center;
-  gap: 4px;
-  border: 1px solid var(--border);
-  padding: 8px 14px;
-  cursor: pointer;
-  color: var(--primary);
-  font-weight: 600;
-  white-space: nowrap;
-}
-.site-colleges .colleges-arrow { font-style: normal; font-size: 12px; color: var(--text-light); }
-.site-colleges .colleges-menu {
-  display: none;
-  position: absolute;
-  top: 100%;
-  right: 0;
-  min-width: 200px;
-  max-height: 420px;
-  overflow-y: auto;
-  margin: 0;
-  padding: 6px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-top: 2px solid var(--primary);
-  box-shadow: 0 6px 16px rgba(0, 0, 0, .12);
-  z-index: 110;
-}
-.site-colleges:hover .colleges-menu { display: block; }
-.site-colleges .colleges-menu li a {
-  display: block;
-  padding: 9px 16px;
-  color: var(--text);
-  white-space: nowrap;
-}
-.site-colleges .colleges-menu li a:hover { background: #f2f6fc; color: var(--primary); }
-.site-colleges .colleges-menu li.active a { color: var(--primary); font-weight: 600; }
-.site-nav { background: var(--primary); }
-.site-nav ul {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 0 16px;
-  list-style: none;
-  display: flex;
-  flex-wrap: wrap;
-}
-.site-nav li a {
-  display: block;
-  padding: 12px 22px;
-  color: #fff;
-}
-.site-nav li:hover a, .site-nav li.active a { background: var(--primary-dark); }
-
-/* ===== 二级下拉导航 ===== */
-/* 面板为白底纵向列表：需整体覆盖 .site-nav ul 的横向 flex 与内边距 */
-.site-nav > ul > li { position: relative; }
-.site-nav li.has-sub > a::after { content: " ▾"; font-size: 12px; opacity: .85; }
-.site-nav ul.sub-nav {
-  display: none;
-  position: absolute;
-  top: 100%;
-  left: 0;
-  min-width: 168px;
-  max-width: none;
-  margin: 0;
-  padding: 6px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-top: 2px solid var(--primary);
-  box-shadow: 0 6px 16px rgba(0, 0, 0, .12);
-  z-index: 100;
-}
-.site-nav li:hover > .sub-nav { display: block; }
-.site-nav .sub-nav li a {
-  padding: 9px 16px;
-  color: var(--text);
-  white-space: nowrap;
-  background: none;
-}
-.site-nav .sub-nav li a:hover { background: #f2f6fc; color: var(--primary); }
-.site-nav .sub-nav li.active a { color: var(--primary); font-weight: 600; }
-
-/* ===== 首页轮播 ===== */
-.banner { position: relative; max-width: var(--max-width); margin: 16px auto; overflow: hidden; }
-.banner-slides { position: relative; height: 420px; }
-.banner-slide { display: none; position: absolute; inset: 0; }
-.banner-slide.active { display: block; }
-.banner-slide img { width: 100%; height: 100%; object-fit: cover; }
-.banner-title {
-  position: absolute;
-  left: 0; right: 0; bottom: 0;
-  padding: 12px 20px;
-  color: #fff;
-  background: linear-gradient(transparent, rgba(0, 0, 0, .6));
-}
-.banner-dots {
-  position: absolute;
-  bottom: 12px; right: 20px;
-  display: flex; gap: 8px;
-}
-.banner-dots button {
-  width: 10px; height: 10px;
-  border-radius: 50%;
-  border: none;
-  background: rgba(255, 255, 255, .6);
-  cursor: pointer;
-}
-.banner-dots button.active { background: #fff; }
-
-/* ===== 通用区块 ===== */
-.top-strip, .category-block {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 20px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.section-title, .block-head h2 {
-  margin: 0 0 12px;
-  font-size: 20px;
-  border-left: 4px solid var(--primary);
-  padding-left: 10px;
-}
-.block-head { display: flex; align-items: baseline; justify-content: space-between; }
-.more { font-size: 13px; color: var(--text-light); }
-.top-strip ul, .block-list { list-style: none; margin: 0; padding: 0; }
-.top-strip li, .block-list li {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 9px 0;
-  border-bottom: 1px dashed var(--border);
-}
-.top-strip li:last-child, .block-list li:last-child { border-bottom: none; }
-.top-strip li a, .block-list li a {
-  flex: 1;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.top-badge {
-  flex: none;
-  color: #fff;
-  background: var(--primary);
-  font-size: 12px;
-  padding: 1px 6px;
-  border-radius: 2px;
-}
-
-/* ===== 列表页 ===== */
-.list-main {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 24px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.breadcrumb { color: var(--text-light); font-size: 13px; margin-bottom: 16px; }
-.breadcrumb a { margin-right: 8px; }
-.breadcrumb span { margin-left: 8px; }
-.page-title {
-  font-size: 22px;
-  border-left: 4px solid var(--primary);
-  padding-left: 10px;
-  margin: 0 0 18px;
-}
-.article-list { list-style: none; margin: 0; padding: 0; }
-.article-list li { padding: 14px 0; border-bottom: 1px dashed var(--border); }
-.item-title { font-size: 17px; }
-.item-summary {
-  color: var(--text-light);
-  font-size: 14px;
-  margin: 6px 0;
-  overflow: hidden;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-}
-.item-meta { display: flex; gap: 10px; align-items: center; }
-
-/* ===== 分页 ===== */
-.pagination { display: flex; gap: 6px; justify-content: center; padding: 24px 0 4px; }
-.pagination a {
-  min-width: 34px;
-  text-align: center;
-  padding: 6px 10px;
-  border: 1px solid var(--border);
-  background: var(--card-bg);
-}
-.pagination a.active { background: var(--primary); color: #fff; border-color: var(--primary); }
-
-/* ===== 详情/单页 ===== */
-.detail-main {
-  max-width: var(--max-width);
-  margin: 16px auto;
-  padding: 32px;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-}
-.article-title { margin: 8px 0 12px; font-size: 26px; text-align: center; }
-.article-meta {
-  display: flex;
-  gap: 18px;
-  justify-content: center;
-  flex-wrap: wrap;
-  color: var(--text-light);
-  font-size: 13px;
-  padding-bottom: 18px;
-  border-bottom: 1px solid var(--border);
-}
-.article-content { line-height: 1.9; font-size: 16px; padding-top: 20px; word-break: break-word; }
-.article-content img { height: auto; }
-.article-content table { border-collapse: collapse; width: 100%; }
-.article-content table td, .article-content table th { border: 1px solid var(--border); padding: 6px 10px; }
-.article-sibling { display: flex; flex-direction: column; gap: 8px; margin-top: 28px; font-size: 14px; }
-
-/* ===== 页脚 ===== */
-.site-footer { margin-top: 32px; background: var(--primary-dark); color: rgba(255, 255, 255, .85); }
-.footer-links {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 18px 16px 0;
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.links-group { display: flex; flex-wrap: wrap; gap: 14px; align-items: center; font-size: 13px; }
-.group-name { font-weight: 600; margin-right: 4px; }
-.footer-info {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 12px 16px 20px;
-  text-align: center;
-  font-size: 13px;
-}
-.footer-info p { margin: 4px 0; }
-
-/* ===== 移动端适配 ===== */
-@media (max-width: 768px) {
-  .header-inner { flex-direction: column; align-items: stretch; }
-  .site-search input { flex: 1; width: auto; }
-  .site-colleges { align-self: flex-start; }
-  .site-colleges .colleges-menu { left: 0; right: auto; min-width: 100%; }
-  .banner-slides { height: 200px; }
-  .detail-main, .list-main { padding: 18px 14px; }
-  .article-title { font-size: 22px; }
-  /* 触屏无 hover：子菜单静态平铺（缩进列表），不做浮层 */
-  .site-nav ul.sub-nav {
-    display: block;
-    position: static;
-    border: none;
-    box-shadow: none;
-    background: transparent;
-    min-width: 0;
-    padding: 0 0 6px;
-  }
-  .site-nav .sub-nav li a { color: rgba(255, 255, 255, .9); padding: 8px 16px 8px 34px; }
-  .site-nav .sub-nav li a:hover { background: var(--primary-dark); color: #fff; }
-}
-
-
-/* ===== classic-red 主题差异层（方案 §7：差异仅限 CSS + fragments）===== */
-/* 宋体标题（中小学/党政风） */
-.site-name, .banner-title, .page-title, .section-title, .article-title, .item-title {
-  font-family: "SimSun", "STSong", "Songti SC", serif;
-}
-/* 头部样式参数（theme.json headerStyle=plain → 简洁顶栏） */
-.site-header.header-plain { background: #fff; border-bottom: 2px solid var(--primary); }
-.site-header.header-plain .site-name { color: var(--primary-dark); }
-
-/* B4 友链 Logo：与名称并排小图（高度 ~20px，垂直居中；过宽截断不撑破页脚） */
-.links-group a .link-logo,
-.sp-links-row a .link-logo {
-    height: 20px;
-    width: auto;
-    max-width: 64px;
-    object-fit: contain;
-    vertical-align: middle;
-    margin-right: 4px;
-    border-radius: 2px;
-}
-
-
-/* ===== 左侧栏目导航（docs/11）：有二级节点的模块，栏目/文章页左侧展示兄弟目录 ===== */
-.list-main.has-sidenav, .detail-main.has-sidenav { display: flex; align-items: flex-start; gap: 24px; }
-.has-sidenav .list-body { flex: 1; min-width: 0; }
-.side-nav { flex: none; width: 220px; background: var(--card-bg, #fff); border: 1px solid var(--border); overflow: hidden; }
-.side-nav-head { background: var(--primary); color: #fff; font-size: 20px; font-weight: 700; text-align: center; padding: 18px 12px; letter-spacing: 2px; }
-.side-nav-list { list-style: none; margin: 0; padding: 0; }
-.side-nav-item + .side-nav-item { border-top: 1px dashed var(--border); }
-.side-nav-item a { display: block; padding: 12px 16px; color: var(--text); text-decoration: none; font-size: 15px; transition: background .15s ease, color .15s ease; }
-.side-nav-item a:hover { color: var(--primary); background: var(--bg); }
-.side-nav-item.active a { background: var(--primary); color: #fff; font-weight: 600; text-decoration: none; }
-/* 顶导航二级下拉当前项高亮（docs/11 顺带） */
-.site-nav ul.sub-nav li.active a { color: var(--primary); }
-@media (max-width: 768px) {
-  .list-main.has-sidenav, .detail-main.has-sidenav { flex-direction: column; gap: 12px; }
-  .side-nav { width: 100%; }
-  .side-nav-list { display: flex; overflow-x: auto; -webkit-overflow-scrolling: touch; }
-  .side-nav-item { flex: none; }
-  .side-nav-item + .side-nav-item { border-top: none; border-left: 1px dashed var(--border); }
-  .side-nav-item a { white-space: nowrap; }
-}
-@media print {
-  .side-nav { display: none; }
-  .list-main.has-sidenav, .detail-main.has-sidenav { display: block; }
-}

src/main/resources/templates/themes/classic-red/assets/favicon.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
-  <defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-    <stop offset="0" stop-color="#be4354"/><stop offset="1" stop-color="#7b1220"/>
-  </linearGradient></defs>
-  <rect width="64" height="64" fill="url(#bg)"/>
-  <circle cx="32" cy="25" r="10" fill="#ffffff"/>
-  <path d="M 16 49.3 Q 32 30.7 48 49.3 Z" fill="#ffffff" opacity="0.92"/>
-</svg>

src/main/resources/templates/themes/classic-red/assets/js/main.js

@@ -1,40 +0,0 @@
-/* default 皮肤包脚本：仅首页轮播自动播放与圆点切换，无任何外部依赖 */
-(function () {
-  var slides = document.querySelectorAll('.banner-slide');
-  var dots = document.querySelectorAll('.banner-dots button');
-  if (!slides.length) {
-    return;
-  }
-  var current = 0;
-  var timer = null;
-
-  function show(index) {
-    slides[current].classList.remove('active');
-    if (dots[current]) {
-      dots[current].classList.remove('active');
-    }
-    current = (index + slides.length) % slides.length;
-    slides[current].classList.add('active');
-    if (dots[current]) {
-      dots[current].classList.add('active');
-    }
-  }
-
-  function start() {
-    if (slides.length > 1) {
-      timer = window.setInterval(function () {
-        show(current + 1);
-      }, 5000);
-    }
-  }
-
-  dots.forEach(function (dot, index) {
-    dot.addEventListener('click', function () {
-      window.clearInterval(timer);
-      show(index);
-      start();
-    });
-  });
-
-  start();
-})();

src/main/resources/templates/themes/classic-red/detail.html

@@ -1,58 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node : ${categoryPath}">
-            <a class="crumb-parent" th:href="${url.category(node.id)}" th:text="${node.name}">栏目</a>
-        </th:block>
-        <span>正文</span>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${article.title}">文章标题</h1>
-        <div class="article-meta">
-            <time th:if="${article.publishTime != null}"
-                  th:text="${'发布时间：' + #temporals.format(article.publishTime, 'yyyy-MM-dd HH:mm')}">2026-01-01 10:00</time>
-            <span th:if="${!#strings.isEmpty(article.authorName)}"
-                  th:text="'作者：' + ${article.authorName}">作者</span>
-            <span th:if="${!#strings.isEmpty(article.source)}"
-                  th:text="'来源：' + ${article.source}">来源</span>
-            <span th:text="'浏览量：' + ${article.viewCount}">浏览量</span>
-        </div>
-        <!-- 正文：入库前已经 jsoup 白名单清洗（方案 §8.5），此处允许 utext；
-             其余字段一律 th:text 转义输出 -->
-        <div class="article-content" th:utext="${article.content}">正文</div>
-    </article>
-
-    <nav class="article-sibling">
-        <a th:if="${prevArticle != null}" class="prev"
-           th:href="${url.article(prevArticle.id)}"
-           th:text="'上一篇：' + ${prevArticle.title}">上一篇</a>
-        <a th:if="${nextArticle != null}" class="next"
-           th:href="${url.article(nextArticle.id)}"
-           th:text="'下一篇：' + ${nextArticle.title}">下一篇</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/classic-red/fragments/footer.html

@@ -1,21 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共页脚：联系信息 + 友情链接（分组渲染，方案 §8.1：友链不设独立路由） -->
-<footer class="site-footer" th:fragment="footer">
-    <div class="footer-links" th:if="${!#lists.isEmpty(site.linkGroups)}">
-        <div class="links-group" th:each="group : ${site.linkGroups}">
-            <span class="group-name" th:text="${group.groupName}">分组</span>
-            <a th:each="link : ${group.links}" th:href="${link.linkUrl}" target="_blank" rel="noopener">
-                    <img th:if="${link.logoUrl != null and !#strings.isEmpty(link.logoUrl)}" class="link-logo"
-                         th:src="${url.upload(link.logoUrl)}" th:alt="${link.name}" loading="lazy">
-                    <span th:text="${link.name}">链接</span>
-                </a>
-        </div>
-    </div>
-    <div class="footer-info">
-        <p th:if="${site.config['contact'] != null}" th:text="${site.config['contact']}">联系方式</p>
-        <p th:if="${site.config['copyright'] != null}" th:text="${site.config['copyright']}">版权信息</p>
-        <p th:if="${site.config['beian'] != null}" th:text="${site.config['beian']}">备案号</p>
-    </div>
-</footer>
-</html>

src/main/resources/templates/themes/classic-red/fragments/head.html

@@ -1,24 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<!-- 公共 head 片段：SEO（title/description/canonical）+ 主题资产（方案 §8.3/§8.6） -->
-<head th:fragment="head">
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title th:text="${pageTitle}">页面标题</title>
-    <meta name="description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}"
-          th:content="${seoDescription}">
-    <link rel="canonical" th:if="${canonical != null}" th:href="${canonical}">
-    <!-- og 标签基本三件（C-7，方案 §8.6 canonical/og 同基准） -->
-    <meta property="og:title" th:if="${pageTitle != null}" th:content="${pageTitle}">
-    <meta property="og:description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}" th:content="${seoDescription}">
-    <meta property="og:image" th:if="${ogImage != null}" th:content="${ogImage}">
-    <link rel="stylesheet" th:href="${url.asset('css/main.css')}">
-    <!-- 微调参数 CSS 变量覆盖（方案 §5.3）：位于皮肤 CSS 之后层叠覆盖；值由服务端预构建并校验 -->
-    <style th:if="${not #strings.isEmpty(themeVarsCss)}" th:utext="${themeVarsCss}"></style>
-    <!-- 站点级自定义样式（B3）：位于皮肤 CSS 与微调变量之后层叠覆盖；内容经服务端黑名单强校验后直出 -->
-    <style th:if="${not #strings.isEmpty(customCss)}" th:utext="${customCss}"></style>
-    <!-- favicon：管理端配置了 favicon 键用上传图，未配置输出主题内置兜底 icon（assets/favicon.png） -->
-    <link rel="icon" type="image/png"
-          th:href="${site.config['favicon'] != null ? url.upload(site.config['favicon']) : url.asset('favicon.png')}">
-</head>
-</html>

src/main/resources/templates/themes/classic-red/fragments/header.html

@@ -1,55 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共头部：站点名 + 栏目导航 + 站内搜索 + 专业院系下拉（院系子站切换，《院系子站方案》） -->
-<header class="site-header" th:fragment="header"
-        th:classappend="${themeParams['headerStyle'] == 'plain'} ? 'header-plain'">
-    <div class="header-inner">
-        <div class="site-brand">
-            <img th:if="${site.config['logo'] != null}" class="site-logo"
-                 th:src="${url.upload(site.config['logo'])}" th:alt="${site.name}">
-            <a class="site-name" th:href="${url.home()}" th:text="${site.name}">站点名称</a>
-        </div>
-        <form class="site-search" th:action="${url.search('', null)}" method="get">
-            <input type="text" name="q" placeholder="站内搜索" aria-label="站内搜索">
-            <button type="submit">搜索</button>
-        </form>
-        <!-- 专业院系下拉：顶层站取其子站、院系子站取兄弟站（含自身）；无子站不渲染；文案经 config_json.colleges_label 覆盖 -->
-        <div class="site-colleges" th:if="${!site.colleges.isEmpty()}"
-             th:with="collegesLabel=${site.config['colleges_label'] ?: '专业院系'}">
-            <span class="colleges-toggle">
-                <a href="javascript:void(0)" th:text="${collegesLabel}">专业院系</a>
-                <i class="colleges-arrow">▾</i>
-            </span>
-            <ul class="colleges-menu">
-                <li th:each="col : ${site.colleges}" th:classappend="${col.path == site.path} ? 'active'">
-                    <a th:href="${url.siteHome(col.path, col.publicBaseUrl)}"
-                       th:title="${col.name}" th:text="${col.name}">学院名称</a>
-                </li>
-            </ul>
-        </div>
-    </div>
-    <nav class="site-nav">
-        <ul>
-            <li th:classappend="${currentCategoryId == null and navServiceActive == null} ? 'active'">
-                <a th:href="${url.home()}">首页</a>
-            </li>
-            <li th:each="cat : ${navCategories}"
-                th:classappend="${((currentCategoryId == cat.id or navTopId == cat.id) ? 'active' : '') + (!cat.children.isEmpty() ? ' has-sub' : '')}">
-                <!-- 外链栏目直接外跳；其余进栏目页（方案 §8.1） -->
-                <a th:if="${cat.type == 3}" th:href="${cat.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${cat.name}">栏目</a>
-                <a th:unless="${cat.type == 3}" th:href="${url.category(cat.id)}" th:text="${cat.name}">栏目</a>
-                <!-- 二级下拉：悬停展开（样式见 assets/css/main.css .sub-nav） -->
-                <ul class="sub-nav" th:if="${!cat.children.isEmpty()}">
-                    <li th:each="sub : ${cat.children}"
-                        th:classappend="${sub.id == currentCategoryId} ? 'active'">
-                        <a th:if="${sub.type == 3}" th:href="${sub.linkUrl}" target="_blank" rel="noopener"
-                           th:text="${sub.name}">子栏目</a>
-                        <a th:unless="${sub.type == 3}" th:href="${url.category(sub.id)}" th:text="${sub.name}">子栏目</a>
-                    </li>
-                </ul>
-            </li>
-        </ul>
-    </nav>
-</header>
-</html>

src/main/resources/templates/themes/classic-red/home.html

@@ -1,68 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="home-main">
-    <!-- 首页轮播位（cms_banner position=home；设计尺寸约定 1920×560，见 assets/css 注释） -->
-    <section class="banner" th:if="${!#lists.isEmpty(banners)}">
-        <div class="banner-slides">
-            <a class="banner-slide" th:each="b, stat : ${banners}"
-               th:classappend="${stat.first} ? 'active'"
-               th:href="${b.linkUrl}" th:title="${b.title}">
-                <img th:src="${b.imageUrl}" th:alt="${b.title}">
-                <span class="banner-title" th:text="${b.title}">标题</span>
-            </a>
-        </div>
-        <div class="banner-dots" th:if="${#lists.size(banners) > 1}">
-            <button th:each="b, stat : ${banners}" th:classappend="${stat.first} ? 'active'"
-                    th:aria-label="${'第' + (stat.count) + '张'}"></button>
-        </div>
-    </section>
-
-    <!-- 首页布局模式（docs/16 §4.4）：home_layout 落库后按区块序列渲染（common 兜底骨架，本主题不另设形态） -->
-    <th:block th:if="${layoutBlocks != null}">
-        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: style}" />
-        <th:block th:each="block : ${layoutBlocks}">
-            <th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" />
-        </th:block>
-    </th:block>
-
-    <!-- 回落分支（docs/16 D2）：无 home_layout 时按现状渲染 -->
-    <th:block th:unless="${layoutBlocks != null}">
-    <!-- 置顶/头条区（cms_article topmost 优先） -->
-    <section class="top-strip" th:if="${!#lists.isEmpty(topArticles)}">
-        <h2 class="section-title">头条推荐</h2>
-        <ul>
-            <li th:each="item : ${topArticles}">
-                <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-    </section>
-
-    <!-- 一级栏目区块（每栏目 top 8） -->
-    <section class="category-block" th:each="block : ${categoryBlocks}">
-        <div class="block-head">
-            <h2 th:text="${block.category.name}">栏目名</h2>
-            <a class="more" th:href="${block.moreUrl}">更多 &gt;</a>
-        </div>
-        <ul class="block-list" th:if="${!#lists.isEmpty(block.items)}">
-            <li th:each="item : ${block.items}">
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-        <p class="empty" th:if="${#lists.isEmpty(block.items)}">暂无内容</p>
-    </section>
-    </th:block>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/classic-red/list.html

@@ -1,68 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="list-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb" th:if="${searchMode != true}">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-    <nav class="breadcrumb" th:if="${searchMode == true}">
-        <a th:href="${url.home()}">首页</a>
-        <span>搜索结果</span>
-    </nav>
-
-    <h1 class="page-title" th:if="${searchMode != true}" th:text="${category.name}">栏目名</h1>
-    <h1 class="page-title" th:if="${searchMode == true}" th:text="'搜索：' + ${q}">搜索词</h1>
-
-    <ul class="article-list">
-        <li th:each="item : ${listData.items}">
-            <a class="item-title" th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-            <p class="item-summary" th:if="${!#strings.isEmpty(item.summary)}" th:text="${item.summary}">摘要</p>
-            <div class="item-meta">
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-                <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-            </div>
-        </li>
-    </ul>
-    <p class="empty" th:if="${#lists.isEmpty(listData.items)}">暂无内容</p>
-
-    <!-- 分页（列表页/搜索页共用） -->
-    <nav class="pagination" th:if="${listData.totalPages > 1}"
-         th:with="cur=${listData.page}, total=${listData.totalPages}">
-        <a th:if="${cur > 1}"
-           th:href="${searchMode == true} ? ${url.search(q, cur - 1)} : ${url.category(listData.categoryId) + '?page=' + (cur - 1)}">上一页</a>
-        <a th:each="p : ${#numbers.sequence(1, total)}"
-           th:classappend="${p == cur} ? 'active'"
-           th:href="${searchMode == true} ? ${url.search(q, p)} : ${url.category(listData.categoryId) + '?page=' + p}"
-           th:text="${p}">1</a>
-        <a th:if="${cur < total}"
-           th:href="${searchMode == true} ? ${url.search(q, cur + 1)} : ${url.category(listData.categoryId) + '?page=' + (cur + 1)}">下一页</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/classic-red/single.html

@@ -1,41 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body>
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${category.name}">栏目名</h1>
-        <!-- 单页栏目内容（type=2，入库前已 jsoup 清洗） -->
-        <div class="article-content" th:utext="${category.content}">单页内容</div>
-        <p class="empty" th:if="${#strings.isEmpty(category.content)}">暂无内容</p>
-    </article>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/classic-red/theme.json

@@ -1,17 +0,0 @@
-{
-  "specVersion": 1,
-  "name": "classic-red",
-  "title": "红蓝经典",
-  "version": "1.0.0",
-  "author": "yunhai",
-  "description": "深红横幅头图 + 通栏轮播 + 宋体标题，适合中小学与党政风格的学校（方案 §7）。",
-  "screenshot": "assets/screenshot.png",
-  "bannerSize": "1920x560",
-  "params": [
-    { "key": "primary",     "cssVar": "--primary",      "label": "主色",       "type": "color", "default": "#b01a2e" },
-    { "key": "primaryDark", "cssVar": "--primary-dark", "label": "主色加深",   "type": "color", "default": "#7f1224" },
-    { "key": "bg",          "cssVar": "--bg",           "label": "页面底色",   "type": "color", "default": "#f7f5f2" },
-    { "key": "headerStyle", "label": "头部样式",        "type": "select",      "default": "banner",
-      "options": [ { "value": "banner", "label": "横幅头图" }, { "value": "plain", "label": "简洁顶栏" } ] }
-  ]
-}

src/main/resources/templates/themes/common/fragments/home-blocks.html

@@ -4,60 +4,184 @@
   样式随 fragment 内联携带——themes/common 不注册为皮肤包（无 theme.json），主题资产通道不服务该目录；
   颜色回落站点主题变量（--primary 等 themeVarsCss 注入），无变量时用内置缺省。
   契约：block 为渲染端组装的同构 Map——type/title/category.name/homeStyle/items/moreUrl/subtitle/
-  background/source/linkGroups，与回落模式 categoryBlocks 的块字段兼容。
+  background/source/linkGroups/quickLinks/noticeText/noticeUrl/noticeLevel，与回落模式 categoryBlocks 的块字段兼容。
 -->
 <th:block th:fragment="style">
 <style>
+/* 皮肤穿透层：站点配了 home_layout 时首页由本骨架渲染，颜色必须跟随当前皮肤变量，
+   否则换肤只换了页头页脚、正文区块仍是内置蓝灰（皮肤契约 §6；缺变量时回落内置蓝）。 */
+:root{
+  --plb-primary: var(--primary, #2d8cf0);
+  --plb-text: var(--text, #1f2d3d);
+  --plb-muted: var(--text-light, #8a94a6);
+  --plb-card-bg: var(--card-bg, #ffffff);
+  --plb-page-bg: var(--bg, #f5f7fb);
+  --plb-band-bg: var(--bg, #f5f7fb);
+  --plb-border: var(--border, rgba(0, 0, 0, .08));
+  --plb-radius: var(--radius, 10px);
+  /* 公告条 warn 档：皮肤契约没有告警色变量，取骨架自持的暖色（不跟随皮肤） */
+  --plb-warn-fg: #d46b08;
+  --plb-warn-bg: #fff7e6;
+  --plb-warn-border: #ffd591;
+}
 .plb-section{padding:26px 16px}
 .plb-container{max-width:1200px;margin:0 auto}
 .plb-head{display:flex;align-items:baseline;justify-content:space-between;gap:16px;margin:0 0 14px}
-.plb-head h2{margin:0;font-size:20px;line-height:1.3;padding-left:10px;border-left:4px solid var(--primary,#2d8cf0);color:#1f2d3d}
-.plb-sub{margin:2px 0 0;color:#8a94a6;font-size:12px;letter-spacing:.12em}
-.plb-more{font-size:13px;color:var(--primary,#2d8cf0);text-decoration:none;white-space:nowrap}
+.plb-head h2{margin:0;font-size:20px;line-height:1.3;padding-left:10px;border-left:4px solid var(--plb-primary);color:var(--plb-text)}
+.plb-sub{margin:2px 0 0;color:var(--plb-muted);font-size:12px;letter-spacing:.12em}
+.plb-more{font-size:13px;color:var(--plb-primary);text-decoration:none;white-space:nowrap}
 .plb-more:hover{text-decoration:underline}
 .plb-list{list-style:none;margin:0;padding:0}
-.plb-list li{display:flex;align-items:center;gap:10px;padding:7px 0;border-bottom:1px dashed rgba(0,0,0,.08);font-size:14px}
-.plb-list li a{flex:1;min-width:0;color:#333;text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.plb-list li a:hover{color:var(--primary,#2d8cf0)}
-.plb-list time{color:#999;font-size:12px;flex:none}
-.plb-badge{flex:none;font-size:11px;color:#fff;background:var(--primary,#2d8cf0);border-radius:3px;padding:1px 5px}
-.plb-src{flex:none;font-size:11px;color:var(--primary,#2d8cf0);border:1px solid currentColor;border-radius:3px;padding:1px 6px}
-.plb-empty{color:#98a2b3;font-size:13px;padding:26px 0;text-align:center}
-.plb-card{background:#fff;border:1px solid rgba(0,0,0,.06);border-radius:10px;padding:20px 24px;box-shadow:0 4px 18px rgba(15,34,66,.05)}
-.plb-feat{display:flex;gap:16px;margin:0 0 12px;padding:0 0 12px;border-bottom:1px solid rgba(0,0,0,.06);text-decoration:none;color:#333}
+.plb-list li{display:flex;align-items:center;gap:10px;padding:7px 0;border-bottom:1px dashed var(--plb-border);font-size:14px}
+.plb-list li a{flex:1;min-width:0;color:var(--plb-text);text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.plb-list li a:hover{color:var(--plb-primary)}
+.plb-list time{color:var(--plb-muted);font-size:12px;flex:none}
+.plb-badge{flex:none;font-size:11px;color:#fff;background:var(--plb-primary);border-radius:3px;padding:1px 5px}
+.plb-src{flex:none;font-size:11px;color:var(--plb-primary);border:1px solid currentColor;border-radius:3px;padding:1px 6px}
+.plb-empty{color:var(--plb-muted);font-size:13px;padding:26px 0;text-align:center}
+.plb-card{background:var(--plb-card-bg);border:1px solid var(--plb-border);border-radius:var(--plb-radius);padding:20px 24px;box-shadow:0 4px 18px rgba(15,34,66,.05)}
+.plb-feat{display:flex;gap:16px;margin:0 0 12px;padding:0 0 12px;border-bottom:1px solid var(--plb-border);text-decoration:none;color:var(--plb-text)}
 .plb-feat img{width:200px;height:120px;object-fit:cover;border-radius:6px;flex:none}
-.plb-feat .t{display:block;font-size:16px;font-weight:600;color:#1f2d3d;margin:0 0 6px}
-.plb-feat .s{display:block;color:#8a94a6;font-size:13px;line-height:1.6;margin:0 0 6px}
-.plb-feat .m{color:#999;font-size:12px}
+.plb-feat .t{display:block;font-size:16px;font-weight:600;color:var(--plb-text);margin:0 0 6px}
+.plb-feat .s{display:block;color:var(--plb-muted);font-size:13px;line-height:1.6;margin:0 0 6px}
+.plb-feat .m{color:var(--plb-muted);font-size:12px}
 .plb-grid2{columns:2;column-gap:40px}
 .plb-grid2 li{break-inside:avoid}
-.plb-newshot{position:relative;padding:30px 0;background:#f5f7fb}
+.plb-newshot{position:relative;padding:30px 0;background:var(--plb-band-bg)}
 .plb-newshot-bg{position:absolute;inset:0;background-size:cover;background-position:center}
-.plb-newshot-card{position:relative;background:rgba(255,255,255,.94);border-radius:10px;padding:22px 26px;box-shadow:0 8px 30px rgba(15,34,66,.08)}
+.plb-newshot-card{position:relative;background:var(--plb-card-bg);border-radius:var(--plb-radius);padding:22px 26px;box-shadow:0 8px 30px rgba(15,34,66,.08)}
 .plb-imagewall{display:grid;grid-template-columns:repeat(4,1fr);gap:14px;list-style:none;margin:0;padding:0}
-.plb-imagewall a{text-decoration:none;color:#333}
+.plb-imagewall a{text-decoration:none;color:var(--plb-text)}
 .plb-imagewall img{width:100%;height:120px;object-fit:cover;border-radius:6px;display:block}
 .plb-imagewall .t{display:block;font-size:13px;margin-top:6px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.plb-ticker{background:var(--primary,#2d8cf0);color:#fff;padding:10px 16px;font-size:14px}
+.plb-ticker{background:var(--plb-primary);color:#fff;padding:10px 16px;font-size:14px}
 .plb-ticker-inner{max-width:1200px;margin:0 auto;display:flex;align-items:center;gap:14px}
 .plb-ticker-label{flex:none;font-weight:600;letter-spacing:.08em}
-.plb-ticker-list{display:flex;gap:26px;list-style:none;margin:0;padding:0;overflow:hidden}
-.plb-ticker-list a{color:#fff;text-decoration:none;opacity:.92}
-.plb-ticker-list a:hover{opacity:1;text-decoration:underline}
+/* flex 项自动最小尺寸=min-content，中文可按字断行 → 不锁 nowrap/不收缩就会塌成一字一列 */
+.plb-ticker-list{display:flex;gap:26px;list-style:none;margin:0;padding:0;flex:1;min-width:0;overflow:hidden;white-space:nowrap}
+.plb-ticker-list li{flex:none;min-width:0}
+.plb-ticker-item{display:block;flex:none;max-width:280px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:#fff;text-decoration:none;opacity:.92}
+.plb-ticker-item:hover{opacity:1;text-decoration:underline}
 .plb-gallery-head{text-align:center;margin:0 0 18px}
-.plb-gallery-head h2{margin:0;font-size:22px;color:#1f2d3d}
+.plb-gallery-head h2{margin:0;font-size:22px;color:var(--plb-text)}
 .plb-gallery-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:14px;list-style:none;margin:0;padding:0}
 .plb-gallery-grid img{width:100%;height:150px;object-fit:cover;border-radius:8px;display:block}
-.plb-gallery-grid .t{display:block;font-size:13px;color:#51607a;margin-top:6px;text-align:center;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.plb-gallery-grid .t{display:block;font-size:13px;color:var(--plb-muted);margin-top:6px;text-align:center;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .plb-gallery-grid a{text-decoration:none}
 .plb-links{display:flex;flex-wrap:wrap;gap:10px;list-style:none;margin:0;padding:0}
-.plb-links a{display:inline-block;font-size:13px;color:#51607a;text-decoration:none;border:1px solid rgba(0,0,0,.1);border-radius:16px;padding:4px 14px;background:#fff}
-.plb-links a:hover{color:var(--primary,#2d8cf0);border-color:var(--primary,#2d8cf0)}
+.plb-links a{display:inline-block;font-size:13px;color:var(--plb-muted);text-decoration:none;border:1px solid var(--plb-border);border-radius:16px;padding:4px 14px;background:var(--plb-card-bg)}
+.plb-links a:hover{color:var(--plb-primary);border-color:var(--plb-primary)}
+.plb-quick-grid{display:grid;grid-template-columns:repeat(6,1fr);gap:12px;list-style:none;margin:0;padding:0}
+.plb-quick-link{display:flex;align-items:center;justify-content:center;min-height:62px;padding:10px 12px;font-size:14px;line-height:1.4;text-align:center;color:var(--plb-text);text-decoration:none;background:var(--plb-page-bg);border:1px solid var(--plb-border);border-radius:var(--plb-radius);overflow-wrap:anywhere}
+.plb-quick-link:hover{color:var(--plb-primary);border-color:var(--plb-primary)}
+.plb-notice-bar{background:var(--plb-band-bg);border-top:1px solid var(--plb-border);border-bottom:1px solid var(--plb-border);padding:10px 16px;font-size:14px}
+.plb-notice-inner{max-width:1200px;margin:0 auto;display:flex;align-items:center;gap:12px}
+.plb-notice-tag{flex:none;font-weight:600;color:var(--plb-primary)}
+/* 中文可按字断行，flex 项不锁 min-width:0 就会被长公告挤破容器 */
+.plb-notice-link,.plb-notice-text{flex:1;min-width:0;color:var(--plb-text);text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.plb-notice-link:hover{text-decoration:underline;color:var(--plb-primary)}
+.plb-notice-warn{background:var(--plb-warn-bg);border-color:var(--plb-warn-border)}
+.plb-notice-warn .plb-notice-tag{color:var(--plb-warn-fg)}
+/* 全宽区块必须跨满整行：网格型主题（mint-breeze 系 .home-main 是三列）会把它们塞进单列，
+   非网格父容器下 grid-column 无副作用，故由骨架自带。
+   F2（docs/20）：布局区块经 .plb-anchor（display:contents 预览锚点）包裹时按子选择器等效覆盖。 */
+main > .plb-ticker{grid-column:1 / -1}
+main > .plb-newshot{grid-column:1 / -1}
+main > .plb-section{grid-column:1 / -1}
+main > .plb-notice-bar{grid-column:1 / -1}
+main > .plb-anchor{display:contents;grid-column:auto}
+main > .plb-anchor > .plb-ticker{grid-column:1 / -1}
+main > .plb-anchor > .plb-newshot{grid-column:1 / -1}
+main > .plb-anchor > .plb-section{grid-column:1 / -1}
+main > .plb-anchor > .plb-notice-bar{grid-column:1 / -1}
+
+/* ===== docs/20 D 组件库骨架样式（跟随主题变量；campus-glow 等可自持精细版覆盖） ===== */
+/* D-4 双语标题：themeParams.titleStyle=bilingual 时副题斜体展示（默认 cn 不展示由渲染端守卫） */
+.plb-sub{font-style:italic}
+/* D-1 数字计数带（含 R-45 形状语言：conic-gradient 装饰环） */
+.plb-stats-row{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(4,1fr);gap:16px}
+.plb-stats-row li{text-align:center;padding:14px 8px}
+.plb-stats-row li::before{content:"";display:block;width:34px;height:34px;margin:0 auto 8px;border-radius:50%;
+  background:conic-gradient(from 210deg,var(--plb-primary),#8fd3ff 55%,var(--plb-primary));
+  -webkit-mask:radial-gradient(circle,transparent 9px,#000 10px);mask:radial-gradient(circle,transparent 9px,#000 10px)}
+.plb-num{display:block;font-size:34px;font-weight:700;line-height:1.1;color:var(--plb-primary);font-variant-numeric:tabular-nums}
+.plb-unit{font-size:14px;font-weight:600;margin-left:2px}
+.plb-stats-label{display:block;margin-top:6px;color:var(--plb-muted);font-size:13px}
+/* D-2 图标宫格（quick_links 升级）：形状由主题 iconShape 参数控制（circle/hexagon/square） */
+.plb-quick-grid{grid-template-columns:repeat(6,1fr)}
+.plb-qitem{display:flex;flex-direction:column;align-items:center;gap:8px;padding:14px 8px;text-decoration:none;background:var(--plb-page-bg);border:1px solid var(--plb-border);border-radius:var(--plb-radius);transition:transform .2s,border-color .2s}
+.plb-qitem:hover{transform:translateY(-3px);border-color:var(--plb-primary)}
+.plb-qicon{display:inline-flex;align-items:center;justify-content:center;width:52px;height:52px;color:#fff;background:linear-gradient(135deg,var(--plb-primary),var(--plb-primary, #2d8cf0));border-radius:50%}
+.plb-qicon svg{width:26px;height:26px}
+.plb-shape-square .plb-qicon{border-radius:10px}
+.plb-shape-hexagon .plb-qicon{clip-path:polygon(50% 0,93% 25%,93% 75%,50% 100%,7% 75%,7% 25%);border-radius:0}
+.plb-qfall{font-size:22px;font-weight:700;line-height:1}
+.plb-qname{font-size:14px;color:var(--plb-text)}
+/* D-3 专题大卡 */
+.plb-topics{display:grid;grid-template-columns:repeat(auto-fit,minmax(300px,1fr));gap:16px}
+.plb-topic{position:relative;display:block;border-radius:var(--plb-radius);overflow:hidden;text-decoration:none;min-height:220px;box-shadow:0 6px 20px rgba(15,34,66,.12)}
+.plb-topic img{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;transition:transform .35s}
+.plb-topic:hover img{transform:scale(1.04)}
+.plb-topic-body{position:absolute;left:0;right:0;bottom:0;padding:40px 16px 14px;background:linear-gradient(180deg,transparent,rgba(0,0,0,.72));color:#fff}
+.plb-topic-t{display:block;font-size:17px;font-weight:600}
+.plb-topic-d{display:block;margin-top:4px;font-size:13px;opacity:.85;line-height:1.5}
+.plb-topic-cta{display:inline-block;margin-top:10px;font-size:13px;border:1px solid rgba(255,255,255,.7);border-radius:16px;padding:3px 14px;color:#fff !important;text-decoration:none}
+.plb-topic-cta:hover{background:rgba(255,255,255,.15)}
+/* D-5 视频/VR 校园 */
+.plb-video{position:relative;display:block;border-radius:var(--plb-radius);overflow:hidden;box-shadow:0 8px 26px rgba(15,34,66,.16)}
+.plb-video img{width:100%;height:340px;object-fit:cover;display:block}
+.plb-video-play{position:absolute;inset:0;display:flex;align-items:center;justify-content:center}
+.plb-video-play::before{content:"";position:absolute;width:74px;height:74px;border-radius:50%;background:rgba(0,0,0,.45);backdrop-filter:blur(2px)}
+.plb-video-play::after{content:"";position:absolute;width:0;height:0;border-style:solid;border-width:14px 0 14px 24px;border-color:transparent transparent transparent #fff;margin-left:6px}
+/* D-6 学术活动（大日期块横带） */
+.plb-events{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:14px}
+.plb-event{display:flex;gap:14px;align-items:center;padding:14px 16px;background:var(--plb-card-bg);border:1px solid var(--plb-border);border-radius:var(--plb-radius);text-decoration:none}
+.plb-event-date{flex:none;width:64px;text-align:center;color:var(--plb-primary)}
+.plb-event-date b{display:block;font-size:30px;line-height:1;font-weight:700}
+.plb-event-date i{display:block;font-style:normal;font-size:11px;color:var(--plb-muted);margin-top:3px}
+.plb-event-t{display:block;color:var(--plb-text);font-size:15px;font-weight:600;line-height:1.4}
+.plb-event-loc{display:block;color:var(--plb-muted);font-size:12px;margin-top:3px}
+.plb-event:hover .plb-event-t{color:var(--plb-primary)}
+/* D-7 名师风采 */
+.plb-people{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fill,minmax(190px,1fr));gap:16px}
+.plb-person{display:flex;flex-direction:column;align-items:center;text-align:center;padding:20px 12px;background:var(--plb-card-bg);border:1px solid var(--plb-border);border-radius:var(--plb-radius)}
+.plb-person-avatar{width:84px;height:84px;border-radius:50%;overflow:hidden;display:flex;align-items:center;justify-content:center;background:linear-gradient(135deg,var(--plb-primary),#8fb8f0);color:#fff;font-size:32px;font-weight:700}
+.plb-person-avatar img{width:100%;height:100%;object-fit:cover}
+.plb-person-name{margin-top:12px;font-size:16px;font-weight:600;color:var(--plb-text)}
+.plb-person-title{margin-top:2px;font-size:12px;color:var(--plb-primary)}
+.plb-person-bio{margin-top:8px;font-size:13px;color:var(--plb-muted);line-height:1.6}
+/* D-8 campus_wall 瀑布流（columns 流式，块高天然错落） */
+.plb-gallery-grid.masonry{display:block;columns:4;column-gap:14px}
+.plb-gallery-grid.masonry li{break-inside:avoid;margin-bottom:14px}
+.plb-gallery-grid.masonry img{height:auto}
+/* D-9 徽章带 */
+.plb-badges{list-style:none;margin:0;padding:0;display:flex;flex-wrap:wrap;justify-content:center;gap:28px}
+.plb-badge-item{display:flex;flex-direction:column;align-items:center;text-align:center;max-width:130px}
+.plb-badge-item img{width:72px;height:72px;object-fit:contain}
+.plb-badge-label{margin-top:8px;font-size:14px;font-weight:600;color:var(--plb-text)}
+.plb-badge-desc{margin-top:2px;font-size:12px;color:var(--plb-muted)}
+/* D-8/D-42 骨架共享入场动效（R-42：所有主题自动生效，主题参数 animation=off 关闭） */
+.plb-anim{opacity:0;transform:translateY(24px);transition:opacity .6s ease,transform .6s ease}
+.plb-anim.plb-in{opacity:1;transform:none}
+@media (prefers-reduced-motion: reduce){.plb-anim{opacity:1;transform:none;transition:none}}
+main > .plb-anchor > .plb-stats-band{grid-column:1 / -1}
+main > .plb-anchor > .plb-section{grid-column:1 / -1}
 @media (max-width:768px){
-  .plb-grid2{grid-template-columns:1fr}
+  .plb-stats-row{grid-template-columns:repeat(2,1fr)}
+  .plb-topics{grid-template-columns:1fr}
+  .plb-video img{height:210px}
+  .plb-gallery-grid.masonry{columns:2}
+  .plb-quick-grid{grid-template-columns:repeat(3,1fr)}
+  .plb-people{grid-template-columns:repeat(2,1fr)}
+  .plb-badges{gap:16px}
+}
+@media (max-width:768px){
+  .plb-grid2{columns:1}
   .plb-imagewall{grid-template-columns:repeat(2,1fr)}
   .plb-gallery-grid{grid-template-columns:repeat(2,1fr)}
+  .plb-quick-grid{grid-template-columns:repeat(3,1fr)}
   .plb-feat img{width:120px;height:80px}
+  .plb-ticker-item{max-width:150px}
 }
 </style>
 </th:block>
@@ -79,6 +203,15 @@
     <th:block th:case="'ticker'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbTicker(${block})}" /></th:block>
     <th:block th:case="'gallery'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbGallery(${block})}" /></th:block>
     <th:block th:case="'links'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbLinks(${block})}" /></th:block>
+    <th:block th:case="'quick_links'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbQuickLinks(${block})}" /></th:block>
+    <th:block th:case="'notice_bar'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbNoticeBar(${block})}" /></th:block>
+    <!-- docs/20 D-1~D-9 新组件（骨架兜底渲染；A 档主题可自持精细版覆盖） -->
+    <th:block th:case="'stats_band'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbStatsBand(${block})}" /></th:block>
+    <th:block th:case="'featured_topics'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbFeaturedTopics(${block})}" /></th:block>
+    <th:block th:case="'video_tour'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbVideoTour(${block})}" /></th:block>
+    <th:block th:case="'events'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbEvents(${block})}" /></th:block>
+    <th:block th:case="'people'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbPeople(${block})}" /></th:block>
+    <th:block th:case="'badges'"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbBadges(${block})}" /></th:block>
     <th:block th:case="*"><th:block th:replace="~{'themes/common/fragments/home-blocks' :: plbCard(${block})}" /></th:block>
   </th:block>
 </th:block>
@@ -87,12 +220,13 @@
 <div class="plb-head" th:fragment="head(block)">
   <div>
     <h2 th:text="${block.title}">区块标题</h2>
-    <p class="plb-sub" th:if="${!#strings.isEmpty(block['subtitle'])}" th:text="${block['subtitle']}">副题</p>
+    <!-- D-4（docs/20）：中英双语副题；themeParams.titleStyle=cn 时隐藏（主题级开关） -->
+    <p class="plb-sub" th:if="${!#strings.isEmpty(block['subtitle']) and (themeParams == null or themeParams['titleStyle'] == null or themeParams['titleStyle'] != 'cn')}" th:text="${block['subtitle']}">副题</p>
   </div>
   <a class="plb-more" th:if="${!#strings.isEmpty(block['moreUrl'])}" th:href="${block['moreUrl']}">更多 &gt;</a>
 </div>
 
-<!-- 空态 -->
+<!-- 空态（各形态引用时守卫必须包在 th:block 外层：th:replace 优先级 100 先于 th:if 300 求值，写在同一标签上等于没写） -->
 <div class="plb-empty" th:fragment="empty(block)">
   <p>该区块暂无内容</p>
 </div>
@@ -121,7 +255,9 @@
           <time th:if="${item.publishTime != null}" th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
         </li>
       </ul>
-      <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}" th:if="${#lists.isEmpty(block.items)}"></div>
+      <th:block th:if="${#lists.isEmpty(block.items)}">
+        <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+      </th:block>
     </div>
   </div>
 </section>
@@ -138,7 +274,9 @@
           <time th:if="${item.publishTime != null}" th:text="${#temporals.format(item.publishTime, 'MM-dd')}">01-01</time>
         </li>
       </ul>
-      <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}" th:if="${#lists.isEmpty(block.items)}"></div>
+      <th:block th:if="${#lists.isEmpty(block.items)}">
+        <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+      </th:block>
     </div>
   </div>
 </section>
@@ -158,7 +296,9 @@
           <span class="plb-badge" th:if="${item.topmost == 1}">置顶</span>
         </li>
       </ul>
-      <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}" th:if="${#lists.isEmpty(block.items)}"></div>
+      <th:block th:if="${#lists.isEmpty(block.items)}">
+        <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+      </th:block>
     </div>
   </div>
 </section>
@@ -176,7 +316,10 @@
           <time th:if="${item.publishTime != null}" th:text="${#temporals.format(item.publishTime, 'MM-dd')}">01-01</time>
         </li>
       </ul>
-      <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}" th:if="${#lists.isEmpty(block.items)}"></div>
+      <!-- 守卫必须包在 th:block 外层：th:replace（100）先于 th:if（300）求值，写在同一标签上等于没写 -->
+      <th:block th:if="${#lists.isEmpty(block.items)}">
+        <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+      </th:block>
     </div>
   </div>
 </section>
@@ -193,7 +336,9 @@
         </a>
       </li>
     </ul>
-    <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}" th:if="${#lists.isEmpty(block.items)}"></div>
+    <th:block th:if="${#lists.isEmpty(block.items)}">
+      <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+    </th:block>
   </div>
 </section>
 
@@ -216,7 +361,8 @@
       <h2 th:text="${block.title}">线上展厅</h2>
       <p class="plb-sub" th:if="${!#strings.isEmpty(block.subtitle)}" th:text="${block.subtitle}">Online Exhibition Hall</p>
     </div>
-    <ul class="plb-gallery-grid">
+    <!-- D-8（docs/20）：layout=masonry 时瀑布流（columns 错落） -->
+    <ul class="plb-gallery-grid" th:classappend="${block['layout'] == 'masonry' ? 'masonry' : ''}">
       <li th:each="g : ${block.items}">
         <a th:href="${g.linkUrl}" th:title="${g.title}">
           <img th:src="${g.imageUrl}" th:alt="${g.title}">
@@ -243,3 +389,329 @@
     </div>
   </div>
 </section>
+
+<!-- 区块：快捷入口宫格（quick_links，v2 手册 §2.8 类型 A）：区块内联数组，不读友情链接表；
+     非法 url 项已由渲染端丢弃，这里只消费 block['quickLinks']=[{name,url}] -->
+<section class="plb-section plb-quick-links" th:fragment="plbQuickLinks(block)" aria-label="快捷入口">
+  <div class="plb-container">
+    <div class="plb-card">
+      <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+      <!-- D-2（docs/20）：图标宫格——内置 SVG 图标集，未选图标降级首字徽章；形状随主题 iconShape 参数 -->
+      <ul class="plb-quick-grid" th:with="shapeCls=${themeParams != null and themeParams['iconShape'] != null ? 'plb-shape-' + themeParams['iconShape'] : 'plb-shape-circle'}"
+          th:if="${!#lists.isEmpty(block['quickLinks'])}">
+        <li th:each="l : ${block['quickLinks']}">
+          <a class="plb-qitem" th:classappend="${shapeCls}" th:href="${l.url}">
+            <span class="plb-qicon">
+              <th:block th:if="${!#strings.isEmpty(l['icon'])}">
+                <th:block th:replace="~{'themes/common/fragments/home-blocks' :: icon(${l['icon']})}" />
+              </th:block>
+              <span class="plb-qfall" th:unless="${!#strings.isEmpty(l['icon'])}"
+                    th:text="${#strings.length(l.name) > 0 ? #strings.substring(l.name, 0, 1) : ''}">首</span>
+            </span>
+            <span class="plb-qname" th:text="${l.name}">入口名</span>
+          </a>
+        </li>
+      </ul>
+      <!-- 空态守卫必须包在 th:block 外层（坑①：th:replace 优先级 100 先于 th:if 300 求值） -->
+      <th:block th:if="${#lists.isEmpty(block['quickLinks'])}">
+        <div th:replace="~{'themes/common/fragments/home-blocks' :: empty(${block})}"></div>
+      </th:block>
+    </div>
+  </div>
+</section>
+
+<!-- 区块：公告条（notice_bar，v2 手册 §2.8 类型 B）：单条手填通告，非滚动非文章列表；
+     level 缺省 info，warn 走告警配色；url 非法时渲染端置空 → 退化为纯文本 -->
+<div class="plb-notice-bar" th:fragment="plbNoticeBar(block)" role="note"
+     th:if="${!#strings.isEmpty(block['noticeText'])}"
+     th:classappend="${block['noticeLevel'] == 'warn' ? 'plb-notice-warn' : 'plb-notice-info'}">
+  <div class="plb-notice-inner">
+    <span class="plb-notice-tag" th:text="${block['title']}">公告</span>
+    <a class="plb-notice-link" th:if="${!#strings.isEmpty(block['noticeUrl'])}"
+       th:href="${block['noticeUrl']}" th:text="${block['noticeText']}">公告正文</a>
+    <span class="plb-notice-text" th:unless="${!#strings.isEmpty(block['noticeUrl'])}"
+          th:text="${block['noticeText']}">公告正文</span>
+  </div>
+</div>
+
+<!--
+  F2（docs/20）实时预览监听脚本：管理端首页布局编辑器（iframe 加载正式门户）经 postMessage
+  发送未保存的编排模拟——{type:'cms-layout-preview', order:[区块id…], cssVars:{…}}。
+  行为：按 order 重排/隐藏 [data-plb-id] 锚点（display:contents 包裹层，零布局影响）；
+  未知 id（未保存的新区块）静默忽略 → 编辑器侧提供手动刷新兜底（D-3 降级路径）。
+  安全：仅 DOM 移动/显隐与 CSS 变量赋值（textContent/innerHTML 一概不碰），payload 严格校形。
+  引用位置：主题 home.html 布局分支随 :: style 一并引入一次。
+-->
+<th:block th:fragment="previewScript">
+<script>
+(function () {
+  if (window.__cmsLayoutPreviewBound) { return; }
+  window.__cmsLayoutPreviewBound = true;
+  window.addEventListener('message', function (ev) {
+    var data = ev.data;
+    if (!data || data.type !== 'cms-layout-preview') { return; }
+    var anchors = Array.prototype.slice.call(document.querySelectorAll('[data-plb-id]'));
+    if (!anchors.length) { return; }
+    var order = Array.isArray(data.order) ? data.order.filter(function (x) {
+      return typeof x === 'string' && x.length <= 64;
+    }) : null;
+    if (order) {
+      var byId = {};
+      anchors.forEach(function (a) { byId[a.getAttribute('data-plb-id')] = a; });
+      var parent = anchors[0].parentNode;
+      order.forEach(function (id) {
+        var a = byId[id];
+        if (a) { a.style.display = 'contents'; parent.appendChild(a); }
+      });
+      anchors.forEach(function (a) {
+        if (order.indexOf(a.getAttribute('data-plb-id')) < 0) { a.style.display = 'none'; }
+      });
+    }
+    if (data.cssVars && typeof data.cssVars === 'object') {
+      var bad = /[^a-zA-Z0-9-_, .#%()]/;
+      Object.keys(data.cssVars).forEach(function (k) {
+        if (/^--[a-zA-Z][\w-]*$/.test(k) && !bad.test(String(data.cssVars[k]))) {
+          document.documentElement.style.setProperty(k, data.cssVars[k]);
+        }
+      });
+    }
+  });
+})();
+</script>
+</th:block>
+
+<!--
+  ===== docs/20 D-1~D-9 新组件骨架 fragment（追加于文件尾部） =====
+  契约键：stats_band.stats / featured_topics.items[{title,description,imageUrl,linkUrl,ctaText,ctaUrl}] /
+  video_tour.{cover,videoUrl} / events.items[{title,linkUrl,eventDate,location}] /
+  people.items[{name,title,bio,avatar}] / badges.items[{label,desc,image}]。
+  空数据由渲染端直接不产出区块（R-44），此处守卫为双保险。
+-->
+
+<!-- D-1 数字计数带：count-up 动画由共享动效脚本驱动（data-plb-countup） -->
+<section class="plb-section plb-stats-band" th:fragment="plbStatsBand(block)" aria-label="数字计数">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <ul class="plb-stats-row" th:if="${!#lists.isEmpty(block['stats'])}">
+      <li th:each="st : ${block['stats']}">
+        <span class="plb-num">
+          <span class="plb-count" th:attr="data-plb-countup=${st['value']}" th:text="${st['value']}">3.2</span><span
+          class="plb-unit" th:if="${!#strings.isEmpty(st['unit'])}" th:text="${st['unit']}">万</span>
+        </span>
+        <span class="plb-stats-label" th:text="${st['label']}">在校生</span>
+      </li>
+    </ul>
+  </div>
+</section>
+
+<!-- D-3 专题大卡：大图 + 标题 + 描述 + CTA 按钮（数据 = 轮播管理「专题大卡」位）。
+     整卡主链接 = linkUrl；CTA 按钮 = ctaUrl（无 ctaUrl 时回落 linkUrl），span+data-href 由脚本转 a 语义防止嵌套 a -->
+<section class="plb-section" th:fragment="plbFeaturedTopics(block)" aria-label="专题推荐" th:if="${!#lists.isEmpty(block.items)}">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <div class="plb-topics">
+      <a class="plb-topic" th:each="t : ${block.items}" th:href="${!#strings.isEmpty(t['ctaUrl']) ? t['ctaUrl'] : t['linkUrl']}">
+        <img th:src="${t['imageUrl']}" th:alt="${t['title']}">
+        <span class="plb-topic-body">
+          <span class="plb-topic-t" th:text="${t['title']}">专题标题</span>
+          <span class="plb-topic-d" th:if="${!#strings.isEmpty(t['description'])}" th:text="${t['description']}">专题描述</span>
+          <span class="plb-topic-cta" th:if="${!#strings.isEmpty(t['ctaText'])}" th:text="${t['ctaText']}">进入专题</span>
+        </span>
+      </a>
+    </div>
+  </div>
+</section>
+
+<!-- D-5 视频/VR 校园：封面大图 + 播放按钮（点击开新窗跳视频/VR 地址） -->
+<section class="plb-section" th:fragment="plbVideoTour(block)" aria-label="云端校园">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <a class="plb-video" th:href="${block['videoUrl']}" target="_blank" rel="noopener">
+      <img th:src="${block['cover']}" th:alt="${block['title']}">
+      <span class="plb-video-play"></span>
+    </a>
+  </div>
+</section>
+
+<!-- D-6 学术日历/活动：大日期块（日 / 年月两段）+ 活动名 + 地点（数据 = 轮播管理「学术活动」位） -->
+<section class="plb-section" th:fragment="plbEvents(block)" aria-label="学术活动" th:if="${!#lists.isEmpty(block.items)}">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <ul class="plb-events">
+      <li th:each="e : ${block.items}">
+        <a class="plb-event" th:href="${e['linkUrl']}">
+          <span class="plb-event-date" th:if="${e['eventDate'] != null}">
+            <b th:text="${#temporals.format(e['eventDate'], 'dd')}">28</b>
+            <i th:text="${#temporals.format(e['eventDate'], 'yyyy-MM')}">2026-09</i>
+          </span>
+          <span class="plb-event-date" th:unless="${e['eventDate'] != null}">
+            <b>·</b><i>待定</i>
+          </span>
+          <span>
+            <span class="plb-event-t" th:text="${e['title']}">活动名称</span>
+            <span class="plb-event-loc" th:if="${!#strings.isEmpty(e['location'])}" th:text="${e['location']}">活动地点</span>
+          </span>
+        </a>
+      </li>
+    </ul>
+  </div>
+</section>
+
+<!-- D-7 名师风采：圆头像（无头像首字徽章）+ 姓名 + 头衔 + 简介（数据 = 人物管理） -->
+<section class="plb-section" th:fragment="plbPeople(block)" aria-label="名师风采" th:if="${!#lists.isEmpty(block.items)}">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <ul class="plb-people">
+      <li class="plb-person" th:each="pp : ${block.items}">
+        <span class="plb-person-avatar">
+          <img th:if="${!#strings.isEmpty(pp['avatar'])}" th:src="${url.upload(pp['avatar'])}" th:alt="${pp['name']}">
+          <span th:unless="${!#strings.isEmpty(pp['avatar'])}"
+                th:text="${#strings.length(pp['name']) > 0 ? #strings.substring(pp['name'], 0, 1) : ''}">师</span>
+        </span>
+        <span class="plb-person-name" th:text="${pp['name']}">姓名</span>
+        <span class="plb-person-title" th:if="${!#strings.isEmpty(pp['title'])}" th:text="${pp['title']}">头衔</span>
+        <span class="plb-person-bio" th:if="${!#strings.isEmpty(pp['bio'])}" th:text="${pp['bio']}">一句话简介</span>
+      </li>
+    </ul>
+  </div>
+</section>
+
+<!-- D-9 排名/学科评估徽章带 -->
+<section class="plb-section" th:fragment="plbBadges(block)" aria-label="实力声誉" th:if="${!#lists.isEmpty(block.items)}">
+  <div class="plb-container">
+    <div th:replace="~{'themes/common/fragments/home-blocks' :: head(${block})}"></div>
+    <ul class="plb-badges">
+      <li class="plb-badge-item" th:each="bd : ${block.items}">
+        <img th:src="${url.upload(bd['image'])}" th:alt="${bd['label']}">
+        <span class="plb-badge-label" th:text="${bd['label']}">软科排名</span>
+        <span class="plb-badge-desc" th:if="${!#strings.isEmpty(bd['desc'])}" th:text="${bd['desc']}">前 100 强</span>
+      </li>
+    </ul>
+  </div>
+</section>
+
+<!--
+  D-2 内置通用 SVG 图标集（docs/20 §3.3 定案 2：平台内置约 20 个，不引外部 CDN）。
+  24x24 线条风格，stroke=currentColor；管理端图标选择器同 key 对应（front IconGrid）。
+  SpEL 对 Map 缺失键访问会抛错——l['icon'] 的 Map 取值安全（缺键返回 null），不用的 g 分支整组不渲染。
+-->
+<svg th:fragment="icon(name)" class="plb-svg-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+     stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+  <!-- 招生（学士帽） -->
+  <g th:if="${name == 'zhaosheng'}"><path d="M3 9.5 12 4.5 21 9.5 12 14.5 3 9.5z"/><path d="M7 12v4.5c0 1 2.2 2 5 2s5-1 5-2V12"/><path d="M21 9.5V15"/></g>
+  <!-- 就业（公文包） -->
+  <g th:if="${name == 'jiuye'}"><rect x="3.5" y="8" width="17" height="11.5" rx="2"/><path d="M9 8V6.2C9 5.5 9.6 5 10.3 5h3.4c.7 0 1.3.5 1.3 1.2V8"/><path d="M3.5 12.5h17"/></g>
+  <!-- 图书馆（书） -->
+  <g th:if="${name == 'tushuguan'}"><path d="M4 19.5 4.9 6.5 11 5v15"/><path d="M11 20h9V8l-7.9-1.5"/><path d="M4 19.5h7"/><path d="M14.5 11.5h3M14.5 15h3"/></g>
+  <!-- 办事大厅（对话） -->
+  <g th:if="${name == 'banshi'}"><path d="M4 5.5h16v10H9.5L5 19.2V15.5H4z"/></g>
+  <!-- 信息公开（眼睛） -->
+  <g th:if="${name == 'xinxi'}"><path d="M2.5 12C5 7.5 8.3 5.5 12 5.5S19 7.5 21.5 12C19 16.5 15.7 18.5 12 18.5S5 16.5 2.5 12z"/><circle cx="12" cy="12" r="3"/></g>
+  <!-- 校友（人群） -->
+  <g th:if="${name == 'xiaoyou'}"><circle cx="9" cy="8.5" r="3"/><path d="M3.5 19c0-3 2.5-5 5.5-5s5.5 2 5.5 5"/><circle cx="17" cy="9.5" r="2.2"/><path d="M16 14.2c2.6.3 4.5 2.1 4.5 4.8"/></g>
+  <!-- 邮箱 -->
+  <g th:if="${name == 'youjian'}"><rect x="3" y="5" width="18" height="14" rx="2"/><path d="m3.5 7 8.5 6 8.5-6"/></g>
+  <!-- 电话 -->
+  <g th:if="${name == 'dianhua'}"><path d="M5 4h3.5l1.7 4.3-2.3 1.8a12.5 12.5 0 0 0 5.9 5.9l1.8-2.3L20 15.4V19a1.5 1.5 0 0 1-1.6 1.5C10 20 4 14 3.5 5.6A1.5 1.5 0 0 1 5 4z"/></g>
+  <!-- 地图（定位） -->
+  <g th:if="${name == 'ditu'}"><path d="M12 21.5c4.2-5 6.8-8 6.8-11.5a6.8 6.8 0 1 0-13.6 0c0 3.5 2.6 6.5 6.8 11.5z"/><circle cx="12" cy="9.7" r="2.4"/></g>
+  <!-- 新闻 -->
+  <g th:if="${name == 'xinwen'}"><rect x="3" y="5" width="18" height="14" rx="1.5"/><path d="M6.5 9h6M6.5 12.5h6M6.5 16h6"/><rect x="15.5" y="9" width="3" height="7.5" rx=".5"/></g>
+  <!-- 日历 -->
+  <g th:if="${name == 'rili'}"><rect x="3.5" y="5" width="17" height="15.5" rx="2"/><path d="M3.5 10h17M8 3v4M16 3v4"/></g>
+  <!-- 视频 -->
+  <g th:if="${name == 'shipin'}"><circle cx="12" cy="12" r="8.5"/><path d="M10 8.5 16 12l-6 3.5z"/></g>
+  <!-- 微信 -->
+  <g th:if="${name == 'weixin'}"><path d="M9.5 5.5C6 5.5 3 7.8 3 10.7c0 1.6.9 3 2.3 4L5 17l2.6-1.3c.6.2 1.3.3 1.9.3"/><path d="M21.5 14.8c0-2.4-2.3-4.3-5.1-4.3s-5.1 1.9-5.1 4.3 2.3 4.3 5.1 4.3c.6 0 1.2-.1 1.7-.3L20.5 20l-.5-1.7c.9-.8 1.5-2.1 1.5-3.5z"/></g>
+  <!-- 微博 -->
+  <g th:if="${name == 'weibo'}"><path d="M10.5 19.5c-3.5 0-6.5-2-6.5-4.7 0-2.9 3.3-5.6 6.8-5.6 3 0 6.5 1.6 6.5 4.2 0 2.3-1.9 4.3-4.4 4.3-1.8 0-3.6-.8-3.6-2 0-.8.7-1.5 1.7-1.5.9 0 1.5.5 1.5 1.1 0 .4-.3.7-.7.8"/><path d="M15.5 4.5c2.9 0 5 1.8 5.2 4.3"/><path d="M15.8 7.2c1.5 0 2.7.9 2.8 2.3"/></g>
+  <!-- 抖音（音符） -->
+  <g th:if="${name == 'douyin'}"><circle cx="8" cy="17.5" r="3"/><path d="M11 17.5V4.5l7 2v3.2l-4.6-1.3"/></g>
+  <!-- B站 -->
+  <g th:if="${name == 'bilibili'}"><rect x="3" y="6.5" width="18" height="12.5" rx="3"/><path d="M7 4l2.2 2.4M17 4l-2.2 2.4"/><path d="M9.2 10.5v4M14.8 10.5v4"/></g>
+  <!-- 链接 -->
+  <g th:if="${name == 'lianjie'}"><path d="m9.5 14.5 5-5"/><path d="m8 12-3 3a4 4 0 0 0 5.7 5.7l3-3"/><path d="m16 12 3-3a4 4 0 0 0-5.7-5.7l-3 3"/></g>
+  <!-- 档案 -->
+  <g th:if="${name == 'dangan'}"><path d="M6 3.5h8.5L18 7v13.5H6z"/><path d="M14 3.5V7h4"/><path d="M9 11h6M9 14.5h6M9 18h3.5"/></g>
+  <!-- 校历/校史（建筑） -->
+  <g th:if="${name == 'xiaoli'}"><path d="M4 21V10l8-6.2L20 10v11"/><path d="M10 21v-6h4v6"/><path d="M4 21h16"/><path d="M9.5 10.5h5"/></g>
+  <!-- 体育（奖杯） -->
+  <g th:if="${name == 'tiyu'}"><path d="M8 4.5h8v5a4 4 0 0 1-8 0z"/><path d="M8 5.5H5v1.6A3.4 3.4 0 0 0 8.4 10M16 5.5h3v1.6A3.4 3.4 0 0 1 15.6 10"/><path d="M12 13.5v3M8.5 20h7M9.8 20c0-1.7.9-3.5 2.2-3.5s2.2 1.8 2.2 3.5"/></g>
+  <!-- 艺术（调色板） -->
+  <g th:if="${name == 'yishu'}"><path d="M12 3a9 9 0 0 0 0 18c1.4 0 2-.8 2-1.7 0-1.5-1.6-1.9-1.6-3.1 0-1 .8-1.7 2-1.7h1.8A4.8 4.8 0 0 0 21 9.7C21 5.9 17 3 12 3z"/><circle cx="7.8" cy="10.5" r=".9"/><circle cx="12" cy="7.6" r=".9"/><circle cx="16.2" cy="10" r=".9"/></g>
+  <!-- 实验（烧瓶） -->
+  <g th:if="${name == 'shiyan'}"><path d="M10 3.5h4M11 3.5v6l-4.6 8.2A2 2 0 0 0 8.2 20.5h7.6a2 2 0 0 0 1.8-2.8L13 9.5v-6"/><path d="M8.5 14.5h7"/></g>
+</svg>
+
+<!--
+  D-8 配套 · 骨架共享动效脚本（R-42）：滚动入场（fade-in-up + stagger）+ 数字计数 count-up。
+  一处实现全局生效（D-8 决策），主题经 theme.json 参数 animation=off 关闭（由引用方 th:if 守卫）；
+  尊重 prefers-reduced-motion。观察目标 = main 的区块级直接子元素（.plb-anchor 子节点或 main 直属区块根）。
+-->
+<th:block th:fragment="motionScript">
+<script>
+(function () {
+  if (window.__cmsMotionBound) { return; }
+  window.__cmsMotionBound = true;
+  var reduced = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+  if (reduced) { return; }
+  function targets() {
+    var main = document.querySelector('main');
+    if (!main) { return []; }
+    var out = [];
+    Array.prototype.forEach.call(main.children, function (n) {
+      if (n.classList && n.classList.contains('plb-anchor')) {
+        Array.prototype.forEach.call(n.children, function (c) { out.push(c); });
+      } else if (n.tagName === 'SECTION' || (n.tagName === 'DIV' && n.getAttribute('role') === 'note')) {
+        out.push(n);
+      }
+    });
+    return out;
+  }
+  var els = targets();
+  els.forEach(function (el, i) {
+    el.classList.add('plb-anim');
+    el.style.transitionDelay = Math.min(i * 80, 400) + 'ms';
+  });
+  if (!('IntersectionObserver' in window)) {
+    els.forEach(function (el) { el.classList.add('plb-in'); });
+  } else {
+    var io = new IntersectionObserver(function (entries) {
+      entries.forEach(function (en) {
+        if (en.isIntersecting) {
+          en.target.classList.add('plb-in');
+          io.unobserve(en.target);
+        }
+      });
+    }, { threshold: 0.12 });
+    els.forEach(function (el) { io.observe(el); });
+  }
+  document.querySelectorAll('[data-plb-countup]').forEach(function (node) {
+    var raw = (node.textContent || '').trim();
+    var m = raw.match(/^([^0-9]*)([0-9,]+(?:\.[0-9]+)?)(.*)$/);
+    if (!m) { return; }
+    var prefix = m[1], numText = m[2].replace(/,/g, ''), suffix = m[3];
+    var target = parseFloat(numText);
+    if (isNaN(target)) { return; }
+    var decimals = (numText.split('.')[1] || '').length;
+    var t0 = null, dur = 1200;
+    function step(ts) {
+      if (!t0) { t0 = ts; }
+      var p = Math.min((ts - t0) / dur, 1);
+      var eased = 1 - Math.pow(1 - p, 3);
+      node.textContent = prefix + (target * eased).toFixed(decimals) + suffix;
+      if (p < 1) { requestAnimationFrame(step); }
+    }
+    var cio = new IntersectionObserver(function (entries) {
+      entries.forEach(function (en) {
+        if (en.isIntersecting) {
+          cio.disconnect();
+          requestAnimationFrame(step);
+        }
+      });
+    }, { threshold: 0.4 });
+    cio.observe(node);
+  });
+})();
+</script>
+</th:block>

src/main/resources/templates/themes/common/fragments/search.html

@@ -0,0 +1,77 @@
+<!--
+  D-10（docs/20）搜索浮层 · 通用 fragment：theme.json 参数 searchStyle 控制门户搜索形态——
+  · inline（缺省）= 保留主题 header 自有内联搜索表单（现状外观，零变化）
+  · none          = 不渲染任何搜索入口
+  · overlay       = 隐藏内联表单，渲染右上「放大镜」按钮 + 全屏搜索浮层（本文件实现）
+  引用方式：主题 header.html 在其内联搜索表单位置——
+    <th:block th:if="${themeParams != null and themeParams['searchStyle'] == 'overlay'}"
+              th:replace="~{'themes/common/fragments/search' :: overlay(${url})}" />
+    <form class="…" th:unless="${themeParams != null and themeParams['searchStyle'] == 'overlay'}" …>（inline/缺省保留原表单）
+  样式/脚本自持（不引外部依赖）；颜色跟随主题变量缺省蓝。
+-->
+<th:block th:fragment="overlay(url)">
+  <div class="plb-search-widget">
+    <button type="button" class="plb-search-toggle" aria-label="打开站内搜索" aria-expanded="false">
+      <svg viewBox="0 0 24 24" width="19" height="19" focusable="false" aria-hidden="true">
+        <path d="M10.5 3a7.5 7.5 0 015.9 12.1l4.3 4.3-1.4 1.4-4.3-4.3A7.5 7.5 0 1110.5 3zm0 2a5.5 5.5 0 100 11 5.5 5.5 0 000-11z"
+              fill="currentColor"></path>
+      </svg>
+      <span>搜索</span>
+    </button>
+    <div class="plb-search-layer" role="dialog" aria-modal="true" aria-label="站内搜索">
+      <button type="button" class="plb-search-close" aria-label="关闭搜索">✕</button>
+      <form class="plb-search-form" th:action="${url.search('', null)}" method="get" role="search">
+        <input type="text" name="q" placeholder="输入关键词，搜索本站内容…" aria-label="站内搜索" autocomplete="off">
+        <button type="submit">搜 索</button>
+      </form>
+      <p class="plb-search-tip">按 ESC 或点击空白处关闭</p>
+    </div>
+  </div>
+  <style>
+    .plb-search-widget{position:relative}
+    .plb-search-toggle{display:inline-flex;align-items:center;gap:6px;border:1px solid var(--border, #e5e6eb);
+      background:transparent;color:inherit;border-radius:18px;padding:5px 14px;font-size:13px;cursor:pointer;
+      transition:border-color .2s,color .2s}
+    .plb-search-toggle:hover{border-color:var(--primary, #2d8cf0);color:var(--primary, #2d8cf0)}
+    .plb-search-layer{position:fixed;inset:0;z-index:9999;display:none;align-items:center;justify-content:center;
+      flex-direction:column;background:rgba(10,20,40,.82);backdrop-filter:blur(6px)}
+    .plb-search-widget.open .plb-search-layer{display:flex}
+    .plb-search-close{position:absolute;top:26px;right:32px;background:none;border:0;color:#fff;font-size:22px;
+      cursor:pointer;opacity:.8;padding:6px}
+    .plb-search-close:hover{opacity:1}
+    .plb-search-form{display:flex;width:min(640px,86vw);border-radius:8px;overflow:hidden;box-shadow:0 18px 60px rgba(0,0,0,.35)}
+    .plb-search-form input{flex:1;border:0;padding:16px 18px;font-size:16px;outline:none;min-width:0}
+    .plb-search-form button{border:0;padding:0 26px;font-size:15px;cursor:pointer;
+      background:var(--primary, #2d8cf0);color:#fff}
+    .plb-search-form button:hover{filter:brightness(1.08)}
+    .plb-search-tip{margin-top:16px;color:rgba(255,255,255,.55);font-size:12px;letter-spacing:.05em}
+  </style>
+  <script>
+  (function () {
+    var widget = document.currentScript && document.currentScript.previousElementSibling;
+    while (widget && !(widget.classList && widget.classList.contains('plb-search-widget'))) {
+      widget = widget && widget.previousElementSibling;
+    }
+    if (!widget || widget.__plbSearchBound) { return; }
+    widget.__plbSearchBound = true;
+    var toggle = widget.querySelector('.plb-search-toggle');
+    var layer = widget.querySelector('.plb-search-layer');
+    var input = widget.querySelector('.plb-search-form input');
+    function open() {
+      widget.classList.add('open');
+      toggle.setAttribute('aria-expanded', 'true');
+      if (input) { setTimeout(function () { input.focus(); }, 50); }
+    }
+    function close() {
+      widget.classList.remove('open');
+      toggle.setAttribute('aria-expanded', 'false');
+    }
+    toggle.addEventListener('click', open);
+    widget.querySelector('.plb-search-close').addEventListener('click', close);
+    layer.addEventListener('click', function (e) { if (e.target === layer) { close(); } });
+    document.addEventListener('keydown', function (e) {
+      if (e.key === 'Escape') { close(); }
+    });
+  })();
+  </script>
+</th:block>

src/main/resources/templates/themes/default/fragments/header.html

@@ -34,10 +34,19 @@
                  th:src="${url.upload(site.config['logo'])}" th:alt="${site.name}">
             <a class="site-name" th:href="${url.home()}" th:text="${site.name}">站点名称</a>
         </div>
-        <form class="site-search" th:action="${url.search('', null)}" method="get" role="search">
+        <!-- D-10（docs/20）：searchStyle=overlay 换全屏搜索浮层；none 隐藏；inline/缺省保留原表单。
+     坑④：th:replace 优先级(100)先于 th:if(300)——条件必须放外层 th:block，replace 放子元素 -->
+        <th:block th:if="${themeParams != null and themeParams['searchStyle'] == 'overlay'}">
+            <th:block th:replace="~{'themes/common/fragments/search' :: overlay(${url})}" />
+        </th:block>
+        <th:block th:if="${themeParams == null or themeParams['searchStyle'] == null or themeParams['searchStyle'] == 'inline'}">
+<form class="site-search"
+             
+              th:action="${url.search('', null)}" method="get" role="search">
             <input type="text" name="q" placeholder="站内搜索" aria-label="站内搜索">
             <button type="submit">搜索</button>
         </form>
+        </th:block>
     </div>
 
     <!-- 栏目导航：外链栏目直接外跳；其余进栏目页（方案 §8.1） -->

src/main/resources/templates/themes/default/home.html

@@ -26,8 +26,14 @@
     <!-- 首页布局模式（docs/16 §4.4）：home_layout 落库后按区块序列渲染（common 兜底骨架，本主题不另设形态） -->
     <th:block th:if="${layoutBlocks != null}">
         <th:block th:replace="~{'themes/common/fragments/home-blocks' :: style}" />
+        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: previewScript}" />
+        <!-- D-8（docs/20）：骨架共享入场动效 + count-up；主题参数 animation=off 关闭 -->
+        <th:block th:if="${themeParams == null or themeParams['animation'] != 'off'}" th:replace="~{'themes/common/fragments/home-blocks' :: motionScript}" />
+        <!-- F2：data-plb-id 锚点（display:contents）供编辑器实时预览 postMessage 重排 -->
         <th:block th:each="block : ${layoutBlocks}">
-            <th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" />
+            <div class="plb-anchor" th:attr="data-plb-id=${block['id']}" style="display:contents">
+                <th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" />
+            </div>
         </th:block>
     </th:block>
 

src/main/resources/templates/themes/default/theme.json

@@ -4,16 +4,184 @@
   "title": "高校蓝（默认）",
   "version": "1.0.0",
   "author": "yunhai",
-  "description": "高校蓝主题：顶栏 + 通栏轮播布局，现行基准皮肤（方案 §7）。",
+  "description": "高校蓝主题：顶栏 + 通栏轮播布局，现行基准皮肤（方案 §7）。 docs/20 E：色皮档 4 套（blue-white/classic-red/fresh-mint/warm-kinder）并入为 colorScheme 预设。",
   "screenshot": "assets/screenshot.png",
   "bannerSize": "1920x560",
   "params": [
-    { "key": "primary",     "cssVar": "--primary",      "label": "主色",       "type": "color", "default": "#1a5cb0" },
-    { "key": "primaryDark", "cssVar": "--primary-dark", "label": "主色加深",   "type": "color", "default": "#12447f" },
-    { "key": "text",        "cssVar": "--text",         "label": "正文文字色", "type": "color", "default": "#333333" },
-    { "key": "textLight",   "cssVar": "--text-light",   "label": "次要文字色", "type": "color", "default": "#777777" },
-    { "key": "bg",          "cssVar": "--bg",           "label": "页面底色",   "type": "color", "default": "#f5f6f8" },
-    { "key": "cardBg",      "cssVar": "--card-bg",      "label": "卡片底色",   "type": "color", "default": "#ffffff" },
-    { "key": "border",      "cssVar": "--border",       "label": "边框色",     "type": "color", "default": "#e5e6eb" }
+    {
+      "key": "primary",
+      "cssVar": "--primary",
+      "label": "主色",
+      "type": "color",
+      "default": "#1a5cb0"
+    },
+    {
+      "key": "primaryDark",
+      "cssVar": "--primary-dark",
+      "label": "主色加深",
+      "type": "color",
+      "default": "#12447f"
+    },
+    {
+      "key": "text",
+      "cssVar": "--text",
+      "label": "正文文字色",
+      "type": "color",
+      "default": "#333333"
+    },
+    {
+      "key": "textLight",
+      "cssVar": "--text-light",
+      "label": "次要文字色",
+      "type": "color",
+      "default": "#777777"
+    },
+    {
+      "key": "bg",
+      "cssVar": "--bg",
+      "label": "页面底色",
+      "type": "color",
+      "default": "#f5f6f8"
+    },
+    {
+      "key": "cardBg",
+      "cssVar": "--card-bg",
+      "label": "卡片底色",
+      "type": "color",
+      "default": "#ffffff"
+    },
+    {
+      "key": "border",
+      "cssVar": "--border",
+      "label": "边框色",
+      "type": "color",
+      "default": "#e5e6eb"
+    },
+    {
+      "key": "animation",
+      "label": "首页动效",
+      "type": "select",
+      "default": "on",
+      "options": [
+        {
+          "value": "on",
+          "label": "开启（滚动入场 + 数字计数）"
+        },
+        {
+          "value": "off",
+          "label": "关闭（静态呈现）"
+        }
+      ]
+    },
+    {
+      "key": "titleStyle",
+      "label": "栏目标题语言",
+      "type": "select",
+      "default": "cn",
+      "options": [
+        {
+          "value": "cn",
+          "label": "仅中文"
+        },
+        {
+          "value": "bilingual",
+          "label": "中英双语（大中文 + 斜体英文副题）"
+        }
+      ]
+    },
+    {
+      "key": "iconShape",
+      "label": "图标形状语言",
+      "type": "select",
+      "default": "circle",
+      "options": [
+        {
+          "value": "circle",
+          "label": "圆形徽章"
+        },
+        {
+          "value": "hexagon",
+          "label": "六边形"
+        },
+        {
+          "value": "square",
+          "label": "圆角方形"
+        }
+      ]
+    },
+    {
+      "key": "searchStyle",
+      "label": "门户搜索样式",
+      "type": "select",
+      "default": "inline",
+      "options": [
+        {
+          "value": "none",
+          "label": "不显示搜索"
+        },
+        {
+          "value": "inline",
+          "label": "通栏搜索条（banner 下方白色大搜索条）"
+        },
+        {
+          "value": "overlay",
+          "label": "全屏搜索浮层（右上放大镜唤起）"
+        }
+      ]
+    },
+    {
+      "key": "colorScheme",
+      "label": "配色方案",
+      "type": "select",
+      "default": "custom",
+      "options": [
+        {
+          "value": "custom",
+          "label": "自定义（上方色号自由调）"
+        },
+        {
+          "value": "blue-white",
+          "label": "蓝白经典（原 blue-white）"
+        },
+        {
+          "value": "classic-red",
+          "label": "典雅红（原 classic-red）"
+        },
+        {
+          "value": "fresh-mint",
+          "label": "清新薄荷（原 fresh-mint）"
+        },
+        {
+          "value": "warm-kinder",
+          "label": "暖阳幼教（原 warm-kinder）"
+        }
+      ],
+      "presets": {
+        "blue-white": {
+          "--primary": "#2f6bd8",
+          "--primary-dark": "#1d4fae",
+          "--bg": "#f7f9fc",
+          "--border": "#e3e9f2"
+        },
+        "classic-red": {
+          "--primary": "#b01a2e",
+          "--primary-dark": "#7f1224",
+          "--bg": "#f7f5f2"
+        },
+        "fresh-mint": {
+          "--primary": "#17a2a2",
+          "--primary-dark": "#0f7c7c",
+          "--bg": "#f5fbfa",
+          "--border": "#dcedeb"
+        },
+        "warm-kinder": {
+          "--primary": "#e8722a",
+          "--primary-dark": "#c25a1a",
+          "--bg": "#fff8f0",
+          "--card-bg": "#fffdf9",
+          "--border": "#f3e3d3"
+        }
+      }
+    }
   ]
 }

src/main/resources/templates/themes/fresh-mint/README.md

@@ -1,36 +0,0 @@
-# fresh-mint 皮肤包
-
-由 blue-white 派生的清新薄荷风皮肤（**卡片封面版**，docs/10 契约 §5 工作流）。**升级随版本发布，不在站点间复制目录**。
-
-## 风格定位
-
-清爽、亲和，适合职业院校门户：主色薄荷青、圆角 12px、卡片纯白+柔和阴影、细线吸顶顶栏+居中 logo、列表卡片网格（一行 3 张）支持封面图、几何圆点装饰与大留白；无纹理、无通栏大图、无复杂动效。
-
-与 `fresh-mint`（同色系基础版）的差异：列表为带封面的卡片网格（`listLayout=grid`，`decoration=dots`），header 为 3 列网格（左：专业院系 / 中：品牌 / 右：搜索）；`fresh-mint` 采用 top-bar + brand-row 顶栏与纯文字列表卡片。
-
-## 数据契约（模板可取用的 model 属性全集，契约 §3）
-
-| 页面 | 属性 |
-| --- | --- |
-| 全部 | `site`（快照：config/分类树/轮播/友链组/院系子站）、`url`（PortalUrlHelper：home/category/article/upload/asset/search/siteHome）、`themeBase`（=`themes/fresh-mint`）、`navCategories`、`pageTitle`、`seoDescription`、`canonical`、`themeParams`（微调参数，仅 theme.json 声明过的 key）、`themeVarsCss`（服务端预构建 `:root{}` 覆盖串，无参数为空） |
-| home | `banners`（时间窗内 home 位）、`topArticles`（置顶+最新 6）、`categoryBlocks`（LIST 型根栏目块，各 top 8） |
-| list / search | `listData`（分页 + `items[].coverImage`）、`category`（list）、`q` + `searchMode`（search） |
-| detail | `article`、`prevArticle`、`nextArticle`、`currentCategoryId` |
-| single | `category`（含 `content`）、`currentCategoryId` |
-
-原则：皮肤不得假设"首页一定有轮播"、"列表一定有封面"，对空集合优雅降级。
-
-## 轮播图尺寸约定（bannerSize）
-
-1920x560（管理端上传端按此引导裁剪）。
-
-## 可调参数
-
-见 `theme.json` 的 `params`：
-
-- **color**（进 CSS 变量）：`primary` 主色 / `primaryDark` 主色加深（用于品牌文字、悬停加深）/ `primarySoft` 主色浅调（装饰、点缀背景）/ `bg` 页面底色 / `border` 边框色。
-- **select**：`listLayout` = `grid`（默认，卡片网格一行 3 张，支持封面）或 `list`（简约列表，封面靠左缩略）；`decoration` = `dots`（默认，背景几何圆点）或 `plain`（纯净无装饰）。
-
-换色建议：主色系三值同步调整（primary / primaryDark / primarySoft），bg 与 border、primarySoft 保持同族浅色调，避免底色与卡片对比失衡。
-
-优先级：`custom_css` > `themeVarsCss` > `main.css`。

src/main/resources/templates/themes/fresh-mint/assets/css/main.css

@@ -1,650 +0,0 @@
-/* ============================================================
- * fresh-mint 皮肤包样式（blue-white 派生，docs/10 皮肤包契约 §5）
- * 清新薄荷风（卡片封面版）：主色 #17A2A2、浅薄荷底、白卡 12px 圆角 + 柔和阴影；
- * 细线吸顶顶栏 + 居中 logo；列表为带封面的卡片网格（一行 3 张）；几何圆点装饰。
- * 无纹理、无通栏大图、无复杂动效。
- * 轮播图设计尺寸约定：1920×560（管理端上传端按此引导裁剪）。
- * ============================================================ */
-:root {
-  --primary: #17A2A2;
-  --primary-dark: #0F7C7C;
-  --primary-soft: #E6F6F6;
-  --bg: #F5FBFA;
-  --card-bg: #FFFFFF;
-  --border: #DCEDEB;
-  --text: #1F2D2D;
-  --text-light: #6B8382;
-
-  --radius: 12px;
-  --radius-sm: 8px;
-  --max-width: 1200px;
-
-  --shadow-card: 0 6px 18px rgba(15, 124, 124, .06);
-  --shadow-hover: 0 14px 30px rgba(15, 124, 124, .13);
-  --shadow-pop: 0 10px 26px rgba(15, 124, 124, .12);
-}
-
-* { box-sizing: border-box; }
-body {
-  margin: 0;
-  font-family: "PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif;
-  font-size: 15px;
-  line-height: 1.7;
-  color: var(--text);
-  background-color: var(--bg);
-  background-image: radial-gradient(rgba(23, 162, 162, .10) 1.6px, transparent 1.6px);
-  background-size: 28px 28px;
-  background-attachment: fixed;
-}
-body.decor-plain { background-image: none; }
-h1, h2, h3 { font-weight: 600; letter-spacing: .01em; }
-a { color: inherit; text-decoration: none; }
-a:hover { color: var(--primary-dark); }
-img { max-width: 100%; }
-time, .item-meta { color: var(--text-light); font-size: 13px; }
-.empty {
-  color: var(--text-light);
-  text-align: center;
-  padding: 36px 0;
-  background: var(--card-bg);
-  border: 1px dashed var(--border);
-  border-radius: var(--radius);
-}
-
-/* ===== 头部：细线顶栏 + 居中 logo + 吸顶 ===== */
-.site-header {
-  position: sticky;
-  top: 0;
-  z-index: 200;
-  background: rgba(255, 255, 255, .94);
-  border-bottom: 1px solid var(--border);
-  box-shadow: 0 2px 12px rgba(15, 124, 124, .05);
-}
-.header-inner {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 12px 16px;
-  display: grid;
-  grid-template-columns: 1fr auto 1fr;
-  align-items: center;
-  gap: 16px;
-}
-.header-aside { display: flex; align-items: center; gap: 10px; min-width: 0; }
-.header-aside-left { justify-self: start; }
-.header-aside-right { justify-self: end; }
-
-.site-brand { display: flex; align-items: center; gap: 12px; justify-self: center; }
-.site-logo { height: 40px; width: auto; }
-.site-name {
-  font-size: 22px;
-  font-weight: 600;
-  color: var(--primary-dark);
-  letter-spacing: .02em;
-  white-space: nowrap;
-}
-
-.site-search { display: flex; gap: 8px; }
-.site-search input {
-  border: 1px solid var(--border);
-  background: var(--primary-soft);
-  border-radius: 999px;
-  padding: 8px 16px;
-  width: 190px;
-  font-size: 14px;
-  color: var(--text);
-  outline: none;
-}
-.site-search input::placeholder { color: #9bb6b5; }
-.site-search input:focus { border-color: var(--primary); background: #fff; }
-.site-search button {
-  border: none;
-  border-radius: 999px;
-  background: var(--primary);
-  color: #fff;
-  font-size: 14px;
-  padding: 8px 20px;
-  cursor: pointer;
-}
-.site-search button:hover { background: var(--primary-dark); color: #fff; }
-
-/* ===== 专业院系下拉（院系子站切换，《院系子站方案》） ===== */
-.site-colleges { position: relative; }
-.site-colleges .colleges-toggle {
-  display: flex;
-  align-items: center;
-  gap: 4px;
-  border: 1px solid var(--border);
-  border-radius: 999px;
-  background: #fff;
-  padding: 7px 16px;
-  cursor: pointer;
-  color: var(--primary-dark);
-  font-size: 14px;
-  font-weight: 500;
-  white-space: nowrap;
-}
-.site-colleges .colleges-toggle:hover { border-color: var(--primary); background: var(--primary-soft); }
-.site-colleges .colleges-arrow { font-style: normal; font-size: 12px; color: var(--text-light); }
-.site-colleges .colleges-menu {
-  display: none;
-  position: absolute;
-  top: calc(100% + 8px);
-  right: 0;
-  min-width: 200px;
-  max-height: 420px;
-  overflow-y: auto;
-  margin: 0;
-  padding: 6px;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-pop);
-  z-index: 210;
-}
-.site-colleges:hover .colleges-menu { display: block; }
-.site-colleges .colleges-menu li a {
-  display: block;
-  padding: 9px 14px;
-  border-radius: var(--radius-sm);
-  color: var(--text);
-  white-space: nowrap;
-}
-.site-colleges .colleges-menu li a:hover { background: var(--primary-soft); color: var(--primary-dark); }
-.site-colleges .colleges-menu li.active a { color: var(--primary-dark); font-weight: 600; background: var(--primary-soft); }
-
-/* ===== 主导航：细线文字导航 + 薄荷下划线激活态 ===== */
-.site-nav { background: transparent; border-top: 1px solid var(--border); }
-.site-nav ul {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 0 16px;
-  list-style: none;
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: center;
-}
-.site-nav > ul > li { position: relative; }
-.site-nav li > a {
-  display: block;
-  padding: 13px 22px;
-  color: var(--text);
-  font-weight: 500;
-  position: relative;
-}
-.site-nav > ul > li > a::before {
-  content: "";
-  position: absolute;
-  left: 22px;
-  right: 22px;
-  bottom: 8px;
-  height: 2px;
-  border-radius: 2px;
-  background: var(--primary);
-  transform: scaleX(0);
-  transition: transform .18s ease;
-}
-.site-nav > ul > li:hover > a::before,
-.site-nav > ul > li.active > a::before { transform: scaleX(1); }
-.site-nav > ul > li:hover > a,
-.site-nav > ul > li.active > a { color: var(--primary-dark); }
-.site-nav li.has-sub > a::after { content: " ▾"; font-size: 12px; opacity: .7; }
-
-/* ===== 二级下拉导航 ===== */
-.site-nav ul.sub-nav {
-  display: none;
-  position: absolute;
-  top: 100%;
-  left: 0;
-  min-width: 178px;
-  max-width: none;
-  margin: 0;
-  padding: 6px;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-pop);
-  z-index: 205;
-}
-.site-nav li:hover > .sub-nav { display: block; }
-.site-nav .sub-nav li a {
-  padding: 9px 16px;
-  border-radius: var(--radius-sm);
-  color: var(--text);
-  white-space: nowrap;
-  background: none;
-}
-.site-nav .sub-nav li a::before { display: none; }
-.site-nav .sub-nav li a:hover { background: var(--primary-soft); color: var(--primary-dark); }
-.site-nav .sub-nav li.active a { color: var(--primary-dark); font-weight: 600; }
-
-/* ===== 首页轮播（收窄 + 圆角，不做通栏大图） ===== */
-.banner {
-  position: relative;
-  max-width: var(--max-width);
-  margin: 24px auto 4px;
-  padding: 0 16px;
-}
-.banner-slides {
-  position: relative;
-  height: 380px;
-  border-radius: var(--radius);
-  overflow: hidden;
-  box-shadow: var(--shadow-card);
-}
-.banner-slide { display: none; position: absolute; inset: 0; }
-.banner-slide.active { display: block; }
-.banner-slide img { width: 100%; height: 100%; object-fit: cover; }
-.banner-title {
-  position: absolute;
-  left: 16px;
-  right: auto;
-  bottom: 16px;
-  max-width: 68%;
-  padding: 8px 18px;
-  border-radius: 999px;
-  background: rgba(255, 255, 255, .92);
-  color: var(--text);
-  font-weight: 500;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.banner-dots {
-  position: absolute;
-  bottom: 24px;
-  right: 32px;
-  display: flex;
-  gap: 8px;
-}
-.banner-dots button {
-  width: 9px;
-  height: 9px;
-  border-radius: 50%;
-  border: none;
-  background: rgba(255, 255, 255, .75);
-  cursor: pointer;
-}
-.banner-dots button.active { background: var(--primary); transform: scale(1.25); }
-
-/* ===== 通用区块：白卡 + 柔和阴影 ===== */
-.top-strip, .category-block {
-  max-width: var(--max-width);
-  margin: 20px auto;
-  padding: 22px 24px 24px;
-  background: var(--card-bg);
-  border: none;
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-card);
-}
-.section-title, .block-head h2 {
-  margin: 0 0 16px;
-  font-size: 19px;
-  font-weight: 600;
-  display: flex;
-  align-items: center;
-}
-.section-title::before, .block-head h2::before {
-  content: "";
-  flex: none;
-  width: 7px;
-  height: 7px;
-  margin-right: 26px;
-  border-radius: 50%;
-  background: var(--primary);
-  box-shadow: 12px 0 0 rgba(23, 162, 162, .32), 24px 0 0 rgba(23, 162, 162, .14);
-}
-.block-head { display: flex; align-items: baseline; justify-content: space-between; }
-.more {
-  font-size: 13px;
-  color: var(--primary-dark);
-  background: var(--primary-soft);
-  border-radius: 999px;
-  padding: 4px 14px;
-  flex: none;
-}
-
-/* 头条推荐：卡片网格（listLayout=list 时回落为行列表） */
-.top-grid { list-style: none; margin: 0; padding: 0; display: grid; grid-template-columns: repeat(3, 1fr); gap: 16px; }
-.top-grid li {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 16px 18px;
-  background: var(--primary-soft);
-  border-radius: var(--radius-sm);
-}
-.top-grid li a {
-  flex: 1;
-  font-weight: 500;
-  color: var(--text);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.top-grid li time { flex: none; }
-.top-grid.is-list { display: block; }
-.top-grid.is-list li { background: transparent; padding: 11px 0; border-bottom: 1px solid var(--border); }
-.top-grid.is-list li:last-child { border-bottom: none; }
-
-/* 栏目区块：行列表 + 圆点标记 */
-.block-list { list-style: none; margin: 0; padding: 0; }
-.block-list li {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 11px 0;
-  border-bottom: 1px solid var(--border);
-}
-.block-list li:last-child { border-bottom: none; }
-.block-list li a {
-  flex: 1;
-  display: flex;
-  align-items: center;
-  gap: 10px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.block-list li a::before {
-  content: "";
-  flex: none;
-  width: 5px;
-  height: 5px;
-  border-radius: 50%;
-  background: var(--primary);
-  opacity: .5;
-}
-.top-badge {
-  flex: none;
-  color: #fff;
-  background: var(--primary);
-  font-size: 12px;
-  font-weight: 500;
-  padding: 2px 10px;
-  border-radius: 999px;
-}
-
-/* ===== 列表页：卡片网格（一行三张，支持封面） ===== */
-.list-main {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 24px 16px 48px;
-  background: transparent;
-  border: none;
-}
-.home-main { padding-bottom: 8px; }
-.breadcrumb { color: var(--text-light); font-size: 13px; margin: 0 0 14px; }
-.breadcrumb a { margin-right: 8px; }
-.breadcrumb span { margin-left: 8px; color: var(--primary-dark); }
-.page-title {
-  font-size: 24px;
-  font-weight: 600;
-  margin: 0 0 22px;
-  padding-bottom: 14px;
-  border-bottom: 1px solid var(--border);
-}
-
-.article-list {
-  list-style: none;
-  margin: 0;
-  padding: 0;
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 20px;
-}
-.article-list li {
-  background: var(--card-bg);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-card);
-  overflow: hidden;
-  transition: transform .2s ease, box-shadow .2s ease;
-}
-.article-list li:hover { transform: translateY(-4px); box-shadow: var(--shadow-hover); }
-.item-card { display: flex; flex-direction: column; height: 100%; }
-.item-cover {
-  display: block;
-  aspect-ratio: 16 / 9;
-  overflow: hidden;
-  background: var(--primary-soft);
-}
-.item-cover img { display: block; width: 100%; height: 100%; object-fit: cover; }
-.item-body { display: flex; flex-direction: column; gap: 8px; padding: 16px 18px 18px; flex: 1; }
-.item-title {
-  font-size: 16px;
-  font-weight: 600;
-  line-height: 1.5;
-  color: var(--text);
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-.item-summary {
-  color: var(--text-light);
-  font-size: 14px;
-  line-height: 1.7;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-}
-.item-meta { display: flex; gap: 10px; align-items: center; margin-top: auto; padding-top: 4px; }
-
-.article-list.is-list { display: block; }
-.article-list.is-list li { margin-bottom: 14px; }
-.article-list.is-list .item-card { flex-direction: row; align-items: center; gap: 18px; padding: 16px 20px; }
-.article-list.is-list .item-cover { width: 190px; flex: none; aspect-ratio: 16 / 10; border-radius: var(--radius-sm); }
-.article-list.is-list .item-body { padding: 0; }
-.article-list.is-list .item-meta { margin-top: 4px; }
-
-/* ===== 分页 ===== */
-.pagination { display: flex; gap: 8px; justify-content: center; flex-wrap: wrap; padding: 36px 0 8px; }
-.pagination a {
-  min-width: 36px;
-  text-align: center;
-  padding: 7px 14px;
-  border: 1px solid var(--border);
-  border-radius: 999px;
-  background: var(--card-bg);
-  color: var(--text-light);
-}
-.pagination a:hover { border-color: var(--primary); color: var(--primary-dark); }
-.pagination a.active { background: var(--primary); color: #fff; border-color: var(--primary); }
-
-/* ===== 详情 / 单页 ===== */
-.detail-main {
-  max-width: 1000px;
-  margin: 24px auto 48px;
-  padding: 36px 40px 40px;
-  background: var(--card-bg);
-  border: none;
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-card);
-}
-.article-title { margin: 8px 0 14px; font-size: 27px; font-weight: 600; text-align: center; line-height: 1.45; }
-.article-meta {
-  display: flex;
-  gap: 0;
-  justify-content: center;
-  flex-wrap: wrap;
-  color: var(--text-light);
-  font-size: 13px;
-  padding-bottom: 20px;
-  border-bottom: 1px solid var(--border);
-}
-.article-meta > * { padding: 0 12px; position: relative; }
-.article-meta > * + *::before {
-  content: "";
-  position: absolute;
-  left: 0;
-  top: 50%;
-  width: 4px;
-  height: 4px;
-  margin-top: -2px;
-  border-radius: 50%;
-  background: var(--primary);
-  opacity: .5;
-}
-.article-content { line-height: 1.95; font-size: 16px; padding-top: 24px; word-break: break-word; color: var(--text); }
-.article-content p { margin: 0 0 16px; }
-.article-content h1, .article-content h2, .article-content h3 { margin: 26px 0 12px; }
-.article-content img { height: auto; border-radius: var(--radius-sm); }
-.article-content a { color: var(--primary-dark); text-decoration: underline; text-underline-offset: 3px; }
-.article-content blockquote {
-  margin: 18px 0;
-  padding: 12px 18px;
-  background: var(--primary-soft);
-  border-left: 3px solid var(--primary);
-  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
-}
-.article-content table { border-collapse: collapse; width: 100%; }
-.article-content table td, .article-content table th { border: 1px solid var(--border); padding: 8px 12px; }
-.article-sibling { display: flex; flex-direction: column; gap: 10px; margin-top: 32px; font-size: 14px; }
-.article-sibling a {
-  padding: 12px 18px;
-  border-radius: var(--radius-sm);
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  color: var(--text-light);
-}
-.article-sibling a:hover { border-color: var(--primary); color: var(--primary-dark); }
-
-/* ===== 页脚（浅薄荷底） ===== */
-.site-footer {
-  margin-top: 40px;
-  background: var(--primary-soft);
-  color: var(--text-light);
-  border-top: 1px solid var(--border);
-}
-.footer-decor {
-  height: 26px;
-  display: flex;
-  justify-content: center;
-  align-items: center;
-}
-.footer-decor::before {
-  content: "";
-  width: 7px;
-  height: 7px;
-  border-radius: 50%;
-  background: var(--primary);
-  box-shadow: 14px 0 0 rgba(23, 162, 162, .32), -14px 0 0 rgba(23, 162, 162, .32);
-}
-.footer-links {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 8px 16px 4px;
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-}
-.links-group { display: flex; flex-wrap: wrap; gap: 10px 14px; align-items: center; font-size: 13px; }
-.group-name {
-  font-weight: 600;
-  color: var(--primary-dark);
-  margin-right: 6px;
-  padding-right: 16px;
-  position: relative;
-}
-.group-name::after {
-  content: "";
-  position: absolute;
-  right: 0;
-  top: 50%;
-  width: 4px;
-  height: 4px;
-  margin-top: -2px;
-  border-radius: 50%;
-  background: var(--primary);
-  opacity: .5;
-}
-.links-group a { color: var(--text-light); }
-.links-group a:hover { color: var(--primary-dark); }
-.footer-info {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 14px 16px 26px;
-  text-align: center;
-  font-size: 13px;
-}
-.footer-info p { margin: 4px 0; }
-.links-group a .link-logo,
-.sp-links-row a .link-logo {
-  height: 20px;
-  width: auto;
-  max-width: 64px;
-  object-fit: contain;
-  vertical-align: middle;
-  margin-right: 4px;
-  border-radius: 4px;
-}
-
-/* ===== 移动端适配 ===== */
-@media (max-width: 768px) {
-  .header-inner { grid-template-columns: 1fr; justify-items: center; gap: 12px; padding: 12px 14px; }
-  .site-brand { order: 1; justify-self: center; }
-  .header-aside-right { order: 2; justify-self: stretch; }
-  .header-aside-left { order: 3; justify-self: center; }
-  .site-search { flex: 1; }
-  .site-search input { flex: 1; width: auto; min-width: 0; }
-  .site-colleges .colleges-menu { left: 50%; right: auto; transform: translateX(-50%); min-width: 200px; }
-  .site-nav ul { flex-wrap: nowrap; overflow-x: auto; justify-content: flex-start; }
-  .site-nav > ul > li > a { padding: 12px 16px; white-space: nowrap; }
-  .site-nav > ul > li > a::before { left: 16px; right: 16px; }
-
-  .banner { margin-top: 16px; }
-  .banner-slides { height: 190px; }
-  .banner-title { font-size: 13px; padding: 6px 14px; }
-  .banner-dots { bottom: 14px; right: 20px; }
-
-  .top-grid { grid-template-columns: 1fr; }
-  .article-list { grid-template-columns: 1fr; }
-  .article-list.is-list .item-card { flex-direction: column; align-items: stretch; }
-  .article-list.is-list .item-cover { width: 100%; aspect-ratio: 16 / 9; }
-  .top-strip, .category-block { padding: 18px 16px 20px; margin: 16px auto; }
-  .detail-main { margin: 16px auto 32px; padding: 22px 18px 26px; }
-  .article-title { font-size: 22px; }
-  .article-content { font-size: 15px; }
-
-  .site-nav ul.sub-nav {
-    display: block;
-    position: static;
-    border: none;
-    border-radius: var(--radius-sm);
-    box-shadow: none;
-    background: var(--primary-soft);
-    min-width: 0;
-    padding: 6px;
-  }
-  .site-nav .sub-nav li a { color: var(--text); padding: 8px 14px; }
-}
-
-
-/* ===== 左侧栏目导航（docs/11）：有二级节点的模块，栏目/文章页左侧展示兄弟目录 ===== */
-.list-main.has-sidenav, .detail-main.has-sidenav { display: flex; align-items: flex-start; gap: 24px; }
-.has-sidenav .list-body { flex: 1; min-width: 0; }
-.side-nav { flex: none; width: 220px; background: var(--card-bg, #fff); border: 1px solid var(--border); overflow: hidden; }
-.side-nav-head { background: var(--primary); color: #fff; font-size: 20px; font-weight: 700; text-align: center; padding: 18px 12px; letter-spacing: 2px; }
-.side-nav-list { list-style: none; margin: 0; padding: 0; }
-.side-nav-item + .side-nav-item { border-top: 1px dashed var(--border); }
-.side-nav-item a { display: block; padding: 12px 16px; color: var(--text); text-decoration: none; font-size: 15px; transition: background .15s ease, color .15s ease; }
-.side-nav-item a:hover { color: var(--primary); background: var(--bg); }
-.side-nav-item.active a { background: var(--primary); color: #fff; font-weight: 600; text-decoration: none; }
-/* 顶导航二级下拉当前项高亮（docs/11 顺带） */
-.site-nav ul.sub-nav li.active a { color: var(--primary); }
-@media (max-width: 768px) {
-  .list-main.has-sidenav, .detail-main.has-sidenav { flex-direction: column; gap: 12px; }
-  .side-nav { width: 100%; }
-  .side-nav-list { display: flex; overflow-x: auto; -webkit-overflow-scrolling: touch; }
-  .side-nav-item { flex: none; }
-  .side-nav-item + .side-nav-item { border-top: none; border-left: 1px dashed var(--border); }
-  .side-nav-item a { white-space: nowrap; }
-}
-@media print {
-  .side-nav { display: none; }
-  .list-main.has-sidenav, .detail-main.has-sidenav { display: block; }
-}

src/main/resources/templates/themes/fresh-mint/assets/favicon.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
-  <defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-    <stop offset="0" stop-color="#5486df"/><stop offset="1" stop-color="#214b97"/>
-  </linearGradient></defs>
-  <rect width="64" height="64" fill="url(#bg)"/>
-  <circle cx="32" cy="25" r="10" fill="#ffffff"/>
-  <path d="M 16 49.3 Q 32 30.7 48 49.3 Z" fill="#ffffff" opacity="0.92"/>
-</svg>

src/main/resources/templates/themes/fresh-mint/assets/js/main.js

@@ -1,40 +0,0 @@
-/* fresh-mint 皮肤包脚本：仅首页轮播自动播放与圆点切换，无任何外部依赖 */
-(function () {
-  var slides = document.querySelectorAll('.banner-slide');
-  var dots = document.querySelectorAll('.banner-dots button');
-  if (!slides.length) {
-    return;
-  }
-  var current = 0;
-  var timer = null;
-
-  function show(index) {
-    slides[current].classList.remove('active');
-    if (dots[current]) {
-      dots[current].classList.remove('active');
-    }
-    current = (index + slides.length) % slides.length;
-    slides[current].classList.add('active');
-    if (dots[current]) {
-      dots[current].classList.add('active');
-    }
-  }
-
-  function start() {
-    if (slides.length > 1) {
-      timer = window.setInterval(function () {
-        show(current + 1);
-      }, 5000);
-    }
-  }
-
-  dots.forEach(function (dot, index) {
-    dot.addEventListener('click', function () {
-      window.clearInterval(timer);
-      show(index);
-      start();
-    });
-  });
-
-  start();
-})();

src/main/resources/templates/themes/fresh-mint/detail.html

@@ -1,58 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body th:classappend="${themeParams['decoration'] == 'plain'} ? 'decor-plain'">
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node : ${categoryPath}">
-            <a class="crumb-parent" th:href="${url.category(node.id)}" th:text="${node.name}">栏目</a>
-        </th:block>
-        <span>正文</span>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${article.title}">文章标题</h1>
-        <div class="article-meta">
-            <time th:if="${article.publishTime != null}"
-                  th:text="${'发布时间：' + #temporals.format(article.publishTime, 'yyyy-MM-dd HH:mm')}">2026-01-01 10:00</time>
-            <span th:if="${!#strings.isEmpty(article.authorName)}"
-                  th:text="'作者：' + ${article.authorName}">作者</span>
-            <span th:if="${!#strings.isEmpty(article.source)}"
-                  th:text="'来源：' + ${article.source}">来源</span>
-            <span th:text="'浏览量：' + ${article.viewCount}">浏览量</span>
-        </div>
-        <!-- 正文：入库前已经 jsoup 白名单清洗（方案 §8.5），此处允许 utext；
-             其余字段一律 th:text 转义输出 -->
-        <div class="article-content" th:utext="${article.content}">正文</div>
-    </article>
-
-    <nav class="article-sibling">
-        <a th:if="${prevArticle != null}" class="prev"
-           th:href="${url.article(prevArticle.id)}"
-           th:text="'上一篇：' + ${prevArticle.title}">上一篇</a>
-        <a th:if="${nextArticle != null}" class="next"
-           th:href="${url.article(nextArticle.id)}"
-           th:text="'下一篇：' + ${nextArticle.title}">下一篇</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/fresh-mint/fragments/footer.html

@@ -1,23 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共页脚：浅薄荷底 + 圆点装饰 + 友情链接（分组渲染，方案 §8.1：友链不设独立路由） -->
-<footer class="site-footer" th:fragment="footer">
-    <!-- 纯装饰几何圆点（无数据绑定，aria-hidden） -->
-    <div class="footer-decor" aria-hidden="true"></div>
-    <div class="footer-links" th:if="${!#lists.isEmpty(site.linkGroups)}">
-        <div class="links-group" th:each="group : ${site.linkGroups}">
-            <span class="group-name" th:text="${group.groupName}">分组</span>
-            <a th:each="link : ${group.links}" th:href="${link.linkUrl}" target="_blank" rel="noopener">
-                    <img th:if="${link.logoUrl != null and !#strings.isEmpty(link.logoUrl)}" class="link-logo"
-                         th:src="${url.upload(link.logoUrl)}" th:alt="${link.name}" loading="lazy">
-                    <span th:text="${link.name}">链接</span>
-                </a>
-        </div>
-    </div>
-    <div class="footer-info">
-        <p th:if="${site.config['contact'] != null}" th:text="${site.config['contact']}">联系方式</p>
-        <p th:if="${site.config['copyright'] != null}" th:text="${site.config['copyright']}">版权信息</p>
-        <p th:if="${site.config['beian'] != null}" th:text="${site.config['beian']}">备案号</p>
-    </div>
-</footer>
-</html>

src/main/resources/templates/themes/fresh-mint/fragments/head.html

@@ -1,25 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<!-- 公共 head 片段：SEO（title/description/canonical）+ 主题资产（方案 §8.3/§8.6） -->
-<head th:fragment="head">
-    <meta name="theme-color" content="#17A2A2">
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title th:text="${pageTitle}">页面标题</title>
-    <meta name="description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}"
-          th:content="${seoDescription}">
-    <link rel="canonical" th:if="${canonical != null}" th:href="${canonical}">
-    <!-- og 标签基本三件（C-7，方案 §8.6 canonical/og 同基准） -->
-    <meta property="og:title" th:if="${pageTitle != null}" th:content="${pageTitle}">
-    <meta property="og:description" th:if="${seoDescription != null and !#strings.isEmpty(seoDescription)}" th:content="${seoDescription}">
-    <meta property="og:image" th:if="${ogImage != null}" th:content="${ogImage}">
-    <link rel="stylesheet" th:href="${url.asset('css/main.css')}">
-    <!-- 微调参数 CSS 变量覆盖（方案 §5.3）：位于皮肤 CSS 之后层叠覆盖；值由服务端预构建并校验 -->
-    <style th:if="${not #strings.isEmpty(themeVarsCss)}" th:utext="${themeVarsCss}"></style>
-    <!-- 站点级自定义样式（B3）：位于皮肤 CSS 与微调变量之后层叠覆盖；内容经服务端黑名单强校验后直出 -->
-    <style th:if="${not #strings.isEmpty(customCss)}" th:utext="${customCss}"></style>
-    <!-- favicon：管理端配置了 favicon 键用上传图，未配置输出主题内置兜底 icon（assets/favicon.png） -->
-    <link rel="icon" type="image/png"
-          th:href="${site.config['favicon'] != null ? url.upload(site.config['favicon']) : url.asset('favicon.png')}">
-</head>
-</html>

src/main/resources/templates/themes/fresh-mint/fragments/header.html

@@ -1,62 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org">
-<!-- 公共头部：细线顶栏 + 居中品牌行（左：专业院系 / 中：品牌 / 右：站内搜索）+ 栏目导航（《院系子站方案》） -->
-<header class="site-header" th:fragment="header">
-    <div class="header-inner">
-        <!-- 左：专业院系下拉；顶层站取其子站、院系子站取兄弟站（含自身）；无子站不渲染；文案经 config_json.colleges_label 覆盖 -->
-        <div class="header-aside header-aside-left">
-            <div class="site-colleges" th:if="${!site.colleges.isEmpty()}"
-                 th:with="collegesLabel=${site.config['colleges_label'] ?: '专业院系'}">
-                <span class="colleges-toggle">
-                    <a href="javascript:void(0)" th:text="${collegesLabel}">专业院系</a>
-                    <i class="colleges-arrow">▾</i>
-                </span>
-                <ul class="colleges-menu">
-                    <li th:each="col : ${site.colleges}" th:classappend="${col.path == site.path} ? 'active'">
-                        <a th:href="${url.siteHome(col.path, col.publicBaseUrl)}"
-                           th:title="${col.name}" th:text="${col.name}">学院名称</a>
-                    </li>
-                </ul>
-            </div>
-        </div>
-
-        <!-- 中：居中品牌（logo + 站名） -->
-        <div class="site-brand">
-            <img th:if="${site.config['logo'] != null}" class="site-logo"
-                 th:src="${url.upload(site.config['logo'])}" th:alt="${site.name}">
-            <a class="site-name" th:href="${url.home()}" th:text="${site.name}">站点名称</a>
-        </div>
-
-        <!-- 右：站内搜索 -->
-        <div class="header-aside header-aside-right">
-            <form class="site-search" th:action="${url.search('', null)}" method="get">
-                <input type="text" name="q" placeholder="站内搜索" aria-label="站内搜索">
-                <button type="submit">搜索</button>
-            </form>
-        </div>
-    </div>
-    <nav class="site-nav">
-        <ul>
-            <li th:classappend="${currentCategoryId == null and navServiceActive == null} ? 'active'">
-                <a th:href="${url.home()}">首页</a>
-            </li>
-            <li th:each="cat : ${navCategories}"
-                th:classappend="${((currentCategoryId == cat.id or navTopId == cat.id) ? 'active' : '') + (!cat.children.isEmpty() ? ' has-sub' : '')}">
-                <!-- 外链栏目直接外跳；其余进栏目页（方案 §8.1） -->
-                <a th:if="${cat.type == 3}" th:href="${cat.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${cat.name}">栏目</a>
-                <a th:unless="${cat.type == 3}" th:href="${url.category(cat.id)}" th:text="${cat.name}">栏目</a>
-                <!-- 二级下拉：悬停展开（样式见 assets/css/main.css .sub-nav） -->
-                <ul class="sub-nav" th:if="${!cat.children.isEmpty()}">
-                    <li th:each="sub : ${cat.children}"
-                        th:classappend="${sub.id == currentCategoryId} ? 'active'">
-                        <a th:if="${sub.type == 3}" th:href="${sub.linkUrl}" target="_blank" rel="noopener"
-                           th:text="${sub.name}">子栏目</a>
-                        <a th:unless="${sub.type == 3}" th:href="${url.category(sub.id)}" th:text="${sub.name}">子栏目</a>
-                    </li>
-                </ul>
-            </li>
-        </ul>
-    </nav>
-</header>
-</html>

src/main/resources/templates/themes/fresh-mint/home.html

@@ -1,68 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body th:classappend="${themeParams['decoration'] == 'plain'} ? 'decor-plain'">
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="home-main">
-    <!-- 首页轮播位（cms_banner position=home；设计尺寸约定 1920×560，见 assets/css 注释） -->
-    <section class="banner" th:if="${!#lists.isEmpty(banners)}">
-        <div class="banner-slides">
-            <a class="banner-slide" th:each="b, stat : ${banners}"
-               th:classappend="${stat.first} ? 'active'"
-               th:href="${b.linkUrl}" th:title="${b.title}">
-                <img th:src="${b.imageUrl}" th:alt="${b.title}">
-                <span class="banner-title" th:text="${b.title}">标题</span>
-            </a>
-        </div>
-        <div class="banner-dots" th:if="${#lists.size(banners) > 1}">
-            <button th:each="b, stat : ${banners}" th:classappend="${stat.first} ? 'active'"
-                    th:aria-label="${'第' + (stat.count) + '张'}"></button>
-        </div>
-    </section>
-
-    <!-- 首页布局模式（docs/16 §4.4）：home_layout 落库后按区块序列渲染（common 兜底骨架，本主题不另设形态） -->
-    <th:block th:if="${layoutBlocks != null}">
-        <th:block th:replace="~{'themes/common/fragments/home-blocks' :: style}" />
-        <th:block th:each="block : ${layoutBlocks}">
-            <th:block th:replace="~{'themes/common/fragments/home-blocks' :: render(${block})}" />
-        </th:block>
-    </th:block>
-
-    <!-- 回落分支（docs/16 D2）：无 home_layout 时按现状渲染 -->
-    <th:block th:unless="${layoutBlocks != null}">
-    <!-- 置顶/头条区（cms_article topmost 优先） -->
-    <section class="top-strip" th:if="${!#lists.isEmpty(topArticles)}">
-        <h2 class="section-title">头条推荐</h2>
-        <ul class="top-grid" th:classappend="${themeParams['listLayout'] == 'list'} ? 'is-list'">
-            <li th:each="item : ${topArticles}">
-                <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-    </section>
-
-    <!-- 一级栏目区块（每栏目 top 8） -->
-    <section class="category-block" th:each="block : ${categoryBlocks}">
-        <div class="block-head">
-            <h2 th:text="${block.category.name}">栏目名</h2>
-            <a class="more" th:href="${block.moreUrl}">更多 &gt;</a>
-        </div>
-        <ul class="block-list" th:if="${!#lists.isEmpty(block.items)}">
-            <li th:each="item : ${block.items}">
-                <a th:href="${url.article(item.id)}" th:text="${item.title}">文章标题</a>
-                <time th:if="${item.publishTime != null}"
-                      th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-            </li>
-        </ul>
-        <p class="empty" th:if="${#lists.isEmpty(block.items)}">暂无内容</p>
-    </section>
-    </th:block>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/fresh-mint/list.html

@@ -1,76 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body th:classappend="${themeParams['decoration'] == 'plain'} ? 'decor-plain'">
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="list-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb" th:if="${searchMode != true}">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-    <nav class="breadcrumb" th:if="${searchMode == true}">
-        <a th:href="${url.home()}">首页</a>
-        <span>搜索结果</span>
-    </nav>
-
-    <h1 class="page-title" th:if="${searchMode != true}" th:text="${category.name}">栏目名</h1>
-    <h1 class="page-title" th:if="${searchMode == true}" th:text="'搜索：' + ${q}">搜索词</h1>
-
-    <ul class="article-list" th:classappend="${themeParams['listLayout'] == 'list'} ? 'is-list'">
-        <li th:each="item : ${listData.items}">
-            <a class="item-card" th:href="${url.article(item.id)}">
-                <!-- 封面（契约 §3.3 listData.items[].coverImage；上传图走 url.upload） -->
-                <span class="item-cover" th:if="${item.coverImage != null and !#strings.isEmpty(item.coverImage)}">
-                    <img th:src="${url.upload(item.coverImage)}" th:alt="${item.title}" loading="lazy">
-                </span>
-                <span class="item-body">
-                    <span class="item-title" th:text="${item.title}">文章标题</span>
-                    <span class="item-summary" th:if="${!#strings.isEmpty(item.summary)}" th:text="${item.summary}">摘要</span>
-                    <span class="item-meta">
-                        <time th:if="${item.publishTime != null}"
-                              th:text="${#temporals.format(item.publishTime, 'yyyy-MM-dd')}">2026-01-01</time>
-                        <span class="top-badge" th:if="${item.topmost == 1}">置顶</span>
-                    </span>
-                </span>
-            </a>
-        </li>
-    </ul>
-    <p class="empty" th:if="${#lists.isEmpty(listData.items)}">暂无内容</p>
-
-    <!-- 分页（列表页/搜索页共用） -->
-    <nav class="pagination" th:if="${listData.totalPages > 1}"
-         th:with="cur=${listData.page}, total=${listData.totalPages}">
-        <a th:if="${cur > 1}"
-           th:href="${searchMode == true} ? ${url.search(q, cur - 1)} : ${url.category(listData.categoryId) + '?page=' + (cur - 1)}">上一页</a>
-        <a th:each="p : ${#numbers.sequence(1, total)}"
-           th:classappend="${p == cur} ? 'active'"
-           th:href="${searchMode == true} ? ${url.search(q, p)} : ${url.category(listData.categoryId) + '?page=' + p}"
-           th:text="${p}">1</a>
-        <a th:if="${cur < total}"
-           th:href="${searchMode == true} ? ${url.search(q, cur + 1)} : ${url.category(listData.categoryId) + '?page=' + (cur + 1)}">下一页</a>
-    </nav>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-<script th:src="${url.asset('js/main.js')}"></script>
-</body>
-</html>

src/main/resources/templates/themes/fresh-mint/single.html

@@ -1,41 +0,0 @@
-<!DOCTYPE html>
-<html xmlns:th="http://www.thymeleaf.org" lang="zh-CN">
-<head th:replace="~{${themeBase} + '/fragments/head' :: head}"></head>
-<body th:classappend="${themeParams['decoration'] == 'plain'} ? 'decor-plain'">
-<header th:replace="~{${themeBase} + '/fragments/header' :: header}"></header>
-
-<main class="detail-main" th:classappend="${sideNav != null} ? 'has-sidenav'">
-    <!-- 左侧栏目导航（docs/11）：模块有二级子栏目时展示"模块名 + 全部兄弟" -->
-    <aside class="side-nav" th:if="${sideNav != null}" aria-label="栏目导航">
-        <div class="side-nav-head" th:text="${sideNav.top.name}">模块名</div>
-        <ul class="side-nav-list">
-            <li class="side-nav-item" th:each="item : ${sideNav.items}"
-                th:classappend="${item.id == sideNav.activeId} ? 'active'">
-                <a th:if="${item.type == 3}" th:href="${item.linkUrl}" target="_blank" rel="noopener"
-                   th:text="${item.name}">子栏目</a>
-                <a th:unless="${item.type == 3}" th:href="${url.category(item.id)}" th:text="${item.name}">子栏目</a>
-            </li>
-        </ul>
-    </aside>
-    <div class="list-body">
-    <nav class="breadcrumb">
-        <a th:href="${url.home()}">首页</a>
-        <th:block th:each="node, st : ${categoryPath}">
-            <a th:if="${!st.last}" class="crumb-parent" th:href="${url.category(node.id)}"
-               th:text="${node.name}">父栏目</a>
-            <span th:if="${st.last}" th:text="${node.name}">栏目</span>
-        </th:block>
-    </nav>
-
-    <article class="article">
-        <h1 class="article-title" th:text="${category.name}">栏目名</h1>
-        <!-- 单页栏目内容（type=2，入库前已 jsoup 清洗） -->
-        <div class="article-content" th:utext="${category.content}">单页内容</div>
-        <p class="empty" th:if="${#strings.isEmpty(category.content)}">暂无内容</p>
-    </article>
-    </div>
-</main>
-
-<footer th:replace="~{${themeBase} + '/fragments/footer' :: footer}"></footer>
-</body>
-</html>

src/main/resources/templates/themes/fresh-mint/theme.json

@@ -1,21 +0,0 @@
-{
-  "specVersion": 1,
-  "name": "fresh-mint",
-  "title": "清新薄荷",
-  "version": "1.0.0",
-  "author": "yunhai",
-  "description": "清新薄荷风（卡片封面版）：主色 #17A2A2、浅薄荷底、白卡 12px 圆角；细线吸顶顶栏 + 居中 logo；列表为带封面的卡片网格（一行 3 张）；几何圆点装饰与大留白；适合职业院校。",
-  "screenshot": "assets/screenshot.png",
-  "bannerSize": "1920x560",
-  "params": [
-    { "key": "primary",      "cssVar": "--primary",       "label": "主色（薄荷绿）",  "type": "color", "default": "#17A2A2" },
-    { "key": "primaryDark",  "cssVar": "--primary-dark",  "label": "主色加深",        "type": "color", "default": "#0F7C7C" },
-    { "key": "primarySoft",  "cssVar": "--primary-soft",  "label": "主色浅调（装饰）", "type": "color", "default": "#E6F6F6" },
-    { "key": "bg",           "cssVar": "--bg",            "label": "页面底色",        "type": "color", "default": "#F5FBFA" },
-    { "key": "border",       "cssVar": "--border",        "label": "边框色",          "type": "color", "default": "#DCEDEB" },
-    { "key": "listLayout",   "label": "列表形态", "type": "select", "default": "grid",
-      "options": [ { "value": "grid", "label": "卡片网格（一行三张）" }, { "value": "list", "label": "简约列表" } ] },
-    { "key": "decoration",   "label": "背景装饰", "type": "select", "default": "dots",
-      "options": [ { "value": "dots", "label": "几何圆点" }, { "value": "plain", "label": "纯净无装饰" } ] }
-  ]
-}

src/main/resources/templates/themes/mint-breeze/README.md

@@ -1,36 +0,0 @@
-# mint-breeze 皮肤包
-
-由 blue-white 派生的清新薄荷风皮肤（docs/10 契约 §5 工作流）。**升级随版本发布，不在站点间复制目录**。
-
-> 注：本包与 fresh-mint 为同源并存的两个车道产物（并发会话分道，2026-09-08），互不依赖；站点二选一即可。
-
-## 风格定位
-
-清爽、亲和，适合职业院校门户：薄荷青品牌色、圆角 12px、卡片纯白+柔和阴影、细线顶栏+居中 logo（桌面吸顶，移动端取消）、列表卡片网格（一行 3 张）、几何圆点装饰与大留白；无纹理、无通栏大图、无复杂动效。
-
-## 数据契约（模板可取用的 model 属性全集，契约 §3）
-
-| 页面 | 属性 |
-| --- | --- |
-| 全部 | `site`（快照：config/分类树/轮播/友链组/院系子站）、`url`（PortalUrlHelper：home/category/article/asset/search/siteHome）、`themeBase`（=`themes/mint-breeze`）、`navCategories`、`pageTitle`、`seoDescription`、`canonical`、`themeParams`（微调参数，仅 theme.json 声明过的 key）、`themeVarsCss`（服务端预构建 `:root{}` 覆盖串，无参数为空） |
-| home | `banners`（时间窗内 home 位）、`topArticles`（置顶+最新 6）、`categoryBlocks`（LIST 型根栏目块，各 top 8） |
-| list / search | `listData`（分页）、`category`（list）、`q` + `searchMode`（search） |
-| detail | `article`、`prevArticle`、`nextArticle`、`currentCategoryId` |
-| single | `category`（含 `content`）、`currentCategoryId` |
-
-原则：皮肤不得假设"首页一定有轮播"，对空集合优雅降级。
-
-## 轮播图尺寸约定（bannerSize）
-
-1920x560（管理端上传端按此引导裁剪，D2 决策点）。
-
-## 可调参数
-
-见 `theme.json` 的 `params`：
-
-- **color**（进 CSS 变量）：`primary` 主色 / `primaryDark` 主色加深（即强调色，用于品牌文字与悬停加深）/ `primaryLight` 主色提亮 / `bg` 页面底色 / `cardBg` 卡片底色 / `border` 边框色 / `text` 正文文字 / `textLight` 次要文字。
-- **select**：`listLayout` = `grid`（默认，卡片网格一行 3 张）或 `row`（传统行列表）。
-
-换色建议：主色系三值同步调整（primary / primaryDark / primaryLight），bg 与 border、primaryLight 保持同族浅色调，避免底色与卡片对比失衡。
-
-优先级：`custom_css` > `themeVarsCss` > `main.css`。

src/main/resources/templates/themes/mint-breeze/assets/css/main.css

@@ -1,616 +0,0 @@
-/* ============================================================
- * mint-breeze 皮肤包样式（blue-white 派生，docs/10 皮肤包契约 §5）
- * 清新薄荷风：薄荷青品牌色 + 圆角 12px + 柔和阴影 + 卡片网格列表
- * + 几何圆点装饰与大留白；无纹理、无通栏大图、无复杂动效。
- * 轮播图设计尺寸约定：1920×560（管理端上传端按此引导裁剪）。
- * ============================================================ */
-:root {
-  --primary: #17A2A2;
-  --primary-dark: #0F7C7C;
-  --primary-light: #E6F6F6;
-  --text: #2F3E3C;
-  --text-light: #7D8F8C;
-  --bg: #F5FBFA;
-  --card-bg: #FFFFFF;
-  --border: #DDF0EE;
-  --radius: 12px;
-  --radius-sm: 8px;
-  --radius-pill: 999px;
-  --shadow-soft: 0 6px 18px rgba(15, 124, 124, .08);
-  --shadow-hover: 0 12px 28px rgba(15, 124, 124, .14);
-  --max-width: 1200px;
-}
-
-* { box-sizing: border-box; }
-body {
-  margin: 0;
-  font-family: "PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif;
-  color: var(--text);
-  background: var(--bg);
-}
-a { color: inherit; text-decoration: none; transition: color .15s ease; }
-a:hover { color: var(--primary); }
-img { max-width: 100%; }
-time, .item-meta { color: var(--text-light); font-size: 13px; }
-.empty { color: var(--text-light); text-align: center; padding: 32px 0; }
-
-/* ===== 头部：细线顶栏 + 居中品牌行 + 白底导航（桌面吸顶） ===== */
-.site-header {
-  position: sticky;
-  top: 0;
-  z-index: 90;
-  background: var(--card-bg);
-  box-shadow: var(--shadow-soft);
-}
-/* 细线顶栏：院系切换在左、站内搜索在右；院系未配置时搜索仍靠右 */
-.top-bar {
-  display: flex;
-  align-items: center;
-  justify-content: flex-end;
-  gap: 16px;
-  padding: 7px max(16px, calc((100% - var(--max-width)) / 2 + 16px));
-  border-bottom: 1px solid var(--border);
-  font-size: 13px;
-}
-.top-bar .site-colleges { margin-right: auto; }
-/* 居中品牌行：两侧几何圆点装饰（纯 CSS，无纹理） */
-.brand-row {
-  position: relative;
-  display: flex;
-  justify-content: center;
-  padding: 18px 16px 14px;
-}
-.brand-row::before, .brand-row::after {
-  content: "";
-  position: absolute;
-  top: 50%;
-  transform: translateY(-50%);
-  width: 46px;
-  height: 10px;
-  opacity: .45;
-  background-image:
-    radial-gradient(circle, var(--primary) 2.2px, transparent 2.8px),
-    radial-gradient(circle, var(--primary) 1.6px, transparent 2.2px),
-    radial-gradient(circle, var(--primary) 1.1px, transparent 1.7px);
-  background-repeat: no-repeat;
-  background-position: left center, center center, right center;
-}
-.brand-row::before { left: 6%; }
-.brand-row::after { right: 6%; }
-.site-brand { display: flex; align-items: center; gap: 14px; }
-.site-logo { height: 52px; }
-.site-name {
-  font-size: 28px;
-  font-weight: 600;
-  letter-spacing: .02em;
-  color: var(--primary-dark);
-}
-.site-name:hover { color: var(--primary); }
-.site-search { display: flex; align-items: center; }
-.site-search input {
-  border: 1px solid var(--border);
-  border-right: none;
-  border-radius: var(--radius-pill) 0 0 var(--radius-pill);
-  padding: 7px 16px;
-  width: 220px;
-  outline: none;
-  background: var(--card-bg);
-  color: var(--text);
-  transition: border-color .15s ease, box-shadow .15s ease;
-}
-.site-search input:focus {
-  border-color: var(--primary);
-  box-shadow: 0 0 0 3px var(--primary-light);
-}
-.site-search button {
-  border: none;
-  background: var(--primary);
-  color: #fff;
-  padding: 7px 20px;
-  border-radius: 0 var(--radius-pill) var(--radius-pill) 0;
-  cursor: pointer;
-  transition: background .15s ease;
-}
-.site-search button:hover { background: var(--primary-dark); }
-
-/* ===== 专业院系下拉（院系子站切换）：胶囊开关 + 圆角白卡面板 ===== */
-.site-colleges { position: relative; }
-.site-colleges .colleges-toggle {
-  display: inline-flex;
-  align-items: center;
-  gap: 6px;
-  border: 1px solid var(--border);
-  border-radius: var(--radius-pill);
-  padding: 5px 14px;
-  cursor: pointer;
-  color: var(--primary-dark);
-  font-weight: 600;
-  white-space: nowrap;
-  transition: border-color .15s ease, background .15s ease;
-}
-.site-colleges:hover .colleges-toggle {
-  border-color: var(--primary);
-  background: var(--primary-light);
-}
-.site-colleges .colleges-arrow { font-style: normal; font-size: 12px; color: var(--primary); }
-.site-colleges .colleges-menu {
-  display: none;
-  position: absolute;
-  top: 100%;
-  left: 0;
-  min-width: 200px;
-  max-height: 420px;
-  overflow-y: auto;
-  margin: 0;
-  padding: 8px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-hover);
-  z-index: 110;
-}
-.site-colleges:hover .colleges-menu { display: block; }
-.site-colleges .colleges-menu li a {
-  display: block;
-  margin: 0 8px;
-  padding: 9px 12px;
-  border-radius: var(--radius-sm);
-  color: var(--text);
-  white-space: nowrap;
-}
-.site-colleges .colleges-menu li a:hover { background: var(--primary-light); color: var(--primary-dark); }
-.site-colleges .colleges-menu li.active a { color: var(--primary); font-weight: 600; }
-
-/* ===== 主导航：白底 + 柔和文字层级，当前项圆点标记 ===== */
-.site-nav { background: var(--card-bg); border-top: 1px solid var(--border); }
-.site-nav ul {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 0 16px;
-  list-style: none;
-  display: flex;
-  justify-content: center;
-  flex-wrap: wrap;
-}
-.site-nav li a {
-  position: relative;
-  display: block;
-  padding: 13px 20px;
-  color: var(--text);
-  font-weight: 500;
-}
-.site-nav li a:hover { color: var(--primary); }
-.site-nav li.active a { color: var(--primary); font-weight: 600; }
-/* 几何圆点：当前栏目下方的小圆点 */
-.site-nav li.active > a::before {
-  content: "";
-  position: absolute;
-  left: 50%;
-  bottom: 5px;
-  width: 5px;
-  height: 5px;
-  transform: translateX(-50%);
-  border-radius: 50%;
-  background: var(--primary);
-}
-
-/* ===== 二级下拉导航：圆角白卡面板 ===== */
-.site-nav > ul > li { position: relative; }
-.site-nav li.has-sub > a::after { content: " ▾"; font-size: 12px; opacity: .7; }
-.site-nav ul.sub-nav {
-  display: none;
-  position: absolute;
-  top: 100%;
-  left: 0;
-  min-width: 168px;
-  max-width: none;
-  margin: 0;
-  padding: 8px 0;
-  list-style: none;
-  background: var(--card-bg);
-  border: 1px solid var(--border);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-hover);
-  z-index: 100;
-}
-.site-nav li:hover > .sub-nav { display: block; }
-.site-nav .sub-nav li a {
-  margin: 0 8px;
-  padding: 9px 12px;
-  border-radius: var(--radius-sm);
-  color: var(--text);
-  font-weight: 400;
-  white-space: nowrap;
-  background: none;
-}
-.site-nav .sub-nav li a:hover { background: var(--primary-light); color: var(--primary-dark); }
-.site-nav .sub-nav li.active a { color: var(--primary); font-weight: 600; }
-
-/* ===== 首页轮播：容器内圆角卡片（非通栏），几何圆点指示器 ===== */
-.banner {
-  position: relative;
-  width: min(var(--max-width), calc(100% - 32px));
-  margin: 24px auto 0;
-  border-radius: var(--radius);
-  overflow: hidden;
-  box-shadow: var(--shadow-soft);
-}
-.banner-slides { position: relative; height: 400px; }
-.banner-slide { display: none; position: absolute; inset: 0; }
-.banner-slide.active { display: block; }
-.banner-slide img { width: 100%; height: 100%; object-fit: cover; }
-.banner-title {
-  position: absolute;
-  left: 0; right: 0; bottom: 0;
-  padding: 14px 20px;
-  color: #fff;
-  font-weight: 500;
-  background: linear-gradient(transparent, rgba(20, 63, 61, .62));
-}
-.banner-dots {
-  position: absolute;
-  bottom: 14px; right: 20px;
-  display: flex; gap: 8px;
-}
-.banner-dots button {
-  width: 9px; height: 9px;
-  border-radius: 50%;
-  border: none;
-  background: rgba(255, 255, 255, .55);
-  cursor: pointer;
-  transition: background .15s ease, transform .15s ease;
-}
-.banner-dots button.active { background: #fff; transform: scale(1.25); }
-
-/* ===== 首页区块：卡片网格（头条通栏 + 栏目块一行 3 张） ===== */
-.home-main {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 28px 16px 56px;
-  display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 24px;
-}
-.top-strip, .category-block {
-  background: var(--card-bg);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-soft);
-  padding: 24px;
-}
-.top-strip { grid-column: 1 / -1; }
-/* 栏目标题：几何圆点标记（环形点），标题中等粗细、层级柔和 */
-.section-title, .block-head h2 {
-  margin: 0 0 14px;
-  font-size: 19px;
-  font-weight: 600;
-  letter-spacing: .02em;
-  display: flex;
-  align-items: center;
-  gap: 10px;
-}
-.section-title::before, .block-head h2::before {
-  content: "";
-  flex: none;
-  width: 9px;
-  height: 9px;
-  border-radius: 50%;
-  background: var(--primary);
-  box-shadow: 0 0 0 3.5px var(--primary-light);
-}
-.block-head { display: flex; align-items: center; justify-content: space-between; }
-.more {
-  flex: none;
-  font-size: 13px;
-  color: var(--text-light);
-  padding: 4px 12px;
-  border: 1px solid var(--border);
-  border-radius: var(--radius-pill);
-  transition: color .15s ease, border-color .15s ease, background .15s ease;
-}
-.more:hover {
-  color: var(--primary-dark);
-  border-color: var(--primary);
-  background: var(--primary-light);
-}
-.top-strip ul, .block-list { list-style: none; margin: 0; padding: 0; }
-.top-strip li, .block-list li {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-  padding: 10px 0;
-  border-bottom: 1px dashed var(--border);
-}
-.top-strip li:last-child, .block-list li:last-child { border-bottom: none; }
-.top-strip li a, .block-list li a {
-  flex: 1;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-.top-badge {
-  flex: none;
-  color: var(--primary-dark);
-  background: var(--primary-light);
-  font-size: 12px;
-  font-weight: 500;
-  padding: 2px 10px;
-  border-radius: var(--radius-pill);
-}
-
-/* ===== 列表页：卡片网格（默认一行 3 张；listLayout=row 切换行列表） ===== */
-.list-main {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 28px 16px 56px;
-}
-.breadcrumb { color: var(--text-light); font-size: 13px; margin-bottom: 14px; }
-.breadcrumb a { margin-right: 8px; }
-.breadcrumb span { margin-left: 8px; }
-.page-title {
-  font-size: 24px;
-  font-weight: 600;
-  letter-spacing: .02em;
-  margin: 0 0 22px;
-  display: flex;
-  align-items: center;
-  gap: 10px;
-}
-.page-title::before {
-  content: "";
-  flex: none;
-  width: 9px;
-  height: 9px;
-  border-radius: 50%;
-  background: var(--primary);
-  box-shadow: 0 0 0 3.5px var(--primary-light);
-}
-.article-list {
-  list-style: none;
-  margin: 0;
-  padding: 0;
-  display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 20px;
-}
-.article-list li {
-  background: var(--card-bg);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-soft);
-  padding: 22px 20px;
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-  transition: transform .18s ease, box-shadow .18s ease;
-}
-.article-list li:hover { transform: translateY(-3px); box-shadow: var(--shadow-hover); }
-.item-title {
-  font-size: 16px;
-  font-weight: 600;
-  line-height: 1.55;
-  overflow: hidden;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-}
-.article-list li:hover .item-title { color: var(--primary); }
-.item-summary {
-  color: var(--text-light);
-  font-size: 13.5px;
-  line-height: 1.7;
-  margin: 0;
-  flex: 1;
-  overflow: hidden;
-  display: -webkit-box;
-  -webkit-line-clamp: 3;
-  -webkit-box-orient: vertical;
-}
-.item-meta {
-  display: flex;
-  gap: 10px;
-  align-items: center;
-  margin-top: auto;
-  padding-top: 10px;
-  border-top: 1px dashed var(--border);
-}
-/* 布局变体：传统行列表（themeParams listLayout=row，见 list.html classappend） */
-.list-rows .article-list { display: block; }
-.list-rows .article-list li { display: block; margin-bottom: 16px; }
-.list-rows .item-summary { -webkit-line-clamp: 2; flex: none; }
-.list-rows .item-meta { border-top: none; padding-top: 0; margin-top: 6px; }
-
-/* ===== 分页：胶囊页码 ===== */
-.pagination {
-  display: flex;
-  gap: 8px;
-  justify-content: center;
-  flex-wrap: wrap;
-  padding: 28px 0 4px;
-}
-.pagination a {
-  min-width: 36px;
-  text-align: center;
-  padding: 6px 12px;
-  border: 1px solid var(--border);
-  border-radius: var(--radius-pill);
-  background: var(--card-bg);
-  font-size: 14px;
-  transition: color .15s ease, border-color .15s ease, background .15s ease;
-}
-.pagination a:hover { color: var(--primary-dark); border-color: var(--primary); }
-.pagination a.active { background: var(--primary); color: #fff; border-color: var(--primary); }
-
-/* ===== 详情/单页：整卡承载，正文舒适行距 ===== */
-.detail-main {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 28px 16px 56px;
-}
-.detail-main .article {
-  background: var(--card-bg);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-soft);
-  padding: 36px 40px;
-}
-.article-title {
-  margin: 4px 0 14px;
-  font-size: 26px;
-  font-weight: 600;
-  letter-spacing: .02em;
-  text-align: center;
-}
-.article-meta {
-  display: flex;
-  gap: 18px;
-  justify-content: center;
-  flex-wrap: wrap;
-  color: var(--text-light);
-  font-size: 13px;
-  padding-bottom: 18px;
-  border-bottom: 1px solid var(--border);
-}
-.article-content { line-height: 1.9; font-size: 16px; padding-top: 22px; word-break: break-word; }
-.article-content img { height: auto; border-radius: var(--radius-sm); }
-.article-content table { border-collapse: collapse; width: 100%; }
-.article-content table td, .article-content table th { border: 1px solid var(--border); padding: 6px 10px; }
-.article-sibling { display: flex; flex-wrap: wrap; gap: 12px; margin-top: 20px; font-size: 14px; }
-.article-sibling a {
-  flex: 1 1 320px;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-  background: var(--card-bg);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow-soft);
-  padding: 14px 18px;
-  transition: transform .18s ease, box-shadow .18s ease, color .15s ease;
-}
-.article-sibling a:hover {
-  color: var(--primary-dark);
-  transform: translateY(-2px);
-  box-shadow: var(--shadow-hover);
-}
-
-/* ===== 页脚：浅薄荷底 + 圆点分隔条（三态渲染逻辑不动） ===== */
-.site-footer {
-  margin-top: 40px;
-  background: var(--primary-light);
-  color: var(--text);
-  border-top: 1px solid var(--border);
-}
-.site-footer::before {
-  content: "";
-  display: block;
-  height: 8px;
-  width: min(var(--max-width), calc(100% - 32px));
-  margin: 18px auto 0;
-  background-image: radial-gradient(circle, var(--primary) 1.6px, transparent 2.2px);
-  background-size: 16px 8px;
-  background-repeat: repeat-x;
-  opacity: .4;
-}
-.footer-links {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 18px 16px 0;
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-}
-.links-group { display: flex; flex-wrap: wrap; gap: 6px 14px; align-items: center; font-size: 13px; }
-.group-name { font-weight: 600; margin-right: 4px; color: var(--primary-dark); }
-.links-group a {
-  padding: 3px 10px;
-  border-radius: var(--radius-pill);
-  transition: background .15s ease, color .15s ease;
-}
-.links-group a:hover { background: rgba(255, 255, 255, .75); color: var(--primary-dark); }
-.footer-info {
-  max-width: var(--max-width);
-  margin: 0 auto;
-  padding: 14px 16px 24px;
-  text-align: center;
-  font-size: 13px;
-  color: var(--text-light);
-}
-.footer-info p { margin: 4px 0; }
-
-/* B4 友链 Logo：与名称并排小图（高度 ~20px，垂直居中；过宽截断不撑破页脚） */
-.links-group a .link-logo {
-  height: 20px;
-  width: auto;
-  max-width: 64px;
-  object-fit: contain;
-  vertical-align: middle;
-  margin-right: 4px;
-  border-radius: 4px;
-}
-
-/* ===== 平板（≤992px）：网格降为两列，隐藏品牌行圆点装饰 ===== */
-@media (max-width: 992px) {
-  .home-main { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-  .article-list { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-  .brand-row::before, .brand-row::after { display: none; }
-}
-
-/* ===== 移动端（≤768px）：取消吸顶，网格单列，导航横向滑动 ===== */
-@media (max-width: 768px) {
-  .site-header { position: static; }
-  .top-bar { padding: 8px 14px; justify-content: flex-start; flex-wrap: wrap; }
-  .top-bar .site-colleges { margin-right: 0; }
-  .site-search { flex: 1; }
-  .site-search input { flex: 1; width: auto; min-width: 0; }
-  .brand-row { padding: 14px 16px 10px; }
-  .site-logo { height: 40px; }
-  .site-name { font-size: 22px; }
-  .site-nav ul {
-    justify-content: flex-start;
-    flex-wrap: nowrap;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch;
-  }
-  .banner-slides { height: 200px; }
-  .home-main { grid-template-columns: 1fr; padding: 18px 14px 40px; }
-  .article-list { grid-template-columns: 1fr; }
-  .detail-main .article { padding: 22px 16px; }
-  .article-title { font-size: 21px; }
-  /* 触屏无 hover：子菜单静态平铺（缩进列表），不做浮层 */
-  .site-nav ul.sub-nav {
-    display: block;
-    position: static;
-    border: none;
-    box-shadow: none;
-    background: transparent;
-    min-width: 0;
-    padding: 0 0 6px;
-  }
-  .site-nav .sub-nav li a { margin: 0; padding: 8px 16px 8px 34px; border-radius: 0; color: var(--text-light); }
-  .site-nav .sub-nav li a:hover { background: var(--primary-light); color: var(--primary-dark); }
-}
-
-
-/* ===== 左侧栏目导航（docs/11）：有二级节点的模块，栏目/文章页左侧展示兄弟目录 ===== */
-.list-main.has-sidenav, .detail-main.has-sidenav { display: flex; align-items: flex-start; gap: 24px; }
-.has-sidenav .list-body { flex: 1; min-width: 0; }
-.side-nav { flex: none; width: 220px; background: var(--card-bg, #fff); border: 1px solid var(--border); overflow: hidden; }
-.side-nav-head { background: var(--primary); color: #fff; font-size: 20px; font-weight: 700; text-align: center; padding: 18px 12px; letter-spacing: 2px; }
-.side-nav-list { list-style: none; margin: 0; padding: 0; }
-.side-nav-item + .side-nav-item { border-top: 1px dashed var(--border); }
-.side-nav-item a { display: block; padding: 12px 16px; color: var(--text); text-decoration: none; font-size: 15px; transition: background .15s ease, color .15s ease; }
-.side-nav-item a:hover { color: var(--primary); background: var(--bg); }
-.side-nav-item.active a { background: var(--primary); color: #fff; font-weight: 600; text-decoration: none; }
-/* 顶导航二级下拉当前项高亮（docs/11 顺带） */
-.site-nav ul.sub-nav li.active a { color: var(--primary); }
-@media (max-width: 768px) {
-  .list-main.has-sidenav, .detail-main.has-sidenav { flex-direction: column; gap: 12px; }
-  .side-nav { width: 100%; }
-  .side-nav-list { display: flex; overflow-x: auto; -webkit-overflow-scrolling: touch; }
-  .side-nav-item { flex: none; }
-  .side-nav-item + .side-nav-item { border-top: none; border-left: 1px dashed var(--border); }
-  .side-nav-item a { white-space: nowrap; }
-}
-@media print {
-  .side-nav { display: none; }
-  .list-main.has-sidenav, .detail-main.has-sidenav { display: block; }
-}

src/main/resources/templates/themes/mint-breeze/assets/favicon.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
-  <defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-    <stop offset="0" stop-color="#5486df"/><stop offset="1" stop-color="#214b97"/>
-  </linearGradient></defs>
-  <rect width="64" height="64" fill="url(#bg)"/>
-  <circle cx="32" cy="25" r="10" fill="#ffffff"/>
-  <path d="M 16 49.3 Q 32 30.7 48 49.3 Z" fill="#ffffff" opacity="0.92"/>
-</svg>

src/main/resources/templates/themes/mint-breeze/assets/js/main.js

@@ -1,40 +0,0 @@
-/* mint-breeze 皮肤包脚本：仅首页轮播自动播放与圆点切换，无任何外部依赖 */
-(function () {
-  var slides = document.querySelectorAll('.banner-slide');
-  var dots = document.querySelectorAll('.banner-dots button');
-  if (!slides.length) {
-    return;
-  }
-  var current = 0;
-  var timer = null;
-
-  function show(index) {
-    slides[current].classList.remove('active');
-    if (dots[current]) {
-      dots[current].classList.remove('active');
-    }
-    current = (index + slides.length) % slides.length;
-    slides[current].classList.add('active');
-    if (dots[current]) {
-      dots[current].classList.add('active');
-    }
-  }
-
-  function start() {
-    if (slides.length > 1) {
-      timer = window.setInterval(function () {
-        show(current + 1);
-      }, 5000);
-    }
-  }
-
-  dots.forEach(function (dot, index) {
-    dot.addEventListener('click', function () {
-      window.clearInterval(timer);
-      show(index);
-      start();
-    });
-  });
-
-  start();
-})();