v4.10.10

v4.10.10

这是一次小版本维护发布，收录 v4.10.9 之后的近期主线改动。普通站点同步最新 main 后重新部署即可；只有需要内嵌子页面层级 URL 的站点，才需要新增可选配置。

Notion 内嵌子页面 URL

• 新增可选配置，推荐在 Notion Config 中添加 INNER_PAGE_URL_PARENT_PATH=true。
• 也可以在部署平台添加 NEXT_PUBLIC_INNER_PAGE_URL_PARENT_PATH=true。开启后，未收录到数据库的 Notion 内嵌子页面 URL 会跟随当前文章路径，例如 /article/fpga-studying-notes/{pageId}。
• 已收录到 NotionNext 数据库、并拥有明确 slug / href 的页面仍优先跳转自己的正式地址，避免影响 sitemap、RSS、站内搜索和旧链接兼容。
• 该能力只优化访问路径和层级表达；未收录子页面不会因此自动进入 sitemap、RSS 或搜索索引。需要 SEO 收录的页面仍建议加入主数据库并配置明确 slug。

使用方法：

1. 推荐在 Notion Config 配置中心添加：

   Key:   INNER_PAGE_URL_PARENT_PATH
   Value: true

2. 保存配置后重新部署，或等待站点重新读取配置。

3. 也可以在 Vercel / Netlify / Cloudflare Pages / Docker 环境变量中添加 NEXT_PUBLIC_INNER_PAGE_URL_PARENT_PATH=true 后重新部署。

4. 打开含内嵌子页面的文章，未收录子页面链接会显示为 当前文章路径/{pageId}。

文档：

• URL 自定义：内嵌子页面跟随父路径：https://notionnext.tangly1024.com/user-guide/config/url-customize
• 升级提示：https://notionnext.tangly1024.com/user-guide/update
• 最新更新日志：https://notionnext.tangly1024.com/user-guide/changelog/latest

阅读与主题体验

• 修复静态分享 SVG 被 Next/Image 优化导致的显示风险，分享图标继续按静态资源方式加载。
• Magzine 主题恢复文章页广告与侧栏间距，避免正文和广告区域贴得过近。
• 主题设置抽屉增加更顺滑的动效反馈。
• XuHome 主题完成主线集成，并补充深色模式对比度与调色板实时生效修复。
• NotionTabs 支持 keep-alive 行为，切换标签时可保留已渲染内容状态。
• Callout 嵌套子块和无图标 Callout 渲染更稳定。

相关文档：

• 主题目录：https://notionnext.tangly1024.com/user-guide/themes/THEMES_CATALOG
• Magzine 主题：https://notionnext.tangly1024.com/user-guide/themes/magzine
• 代码样式与侧栏预览：https://notionnext.tangly1024.com/user-guide/config/notion-next-code-style

部署与依赖

• 继续跟进依赖维护和安全更新，包括 Next.js、Supabase、Vercel Functions 及开发依赖组。
• Notion 图片浏览器缓存和 Cloudflare 文档继续保持在新版手册中，方便站长按需配置。

相关文档：

• 部署指南索引：https://notionnext.tangly1024.com/user-guide/deploy/
• Notion 图片反代与缓存：https://notionnext.tangly1024.com/user-guide/deploy/notion-image-proxy

验证

• node package version check: 4.10.10
• yarn jest __tests__/lib/db/notion/convertInnerUrl.test.js --runInBand
• yarn docs:site:build
• PR #4421 checks: CI, CodeQL, VitePress build, Vercel preview, Docker build all passed
• PR #4422 added Notion Config usage docs and config coverage
• PR #4423 cleaned the Notion Config usage layout

完整变更：v4.10.9...v4.10.10