docs: publish v4.10.10 release notes (#4421)

Author: tangly1024

docs/user-guide/changelog/latest.md

@@ -1,6 +1,54 @@
 # 最新版本与更新日志
 
-> 当前主线：**4.10.9**（见根目录 `package.json`）
+> 当前主线：**4.10.10**（见根目录 `package.json`）
+
+## 4.10.10 发布要点
+
+`4.10.10` 是一次小版本维护发布，集中收录 `v4.10.9` 之后的近期主线改动。普通站点同步最新 `main` 后重新部署即可；只有需要内嵌子页面层级 URL 的站点，才需要新增可选环境变量。
+
+### Notion 内嵌子页面 URL
+
+- 新增可选配置 `NEXT_PUBLIC_INNER_PAGE_URL_PARENT_PATH=true`，让未收录到数据库的 Notion 内嵌子页面 URL 跟随当前文章路径，例如 `/article/fpga-studying-notes/{pageId}`。
+- 已收录到 NotionNext 数据库、并拥有明确 `slug / href` 的页面仍优先跳转自己的正式地址，避免影响 sitemap、RSS、站内搜索和旧链接兼容。
+- 该能力只优化访问路径和层级表达；未收录子页面不会因此自动进入 sitemap、RSS 或搜索索引。需要 SEO 收录的页面仍建议加入主数据库并配置明确 `slug`。
+
+使用方法见 [URL 自定义：内嵌子页面跟随父路径](../config/url-customize.md#内嵌子页面跟随父路径)。
+
+### 阅读与主题体验
+
+- 修复静态分享 SVG 被 Next/Image 优化导致的显示风险，分享图标继续按静态资源方式加载。
+- Magzine 主题恢复文章页广告与侧栏间距，避免正文和广告区域贴得过近。
+- 主题设置抽屉增加更顺滑的动效反馈。
+- XuHome 主题完成主线集成，并补充深色模式对比度与调色板实时生效修复。
+- NotionTabs 支持 keep-alive 行为，切换标签时可保留已渲染内容状态。
+- Callout 嵌套子块和无图标 Callout 渲染更稳定。
+
+相关文档：
+
+- [主题目录](../themes/THEMES_CATALOG.md)
+- [Magzine 主题](../themes/magzine.md)
+- [代码样式与侧栏预览](../config/notion-next-code-style.md)
+
+### 部署与依赖
+
+- 继续跟进依赖维护和安全更新，包括 Next.js、Supabase、Vercel Functions 及开发依赖组。
+- Notion 图片浏览器缓存和 Cloudflare 文档继续保持在新版手册中，方便站长按需配置。
+
+相关文档：
+
+- [部署指南索引](../deploy/index.md)
+- [Notion 图片反代与缓存](../deploy/notion-image-proxy.md)
+
+### 升级说明
+
+- 普通 Vercel / Netlify / Cloudflare Pages / Docker 站点：同步最新 `main` 后重新部署即可。
+- 如果要启用内嵌子页面父路径 URL，在部署平台添加 `NEXT_PUBLIC_INNER_PAGE_URL_PARENT_PATH=true` 后重新部署。
+- 如果你依赖 Docker 镜像，请等待本版本 GitHub Release 对应的 GHCR 镜像发布完成后再拉取。
+
+### GitHub Release
+
+- Release：[v4.10.10](https://github.com/notionnext-org/NotionNext/releases/tag/v4.10.10)
+- 完整变更：[v4.10.9...v4.10.10](https://github.com/notionnext-org/NotionNext/compare/v4.10.9...v4.10.10)
 
 ## 4.10.9 发布要点
 

docs/user-guide/config/url-customize.md

@@ -103,6 +103,10 @@ POST_URL_PREFIX 配置为： `%category%/%year%/%month%/%day%`
 
 ## 内嵌子页面跟随父路径
 
+::: tip 4.10.10 更新
+该能力从 `4.10.10` 起提供，默认关闭。只有希望未收录的 Notion 内嵌子页面 URL 跟随父级文章路径时，才需要开启。
+:::
+
 Notion 页面中可以继续嵌套子页面。默认情况下，NotionNext 会优先把能在站点数据库中找到的内页链接转换为该页面自己的 `slug`；如果子页面没有收录到数据库中，则会保留 Notion 页面 ID 作为兜底地址。
 
 如果希望未收录的内嵌子页面 URL 也体现父级文章层级，可以开启：

docs/user-guide/themes/THEMES_CATALOG.md

@@ -1,6 +1,6 @@
 # 内置主题全览（27 个）
 
-> 与 `themes/` 目录及 `conf/themeSwitch.manifest.js` 同步 · 当前版本 **4.10.9**
+> 与 `themes/` 目录及 `conf/themeSwitch.manifest.js` 同步 · 当前版本 **4.10.10**
 > 先按站点目标选主题，再进入单个主题文档看配置。
 
 预览：`https://preview.tangly1024.com/?theme=<id>`（`id` 为下表主题 ID，小写）。
@@ -33,6 +33,12 @@
 
 部署成功后再换主题也可以，主题 ID 改完重新部署即可。
 
+## 4.10.10 主题体验修复
+
+- Magzine：恢复文章页广告与侧栏间距，避免正文和广告区域贴得过近。
+- 主题设置抽屉：增加更顺滑的动效反馈，打开和关闭时更自然。
+- XuHome：完成主线集成，并补充深色模式对比度与调色板实时生效修复。
+
 ## 4.10.9 主题体验修复
 
 - Matery：优化移动端文章标题、标签换行和正文页间距。

docs/user-guide/themes/magzine.md

@@ -13,6 +13,10 @@
 新主题，需要升级到V4.7.1之后的版本才能使用
 :::
 
+::: tip 4.10.10 更新
+文章页广告与右侧栏间距已恢复，升级到 `4.10.10` 后同步最新代码并重新部署即可，无需新增配置。
+:::
+
 ![桌面端](/legacy/e5089e1db6109fc0.png)
 ![移动端](/legacy/aa0f0b759ff50dec.png)
 

docs/user-guide/update.md

@@ -42,6 +42,20 @@
 
 NotionNext教程
 
+## 4.10.10 升级提示
+
+`4.10.10` 是一次小版本维护发布。普通站点同步最新 `main` 后重新部署即可，不需要新增必填环境变量。
+
+如果你希望 Notion 文章中的未收录内嵌子页面 URL 跟随父级文章路径，可以在部署平台添加：
+
+```bash
+NEXT_PUBLIC_INNER_PAGE_URL_PARENT_PATH=true
+```
+
+开启后，文章 `/article/fpga-studying-notes` 中未收录的子页面链接会显示为 `/article/fpga-studying-notes/{pageId}`。已收录到数据库并配置了 `slug` 的页面仍优先使用自己的正式地址。
+
+使用说明见 [URL 自定义：内嵌子页面跟随父路径](./config/url-customize.md#内嵌子页面跟随父路径)，完整发布说明见 [最新版本更新日志](./changelog/latest.md)。
+
 ## 4.10.9 升级提示
 
 `4.10.9` 是一次小版本维护发布。普通站点同步最新 `main` 后重新部署即可，不需要新增必填环境变量。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "notion-next",
-  "version": "4.10.9",
+  "version": "4.10.10",
   "packageManager": "yarn@1.22.22",
   "homepage": "https://github.com/tangly1024/NotionNext.git",
   "license": "MIT",