@alanwang-merit/meritdata-platform-skill-package 1.0.8 → 1.0.10

package/skills/meritdata-platform-playbook/references/public-entry-map.json

@@ -0,0 +1,135 @@
+{
+  "$schema": "skill-suite.schema.json",
+  "version": "1.2.0",
+  "description": "公司级 Skill 套件的唯一编排入口路由表",
+  "last_updated": "2026-09-10",
+  "fix_log": [
+    "v1.1.0: 移除 core 层误登记的 meritdata-platform-data-boundary（它是 rules 不是 skill），改为引用 .claude/rules/data-boundary-rules.md",
+    "v1.2.0: extensions 层加入 meritdata-platform-org-sync（HR 集成子技能）和 meritdata-platform-portal-customization（portal 定制子技能），覆盖原 integration 的部分场景"
+  ],
+  "rules": {
+    "data_boundary": ".claude/rules/data-boundary-rules.md",
+    "sql_naming": ".claude/rules/sql-naming-rules.md",
+    "nacos": ".claude/rules/nacos-rules.md",
+    "api_design": ".claude/rules/api-design-rules.md",
+    "git_workflow": ".claude/rules/git-workflow-rules.md"
+  },
+  "skills": {
+    "core": [
+      {
+        "name": "meritdata-platform-playbook",
+        "type": "orchestrator",
+        "description": "唯一编排入口",
+        "triggers": ["跨skill", "新建", "存量接入", "项目模式识别"],
+        "allowed_actions": ["orchestrate", "detect", "route"]
+      },
+      {
+        "name": "meritdata-platform-2nd-dev-check",
+        "type": "validator",
+        "description": "项目就绪度体检",
+        "triggers": ["体检", "check", "上线前", "GAP"],
+        "allowed_actions": ["check", "report"]
+      }
+    ],
+    "themes": [
+      {
+        "name": "meritdata-platform-cloud-dev",
+        "type": "entry",
+        "description": "综合开发入口",
+        "triggers": ["开发", "代码生成", "能力查询"],
+        "modules": [
+          "gen", "platform", "domain-model", "data-boundary",
+          "feign-api", "platform-entities", "ui", "spec",
+          "cache", "config", "datasource", "utils", "logging",
+          "webapi", "masterdata-sync", "msg-job",
+          "services", "impexp", "file", "http-client", "governance"
+        ]
+      },
+      {
+        "name": "meritdata-platform-core",
+        "type": "theme",
+        "description": "后端基础设施（缓存/Nacos/加密/日志/会话/密级）",
+        "triggers": ["缓存", "Nacos", "国密", "操作日志", "Session"]
+      },
+      {
+        "name": "meritdata-platform-bpm",
+        "type": "theme",
+        "description": "工作流",
+        "triggers": ["审批", "BpmEngine", "待办", "流程追踪"]
+      },
+      {
+        "name": "meritdata-platform-job",
+        "type": "theme",
+        "description": "调度任务",
+        "triggers": ["定时任务", "XXL-JOB", "Cron"]
+      },
+      {
+        "name": "meritdata-platform-integration",
+        "type": "theme",
+        "description": "平台集成 + Feign",
+        "triggers": ["Feign", "Gateway", "WebService", "同步"]
+      },
+      {
+        "name": "meritdata-platform-frontend",
+        "type": "theme",
+        "description": "Vue 2 前端",
+        "triggers": ["Vue", "Element UI", "前端"]
+      },
+      {
+        "name": "meritdata-platform-entities",
+        "type": "theme",
+        "description": "平台实体 / Q 类",
+        "triggers": ["Emp", "User", "Q类", "基础表"]
+      },
+      {
+        "name": "meritdata-platform-ui-components",
+        "type": "theme",
+        "description": "前端组件库",
+        "triggers": ["CloudDialog", "UserSelect", "组件库"]
+      },
+      {
+        "name": "meritdata-platform-impexp",
+        "type": "theme",
+        "description": "导入导出 + 附件",
+        "triggers": ["Excel", "导入", "导出", "附件"]
+      }
+    ],
+    "extensions": [
+      "meritdata-platform-deploy",
+      "meritdata-platform-sso",
+      "meritdata-platform-cache",
+      "meritdata-platform-logging",
+      "meritdata-platform-session",
+      "meritdata-platform-data-secret",
+      "meritdata-platform-crypto-gm",
+      "meritdata-platform-resource-auth",
+      "meritdata-platform-messaging",
+      "meritdata-platform-config-item",
+      "meritdata-platform-org-sync",
+      "meritdata-platform-portal-customization"
+    ],
+    "team_private": [
+      {
+        "name": "meritdata-platform-bootstrap-2nd-dev",
+        "type": "team_private",
+        "description": "二开引导（团队私有）"
+      },
+      {
+        "name": "meritdata-platform-nacos-importer",
+        "type": "team_private",
+        "description": "Nacos 配置导入（团队私有）"
+      },
+      {
+        "name": "meritdata-platform-menu-config",
+        "type": "team_private",
+        "description": "菜单挂载（团队私有）"
+      }
+    ]
+  },
+  "routing_rules": {
+    "优先匹配": "用户显式 $skill-name",
+    "次优匹配": "业务关键词（description 触发）",
+    "兜底匹配": "$meritdata-platform-playbook 自动编排",
+    "门禁加载": "data-boundary 通过 .claude/rules/data-boundary-rules.md 自动加载（非 skill）"
+  }
+}

package/skills/meritdata-platform-playbook/references/skill-decision-tree.md

@@ -0,0 +1,125 @@
+# Skill 决策树
+
+> ⚠️ **本决策树已与 24 skill + 1 rules 架构对齐**（2026-09-10 修订）：原 7 个已下线 skill 全部替换为 `meritdata-platform-integration/references/external-api/full/` 下的真实文档路径。
+
+## 决策流程
+
+```
+用户需求
+  │
+  ├─ Q1: 是新模块/新功能吗？
+  │   ├─ 是 → 走 playbook 工作流 1-5
+  │   └─ 否 → Q2
+  │
+  ├─ Q2: 是 bug 修复 / 单点调试？
+  │   ├─ 是 → 用 systematic-debugging + 针对性 skill
+  │   └─ 否 → Q3
+  │
+  └─ Q3: 是查询 / 文档检索？
+      ├─ 是 → 走 playbook 路由表（public-entry-map.json）或直接 grep
+      └─ 否 → 找最近的 skill
+```
+
+## 单点问题决策
+
+```
+问题是什么？
+  │
+  ├─ "怎么做" 类（how-to）
+  │   ├─ 加日志 → meritdata-platform-logging
+  │   ├─ 加缓存 → meritdata-platform-cache
+  │   ├─ 加消息 → meritdata-platform-messaging
+  │   ├─ 加字典 → [integration/references/external-api/full/38_3.11基础数据.md](../../meritdata-platform-integration/references/external-api/full/38_3.11基础数据.md)
+  │   ├─ 加按钮 → meritdata-platform-resource-auth
+  │   ├─ 加菜单 → meritdata-platform-menu-config（团队私有 skill，非 resource-auth）
+  │   ├─ 加 BPM → meritdata-platform-bpm
+  │   ├─ 加 SSO → meritdata-platform-sso
+  │   ├─ 加电子签章 → meritdata-platform-crypto-gm
+  │   ├─ 加配置 → meritdata-platform-config-item
+  │   ├─ 加密级 → meritdata-platform-data-secret
+  │   └─ 加 UI 组件 → meritdata-platform-ui-components
+  │
+  ├─ "拿什么" 类（what-to-get）
+  │   ├─ 当前用户/部门 → meritdata-platform-session
+  │   ├─ 部门下人员 → [integration/references/external-api/full/28_2.2人员维护-下半.md](../../meritdata-platform-integration/references/external-api/full/28_2.2人员维护-下半.md)
+  │   ├─ 角色列表 → [integration/references/external-api/full/30_2.3角色维护-下半.md](../../meritdata-platform-integration/references/external-api/full/30_2.3角色维护-下半.md)
+  │   ├─ 字典项 → [integration/references/external-api/full/38_3.11基础数据.md](../../meritdata-platform-integration/references/external-api/full/38_3.11基础数据.md)
+  │   ├─ 资源树 → meritdata-platform-resource-auth
+  │   ├─ 平台 Logo → [integration/references/external-api/full/19_1.1-1.6基础配置-平台信息类.md](../../meritdata-platform-integration/references/external-api/full/19_1.1-1.6基础配置-平台信息类.md)
+  │   └─ 我的菜单 → meritdata-platform-resource-auth
+  │
+  └─ "查文档" 类
+      ├─ 任何文档 → playbook 路由表（[public-entry-map.json](public-entry-map.json)）
+      ├─ 平台能力 → 各对应 skill
+      └─ 编码规范 → .claude/rules/*.md
+```
+
+## 顺序优化（新模块）
+
+```
+前置：meritdata-platform-2nd-dev-check → 0 FAIL
+  │
+  ├─ 后端 9 步（按依赖）
+  │   1. meritdata-platform-sso        （登录）
+  │   2. meritdata-platform-session    （取当前用户）
+  │   3. meritdata-platform-integration（外部接口：org/role/dict）
+  │   4. meritdata-platform-cache      （缓存）
+  │   5. meritdata-platform-logging    （日志）
+  │   6. meritdata-platform-messaging  （通知）
+  │   7. meritdata-platform-data-secret（密级）
+  │   8. meritdata-platform-crypto-gm  （签名/加密）
+  │   9. meritdata-platform-resource-auth（权限）
+  │
+  ├─ 配置 1 步
+  │   - meritdata-platform-config-item （业务参数）
+  │   - meritdata-platform-integration（字典，详见 external-api/full/38_3.11基础数据.md）
+  │
+  ├─ 前端 2 步
+  │   - meritdata-platform-ui-components（选组件）
+  │   - meritdata-platform-resource-auth（资源授权）
+│   - meritdata-platform-menu-config（菜单挂载，团队私有 skill）
+  │
+  │
+  └─ 流程（按需）
+      - meritdata-platform-bpm                （BPM 流程）
+      - meritdata-platform-job                （XXL-JOB / Taier / DolphinScheduler）
+```
+
+## 优先级原则
+
+| 优先级 | 类别 |
+|-------|------|
+| 🔴 P0 | 平台接入（SSO + session）|
+| 🟠 P1 | 业务数据（integration 外部接口：org/role/dict）|
+| 🟡 P2 | 横切关注（cache + logging + messaging + data-secret）|
+| 🟢 P3 | UI/权限（ui-components + resource-auth）|
+| 🔵 P4 | 高级（meritdata-platform-crypto-gm + config-item）|
+| 🟣 P5 | 流程（meritdata-platform-bpm + job）|
+
+## 不应该用 skill 的场景
+
+| 场景 | 原因 | 应该用 |
+|------|------|-------|
+| 修改一个常量 | 太简单 | 直接编辑 |
+| 改 SQL | 通用 | .claude/rules/sql-naming-rules.md |
+| 加测试方法 | 通用 | .claude/rules/coding-standards-rules.md |
+| 改 pom 依赖 | 通用 | 平台文档 + meritdata-platform-bpm（如 BPM 依赖）|
+| 跨服务追踪 bug | 复杂诊断 | systematic-debugging + memory |
+
+## 已下线 skill 归档（**禁止再引用**）
+
+> 以下 7 个 skill 名已**全部下线**，列出仅作历史参考；任何新文档都**禁止**再使用这些名称。本表本身不是"可引用清单"，而是"作废清单"。
+
+| ~~旧名（已下线）~~ | 真实去向 |
+|---------------|---------|
+| ~~`meritdata-dev-docs-file-finder`~~ | playbook 路由表 [public-entry-map.json](public-entry-map.json) |
+| ~~`meritdata-platform-dict-api`~~ | `meritdata-platform-integration/references/external-api/full/38_3.11基础数据.md` |
+| ~~`meritdata-platform-org-user-api`~~ | `meritdata-platform-integration/references/external-api/full/25-35_2.1-2.6组织人员维护.md` |
+| ~~`meritdata-platform-menu-resource`~~ | `meritdata-platform-menu-config`（团队私有 skill，挂菜单）|
+| ~~`meritdata-bpm-2nd-dev`~~ | `meritdata-platform-bpm` |
+| ~~`meritdata-platform-config-integration`~~ | `meritdata-platform-config-item` |
+| ~~`meritdata-platform-basic-config-api`~~ | `meritdata-platform-integration/references/external-api/full/19-21_1.x基础配置.md` |
+
+---
+
+**修订说明**：本决策树于 2026-09-10 重写，移除 7 个已下线 skill 引用，统一指向 `integration/references/external-api/full/` 文档或现存 skill。

package/skills/meritdata-platform-playbook/references/svn-integration.md

@@ -0,0 +1,117 @@
+
+`meritdata-platform-playbook` 与 SVN 项目集成时遵循**只读契约**：仅读取状态，不修改任何东西。
+
+## 允许的操作
+
+### 1. 检查 SVN 仓库
+
+```bash
+# 检测 .svn/ 目录
+[ -d ".svn" ] && echo "svn-managed"
+
+# 获取 SVN 信息
+svn info
+```
+
+### 2. 读取工作区状态
+
+```bash
+# 工作区变更
+svn status
+
+# 详细状态（含属性变更）
+svn status --verbose
+```
+
+### 3. 读取差异
+
+```bash
+# 工作区 vs BASE
+svn diff
+
+# 指定文件
+svn diff src/main/java/Example.java
+```
+
+### 4. 读取日志
+
+```bash
+# 最近 5 条 log
+svn log -l 5
+
+# 单文件 log
+svn log src/main/java/Example.java
+```
+
+### 5. 读取分支/Tag 信息
+
+```bash
+# 当前分支（trunk / branches/x）
+svn info | grep "URL"
+
+# 所有 tag
+svn ls ^/tags
+```
+
+## 禁止的操作
+
+| 操作 | 原因 |
+|------|------|
+| `svn add` | 不自动添加 |
+| `svn commit` | 不自动提交（重点） |
+| `svn update` | 不自动更新 |
+| `svn switch` | 不自动切换分支 |
+| `svn merge` | 不自动合并 |
+| `svn delete` | 不自动删除 |
+| `svn revert` | 不自动回滚（破坏用户修改） |
+| 修改 `.svn/` 内部 | 破坏 SVN 完整性 |
+
+## 输出格式
+
+playbook 检测 SVN 项目后的输出：
+
+```yaml
+vcs:
+  type: svn
+  status: clean | modified
+  url: ^/branches/feature/leave-module
+  revision: 12345
+
+files_changed:
+  modified:
+    - src/main/java/Example.java
+  added:
+    - src/main/java/NewFile.java
+  deleted: []
+
+suggested_commit_message: |
+  feat(leave): 添加请假模块
+  - LeaveController
+  - LeaveService
+  - LeaveRepository
+  - SQL migration: 2026-09-01-create-leave.sql
+
+manual_steps:
+  - svn add src/main/java/NewFile.java
+  - 用户手动执行 commit（由用户执行，skill 不自动）
+```
+
+## 与 Git 的差异
+
+| 维度 | Git | SVN |
+|------|-----|-----|
+| 分支模型 | 本地分支 | 远程目录树（trunk/branches/tags） |
+| 暂存区 | 有（staging area） | 无（直接 commit） |
+| 本地提交 | 支持 | 不支持（必须联网） |
+| 修改检测 | `git status --porcelain` | `svn status` |
+| 差异查看 | `git diff` | `svn diff` |
+| 添加新文件 | `git add` 后 commit | `svn add` 后 commit |
+
+## 异常处理
+
+| 场景 | 处理 |
+|------|------|
+| `.svn/` 损坏 | 报错，要求用户执行 `svn cleanup` |
+| 网络不可用 | 仅读取本地缓存，提示 `svn update` 失败 |
+| 锁冲突 | 提示用户执行 `svn cleanup` 或 `svn unlock` |
+| 工作区有未提交修改 | 输出 diff，建议用户先 commit |

package/skills/meritdata-platform-portal-customization/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: meritdata-platform-portal-customization
+description: 平台 portal 定制（首页框架配置 / 主题切换 / Logo 定制 / 首页布局 / 个性化首页 URL）。基于 HomeFrameConfigController + ThemeController + WorkBench/Theme 实体；前端基于 cloud-system-portal 独立应用的 4 种布局组件与 theme-css 主题色变量。 | 触发条件：用户问首页定制 / 首页框架配置 / 主题切换 / 主题包上传 / Logo 定制 / 首页拖拽 / 门户定制 / HomeFrame / WorkBench 主题 / cloud-system-portal / branding / portal customization / 个性化首页 URL / 角色首页路由 | 用户提问示例："如何自定义平台 Logo？" "怎么切换主题色？" "首页框架配置 API 怎么调？" "如何上传主题包？" "WorkBench 实体怎么用？" | 不适用：菜单挂载 SQL（用 meritdata-platform-menu-config）/ Nacos 配置中心（用 meritdata-platform-config-item）/ Vue 工程脚手架（用 meritdata-platform-frontend）/ 业务组件库（用 meritdata-platform-ui-components）/ BPM 流程（用 meritdata-platform-bpm）
+metadata:
+  version: "1.0.0"
+  author: maohan
+  source: company
+  date_added: "2026-09-10"
+  last_updated: "2026-09-10"
+  risk: medium
+  allowed-tools: Read, Grep, Glob, Bash
+---
+
+# meritdata-platform-portal-customization（平台 portal 定制）
+
+> **新增日期**：2026-09-10
+> **背景**：基于平台源码调研（`cloud-system-manage-module/homeframeconfig` 12+ Java 类 + `cloud-module-base/WorkBench`+`Theme` 实体 + `cloud-system-portal` 独立前端应用 + `cloud-utils-theme-generator` 工程），现有 25 个 skill 在 portal 定制场景下 **0 命中**关键词。
+
+## ⭐ 这是什么
+
+**平台 portal 定制完整指南**，覆盖 5 大场景：
+
+| 场景 | 范围 | 关键 API/类 |
+|------|------|-----------|
+| 1. 首页框架配置 | `show/name/url/type/theme/useCustomTheme/roleHome` 等 **12 字段**（基于 `HomeFrameConfigProperties`） | `/api/basic/home-frame-config/find` |
+| 2. 主题管理 | 主题包上传/保存/删除/列表 | `/api/basic/home-frame-config/save-theme` 等 5 接口 |
+| 3. 首页布局切换 | `left-layout` / `top-layout` / `mixture-layout` / `other-info` 4 种布局 | `cloud-system-portal` 前端组件 |
+| 4. Logo 定制 | 自定义平台 Logo 图片流 | `/certificate/get-logo` |
+| 5. 角色首页路由 | 不同角色登录后跳转不同首页 | `/api/basic/home-frame-config/get-role-home-url` |
+
+## 🎯 适用场景
+
+| 场景 | 用本 skill |
+|------|----------|
+| 自定义平台 Logo / 主视觉 | ✅ |
+| 切换主题色 / 上传主题包 | ✅ |
+| 修改首页布局（左侧菜单/顶部菜单/混合）| ✅ |
+| 多角色登录跳转不同首页 | ✅ |
+| 个性化首页 URL（按角色）| ✅ |
+| 集成 `cloud-system-portal` 应用 | ✅ |
+| **菜单挂载到 `pf_resource`** | ❌ → 用 `meritdata-platform-menu-config` |
+| **Nacos 配置中心 / sys_config 业务开关** | ❌ → 用 `meritdata-platform-config-item` |
+| **Vue 工程脚手架 / Element UI** | ❌ → 用 `meritdata-platform-frontend` |
+| **业务对话框/选人/选部门** | ❌ → 用 `meritdata-platform-ui-components` |
+| **BPM 流程引擎** | ❌ → 用 `meritdata-platform-bpm` |
+
+## 📂 references（6 个文档）
+
+| 文件 | 章节 | 关键内容 |
+|------|------|---------|
+| `home-frame-config-api.md` | 第 1 章 | `/api/basic/home-frame-config/*` 13 个接口契约 |
+| `theme-management.md` | 第 2 章 | Theme 实体 + 主题包上传流程 + 前端 theme-css |
+| `workbench-entities.md` | 第 3 章 | WorkBench / WorkBenchAuth / WorkBenchMenu / WorkBeachHomePage 字段说明 |
+| `portal-frontend-layouts.md` | 第 4 章 | cloud-system-portal 4 种布局组件选型 |
+| `cloud-utils-theme-generator.md` | 第 5 章 | 主题代码生成器使用 |
+| `portal-product-config.md` | 第 6 章 | cloud-module-product-portal 产品定义 |
+
+## 🚀 快速使用
+
+1. **首次接入**：从 `home-frame-config-api.md` 开始读，了解 13 个 API
+2. **主题定制**：读 `theme-management.md` + `portal-frontend-layouts.md`
+3. **个性化首页**：读 `workbench-entities.md` + `home-frame-config-api.md` 第 1.15 节
+
+## 🔗 相关 skill
+
+| Skill | 何时用 |
+|-------|------|
+| `meritdata-platform-integration` | 跨 JVM Feign 装配 / 网关路径五段拆分 |
+| `meritdata-platform-entities` | WorkBench/Theme 等平台实体的完整字段索引（67 实体） |
+| `meritdata-platform-config-item` | Nacos 配置中心 / sys_config 业务开关（**与本 skill 存储位置不同**） |
+| `meritdata-platform-frontend` | Vue 2 工程脚手架（cloud-module-base 14 组件） |
+| `meritdata-platform-menu-config` | pf_resource 菜单挂载 SQL（与首页框架配置不重叠） |
+| `meritdata-platform-ui-components` | 14 个业务语义组件（对话框/选人等） |
+
+## 📌 历史
+
+- **2026-09-10**：基于平台源码调研新增（cloud-system-manage-module + cloud-module-base + cloud-system-portal + cloud-utils-theme-generator 4 大模块）
+- **抽离原因**：现有 25 个 skill 在 portal/theme/首页/拖拽/定制 关键词下 0 命中；二开客户高频问"如何自定义 Logo / 切换主题色"

package/skills/meritdata-platform-portal-customization/references/cloud-utils-theme-generator.md

@@ -0,0 +1,97 @@
+# 主题代码生成器（cloud-utils-theme-generator）
+
+> **来源**：基于 `F:/git-cloud-back/git-cloud-bak/cloud_back/cloud-utils-theme-generator/` 工程
+> **重要**：本文档只列工程位置 + 用途 + 调用方式，不复制源码
+
+---
+
+## 一、工程定位
+
+| 项 | 值 |
+|----|-----|
+| 工程名 | `cloud-utils-theme-generator` |
+| 路径 | `F:/git-cloud-back/git-cloud-bak/cloud_back/cloud-utils-theme-generator/` |
+| 类型 | 独立 Maven 工具工程 |
+| 用途 | 自动生成符合平台规范的主题包（zip）|
+
+---
+
+## 二、使用场景
+
+当客户/二开工程师想要：
+
+1. **创建自定义主题**：用 `cloud-utils-theme-generator` 自动生成标准主题包结构
+2. **避免手工错误**：工具确保主题包结构符合平台加载规范
+3. **快速原型**：基于现有主题（如 `theme-green`）快速生成新主题变体
+
+---
+
+## 三、典型工作流
+
+```
+1. 准备主题色变量（color.less）
+2. 运行 cloud-utils-theme-generator，指定主题名 + 颜色变量
+3. 自动生成符合平台规范的主题包 zip
+4. 通过管理后台上传主题包
+5. POST /api/basic/home-frame-config/save-theme 保存元数据
+6. POST /api/basic/home-frame-config/find 修改 theme 字段
+```
+
+---
+
+## 四、生成的主题包结构
+
+```
+output/
+└── theme-{custom-name}/
+    ├── color.less           # 主题色变量
+    ├── theme.less            # 全局样式覆盖
+    ├── assets/
+    │   ├── logo.png         # 可选 Logo
+    │   └── icons/           # 主题相关图标
+    └── manifest.json        # 主题元数据（name/version/author）
+```
+
+---
+
+## 五、与平台 jar 的关系
+
+**主题包加载路径**：`cloud-module-base/static/theme/`
+
+```
+cloud-module-base/
+└── static/
+    └── theme/
+        ├── theme-default/    # 平台内置默认主题
+        ├── theme-green/      # 平台内置绿色主题
+        └── theme-{custom}/   # 二开/客户上传的自定义主题
+```
+
+平台通过 `WorkBench.theme` 字段查找对应主题目录。
+
+---
+
+## 六、最小化定制方案
+
+如果**不**用主题生成器，最简单的方案：
+
+```
+直接修改 cloud-module-base/static/theme/theme-default/color.less
+├── @primary-color: #409EFF  → 改成客户品牌色
+├── @success-color: #67C23A  → 改成客户品牌色
+└── ...
+
+重新打包 cloud-module-base jar → 部署
+```
+
+> **⚠️ 缺点**：升级平台时会被覆盖；适合 PoC 阶段，不适合长期生产
+
+**推荐**：用 `cloud-utils-theme-generator` 生成新主题包 → 通过管理后台上传 → 不修改平台 jar
+
+---
+
+## 🔗 相关文档
+
+- `references/theme-management.md`（主题包上传流程）
+- `references/home-frame-config-api.md`（API 契约）
+- `references/portal-frontend-layouts.md`（前端主题目录结构）