<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p><p>
</p><p><strong>内容中心</strong>,后台是 Vue 远程应用,公开页由插件服务端直出:主题只是产物里的一个目录。</p><p> </p><p> <img alt="应用版本" src="https://img.shields.io/badge/app-1.0.4-111111?style=flat-square"> <img alt="应用编码" src="https://img.shields.io/badge/code-cms-0057FE?style=flat-square"> <img alt="License" src="https://img.shields.io/badge/license-commercial-orange?style=flat-square">
功能特性 安装 设置 菜单入口 公开页 常见问题 <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p><p>
Wujies 无界平台(wujies.cn)的内容应用,Halo 的玩法:后台是 Vue 远程应用,
公开页是服务端渲染的整页 HTML,主题只是产物里的一个目录。默认主题(themes/default/)是 Nike 官网的版式骨架。
- 后台:应用市场装上后多一个「内容中心」菜单,前端是远程应用(
frontend/,27 个文件), 管概览、文章、页面、菜单、分类、标签与站点配置的列表与编辑器。 - 前台:
/site/**整页由本插件直出(首页 / 文章 / 分类 / 标签 / 独立页面 / 用户主页 / 关注粉丝页 / 404), 模板与主题 CSS、JS 都在本仓库产物里(见「公开页与自带样式」)。 - 它也是整个前台的骨架:主题令牌、共享件(
.pager/.row-list/.shop__list…)都在这里, 各应用自己那一屏的样式经appStyles这个唯一的口子插进来 —— 图床、商城、报价、社交四个插件仓的 README 现在都引用本文「写主题时必须守住的五条」第 5 条。
应用编码 cms | 应用版本 1.0.4 | 后端构件 wujies-cms-plugin | Java 源码 74 个文件 | 迁移脚本 15 个
总体设计与分阶段计划在项目根的 wujies/实施计划-CMS应用与Nike主题.md(不在本仓库内)。
✨ 功能特性
- 📝 文章 — 列表 + 富文本编辑器,封面、分类、标签、精选/置顶、SEO 字段,1.0.4 起每篇可带一句版权声明(
copyright_text)。 - 📄 独立页面 — 别名直接占根一级
/site/{slug},对齐 Halo 的SinglePageRoute;撞上保留字保存即报错,公开访问一律 404。 - 🧭 菜单 — 一条菜单一个位置,菜单项存引用不存 URL,两级 + 新窗口,整树拖拽保存(
PUT /cms/menu/{id}/tree)。 - 🗂️ 分类与标签 — 树形分类 + 标签两套归档口径,前台各有列表页(
/site/category/{slug}、/site/tag/{slug})。 - 🎨 主题即目录 — 模板(
templates/cms/<主题编码>/)、theme.css、site.js、toc.js、评论组件产物全在同一份产物里,换主题 = 整份拷贝目录 + 改cms.themeCode。 - 🌐 公开页 SSR — 整页 HTML 服务端渲染(不是 JSON),带 SEO 五件套、正文目录、404 主题页与
noindex兜底。 - 👤 用户公开主页与关系页 —
/site/user/{userId}(文章 SSR,图片/收藏/点赞切 tab 再问各应用)、/site/user/{userId}/relations(关注 / 粉丝)。 - 💬 评论区 — 组件在
wujies-ui,产物随主题一起发;评论数据由社交应用、头衔由会员应用提供,CMS 只印挂载点。 - 🛒 跨应用取数 — 首页「精选商品」经 SDK 契约
MallCatalogApi运行期反查商城;商城没装时这一栏整块不存在。 - 🖼️ 同源媒体代理 —
/site/media/remote把 OSS 上的封面搬回本站域名,供海报画布与下载用(带 SSRF 闸门)。 - ⚙️ 站点配置 — 全部
cms.*键写在sys_config,后台「配置」页两个 tab 直接改,改完刷新即生效。 - 🔐 多租户 — 内容与站点配置都按
tenant_id隔离,种子脚本只写默认租户000000。
🚀 安装
环境要求
| 项 | 要求 |
|---|---|
| 平台版本 | >=5.6.2 <6.0.0(app.json 的 engine) |
| 后端构建 | JDK 17+(父 POM 的 java.version 为 17) |
| 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm |
| 宿主前提 | wujies-admin/pom.xml 引 org.thymeleaf:thymeleaf + thymeleaf-spring6(纯库、不是 starter),且 open-api.tenant.path-patterns 含 /site/**(见「依赖与插件支持」) |
| 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取;需要一枚覆盖本应用的有效授权凭证(商业授权) |
从应用市场安装
- 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
- 安装时自动执行
migrations/下的 15 个脚本(按文件名排序:建表 → 种子 → 站点配置 → 菜单 → 法律页 / 备案 / 联系 / 版权列)。 - 装完刷新菜单,出现「内容中心」即成功;前台入口是
/site/。
包里两个产物的路径由 app.json 的 assets 决定:
frontend → frontend/index.js | backend → backend/wujies-cms-plugin-1.0.4.jar。
清单只有 1 项 menus(根「内容中心」,下挂概览 / 文章 / 页面 / 菜单 / 分类 / 标签 / 配置七个子项)。
从源码构建
在本仓库根打包(三条命令各管一段,都在本仓库根执行):
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev # ② 开发包:不签名,落 ..\.plugin-dist\cms\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 # ③ 正式包:构建 + 用 keys\private.pem 签名关于上面三条命令的取值口径:
- 判据是「脚本所在仓库根有没有
app.json」,所以在本仓库里不要传-Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject/-FrontendDist也不用传 —— 独立布局的前端工程固定就是 本仓库frontend/、产物frontend/dist,脚本自己跑npm run build(首次先cd frontend && npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加-SkipBuild。 -SkipFrontend只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有app.json,装上去没有界面。-CheckOnly打出的CHECK|级别|项|说明行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库keys/(private.pem+public.pem,已在.gitignore里),生成或更换用-Keygen(覆盖已有密钥要显式加-KeygenForce,旧钥先整份备份进keys\backup\<时间戳>\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。
手工构建(不用打包脚本时):
mvn -o compile # 后端(宿主 dev-mode 加载的是 target/classes;前提见「常见问题」的父 pom 一条)
cd frontend && npm install && npm run build # 前端,库模式构建,没有 HMR后端改完 POST /app/dev/reload {"appCode":"cms"} 热加载;模板与 CSS 是资源,mvn -o compile
就会复制进 target/classes(用 javac 手工落类时不会,见「常见问题」里 -parameters 那一条)。
最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」,
找到 cms 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」
(常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见
文档站「插件开发」。
升级与卸载
- 升级:换
app.json的version后重新打包上传。已执行的迁移脚本不可改内容 (平台按(appCode, script)记摘要),新增表结构一律加新编号脚本 ——15-add-cms-post-copyright.sql就是这种加法(给文章加copyright_text列)。升级或安装时 08 / 13 / 14 才会把通知条、公网安备、 联系方式的配置行落进sys_config;已装好的环境不升级就一直是空的。 - 卸载:管理端「应用市场」里卸载,平台按
migrations/记录的CREATE TABLE清理cms_*数据表, 并按config_category = 'cms'清掉站点配置行。
⚙️ 设置
运行时的站点信息集中在后台「内容中心 → 配置」(对应菜单 cms-settings):两个 tab,
「网站配置」= cms.name / cms.description / cms.icp,「业务配置」= Hero 两行、通知条那八条、
siteUrl / consoleUrl / themeCode。全部落在 sys_config,不写配置文件,改完刷新前台即生效
(cms.themeCode 例外,见下)。
> ⚠️ updateByKey 只改已存在的行:键不在 sys_config 里时影响 0 行,SysConfigServiceImpl
> 直接抛「操作失败」,不会补插。页面上出现的每个键都必须先由迁移脚本建好行 ——
> 这也是本页不摆 Logo / 图标 / 背景图那三项的原因:主题不读 cms.logo,摆出来只是一坑。
站点配置:写在 sys_config,不写在 application.yml
插件里读不到 application.yml。 插件子上下文是 AnnotationConfigApplicationContext,
它不继承宿主的 Environment:@ConfigurationProperties 绑不上,@Value("${...:默认值}")
只会静默拿到默认值 —— 两种都不报错,症状是"改了配置没反应"。平台给应用留的口子是参数表:
migrations/03-create-cms-config.sql 往 sys_config 插 config_category = 'cms'、
键名 cms. 前缀的行,CmsThemeConfigReader 每请求读一次(去前缀后交 CmsThemeProperties)。
| 键 | 作用 | 改完怎么生效 |
|---|---|---|
| cms.name | 标题、页脚、OG 站点名 | 刷新页面 |
| cms.description | meta description 的最后一级回落 | 刷新页面 |
| cms.icp | 页脚备案号;空串 = 不渲染这一行 | 刷新页面 |
| cms.police | 页脚公网安备号(整段展示文本,图标 beian.png);policeUrl() 从文本里取数字拼公安部查询链接,取不出数字就只印文本 | 刷新页面 |
| cms.heroTitle / cms.heroSubtitle | 首页 Hero 两行大字;副标空串 = 不渲染 | 刷新页面 |
| cms.siteUrl | canonical / og:url 的域名;留空则不输出这两个标签 | 刷新页面 |
| cms.consoleUrl | 管理端地址,主题里拼成 /login、/register、/member 三个跳转,并各带一个 ?redirect=<当前前台页>;留空 = 整块不渲染这些链接 | 刷新页面 |
| cms.themeCode | 模板与资源用的主题目录名 | 重新加载应用(引擎按主题分套,装载期定型) |
| cms.regionName / cms.regionUrl | 通知条最左那个站点标识(默认「中国」)+ 它的切换地址;regionUrl 空 = 印纯文本,不带地球图标 | 刷新页面 |
| cms.noticeOne / cms.noticeOneUrl</p><p><br></p><p>cms.noticeTwo / cms.noticeTwoUrl | 通知条中间那两条轮播公告(各 5 秒换一条);某条文字留空 = 那条不进列表,链接留空 = 印纯文本 | 刷新页面 |
| cms.helpName / cms.helpUrl | 通知条最右那个入口(默认「帮助」→ https://docs.wujies.cn);helpUrl 空 = 印纯文本 | 刷新页面 |
| cms.contactEmail / cms.contactQq / cms.contactWechat / cms.contactPhone | 页脚「联系我们」四行:邮箱(可发信)、QQ 号、微信号、手机号(可拨号);单行留空 = 不显示那一行,四项都空 = 整列不渲染 | 刷新页面 |
> ⚠️ 上面这 8 个通知条键由 migrations/08-add-cms-notice-bar-config.sql 建,后台「配置 → 业务配置」
> 也已摆出这八个输入框。迁移没跑之前,这八个框是空的(sys_config 里还没有行),
> 而前台照旧显示 Java 默认值 —— 于是"框里没字、页面上有字"看着像 bug。
> 更糟的是此时往任何一个框里打字点保存会 保存失败:updateByKey 对不存在的键影响 0 行并抛「操作失败」,
> 不会补插。保存只提交改动过的键,所以什么都不动地点保存是安全的。
> 装/升级应用时 08 会自动执行(migrations/ 目录按文件名排序扫,不用改 app.json);
> 已经装好的环境要让它生效,就得走一次升级或手工执行那份 SQL。
> 默认值的口径见 CmsThemeProperties 那八个字段的注释:必须是本站此刻真的事,不能写假促销。
> 13 / 14 两个脚本同一条规矩:公网安备号与联系方式默认值刻意留空,种示例号码等于让访客打到别人那里。
> 曾经的坑(平台已修,2026-10-29):SysConfigBo 的 defaultValue 与 configValue 都挂过 @NotBlank,
> 而 cms.siteUrl / cms.icp / cms.consoleUrl 这三行的 default_value 按设计就是空串 —— 在「参数设置」里
> 点保存会 500「默认值不能为空」,连「把值清空以隐藏」都做不到。现在两条校验都去掉了(@Size 保留),
> 空串是合法值:键值留空 = 该项前台不渲染。前提是跑的是改过的宿主;老 5.6.2 构建仍会 500。
三条附带好处:后台「系统管理 → 参数设置」直接能改;宿主泛化端点 GET /open/cms/config
零改动就能读给 C 端(name/description/icp 是它的基础字段,其余进 settings);
改值会自动失效 Redis 缓存。
规则:没有这一行 → 用 Java 里的默认值;有这一行但值为空串 → 按空串(管理员清空就是想要"不显示")。
配置按租户隔离(sys_config 是租户表),所以 03 / 08 / 13 / 14 只插了默认租户 000000,别的租户要各补一份。
后台「配置」页:复用宿主那对 settings 组件,插件里不写表单
frontend/src/views/cms/settings/** 只有三个壳文件(一个 tabs 壳 + 两个一行的包装),
表单体是宿主的 ModuleWebsiteSettings / ModuleBusinessSettings —— 它们是
wujies-admin/src/components/settings/*.vue,宿主本地组件,只是经
wujies-admin/src/plugins/appmarket/runtime.ts 的 SHARED_COMPONENTS 注入给远程应用;
从 @wujies/components 来的只有它们里面那个 SettingForm。
所以给这两个页加字段不触发 npm 发布(改 @wujies/components 才要)。
与 IM / 图床 / 考试同一形态。两个 tab 的分工:「网站配置」= cms.name / cms.description / cms.icp,
「业务配置」= heroTitle / heroSubtitle / 通知条那八条(regionName / regionUrl /
noticeOne / noticeOneUrl / noticeTwo / noticeTwoUrl / helpName / helpUrl)/
siteUrl / consoleUrl / themeCode。
- 取数与保存走宿主通用接口:
GET /system/config/list?configCategory=cms读,改动的键逐条PUT /system/config/updateByKey。 所以调用者的角色除了cms:settings:list,还得有system:config:list/system:config:edit(超级管理员天然有)。 - 为此动过宿主一次:那两个组件各自有一份按
category分组的字段表与Category联合类型, 加一档应用就是往表里加一项(ModuleWebsiteSettings顺带把品牌图三项与必填规则改成按 category 取, mall/im/exam/gallery 的字段和校验一字未变)。这是本应用在 pom/yml 之外对宿主的第三处改动。 ⚠️ModuleWebsiteSettings.vue的FieldKey是封闭联合类型(只有品牌图 + 那五个), 往「网站配置」页加键得先扩它;「业务配置」页的moduleFieldMap是自由键,加项请优先加在那边。
菜单入口
| 菜单 | 路径 | 组件键 | 权限前缀 |
|---|---|---|---|
| 概览 | cms/overview | remote:cms/cms/overview/index | cms:post:list(与文章共用) |
| 文章 | cms/post/list | remote:cms/cms/post/index | cms:post:* |
| 页面 | cms/page/list | remote:cms/cms/page/index | cms:page:* |
| 菜单 | cms/menu | remote:cms/cms/menu/index | cms:menu:* |
| 分类 | cms/category | remote:cms/cms/category/index | cms:category:* |
| 标签 | cms/tag | remote:cms/cms/tag/index | cms:tag:* |
| 配置 | cms/settings | remote:cms/cms/settings/index | cms:settings:list |
app.json 里每个 C 菜单下挂的 F 按钮(cms-post-query/add/edit/remove 等)与上表前缀逐字对应;
菜单是平台按清单幂等 upsert 出来的(AppMenuPlanner),不要手工写 sys_menu。
菜单多寡不影响前台:前台导航走的是 cms_menu / cms_menu_item(见「导航」一节)。
🌐 公开页与自带样式
/site/** 整页 HTML 由本插件服务端直出:模板与 CSS、JS 都在应用产物里,
所以开发态和生产态同源、同一代类加载器、同一次 reload —— 这是当初把资源端点从 /remote-apps
静态目录改成后端直出的原因(详见 CmsThemeAssetController 类注释)。
| 路径 | 说明 | 渲染模板 |
|---|---|---|
| GET /site/(含 /site) | 首页:Hero + 精选 + 最新 +(装了商城时)商城精选 + 会员区 | index.html |
| GET /site/p/{slug} | 文章详情(作者块、版权声明、正文目录、评论挂载点);取不到时返回 404 状态 + 主题自己的 404 页 | post.html / error.html |
| GET /site/category/{slug} | 分类列表 | list.html |
| GET /site/tag/{slug} | 标签列表 | list.html |
| GET /site/user/{userId} | 用户公开主页:文章由服务端直出,图片 / 收藏夹 / 点赞三档切 tab 时再向各应用问 | user.html / error.html |
| GET /site/user/{userId}/relations | 关注 / 粉丝页:两档 tab、名单三列卡片,等级勋章与关注状态各自补齐 | relations.html / error.html |
| GET /site/{slug} | 独立页面(关于 / 联系 / 落地页 / privacy / terms),别名直接占根一级,对齐 Halo 的 SinglePageRoute;别名撞上保留字(p、category、tag、themes、shop…)时保存就报错,公开访问一律 404 | page.html / error.html |
| GET /site/themes/{code}/{file} | 主题 CSS / JS / 图片 / 字体 | — |
| GET /site/post/summary?ids=1,2,3 | 文章摘要 JSON(/site/** 匿名族,一次最多 100 篇) | — |
| GET /site/media/remote?url= | 同源媒体代理:把 OSS 上的封面搬回本站域名(海报画布与下载用) | — |
| GET /site/account | 账号区取「我是谁」(昵称 + 头像 URL),给 site.js 调,不是页面 | — |
| POST /site/account/logout | 注销当前这一个令牌,给账号区下拉的「退出登录」调 | — |
/site/media/remote 是一个匿名可读、能替别人发请求的端点,所以闸门按「最小能力」写死:
只放行 http/https 且端口 80/443;主机名不许是 IP 字面量、不许是本机/内网/链路本地/唯一本地地址
(DNS 解析后逐个地址判,域名解析到内网也挡);不跟 3xx(跟了就能绕过主机白名单);
只接受 image/*;最多 8MB;缓存一天。宁可少代理一张图,也不长出一个能打内网的 SSRF 洞。
挂载点写死在 CmsThemeProperties.PUBLIC_BASE(/site)—— 它必须等于控制器上的 @RequestMapping,
所以不是配置项:配错了链接全断而端点不会跟着移动。接管根路径 / 是阶段 C 的事,
前提是把宿主 IndexController#index 那份网站配置接口的消费方先迁走。
⚠️ 这张表不含别的应用发的公开页与静态资源:
- 商城六页已搬回商城应用(
MallSiteController):/site/shop、/site/shop/home、/site/product/{id}、/site/activity、/site/coupon、/site/store/{id}。CMS 只留 URL 拼接与卡片口径 (CmsThemeProperties#shopUrl/productUrl/couponUrl、CmsMallCard、CmsMallProduct),不再出这些页面。 /site/comment/**是社交应用、/site/member/profiles是会员应用、/site/interaction/**与/site/follow/**也是社交、/site/gallery/image/**是图床。/site/apps//**是各应用自己发的公开页静态资源(图床、商城、报价已在用,机制见 「写主题时必须守住的五条」第 5 条),本仓库没有那个端点,也别来这里找。
themes/default/theme.css(当前实测 4116 行)是这一整套前台的基元与共享件;
1.0.1 那轮商城把专属样式搬走时它从 3576 行降到 2685 行,之后用户主页、关注页、标签页、法律页
等新屏又把它加回来了。各应用自己那一屏的样式由那个应用自己发、经 appStyles 排到 theme.css
之后 —— 边界与理由都在「写主题时必须守住的五条」第 5 条。
🧩 依赖与插件支持
| 项 | 说明 |
|---|---|
| 依赖插件 | app.json 的 dependencies 为空,但前台内容按装了谁决定:商城(首页精选商品、导航里的商城页)、社交(评论区与互动条)、会员(作者头衔 / 勋章)、图床(导航里的图片页)—— 缺谁就少哪一块,页面本身不报错 |
| 宿主前提 | 见下节「宿主侧只需要两处」(thymeleaf 纯库 + /site/** 进租户路径清单) |
| 平台存储 | 上传图片走平台「存储配置」(OSS / 本地),本插件不另存密钥;公开页只按 URL 取图(跨域那条走 /site/media/remote) |
| 公共 API | 前端走打进包内的 @wujies/api-client;运行时由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例;ModuleWebsiteSettings / ModuleBusinessSettings / ImageUpload / WangEditor 由宿主运行时提供 |
宿主侧只需要两处
wujies-admin/pom.xml引org.thymeleaf:thymeleaf+thymeleaf-spring6(纯库,不是 starter)。PluginClassLoader是 parent-first,引擎必须由宿主提供;不引 starter 是为了不往全 JSON 的宿主上 装一个全局thymeleafViewResolver。插件侧一律provided。application.yml的open-api.tenant.path-patterns加- /site/**, 让匿名公开页落进既有的租户解析那一条带(取值顺序仍是 querytenantId> headerX-Tenant-Id> 默认租户)。
鉴权没有扩大匿名面:/site/** 靠控制器上的 @SaIgnore 放行,与
/portal/enterprise/**、/open/gallery/* 同一套既有做法。
导航:菜单(cms_menu + cms_menu_item),不是分类
头部/页脚那排链接来自后台「内容中心 → 菜单」,对齐 Halo 的 Menu / MenuItem:
- 一条菜单 = 一个位置,靠
code认。主题头部取code = 'main'(写死在CmsMenu.CODE_MAIN),页脚复用同一份nav变量、只渲染顶层。要第二排链接就再建一条菜单, 但模板得跟着改 —— 位置是主题概念,不是配置项。 - 菜单项存引用,不存复制来的 URL:
source_type∈home/post/page/category/plugin/url, 中间几类配ref_id(内容主键),链接在 Java 侧按当前主题/挂载点现算(CmsMenuServiceImpl.resolveUrls)。 所以改了文章别名,导航自动跟着变,不会留下坏死链接。url类型才用href, 且只允许http://、https://、/三种前缀 —— 挡的是javascript:混进</p><p>。 plugin是跨应用那一档(href列借来存应用编码:页面标识,如mall:shop): 地址每次渲染时向提供方现问(CmsSitePageFinder→ 各插件的SitePagesApi#listSitePages), 插件改名、换路径都不用再改数据。迁移09把早期的'shop'来源迁成通用的一档,10/11给主导航补上图片广场 / 企业查询 / 考试安排 / 在线询价并改了短名。home是本站固定页:不引用任何内容对象,ref_id与href一律置空,URL 由theme.homeUrl()现算。 商城没装时商城那条整条摘掉(CmsSitePageFinder拿到空清单 →navItems跳过并打一行 info 日志): 导航上摆一条点进去什么都没有的链接,比少一个入口更糟。后台预览不受影响 —— 摘除只发生在前台解析那一条路。- 两级 + 新窗口:
parent_id组树,后台拖拽排序(整树PUT /cms/menu/{id}/tree), 主题头部渲染两层(二级是 hover/focus 下拉),target = '_blank'会真的写进</p><p>。 树最深 5 级(MAX_DEPTH),防的是把某个节点拖成自己的子孙之后组树死循环。 - 删了内容不报错:前台渲染时解析不出链接的项直接跳过(文章转草稿、被删、
href不合法都算), 访客看不到死链;后台树里同样的项会标「内容已删除」,让运营去改。这是两种解析模式之间 唯一故意保留的差别(publishedOnly参数)。 - 菜单为空 → 回落取前 6 个分类,见
CmsPublicController#buildNav。新租户装完还没进过菜单页时 头部不至于一片空白,同时也是本应用有菜单之前的老行为。 - 前端两处坑(联机实测踩到的):
v-hasPermi挂在 `上不会生效(它的根不是元素 节点,Vue 只给一条Runtime directive used on component with non-element root node就继续渲染), 所以权限挂在「更多」那个触发上、把三个权限码或着写在一起;「上级菜单项」的el-tree-select用undefined表示顶级,初值给0会把「0」当成已选值显示出来,保存时再补成后端要的0`。
「菜单」管导航,「分类」管归档,两者并存 —— 分类退回它该干的事(给文章分组、列表页按它筛选),
页面里的这一层从「栏目」统一改叫「分类」,避免和菜单混。迁移与种子见 migrations/06-add-cms-menu.sql
(默认租户 000000 建了一条 main 菜单和 4 个菜单项;别的租户要各建各的)、
07-add-cms-menu-shop-item.sql(补「商店」,固定 id 9155,INSERT IGNORE 幂等;地址口径后来由 09 改成 plugin)。
商品从别的应用借:Finder 契约(Halo 的做法)
Halo 的商城页不是主题写的 —— 数据在插件里,主题只有一份可覆盖的模板。我们同一形态: 商城有数据,主题有版式,中间是一份放在平台 SDK 里的契约。
wujies-common-plugin-sdk/…/sdk/MallCatalogApi.java 契约(四个方法,参数全是标量)
MallProductView 商品视图(卡片上那几行,只有展示字段、没有链接)
MallProductDetailView 详情(图集 + 规格 + 正文),组合上面那个视图
MallSkuView / MallSpecViewValue 规格行与属性值(JSON 由商城解析好)
MallCategoryView 分类视图(id / parentId / name)
wujies-mall-plugin/…/mall/adapter/MallCatalogApiAdapter.java 实现(@Service,只在插件子上下文)
wujies-cms-plugin/…/cms/theme/CmsMallFinder.java 消费方(本应用唯一的跨应用取数入口)
wujies-cms-plugin/…/cms/theme/CmsMallCard.java 卡片的展示口径(标签/副标题/划线价/折让怎么判)
wujies-cms-plugin/…/cms/theme/CmsMallProduct.java 详情页的展示口径(图集、库存那句话、正文消毒)- 为什么必须"反查"而不是
@Autowired:插件运行时是「宿主上下文 → 每个插件一个子上下文」, Spring 的父子关系单向 —— 插件能看见宿主,宿主和兄弟插件都看不见它。所以 CMS 里注入ObjectProvider拿到的永远是 null(gallery 的FollowRelationApi就是这个坑, 它的 javadoc 写着"宿主侧提供",实现却在兄弟插件里,静默降级)。走PluginServiceProvider#getPluginBean("mall", MallCatalogApi.class),且每次调用现取, 这样商城热重载之后 CMS 不会握着上一代对象。 - 为什么契约能对上:
PluginClassLoader对cn.wujies..*才走子加载器,cn.wujies.common.*一律 parent-first,所以 SDK 里那个MallCatalogApi在每个上下文都是同一个 Class, 按类型查找才有意义。这也是 SDK 只依赖wujies-common-core的原因 —— 一旦它依赖实现,应用就又和宿主绑死了。 相应地,签名里只有Long / String / int和两个 SDK 自己的 DTO,没有MallProductBo、PageQuery这些商城类型。 - 降级是设计的一部分:
getPluginBean约定返回 null 不抛异常,CmsMallFinder再把"商城装了但表还没在线上建" 这类运行期异常也吞成空列表 +log.warn。症状必须是"首页少一栏、导航少一条、商城页由商城自己说没装", 不能是 500 —— 一个应用没装不该把别人的站点打挂。 - 可见性口径是第二份拷贝(
status=0+saleStatus=Y+auditStatus=1+ 分类按ancestors展开子树), 和商城自己的OpenMallProductController逐条对齐。刻意复制而不是去改那个控制器: 契约只到"取前 N 条",动开放接口是另一件事。两处要改一起改。 ⚠️getProduct(id)同一条口径要再判一次:按 id 取数时那三条是唯一能挡住"下架商品被猜地址读走"的东西 (queryById自己不判),适配器取完先验、不合格返回 null,控制器据此出 404。 - 链接一律由本应用拼,DTO 里没有任何 URL 字段:
CmsThemeProperties的shopUrl()/shopUrl(categoryId, keyword)/productUrl(id)(指向商城直出的详情页)/mallCheckoutUrl(id)/mallCouponUrl()。后两条落点是后台会员中心(cms.consoleUrl,另一个 origin), 没配就是null,模板改印「暂未开放购买 / 暂未开放领取」;MALL_BASE = "/mall"只剩 活动商品详情(mallActivityDetailUrl)还在用 —— 商城 SPA 和 CMS 同域,移动挂载点要改代码。 - 卡片上没有「加入购物车」:商城购物车是 SPA 的 localStorage(键
wujies-shop:mall:cart), 后端没有 HTTP 购物车端点,服务端渲染的页面根本加不进去。两个按钮分别是 「查看详情」/site/product/{id}(商城直出的详情页)和「立即购买」{consoleUrl}/member/checkout/{id}?quantity=1(出站到后台会员中心,且要登录,见下面那条)。 - ⚠️
shop已加进CmsThemeProperties.RESERVED_PAGE_SLUGS:/site/{slug}那条独立页面别名路由 直接占根一级,不保留就会让运营建一篇别名shop的页面把商城页挡掉。 - 首页那一栏要商城里有推荐商品才出得来:
listRecommended按mall_product.recommend_flag = '1'取数(这列是0否 /1是,不是 Y/N —— 同表的sale_status才是 Y/N,抄错口径不报错, 只会让推荐位永远空的,实测踩过)。线上那两个在售商品的推荐位都是0,所以/site/现在 看不到这一栏,/site/shop照常出全部在售商品。要看到首页栏,去后台「商城 → 商品」把某个商品设为推荐。 - 商品详情页的归属改过两次,以现状为准:先由 wujies-web 的 SPA 出 → 2026-10-30 改由本主题直出 (
product.html)→ 后来六个商城前台页一起搬回商城应用,现在由MallSiteController直出/site/shop、/site/product/{id}、/site/activity、/site/coupon、/site/store/{id}、/site/shop/home。 定案的口径没变:前台的页面都归站点(同域名、同 origin),商城 SPA 只管下单与交易; 「立即购买」{consoleUrl}/member/checkout/{id}仍然出站,下单、购物车、优惠券都在 SPA 那边, 这一页只负责"看"。三页(确认订单 / 收银台 / 支付结果)在后台会员中心,走登录守卫 (未登录先跳登录,带redirect);cms.consoleUrl没配时没有回退,卡片上改印「暂未开放购买」—— 回退到/mall/checkout/…只会把部署问题盖成 404。 - 历史弯路:详情页走 wujies-web 的 SPA 链接(
/mall/product/{id})不通。为了让匿名访客点得通, 曾给它的src/permission.ts加了whitePrefixList前缀放行并实测通过,但那条链在后台那个 origin 上 打不开::80是 wujies-admin 的 vite,只代理/dev-api与/site,/mall/**落回 admin 自己的index.html⇒ 后台的 404 页;而/mall加不进那份代理,因为本站base='/',产物里是/src/main.ts、/@vite/client这种根绝对路径,会和后台的 vite 撞车。所以结论是前台的页面都归站点,卡片不再依赖 wujies-web 是否装了、是否放行了。 - 改 SDK 要不要重启宿主?取决于宿主怎么起来的(2026-10-30 实测校准,别再一律按"必须重启"处理): IDEA 直接跑
WujiesApplication时,classpath 是各模块的target/classes展开目录 (看java.exe … @C:\Users\…\idea_arg_fileNNN里那一行,wujies-common-plugin-sdk\target\classes就在上面), 所以 SDK 里新增的类只要mvn -o compile落进那个目录,运行中的宿主第一次用到就能加载,不用重启。 要重启的是两种情况:改已加载类的签名或字段(JVM 不会重读),以及宿主是打包起来跑的 (fat jar 里的 SDK 构建期就定型了)。判据:Get-CimInstance Win32_Process取那条命令行指向的@…\idea_arg_fileNNN,看里面有没有wujies-common-plugin-sdk\target\classes。 ⚠️ 用javac手工往target/classes落类时必须带-parameters:Spring 靠参数名绑@RequestParam Long category,缺了就报Name for argument of type [java.lang.Long] not specified(实测踩过;Maven 构建自带这个 flag,只有手工编译会漏)。 - ⚠️ 插件仓编译认的是
~/.m2里那份 SDK jar,不是target/classes:dev-console 的「编译并热加载后端」 跑标准mvn compile,解析到cn.wujies:wujies-common-plugin-sdk:5.6.2这个已安装产物。所以 SDK 里新增 一个契约类,运行中的宿主能立刻用到(上一条),插件仓却会报「找不到符号 类 MallCatalogApi」 —— 两个现象同源,别误判成代码错。正解是停掉宿主后mvn -o install -pl wujies-platform/wujies-common/wujies-common-plugin-sdk(宿主跑着不许 install)。本机现在靠jar uf往~/.m2里那个 jar 追加 class 顶着用, 属临时补丁:任何一次真正的 install 都会把它冲掉(target/里那份 jar 至今还是新增前的 18 个类)。
给 gallery / 企业查询 / 询价 / 考试加页面时照这个范式复制:SDK 里加 …Api + 视图 DTO,
提供方插件里加 adapter,CMS 侧加一个 CmsFinder。不要在 CMS 的 pom 里引对方应用任何 jar。
评论区:组件在 wujies-ui,产物随主题一起发(Halo 的做法)
post.html 正文下面那一块不是主题里的片段,是一个 Vue 组件。但前台这一页没有 Vue、没有
Import Map、也没有 Element Plus,所以照 Halo 那套「主题只出一个挂载点,控件自带产物」分三层:
| 层 | 在哪 | 管什么 |
|---|---|---|
| 组件 | wujies-ui/packages/components/src/components/KCommentSection.vue | 版式与交互。只认 CommentApi 适配器(list/submit/like),不认识任何 URL |
| 前台产物 | 同包 src/widget/comment-widget.ts + vite.widget.config.mts | 把模板印的 data-cms-* 翻译成适配器;自带 Vue 运行时,一份自包含 IIFE |
| 挂载点 | templates/cms/default/post.html 里 section.comments[data-cms-comments] | 只印地址,别的一律不管 |
# 改过 KCommentSection.vue 或 comment-widget.ts 就必须重跑这一条(它故意不在 build / prepublishOnly 里)
cd ../wujies-ui/packages/components && pnpm run build:widget
# 产出直接落进本仓库(vite.widget.config.mts 的 outDir 就是这里),不需要 dist、也不发 npm:
# src/main/resources/themes/default/comment-widget.js (含 Vue 运行时;2026-11-01 重跑后是 88,185 字节,
# 仓库里现在这份是 91,366 字节。
# 更早的记录量的是约 77 KB、gzip 30 KB,别拿那个数对账)
# src/main/resources/themes/default/comment-widget.css
# 之后照常规范式打包/热加载本插件(见「连宿主验」)这两份产物由既有的 CmsThemeAssetController 发(/site/themes/default/comment-widget.js,
扩展名白名单已有 js/css)—— 挂进主题目录就不必再开一个资源端点,而且与页面同源:
Admin-Token 那条 Authorization: Bearer 直接打得出去,没有 CORS。
模板要印的那六个属性
comment-base→ 社交应用的/site/comment(GET /tree、GET /replies、POST、POST /like,见wujies-social-plugin的SocialSiteCommentController);author-api→ 会员应用的/site/member/profiles?userIds=1,2,3(昵称 + 等级 + 勋章,见MemberSiteController);评论行里只有userId,头衔必须问会员那边;account-url→ 本页已有的GET /site/account:登录时并行问一次身份(不挡评论首屏), 问出来之前编辑器那一格留空,问出来才印上我自己的昵称与头像;没带凭据则当场就是 「登录后可发表评论」那一行;widget-css→ 样式由脚本自己插进 ``(少这一条就出一块没样式的评论区)。
后两条路径不在模板里写死:它们属于别的应用,CMS 只在 CmsThemeProperties 里留一份
同名常量(与 productUrl / galleryUrl 一个口径 —— 共用的是 URL 这条约定,不是代码)。
属性印漏时脚本不挂载,页面仍是完整的文章页 —— 与主题其余交互「没有脚本也还是一页」同一条底线。
树的形状是服务端说了算的一条约定:GET /tree 只回两层,回复的回复一律摊平到
它所在那一栋的 children 里(按 createTime 升序)。组件只渲染两层,多出第三级会挂在
屏幕看不见的地方,而评论数照样把它算进去;「回复 @谁」那一句靠 replyToUserId 在同一栋里找人。
同一栋默认只带前 2 条回复(SocialSiteCommentService.REPLY_PREVIEW),剩下的走
GET /replies?targetType=&targetId=&rootId=:首屏不必把整篇的回复与作者全拉出来,
但一栋有回复就仍然看得见样子(有回复的栋自然出 2 条,没出的一条不拉 —— 不做"随机出几条",
同一篇文章刷两次版式会跳)。tree 里那一栋的 replyCount 回的是这一次真查出来的回复数
而不是 reply_count 那一列:那一列只在发评论时自增,后台删过回复就再也对不上,
前台「展开其他 N 条回复」会报一个不存在的数。2 这个数字与组件的 replyPreview prop 是同一把尺子,
改一侧要改另一侧。
--k-cw-* 那一组配色变量写在 theme.css 的 .comments 上(组件内部把它接成自己的 --cw-*):
变量必须设在组件外层,同名写到组件根节点会被它自己那条声明盖住。版式(行距、圆角、头像尺寸)
留在组件里,换主题只改配色。
验收口径(2026-11-01,本地 mock 服务器起 4 个接口跑的):匿名进 → 整块评论可读、输入框换成
「登录后可发表评论」、回复按钮不出现;带 token 进 → 编辑器出昵称头像、回复落到对应楼中并即时
带上自己的等级与勋章、点赞先加一再用服务端计数覆盖;会员查不到的那位画成「匿名 + 没头衔」而不是
整条丢掉;勋章图挂不上就退回名字前两三个字(与后台勋章墙 showBadgeImage 同一把尺子)。
同一份 mock 上还量过:加载中出三行骨架(头像 + 昵称 + 两行正文,aria-busy="true",
prefers-reduced-motion 下不抖),楼中楼那格回复框是纵向的(输入框占满宽度,
「取消 / 发布回复」在下一行右侧、彼此留 10px),点赞那颗是 24×24 描线图(14×14 显示)。
2026-11-01 第二批(同一份 mock,改成"每栋只给前 2 条 + 一个 /replies"的形状)量到:
一栋 5 条回复时收起状态出 2 条与「展开其他 3 条回复」,点开变 5 条 + 「收起」,
收起再展开不再发第二次请求(判断"要不要问"看的是已拿到几条,不是当前画了几条,
写成后者会把同一批回复再问一遍);只有一条回复的那栋不出按钮;头部「评论 10」在展开收起时不动。
楼号按发帖顺序定(4/3/2/1,最新在前),切到「最热」只换行的次序、楼号跟着人走。
表情面板 105 枚分 4 组,搜「狗头」只命中狗头那一枚,点一枚插进光标处(选中两段字会被它换掉,
成对码点按 UTF-16 偏移量落光标:在「这张」与「图不错」之间插那一枚,实测 selectionStart=4),
选完不关面板、点面板外或再点笑脸才关,「最近使用」记在 localStorage 的
wujies-comment-recent-emoji(最多 12 枚,隐私模式读写都包了 try/catch)。
等级与勋章那两枚小牌改成白底 + 一条描边:楼中楼整格铺 --cw-fill,
牌原来铺同一档灰,落在一起就只剩字(实测牌面 rgb(255,255,255) 对格子 rgb(246,246,247),描边 1px)。
联机侧(2026-11-01,http://127.0.0.1/site/p/hello-cms,文章 id 9130)已验到:三个新控制器都返回 200,
六个属性齐全印出,comment-widget.js|css 同源取到并挂载成功。
服务端耗时(本机 → 远程库那台测试机,热连接,curl -w %{time_total}):
GET /site/comment/tree 45–50 ms(换一个没评论的 target 是 53–67 ms,也就是 SQL 只占约 20 ms,
其余是框架与鉴权的固定开销);GET /site/member/profiles?userIds=1 160–265 ms,
串 8 个 id 是 341 ms;GET /site/account 5–7 ms(早先记的「约 210 ms」是冷连接那一次,作废)。
profiles 慢在一次请求串了 6 趟远程库(用户 / 会员行 / 等级 / 勋章授权 / 勋章 / 头像 oss),
每趟约 30–45 ms —— 树改成只带前 2 条回复以后,这一问要查的作者数从"整篇"降到"首屏那几张面孔",
但趟数本身还没减。
2026-11-01 已把 6 趟减到 4 趟(改在会员插件,两条 join SQL 各吃掉一趟):
MemberMapper.selectMembersWithLevelByUserIds(会员行 join 等级,del_flag 写在 ON 里,
所以 level_id 为空或等级被软删时会员行仍然回来 —— 前台画成一个没有头衔的名字);
MemberBadgeGrantMapper.selectGrantedBadgesByMemberIds(发放记录 join 勋章定义,
INNER JOIN + 定义侧 del_flag = '0',与改造前"查不到定义就跳过这枚"同一个结果,
排序仍是 grant_time desc, id desc,每人去重留在 Java 里)。
sys_user 与 sys_oss 那两趟没动(跨模块,靠宿主的 SDK 能力)。
本机 JDBC 只读核对(同一把尺子跑新旧两组 SQL):新 SQL 在线上 schema 解析通过、
会员+等级两边结果逐字段一致(库里 1 位会员、7 个等级、3 枚勋章定义、0 条发放记录,
所以勋章那条只验到"解析与列名对",返回空集),单趟耗时 23–26 ms,预计这一问省约 50 ms。
接口侧的实测还没做 —— 这改的是 Java,本机 8086 上要 POST /app/dev/reload 加载会员插件才生效;
生效前测到的仍是旧口径(2026-11-01 重载前复测:?userIds=1 170–295 ms,
串 8 个 id 444 ms)。复验口径:
curl -s -o /dev/null -w '%{time_total}\n' 'http://127.0.0.1:8086/site/member/profiles?userIds=1',
再用同一批 8 个 id 跑一次与上面那两个数对比。
评论树两层摊平那条已在联机生效:9130 现回顶层 1 条、楼中楼 3 条(回复的回复与它回复的那条
同级,靠 replyToUserId 说明接的是哪一条),页面标题「评论4」。
「每栋只带前 2 条 + /replies」这一条改的是 Java,本机 8086 上还没生效:生效前旧服务会把
3 条回复一次全给,组件按"已经拿到手"判断,那颗按钮最多说一句「展开其他 1 条回复」而点开只是把
已在手的那条画出来,不会报错也不会多发请求。
两处留意:改过 KCommentSection.vue / comment-widget.ts 要重跑 build:widget 并把产物 cp 进
本插件的 target/classes/themes/default/(静态资源与模板现读 classes,不用热加载);
Java 侧改动仍要插件被热加载(POST /app/dev/reload),而本机 8086 宿主跑的是 prod profile、
写的就是线上库,重载由维护者手动执行。
写主题时必须守住的五条
- 判空写
X != null and X != '',不要写#strings.isNotEmpty(X): 模板走 SpEL,SpEL 按参数类型找方法,isNotEmpty(null)报EL1004E: Method isNotEmpty(null) cannot be found,整页 500。 封面这种常为空的字段用post.hasCover()(零参数,没有这个问题)。 th:utext只准出现在正文那三处(post.html、page.html的article__body,加product.html的商品详情)。前两处输出的是入库前已由HtmlSanitizer消毒的 HTML —— 闸门在保存链路 (CmsPostServiceImpl/CmsPageServiceImpl),模板不做过滤;/cms/post/**与/cms/page/**在宿主xss.excludeUrls里,排除即没有兜底。第三处反过来:mall_product.detail由商城后台写, 本应用管不到它的保存链路,所以闸门在读取侧(CmsMallProduct里过一次HtmlSanitizer.clean)。- 片段引用只准用主题目录内的相对名(
~{modules/head :: head}),不准写成default/modules/head: 每个主题一套引擎、解析前缀就是它的目录,所以整份拷贝templates/cms/<新编码>/+themes/<新编码>/再改cms.themeCode就能换主题。前缀一旦收到templates/cms/这一层, 主题就得在自己的模板里写自己的编码,"主题 = 一个自包含目录"当场破掉(踩过,实测TemplateInputException)。 - 动效只用
theme.css里那两个令牌:--dur: .3s与--motion: cubic-bezier(.7,.3,.1,1)。 这条曲线是 2026-10-30 从参考站(Converse 商品目录的「收起筛选」抽屉)实测getComputedStyle抄来的, 通知条轮播、点击展开搜索、收起筛选三处共用 —— 别再各自写一遍ease,四处不同步的动效比没有动效更显眼。 - 应用自己那一屏的样式不在这个仓库里:
modules/head.html那条th:each="${appStyles}"是唯一的口子 (排在theme.css之后,所以应用样式盖得动基元)。链接清单由应用的控制器作为页面变量塞进来, 文件与端点都在应用插件里 —— 图床是第一个这么做的(wujies-gallery-plugin的site-styles/gallery/gallery.css+GallerySiteAssetController+GallerySiteRender)。 为什么端点必须跟着插件走:插件各自的类加载器,本仓库的CmsThemeAssetController显式按自己的加载器取资源,读不到兄弟插件的产物(模板能跨过去是因为 渲染时应用把加载器交了过来,静态资源是一次独立请求,没有那次交接)。 搬的边界(2026-11-01 用 Node 扫六个应用的*.html,按"几个模板在渲染这一族"定,不看类名前缀):shop__list五个应用、filter__chip五个、pager四个、row-list/row-facts三个 —— 这些留在本仓库; 只有一个使用者的整族跟着插件走:.facts→图床、.apply→报价、.toolbar/.entrance*/.entry*/.store*/.pdp*/.campaign/.coupons/.shop__price*→商城、.wall/.gcard/.shot/.upload/.lightbox→图床。搬过去的规则只准用主题的 CSS 变量, 否则阶段 B 换主题就是"骨架换了肤、那一屏还是旧配色"。 两个反直觉的判例:.acard(活动卡)与.ccard(券卡)看着像商城的,其实templates/cms/default/modules/activity-card.html与coupon-card.html也在渲染它们(往文章里插一张卡), 所以留在本仓库;.pcard同理。反过来,.shop__price前缀像共享目录列的一部分,但只有商城的目录页在用,所以搬走;连那六条 "在商城作用域里覆盖共享基元"的规则一起走(.toolbar .search、.btn.is-off、.pdp__detail .section__title等)—— 它们靠 `排在theme.css之后才盖得住。 共享件的**变体**不搬:.filter--tight跟着.filter留下,.btn--off、.min-wrap跟着各自基元留下。 合写的选择器拆开算各自的:.shopgroup > .shoplist(四个应用)留下,同一块的.shopgroup > .shopprice(只有商城)跟.shop__price一族走。 2026-11-01 商城是第二个这么做的(wujies-mall-plugin的site-styles/mall/mall.css+MallSiteAssetController+MallSiteRender,theme.css 从 3576 行降到 2685 行); 报价的.apply那一族 172 行已经写进wujies-quote-plugin的site-styles/quote/quote.css并接好端点 (QuoteSiteAssetController),等报价插件热加载一次、/site/apps/quote/quote.css真能出text/css, 再把本仓库这一段删掉 —— 少 172 行到 2513(按 2685 行那版算;此后页面长回 4116 行,删后约 3944)。 现状是**还没删**:grep -c '\.apply'= 24 处。 **:root那套令牌不跟着搬,也不准在应用样式里重抄一份**:编辑器看不见兄弟插件的 jar,会在应用 CSS 的var(--ink)下面提示"未知自定义属性",那是 IDE 的限制不是运行时没生效(自定义属性全局作用域, 而且head.html无条件把theme.css排在前面)—— 2026-11-01 用getComputedStyle在/site/gallery实测取到#111 / #2e2e30 / #e5e5e5 / .3s`,别为了消掉编辑器黄灯把数值抄第二份。
上线前提与登录回跳
上线时的一条前提:/site/** 必须挂在域名根上
模板里的链接全部是根相对路径(/site/、/site/p/、/site/themes/default/theme.css,
由 CmsThemeProperties 的 PUBLIC_BASE = "/site" 拼出),没有可配的路径前缀。
所以反向代理必须把 site 整段映射到后端 origin 的根;
若沿用管理端那种带前缀的地址(VITE_APP_BASE_API = https://api.wujies.cn/v1/prod),
/v1/prod 会被根相对链接吃掉,页面能出但 CSS 与内链全 404。
后台改配置、文章列表、主题样式在 8086 直连下均已实测通过(见「连宿主验」),
网关那一段的重写规则本机没有副本,尚未验证。
前台 → 后台的登录回跳(?redirect=)
主题里「登录 / 个人中心 / 立即登录」三个链接都带 ?redirect=,值是当前这一页的绝对地址:
优先 cms.siteUrl 拼出来的 canonical,没配站点域名时回落请求行 URL(CmsPublicController#returnTo)。
后台 ?redirect= 这个参数名不是新造的,src/permission.ts 未登录拦截时本来就在写它。
- 绝对地址只能交给浏览器整条换页:
router.push('http://…/site/')得到的是空白路由。wujies-admin/src/utils/loginRedirect.ts负责分辨"本站路由"还是"前台绝对地址",后者走window.location.replace。 - ⚠️ 主机必须比,否则这是一枚开放重定向(任何人把用户从登录页拐去假后台都能成立)。 但比的是 hostname 而不是 origin:开发态后台在
:80、后端在:8086,端口天生不同; 并且回环地址的三个名字(localhost/127.0.0.1/::1)按同一台机器看待 —— 本机cms.consoleUrl = http://127.0.0.1,而前台页面上的redirect是http://localhost:8086/site/, 严格比 hostname 会把这条合法回跳判掉。只放开环,localhost.evil.com仍然挡。
前台认出后台的登录态:site.js 干的事
令牌只在 localStorage 的 Admin-Token 里(is-read-cookie: false,服务端不发 Set-Cookie),
SSR 拿不到登录态 —— 服务端既不知道你是谁,也不该猜。页面先按未登录印完,
themes/default/site.js 再在客户端补状态。最初的四件事(都不影响服务端印出来的那份 HTML):
| 做什么 | 靠什么 | 守什么 |
|---|---|---|
| 通知条轮播 | data-cms-notice 上每 5 秒换一条 | 只有一条 / 标签页在后台 / 系统开了「减少动态效果」 ⇒ 不装定时器 |
| 点击展开搜索 | 导航条那个图标切 is-open | 展开即聚焦输入框;点外面或 Esc 收起;aria-expanded 同步 |
| 收起筛选 | 目录页那个按钮切状态 | ≥992px 收侧栏(.shop.is-filters-off),<992px 改底部抽屉 + 遮罩 |
| 账号区 | 读 Admin-Token → GET /site/account | 见下面两段 |
之后陆续加的几件(同一份 site.js,都只是增强):wireGallery() 商品图集悬停换主图、
wireLightbox() 把 [data-cms-lightbox] 的点击变成一次 wujies:lightbox 事件(没人接就用
themes/default/lightbox.js 兜底)、wireArticleImages() 给正文裸 <img> 包上「看原图」、
wireDownload() 的「下载原图」压 1.5 秒防连点、wireSku() 规格切换与「立即购买」参数、
wireCountdowns() 活动与领券倒计时、wireInteractions() 文章页与图片页的互动条
(数据向社交应用 /site/interaction 问)、wireUserPage() 与 wireRelationsPage() 的用户主页 /
关系页 tab 与名单。没有脚本时这些位置都还是完整的(公告停在第一条、筛选摊开、详情第一张即主图、
互动条数位为空),页面不靠脚本才成立。
前三件不碰身份,所以在登录判断之前就装好;账号区才需要凭据。
跨端口那一半交给标记 cookie wujies-site-state(由后台 setToken / removeToken 写与清):
cookie 的作用域不含端口,所以本机「后台 :80 + 前台 :8086 直连」也能认出登录态。
代价是这一侧只剩一个布尔值、换不到身份 —— 没有 token 就问不出昵称,此时印「我的账号」
且把退出按钮从 DOM 里删掉(留一个按了没反应的按钮更糟)。给 ` 加 is-logged-in` 之后,
theme.css 据此 [data-cms-guest]{display:none} / [data-cms-user] 反向显示
(写 display: initial 会把 .member__cta 自己的 inline-block 抹掉,所以显式写了行内级)。
取身份走 GET /site/account(CmsAccountController)。这条路径 @SaIgnore 且不在 Sa-Token 的
登录校验清单里,所以公开页不需要后台那份 clientid 头 —— 那是构建期注入管理端的常量,
公开页拿不到,也不该拿到。响应 data: null 是四种情况的同一个画法(没带 token / 已过期 /
账号已删 / 宿主没提供 PlatformUserApi),前台一律留「我的账号」,不猜是谁。
> ⚠️ 控制器里必须先 LoginHelper.isLogin() 再看 getUserId():后者只解 JWT 载荷,
> 会话已注销的旧 token 照样读得出 loginId。不挡就等于把昵称与头像交给一枚作废的字符串,
> 直到它自然过期为止。2026-10-30 实测收口:带旧 token 时 /system/user/getInfo 已 401,
> 本接口当时还返回身份;现在 /site/account/logout 之后拿同一枚 token 再问,回 data: null。
> 昵称只能进 textContent(innerHTML 等于把存储型 XSS 请进头部)。
前提是前台页与后台同源(localStorage 按 origin 隔离),这只影响"能不能换到身份",不影响"认不认得出登录过":
- 生产:同域 + 路径前缀(见 wujies-web 拆分定案),
https://域名/site/与https://域名/login同一个 origin ⇒ 正常。 - 本机:只能走 vite 的
/site代理(wujies-admin/vite.config.ts里把/site转到http://127.0.0.1:8086), 在http://localhost/site/上打开才有 token 可用;直接开http://localhost:8086/site/是另一个 origin, 读不到Admin-Token,账号区只剩标记 cookie 给的那个布尔值(有「我的账号」,没有昵称,也没有退出按钮)。 这不是 bug,是 origin 隔离。
开发环境
git clone git@gitee.com:wujies/wujies-cms-plugin.git
cd wujies-cms-plugin打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用
node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、
生成密钥,不需要回到单体仓库,也不需要手工传产物路径。
后端:父 pom 是 cn.wujies.plugins:wujies-plugins-parent:1.0.0 且 `` 已置空,
平台依赖(wujies-common-*,5.6.2)也全 provided —— 都要在 ~/.m2 里才编得动
(陌生人 clone 后会卡在找不到父 pom,见「常见问题」)。
前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client /
ui-plugin-bundler-kit,frontend/package.json 里是 ^5.6.5)。frontend/vite.config.ts
只声明 defineRemoteApp({ appCode: 'cms', root }),共享依赖一律 external、运行期由宿主
import map 兜到同一份实例;本仓库前端可独立构建。要直接落位到宿主,构建前设
WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。
本机验收前台一律开 http://localhost/site/(wujies-admin 的 vite 有 /site 代理 → http://127.0.0.1:8086),
别用 http://localhost:8086/site/ 直连:两者不同 origin,前者才和后台共享 Admin-Token(见上一节)。
不启动宿主也能验模板(推荐先跑这个)
Thymeleaf + SpEL 的表达式错误只有在渲染时才会暴露,而线上一次渲染要连"装插件 + 建表"两步副作用。
所以先用一个离线渲染自检:把模板与片段在真正的 SpringTemplateEngine 下渲染成静态 HTML
(现在跑的是 index × 2(有商品 / 空)+ shop × 2(有商城 / 没装)+ product × 3(图集+可分组规格 /
只有规格名 / 三样全空)= 七份产出,商品数据是假的 MallProductView / MallProductDetailView 喂进去的)。
mvn -o -B -q dependency:build-classpath -Dmdep.outputFile=target/cp.txt
# 用 CmsRenderCheck(临时脚手架,不放进仓库)渲染 index / shop / list / post / page / error / 空数据 几份产出
javac -encoding UTF-8 -cp "target/classes;$(cat target/cp.txt)" -d /classes /CmsRenderCheck.java
java -cp "/classes;target/classes;$(cat target/cp.txt)" CmsRenderCheck⚠️ 断言里比对 URL 时记得 & 在产出里是 &(Thymeleaf 转义属性值):
按 ?category=1&q=x 原文断言会假失败,第一次跑就撞上过。
它会打印每页字符数,并对产出里残留的 th: 告警;顺带断言配置的三条语义
(缺行用默认值、空串按空串、非法主题编码回落 default)、链接拼接结果,导航的两侧
(一项带二级 + 一项 target="_blank" 时,index.html 里要有 nav__drop、target="_blank"
和拼好的二级链接),以及目录的两侧:
有标题时 post.html 里 aside.toc 与正文锚点成对出现,无标题时整个侧栏不渲染。
它同时断言分支互斥与读取侧那道消毒闸门:needle 前加 NO: 表示"这个必须不出现" ——
详情页有属性名可分组时 NO:pdp__skus"(两套规格表印在同一页上最难看),正文里
NO:alert( / NO:onerror= / NO:javascript:(商城富文本原文带着这三种,消毒后必须都没了)。
⚠️ 这里**不能用 NO:,
断言写粗了会永远红。"只能有一个"这种语义 substring 判不出来(每条都印上 --on 也能命中断言),
用计数:aria-pressed="true" × 1(缩略图只有一个选中态)、pdp__sku-was × 1(原价等于售价的那条规格不画线)。
⚠️ 跑它要在 -cp 里补 ~/.m2/.../jsoup-1.18.3.jar —— 正文目录(CmsToc)解析 HTML 用的就是它,
宿主那边由 wujies-common-core 带(compile 作用域),插件只声明 provided,不进 target/cp.txt。
渲染结果可以直接用浏览器打开看版式(内置浏览器不吃 file://,用一个本地静态服务器喂,
CSS 会一并复制到 /site/themes/default/ 这个挂载点上)。
连宿主验
- 宿主以
app-market.plugin-runtime.dev-mode: true启动,本仓库在项目根plugins/下会被自动扫描。 ⚠️ 本机 8086 宿主跑的是profile=prod,写的就是线上库:装应用会建cms_*表(含 06 的cms_menu/cms_menu_item)、同步sys_menu、往sys_config插cms.*那批行。 mvn -o compile后POST /app/dev/reload {"appCode":"cms"},看componentCount/endpointCount/mapperCount都 > 0。- 开发台「本地安装」建表 + 同步菜单 + 落配置。
curl -i http://localhost:8086/site/p/hello-cms—— 期望 200 + 整页 HTML(种子数据里有这篇)。 这一步同时证明「引擎能从插件产物里解析模板」和「@SaIgnore在插件路由上生效」。curl http://localhost:8086/open/cms/config(匿名)能看到那批配置;在后台改cms.heroTitle后刷新/site/应当立刻变。这条是"配置真的通"的判据——application.yml路线上这两种做法都没有任何症状。 (2026-10-30 已实测:后台「内容中心 → 配置」改cms.icp保存,/site/页脚立刻多出一行; 清空再保存,那一行跟着消失 —— 空串是合法值,不会被@NotBlank拦。)- 反复 reload 5 次数
PluginClassLoader实例数,确认没有一代一泄漏(stop()会丢弃整批主题引擎)。 - 菜单:
curl -s http://localhost:8086/site/ | grep -o 'nav__drop'要有输出(种子那条main菜单 的二级渲染出来了),后台「内容中心 → 菜单」里把某项拖到另一项下面,刷新/site/应当跟着变 —— 拖拽落点走的是PUT /cms/menu/{id}/tree,返回 500「提交的菜单树少了 N 项」就是前端少送了节点。 (2026-10-30 已实测:把「技术手记」拖到「产品动态」下面,前台立刻出现nav__drop;重进页面层级仍在。) - 商城契约(2026-10-30 已实测,没停宿主)。步骤:
mvn -o -B compile -pl wujies-common/wujies-common-plugin-sdk(在wujies-platform/下跑,只 compile 不 install) → 两个插件各mvn -o compile(当前不行:~/.m2里那份 SDK jar 还是 18 个类、没有MallCatalogApi, 要先把宿主停掉mvn -o install -pl wujies-common/wujies-common-plugin-sdk才能用 Maven 编; 本轮为了不动宿主,改用javac -parameters -d target/classes手工落进插件的target/classes, classpath 用mvn -o dependency:build-classpath -Dmdep.outputFile=target/cp.txt生成、 再把 SDK 的target/classes排在最前)→ 模板与 CSS 是资源,javac不会复制, 要手工cp src/main/resources/templates/... target/classes/templates/...(漏了就是页面能出但没样式/找不到模板)。 cms 是「监听中」的,改完约 20 秒自动生效;mall 没在监听,得在开发台 「开发工具 → 插件开发」那一行点「更多 → 热加载」,对话框里 appCode(mall)与产物路径 (wujies-mall-plugin/target/*.jar)都预填好了,点「热加载」只重建子上下文、不碰数据库。 ⚠️ 商城必须热加载一次:磁盘上装着的旧副本里没有getProduct的实现,光重启宿主拿到的还是旧 jar, 接口一调就AbstractMethodError。POST /app/dev/reload {"appCode":"mall"}这个接口签名后来改过, 旧 jar 里的实现不认,走开发台那条路更稳。
curl -s http://localhost:8086/site/shop | grep -c 'class="pcard"' # 实测 2(线上在售商品就 2 个)
curl -s http://localhost:8086/site/shop | grep -c 'filter__chip' # 实测 11 个分类,未选分类时不出「全部」
curl -s 'http://localhost:8086/site/shop?category=2055188086818668545' \
| grep -o 'filter__chip--on[^>]*>[^<]*' # 实测只有 T恤 亮,且多出「全部」
curl -s 'http://localhost:8086/site/shop?q=JEEP' | grep -o 'band__sub">[^<]*' # 实测 1 个在售商品
curl -s 'http://localhost:8086/site/shop?q=JEEP' | grep -o 'name="robots"[^>]*' # noindex, follow
curl -s http://localhost:8086/site/ | grep -c 'class="pcard"' # 实测 0:推荐位没商品,整节不渲染(上面那几条当时验的是 CMS 直出的商城页;页面现在改由商城应用直出,断言与 URL 不变,仍可照打。)
浏览器实测 /site/shop 版式正常(分类条 + 搜索框 + 两列商品卡,价格/划线价/销量/商家/两个按钮都对齐在卡底);
两张卡的封面图 403 —— 那两个商品的 galleryUrls 指向 https://oss.wujies.cn/image/2026-05-*/….jpg,
带不带 Referer 都是 403,商城 C 端同样取不到,属于商品数据/对象存储权限的既有问题,与本页无关。
日志那行是 [cms] 商城页渲染完成 主题=default 商城=true 分类=null 关键词= 商品=2 耗时=525ms
—— 商品=0 而 商城=true 是"装了但库里没有在售商品",和 商城=false(没装)是两种症状,别看错。
⚠️ 顺带测出商城开放接口的一个既有故障(本轮没改):/open/mall/product/list?pageSize=2
序列化第 2 行时抛 JsonMappingException: Can not write a string, expecting field name
(引用链 MallProductVo["merchant"] -> MallMerchantVo["merchantLogoUrl"]),pageSize=1 正常;
这条契约只取 merchantName 字符串,所以没受影响。
仓库布局
| 位置 | 内容 |
|---|---|
| pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,`` 已置空) |
| app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) |
| src/ | Java 源码(74 个文件) |
| migrations/ | 15 个建表/种子/配置脚本(按文件名排序执行,执行过不许改内容) |
| src/main/resources/templates/cms/<主题编码>/、themes/<主题编码>/ | 公开页直出的模板(15 个文件)与主题样式、脚本(见「公开页」) |
| frontend/ | 远程应用源码(src/ 27 个文件),入口 frontend/src/index.ts |
src/main/java/cn/wujies/cms/
controller/CmsPublicController.java 公开页(返回整页 HTML,不是 JSON)
controller/CmsPublicPostApiController.java /site/post/summary(JSON,一次最多 100 篇)
controller/CmsAccountController.java /site/account 与 /site/account/logout
controller/CmsSiteMediaController.java /site/media/remote 同源媒体代理(SSRF 闸门写死)
controller/CmsThemeAssetController.java 主题静态资源端点 /site/themes/**
controller/Cms{Post,Page,Category,Tag,Menu,Overview}Controller.java 后台 CRUD(/cms/**)
portal/PortalCms{Post,Term}Controller.java C 端「我的文章」与分类/标签下拉
theme/CmsThemeEngines.java 一个主题一套 SpringTemplateEngine(按需建,卸载时整批丢弃)
theme/CmsThemeConfigReader.java 从 sys_config 读 cms.* 站点配置
theme/CmsThemeProperties.java 一次请求的配置快照(主题编码、文案、链接拼接)
theme/CmsSiteRenderer.java 渲染入口(自己 process(),不依赖宿主 ViewResolver)
theme/CmsSitePageFinder.java 向兄弟插件问前台页清单(source_type = plugin)
theme/CmsNavItem.java 导航项(链接在 Java 侧拼好,模板只管遍历)
theme/CmsMallFilter.java 商城列表页的分类筛选条(URL 与 active 都在 Java 算)
theme/CmsMallFinder.java 本应用唯一的跨应用取数入口:反查商城的 MallCatalogApi
theme/CmsToc.java 正文目录:渲染时给 h1–h4 补锚点并抽出目录行
service/CmsMenuServiceImpl.java 菜单:把 cms_menu_item 的引用解析成链接 + 组树 + 整树保存校验
service/… 公开页只读取数(已发布 + 未删除 + 公开可见)
src/main/resources/
templates/cms/<主题编码>/**.html 模板(在产物里,不会被静态目录吐出去)
themes/<主题编码>/theme.css 主题样式(由上面的资源端点发,当前实测 4116 行)
themes/<主题编码>/site.js 前台客户端脚本(见「前台认出后台的登录态」)
themes/<主题编码>/toc.js 目录高亮(只有观感;禁 JS 时目录仍可点)
themes/<主题编码>/lightbox.js 看原图浮层的兜底实现
themes/<主题编码>/qrcode.js 二维码(分享用)
themes/<主题编码>/beian.png 页脚公网安备那行的小图标
themes/<主题编码>/comment-widget.{js,css} 评论区组件产物,由 wujies-ui 的 `pnpm run build:widget`
直接写进这里 —— 是生成物,别手改(见「评论区」一节)
mapper/cms/CmsPostMapper.xml 带分类/标签聚合的查询
migrations/ 建表 + 种子数据 + 站点配置 + 菜单(幂等,执行过不许改内容)
frontend/ 后台 Vue 远程应用(概览/文章/分类/标签/页面/菜单/配置)❓ 常见问题
Q:陌生人 clone 后 mvn compile 报找不到 wujies-plugins-parent?
父 pom、wujies-common-* 与兄弟插件构件目前只有本地 mvn install 出来的版本,还没发布到 Maven
仓库(后端构件发布那一阶段才补)。本机装过就能通。
Q:打包时提示「找不到插件目录」?
在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。
Q:后台改了配置,前台没变 / 改了 cms.themeCode 没反应?
先确认改的是 cms.* 行(application.yml 在插件里读不到,见「站点配置」);cms.themeCode 要
重新加载应用(主题引擎装载期定型),其余键刷新页面即可。
Q:配置页里打字保存报「操作失败」,或页面显示的是 Java 默认值?
updateByKey 只改已存在的行:键没被迁移脚本建出来时影响 0 行且不补插。升级一次(或手工跑
migrations/08|13|14)让行落库;保存只提交改动过的键,什么都不动地点保存是安全的。
Q:保存配置 500「默认值不能为空」?
老 5.6.2 宿主里 SysConfigBo 的 defaultValue / configValue 挂过 @NotBlank,而 cms.siteUrl /
cms.icp / cms.consoleUrl 的默认值按设计就是空串。平台 2026-10-29 已去掉这两条校验,
跑改过的宿主即可;空串是合法值(= 该项前台不渲染)。
Q:换了主题目录,模板报 TemplateInputException?
片段引用只能用主题目录内的相对名(~{modules/head :: head})。写成 default/modules/head
会把解析前缀收到 templates/cms/ 这一层,主题就不再自包含(五条第 3 条)。
Q:页面 500,日志 EL1004E: Method isNotEmpty(null) cannot be found?
模板判空写成了 #strings.isNotEmpty(X)。SpEL 按参数类型找方法,null 找不到;改用
X != null and X != '',封面用 post.hasCover()(五条第 1 条)。
Q:前台页面能开、CSS / 内链全 404?
/site/** 的链接是根相对路径,反向代理必须把 site 整段映射到后端 origin 的根;
带 /v1/prod 这类前缀的地址会把根相对链接吃掉(见「上线前提」)。
Q:/site/shop 打不开 / 显示没装商城?
那几页现在由商城应用直出(MallSiteController),要装 mall;CMS 侧的导航项也靠
CmsSitePageFinder 向它问清单,商城没装时整条摘掉。/site/apps//** 里的样式同理归各插件自己发。
Q:后台「配置」页保存按钮报没权限?
除了 cms:settings:list,还要有宿主的 system:config:list / system:config:edit(超管天然有),
因为取数与保存走的是宿主通用配置接口。
Q:手工 javac 落类后页面没样式、或接口报参数名找不到?
javac 不会复制资源(模板与 themes/ 要自己 cp 进 target/classes),并且必须带
-parameters(Spring 靠参数名绑 @RequestParam;Maven 构建自带这个 flag)。
Q:插件仓编译报「找不到符号 类 MallCatalogApi」?
插件仓解析的是 ~/.m2 里那份已安装的 SDK jar,不是 target/classes。停宿主后
mvn -o install -pl wujies-platform/wujies-common/wujies-common-plugin-sdk 即可;
宿主跑着的时候不许 install。
Q:本机 http://localhost:8086/site/ 认不出登录态?
那是另一个 origin(localStorage 按 origin 隔离),只能拿到标记 cookie 的布尔值。
本机一律开 http://localhost/site/ 走 vite 的 /site 代理,才和后台共享 Admin-Token。
Q:报价的 .apply 样式还在 CMS 的 theme.css 里?
是。wujies-quote-plugin 的 site-styles/quote/quote.css 与 QuoteSiteAssetController 已就位,
但 /site/apps/quote/quote.css 还没在本机热加载验证过,删早了前台就没样式(五条第 5 条);
那 172 行删完,按 2685 行那版是 2513 行,按现在 4116 行约 3944 行。
Q:为什么仓库里没有截图?
本仓库还没有 docs/screenshots/,所以 README 不放预览图;前台这几屏只能联机看,
入口是 http://localhost/site/(理由见「开发环境」)。
🛣️ 路线图与已知缺口
1.0.1 – 1.0.4 已经把旧 README 里这几条做完了:用户公开主页与关注/粉丝页 SSR(user.html /
relations.html)、文章详情作者块与版权声明(15)、标签页(/site/tag/{slug})、两份法律文本
(12 的 privacy / terms)、公网安备(13)、页脚联系方式(14)、同源媒体代理
(/site/media/remote)、插件前台页导航(source_type = plugin,09/10/11)、
商城六页搬回商城应用、/site/post/summary 摘要接口。
还没做:
- 报价的
.apply一族(172 行)还压在这份 theme.css 里:要等wujies-quote-plugin的QuoteSiteAssetController被宿主热加载一次、/site/apps/quote/quote.css实测回200 text/css才能删 (删后少 172 行:按 2685 行那版是 2513,按现在的 4116 行约 3944)。 - 通知条那 8 个键要等一次升级才落库:SQL(
migrations/08)与后台表单都已就位,但本机这个 已经装好的环境还没跑 08 ⇒ 八个框是空的、打字保存会失败(原因见上面那个 ⚠️ 块)。 补跑要写线上库,等点头。 - 目录页没有排序控件:
MallCatalogApi#listProducts只按后台sortOrder升序返回, 契约里没有排序参数,加控件就得先加契约。同理没有翻页(只有limit,上限 60)。 - 筛选只有分类 + 关键词:价格区间、颜色、尺码三组都没做 —— 商品表里没有可筛的规格数据 (
specConfig是一段 JSON 字符串,不是列)。 - 搜索只搜商品:导航条那个框提交到商城的
/site/shop?q=。全站(文章 + 页面 + 商品)没有搜索端点, 所以这一条不是"入口没做",是后端没有能查的东西。 assetUrl的?v=是主题编码,不是版本:同一套主题改了 CSS,访客浏览器上的旧文件不会失效。 正解是接产物指纹,那要等主题打包进发行版本体。- 开发态「个人中心」要跨主机名跳:
cms.consoleUrl配的是http://127.0.0.1, 而前台是从http://localhost打开的。alignConsoleHost只把回环别名归一(localhost/127.0.0.1/::1算同一台机器),非回环的域名不一致时故意不猜,原样保留。 - 其它应用的前台页:图床、企业查询、考试、询价已经有各自的公开页并挂进导航;考试与即时通讯 要不要再往下做(列表页、详情页)还没定(IM 基本没有"公开可看"的东西,考试是另一套权限模型)。
- 文章编辑器抽成可复用组件放进
@wujies/components:现在文章与页面两个编辑页各自引宿主的 全局WangEditor,企业/商城的富文本也该共用同一套(发 npm 前要二次确认)。 - 定时发布(
status=scheduled有列、没有到点转 published 的任务)。 - 列表页真正的分页:
/site/category/{slug}?page=2现在只接参数、不改内容,靠noindex兜住重复 URL。 - 阶段 B:多主题目录与回落、
theme.yaml与主题选项表单、按 Host 定租户、sitemap.xml/robots.txt、JSON-LD 结构化数据。 - 阶段 C:接管根路径
/(前提是把宿主IndexController#index那份网站配置接口的消费方先迁走)。
🔒 隐私与外部资源
- 不收集、不上报任何遥测;页面渲染只读本平台数据库,评论与头衔分别向社交、会员应用现问。
/site/media/remote只代理模板里写出来的图片地址,并且把闸门写死在代码里:只http/https、端口 80/443、 拒 IP 字面量与内网/回环/链路本地地址(DNS 解析后逐个判)、不跟 3xx、只收image/*、上限 8MB。- 上传文件存放位置由平台「存储配置」决定(本地磁盘或对象存储),本插件代码里不写任何密钥。
- README 与仓库中不包含任何真实口令、token 或私钥;签名密钥只在本机
keys/(已 gitignore)。
📄 许可证与致谢
商业授权:本应用当前为脚手架形态、按企业档处理,需要一枚覆盖本应用的有效授权凭证才允许安装
与加载(条文见仓库根目录 LICENSE,不适用 MIT 或任何其它开源许可)。清单 app.json 里
license 为 UNLICENSED、licenseRequired 为 true;三档口径见官网 wujies.cn
的「授权与版本」文档。
默认主题的版式骨架取自 Nike 官网的公开设计语言,只沿用布局与节奏,不含任何品牌素材;
主题里的 beian.png 是本站自备的公网安备小图标。
💬 反馈与建议
- 仓库:gitee.com/wujies/wujies-cms-plugin
- 文档:插件开发见 docs.wujies.cn,打包见 「打包应用」
参考
wujies-gallery-plugin(第一个自带公开页资源端点的应用)、
wujies-mall-plugin(第二个,样式搬走的判据就是它定的;商城六页现在由它直出)、
wujies-quote-plugin(.apply 那一族的去处,端点已写好等热加载)、
wujies-ui(KCommentSection 与 @wujies/* 的源码仓)、
文档站「插件开发」章节。
</p>
评论区需要浏览器启用 JavaScript 才能加载。