Skip to content

NovaBlog CMS v1.2.11

Choose a tag to compare

@github-actions github-actions released this 26 Oct 13:38
· 23 commits to main since this release

NovaBlog CMS v1.2.11

本版本完成媒体库图片引用架构改造:内容创作与「关于我」全部模块的图片字段不再把完整 URL 写死在业务表,改为引用媒体库文件 ID,读取时按当前存储配置动态拼接访问链接——更换对象存储平台、更换自定义域名后全站图片自动跟随,从根源上消除「迁移存储后旧图断链」的同步问题。

架构改造

业务表存文件 ID,链接动态解析

  • 文章/菜谱/书籍/游戏/视频/歌曲/歌单/旅行攻略(内容创作)与个人设备/项目经历/技术栈/个人资料(关于我)共 12 张表的封面、图标、头像等图片字段新增 media_id(及预设 preset_id)引用列
  • 从媒体库选图/上传时存 ID,读取时实时解析为最新链接;第三方外链(Simple Icons 图标、B站解析封面、手动输入的链接)保持 URL 模式,两种来源互斥共存,历史数据兼容不变
  • 落库不固化 URL:保存时 ID 与 URL 互斥写入(模型层 BeforeSave 兜底归一),编辑保存不会把解析出的完整 URL 重新写回数据库

media 表只存相对路径,URL 全动态拼接

  • media.url / media_presets.output_url 统一归一为相对对象键,完整 URL 在读取时按该媒体所在存储平台的当前配置(自定义域名优先)动态拼接
  • 更换存储平台的自定义域名后立即全站生效,零数据库改写;存储迁移工具迁移文件后仅更新 storage_type,完成即生效

正文与 jsonb 内嵌图使用稳定链接

  • 新增公开稳定链接端点 GET /api/v1/public/media/:id/file(支持 ?preset= 指定预设成品图):本地存储流式返回文件,对象存储 302 到当前访问地址
  • 富文本/Markdown 正文上传插图、菜谱步骤图、旅行景点/行程图改用按媒体 ID 索引的稳定链接,存储迁移/换域名后历史内容不断链

体验改进

媒体删除的引用确认更精准

  • 删除弹窗的引用扫描从「URL 字符串模糊匹配」升级为「文件 ID 精确匹配」(保留 URL 与稳定链接兜底扫描,命中自动去重),ID 引用的内容必定被准确列出
  • 强制删除被引用文件时,同一事务内自动清空所有业务表中的引用列,不再遗留死 ID

存储迁移工具加固

  • 平台迁移不再需要改写业务表里的 URL 字符串;正文与 jsonb 内嵌图的历史绝对 URL 保留自动 REPLACE,并补齐菜谱步骤图、旅行景点图/行程图两类此前遗漏的同步位置

升级说明

  • 数据库:无需手工操作。AutoMigrate 自动为 12 张业务表新增引用列、为 media_presets 表补 storage_type 列;migrations/043_media_reference 为等价 SQL 存档
  • 存量数据:服务启动后在后台 goroutine 自动幂等回填(按 URL 与 media.url/存储路径匹配填引用列,匹配不上的纯外链保持原样),不阻塞启动;回填未完成的短暂窗口内读取走 URL 兜底,页面无感知
  • 配置:无新增配置项;现有存储配置与已上传文件不受影响
  • 公站主题:零改动——API 仍下发完整 URL 且字段名不变,主题站/静态导出站无需重建即可正常渲染
  • 升级验证方法:在媒体库更换存储自定义域名(或执行一次平台迁移),所有引用中的文章封面、头像等链接应即时跟随新地址

Full Changelog: v1.2.10...v1.2.11