docs(deploy): add EdgeOne Pages guide for Node version and ENOSPC (notionnext-org#4014)

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: t

.vitepress/config.mts

@@ -70,6 +70,7 @@ export default defineConfig({
             { text: 'Vercel 静态导出', link: '/user-guide/deploy/vercel-static' },
             { text: 'Cloudflare 文档站', link: '/user-guide/deploy/cloudflare-pages-docs' },
             { text: 'Cloudflare 博客静态', link: '/user-guide/deploy/cloudflare-pages' },
+            { text: 'EdgeOne Pages', link: '/user-guide/deploy/edgeone-pages' },
             { text: '构建性能调优', link: '/user-guide/deploy/build-tuning' },
             { text: 'Netlify', link: '/user-guide/deploy/netlify' },
             { text: 'VPS', link: '/user-guide/deploy/vps' }

docs/user-guide/deploy/edgeone-pages.md

@@ -0,0 +1,45 @@
+# 腾讯云 EdgeOne Pages 部署
+
+> 完整排错见仓库 [DEPLOYMENT.md · EdgeOne Pages](https://github.com/notionnext-org/NotionNext/blob/main/DEPLOYMENT.md#腾讯云-edgeone-pages)
+
+## 环境要求
+
+| 项 | 说明 |
+| --- | --- |
+| Node | 与仓库根目录 **`.nvmrc` 完全一致**（当前为 `20.18.0`） |
+| 包管理 | `yarn install` → `yarn build` 或 `yarn export` |
+| 必配变量 | `NOTION_PAGE_ID` 等（见 [配置站点](../config-site.md)） |
+
+EdgeOne 会按 `.nvmrc` 切换 Node。若日志出现 **`Failed to switch to Node.js 20.20.0`** 等，说明仓库过旧或控制台所选版本与 `.nvmrc` 不一致——请拉取最新 `main`，并在 **项目设置 → Node.js 版本** 中选择与 `.nvmrc` 相同的补丁号（如 `20.18.0`）。
+
+## 推荐：框架预设「Next SSG」
+
+部分用户在默认 Pages 构建流程下，Node 切换成功后会在 `yarn install` 阶段遇到 **`ENOSPC: no space left on device`**（构建机 `/dev/shm` 或磁盘不足）。
+
+若出现该情况，可在 EdgeOne 控制台尝试将**框架预设**改为 **Next SSG**（或平台提供的 Next 静态导出类预设）后重新部署。该方式通常由平台优化安装与构建路径，占用更小，社区反馈可成功完成部署。
+
+仍失败时请结合下方 ENOSPC 小节与 [构建性能调优](./build-tuning.md)。
+
+## `yarn install` 报 ENOSPC
+
+日志中若已有 **`Now, we're on node version v20.18.0`**，则 Node 版本已正常，失败原因是**构建机空间不足**，与 NotionNext 代码无关。
+
+可尝试（按顺序）：
+
+1. 改用上文 **Next SSG** 预设，或关闭「依赖/构建缓存」后无缓存重构建一次  
+2. 向 EdgeOne / 腾讯云工单说明 `yarn install` 阶段 ENOSPC，询问构建盘配额  
+3. 若平台支持，设置 `YARN_CACHE_FOLDER` 到空间更大的路径（以官方文档为准）  
+4. 在 GitHub Actions 等环境完成 `yarn build` / `yarn export`，仅将静态产物同步到 EdgeOne 托管
+
+## 构建超时
+
+Notion 拉取慢导致单页超时，请参阅 **[构建性能调优](./build-tuning.md)**，例如：
+
+```env
+BUILD_PREFETCH_ENABLED=false
+STATIC_PAGE_GENERATION_TIMEOUT=600
+```
+
+## 相关 Issue
+
+- [#4014](https://github.com/notionnext-org/NotionNext/issues/4014) — EdgeOne Node 版本与 ENOSPC 排错（已在 `main` 将 `.nvmrc` 对齐 `20.18.0`）

docs/user-guide/deploy/index.md

@@ -19,6 +19,7 @@
 | [vercel-redeploy.md](./vercel-redeploy.md) | 重新部署 |
 | [netlify.md](./netlify.md) | Netlify（4.0.9+） |
 | [cloudflare-pages.md](./cloudflare-pages.md) | Cloudflare 静态 |
+| [edgeone-pages.md](./edgeone-pages.md) | **腾讯云 EdgeOne**（Node 版本、ENOSPC、Next SSG 预设） |
 | [build-tuning.md](./build-tuning.md) | **构建超时 / Notion 预热与限流**（环境变量） |
 | [vps.md](./vps.md) | VPS / Docker（Node 20+） |
 
@@ -32,6 +33,6 @@
 - **Yarn**：`yarn` → `yarn build` / `yarn export`
 - 必配：`NOTION_PAGE_ID`
 
-## EdgeOne / 构建缓存
+## EdgeOne
 
-构建时若 `.next/cache` 不可写，项目会回退系统临时目录（Netlify 等）。见上游 PR #4046 与 `lib/cache/build_session.js`。
+Node 版本、磁盘 `ENOSPC`、框架预设 **Next SSG** 等见 **[edgeone-pages.md](./edgeone-pages.md)**。构建时若 `.next/cache` 不可写，项目会回退系统临时目录，见 `lib/cache/build_session.js`。