VVCMS v5.13.0 更新说明 | 在线更新体系、内容排序与前台计数缓存

VVCMS v5.13.0 于 2026-11-06 发布。这是一个 minor 版本:在线更新与版本发布体系作为模块级新能力加入,同时汇总了 v5.12.6(10 月 25 日已发布)与 v5.12.7(此前未单独发布更新说明)以来的全部改进,累计 32 次提交、214 个文件变更。

在线更新与版本发布体系

运行版本统一由 version.txt 提供,构建时注入二进制,文件名、二进制版本与清单版本保持一致。新版升级清单按平台给出 url、size 与 sha256,下载后再次核对大小与摘要。

  • 后台可直接下载新版本:提交后立即返回后台任务,刷新页面即可查看进度、已接收字节与失败原因;MCP 也提供 download_update 与 get_update_status。
  • 检查限时 15 秒、下载限时 30 分钟、压缩包上限 40 MiB;上传与下载在同一进程内互斥,失败不会删除已有待应用包,进程重启后仍可识别。
  • 初始包地址限定官方 Gitee release 的 HTTPS 路径,默认只允许 gitee.com 重定向;只有准备成功才提示管理员手动重启,不会自动覆盖运行中的程序。

内容列表、排序与定时发布

  • 列表默认按 sort、创建时间、ID 排序;后台未选择栏目时按时间排序,选择栏目(含子栏目)仍以 sort 优先。
  • 公开列表、详情、卡片、标签与 sitemap 只包含已发布且发布时间已到的内容;定时发布记录在后台与搜索索引中仍可见。
  • 栏目隐藏只影响导航展示,隐藏栏目下已发布的内容仍然可以直接访问、参与栏目查询和 sitemap。
  • SQLite、PostgreSQL、MySQL 三方言的时间口径统一;MeiliSearch 增加 created_at_nanos 用于精确排序与公开时间过滤,升级后需执行一次搜索全量重建。
  • 内容表索引整合为 SQLite 19 个、PostgreSQL/MySQL 18 个固定索引,启动升级按实际查询补齐后再删除旧索引,用户自建索引和动态扩展字段索引保留。
  • 公开列表计数失败时返回明确的读取错误,不再被误判为零条内容。

前台计数缓存与读路径

新增前台计数缓存层:首页、栏目及后代栏目、栏目筛选、SQL 搜索、标签页、用户页与详情作者计数统一走缓存,相同条件的并发冷加载会合并,缓存 2048 项、最长 3 分钟,命中后不再执行计数 SQL。

  • 前台总数只统计已发布且发布时间已到的内容,不再直接复用可能因定时发布而偏大的 content_count;到点自动过期。
  • 内容、标签、栏目变更,以及主题初始化、迁移导入、测试数据、备份恢复都会清除相关缓存,并用版本号阻止旧查询写回。
  • 浏览量与访问明细改为批量落库,两阶段分页回表复查公开条件,前台模板渲染错误不再静默。
计数缓存仅在当前进程内,其他进程或直接改库最长依赖 3 分钟 TTL;多实例需要立即一致时,应接入共享失效通知。

内容重写、Sitemap 与配置接口

重写规则在动态请求、MCP 调用与后台发布任务各自的边界读取并固定快照,写入后发布当前值,旧请求继续沿用旧快照。规则或配置 JSON 故障不会阻断支付异步通知、登录验证码和配置修复写入。

  • Sitemap 按内容 ID 游标每批 100 条生成,索引与分片以完整快照原子发布,快照过期自动重建,失败不返回旧死链。
  • CMS 配置改为按字段更新,省略字段保持原值;content_rule 传空可清除规则,专用接口与通用创建/更新接口共用校验。

安全与稳定性修复

  • 授权判定改为调用点实时读库,修复已授权站点被误判未授权的问题,并补齐三层守卫测试。
  • CSRF 同源校验按 registrable host 比较并信任代理头,修复后台开发代理 403;Cookie 认证写请求优先采信浏览器 Sec-Fetch-Site 同源标记。
  • MCP 请求体上限修复:此前 SDK 默认 4 MiB 会导致更新包、主题包无法传入。
  • 记录与审计类 IP 采集统一到 gin 原生 ClientIP,并通过可信代理白名单收口 XFF 伪造风险;反向代理在远端时可用 VAPP_TRUSTED_PROXIES 或后台 trusted_proxies 配置。
  • 安装向导仅监听回环并要求空库,配置文件权限 0600;更新包解压限制 1 GiB / 10000 条目,应用中断按记录回滚;备份恢复保留目标站点敏感配置。

商城、订单与支付边界

  • 会员撤下本人内容只改为待审核并调整发布计数,正文、标签和商品数据保留。
  • 商品库存编辑支持 expected_stock 冲突检测,省略 stock 时保留实时库存;普通内容忽略库存与 SKU 字段。
  • 在线支付保存渠道身份与会话快照,无法确认渠道状态或无法安全关单的订单保留待对账,不假定已关单;迟到支付记录补齐。
  • 购物车事务内串行化,游客合并去重,提交跳过不可售商品;搜索重建与订单通知走持久任务重试。

回顾:v5.12.6 访问统计增强

本版同样包含 10 月 25 日 v5.12.6 的内容:新增 Yandex、DuckDuckGo、Yahoo、华为花瓣、网易有道等搜索引擎列,Ai2Bot、Mistral AI、ExaBot、Diffbot 等国外 AI 爬虫列,以及小米、讯飞星火、MiniMax、阶跃星辰、华为盘古等国内大模型爬虫识别;并新增默认关闭、可配置保留天数的访问明细逐条采集。

升级提示

  • 使用 Meilisearch 的站点,升级后请执行一次搜索全量重建。
  • 启动升级会自动补齐并核验索引,用户自建索引与动态扩展字段索引会保留;同版本重启也会执行。
  • 反代部署请把代理子网加入可信代理配置,否则反代后访客会共用代理机 IP。
  • 可通过后台在线更新或下载页获取 v5.13.0 安装包。
本文地址: https://www.vvcms.cn/update/v5-13-0
版权所有 © VVCMS 团队 未经授权不得转载

联系我们

微信号:ivvcms · 电话:13388969195

获取支持

相关推荐