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 安装包。