Skip to content

v4.11.0

Latest
Latest

Choose a tag to compare

View all tags
@tangly1024 tangly1024 released this 14 Oct 08:45
v4.11.0
03d652c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v4.11.0

4.11.0 收录 v4.10.10 之后的主线改动（约 180 个提交）。其中有两项不兼容变更（缓存维护接口、Notion OAuth 授权入口），升级前请先阅读下面的「升级须知」；其余普通站点同步最新 main 后重新部署即可。

升级须知（请先阅读）

  1. 缓存维护接口需要令牌（不兼容）：/api/cache 必须配置 CACHE_REVALIDATION_TOKEN 并携带 Authorization: Bearer <令牌>；未配置时返回 HTTP 503，不再允许无令牌清理缓存。已有的维护脚本需补充环境变量和请求头。详见 数据缓存与页面重建。
  2. Notion OAuth 授权入口变更（不兼容）：升级后必须从本站 /api/auth/notion 发起授权；旧的直接携带 code 访问回调的方式不再接受。详见 Notion OAuth 授权入口。
  3. Notion 图片：新版 Notion 接口返回的 file.notion.com 图片链接已适配图片反代和签名刷新，之前为解决图片过期而临时设置 API_BASE_URL=https://www.notion.so/api/v3 的站点，升级后不再需要该设置。外链（http/https）图片现在也会经 NEXT_PUBLIC_NOTION_HOST 的图片中转端点加载，使用自定义反代地址的站点请确认中转端可用。
  4. 字体：默认不再加载 Noto Sans SC、Noto Serif SC 等第三方中文 Web Font，未配置自定义字体的站点会改用系统字体，外观会有变化。需要品牌字体请显式配置 NEXT_PUBLIC_FONT_URL（或 Notion Config 的 FONT_URL）。
  5. 非本站工作区的页面会返回 404：通过页面 id 兜底渲染时会校验页面是否属于本站 Notion 工作区，工作区 id 默认自动推导，也可用 NOTION_WORKSPACE_ID 指定（多站点用逗号分隔）。见 NOTION_WORKSPACE_ID。
  6. 访问统计默认端点：不蒜子默认脚本已切换为社区维护的 Vercount（https://events.vercount.one/js），可用 NEXT_PUBLIC_BUSUANZI_SCRIPT_URL 覆盖。见 不蒜子统计。

图片与 Notion 数据

  • 恢复 NEXT_PUBLIC_NOTION_HOST 图片反代与签名刷新，适配 file.notion.com 新图片 CDN（#4476、#4473）。
  • 外链图片经图片中转端点加载，避免防盗链图床拒绝带本站 Referer 的请求；反代图片支持高清缩放与随机图替换。
  • 数据库的 Created time / Last edited time 系统属性不再丢失；嵌套 Gallery 视图设置、Gallery 单列显示问题已修复。
  • 内嵌页面链接解析会先去掉 query 与 hash 再提取页面 ID。

使用方法见 Notion 图片反代与缓存。

安全与接口

  • /api/revalidate 的单页请求默认只重建指定页；清理数据须显式传入 invalidateData: true，全站请求使用 all: true。批量重建默认每次最多 25 页，HTTP 202 返回剩余路径供调用方续传。多实例或 Serverless 部署要实现同步失效，必须配置所有实例共用的 Redis。
  • Notion OAuth 改为服务端授权流程：授权结果不再携带原始 token 或用户资料进入 URL、页面 props 和日志，回调绑定授权发起时的随机 state cookie。
  • 修复任意公开 Notion 块 id 可被渲染到本站域名下的问题（见升级须知 5）。
  • Mailchimp 订阅结果处理、Algolia 搜索请求生命周期的问题已修复；依赖安全审计补丁已合入。

新功能与可选配置

  • PWA 安装入口：新增可选配置 PWA_ENABLE=true，开启后 Android Chrome 可将博客安装到桌面；主题色可通过 PWA_THEME_COLOR 配置，manifest 使用固定路径 /manifest.json；默认关闭，不影响未开启站点。使用方法见 PWA 安装入口。
  • NotionNext Content MCP（可选）：内置零依赖 MCP 服务器，让 Claude Code、Codex、Cursor 等 AI 助手按 NotionNext 数据契约管理 Notion 内容。见 NotionNext Content MCP。
  • RSS 可通过 RSS_FULL_CONTENT=false 只输出摘要（默认仍输出全文）。
  • 多个主题新增 CSDN、稀土掘金联系入口（NEXT_PUBLIC_CONTACT_CSDN、NEXT_PUBLIC_CONTACT_JUEJIN）；公告改用 Notion 页面标题；simple 主题页头页脚新增站点访问统计；统计卡片改用站点 PV，与页脚口径一致。

主题

  • opc：首页围绕任务流水线重做，归档卡片与新手引导优化。
  • Proxio：侧栏目录与加锁文章显示。
  • Fuwari：NotionComments 评论、FUWARI_HERO_ENABLE 关闭 Hero 后的布局、移动端菜单、按页面隐藏侧栏、搜索页改进。
  • heo：昼夜切换、控件与评论、回弹背景修复。
  • XuHome 同步上游目录与音频更新；Magzine 封面间距；starter 导航栏 hover 配色；hero 打字脚本初始化时机。

部署与依赖

  • 依赖更新：next 15.5.27、notion-client / notion-utils / react-notion-x 7.12.1，以及一批 patch / minor 更新。
  • 仓库地址已迁移到 notionnext-org/NotionNext，文档与配置中的旧地址已清理。
  • Vercel 保留 html 站点验证 URL。

升级说明

  • 普通 Vercel / Netlify / Cloudflare Pages / Docker 站点：先阅读上面的「升级须知」，同步最新 main 后重新部署即可。
  • 如果你有调用 /api/cache 或 /api/revalidate 的脚本、或使用 Notion OAuth 授权，必须按升级须知调整。
  • 如果你依赖 Docker 镜像，请等待本版本 GitHub Release 对应的 GHCR 镜像发布完成后再拉取。

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

Assets 2
Loading