Skip to content

NovaBlog CMS v1.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 03 Nov 02:21

NovaBlog CMS v1.3.0

本版本为切割版本(破坏性重构):以 v1.2.x 为界对历史包袱做一次性清底——移除全部向下兼容代码与死代码、删除 88 个历史迁移 SQL、移除全部测试用例,表结构以 GORM AutoMigrate + bootstrap 启动逻辑为唯一事实源。同时落地两轮代码核查报告的全部整改:定时任务拆分为独立进程、缓存层收口、主题托管分层、/ready 真实探活、错误信息收敛等规范修复。

Warning

不兼容提醒:v1.3.0 不兼容 v1.3.0 之前的任何版本,无法直接升级。

  • 老用户:请先升级到 v1.2.12 完成旧数据兼容迁移,再升级 v1.3.0
  • 新用户:直接从 v1.3.0 开始使用即可

升级前请备份数据库与上传目录。

后台选图弹窗重构(媒体体验优化)

  • 统一选图体验:两栏文件管理器浏览器(MediaBrowser 共享组件)覆盖全部挑选媒体库的入口——9 个业务模块弹窗(文章/音乐歌曲/音乐歌单/视频/菜谱/游戏/项目/读书/设备)、旅行攻略封面与景点池、摄影作品集三步向导(添加作品/编辑/封面)
  • 两栏布局:弹窗加宽,左侧固定文件夹树(各级层级 + 文件数徽标,打开时按业务模块自动定位到对应文件夹),右侧为面包屑 + 文件网格,目录结构一目了然,不再依赖逐级点入
  • 文件名展示:图片下方显示文件名(超长省略、悬浮显示完整名),视频文件显示占位图标
  • 双维搜索:新增搜索框,支持文件夹名与文件名检索——文件夹由前端过滤目录树(结果带完整路径,点击直达该文件夹);文件走后端全局检索(结果标注所属文件夹),清空搜索即回到目录浏览
  • 个人资料、技术栈图标、文章编辑器为纯上传/在线搜图场景(无媒体库挑选需求),保持原交互不变

向下兼容内容移除(切割核心)

  • 退役 X-Market-Base-URL 请求头透传链:controller/logic/middleware/cors 共 16 处传参及 CORS 允许头一并移除(CMS 前端早已不发送该头,官方主题不受影响)
  • 零调用死代码清除:article_cache、SumArticleViews、IncrementViewCountByID、GetAllIDs、SoftDeleteByPortfolioID、GetByKey、ReplaceTags、GetTagIDsByArticle、IPBlacklistRecord 模型等;删除 5 个零引用错误码(403002/400205/400209/404004/400507)
  • 废弃库对象改为启动时自动清理(bootstrap/deprecated_cleanup.go,幂等 DROP ... IF EXISTS,失败仅告警不阻塞启动):
    • 旧 ip_blacklist 表(单数,注意运行时黑名单走 ip_blacklists + Redis,不受影响)
    • theme_market_configs.market_base_url 列(官方站点地址已统一托管)
    • security_configs 的 9 个旧限流列(get/post/view/like_max_tokens 及对应 window_seconds、blacklist_threshold)

历史迁移与测试清理

  • 删除 88 个历史迁移 SQL:经核查从未被代码/部署执行(全仓无迁移 runner、无 go:embed、deploy 目录零引用),且 9 张表从未有 CREATE TABLE 迁移、纯手工执行无法从零建库;migrations/README.md 重写为「启动逻辑事实源」说明
  • 移除全部 Go 测试文件(28 个):与死种子脚本 insert_article_golden_hour.sql 一并清理;CI 测试环节将空跑通过

定时任务拆分为独立进程

  • 新增 internal/cron + cmd/cron:访问日志清理(1h)、浏览统计聚合(1h)、社区推送失败重试(5min)三个任务移出 api 进程,api 进程不再内嵌长驻协程;任务全部支持 ctx 优雅停止(原 for range ticker.C 不可停止)
  • Dockerfile/supervisord 配套新增 novablog-cron 进程(SIGTERM 优雅收尾)

架构与规范修复(两轮核查报告落地)

  • 缓存层收口:新增 5 个 cache 封装(install_guard/bilibili/cloud_drive/view_stats/mcp_rate_limit),生产代码不再裸调 cache.RedisClient;cloud_drive 为 fail-closed(Redis 不可用拒绝 OAuth)
  • 主题托管分层:theme_host_logic 去 gin 依赖改为纯决策,HTTP 执行迁入新 controller/theme_host_controller.go
  • /ready 真实探活:从空壳改为真实 SELECT 1(2s 超时,失败返回 503)
  • GORM 日志接入 zap;DSN 时区自适应修复(TimeZone=Local 被 pg 拒绝导致启动失败的兼容问题)
  • 错误信息收敛:未映射错误统一返回「系统内部错误」,不再泄露内部 err.Error();删除 response.Error 陷阱函数
  • 环境变量覆盖:配置支持 NOVABLOG_ 前缀环境变量(app/seed 双入口)
  • Shutdown 失败降级:Fatal 改 Error,修复退出时跳过 DB/Redis 关闭的 bug

部署与仓库配置

  • deploy.sh 新增 --host-nginx 宿主机反代配置生成
  • 仓库清理:移除 .idea 与 docs 内部核查报告的 git 跟踪(仅本地保留),补充 gitignore 规则

升级说明

  • 升级路径(必读):
    • 老用户:v1.2.x → v1.2.12(完成旧数据兼容迁移)→ v1.3.0
    • 新用户:直接部署 v1.3.0
  • 数据库:无需手工操作。AutoMigrate 自动同步表结构;废弃对象由启动逻辑幂等清理;迁移 SQL 目录已整体删除,不再需要
  • 配置:无新增必填项,现有数据库/Redis/存储配置与已上传文件不受影响
  • 行为变化:
    1. 未映射错误响应文案统一为「系统内部错误」,依赖原始报错文案的客户端需调整
    2. 自改前端若仍发送 X-Market-Base-URL 头,主题市场接口预检将失败
    3. cron 进程的站点地址为启动时注入,后台修改站点地址后需重启 novablog-cron
  • 升级前请备份数据库与上传目录

Full Changelog: v1.2.12...v1.3.0