Skip to content

Releases

NovaBlog CMS v1.3.0

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

NovaBlog CMS v1.2.12

Choose a tag to compare

@github-actions github-actions released this 26 Oct 15:43

NovaBlog CMS v1.2.12

本版本完成配置统一改造:彻底解决配置分散在「容器 env / config.yaml / 数据库」三处、同一语义多处维护导致的 不同步问题。落地为三层分源——容器编排层只管部署事实、config.yaml 只保留启动前置、运行时配置以数据库为唯一主源,管理后台新增「站点信息」配置分组与配置导出/导入(多博客一键复制),并修复存量部署中的多处配置真分裂问题。

补充更新:B 站视频解析修复(同版本镜像重新发布)

本节为 v1.2.12 镜像的重新发布内容,需重新拉取镜像更新容器后生效。

  • 修复 412 风控拦截:B 站近期对数据中心 IP 的 x/web-interface/view 接口启用 412 风控(返回 HTML 验证页),导致音乐列表/视频作品粘贴 B 站链接解析时报「解析视频信息响应失败: invalid character '<'」。解析现改用官方 WBI 签名接口 x/web-interface/wbi/view(nav 签名密钥缓存 1 小时 + spi 访客 Cookie 缓存 24 小时),实测数据中心 IP 服务器可正常解析
  • 降级兜底:WBI 请求被风控拦截时自动降级 x/player/pagelist(该接口未被风控),标题/时长/分P/cid 仍可解析(封面与 UP 主需手填);两级均失败时返回明确的「B站风控拦截(HTTP 412)」提示,不再出现 JSON 解析裸错误
  • 行为修正:业务错误(如视频不存在 -404)直接返回不再误触发降级;签名失效(-403)自动刷新密钥重试一次
  • 修复创建歌曲报错:未选分类时前端传空 category_id 落库触发 uuid 列 22P02 invalid input syntax 错误(报「创建歌曲失败」);新增分类引用统一归一化(空串置 NULL),创建/批量创建/更新三个入口全覆盖
  • 覆盖范围:音乐列表解析、视频作品解析、MCP parse_video_url 三条路径共用同一客户端,同步修复

三层分源(新的配置主源约定)

层 职责 变化
容器编排(.env / compose / nginx) 镜像版本、宿主端口、挂载路径、DB 模式等部署事实 不变(后端进程本就不读环境变量)
config.yaml 仅「启动前置」:数据库/Redis 连接、HTTP 端口、日志、JWT/加密密钥 大幅瘦身:删除 cors/community/security/image_search/clouddrive 与 themes 的全部运行时键
数据库 一切后台可改的运行时配置,唯一主源,保存即时生效 新增 system_configs 通用键值表(migrations/044)

config.example.yaml 中的 cors.allowed_origins、community.base_url、upload.base_url、geoip.download_url 保留为 [播种] 键:仅首次启动导入数据库作初始值,此后一律以后台为准。

存量配置自动收敛(升级零手工)

  • 启动时后台 goroutine 幂等种子导入:存量 config.yaml 旧键自动写入数据库(仅 DB 无值时写入,此后 yaml 不再被读取)——多个旧代理键(themes/image_search/clouddrive/geoip 的 proxy_url)归一为单一「出网代理」,GitHub Token、主题制品上限、云盘限额、站点对外地址等一并迁移
  • 升级后 deploy.sh 对被移除的旧键提示「废弃,原样保留」,无任何副作用;无需手工改配置

重复源分裂修复

  • 官方站点地址:原先 4 级兜底链(社区推送 DB → community.base_url → 遗留主题市场 DB 列 → themes.market_base_url)收敛为「社区推送 DB 权威值 → 播种键 → 内置默认」,幽灵键 community.site_url(代码读取但所有 yaml 均不存在)与遗留键兜底全部移除
  • 站点对外地址:新增 system_configs.site_url 为权威值(非空时覆盖 yaml 的 upload.base_url 首装默认),后台修改即时热更媒体 URL 基址,并提示同步检查跨域白名单
  • HTTP 代理:4 个独立 yaml 键统一为单一「出网代理」配置,主题下载/开源作品/图片搜索/云盘/IP 库更新共用(空=直连,保留代理不可用自动降级)
  • 访问日志保留天数:修复真分裂——原先后台修改数据库值不生效(清理 worker 只读 yaml),现 worker 直接读数据库权威值
  • 死键清理:security.enabled/security.blacklist_ttl_minutes(无任何读取点,生效源一直是数据库)

管理后台:配置中心增强

  • 系统配置新增「站点信息」分组(置于首位):站点对外地址、出网 HTTP 代理、GitHub 访问令牌、主题制品下载上限、云盘导入限额(单文件/单批)、IP 库下载地址——保存即时生效,每分组标注「即时生效」徽标
  • 补齐安全参数 UI(此前安全开关/黑名单 TTL/日志保留天数只有后端接口无界面)
  • 配置导出/导入:页头一键导出全部运行时配置为 JSON(凭据类默认脱敏为占位符,可选包含);导入时展示将覆盖的分组并二次确认,按分组汇总写入结果——新博客导入即复制一套完整配置

工作台加载体验优化

  • 工作台不再等待全部统计接口返回才渲染:页面结构与各统计卡片即时呈现,访问趋势、内容产出、模块数据表、访问分布、热门内容、最近评论等区块各自独立展示 loading(骨架屏/转圈),哪个接口先返回就先渲染哪个
  • 指标条数值在依赖接口未就绪时展示脉冲骨架占位,接口失败时各区块回落到自身空态文案,不再整页空白
  • 切换 7 天/30 天/90 天时间范围时,趋势图表同样展示 loading 反馈(此前切换无任何状态提示)

遗留文件自动收编进媒体库

早期(约 9 月及以前)的头像/博客 icon/页面背景走的是直写磁盘流程——文件只落在存储目录、完整 URL 烙进 bloggers 表,从未登记媒体库。ID 引用统一机制只覆盖"有媒体记录"的文件,这类遗留文件因此仍指向旧域名地址(即使旧域名已弃用)。

  • 启动迁移新增遗留文件收编步骤:扫描全部业务表图片字段中引用列为空、URL 含 /files/ 的行,提取对象 key(自动解码中文路径、不依赖旧域名),media 无记录且磁盘文件存在时自动补建媒体记录(本地存储、归类到所属模块文件夹如「博主资料」)并回填引用列;磁盘缺失的保持 URL 模式
  • 幂等设计:仅处理引用列为空的行、media 建行按存储路径防重,重复重启零副作用
  • 收编后这些文件出现在媒体库统一管理,头像等地址自动跟随当前站点域名

部署脚本对齐

  • 安装生成的 config.yaml 同步瘦身为启动前置 + 播种键;--market-url 不再写废弃键 themes.market_base_url,改为播种 community.base_url
  • 修复多博客部署盲点:NOVABLOG_GEOIP_DIR 纳入 .env 管理,IP 离线库目录按博客隔离(此前所有博客共享同一目录)

升级说明

  • 数据库:无需手工操作。AutoMigrate 自动建 system_configs 表(migrations/044 为等价 SQL 存档);启动种子自动导入存量 yaml 运行时键
  • 配置:无新增必填项;现有数据库/Redis/存储配置与已上传文件不受影响
  • 公站主题:零改动(媒体 URL 基址、apiBase 注入逻辑不变)
  • 升级验证:管理后台「系统配置-站点信息」修改站点对外地址并保存 → 文章封面等媒体链接立即跟随新地址;「导出配置」后在新博客「导入配置」→ 各分组配置一致

Full Changelog: v1.2.11...v1.2.12

NovaBlog CMS v1.2.11

Choose a tag to compare

@github-actions github-actions released this 26 Oct 13:38

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

NovaBlog CMS v1.2.10

Choose a tag to compare

@github-actions github-actions released this 23 Oct 05:17

NovaBlog CMS v1.2.10

本版本修复 v1.2.9 中百度网盘导入文件必现失败的问题,并为云盘导入补充逐文件进度条与实时下载速度展示——第三方网盘普遍限速(如百度非会员约 80KB/s),下载期间不再出现「假 0%」,用户可看到每个文件的真实进度与速率。

问题修复

修复百度网盘导入必现失败(「未获取到下载直链」)

  • 根因:百度 filemetas 接口响应的文件数组字段为 info(仅目录列表接口 method=list 为 list),客户端此前按 list 解析,导致接口返回成功(errno=0)时始终取不到 dlink,所有百度网盘文件导入都会失败
  • 现按官方响应结构解析;已用真实账号与文件实测,修复后可正常取直链并流式下载
  • 空直链错误信息同步细化为可操作提示:百度个人开发者应用仅能下载「我的应用数据」(/apps/<应用名>/)目录内的文件,报错时会引导移动文件或申请下载权限

新特性

导入逐文件进度与实时下载速度

  • 导入弹窗中每个文件拥有独立进度条(已下载/文件大小百分比)与实时速度(KB/s、MB/s),整体进度条与成功/失败计数保留
  • 后端在下载流上计数并节流回写数据库(增量 ≥1MiB 且间隔 ≥1s),前端每 2 秒轮询渲染,限速下载时进度与速度平滑可见
  • 完成后逐文件状态保留在结果视图中,可一眼看到每个文件的成败与耗时

下载空闲看门狗(健壮性)

  • 网盘直链连接若持续超过 120 秒无任何字节(死挂),自动取消该文件下载并标记失败,任务继续处理其余文件,不再无限期阻塞

升级说明

  • 数据库:无需手工操作。AutoMigrate 自动为 cloud_import_items 表新增 transferred_bytes 列;migrations/042 为等价 SQL 存档
  • 无配置变更;已绑定的云盘账号与授权状态不受影响
  • 拉取新镜像重启后,重新发起导入即可看到逐文件进度

Full Changelog: v1.2.9...v1.2.10

NovaBlog CMS v1.2.9

Choose a tag to compare

@github-actions github-actions released this 23 Oct 02:12

NovaBlog CMS v1.2.9

本版本的核心是 媒体库支持第三方云盘导入:新增「云盘账号管理」与「云盘导入」能力——WebDAV 账密直连开箱即用(坚果云/Alist 等,零审核),百度网盘与阿里云盘通过开放平台 OAuth 接入(自部署站长自带凭据);云盘文件可批量浏览并转存进媒体库,完全复用现有对象存储与文件夹体系,前台展示链路零改动。

新特性

云盘账号管理页(系统与安全 → 云盘账号)

  • WebDAV:填写服务器地址与账密即可绑定(保存前自动测试连通),支持多账号;坚果云请使用「应用密码」;自建 Alist 可将百度/阿里/夸克等网盘聚合为 WebDAV,一次性接入全部网盘
  • 百度网盘/阿里云盘:在对应 Tab 配置开放平台应用凭据(AppKey / Client ID + Secret,AES 加密落库),页面提供开放平台申请入口链接;回调地址由当前访问地址自动生成(只读、可复制),复制登记到开放平台即可
  • OAuth 授权跳转官方授权页(账密/扫码登录),授权完成后账号页自动刷新;账号卡片展示昵称、容量使用与授权状态,可随时解绑

媒体库「云盘导入」

  • 媒体库页头新增「云盘导入」入口:选择账号 → 浏览云盘目录(面包屑导航、进入文件夹、文件多选/全选、游标加载更多)→ 选择目标媒体文件夹 → 批量导入
  • 导入为转存:云盘文件下载后写入当前对象存储(本地卷/阿里 OSS/腾讯 COS/MinIO),自动创建媒体记录并归入目标文件夹,引用检查、素材迁移、删除清理等既有体系完全兼容
  • 支持图片/视频/音频及任意文件类型(按扩展名归类到媒体库对应 Tab);下载流直通存储(流式入库),GB 级视频不占用额外内存
  • 导入过程实时进度条 + 成功/失败计数 + 失败明细(文件名与原因);完成后媒体库自动刷新,可直接用作文章封面等

安全与限流

  • 全部管理接口需登录;OAuth 回调使用一次性 state(Redis,5 分钟)防 CSRF;云盘凭据与 token 均加密存储、接口返回脱敏
  • 单次导入上限 200 个文件、单文件默认 2048MB;同一账号同时仅允许一个导入任务;服务重启后遗留任务自动标记为失败,不会永久卡住

升级说明

  • 数据库:无需手工操作。服务启动时 AutoMigrate 自动创建 4 张新表(cloud_drive_configs / cloud_drive_accounts / cloud_import_tasks / cloud_import_items);migrations/040、041 为等价 SQL 存档
  • config.yaml:新增可选 clouddrive 配置段(proxy_url / max_file_size_mb / import_batch_limit),不配置走默认值;镜像内置配置自动生效,自行挂载 config.yaml 的部署按需添加
  • 云盘接入前提:WebDAV 开箱即用(坚果云需应用密码);百度网盘需在百度网盘开放平台申请应用,阿里云盘需在阿里云盘开放平台申请,并将后台「云盘账号」页展示的回调地址登记到对应平台;平台审核期间可先用 WebDAV
  • API 兼容性:纯新增接口(/api/v1/clouddrive/*)与前端页面,无破坏性变更;已有部署拉取新镜像重启即可

Full Changelog: v1.2.8...v1.2.9

NovaBlog CMS v1.2.8

Choose a tag to compare

@github-actions github-actions released this 22 Oct 07:35

NovaBlog CMS v1.2.8

本版本的核心是 MCP 服务端能力全面扩展:工具数量由 9 个增至 93 个,覆盖管理后台全部内容模块(文章、媒体库、分类标签、关于我、评论、工作台统计与八大内容创作模块),AI 客户端从此可以开口管理整站内容;同时出厂 CORS 默认白名单补充生产域名,并修复 i18n 部分文案未覆盖到位的问题。

新特性

MCP 工具全面覆盖(9 → 93 个)

  • 媒体库:upload_image 新增 module 参数,上传图片按内容模块自动归档到对应文件夹;新增 list_media、list_media_folders、move_media、delete_media(文件被引用时需 force=true)
  • 分类与标签:list_categories 支持全部 12 种内容模块类型;新增 create_category / update_category / delete_category 与 create_tag / update_tag / delete_tag
  • 关于我:新增博主资料 get_profile / update_profile,以及个人设备、项目经历、技术栈、开源作品(含 refresh_open_source 重新拉取仓库信息)四组 CRUD 工具
  • 内容创作:新增第三方歌单、视频作品(含 parse_video_url 链接预解析)、旅行攻略(含 set_travel_status 发布控制)、摄影作品集(含作品项增删改与排序)、美食菜谱、读书书架、游戏库、健身训练八组模块工具
  • 评论管理:新增 list_comments、reply_comment(以博主身份回复)、delete_comment(级联软删其下回复)
  • 工作台(只读):新增 get_dashboard_overview(各模块文章/发布/评论统计与流量摘要)、get_dashboard_trend(内容产出/流量趋势,7d/30d/90d)、get_top_content(热门内容排行)
  • 安全约束统一:所有删除类工具必须显式传 confirm=true 才会执行,防误删
  • 新增 MCP 服务端单元测试;README 五个语言版本的 MCP 章节同步更新为按域分组的 93 工具总览

媒体库系统文件夹随语言显示

  • 媒体文件响应新增 folder_module_key 字段,前端据此翻译系统文件夹名称(media.module.*);媒体库面包屑、选图弹窗、移动弹窗与列表中的系统文件夹名均跟随当前界面语言,不再显示数据库原名

CORS 出厂默认白名单补充生产域名

  • 全新安装的默认白名单由 http://localhost:5173,http://localhost:5174 扩充为同时包含 https://www.novablog.cn 与 https://api.novablog.cn(config.example.yaml、中间件硬编码兜底值、模型列默认值三处同步);后台动态修改的白名单仍以数据库持久化值为准

问题修复

  • 修复 i18n 部分文案未覆盖到位的问题:MCP 设置页的能力描述与安全提示更新为 93 工具口径;新增系统文件夹模块名翻译(media.module.*);简体中文、繁體中文、English、日本語、한국어 五语言同步补齐

升级说明

  • 数据库:无需手工操作。服务启动时 AutoMigrate 同步表结构;migrations/039_cors_default_origins 仅调整 cors_configs 列默认值并回填从未被修改过的播种行——由于项目没有自动执行 SQL 迁移的机制,该回填由启动引导逻辑(InitFromFallback)等价完成:只要白名单从未在后台被修改过,重启后会以 config.yaml 的值自动回填 DB;自定义过的配置不受任何影响。如使用外部迁移流程,也可手工执行对应 SQL,与自动回填互不冲突
  • config.yaml:cors.allowed_origins 出厂默认值已补充生产域名,镜像内置 config 由 config.example.yaml 生成、自动生效。已有部署若自行挂载了 config.yaml,请同步在 cors.allowed_origins 中追加 https://www.novablog.cn,https://api.novablog.cn 后重启;已在后台自定义过白名单的环境以数据库值为准,请按需在后台自行添加生产域名
  • MCP 使用方:升级后重新拉取工具列表即可使用全部 93 个工具;如已在 AI 客户端(Codex / ZCode 等)配置了 Skill 接口文档,建议同步更新以获得完整能力。删除类操作现统一要求显式 confirm=true(delete_media、delete_comment 等新增工具同样适用)
  • API 兼容性:媒体文件响应新增可选 folder_module_key 字段,向后兼容
  • 已有部署拉取新镜像重启即可,无破坏性变更

Full Changelog: v1.2.7...v1.2.8

NovaBlog CMS v1.2.7

Choose a tag to compare

@github-actions github-actions released this 21 Oct 09:43

NovaBlog CMS v1.2.7

本版本的核心是管理后台多语言国际化:界面全面支持简体中文、繁體中文、English、日本語、한국어 五种语言,切换全链路打通;同时对书籍/游戏/菜谱/视频/项目经历/开源/技术栈/健身八个模块统一接入结构化分类,并将官方站点域名切换为 novablog.cn。

新特性

管理后台多语言(i18n)

  • 新增五种界面语言:简体中文(默认)、繁體中文、English、日本語、한국어,覆盖布局、登录页、首装向导及内容创作域(文章/媒体库/音乐/播放列表/评论/分类/视频)、生活与作品域(书籍/游戏/菜谱/健身/器材/旅行/作品集/项目/开源/技术栈)、系统域(主题/系统/存储/安全/地图/MCP/文档/资料/编辑器)全部页面
  • 顶栏、登录页与首装向导均提供语言切换入口,初始语言自动检测:本地偏好 → 浏览器语言(精确匹配 → 前缀匹配,繁体地区 zh-Hant/TW/HK/MO 自动映射繁體中文)→ 简体中文;手动切换后持久化到本地
  • 图表与格式联动:echarts 图表文案、dayjs 日期、Intl.NumberFormat 数字格式化均跟随当前语言;请求拦截器兜底文案(登录过期/网络错误等)同步国际化
  • README 新增繁體中文/English/日本語/한국어 四个语言版本
  • 新增 npm run check:i18n 校验脚本:五语言命名空间 key 一致性 + 源码静态 t() 引用检查(当前 1269 个 key、34 个命名空间),防止漏译入库

多模块统一分类体系

  • 视频作品、读书书架、美食菜谱、游戏库、项目经历、开源作品、技术栈、健身训练八个模块统一接入 categories 结构化分类(新增 category_id 外键关联),各模块列表接口支持按 category_id 筛选
  • 分类唯一性由全局 slug 唯一改为 (type, slug) 联合唯一,不同模块允许同名分类;API 文档同步更新
  • 存量数据自动迁移:项目经历的自由文本分类、技术栈的约定值(语言/框架/工具/数据库/其他)、健身训练的固定枚举(力量/有氧/拉伸)在服务启动时幂等播种为分类并回填 category_id(等价于 migrations/037、038,回填失败仅跳过对应步骤、不阻塞启动)

官方域名切换

  • 官方站点地址由 novablogapi.ditancafebar.cn 切换为 api.novablog.cn(注册页 www.novablog.cn),出厂配置、主题市场客户端与文档同步更新;后台修改的官方地址仍以数据库持久化值为准

问题修复

  • 无

升级说明

  • 数据库:无需手工操作。服务启动时 AutoMigrate 同步表结构,并自动完成分类数据的幂等回填(等价于 migrations/037_content_categories、038_unify_tech_stack_fitness 的 up 脚本);如使用外部迁移流程,也可手工执行对应 SQL,与自动回填互不冲突
  • config.yaml:community.base_url 出厂默认值已更新为 http://api.novablog.cn;已在后台修改过官方地址的部署以数据库值为准、无需改动。旧域名作为存量兜底仍可读取,建议尽快更新
  • API 兼容性:各内容模块请求/响应新增可选 category_id 字段,向后兼容;项目经历、技术栈、健身的旧字段(自由文本 category、枚举 type)保留为兼容镜像,由逻辑层与分类双向同步
  • 已有部署拉取新镜像重启即可,历史数据(项目经历分类、技术栈分类、健身类型)会自动转换为统一分类,无数据丢失

Full Changelog: v1.2.6...v1.2.7

NovaBlog CMS v1.2.6

Choose a tag to compare

@github-actions github-actions released this 16 Oct 12:43

NovaBlog CMS v1.2.6

本版本的核心是音乐播放列表(音频导入)管理体验优化:修复封面不显示问题,补齐行内编辑/删除,新增拖拽排序与置顶,并支持卡片上直接切换分类。

新特性

音乐列表排序:拖拽 + 置顶

  • 鼠标悬停歌曲行首出现拖拽把手,按住拖动到目标位置松手即自动保存,拖动中目标行高亮提示;保存失败自动回滚刷新
  • 行尾新增「置顶」按钮,点击将该歌曲移动到列表第一位;置顶后仍可被拖拽换位
  • 新增批量排序接口 PUT /api/v1/music/songs/sort(事务内逐条更新);保存时按当前分类拉取全量歌曲统一重编 sort_order,分页场景下顺序全局一致

歌曲行内编辑/删除

  • 歌曲行尾新增「编辑」「删除」操作按钮(悬停显示):编辑复用歌曲弹窗,可修改标题、歌手、封面、分类、时长;删除需二次确认

卡片分类快改

  • 歌曲标题右侧展示所属分类标签,点击弹出分类下拉立即切换,支持移入「未分类」;在分类筛选视图下移走歌曲会同步从列表消失

问题修复

  • 音乐封面加载失败:管理端此前将 http:// 封面地址强转为 https://,导致跟随 upload.base_url 转存的本站封面(无 TLS)全部加载失败、显示 alt 文本。现改为多级降级加载:缩略参数 URL → 原始 URL → 服务端图片代理 → 占位图,列表封面、底部播放器、编辑弹窗预览、批量导入预览四处同步修复
  • 编辑歌曲时清空分类不生效:后端此前将空的 category_id 视为「不更新」,现修正为传空字符串即清空分类(置为 NULL),并避免写空串触发 uuid 外键错误

升级说明

  • 无破坏性变更:songs 表 sort_order 字段此前已存在,本次无数据库迁移;config.yaml 无需改动
  • 已有部署拉取新镜像重启即可
  • 拖拽排序与置顶保存使用新增的管理端接口,使用已登录的后台会话即可,无需额外配置

Full Changelog: v1.2.5...v1.2.6

NovaBlog CMS v1.2.5

Choose a tag to compare

@github-actions github-actions released this 16 Oct 11:00

NovaBlog CMS v1.2.5

本版本的核心是社区推送新增「博客归属验证码」:在后台粘贴社区下发的验证码并保存,即可完成博客与社区账号的归属绑定,验证通过后博主的社区账号获得「站长」标识。

新特性

社区推送:博客归属验证码

  • 「系统配置 → 社区推送」新增「社区验证码」输入项:在 NovaBlog 社区「个人设置 → 绑定博客」复制验证码,粘贴后保存即可;验证码对外可见、配置读取时直接回显,允许清空
  • 保存配置时自动向社区提交归属验证(验证码本身即凭据,无需推送密钥),并即时展示结果:
    • 验证成功:提示社区账号「xxx」已获得「站长」标识
    • 验证失败:展示社区返回的具体原因;配置本身仍会保存,修正验证码后重新保存即可重新提交
    • 未填写验证码:视为跳过,保存流程与此前完全一致,不影响推送配置的日常维护
  • community_push_configs 表新增 verify_code 列,随配置持久化,重启后依然生效

变更

  • README 补充作者博客入口链接

升级说明

  • 无破坏性变更:升级后 AutoMigrate 自动为 community_push_configs 表新增 verify_code 列,无手动数据库操作;config.yaml 无需改动
  • 已有部署拉取新镜像重启即可;如需完成社区「站长」认证,到后台「系统配置 → 社区推送」粘贴社区个人设置页展示的验证码并保存一次即可
  • 归属验证失败不影响内容推送:文章等内容同步照常进行,仅社区侧「站长」标识未生效

Full Changelog: v1.2.4...v1.2.5

NovaBlog CMS v1.2.4

Choose a tag to compare

@github-actions github-actions released this 12 Oct 10:06

NovaBlog CMS v1.2.4

本版本的核心是新增「社区推送」模块——CMS 内容一键同步到 NovaBlog 社区,并将官方站点地址收敛为统一托管,社区推送与主题市场共用同一入口。此外还带来部署脚本全面增强、首装部署密钥即时核验、GeoIP 数据文件后台下载与多架构镜像构建提速。

新特性

社区推送:CMS 内容一键同步到 NovaBlog 社区

  • 「系统配置」新增「社区推送」页:维护官方站点地址、博客对外地址与推送密钥(nbk_...,仅管理员接口可写、读取脱敏),支持一键测试连接;不配置即功能不启用,不影响其他模块
  • 支持文章、旅行攻略、美食菜谱、摄影作品集、开源作品五类内容推送,推送时携带原文链接(source_url)指回博客
  • 同步时机:内容创建 / 更新 / 上下架后自动异步推送;删除自动同步社区下架;内容与状态均无变化时(hash 比对一致)自动跳过,不做无效请求
  • 失败自动重试:后台每 5 分钟扫描同步失败记录并重推最新内容,单条最多重试 5 次后停止自动重试,等待博主在后台手动处理
  • 管理端:五类内容的列表卡片与编辑页新增推送按钮(推送 / 重推 / 撤回,实时展示同步状态),支持查询推送记录

官方站点地址统一托管

  • 官方站点地址收敛为单一权威来源(community_push_configs 单行表),后台「系统配置 → 社区推送」是唯一维护入口;社区推送与主题市场共用该地址
  • 主题市场登录弹窗不再要求输入官方地址:由后端统一下发,弹窗展示当前官方地址并支持一键跳转修改(系统配置支持 ?tab= 深链定位)
  • 「博客 API 地址」设置弹窗同步简化,仅保留 public_api_base
  • 首装向导填写的官方地址同样写入统一配置,重启后依然生效

首装向导:部署密钥即时核验

  • 部署密钥输入框失焦即调用新增的 POST /install/verify-code 核验,内联展示校验结果,无需等到提交初始化才暴露错误
  • 核验与初始化共享防爆破计数:失败次数与限流策略同 /install/init 一致,不会被绕过

部署脚本(deploy.sh)增强

  • 新增 --install-code <值|auto>:官方部署可指定首装安装码(防恶意抢先初始化),auto 自动生成 UUID,写入 config 并在部署完成后摘要中展示;交互安装也会询问是否启用(自部署默认不启用)
  • 新增 --delete <名称>:彻底删除指定博客(容器与网络、宿主机反代配置、全部数据),必须交互键入博客名称确认,--yes 不允许绕过
  • docker-compose 新增应用级健康检查(/health 初始化完成后返回 200,start_period 120s 宽限覆盖首次启动 GeoIP 联网下载),并映射 host.docker.internal 到宿主机网关(Linux 下容器可直连宿主机上的 PG/Redis)

变更

  • GeoIP 数据文件缺失/损坏时转为后台下载并加载,不再阻塞启动;下载完成前访问日志的地区字段为空
  • Dockerfile 构建阶段固定 $BUILDPLATFORM 原生执行、Go 交叉编译替代 QEMU 模拟,多架构镜像构建时间从约 13 分钟缩短至约 2 分钟;CI 钉住 buildx/BuildKit 版本保持发布链路稳定
  • README 重构完善并新增项目 Logo,清理仓库内历史设计文档
  • config.example.yaml:新增 community.base_url 出厂默认值;移除 themes.market_base_url(存量值仍会被读取兜底,无需删除)
  • 旧版 theme_market_configs 表的 market_base_url 列不再写入(AutoMigrate 不删列,保留只读作存量迁移兜底)

升级说明

  • 无破坏性变更:升级后自动创建 community_push_configs、community_sync_records 两张新表(AutoMigrate),无手动数据库操作
  • config.yaml 无需改动:官方站点地址按「社区推送 DB 值 → community.base_url → 旧版主题市场 DB 值 → themes.market_base_url」链路自动兜底,老配置原样可用;如需显式配置,参考 config.example.yaml 新增的 community 段
  • 未配置推送密钥时社区推送为未启用状态,主题市场、首装向导等其他功能不受任何影响
  • 已有部署拉取新镜像重启即可,config.yaml 无需改动;部署脚本新增的 --install-code、--delete 与 compose 健康检查需使用仓库最新版 deploy.sh / docker-compose.yml 才生效

Full Changelog: v1.2.3...v1.2.4