两摊事,别混在一起看
内容中心(应用编码 cms)管两摊:一是内容台账 —— 文章、独立页面、分类、标签、评论与前台导航菜单;二是 /site/** 的整页直出能力 —— Thymeleaf 模板、主题样式脚本、SEO 标签与 404 版式。
后台编辑走的是第一摊,访客看到的页面走的是第二摊。这两摊共用一个数据库,但渲染链路上是分层的。

别的插件怎么借壳
图床、商城、报价这些应用各有自己的 /site/** 页面内容,但它们不各自写一套头尾和导航。平台 SDK 里有一条 SiteRenderApi 契约,实现方是内容中心的 CmsSiteRenderService:兄弟应用把「我这一屏的正文片段」交给它,它负责套上当前主题的壳,补齐导航、SEO 与全站资源。
所以会出现一个有意思的现象:app.json 里内容中心的 dependencies 是空的,别的插件却在前台这一层依赖它。没装内容中心时,后台页面、/open/、/portal/ 接口照常可用,只有 /site/** 那几屏取不到 —— 渲染器反查不到契约,给一个 404 加空响应体,日志里留一行「前台页要渲染但没有主题壳」。
主题就是一个目录
一套主题 = theme.json 清单 + 模板目录 + 样式脚本 + 截图。清单里声明页面键、设置项、自定义模板;非默认主题可以只写差异页,缺的页面按 default 回落,不必复制一整套。
后台切换主题后,下一请求就生效 —— 真值存在 cms_theme.enabled 表里,sys_config 里那个 cms.themeCode 只是启动兜底。上传的主题落在 data/cms-themes,和插件 jar 里的内置主题以「存储位置」区分,详情页一眼能看出来。

装之前要确认的两处宿主配置
一是 open-api.tenant.path-patterns 要含 /site/:公开页靠匿名租户带认出当前租户,少了它前台读到的是空列表。二是 xss.excludeUrls 要含 /cms/post/、/cms/page/、/portal/cms/post/:正文的消毒闸门在保存链路里,全局 XssFilter 若还拦这几条,富文本进插件之前就被清成纯文本了。


评论区需要浏览器启用 JavaScript 才能加载。