Skip to content

NotionNext 4.10.0

Choose a tag to compare

@tangly1024 tangly1024 released this 03 Jun 14:10
· 486 commits to main since this release
dbd2cec

NotionNext 4.10.0

本版本是一次以多主题站点性能为核心的较大版本更新,目标是在保持现有主题、配置和插件行为不变的前提下,让站点渲染更轻、更稳、更容易验收。

性能优化

  • 首页和列表页默认只向客户端发送文章摘要字段,减少 __NEXT_DATA__ 体积。
  • 文章页保留渲染所需 blockMap,同时清理 Notion 内部元数据。
  • latestPosts、上一篇/下一篇、推荐文章统一使用轻量摘要结构。
  • 新增 yarn perf:page-data,用于在构建后检查 page-data 是否超过默认 128KB 预算。
  • 批量优化多主题滚动监听,降低目录、进度条、浮动按钮等高频滚动场景的主线程压力。
  • Next、Endspace、Typography 等主题完成重点性能路径优化。

修复与回归保护

  • 保留 allLinkPages 链接解析路径,避免公告栏 type=notice 中指向 type=Page 的 Notion 内链重新退化为 404。
  • 新增 convertInnerUrl 回归测试,覆盖 raw Notion page id 到站内 Page 链接的转换。

文档

  • 更新 docs/user-guide/changelog/latest.md 到 4.10.0。
  • 在 docs/user-guide/deploy/build-tuning.md 增加 page-data 预算检查说明。
  • 同步用户指南、主题目录和性能阶段记录中的版本号。

验收

  • yarn -s type-check 通过。
  • yarn -s docs:site:build 通过。
  • yarn -s build 通过。
  • yarn -s perf:page-data 通过,overBudgetPages: 0。

说明:当前工作区直接运行 Jest 仍会被既有 canvas.node 原生绑定缺失问题阻塞;本次新增测试文件已通过 ESLint,并通过运行态脚本验证核心链接映射逻辑。