v4.9.5.2

NotionNext v4.9.5.2

本版本重点聚焦三件事：性能基线建立、运行时稳定性修复、协作规范完善。
适合准备长期维护或扩展新主题的团队升级。

亮点更新

1) 全主题性能基线（生产模式）

• 新增全主题审计命令：yarn perf:audit:themes
• 审计结果落库并可追踪：
  • docs/performance/theme-audit-latest.md
  • docs/performance/theme-audit-latest.json
• 在 DEVELOPMENT.md 新增“新主题性能准入”流程，后续主题开发可按统一标准验收（LCP/CLS/SEO 等）。

2) 运行时稳定性修复

• 修复 Invalid hook call 等关键运行时问题。
• 修复部分主题中的 React 警告：
  • 列表 key 警告
  • 非法 DOM prop 透传警告
  • defaultProps 兼容性警告
• 修复 Mermaid 渲染相关回归与深色模式视觉一致性问题。

3) 低风险性能优化（高性价比）

• 优化构建与运行热路径，降低不必要 CPU 开销。
• 首页预览数据读取策略优化（并发与范围控制）。
• 优化缓存热路径判断逻辑。
• 减少不必要重依赖开销，补充主题预览图 WebP 资源流程。
• 增强图片加载降级策略，提升复杂图源场景稳定性。

4) 文档与协作体验升级

• 项目文档导航补齐双语入口（中文/英文）。
• 新增中文贡献文档：CONTRIBUTING.zh-CN.md
• package.json 脚本在开发文档中补齐用途说明，方便新贡献者快速上手。
• 版本号更新至 4.9.5.2。

What's Changed

• chore(theme-preview): add claude preview image by @tangly1024 in #3974
• chore(ci): align Yarn version for Cloudflare builds by @tangly1024 in #3976
• chore(ci): standardize Yarn-first developer workflow by @tangly1024 in #3979
• chore(config): tune Node engine range and root guidance by @tangly1024 in #3980
• feat: 优化代码折叠逻辑，引入行数阈值检测与极简 S1 UI by @RHZHZ in #3767
• perf: 全主题性能基线、运行时修复与低风险优化 by @tangly1024 in #3981

New Contributors

• @RHZHZ made their first contribution in #3767

Full Changelog: v4.9.5.1...v4.9.5.2

v4.9.5.1

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 的适配迁移，建立主题基础布局与视觉体系。
• 形成可持续迭代的配置与组件组织方式，为后续主题共性能力复用打基础。
  • PR: #3961

1.2 移动端与导航交互优化

• 优化移动端顶部栏布局，提升小屏设备可读性与触达效率。
• 新增目录悬浮抽屉交互，改善文章内快速定位体验。
  • PR: #3962

1.3 菜单与归档链路修复

• 修复二级菜单交互问题（显示/点击路径更稳定）。
• 优化归档跳转参数继承逻辑，减少路由切换时的状态丢失。
  • PR: #3963

1.4 视觉与可用性细节

• 调整主题调色板行为，减少切换时体验不一致。
• 优化 analytics i18n 文案与 Hero 区域信息清晰度。
  • PR: #3964

1.5 收尾与稳定性修正

• 完成 Fuwari 阶段性收尾，补齐 TechGrow 模态行为问题。
• 稳定 Contact Card 翻转表现，减少镜像/背面可读性问题。
  • PR: #3967
  • PR: #3971

---

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

• 新增 Claude 主题能力，采用增量接入策略，尽量避免影响既有主题。
• 覆盖主题必要组件与数据链路说明，便于后续维护和二次开发。
  • PR: #3789

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

---

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

3.1 Mermaid 渲染生命周期修复

• 修复主题切换后 Mermaid 需要强刷才能渲染的问题。
• 改进多容器场景下 Mermaid 的扫描与绑定策略，提升动态页面稳定性。

3.2 Prism 作用域与主题兼容

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

3.3 Gitbook 深色模式配色协调

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

---

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

4.1 首页封面回退逻辑修复

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

4.2 Proxio 导航回退修复

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

4.3 Sitemap 生成健壮性提升

• 跳过外部 slug，避免无效 URL 混入站点地图。
• 增加非法日期兜底，防止 sitemap 输出异常时间值。
  • PR: #3806

4.4 RSS 404 问题修复

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

---

5. 工程化与平台集成

5.1 自动化流程

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

5.2 评论系统集成修复

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

5.3 仓库清理与发布准备

• 优化 .gitignore（包括本地临时目录与测试产物策略）。
• 回填本地开发缓存与部分主题 UX 变更，减少遗落差异。
• 修复 SEO 中无效字体 preload。
  • PR: #3968
  • PR: #3969
  • PR: #3970

---

6. 版本变更

• 版本号从 4.9.5.0 升级至 4.9.5.1。
  • PR: #3975

---

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

感谢以下首次贡献者：

• @Copilot in #3965
• @yunhe-dev in #3825
• @qianzhu18 in #3807
• @lyizhuo in #3804
• @HiderX in #3789

---

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

v4.9.4.4

NotionNext v4.9.4.4

这个版本重点围绕 稳定性、兼容性与协作体验：修复 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 #3932
• Fix TOC parsing for newer Notion heading types. by @tangly1024 in #3946
• 并发编译优化：基于 #3906 补强 export 阶段 block prefetch 的多 Worker 协调 by @88lin in #3919
• security: pin form-data resolution to ^4.0.4 by @tangly1024 in #3952
• Fix Notion data source schema parsing and page list merging. by @tangly1024 in #3953
• fix: 修复 heo 主题交流频道翻转卡片悬停状态异常 by @88lin in #3871
• fix(notion): open external article links in new tabs with same-origin safeguard by @tangly1024 in #3954
• chore(netlify): 最小化引入 Netlify Next.js 兼容配置 by @tangly1024 in #3955
• 增强 TechGrow 兼容性：替代OpenWrite公众号解锁方案 by @tangly1024 in #3956
• feat: 新增全局置顶标签排序（仅重排置顶子集，按最近更新时间倒序） by @tangly1024 in #3959
• docs: 完善开源协作文档体系并升级版本到 4.9.4.4 by @tangly1024 in #3960

---

🙌 New Contributors

• @88lin made their first contribution in #3919

---

Full Changelog: v4.9.4.2...v4.9.4.4

V4.9.5.0

What's Changed

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

Full Changelog: v4.9.4.4...v4,9.5.0

V4.9.4.2

What's Changed

• Normalize build and compilation speed by @tangly1024 in #3898
• fixbuild by @tangly1024 in #3899
• 构建模式调整 by @tangly1024 in #3904

Full Changelog: v4.9.4.1...v4.9.4.2

v4.9.4.1

What's Changed

• 临时处理 429 Too Many Request 问题
• 升级notion-utils-7.10.0 by @tangly1024 in #3887
• Release/4.9.4.1 by @tangly1024 in #3897

Full Changelog: v4.9.4...v4.9.4.1

V4.9.4

• 升级Notion-Utils 至7.10.0 版本
  Full Changelog: v4.9.3.2...v4.9.4

V4.9.3.2

What's Changed

• hotfix： 兼容NOTION_API升级 by @tangly1024 in #3746
• log by @tangly1024 in #3747
• 保证编译通过 by @tangly1024 in #3748
• Release/4.9.2.1 by @tangly1024 in #3752
• 修復clerk 無法編譯 by @tangly1024 in #3753
• Release/4.9.3 by @tangly1024 in #3757
• 页面url转换bug by @tangly1024 in #3771
• 文章路由错乱bug by @tangly1024 in #3802
• 英雄区副文章数量 by @tanglyqq in #3870
• 修复由于Notion数据格式改变导致的编译异常 by @tanglyqq in #3883 @tangly1024 in #3884

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

V4.9.3

What's Changed

• 修复Notion数据更新导致的站点部署异常，数据显示异常等bug
• 在文章分享区增加了CSDN和稀土掘金的选项 by @DalnyEFZ in #3691
• 修复了Next主题无法解密邮件地址 by @KZaqur in #3709

New Contributors

• @DalnyEFZ made their first contribution in #3691
• @KZaqur made their first contribution in #3709

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

V4.9.2

What's Changed

• 升级notion-react-x 核心依赖，修复notion-api异常 ， Release/4.9.2 by @tangly1024 in #3656
• 版本 4.9.1，临时用api_base_url方案处理接口异常。 by @tangly1024 in #3637

Full Changelog: v4.9.1...v4.9.2