一、这次更新改了什么
VVCMS 5.12.2 已于 2026-10-13 发布。这是 5.12.x 的一个维护性增强版本，重点在搜索体验、MCP 可控性、商城订单准确度三方面做了实质改进，并对全部主题做了通用能力升级。
- 搜索更快更准——接入 Meilisearch 全文检索引擎，内容增删改自动同步索引，后台可一键检查/测试/重建
- MCP 工具可勾选——后台按功能分组批量启用/禁用 AI 工具，并支持只读模式
- 订单规格不再对不上——订单行新增服务端计算的规格摘要快照，前端无法伪造
- 首页多一条信任背书——主题首页新增服务保障条（免运/退换/质保/客服）
- 9 套主题同步增强——页脚/页头、微信二维码、Tailwind 构建与后台可编辑表单升级
- 修了一个登录相关的体验 bug——未登录态下「登录/注册」链接点击无反应的问题已修复
二、核心更新
1. 接入 Meilisearch 全文检索
站点搜索从数据库模糊匹配升级为可接入 Meilisearch 全文检索引擎。
- 新增 SSRF 安全客户端：放开内网地址、禁用云元数据端点，避免索引同步变成内网探测
- 支持嵌套 ext 字段建索引，排序走 resolveSortKey 归一化，与列表页排序保持一致
- 内容发布、修改、下架自动同步到索引；后台新增 status / test / rebuild 运维路由，可查看索引状态、连通性自检与一次性全量重建
- 列表页支持按 ext 字段分组筛选，SQLite / MySQL / PostgreSQL 三库各自用原生 JSON 算子实现，行为一致
- 未配置外部引擎时，自动回落到原有数据库搜索，前台搜索不会因引擎缺失而失效
2. 首页服务保障条
全部主题的网站首页新增「服务保障条」组件，默认展示免运、退换、质保、客服四项信任背书（可在主题后台数据中调整文案），提升访客转化。
3. MCP 工具可按分组勾选
面向 AI 的 MCP 接口新增「工具目录」与后台勾选能力。
- 工具按功能分组：栏目 / 内容 / 标签 / 关键词 / 素材 / 主题 / 互动 / 配置 / 系统，后台按工作动线批量启用或禁用
- 新增只读模式：开启后，所有会写库或写文件的工具（Write=true）一律不注册，AI 只能读不能改，适合对外托管场景
- 目录由工具注册处产出，与注册清单同源，杜绝「后台勾了但模型看不到」的漂移
4. 订单行新增规格摘要快照
下单与结算时，订单行新增 SkuText 规格摘要快照（如「红, M」），由服务端按栏目字段模型 + 商品 ext 现算。
- 不采信任何前端传值：前端传来的红-M 可被伪造，且栏目字段模型一旦增删维度，历史订单需与当前口径一致，因此统一由服务端用详情页同款口径（spuAttrDimensions / BuildSkuAttrs）计算
- 与 Title / Price / Img 一样是永久快照：运营改了字段模型或下架变体商品，历史订单都不跟着变
- 栏目读取跨行复用（colCache）避免 N+1；栏目读不到时不阻断下单，仅当普通单品处理（SkuText 留空）
5. 小米商城（digital-mall）主题改进
完成小米商城主题的针对性改进：列表、详情、购物车、结算等页面与后台可编辑数据（vvdata）随新版商城与订单能力更新，并补齐首页服务保障条相关展示。
6. 全主题通用能力升级
对全部 9 套主题（default / baby-care / beauty-glow / digital-mall / fashion / fresh-mart / global-trade / home-nest / sport-storm）做了通用增强：
- 页脚/页头更新，新增微信二维码图片位，方便引导私域
- 引入 Tailwind 构建链路（build-tailwind.sh + tailwind.config.js + tailwind.src.css），主题样式工程化
- vvdata_schema 扩展，后台可编辑表单字段更丰富
7. 登录体验修复
修复未登录态下「登录 / 注册」链接点击无反应的问题：根因是 buildUserVM 在空壳期未填 AdminPath，导致链接拼成 #/auth/login（缺前缀），点下去只改了 hash、前台没有 hash 路由所以没反应。现已在未登录分支就填上后台前缀，已登录分支复用同一值。
8. 质量与构建
- 补充性能与安全的 E2E 回归脚本（run-perf.sh / run-security.sh），改动后可自动跑一遍
- 更新构建脚本（build_all.sh / build_linux.sh），统一多平台产物
三、其他优化
- 主题备份与上传能力随商城改进同步增强，恢复流程更稳
- 商品规格组合（SPU）的详情页选择器与订单规格摘要复用同一计算口径，前后台一致
四、升级建议
- 升级前备份数据库、uploads 上传目录与当前主题目录（可用主题备份一键打包）
- 要用外部全文检索，先准备好 Meilisearch 服务并在后台配置地址与密钥；不配置不影响原有搜索
- 对外提供 AI 能力时，建议在后台开启 MCP 只读模式，避免 AI 误改线上数据
- 已有自定义商城/会员页模板的站点，升级后建议对照新版主题同名模板检查一遍
五、兼容性说明
- Meilisearch 为可选能力，不配置则沿用原有搜索，老站点升级无需改动
- MCP 工具分组与只读模式为新增能力，原有工具名称与行为不变；只读模式默认关闭
- 首页服务保障条、订单 SkuText 快照均为新增字段/组件，不改动既有内容与栏目结构
- 全主题更新向后兼容，不会覆盖你的自定义模板与数据
六、小结
VVCMS 5.12.2 把 5.12.x 的交易与 AI 能力打磨得更稳更可控：搜索可接 Meilisearch 且能一键运维，MCP 工具可按需勾选并支持只读，订单规格从此与详情页选择器严格一致，9 套主题也补齐了服务保障条与工程化构建。如果你是自建站或内容站，这一版值得平滑升级。