Skip to content

latest.md

Latest commit

 

History

History
500 lines (263 loc) · 20.3 KB

latest.md

File metadata and controls

500 lines (263 loc) · 20.3 KB

V4.9.5.2 - Latest

迁移自：V4.9.5.2 - Latest 发布日期：2025-10-11 最后编辑：2026-5-1 原栏目：✨ 更新日志 标签：NotionNext、Notion、更新历史

旧版异常更新提示

💡

由于Notion数据格式的变化，所有在 2026.4.2 之前部署的站点请升级至最新版本。

可以关注此页面，或项目讨论页获取最新动态：

https://docs.tangly1024.com/article/latest https://github.com/tangly1024/NotionNext/issues 💡

最新事件：2026.4.2 Notion再次更新了接口的数据格式，导致旧版站点不可用。NotionNext紧急发布4.9.3.2 版本修复。4.9.3.2伴随部分数据获取的bug，在4.9.4.2版本中修复。

过往事件 2026.2.7

2026.2.7，Notion官方调整了数据结构，导致旧版NotionNext数据异常，目前已恢复，Notion突然的升级，让我又掉了不少头发。 相关问题讨论：notionnext-org#3749

过往事件　2025.10.8

💡

由于NotionAPI的升级，建议所有在2025.10.11之前部署的站点都升级至4.9.2的最新版 事件：2025.10.08 , Notion官方api改动，导致所有旧版本的NotionNext站点无法部署。站长反馈站点出现大量的530API异常。 image.png

👉

完整的版本发布历史可关注Github页面：

https://github.com/tangly1024/NotionNext/releases

v4.9.5.2 - 2026.5.1

NotionNext v4.9.5.2 已发布 🎉

本次更新重点：性能基线、稳定性修复、协作文档规范化。

本次重点

  • 新增全主题性能审计：yarn perf:audit:themes

  • 首次提交生产模式全主题基线报告（LCP/CLS/SEO 等）

  • 修复多项运行时问题与警告（Hook、菜单 key、DOM props、Mermaid）

  • 优化构建/运行热路径与部分 CPU 开销

  • 补齐双语贡献文档与开发导航（含中文贡献入口）

对开发者的价值

  • 新主题开发可按统一性能准入流程验收

  • 性能问题可追踪、可对比、可持续改进

  • 新贡献者上手路径更清晰（脚本用途 + 双语文档）

版本信息

欢迎继续反馈与贡献 ❤️

v4.9.5.1 2026.4.30

新主题 fuwari 新主题 claude

NotionNext v4.9.5.1

本版本是一次较大范围的迭代，重点覆盖 新主题能力（Fuwari / Claude）、渲染与兼容性稳定性、站点生成链路健壮性 与 工程流程完善。相较 **v4.9.4.4**，本版本在主题体验统一性、跨场景兼容性与维护可控性方面有明显提升。

升级亮点总览

  • ✅ 完成 Fuwari 主题迁移与多轮体验打磨

  • ✅ 引入 Claude 主题（增量接入，不破坏现有主题体系）

  • ✅ 修复 Mermaid / Prism / Gitbook 深色模式 等高频反馈问题

  • ✅ 修复 站点封面、Sitemap、RSS 等关键基础能力

  • ✅ 增强 Issue 响应自动化 与评论系统兼容性

  • ✅ 版本升级至 4.9.5.1

详细变更

1. Fuwari 主题（迁移 + 交互完善）

1.1 主题迁移与发布

  • 完成 Fuwari 主题在 NotionNext 的适配迁移，建立主题基础布局与视觉体系。

  • 形成可持续迭代的配置与组件组织方式，为后续主题共性能力复用打基础。

1.2 移动端与导航交互优化

  • 优化移动端顶部栏布局，提升小屏设备可读性与触达效率。

  • 新增目录悬浮抽屉交互，改善文章内快速定位体验。

1.3 菜单与归档链路修复

  • 修复二级菜单交互问题（显示/点击路径更稳定）。

  • 优化归档跳转参数继承逻辑，减少路由切换时的状态丢失。

1.4 视觉与可用性细节

  • 调整主题调色板行为，减少切换时体验不一致。

  • 优化 analytics i18n 文案与 Hero 区域信息清晰度。

1.5 收尾与稳定性修正

  • 完成 Fuwari 阶段性收尾，补齐 TechGrow 模态行为问题。

  • 稳定 Contact Card 翻转表现，减少镜像/背面可读性问题。

2. Claude 主题引入（增量接入）

  • 新增 Claude 主题能力，采用增量接入策略，尽量避免影响既有主题。

  • 覆盖主题必要组件与数据链路说明，便于后续维护和二次开发。

注：Claude 主题后续还在相关 PR 中持续补充稳定性/安全性修复（例如菜单回退、刷新链路安全、README 渲染边界、文档整理等）。

3. Mermaid / Prism / Gitbook 相关稳定性

3.1 Mermaid 渲染生命周期修复

  • 修复主题切换后 Mermaid 需要强刷才能渲染的问题。

  • 改进多容器场景下 Mermaid 的扫描与绑定策略，提升动态页面稳定性。

3.2 Prism 作用域与主题兼容

  • 调整 Prism/Mermaid 的作用域定位逻辑，降低不同主题结构差异导致的误匹配或漏匹配。

3.3 Gitbook 深色模式配色协调

  • 优化移动端底部导航、抽屉层、目录与文章列表在 dark 模式下的配色一致性与可读性。

4. 核心能力修复（全站层）

4.1 首页封面回退逻辑修复

  • 修复数据库根页面场景下首页封面回退策略，补齐对 page_cover 优先链路的支持。

4.2 Proxio 导航回退修复

  • 在 CUSTOM_MENU 开启但自定义菜单为空时，保留默认导航回退，避免菜单整体消失。

4.3 Sitemap 生成健壮性提升

  • 跳过外部 slug，避免无效 URL 混入站点地图。

  • 增加非法日期兜底，防止 sitemap 输出异常时间值。

4.4 RSS 404 问题修复

  • 修复 RSS 页面生成/访问失败导致 404 的问题，增强 Notion 数据格式兼容。

5. 工程化与平台集成

5.1 自动化流程

  • 新增 Issue Response Bot 工作流，提高 issue 首次响应效率与规范化程度。

5.2 评论系统集成修复

  • 修复 Giscus Discussion 集成参数缺失（data-category、data-strict、crossOrigin）。

5.3 仓库清理与发布准备

  • 优化 .gitignore（包括本地临时目录与测试产物策略）。

  • 回填本地开发缓存与部分主题 UX 变更，减少遗落差异。

  • 修复 SEO 中无效字体 preload。

6. 版本变更

  • 版本号从 4.9.5.0 升级至 4.9.5.1。

PR 列表（按时间线）

  • #3961 feat(theme): 完成 fuwari 主题迁移并发布 v4.9.5.0

  • #3962 fix(fuwari): 优化移动端顶栏布局并新增目录悬浮抽屉

  • #3963 fix(fuwari): 修复二级菜单交互并优化归档跳转参数继承

  • #3964 fix(fuwari): refine palette behavior, analytics i18n, and hero clarity

  • #3967 feat(fuwari): finalize theme work and fix TechGrow modal behavior

  • #3965 Add automated Issue Response Bot GitHub Actions workflow

  • #3966 Fix Giscus GitHub Discussion integration

  • #3968 chore(gitignore): ignore local .tmp workspace directory

  • #3969 chore: backfill missed local dev cache and fuwari UX updates

  • #3970 fix(seo): remove invalid inter-var preload

  • #3971 fix(fuwari): stabilize contact card flip and prism scoping

  • #3972 fix(prism,gitbook): stabilize mermaid lifecycle and dark mode palette

  • #3973 fix(prism,gitbook): stabilize mermaid lifecycle and dark mode palette

  • #3825 Fix homepage site cover fallback for database root page

  • #3807 fix(proxio): keep fallback nav when custom menu is empty

  • #3806 fix(sitemap): skip external slugs and guard invalid dates

  • #3804 修复RSS页404报错

  • #3789 Claude 主题

  • #3975 chore(release): bump version to 4.9.5.1

New Contributors

感谢以下首次贡献者：

Full Changelog: v4.9.4.4...v4.9.5.1

v4.9.4.4 2026.4.29

这个版本重点围绕 稳定性、兼容性与协作体验：修复 Notion 数据结构兼容问题、增强多 Worker 构建稳定性、补齐外链与 TechGrow 行为一致性，并补充了更完善的开源协作文档。

✨ Highlights

  • Notion 兼容性增强

    • 修复新版 Notion heading 类型下的 TOC 解析异常
    • 修复 Notion data source/schema 解析与页面列表合并问题
    • 修复读取 Notion 列表时的数据窜读问题

  • 构建稳定性优化（并发场景）

    • 基于 #3906 的增强，补强 export 阶段 block prefetch 在多 Worker 环境下的协调行为，降低重复预热与超时退化风险

  • 安全与部署

    • 锁定 form-data resolution 到 ^4.0.4
    • 最小化引入 Netlify Next.js 兼容配置

  • 体验改进

    • 修复 heo 主题翻转卡片悬停状态异常
    • Notion 外链默认新标签页打开，并增加同源保护
    • 增强 TechGrow 兼容性，替代 OpenWrite 公众号解锁方案
    • 新增全局置顶标签排序（仅重排置顶子集，按最近更新时间倒序）

  • 文档与协作

    • 完善开源协作文档体系，并升级版本到 4.9.4.4

📦 What's Changed

  • Fix: 读取Notion列表窜数据 by @tangly1024 in notionnext-org#3932

  • Fix TOC parsing for newer Notion heading types. by @tangly1024 in notionnext-org#3946

  • 并发编译优化：基于 #3906 补强 export 阶段 block prefetch 的多 Worker 协调 by @88lin in notionnext-org#3919

  • security: pin form-data resolution to ^4.0.4 by @tangly1024 in notionnext-org#3952

  • Fix Notion data source schema parsing and page list merging. by @tangly1024 in notionnext-org#3953

  • fix: 修复 heo 主题交流频道翻转卡片悬停状态异常 by @88lin in notionnext-org#3871

  • fix(notion): open external article links in new tabs with same-origin safeguard by @tangly1024 in notionnext-org#3954

  • chore(netlify): 最小化引入 Netlify Next.js 兼容配置 by @tangly1024 in notionnext-org#3955

  • 增强 TechGrow 兼容性：替代OpenWrite公众号解锁方案 by @tangly1024 in notionnext-org#3956

  • feat: 新增全局置顶标签排序（仅重排置顶子集，按最近更新时间倒序） by @tangly1024 in notionnext-org#3959

  • docs: 完善开源协作文档体系并升级版本到 4.9.4.4 by @tangly1024 in notionnext-org#3960

🙌 New Contributors

Full Changelog: https://github.com/tangly1024/NotionNext/compare/v4.9.4.2...v4.9.4.4

V4.9.4.2 2026.4.5

  • 针对 4.9.3.2 - 4.9.4 版本中，为了兼容Notion数据格式变动，而产生的新bug进行修复；

  • 修复 由于循环获取数据，导致API超频调用 Too Many Requests 429的问题，同时导致部分文章数据丢失的问题。

  • 构建模式调整

    1. 默认改为 ISR（fallback: 'blocking'），并且最多预存首页文章与最新文章（不超过10篇），控制编译打包时长。
    2. 仅纯静态部署方案使用全量SSG。

V4.9.4 2026.4.2

  • 将 react-notion-x/notion-utils 组件升级至 7.10.0 版本，修复页面部分样式丢失的问题

V4.9.3.2 2026.4.2

What's Changed

image

Full Changelog: v4.9.3...v4.9.3.2

V4.9.3** 2026.2.8**

image

  • 修复Notion数据更新导致的站点部署异常，数据显示异常等bug

  • 在文章分享区增加了CSDN和稀土掘金的选项 by @DalnyEFZ in #3691

  • 修复了Next主题无法解密邮件地址 by @KZaqur in #3709

New Contributors

Full Changelog: v4.9.2...v4.9.3

V4.9.2

  • 2025.10.11 : NotionNext跟随 notion-react-x 补丁，发布4.9.2版本，修复notion-api异常，不再需要额外添加api_base_url进行过度。

  • 升级notion-react-x 核心依赖，修复notion-api异常 ，并使网页样式更加贴近Notion Release/4.9.2 by @tangly1024 in notionnext-org#3656

Full Changelog: https://github.com/tangly1024/NotionNext/compare/v4.9.1...v4.9.2

v4.9.1** **

  • 2025.10.09 : 发布紧急补丁版本4.9.1，支持用户配置自定义接口域名，暂时让站点能够使用。

  • 版本 4.9.1，临时用api_base_url方案处理接口异常。 by @tangly1024 in notionnext-org#3637

What's Changed

重要

由于NotionAPI的调整，增加了一些打包限流的补丁功能

Full Changelog: V4.9.0...v4.9.1

原文链接

https://docs.tangly1024.com/article/latest