diff --git a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/01-installation.mdx b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/01-installation.mdx
index 8af0dbae..affe04e2 100644
--- a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/01-installation.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/01-installation.mdx
@@ -1,23 +1,23 @@
 ---
-source-updated-at: '2025-05-16T04:52:11.000Z'
-translation-updated-at: '2025-05-17T02:12:53.432Z'
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:18:02.138Z
 title: 如何新建 Next.js 项目
 nav_title: 安装指南
 description: 使用 `create-next-app` CLI 创建新的 Next.js 应用，并配置 TypeScript、ESLint 和模块路径别名。
 ---
 
-{/* 本文档内容在应用路由和页面路由间共享。可使用 `<PagesOnly>内容</PagesOnly>` 组件添加仅适用于页面路由的内容。任何共享内容不应包裹在组件中。*/}
+{/* 本文档内容在应用路由和页面路由间共享。如需添加仅适用于页面路由的内容，可使用 `<PagesOnly>内容</PagesOnly>` 组件。共享内容不应包裹在任何组件中。*/}
 
 ## 系统要求
 
 开始前请确保系统满足以下要求：
 
 - [Node.js 18.18](https://nodejs.org/) 或更高版本
-- macOS、Windows（含 WSL）或 Linux
+- macOS、Windows（含 WSL）或 Linux 系统
 
 ## 自动安装
 
-创建 Next.js 应用最快的方式是使用 [`create-next-app`](/docs/app/api-reference/cli/create-next-app)，它会自动完成所有设置。运行以下命令创建项目：
+创建 Next.js 应用最快的方式是使用 [`create-next-app`](/docs/app/api-reference/cli/create-next-app)，它会自动完成所有配置。运行以下命令创建项目：
 
 ```bash filename="终端"
 npx create-next-app@latest
@@ -26,18 +26,18 @@ npx create-next-app@latest
 安装过程中会看到以下提示：
 
 ```txt filename="终端"
-项目名称是什么？my-app
+请输入项目名称？my-app
 是否使用 TypeScript？否 / 是
 是否使用 ESLint？否 / 是
 是否使用 Tailwind CSS？否 / 是
-是否将代码放在 `src/` 目录中？否 / 是
-是否使用 App Router？（推荐）否 / 是
+是否将代码放在 `src/` 目录下？否 / 是
+是否使用应用路由（推荐）？否 / 是
 是否在 `next dev` 中使用 Turbopack？否 / 是
 是否自定义导入别名（默认为 `@/*`）？否 / 是
-要配置什么导入别名？@/*
+请输入配置的导入别名？@/*
 ```
 
-完成提示后，[`create-next-app`](/docs/app/api-reference/cli/create-next-app) 会创建以项目名命名的文件夹并安装所需依赖。
+完成提示后，[`create-next-app`](/docs/app/api-reference/cli/create-next-app) 会创建项目文件夹并安装所需依赖。
 
 ## 手动安装
 
@@ -65,7 +65,7 @@ npm install next@latest react@latest react-dom@latest
 - `next dev`：启动开发服务器
 - `next build`：构建生产环境应用
 - `next start`：启动生产服务器
-- `next lint`：运行 ESLint
+- `next lint`：运行 ESLint 检查
 
 <AppOnly>
 
@@ -103,20 +103,20 @@ export default function RootLayout({ children }) {
 
 ```tsx filename="app/page.tsx" switcher
 export default function Page() {
-  return <h1>Hello, Next.js!</h1>
+  return <h1>你好，Next.js！</h1>
 }
 ```
 
 ```jsx filename="app/page.js" switcher
 export default function Page() {
-  return <h1>Hello, Next.js!</h1>
+  return <h1>你好，Next.js！</h1>
 }
 ```
 
-当用户访问应用根路径 (`/`) 时，`layout.tsx` 和 `page.tsx` 会被渲染。
+当用户访问应用根路径 (`/`) 时，`layout.tsx` 和 `page.tsx` 将同时渲染。
 
 <Image
-  alt="App 文件夹结构"
+  alt="应用目录结构"
   srcLight="/docs/light/app-getting-started.png"
   srcDark="/docs/dark/app-getting-started.png"
   width="1600"
@@ -125,8 +125,8 @@ export default function Page() {
 
 > **须知**：
 >
-> - 如果忘记创建根布局，运行 `next dev` 启动开发服务器时 Next.js 会自动创建该文件
-> - 可选择在项目根目录使用 [`src` 文件夹](/docs/app/api-reference/file-conventions/src-folder) 来分离应用代码和配置文件
+> - 如果忘记创建根布局，运行 `next dev` 启动开发服务器时 Next.js 会自动生成
+> - 可选择使用项目根目录下的 [`src` 文件夹](/docs/app/api-reference/file-conventions/src-folder) 来分离应用代码和配置文件
 
 </AppOnly>
 
@@ -136,21 +136,21 @@ export default function Page() {
 
 Next.js 使用文件系统路由，意味着应用路由由文件结构决定。
 
-在项目根目录创建 `pages` 文件夹，然后添加 `index.tsx` 文件作为首页 (`/`)：
+在项目根目录创建 `pages` 文件夹，然后添加 `index.tsx` 作为首页 (`/`)：
 
 ```tsx filename="pages/index.tsx" switcher
 export default function Page() {
-  return <h1>Hello, Next.js!</h1>
+  return <h1>你好，Next.js！</h1>
 }
 ```
 
 ```jsx filename="pages/index.js" switcher
 export default function Page() {
-  return <h1>Hello, Next.js!</h1>
+  return <h1>你好，Next.js！</h1>
 }
 ```
 
-接着在 `pages/` 中添加 `_app.tsx` 文件定义全局布局。了解更多关于[自定义 App 文件](/docs/pages/building-your-application/routing/custom-app)。
+接着在 `pages/` 下添加 `_app.tsx` 定义全局布局。了解更多关于[自定义 App 文件](/docs/pages/building-your-application/routing/custom-app)。
 
 ```tsx filename="pages/_app.tsx" switcher
 import type { AppProps } from 'next/app'
@@ -166,7 +166,7 @@ export default function App({ Component, pageProps }) {
 }
 ```
 
-最后在 `pages/` 中添加 `_document.tsx` 文件控制服务器初始响应。了解更多关于[自定义 Document 文件](/docs/pages/building-your-application/routing/custom-document)。
+最后在 `pages/` 下添加 `_document.tsx` 控制服务器初始响应。了解更多关于[自定义 Document 文件](/docs/pages/building-your-application/routing/custom-document)。
 
 ```tsx filename="pages/_document.tsx" switcher
 import { Html, Head, Main, NextScript } from 'next/document'
@@ -204,7 +204,7 @@ export default function Document() {
 
 ### 创建 `public` 文件夹（可选）
 
-在项目根目录创建 [`public` 文件夹](/docs/app/api-reference/file-conventions/public-folder) 存放图片、字体等静态资源。`public` 内的文件可通过根路径 (`/`) 引用。
+在项目根目录创建 [`public` 文件夹](/docs/app/api-reference/file-conventions/public-folder) 存放静态资源（如图片、字体等）。`public` 中的文件可通过根路径 (`/`) 引用。
 
 例如 `public/profile.png` 可引用为 `/profile.png`：
 
@@ -212,7 +212,7 @@ export default function Document() {
 import Image from 'next/image'
 
 export default function Page() {
-  return <Image src="/profile.png" alt="Profile" width={100} height={100} />
+  return <Image src="/profile.png" alt="个人头像" width={100} height={100} />
 }
 ```
 
@@ -220,33 +220,33 @@ export default function Page() {
 import Image from 'next/image'
 
 export default function Page() {
-  return <Image src="/profile.png" alt="Profile" width={100} height={100} />
+  return <Image src="/profile.png" alt="个人头像" width={100} height={100} />
 }
 ```
 
 ## 运行开发服务器
 
-1. 运行 `npm run dev` 启动开发服务器
+1. 执行 `npm run dev` 启动开发服务器
 2. 访问 `http://localhost:3000` 查看应用
-3. 编辑<AppOnly>`app/page.tsx`</AppOnly> <PagesOnly>`pages/index.tsx`</PagesOnly> 文件并保存，浏览器中即可看到更新结果
+3. 编辑 <AppOnly>`app/page.tsx`</AppOnly><PagesOnly>`pages/index.tsx`</PagesOnly> 文件并保存，浏览器中即可看到更新结果
 
 ## 配置 TypeScript
 
-> 最低 TypeScript 版本要求：`v4.5.2`
+> TypeScript 最低版本要求：`v4.5.2`
 
-Next.js 内置 TypeScript 支持。要添加 TypeScript 到项目，只需将文件重命名为 `.ts` / `.tsx` 并运行 `next dev`。Next.js 会自动安装必要依赖并添加包含推荐配置的 `tsconfig.json` 文件。
+Next.js 内置 TypeScript 支持。要将 TypeScript 添加到项目，只需将文件重命名为 `.ts`/`.tsx` 并运行 `next dev`。Next.js 会自动安装必要依赖并创建包含推荐配置的 `tsconfig.json` 文件。
 
 <AppOnly>
 
 ### IDE 插件
 
-Next.js 包含自定义 TypeScript 插件和类型检查器，可供 VSCode 等代码编辑器实现高级类型检查和自动补全。
+Next.js 包含自定义 TypeScript 插件和类型检查器，可供 VSCode 等编辑器实现高级类型检查和自动补全。
 
 在 VS Code 中启用插件：
 
 1. 打开命令面板 (`Ctrl/⌘` + `Shift` + `P`)
-2. 搜索 "TypeScript: Select TypeScript Version"
-3. 选择 "Use Workspace Version"
+2. 搜索 "TypeScript: 选择 TypeScript 版本"
+3. 选择 "使用工作区版本"
 
 <Image
   alt="TypeScript 命令面板"
@@ -258,13 +258,13 @@ Next.js 包含自定义 TypeScript 插件和类型检查器，可供 VSCode 等
 
 </AppOnly>
 
-更多信息请参考 [TypeScript 参考文档](/docs/app/api-reference/config/next-config-js/typescript)。
+更多信息请参考 [TypeScript 配置文档](/docs/app/api-reference/config/next-config-js/typescript)。
 
 ## 配置 ESLint
 
-Next.js 内置 ESLint 支持。使用 `create-next-app` 创建新项目时会自动安装必要包并配置正确设置。
+Next.js 内置 ESLint 支持。使用 `create-next-app` 创建项目时会自动安装必要包并配置正确设置。
 
-要为现有项目手动添加 ESLint，在 `package.json` 中添加 `next lint` 脚本：
+要为现有项目手动添加 ESLint，请在 `package.json` 中添加 `next lint` 脚本：
 
 ```json filename="package.json"
 {
@@ -274,35 +274,35 @@ Next.js 内置 ESLint 支持。使用 `create-next-app` 创建新项目时会自
 }
 ```
 
-然后运行 `npm run lint`，将引导完成安装和配置流程：
+然后运行 `npm run lint`，安装向导将引导完成配置过程：
 
 ```bash filename="终端"
 npm run lint
 ```
 
-您会看到如下提示：
+您将看到如下提示：
 
-> ? 您希望如何配置 ESLint？
+> ? 希望如何配置 ESLint？
 >
 > ❯ 严格模式（推荐）  
 > 基础模式  
 > 取消
 
-- **严格模式**：包含 Next.js 基础 ESLint 配置及更严格的 Core Web Vitals 规则集。初次设置 ESLint 时推荐此配置
+- **严格模式**：包含 Next.js 基础 ESLint 配置及更严格的 Core Web Vitals 规则集。首次配置 ESLint 时推荐使用
 - **基础模式**：仅包含 Next.js 基础 ESLint 配置
-- **取消**：跳过配置。如计划自定义 ESLint 配置请选此项
+- **取消**：跳过配置。如需自定义 ESLint 配置请选择此项
 
 选择"严格"或"基础"后，Next.js 会自动安装 `eslint` 和 `eslint-config-next` 依赖，并在项目根目录创建包含所选配置的 `.eslintrc.json` 文件。
 
-现在可随时运行 `next lint` 执行 ESLint 检查。ESLint 设置完成后，每次构建 (`next build`) 时也会自动运行。错误会导致构建失败，而警告不会。
+此后可通过运行 `next lint` 执行 ESLint 检查。ESLint 配置完成后，每次构建 (`next build`) 时也会自动运行。错误会导致构建失败，而警告不会。
 
 更多信息请参考 [ESLint 插件文档](/docs/app/api-reference/config/next-config-js/eslint)。
 
 ## 配置绝对导入和模块路径别名
 
-Next.js 原生支持 `tsconfig.json` 和 `jsconfig.json` 文件中的 `"paths"` 和 `"baseUrl"` 选项。
+Next.js 原生支持 `tsconfig.json` 和 `jsconfig.json` 中的 `"paths"` 和 `"baseUrl"` 选项。
 
-这些选项允许将项目目录别名化为绝对路径，使模块导入更简洁。例如：
+这些选项允许将项目目录映射为绝对路径，使模块导入更清晰简洁。例如：
 
 ```jsx
 // 之前
@@ -312,7 +312,7 @@ import { Button } from '../../../components/button'
 import { Button } from '@/components/button'
 ```
 
-要配置绝对导入，在 `tsconfig.json` 或 `jsconfig.json` 中添加 `baseUrl` 配置选项。例如：
+要配置绝对导入，请在 `tsconfig.json` 或 `jsconfig.json` 中添加 `baseUrl` 配置：
 
 ```json filename="tsconfig.json 或 jsconfig.json"
 {
@@ -322,7 +322,7 @@ import { Button } from '@/components/button'
 }
 ```
 
-除配置 `baseUrl` 路径外，还可使用 `"paths"` 选项设置模块路径"别名"。
+除配置 `baseUrl` 外，还可使用 `"paths"` 选项设置模块路径"别名"。
 
 例如以下配置将 `@/components/*` 映射到 `components/*`：
 
@@ -338,4 +338,4 @@ import { Button } from '@/components/button'
 }
 ```
 
-每个 `"paths"` 都相对于 `baseUrl` 位置。
+每个 `"paths"` 都相对于 `baseUrl` 指定的位置。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/08-partial-prerendering.mdx b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/08-partial-prerendering.mdx
index 6580dd42..1320461f 100644
--- a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/08-partial-prerendering.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/08-partial-prerendering.mdx
@@ -1,21 +1,21 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-19T23:06:15.558Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:17:34.430Z
 title: 如何使用部分预渲染 (Partial Prerendering)
-nav_title: 部分预渲染 (PPR)
-description: 学习如何通过部分预渲染 (Partial Prerendering) 结合静态渲染与动态渲染的优势。
+nav_title: 部分预渲染
+description: 了解如何通过部分预渲染 (Partial Prerendering) 结合静态渲染与动态渲染的优势。
 version: experimental
 related:
   title: 后续步骤
-  description: 了解更多关于部分预渲染 (PPR) 的配置选项。
+  description: 深入了解部分预渲染 (Partial Prerendering) 的配置选项。
   links:
     - app/api-reference/config/next-config-js/ppr
 ---
 
-部分预渲染 (Partial Prerendering, PPR) 是一种渲染策略，允许你在同一路由中结合静态与动态内容。这既能提升初始页面性能，又能支持个性化的动态数据。
+部分预渲染 (PPR) 是一种渲染策略，允许您在同一路由中结合静态与动态内容。这种方式既提升了初始页面性能，又能支持个性化动态数据。
 
 <Image
-  alt="部分预渲染的产品页面展示静态导航栏和产品信息，以及动态购物车和推荐商品"
+  alt="部分预渲染的产品页面展示：静态导航栏和产品信息，动态购物车和推荐商品"
   srcLight="/learn/light/thinking-in-ppr.png"
   srcDark="/learn/dark/thinking-in-ppr.png"
   width="1600"
@@ -24,27 +24,27 @@ related:
 
 当用户访问路由时：
 
-- 服务器发送包含静态内容的 **外壳 (shell)**，确保快速初始加载。
-- 外壳为动态内容预留 **空缺 (holes)**，这些内容将异步加载。
-- 动态空缺会 **并行流式传输 (streamed in parallel)**，减少页面的整体加载时间。
+- 服务器发送包含静态内容的 **外壳 (shell)**，确保快速初始加载
+- 外壳为动态内容预留 **空白区域 (holes)**，这些内容将异步加载
+- 动态空白区域会 **并行流式传输**，减少页面整体加载时间
 
-> **🎥 观看视频：** 为什么需要 PPR 及其工作原理 → [YouTube (10 分钟)](https://www.youtube.com/watch?v=MTcPrTIBkpA)。
+> **🎥 观看视频：** PPR 的原理与价值 → [YouTube (10分钟)](https://www.youtube.com/watch?v=MTcPrTIBkpA)
 
 ## 部分预渲染如何工作？
 
-要理解部分预渲染，需要先熟悉 Next.js 提供的渲染策略。
+理解部分预渲染前，需要先熟悉 Next.js 提供的渲染策略。
 
-### 静态渲染 (Static Rendering)
+### 静态渲染
 
-静态渲染会提前生成 HTML —— 可以在构建时或通过 [重新验证 (revalidation)](/docs/app/building-your-application/data-fetching/incremental-static-regeneration) 完成。结果会被缓存并在用户和请求间共享。
+静态渲染会提前生成 HTML——在构建时或通过 [重新验证](/docs/app/guides/incremental-static-regeneration) 完成。结果会被缓存并在用户和请求间共享。
 
-在部分预渲染中，Next.js 会为路由预渲染一个 **静态外壳 (static shell)**，包含布局和任何不依赖请求时数据的组件。
+在部分预渲染中，Next.js 会为路由预渲染一个 **静态外壳**，可包含布局和任何不依赖请求时数据的组件。
 
-### 动态渲染 (Dynamic Rendering)
+### 动态渲染
 
-动态渲染会在 **请求时 (request time)** 生成 HTML，从而根据请求时的数据提供个性化内容。
+动态渲染会在 **请求时** 生成 HTML，使您能基于请求时数据提供个性化内容。
 
-组件在以下情况下会变为动态：
+组件在以下情况会变为动态：
 
 - 使用 [`cookies`](/docs/app/api-reference/functions/cookies)
 - 使用 [`headers`](/docs/app/api-reference/functions/headers)
@@ -52,19 +52,19 @@ related:
 - 使用 [`draftMode`](/docs/app/api-reference/functions/draft-mode)
 - 使用 [`searchParams` 属性](/docs/app/api-reference/file-conventions/page#searchparams-optional)
 - 使用 [`unstable_noStore`](/docs/app/api-reference/functions/unstable_noStore)
-- 使用 `{ cache: 'no-store' }` 的 [`fetch`](/docs/app/api-reference/functions/fetch)
+- 使用 [`fetch`](/docs/app/api-reference/functions/fetch) 并设置 `{ cache: 'no-store' }`
 
-在部分预渲染中，使用这些 API 会抛出特殊的 React 错误，提示 Next.js 该组件无法静态渲染，导致构建错误。你可以使用 [Suspense](#suspense) 将渲染推迟到运行时。
+在部分预渲染中，使用这些 API 会抛出特殊 React 错误，提示 Next.js 该组件无法静态渲染，导致构建错误。您可以使用 [Suspense](#suspense) 延迟渲染至运行时。
 
 ### Suspense
 
-React 的 [Suspense](https://react.dev/reference/react/Suspense) 用于延迟渲染部分应用，直到满足某些条件。
+React 的 [Suspense](https://react.dev/reference/react/Suspense) 用于延迟渲染部分应用直到满足特定条件。
 
-在部分预渲染中，Suspense 用于标记组件树中的 **动态边界 (dynamic boundaries)**。
+在部分预渲染中，Suspense 用于标记组件树中的 **动态边界**。
 
-构建时，Next.js 会预渲染静态内容和 `fallback` UI。动态内容会 **推迟 (postponed)** 到用户请求路由时加载。
+构建时，Next.js 会预渲染静态内容和 `fallback` UI。动态内容会 **延迟** 至用户请求路由时加载。
 
-用 Suspense 包裹组件不会使组件本身变为动态（动态性由 API 使用决定），而是作为封装动态内容的边界，并启用 [流式传输 (streaming)](#streaming)。
+用 Suspense 包裹组件不会使组件本身变为动态（动态性由 API 使用决定），而是作为封装动态内容的边界，实现 [流式传输](#streaming)
 
 ```jsx filename="app/page.js"
 import { Suspense } from 'react'
@@ -86,33 +86,33 @@ export default function Page() {
 }
 ```
 
-### 流式传输 (Streaming)
+### 流式传输
 
-流式传输将路由拆分为多个块，并在准备就绪时逐步传输到客户端。这样用户可以在整个内容完成渲染前立即看到部分页面。
+流式传输将路由拆分为多个块，并在准备就绪时逐步流式传输至客户端。这使得用户能在全部内容完成渲染前立即看到部分页面。
 
 <Image
-  alt="图表展示客户端部分渲染的页面，以及正在流式传输的区块加载 UI。"
+  alt="图表展示客户端部分渲染的页面，正在流式传输的区块显示加载 UI"
   srcLight="/docs/light/server-rendering-with-streaming.png"
   srcDark="/docs/dark/server-rendering-with-streaming.png"
   width="1600"
   height="785"
 />
 
-在部分预渲染中，包裹在 Suspense 中的动态组件会从服务器并行流式传输。
+在部分预渲染中，包裹在 Suspense 中的动态组件会从服务器并行开始流式传输。
 
 <Image
-  alt="图表展示流式传输期间路由段的并行化，显示各个区块的数据获取、渲染和水合。"
+  alt="图表展示流式传输期间路由段的并行化，显示各个块的数据获取、渲染和水合过程"
   srcLight="/docs/light/sequential-parallel-data-fetching.png"
   srcDark="/docs/dark/sequential-parallel-data-fetching.png"
   width="1600"
   height="525"
 />
 
-为了减少网络开销，完整响应（包括静态 HTML 和流式传输的动态部分）会在 **单个 HTTP 请求** 中发送。这避免了额外的往返，提升了初始加载和整体性能。
+为减少网络开销，完整响应（包括静态 HTML 和流式动态部分）会通过 **单次 HTTP 请求** 发送。这避免了额外往返，提升了初始加载和整体性能。
 
 ## 启用部分预渲染
 
-你可以通过在 `next.config.ts` 文件中添加 [`ppr`](https://rc.nextjs.org/docs/app/api-reference/next-config-js/ppr) 选项来启用 PPR：
+您可以通过在 `next.config.ts` 文件中添加 [`ppr`](https://rc.nextjs.org/docs/app/api-reference/next-config-js/ppr) 选项来启用 PPR：
 
 ```ts filename="next.config.ts" highlight={5} switcher
 import type { NextConfig } from 'next'
@@ -135,7 +135,7 @@ const nextConfig = {
 }
 ```
 
-`'incremental'` 值允许你为特定路由启用 PPR：
+`'incremental'` 值允许您为特定路由启用 PPR：
 
 ```tsx filename="/app/dashboard/layout.tsx"
 export const experimental_ppr = true
@@ -153,18 +153,18 @@ export default function Layout({ children }) {
 }
 ```
 
-未设置 `experimental_ppr` 的路由会默认为 `false`，不会使用 PPR 预渲染。你需要为每个路由显式启用 PPR。
+未设置 `experimental_ppr` 的路由默认为 `false`，不会使用 PPR 预渲染。您需要为每个路由显式启用 PPR。
 
 > **须知：**
 >
-> - `experimental_ppr` 会应用到路由段的所有子节点，包括嵌套布局和页面。你无需在每个文件中添加，只需在路由的顶层段设置。
-> - 要为子段禁用 PPR，可以在子段中将 `experimental_ppr` 设为 `false`。
+> - `experimental_ppr` 会应用于路由段的所有子级，包括嵌套布局和页面。您无需在每个文件中添加，只需在路由的顶层段设置。
+> - 要为子段禁用 PPR，可在子段中将 `experimental_ppr` 设为 `false`。
 
 ## 示例
 
 ### 动态 API
 
-当使用需要查看请求的动态 API 时，Next.js 会为该路由启用动态渲染。要继续使用 PPR，请用 Suspense 包裹组件。例如，`<User />` 组件因使用 `cookies` API 而变为动态：
+当使用需要查看传入请求的动态 API 时，Next.js 会为该路由启用动态渲染。要继续使用 PPR，请用 Suspense 包裹组件。例如，`<User />` 组件因使用 `cookies` API 而变为动态：
 
 ```jsx filename="app/user.js" switcher
 import { cookies } from 'next/headers'
@@ -184,7 +184,7 @@ export async function User() {
 }
 ```
 
-`<User />` 组件会流式传输，而 `<Page />` 中的其他内容会被预渲染并成为静态外壳的一部分。
+`<User />` 组件将被流式传输，而 `<Page />` 中的其他内容会被预渲染并成为静态外壳的一部分。
 
 ```tsx filename="app/page.tsx" switcher
 import { Suspense } from 'react'
@@ -195,7 +195,7 @@ export const experimental_ppr = true
 export default function Page() {
   return (
     <section>
-      <h1>这部分会被预渲染</h1>
+      <h1>这部分内容将被预渲染</h1>
       <Suspense fallback={<AvatarSkeleton />}>
         <User />
       </Suspense>
@@ -213,7 +213,7 @@ export const experimental_ppr = true
 export default function Page() {
   return (
     <section>
-      <h1>这部分会被预渲染</h1>
+      <h1>这部分内容将被预渲染</h1>
       <Suspense fallback={<AvatarSkeleton />}>
         <User />
       </Suspense>
@@ -224,7 +224,7 @@ export default function Page() {
 
 ### 传递动态属性
 
-组件仅在访问值时才会启用动态渲染。例如，如果你从 `<Page />` 组件读取 `searchParams`，可以将其作为属性传递给其他组件：
+只有在访问值时组件才会启用动态渲染。例如，如果您从 `<Page />` 组件读取 `searchParams`，可以将其作为属性传递给其他组件：
 
 ```tsx filename="app/page.tsx" switcher
 import { Table, TableSkeleton } from './table'
@@ -237,7 +237,7 @@ export default function Page({
 }) {
   return (
     <section>
-      <h1>这部分会被预渲染</h1>
+      <h1>这部分内容将被预渲染</h1>
       <Suspense fallback={<TableSkeleton />}>
         <Table searchParams={searchParams} />
       </Suspense>
@@ -253,7 +253,7 @@ import { Suspense } from 'react'
 export default function Page({ searchParams }) {
   return (
     <section>
-      <h1>这部分会被预渲染</h1>
+      <h1>这部分内容将被预渲染</h1>
       <Suspense fallback={<TableSkeleton />}>
         <Table searchParams={searchParams} />
       </Suspense>
@@ -262,7 +262,7 @@ export default function Page({ searchParams }) {
 }
 ```
 
-在表格组件内部，访问 `searchParams` 的值会使该组件变为动态，而页面的其余部分会被预渲染。
+在表格组件内部，访问 `searchParams` 的值会使该组件变为动态，而页面其余部分会被预渲染。
 
 ```tsx filename="app/table.tsx" switcher
 export async function Table({
diff --git a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/09-fetching-data.mdx b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/09-fetching-data.mdx
index 5e75197e..91f0987c 100644
--- a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/09-fetching-data.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/09-fetching-data.mdx
@@ -1,31 +1,33 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-19T23:06:18.784Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:19:09.115Z
 title: 如何获取数据并实现流式传输
 nav_title: 数据获取
 description: 开始在您的应用中获取数据并流式传输内容。
 related:
   title: API 参考
-  description: 通过阅读 API 参考了解更多本页提到的功能。
+  description: 通过阅读 API 参考文档了解更多本页提到的功能特性。
   links:
     - app/api-reference/functions/fetch
     - app/api-reference/file-conventions/loading
+    - app/api-reference/config/next-config-js/logging
+    - app/api-reference/config/next-config-js/taint
 ---
 
-本页将引导您了解如何在 [服务端组件 (Server Components)](#server-components) 和 [客户端组件 (Client Components)](#client-components) 中获取数据，以及如何对依赖数据的内容进行 [流式传输 (streaming)](#streaming)。
+本页将引导您了解如何在 [服务端与客户端组件](/docs/app/getting-started/server-and-client-components) 中获取数据，以及如何流式传输依赖数据的组件。
 
-## 获取数据
+## 数据获取
 
 ### 服务端组件
 
-您可以通过以下方式在服务端组件中获取数据：
+您可以在服务端组件中通过以下方式获取数据：
 
 1. 使用 [`fetch` API](#with-the-fetch-api)
 2. 使用 [ORM 或数据库](#with-an-orm-or-database)
 
 #### 使用 `fetch` API
 
-要在服务端组件中使用 `fetch` API 获取数据，将组件转换为异步函数，并等待 `fetch` 调用。例如：
+要通过 `fetch` API 获取数据，将您的组件转换为异步函数，并 await `fetch` 调用。例如：
 
 ```tsx filename="app/blog/page.tsx" switcher
 export default async function Page() {
@@ -55,9 +57,14 @@ export default async function Page() {
 }
 ```
 
+> **须知：**
+>
+> - `fetch` 响应默认不会被缓存。但 Next.js 会对路由进行 [预渲染](/docs/app/getting-started/partial-prerendering#static-rendering)，输出结果会被缓存以提升性能。如需启用 [动态渲染](/docs/app/getting-started/partial-prerendering#dynamic-rendering)，请使用 `{ cache: 'no-store' }` 选项。参阅 [`fetch` API 参考](/docs/app/api-reference/functions/fetch)。
+> - 开发环境下，您可以记录 `fetch` 调用以便更好地调试和观察。参阅 [`logging` API 参考](/docs/app/api-reference/config/next-config-js/logging)。
+
 #### 使用 ORM 或数据库
 
-由于服务端组件在服务器端渲染，您可以安全地使用 ORM 或数据库客户端进行查询。将组件转换为异步函数，并等待调用：
+由于服务端组件在服务器端渲染，您可以安全地使用 ORM 或数据库客户端进行查询。将组件转换为异步函数，并 await 调用：
 
 ```tsx filename="app/blog/page.tsx" switcher
 import { db, posts } from '@/lib/db'
@@ -91,21 +98,21 @@ export default async function Page() {
 
 ### 客户端组件
 
-在客户端组件中获取数据有两种方式：
+在客户端组件中有两种获取数据的方式：
 
 1. 使用 React 的 [`use` 钩子](https://react.dev/reference/react/use)
 2. 使用社区库如 [SWR](https://swr.vercel.app/) 或 [React Query](https://tanstack.com/query/latest)
 
 #### 使用 `use` 钩子流式传输数据
 
-您可以使用 React 的 [`use` 钩子](https://react.dev/reference/react/use) 将数据从服务器 [流式传输 (streaming)](#streaming) 到客户端。首先在服务端组件中获取数据，然后将 Promise 作为 prop 传递给客户端组件：
+您可以使用 React 的 [`use` 钩子](https://react.dev/reference/react/use) 将数据从服务器 [流式传输](#streaming) 到客户端。首先在服务端组件中获取数据，然后将 Promise 作为 prop 传递给客户端组件：
 
 ```tsx filename="app/blog/page.tsx" switcher
 import Posts from '@/app/ui/posts
 import { Suspense } from 'react'
 
 export default function Page() {
-  // 不要等待数据获取函数
+  // 不要 await 数据获取函数
   const posts = getPosts()
 
   return (
@@ -121,7 +128,7 @@ import Posts from '@/app/ui/posts
 import { Suspense } from 'react'
 
 export default function Page() {
-  // 不要等待数据获取函数
+  // 不要 await 数据获取函数
   const posts = getPosts()
 
   return (
@@ -132,7 +139,7 @@ export default function Page() {
 }
 ```
 
-然后，在客户端组件中使用 `use` 钩子读取 Promise：
+然后在客户端组件中使用 `use` 钩子读取 Promise：
 
 ```tsx filename="app/ui/posts.tsx" switcher
 'use client'
@@ -172,11 +179,11 @@ export default function Posts({ posts }) {
 }
 ```
 
-在上面的示例中，您需要将 `<Posts />` 组件包裹在 [`<Suspense>` 边界](https://react.dev/reference/react/Suspense) 中。这意味着在 Promise 解析期间将显示 fallback 内容。了解更多关于 [流式传输 (streaming)](#streaming) 的信息。
+在上例中，您需要用 [`<Suspense>` 边界](https://react.dev/reference/react/Suspense) 包裹 `<Posts />` 组件。这意味着在 Promise 解析期间会显示 fallback UI。了解更多关于 [流式传输](#streaming) 的内容。
 
 #### 社区库
 
-您可以使用社区库如 [SWR](https://swr.vercel.app/) 或 [React Query](https://tanstack.com/query/latest) 在客户端组件中获取数据。这些库有自己的缓存、流式传输和其他功能的语义。例如，使用 SWR：
+您可以使用社区库如 [SWR](https://swr.vercel.app/) 或 [React Query](https://tanstack.com/query/latest) 在客户端组件中获取数据。这些库有自己的缓存、流式传输等特性语义。例如使用 SWR：
 
 ```tsx filename="app/blog/page.tsx" switcher
 'use client'
@@ -205,6 +212,7 @@ export default function BlogPage() {
 
 ```jsx filename="app/blog/page.js" switcher
 'use client'
+
 import useSWR from 'swr'
 
 const fetcher = (url) => fetch(url).then((r) => r.json())
@@ -230,28 +238,28 @@ export default function BlogPage() {
 
 ## 流式传输
 
-> **警告：** 以下内容假设您的应用中启用了 [`dynamicIO` 配置选项](/docs/app/api-reference/config/next-config-js/dynamicIO)。该标志在 Next.js 15 canary 中引入。
+> **警告：** 以下内容假设您的应用已启用 [`dynamicIO` 配置选项](/docs/app/api-reference/config/next-config-js/dynamicIO)。该标志在 Next.js 15 canary 版本中引入。
 
-在服务端组件中使用 `async/await` 时，Next.js 将选择 **动态渲染 (dynamic rendering)**。这意味着数据将在每次用户请求时在服务器端获取和渲染。如果有任何慢速数据请求，整个路由将被阻塞渲染。
+在服务端组件中使用 `async/await` 时，Next.js 会启用 **动态渲染**。这意味着数据将在每次用户请求时在服务器端获取并渲染。如果有任何慢速数据请求，整个路由的渲染都会被阻塞。
 
-为了改善初始加载时间和用户体验，您可以使用流式传输将页面的 HTML 拆分为较小的块，并逐步将这些块从服务器发送到客户端。
+为了改善初始加载时间和用户体验，您可以使用流式传输将页面的 HTML 拆分为小块，并逐步从服务器发送到客户端。
 
 <Image
-  alt="服务端渲染与流式传输的工作原理"
+  alt="服务端渲染与流式传输工作原理"
   srcLight="/docs/light/server-rendering-with-streaming.png"
   srcDark="/docs/dark/server-rendering-with-streaming.png"
   width="1600"
   height="785"
 />
 
-您可以通过以下两种方式在应用中实现流式传输：
+有两种方式可以在应用中实现流式传输：
 
 1. 使用 [`loading.js` 文件](#with-loadingjs)
 2. 使用 React 的 [`<Suspense>` 组件](#with-suspense)
 
 ### 使用 `loading.js`
 
-您可以在页面所在文件夹中创建 `loading.js` 文件，以便在数据获取期间流式传输 **整个页面**。例如，要流式传输 `app/blog/page.js`，请在 `app/blog` 文件夹中添加该文件。
+您可以在页面所在文件夹中创建 `loading.js` 文件，在数据获取期间流式传输 **整个页面**。例如要为 `app/blog/page.js` 添加流式传输，请在 `app/blog` 文件夹中添加该文件。
 
 <Image
   alt="包含 loading.js 文件的博客文件夹结构"
@@ -275,7 +283,7 @@ export default function Loading() {
 }
 ```
 
-在导航时，用户将立即看到布局和 [加载状态](#creating-meaningful-loading-states)，同时页面正在渲染。渲染完成后，新内容将自动替换显示。
+导航时，用户会立即看到布局和 [加载状态](#creating-meaningful-loading-states)，同时页面正在渲染。渲染完成后，新内容会自动替换显示。
 
 <Image
   alt="加载 UI"
@@ -285,21 +293,21 @@ export default function Loading() {
   height="691"
 />
 
-在后台，`loading.js` 将被嵌套在 `layout.js` 中，并自动将 `page.js` 文件及其子内容包裹在 `<Suspense>` 边界中。
+在底层，`loading.js` 会被嵌套在 `layout.js` 中，并自动将 `page.js` 文件及其子组件包裹在 `<Suspense>` 边界内。
 
 <Image
-  alt="loading.js 概述"
+  alt="loading.js 概览"
   srcLight="/docs/light/loading-overview.png"
   srcDark="/docs/dark/loading-overview.png"
   width="1600"
   height="768"
 />
 
-这种方法适用于路由段（布局和页面），但对于更细粒度的流式传输，您可以使用 `<Suspense>`。
+这种方法适用于路由段（布局和页面），如需更细粒度的流式传输，可以使用 `<Suspense>`。
 
 ### 使用 `<Suspense>`
 
-`<Suspense>` 允许您更精细地控制页面的哪些部分进行流式传输。例如，您可以立即显示 `<Suspense>` 边界之外的任何页面内容，并流式传输边界内的博客文章列表。
+`<Suspense>` 允许您更精细地控制页面的哪些部分需要流式传输。例如，您可以立即显示 `<Suspense>` 边界外的页面内容，而边界内的博客列表则进行流式传输。
 
 ```tsx filename="app/blog/page.tsx" switcher
 import { Suspense } from 'react'
@@ -309,13 +317,13 @@ import BlogListSkeleton from '@/components/BlogListSkeleton'
 export default function BlogPage() {
   return (
     <div>
-      {/* 这部分内容将立即发送到客户端 */}
+      {/* 这部分内容会立即发送到客户端 */}
       <header>
-        <h1>Welcome to the Blog</h1>
-        <p>Read the latest posts below.</p>
+        <h1>欢迎来到博客</h1>
+        <p>阅读以下最新文章。</p>
       </header>
       <main>
-        {/* 任何包裹在 <Suspense> 边界中的内容将被流式传输 */}
+        {/* 任何包裹在 <Suspense> 边界内的内容都会流式传输 */}
         <Suspense fallback={<BlogListSkeleton />}>
           <BlogList />
         </Suspense>
@@ -333,13 +341,13 @@ import BlogListSkeleton from '@/components/BlogListSkeleton'
 export default function BlogPage() {
   return (
     <div>
-      {/* 这部分内容将立即发送到客户端 */}
+      {/* 这部分内容会立即发送到客户端 */}
       <header>
-        <h1>Welcome to the Blog</h1>
-        <p>Read the latest posts below.</p>
+        <h1>欢迎来到博客</h1>
+        <p>阅读以下最新文章。</p>
       </header>
       <main>
-        {/* 任何包裹在 <Suspense> 边界中的内容将被流式传输 */}
+        {/* 任何包裹在 <Suspense> 边界内的内容都会流式传输 */}
         <Suspense fallback={<BlogListSkeleton />}>
           <BlogList />
         </Suspense>
@@ -351,6 +359,269 @@ export default function BlogPage() {
 
 ### 创建有意义的加载状态
 
-即时加载状态是在导航后立即向用户显示的 fallback UI。为了获得最佳用户体验，我们建议设计有意义的加载状态，帮助用户理解应用正在响应。例如，您可以使用骨架屏和加载动画，或者未来屏幕的一小部分但有意义的内容，如封面照片、标题等。
+即时加载状态是导航后立即向用户显示的 fallback UI。为了最佳用户体验，我们建议设计有意义的加载状态，帮助用户理解应用正在响应。例如可以使用骨架屏和加载动画，或未来屏幕中的一小部分有意义内容如封面图片、标题等。
+
+开发时，您可以使用 [React Devtools](https://react.dev/learn/react-developer-tools) 预览和检查组件的加载状态。
+
+## 示例
+
+### 顺序数据获取
+
+顺序数据获取发生在树形结构的嵌套组件各自获取数据且请求未被 [去重](/docs/app/deep-dive/caching#request-memoization) 时，会导致响应时间变长。
+
+<Image
+  alt="顺序与并行数据获取"
+  srcLight="/docs/light/sequential-parallel-data-fetching.png"
+  srcDark="/docs/dark/sequential-parallel-data-fetching.png"
+  width="1600"
+  height="525"
+/>
+
+有时您可能需要这种模式，因为某个获取依赖于另一个获取的结果。
+
+例如，`<Playlists>` 组件只有在 `<Artist>` 组件完成数据获取后才会开始获取数据，因为 `<Playlists>` 依赖 `artistID` prop：
+
+```tsx filename="app/artist/[username]/page.tsx" switcher
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ username: string }>
+}) {
+  const { username } = await params
+  // 获取艺术家信息
+  const artist = await getArtist(username)
+
+  return (
+    <>
+      <h1>{artist.name}</h1>
+      {/* 在 Playlists 组件加载时显示 fallback UI */}
+      <Suspense fallback={<div>Loading...</div>}>
+        {/* 将艺术家 ID 传递给 Playlists 组件 */}
+        <Playlists artistID={artist.id} />
+      </Suspense>
+    </>
+  )
+}
+
+async function Playlists({ artistID }: { artistID: string }) {
+  // 使用艺术家 ID 获取播放列表
+  const playlists = await getArtistPlaylists(artistID)
+
+  return (
+    <ul>
+      {playlists.map((playlist) => (
+        <li key={playlist.id}>{playlist.name}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+```jsx filename="app/artist/[username]/page.js" switcher
+export default async function Page({ params }) {
+  const { username } = await params
+  // 获取艺术家信息
+  const artist = await getArtist(username)
+
+  return (
+    <>
+      <h1>{artist.name}</h1>
+      {/* 在 Playlists 组件加载时显示 fallback UI */}
+      <Suspense fallback={<div>Loading...</div>}>
+        {/* 将艺术家 ID 传递给 Playlists 组件 */}
+        <Playlists artistID={artist.id} />
+      </Suspense>
+    </>
+  )
+}
+
+async function Playlists({ artistID }) {
+  // 使用艺术家 ID 获取播放列表
+  const playlists = await getArtistPlaylists(artistID)
+
+  return (
+    <ul>
+      {playlists.map((playlist) => (
+        <li key={playlist.id}>{playlist.name}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+为了改善用户体验，您应该使用 [React `<Suspense>`](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense) 在数据获取时显示 `fallback`。这将启用 [流式传输](#streaming) 并防止整个路由被顺序数据请求阻塞。
+
+### 并行数据获取
+
+当路由中的数据请求被主动发起并同时开始时，就会发生并行数据获取。
+
+默认情况下，[布局和页面](/docs/app/getting-started/layouts-and-pages)是并行渲染的。因此每个路由段会尽可能早地开始获取数据。
+
+然而，在_任何_组件内部，如果将多个 `async`/`await` 请求按顺序放置，它们仍然会串行执行。例如，`getAlbums` 会阻塞直到 `getArtist` 完成解析：
+
+```tsx filename="app/artist/[username]/page.tsx" switcher
+import { getArtist, getAlbums } from '@/app/lib/data'
+
+export default async function Page({ params }) {
+  // 这些请求将串行执行
+  const { username } = await params
+  const artist = await getArtist(username)
+  const albums = await getAlbums(username)
+  return <div>{artist.name}</div>
+}
+```
+
+你可以通过在数据使用组件外部定义请求，并使用 [`Promise.all`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all) 一起解析它们来实现并行请求：
+
+```tsx filename="app/artist/[username]/page.tsx" highlight={3,8,23} switcher
+import Albums from './albums'
+
+async function getArtist(username: string) {
+  const res = await fetch(`https://api.example.com/artist/${username}`)
+  return res.json()
+}
+
+async function getAlbums(username: string) {
+  const res = await fetch(`https://api.example.com/artist/${username}/albums`)
+  return res.json()
+}
+
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ username: string }>
+}) {
+  const { username } = await params
+  const artistData = getArtist(username)
+  const albumsData = getAlbums(username)
+
+  // 并行发起两个请求
+  const [artist, albums] = await Promise.all([artistData, albumsData])
+
+  return (
+    <>
+      <h1>{artist.name}</h1>
+      <Albums list={albums} />
+    </>
+  )
+}
+```
+
+```jsx filename="app/artist/[username]/page.js" highlight={3,8,19} switcher
+import Albums from './albums'
+
+async function getArtist(username) {
+  const res = await fetch(`https://api.example.com/artist/${username}`)
+  return res.json()
+}
+
+async function getAlbums(username) {
+  const res = await fetch(`https://api.example.com/artist/${username}/albums`)
+  return res.json()
+}
+
+export default async function Page({ params }) {
+  const { username } = await params
+  const artistData = getArtist(username)
+  const albumsData = getAlbums(username)
+
+  // 并行发起两个请求
+  const [artist, albums] = await Promise.all([artistData, albumsData])
+
+  return (
+    <>
+      <h1>{artist.name}</h1>
+      <Albums list={albums} />
+    </>
+  )
+}
+```
+
+> **须知：** 使用 `Promise.all` 时，如果其中一个请求失败，整个操作都会失败。要处理这种情况，可以使用 [`Promise.allSettled`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/allSettled) 方法替代。
+
+### 数据预加载
+
+你可以通过创建一个工具函数，在阻塞请求之前主动调用来预加载数据。`<Item>` 组件会根据 `checkIsAvailable()` 函数的返回值条件渲染。
+
+你可以在 `checkIsAvailable()` 之前调用 `preload()` 来主动初始化 `<Item/>` 的数据依赖。当 `<Item/>` 渲染时，其数据已经获取完成。
 
-在开发过程中，您可以使用 [React Devtools](https://react.dev/learn/react-developer-tools) 预览和检查组件的加载状态。
\ No newline at end of file
+```tsx filename="app/item/[id]/page.tsx" switcher
+import { getItem } from '@/lib/data'
+
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ id: string }>
+}) {
+  const { id } = await params
+  // 开始加载项目数据
+  preload(id)
+  // 执行另一个异步任务
+  const isAvailable = await checkIsAvailable()
+
+  return isAvailable ? <Item id={id} /> : null
+}
+
+export const preload = (id: string) => {
+  // void 会执行给定表达式并返回 undefined
+  // https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/void
+  void getItem(id)
+}
+export async function Item({ id }: { id: string }) {
+  const result = await getItem(id)
+  // ...
+}
+```
+
+```jsx filename="app/item/[id]/page.js" switcher
+import { getItem } from '@/lib/data'
+
+export default async function Page({ params }) {
+  const { id } = await params
+  // 开始加载项目数据
+  preload(id)
+  // 执行另一个异步任务
+  const isAvailable = await checkIsAvailable()
+
+  return isAvailable ? <Item id={id} /> : null
+}
+
+export const preload = (id) => {
+  // void 会执行给定表达式并返回 undefined
+  // https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/void
+  void getItem(id)
+}
+export async function Item({ id }) {
+  const result = await getItem(id)
+  // ...
+```
+
+此外，你还可以使用 React 的 [`cache` 函数](https://react.dev/reference/react/cache) 和 [`server-only` 包](https://www.npmjs.com/package/server-only) 来创建一个可复用的工具函数。这种方法可以缓存数据获取函数，并确保它只在服务器端执行。
+
+```ts filename="utils/get-item.ts" switcher
+import { cache } from 'react'
+import 'server-only'
+import { getItem } from '@/lib/data'
+
+export const preload = (id: string) => {
+  void getItem(id)
+}
+
+export const getItem = cache(async (id: string) => {
+  // ...
+})
+```
+
+```js filename="utils/get-item.js" switcher
+import { cache } from 'react'
+import 'server-only'
+import { getItem } from '@/lib/data'
+
+export const preload = (id) => {
+  void getItem(id)
+}
+
+export const getItem = cache(async (id) => {
+  // ...
+})
+```
diff --git a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/11-error-handling.mdx b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/11-error-handling.mdx
index 68d2a187..11146637 100644
--- a/apps/docs/content/zh-hans/docs/01-app/01-getting-started/11-error-handling.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/01-getting-started/11-error-handling.mdx
@@ -1,9 +1,9 @@
 ---
-source-updated-at: '2025-05-19T22:31:51.000Z'
-translation-updated-at: '2025-05-19T22:31:51.000Z'
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:17:12.404Z
 title: 错误处理指南
 nav_title: 错误处理
-description: 学习如何显示预期错误并处理未捕获异常。
+description: 学习如何显示预期错误并处理未捕获的异常。
 related:
   title: API 参考
   description: 通过阅读 API 参考文档深入了解本页提到的功能。
@@ -14,17 +14,17 @@ related:
     - app/api-reference/file-conventions/not-found
 ---
 
-错误可分为两类：[预期错误](#handling-expected-errors) 和 [未捕获异常](#handling-uncaught-exceptions)。本文将指导您如何在 Next.js 应用中处理这些错误。
+错误可分为两类：[预期错误](#handling-expected-errors) 和 [未捕获异常](#handling-uncaught-exceptions)。本指南将介绍如何在 Next.js 应用中处理这些错误。
 
 ## 处理预期错误
 
-预期错误指应用正常运行过程中可能出现的错误，例如[服务端表单验证](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#server-side-form-validation)失败或请求失败。这类错误应显式处理并返回给客户端。
+预期错误指应用正常运行过程中可能出现的错误，例如来自 [服务端表单验证 (server-side form validation)](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#server-side-form-validation) 的验证错误或失败的请求。这类错误应被显式处理并返回给客户端。
 
 ### 服务端函数
 
-您可以使用 [`useActionState`](https://react.dev/reference/react/useActionState) 钩子来处理[服务端函数 (Server Functions)](https://react.dev/reference/rsc/server-functions)中的预期错误。
+您可以使用 [`useActionState`](https://react.dev/reference/react/useActionState) 钩子来处理 [服务端函数 (Server Functions)](https://react.dev/reference/rsc/server-functions) 中的预期错误。
 
-对于这类错误，应避免使用 `try`/`catch` 代码块抛出错误，而应将预期错误建模为返回值。
+对于这类错误，应避免使用 `try`/`catch` 代码块和抛出错误，而应将预期错误建模为返回值。
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -81,12 +81,12 @@ export function Form() {
 
   return (
     <form action={formAction}>
-      <label htmlFor="title">Title</label>
+      <label htmlFor="title">标题</label>
       <input type="text" id="title" name="title" required />
-      <label htmlFor="content">Content</label>
+      <label htmlFor="content">内容</label>
       <textarea id="content" name="content" required />
       {state?.message && <p aria-live="polite">{state.message}</p>}
-      <button disabled={pending}>Create Post</button>
+      <button disabled={pending}>创建文章</button>
     </form>
   )
 }
@@ -107,12 +107,12 @@ export function Form() {
 
   return (
     <form action={formAction}>
-      <label htmlFor="title">Title</label>
+      <label htmlFor="title">标题</label>
       <input type="text" id="title" name="title" required />
-      <label htmlFor="content">Content</label>
+      <label htmlFor="content">内容</label>
       <textarea id="content" name="content" required />
       {state?.message && <p aria-live="polite">{state.message}</p>}
-      <button disabled={pending}>Create Post</button>
+      <button disabled={pending}>创建文章</button>
     </form>
   )
 }
@@ -120,7 +120,7 @@ export function Form() {
 
 ### 服务端组件
 
-在服务端组件中获取数据时，您可以使用响应条件渲染错误信息或执行[重定向 (redirect)](/docs/app/api-reference/functions/redirect)。
+在服务端组件中获取数据时，您可以使用响应来条件渲染错误信息或执行 [`redirect`](/docs/app/api-reference/functions/redirect) 重定向。
 
 ```tsx filename="app/page.tsx" switcher
 export default async function Page() {
@@ -128,7 +128,7 @@ export default async function Page() {
   const data = await res.json()
 
   if (!res.ok) {
-    return 'There was an error.'
+    return '发生错误。'
   }
 
   return '...'
@@ -141,7 +141,7 @@ export default async function Page() {
   const data = await res.json()
 
   if (!res.ok) {
-    return 'There was an error.'
+    return '发生错误。'
   }
 
   return '...'
@@ -150,7 +150,7 @@ export default async function Page() {
 
 ### 未找到页面
 
-您可以在路由段内调用 [`notFound`](/docs/app/api-reference/functions/not-found) 函数，并使用 [`not-found.js`](/docs/app/api-reference/file-conventions/not-found) 文件显示 404 UI。
+您可以在路由段中调用 [`notFound`](/docs/app/api-reference/functions/not-found) 函数，并使用 [`not-found.js`](/docs/app/api-reference/file-conventions/not-found) 文件来显示 404 UI。
 
 ```tsx filename="app/blog/[slug]/page.tsx" switcher
 import { getPostBySlug } from '@/lib/posts'
@@ -184,23 +184,23 @@ export default async function Page({ params }) {
 
 ```tsx filename="app/blog/[slug]/not-found.tsx" switcher
 export default function NotFound() {
-  return <div>404 - Page Not Found</div>
+  return <div>404 - 页面未找到</div>
 }
 ```
 
 ```jsx filename="app/blog/[slug]/not-found.js" switcher
 export default function NotFound() {
-  return <div>404 - Page Not Found</div>
+  return <div>404 - 页面未找到</div>
 }
 ```
 
 ## 处理未捕获异常
 
-未捕获异常是意外错误，表明应用中存在不应出现的 bug 或问题。这类错误应通过抛出异常来处理，随后会被错误边界捕获。
+未捕获异常是意外错误，表明应用中存在不应在正常流程中出现的错误或问题。这类错误应通过抛出错误来处理，然后由错误边界捕获。
 
 ### 嵌套错误边界
 
-Next.js 使用错误边界 (error boundaries) 处理未捕获异常。错误边界会捕获子组件中的错误，并显示备用 UI 而非崩溃的组件树。
+Next.js 使用错误边界来处理未捕获异常。错误边界会捕获其子组件中的错误，并显示备用 UI 而非崩溃的组件树。
 
 通过在路由段内添加 [`error.js`](/docs/app/api-reference/file-conventions/error) 文件并导出 React 组件来创建错误边界：
 
@@ -223,14 +223,14 @@ export default function Error({
 
   return (
     <div>
-      <h2>Something went wrong!</h2>
+      <h2>出错了！</h2>
       <button
         onClick={
-          // 尝试通过重新渲染路由段来恢复
+          // 尝试通过重新渲染该段来恢复
           () => reset()
         }
       >
-        Try again
+        重试
       </button>
     </div>
   )
@@ -250,21 +250,21 @@ export default function Error({ error, reset }) {
 
   return (
     <div>
-      <h2>Something went wrong!</h2>
+      <h2>出错了！</h2>
       <button
         onClick={
-          // 尝试通过重新渲染路由段来恢复
+          // 尝试通过重新渲染该段来恢复
           () => reset()
         }
       >
-        Try again
+        重试
       </button>
     </div>
   )
 }
 ```
 
-错误会冒泡到最近的父级错误边界。通过在[路由层级结构](/docs/app/getting-started/project-structure#component-hierarchy)的不同层级放置 `error.tsx` 文件，可以实现细粒度的错误处理。
+错误会冒泡到最近的父级错误边界。通过在 [路由层级结构 (route hierarchy)](/docs/app/getting-started/project-structure#component-hierarchy) 的不同层级放置 `error.tsx` 文件，可以实现细粒度的错误处理。
 
 <Image
   alt="嵌套错误组件层级结构"
@@ -276,7 +276,7 @@ export default function Error({ error, reset }) {
 
 ### 全局错误
 
-虽然不常见，但您可以使用根应用目录中的 [`global-error.js`](/docs/app/api-reference/file-conventions/error#global-error) 文件处理根布局中的错误，即使在使用[国际化](/docs/app/building-your-application/routing/internationalization)时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签，因为它在激活时会替换根布局或模板。
+虽然不常见，但您可以通过根应用目录中的 [`global-error.js`](/docs/app/api-reference/file-conventions/error#global-error) 文件处理根布局中的错误，即使在使用 [国际化 (internationalization)](/docs/app/guides/internationalization) 时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签，因为它在激活时会替换根布局或模板。
 
 ```tsx filename="app/global-error.tsx" switcher
 'use client' // 错误边界必须是客户端组件
@@ -292,8 +292,8 @@ export default function GlobalError({
     // global-error 必须包含 html 和 body 标签
     <html>
       <body>
-        <h2>Something went wrong!</h2>
-        <button onClick={() => reset()}>Try again</button>
+        <h2>出错了！</h2>
+        <button onClick={() => reset()}>重试</button>
       </body>
     </html>
   )
@@ -308,10 +308,10 @@ export default function GlobalError({ error, reset }) {
     // global-error 必须包含 html 和 body 标签
     <html>
       <body>
-        <h2>Something went wrong!</h2>
-        <button onClick={() => reset()}>Try again</button>
+        <h2>出错了！</h2>
+        <button onClick={() => reset()}>重试</button>
       </body>
     </html>
   )
 }
-```
+```
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/incremental-static-regeneration.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/incremental-static-regeneration.mdx
index b016a1a7..5aa3f78c 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/incremental-static-regeneration.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/incremental-static-regeneration.mdx
@@ -1,8 +1,9 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:51:15.382Z
-title: 增量静态再生 (ISR)
-description: 了解如何通过增量静态再生在运行时创建或更新静态页面。
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:18:43.136Z
+title: 如何实现增量静态再生 (ISR)
+nav_title: ISR
+description: 学习如何通过增量静态再生在运行时创建或更新静态页面。
 ---
 
 <details>
@@ -18,8 +19,8 @@ description: 了解如何通过增量静态再生在运行时创建或更新静
 
 - 无需重建整个站点即可更新静态内容
 - 通过为大多数请求提供预渲染的静态页面来减少服务器负载
-- 确保自动为页面添加正确的 `cache-control` 头
-- 处理大量内容页面而无需漫长的 `next build` 时间
+- 确保自动为页面添加正确的 `cache-control` 标头
+- 处理大量内容页面而无需长时间的 `next build` 构建
 
 以下是一个最小示例：
 
@@ -32,7 +33,7 @@ interface Post {
   content: string
 }
 
-// Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+// Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
 export const revalidate = 60
 
 // 我们仅在构建时预渲染来自 `generateStaticParams` 的参数。
@@ -68,7 +69,7 @@ export default async function Page({
 ```
 
 ```jsx filename="app/blog/[id]/page.js" switcher
-// Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+// Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
 export const revalidate = 60
 
 // 我们仅在构建时预渲染来自 `generateStaticParams` 的参数。
@@ -140,7 +141,7 @@ export const getStaticProps: GetStaticProps<Props> = async ({
 
   return {
     props: { post },
-    // Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+    // Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
     revalidate: 60,
   }
 }
@@ -176,7 +177,7 @@ export async function getStaticProps({ params }) {
 
   return {
     props: { post },
-    // Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+    // Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
     revalidate: 60,
   }
 }
@@ -193,13 +194,13 @@ export default function Page({ post }) {
 
 </PagesOnly>
 
-这个示例的工作原理：
+此示例的工作原理：
 
-1. 在 `next build` 期间，所有已知的博客文章都会被生成（此示例中有 25 篇）
-2. 对这些页面的所有请求（例如 `/blog/1`）都会被缓存并立即响应
+1. 在 `next build` 期间，所有已知的博客文章（本示例中有 25 篇）会被生成
+2. 对这些页面（例如 `/blog/1`）的所有请求都会被缓存并即时响应
 3. 60 秒后，下一个请求仍会显示缓存的（过时的）页面
 4. 缓存失效，新版本的页面开始在后台生成
-5. 生成成功后，Next.js 将显示并缓存更新后的页面
+5. 成功生成后，Next.js 将显示并缓存更新后的页面
 6. 如果请求 `/blog/26`，Next.js 将按需生成并缓存此页面
 
 ## 参考
@@ -233,7 +234,7 @@ export default function Page({ post }) {
 
 ### 基于时间的重新验证
 
-此示例在 `/blog` 上获取并显示博客文章列表。一小时后，该页面的缓存在下一次访问时失效。然后，在后台生成包含最新博客文章的新版本页面。
+此示例在 `/blog` 上获取并显示博客文章列表。一小时后，此页面的缓存将在下一次访问时失效。然后，在后台，将使用最新的博客文章生成新版本的页面。
 
 ```tsx filename="app/blog/page.tsx" switcher
 interface Post {
@@ -285,7 +286,7 @@ export default async function Page() {
 
 对于更精确的重新验证方法，可以使用 `revalidatePath` 函数按需使页面失效。
 
-例如，此服务器操作将在添加新文章后调用。无论您在服务器组件中使用 `fetch` 还是连接到数据库来获取数据，这将清除整个路由的缓存，并允许服务器组件获取新数据。
+例如，此服务器操作将在添加新文章后调用。无论您在服务器组件中使用 `fetch` 还是连接到数据库获取数据，这将清除整个路由的缓存，并允许服务器组件获取新数据。
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -309,7 +310,7 @@ export async function createPost() {
 }
 ```
 
-[查看演示](https://on-demand-isr.vercel.app) 和 [探索源代码](https://github.com/vercel/on-demand-isr)。
+[查看演示](https://on-demand-isr.vercel.app) 并 [探索源代码](https://github.com/vercel/on-demand-isr)。
 
 ### 使用 `revalidateTag` 进行按需重新验证
 
@@ -373,7 +374,7 @@ export default async function Page() {
 }
 ```
 
-然后可以在[服务器操作](/docs/app/building-your-application/data-fetching/server-actions-and-mutations)或[路由处理程序](/docs/app/building-your-application/routing/route-handlers)中使用 `revalidateTag`：
+然后可以在[服务器操作](/docs/app/building-your-application/data-fetching/server-actions-and-mutations)或[路由处理器](/docs/app/building-your-application/routing/route-handlers)中使用 `revalidateTag`：
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -381,7 +382,7 @@ export default async function Page() {
 import { revalidateTag } from 'next/cache'
 
 export async function createPost() {
-  // 使缓存中标记为 'posts' 的所有数据失效
+  // 使缓存中所有标记为 'posts' 的数据失效
   revalidateTag('posts')
 }
 ```
@@ -392,7 +393,7 @@ export async function createPost() {
 import { revalidateTag } from 'next/cache'
 
 export async function createPost() {
-  // 使缓存中标记为 'posts' 的所有数据失效
+  // 使缓存中所有标记为 'posts' 的数据失效
   revalidateTag('posts')
 }
 ```
@@ -405,7 +406,7 @@ export async function createPost() {
 
 对于更精确的重新验证方法，可以使用 `res.revalidate` 从 API 路由按需生成新页面。
 
-例如，可以调用此 API 路由 `/api/revalidate?secret=<token>` 来重新验证给定的博客文章。创建一个只有您的 Next.js 应用知道的密钥令牌。此密钥将用于防止未经授权访问重新验证 API 路由。
+例如，可以调用 `/api/revalidate?secret=<token>` 此 API 路由来重新验证给定的博客文章。创建一个只有您的 Next.js 应用知道的密钥令牌。此密钥将用于防止未经授权访问重新验证 API 路由。
 
 ```ts filename="pages/api/revalidate.ts" switcher
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -414,19 +415,19 @@ export default async function handler(
   req: NextApiRequest,
   res: NextApiResponse
 ) {
-  // 检查密钥以确认这是一个有效请求
+  // 检查密钥以确认这是有效请求
   if (req.query.secret !== process.env.MY_SECRET_TOKEN) {
     return res.status(401).json({ message: '无效令牌' })
   }
 
   try {
-    // 这应该是实际路径而非重写路径
+    // 这应该是实际路径而不是重写路径
     // 例如，对于 "/posts/[id]"，这应该是 "/posts/1"
     await res.revalidate('/posts/1')
     return res.json({ revalidated: true })
   } catch (err) {
     // 如果发生错误，Next.js 将继续
-    // 显示最后成功生成的页面
+    // 显示上次成功生成的页面
     return res.status(500).send('重新验证时出错')
   }
 }
@@ -434,19 +435,19 @@ export default async function handler(
 
 ```js filename="pages/api/revalidate.js" switcher
 export default async function handler(req, res) {
-  // 检查密钥以确认这是一个有效请求
+  // 检查密钥以确认这是有效请求
   if (req.query.secret !== process.env.MY_SECRET_TOKEN) {
     return res.status(401).json({ message: '无效令牌' })
   }
 
   try {
-    // 这应该是实际路径而非重写路径
+    // 这应该是实际路径而不是重写路径
     // 例如，对于 "/posts/[id]"，这应该是 "/posts/1"
     await res.revalidate('/posts/1')
     return res.json({ revalidated: true })
   } catch (err) {
     // 如果发生错误，Next.js 将继续
-    // 显示最后成功生成的页面
+    // 显示上次成功生成的页面
     return res.status(500).send('重新验证时出错')
   }
 }
@@ -460,13 +461,13 @@ export default async function handler(req, res) {
 
 <AppOnly>
 
-如果在尝试重新验证数据时抛出错误，将继续从缓存中提供最后成功生成的数据。在下一个后续请求中，Next.js 将重试重新验证数据。[了解更多关于错误处理的信息](/docs/app/building-your-application/routing/error-handling)。
+如果在尝试重新验证数据时抛出错误，将继续从缓存中提供上次成功生成的数据。在下一个后续请求中，Next.js 将重试重新验证数据。[了解更多关于错误处理的信息](/docs/app/building-your-application/routing/error-handling)。
 
 </AppOnly>
 
 <PagesOnly>
 
-如果在处理后台重新生成时 `getStaticProps` 内部发生错误，或者您手动抛出错误，将继续显示最后成功生成的页面。在下一个后续请求中，Next.js 将重试调用 `getStaticProps`。
+如果在处理后台重新生成时 `getStaticProps` 内部发生错误，或者您手动抛出错误，将继续显示上次成功生成的页面。在下一个后续请求中，Next.js 将重试调用 `getStaticProps`。
 
 ```tsx filename="pages/blog/[id].tsx" switcher
 import type { GetStaticProps } from 'next'
@@ -487,21 +488,21 @@ export const getStaticProps: GetStaticProps<Props> = async ({
   params: { id: string }
 }) => {
   // 如果此请求抛出未捕获的错误，Next.js 将
-  // 不会使当前显示的页面失效，并在
-  // 下一个请求时重试 getStaticProps。
+  // 不会使当前显示的页面失效，并且
+  // 在下一个请求上重试 getStaticProps。
   const res = await fetch(`https://api.vercel.app/blog/${params.id}`)
   const post: Post = await res.json()
 
   if (!res.ok) {
-    // 如果服务器错误，您可能希望
+    // 如果存在服务器错误，您可能希望
     // 抛出错误而不是返回，以便缓存不会更新
-    // 直到下一个成功的请求。
+    // 直到下一次成功请求。
     throw new Error(`获取文章失败，收到状态码 ${res.status}`)
   }
 
   return {
     props: { post },
-    // Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+    // Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
     revalidate: 60,
   }
 }
@@ -510,21 +511,21 @@ export const getStaticProps: GetStaticProps<Props> = async ({
 ```jsx filename="pages/blog/[id].jsx" switcher
 export async function getStaticProps({ params }) {
   // 如果此请求抛出未捕获的错误，Next.js 将
-  // 不会使当前显示的页面失效，并在
-  // 下一个请求时重试 getStaticProps。
+  // 不会使当前显示的页面失效，并且
+  // 在下一个请求上重试 getStaticProps。
   const res = await fetch(`https://api.vercel.app/blog/${params.id}`)
   const post = await res.json()
 
   if (!res.ok) {
-    // 如果服务器错误，您可能希望
+    // 如果存在服务器错误，您可能希望
     // 抛出错误而不是返回，以便缓存不会更新
-    // 直到下一个成功的请求。
+    // 直到下一次成功请求。
     throw new Error(`获取文章失败，收到状态码 ${res.status}`)
   }
 
   return {
     props: { post },
-    // Next.js 将在请求到来时使缓存失效，最多每 60 秒一次。
+    // Next.js 将在请求到达时使缓存失效，最多每 60 秒一次。
     revalidate: 60,
   }
 }
@@ -540,7 +541,7 @@ export async function getStaticProps({ params }) {
 
 ### 在本地开发中调试缓存数据
 
-如果使用 `fetch` API，可以添加额外的日志记录来了解哪些请求被缓存或未被缓存。[了解更多关于 `logging` 选项的信息](/docs/app/api-reference/config/next-config-js/logging)。
+如果使用 `fetch` API，可以添加额外的日志记录以了解哪些请求被缓存或未被缓存。[了解更多关于 `logging` 选项的信息](/docs/app/api-reference/config/next-config-js/logging)。
 
 ```jsx filename="next.config.js"
 module.exports = {
@@ -562,45 +563,45 @@ module.exports = {
 NEXT_PRIVATE_DEBUG_CACHE=1
 ```
 
-这将使 Next.js 服务器在控制台输出 ISR 缓存的命中与未命中情况。您可以检查输出结果，查看哪些页面是在 `next build` 期间生成的，以及访问路径时页面是如何按需更新的。
+这将使 Next.js 服务器在控制台输出 ISR 缓存的命中和未命中情况。您可以检查输出结果，查看哪些页面是在 `next build` 期间生成的，以及访问路径时页面是如何按需更新的。
 
 ## 注意事项
 
 <AppOnly>
 
-- ISR 仅在使用 Node.js 运行时（默认）时受支持。
+- ISR 仅在 Node.js 运行时（默认）下支持。
 - 创建 [静态导出 (Static Export)](/docs/app/guides/static-exports) 时不支持 ISR。
-- 如果在静态渲染的路由中有多个 `fetch` 请求，且每个请求的 `revalidate` 频率不同，则 ISR 会使用最短的时间。但这些重新验证频率仍会由 [数据缓存 (Data Cache)](/docs/app/deep-dive/caching#data-cache) 遵循。
-- 如果路由中使用的任何 `fetch` 请求的 `revalidate` 时间为 `0` 或显式设置为 `no-store`，则该路由将进行 [动态渲染 (dynamic rendering)](/docs/app/getting-started/partial-prerendering#dynamic-rendering)。
-- 按需 ISR 请求不会执行中间件，这意味着中间件中的任何路径重写或逻辑都不会生效。请确保重新验证的是确切路径。例如，使用 `/post/1` 而非重写后的 `/post-1`。
+- 如果在静态渲染的路由中有多个 `fetch` 请求，且每个请求的 `revalidate` 频率不同，ISR 将使用最短的时间。但这些重新验证频率仍会被 [数据缓存 (Data Cache)](/docs/app/deep-dive/caching#data-cache) 遵循。
+- 如果路由中使用的任何 `fetch` 请求的 `revalidate` 时间为 `0`，或显式设置为 `no-store`，则该路由将 [动态渲染 (dynamically rendered)](/docs/app/getting-started/partial-prerendering#dynamic-rendering)。
+- 中间件不会在按需 ISR 请求时执行，这意味着中间件中的任何路径重写或逻辑都不会生效。请确保您重新验证的是确切的路径。例如，使用 `/post/1` 而非重写后的 `/post-1`。
 
 </AppOnly>
 
 <PagesOnly>
 
-- ISR 仅在使用 Node.js 运行时（默认）时受支持。
+- ISR 仅在 Node.js 运行时（默认）下支持。
 - 创建 [静态导出 (Static Export)](/docs/app/guides/static-exports) 时不支持 ISR。
-- 按需 ISR 请求不会执行中间件，这意味着中间件中的任何路径重写或逻辑都不会生效。请确保重新验证的是确切路径。例如，使用 `/post/1` 而非重写后的 `/post-1`。
+- 中间件不会在按需 ISR 请求时执行，这意味着中间件中的任何路径重写或逻辑都不会生效。请确保您重新验证的是确切的路径。例如，使用 `/post/1` 而非重写后的 `/post-1`。
 
 </PagesOnly>
 
 ## 平台支持
 
-| 部署选项                                                      | 是否支持         |
-| ------------------------------------------------------------ | ---------------- |
-| [Node.js 服务器](/docs/app/getting-started/deploying#nodejs-server) | 是               |
-| [Docker 容器](/docs/app/getting-started/deploying#docker)      | 是               |
-| [静态导出](/docs/app/getting-started/deploying#static-export)  | 否               |
-| [适配器](/docs/app/getting-started/deploying#adapters)         | 视平台而定       |
+| 部署选项                                                                 | 是否支持          |
+| ----------------------------------------------------------------------- | ----------------- |
+| [Node.js 服务器](/docs/app/getting-started/deploying#nodejs-server)     | 是                |
+| [Docker 容器](/docs/app/getting-started/deploying#docker)               | 是                |
+| [静态导出](/docs/app/getting-started/deploying#static-export)           | 否                |
+| [适配器](/docs/app/getting-started/deploying#adapters)                  | 取决于具体平台    |
 
 了解如何 [配置 ISR](/docs/app/guides/self-hosting#caching-and-isr) 以自托管 Next.js。
 
 ## 版本历史
 
-| 版本       | 变更                                                                               |
-| ---------- | ---------------------------------------------------------------------------------- |
-| `v14.1.0`  | 自定义 `cacheHandler` 功能稳定。                                                   |
-| `v13.0.0`  | 引入了应用路由 (App Router)。                                                      |
-| `v12.2.0`  | 页面路由 (Pages Router)：按需 ISR 功能稳定                                         |
-| `v12.0.0`  | 页面路由 (Pages Router)：新增 [针对爬虫的 ISR 回退机制](/blog/next-12#bot-aware-isr-fallback)。 |
-| `v9.5.0`   | 页面路由 (Pages Router)：[正式引入 ISR 功能](/blog/next-9-5)。                     |
+| 版本       | 变更                                                                                 |
+| ---------- | ----------------------------------------------------------------------------------- |
+| `v14.1.0`  | 自定义 `cacheHandler` 功能稳定。                                                    |
+| `v13.0.0`  | 引入了应用路由 (App Router)。                                                       |
+| `v12.2.0`  | 页面路由 (Pages Router)：按需 ISR 功能稳定。                                        |
+| `v12.0.0`  | 页面路由：新增 [Bot-aware ISR 回退](/blog/next-12#bot-aware-isr-fallback) 功能。    |
+| `v9.5.0`   | 页面路由：[引入稳定的 ISR 功能](/blog/next-9-5)。                                    |
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/index.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/index.mdx
index 4fd38c25..a5ff0928 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/index.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/index.mdx
@@ -1,23 +1,23 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:03:48.700Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:04.383Z
 title: 指南
-description: 学习如何使用 Next.js 实现常见的 UI 模式和应用场景
+description: 学习如何使用 Next.js 实现常见的 UI 模式和使用场景
 ---
 
 ### 数据获取
 
-- [使用 `fetch` API](/docs/app/building-your-application/data-fetching/fetching#fetching-data-on-the-server-with-the-fetch-api)
-- [使用 ORM 或数据库客户端](/docs/app/building-your-application/data-fetching/fetching#fetching-data-on-the-server-with-an-orm-or-database)
+- [使用 `fetch` API](/docs/app/getting-started/fetching-data#with-the-fetch-api)
+- [使用 ORM 或数据库客户端](/docs/app/getting-started/fetching-data#with-an-orm-or-database)
 - [在服务端读取搜索参数](/docs/app/api-reference/file-conventions/page)
 - [在客户端读取搜索参数](/docs/app/api-reference/functions/use-search-params)
 
 ### 数据重新验证
 
-- [使用 ISR 定时重新验证数据](/docs/app/building-your-application/data-fetching/incremental-static-regeneration#time-based-revalidation)
-- [使用 ISR 按需重新验证数据](/docs/app/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)
+- [使用 ISR 定时重新验证数据](/docs/app/guides/incremental-static-regeneration#time-based-revalidation)
+- [使用 ISR 按需重新验证数据](/docs/app/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)
 
-### 表单
+### 表单处理
 
 - [提交表单时显示待处理状态](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#pending-states)
 - [服务端表单验证](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#server-side-form-validation)
@@ -26,15 +26,15 @@ description: 学习如何使用 Next.js 实现常见的 UI 模式和应用场景
 - [显示乐观 UI 更新](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#optimistic-updates)
 - [编程式表单提交](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#programmatic-form-submission)
 
-### 服务端操作 (Server Actions)
+### 服务端操作
 
 - [传递额外参数](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#passing-additional-arguments)
 - [重新验证数据](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#revalidating-data)
-- [重定向](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#redirecting)
+- [重定向处理](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#redirecting)
 - [设置 Cookies](/docs/app/api-reference/functions/cookies#setting-a-cookie)
 - [删除 Cookies](/docs/app/api-reference/functions/cookies#deleting-cookies)
 
-### 元数据 (Metadata)
+### 元数据
 
 - [创建 RSS 订阅源](/docs/app/building-your-application/routing/route-handlers#non-ui-responses)
 - [创建 Open Graph 图片](/docs/app/api-reference/file-conventions/metadata/opengraph-image)
@@ -43,12 +43,12 @@ description: 学习如何使用 Next.js 实现常见的 UI 模式和应用场景
 - [创建自定义 404 页面](/docs/app/api-reference/file-conventions/not-found)
 - [创建自定义 500 页面](/docs/app/api-reference/file-conventions/error)
 
-### 认证 (Auth)
+### 认证授权
 
 - [创建注册表单](/docs/app/guides/authentication#sign-up-and-login-functionality)
-- [无状态基于 Cookie 的会话管理](/docs/app/guides/authentication#stateless-sessions)
-- [有状态基于数据库的会话管理](/docs/app/guides/authentication#database-sessions)
-- [管理授权](/docs/app/guides/authentication#authorization)
+- [无状态 Cookie 会话管理](/docs/app/guides/authentication#stateless-sessions)
+- [基于数据库的有状态会话管理](/docs/app/guides/authentication#database-sessions)
+- [权限管理](/docs/app/guides/authentication#authorization)
 
 ### 测试
 
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/internationalization.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/internationalization.mdx
index acc082df..742cb4f3 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/internationalization.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/internationalization.mdx
@@ -1,24 +1,24 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:49:56.235Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:25.701Z
 title: 国际化
 description: 通过国际化路由和本地化内容添加多语言支持。
 ---
 
-Next.js 允许您配置路由和内容渲染以支持多语言。使您的网站适应不同区域设置包括翻译内容（本地化）和国际化路由。
+Next.js 允许您配置路由和内容渲染以支持多种语言。使您的网站适应不同区域设置包括翻译内容（本地化）和国际化路由。
 
 ## 术语
 
-- **区域设置 (Locale):** 一组语言和格式偏好的标识符。通常包括用户首选语言及其可能的地理区域。
+- **区域设置 (Locale):** 用于标识一组语言和格式偏好的标识符。通常包括用户首选语言及其可能的地理区域。
   - `en-US`: 美国使用的英语
   - `nl-NL`: 荷兰使用的荷兰语
   - `nl`: 荷兰语，无特定区域
 
 ## 路由概述
 
-建议使用浏览器中的用户语言偏好来选择区域设置。更改首选语言将修改应用程序接收到的 `Accept-Language` 请求头。
+建议使用浏览器中的用户语言偏好来选择区域设置。更改首选语言会修改发送到您应用的 `Accept-Language` 请求头。
 
-例如，使用以下库可以检查传入的 `Request`，根据请求头、计划支持的区域设置和默认区域设置来决定选择哪个区域。
+例如，使用以下库可以根据请求头 `Headers`、您计划支持的区域设置和默认区域设置，检查传入的 `Request` 以确定选择哪个区域设置。
 
 ```js filename="middleware.js"
 import { match } from '@formatjs/intl-localematcher'
@@ -32,7 +32,7 @@ let defaultLocale = 'en-US'
 match(languages, locales, defaultLocale) // -> 'en-US'
 ```
 
-路由可以通过子路径 (`/fr/products`) 或域名 (`my-site.fr/products`) 实现国际化。利用这些信息，您现在可以基于[中间件](/docs/app/building-your-application/routing/middleware)中的区域设置重定向用户。
+路由可以通过子路径 (`/fr/products`) 或域名 (`my-site.fr/products`) 实现国际化。有了这些信息，您现在可以根据 [中间件](/docs/app/building-your-application/routing/middleware) 中的区域设置重定向用户。
 
 ```js filename="middleware.js"
 import { NextResponse } from "next/server";
@@ -43,7 +43,7 @@ let locales = ['en-US', 'nl-NL', 'nl']
 function getLocale(request) { ... }
 
 export function middleware(request) {
-  // 检查路径中是否存在支持的区域设置
+  // 检查路径中是否有支持的区域设置
   const { pathname } = request.nextUrl
   const pathnameHasLocale = locales.some(
     (locale) => pathname.startsWith(`/${locale}/`) || pathname === `/${locale}`
@@ -51,11 +51,11 @@ export function middleware(request) {
 
   if (pathnameHasLocale) return
 
-  // 无区域设置时重定向
+  // 如果没有区域设置则重定向
   const locale = getLocale(request)
   request.nextUrl.pathname = `/${locale}${pathname}`
-  // 例如：传入请求为 /products
-  // 新 URL 变为 /en-US/products
+  // 例如传入请求是 /products
+  // 新 URL 现在是 /en-US/products
   return NextResponse.redirect(request.nextUrl)
 }
 
@@ -63,17 +63,17 @@ export const config = {
   matcher: [
     // 跳过所有内部路径 (_next)
     '/((?!_next).*)',
-    // 可选：仅在根 URL (/) 运行
+    // 可选：仅在根 URL (/) 上运行
     // '/'
   ],
 }
 ```
 
-最后，确保 `app/` 下的所有特殊文件都嵌套在 `app/[lang]` 目录下。这使得 Next.js 路由器能够动态处理路由中的不同区域设置，并将 `lang` 参数传递给每个布局和页面。例如：
+最后，确保 `app/` 下的所有特殊文件都嵌套在 `app/[lang]` 下。这使得 Next.js 路由器能够动态处理路由中的不同区域设置，并将 `lang` 参数传递给每个布局和页面。例如：
 
 ```tsx filename="app/[lang]/page.tsx" switcher
 // 您现在可以访问当前区域设置
-// 例如 /en-US/products -> `lang` 为 "en-US"
+// 例如 /en-US/products -> `lang` 是 "en-US"
 export default async function Page({
   params,
 }: {
@@ -86,7 +86,7 @@ export default async function Page({
 
 ```jsx filename="app/[lang]/page.js" switcher
 // 您现在可以访问当前区域设置
-// 例如 /en-US/products -> `lang` 为 "en-US"
+// 例如 /en-US/products -> `lang` 是 "en-US"
 export default async function Page({ params }) {
   const { lang } = await params
   return ...
@@ -97,9 +97,9 @@ export default async function Page({ params }) {
 
 ## 本地化
 
-根据用户首选区域设置更改显示内容（即本地化）并非 Next.js 特有功能。以下描述的模式适用于任何 Web 应用程序。
+根据用户首选区域设置更改显示内容（即本地化）并非 Next.js 特有功能。以下描述的模式在任何 Web 应用中同样适用。
 
-假设我们希望在应用程序中同时支持英语和荷兰语内容。我们可以维护两个不同的“字典”，这些字典对象提供了从某个键到本地化字符串的映射。例如：
+假设我们希望应用中同时支持英语和荷兰语内容。我们可以维护两个不同的“字典”，这些字典是从某个键到本地化字符串的映射对象。例如：
 
 ```json filename="dictionaries/en.json"
 {
@@ -168,9 +168,9 @@ export default async function Page({ params }) {
 }
 ```
 
-由于 `app/` 目录中的所有布局和页面默认都是[服务器组件](/docs/app/getting-started/server-and-client-components)，我们无需担心翻译文件的大小影响客户端 JavaScript 包大小。此代码**仅在服务器上运行**，只有生成的 HTML 会发送到浏览器。
+由于 `app/` 目录中的所有布局和页面默认都是 [服务端组件](/docs/app/getting-started/server-and-client-components)，我们无需担心翻译文件的大小会影响客户端 JavaScript 包的大小。此代码 **仅在服务器上运行**，只有生成的 HTML 会发送到浏览器。
 
-## 静态生成
+## 静态渲染
 
 要为给定的一组区域设置生成静态路由，我们可以在任何页面或布局中使用 `generateStaticParams`。这可以是全局的，例如在根布局中：
 
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/app-router-migration.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/app-router-migration.mdx
index ae65446c..6e3c41fc 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/app-router-migration.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/app-router-migration.mdx
@@ -1,18 +1,18 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T23:00:04.349Z
-title: 如何从 Pages 路由迁移到 App 路由
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:25:27.767Z
+title: 如何从 Pages 路由迁移至 App 路由
 nav_title: App 路由
-description: 了解如何将现有的 Next.js 应用从 Pages 路由升级到 App 路由。
+description: 学习如何将现有的 Next.js 应用从 Pages 路由升级至 App 路由。
 ---
 
 本指南将帮助您：
 
-- [将 Next.js 应用从版本 12 更新到版本 13](#nextjs-version)
+- [将 Next.js 应用从版本 12 升级至版本 13](#nextjs-version)
 - [升级同时适用于 `pages` 和 `app` 目录的功能](#upgrading-new-features)
-- [将现有应用从 `pages` 逐步迁移到 `app`](#migrating-from-pages-to-app)
+- [将现有应用从 `pages` 逐步迁移至 `app`](#migrating-from-pages-to-app)
 
-## 升级步骤
+## 升级准备
 
 ### Node.js 版本要求
 
@@ -20,7 +20,7 @@ description: 了解如何将现有的 Next.js 应用从 Pages 路由升级到 Ap
 
 ### Next.js 版本升级
 
-要更新到 Next.js 13 版本，请使用您偏好的包管理器运行以下命令：
+要升级至 Next.js 13 版本，请使用您偏好的包管理器运行以下命令：
 
 ```bash filename="终端"
 npm install next@latest react@latest react-dom@latest
@@ -28,41 +28,41 @@ npm install next@latest react@latest react-dom@latest
 
 ### ESLint 版本升级
 
-如果您使用 ESLint，需要升级 ESLint 版本：
+如果使用 ESLint，需要升级 ESLint 版本：
 
 ```bash filename="终端"
 npm install -D eslint-config-next@latest
 ```
 
-> **须知**：您可能需要重启 VS Code 中的 ESLint 服务器才能使更改生效。打开命令面板（Mac 上按 `cmd+shift+p`；Windows 上按 `ctrl+shift+p`）并搜索 `ESLint: 重启 ESLint 服务器`。
+> **须知**：您可能需要重启 VS Code 中的 ESLint 服务器使更改生效。打开命令面板（Mac 使用 `cmd+shift+p`；Windows 使用 `ctrl+shift+p`）并搜索 `ESLint: 重启 ESLint 服务器`。
 
 ## 后续步骤
 
-更新完成后，请参阅以下部分进行后续操作：
+升级完成后，请参考以下章节进行后续操作：
 
-- [升级新功能](#upgrading-new-features)：帮助您升级到新功能的指南，例如改进的 Image 和 Link 组件。
-- [从 `pages` 迁移到 `app` 目录](#migrating-from-pages-to-app)：逐步指南，帮助您从 `pages` 目录逐步迁移到 `app` 目录。
+- [升级新功能](#upgrading-new-features)：指导您升级至改进后的 Image 组件、Link 组件等新功能。
+- [从 `pages` 迁移至 `app` 目录](#migrating-from-pages-to-app)：分步指南帮助您逐步从 `pages` 迁移至 `app` 目录。
 
 ## 升级新功能
 
-Next.js 13 引入了新的 [App 路由](/docs/app/building-your-application/routing)，包含新功能和约定。新路由位于 `app` 目录中，可与 `pages` 目录共存。
+Next.js 13 引入了新的 [App 路由 (App Router)](/docs/app/building-your-application/routing)，包含新功能和约定。新路由在 `app` 目录中可用，并与 `pages` 目录共存。
 
-升级到 Next.js 13 **不**强制要求使用 App 路由。您可以继续使用 `pages` 目录，同时享受适用于两个目录的新功能，例如更新的 [Image 组件](#image-component)、[Link 组件](#link-component)、[Script 组件](#script-component) 和 [字体优化](#font-optimization)。
+升级至 Next.js 13 **不强制** 要求使用 App 路由。您可以继续使用 `pages` 目录，同时享受适用于两个目录的新功能，例如更新后的 [Image 组件](#image-component)、[Link 组件](#link-component)、[Script 组件](#script-component) 和 [字体优化 (Font optimization)](#font-optimization)。
 
 ### `<Image/>` 组件
 
-Next.js 12 通过临时导入 `next/future/image` 对 Image 组件进行了改进。这些改进包括减少客户端 JavaScript、更简单的图像扩展和样式设置、更好的可访问性以及原生浏览器懒加载。
+Next.js 12 通过临时导入 `next/future/image` 对 Image 组件进行了改进。这些改进包括减少客户端 JavaScript、更简便的图像扩展和样式设置、更好的可访问性以及原生浏览器懒加载。
 
 在版本 13 中，这些新行为已成为 `next/image` 的默认行为。
 
-有两个代码修改工具可帮助您迁移到新的 Image 组件：
+有两个代码修改工具 (codemod) 可帮助您迁移至新的 Image 组件：
 
-- [**`next-image-to-legacy-image` 代码修改工具**](/docs/app/guides/upgrading/codemods#next-image-to-legacy-image)：安全自动地将 `next/image` 导入重命名为 `next/legacy/image`，现有组件将保持相同行为。
-- [**`next-image-experimental` 代码修改工具**](/docs/app/guides/upgrading/codemods#next-image-experimental)：危险地添加内联样式并移除未使用的属性。这将更改现有组件的行为以匹配新默认值。使用此工具前需先运行 `next-image-to-legacy-image` 代码修改工具。
+- [**`next-image-to-legacy-image` codemod**](/docs/app/guides/upgrading/codemods#next-image-to-legacy-image)：安全自动地将 `next/image` 导入重命名为 `next/legacy/image`，现有组件将保持相同行为。
+- [**`next-image-experimental` codemod**](/docs/app/guides/upgrading/codemods#next-image-experimental)：风险较高地添加内联样式并移除未使用的属性。这将改变现有组件的行为以匹配新默认值。使用此 codemod 前需先运行 `next-image-to-legacy-image` codemod。
 
 ### `<Link>` 组件
 
-[`<Link>` 组件](/docs/app/building-your-application/routing/linking-and-navigating#link-component) 不再需要手动添加 `<a>` 标签作为子元素。此行为在 [12.2 版本](https://nextjs.org/blog/next-12-2) 中作为实验性选项添加，现已成为默认行为。在 Next.js 13 中，`<Link>` 始终渲染 `<a>` 并允许您将属性传递给底层标签。
+[`<Link>` 组件](/docs/app/building-your-application/routing/linking-and-navigating#link-component) 不再需要手动添加 `<a>` 标签作为子元素。此行为在 [12.2 版本](https://nextjs.org/blog/next-12-2) 作为实验性选项引入，现已成为默认行为。在 Next.js 13 中，`<Link>` 始终渲染 `<a>` 并允许您将属性传递给底层标签。
 
 例如：
 
@@ -80,62 +80,62 @@ import Link from 'next/link'
 </Link>
 ```
 
-要将链接升级到 Next.js 13，可以使用 [`new-link` 代码修改工具](/docs/app/guides/upgrading/codemods#new-link)。
+要升级至 Next.js 13 的链接，可以使用 [`new-link` codemod](/docs/app/guides/upgrading/codemods#new-link)。
 
 ### `<Script>` 组件
 
-[`next/script`](/docs/app/api-reference/components/script) 的行为已更新以支持 `pages` 和 `app`，但需进行一些更改以确保顺利迁移：
+[`next/script`](/docs/app/api-reference/components/script) 的行为已更新以同时支持 `pages` 和 `app`，但需进行一些更改以确保平滑迁移：
 
-- 将之前包含在 `_document.js` 中的任何 `beforeInteractive` 脚本移动到根布局文件 (`app/layout.tsx`)。
-- 实验性的 `worker` 策略尚不支持 `app` 目录，使用此策略的脚本需移除或修改为使用其他策略（例如 `lazyOnload`）。
-- `onLoad`、`onReady` 和 `onError` 处理程序在服务端组件中不起作用，因此需将它们移动到 [客户端组件](/docs/app/getting-started/server-and-client-components) 或完全移除。
+- 将之前包含在 `_document.js` 中的任何 `beforeInteractive` 脚本移至根布局文件 (`app/layout.tsx`)。
+- 实验性的 `worker` 策略尚不适用于 `app`，使用此策略的脚本需移除或修改为使用其他策略（如 `lazyOnload`）。
+- `onLoad`、`onReady` 和 `onError` 处理程序在服务端组件 (Server Components) 中无效，需将其移至 [客户端组件 (Client Component)](/docs/app/getting-started/server-and-client-components) 或完全移除。
 
 ### 字体优化
 
-之前，Next.js 通过 [内联字体 CSS](/docs/app/api-reference/components/font) 帮助优化字体。版本 13 引入了新的 [`next/font`](/docs/app/api-reference/components/font) 模块，让您能够自定义字体加载体验，同时仍确保出色的性能和隐私。`next/font` 同时支持 `pages` 和 `app` 目录。
+此前，Next.js 通过 [内联字体 CSS](/docs/app/api-reference/components/font) 帮助优化字体。版本 13 引入了新的 [`next/font`](/docs/app/api-reference/components/font) 模块，让您能自定义字体加载体验，同时确保出色的性能和隐私。`next/font` 同时支持 `pages` 和 `app` 目录。
 
-虽然 [内联 CSS](/docs/app/api-reference/components/font) 在 `pages` 中仍然有效，但在 `app` 中不起作用。您应改用 [`next/font`](/docs/app/api-reference/components/font)。
+虽然 [内联 CSS](/docs/app/api-reference/components/font) 在 `pages` 中仍有效，但在 `app` 中无效。应改用 [`next/font`](/docs/app/api-reference/components/font)。
 
 参阅 [字体优化](/docs/app/api-reference/components/font) 页面了解如何使用 `next/font`。
 
-## 从 `pages` 迁移到 `app`
+## 从 `pages` 迁移至 `app`
 
-> **🎥 观看视频**：了解如何逐步采用 App 路由 → [YouTube (16 分钟)](https://www.youtube.com/watch?v=YQMSietiFm0)。
+> **🎥 观看视频**：学习如何逐步采用 App 路由 → [YouTube (16 分钟)](https://www.youtube.com/watch?v=YQMSietiFm0)。
 
-迁移到 App 路由可能是首次使用 Next.js 基于 React 构建的功能，如服务端组件、Suspense 等。结合 Next.js 的新功能，如 [特殊文件](/docs/app/api-reference/file-conventions) 和 [布局](/docs/app/api-reference/file-conventions/layout)，迁移意味着需要学习新的概念、思维模式和行为变化。
+迁移至 App 路由可能是首次使用 Next.js 构建的 React 功能，如服务端组件 (Server Components)、Suspense 等。结合 Next.js 的新功能如 [特殊文件 (special files)](/docs/app/api-reference/file-conventions) 和 [布局 (layouts)](/docs/app/api-reference/file-conventions/layout)，迁移意味着需要学习新概念、思维模式和行为变化。
 
-我们建议通过将迁移分解为更小的步骤来降低这些更新的复杂性。`app` 目录的设计初衷是与 `pages` 目录同时工作，以实现逐页迁移。
+我们建议通过将迁移分解为更小的步骤来降低这些更新的综合复杂度。`app` 目录的设计初衷是与 `pages` 目录同时工作，支持逐页迁移。
 
 - `app` 目录支持嵌套路由 _和_ 布局。[了解更多](/docs/app/building-your-application/routing)。
-- 使用嵌套文件夹定义路由，并使用特殊的 `page.js` 文件使路由段公开可访问。[了解更多](#step-4-migrating-pages)。
-- [特殊文件约定](/docs/app/api-reference/file-conventions) 用于为每个路由段创建 UI。最常见的特殊文件是 `page.js` 和 `layout.js`。
-  - 使用 `page.js` 定义特定于路由的 UI。
+- 使用嵌套文件夹定义路由，并通过特殊的 `page.js` 文件使路由段公开可访问。[了解更多](#step-4-migrating-pages)。
+- [特殊文件约定 (special file conventions)](/docs/app/api-reference/file-conventions) 用于为每个路由段创建 UI。最常见的特殊文件是 `page.js` 和 `layout.js`。
+  - 使用 `page.js` 定义路由特有的 UI。
   - 使用 `layout.js` 定义跨多个路由共享的 UI。
-  - 特殊文件可使用 `.js`、`.jsx` 或 `.tsx` 文件扩展名。
+  - 特殊文件可使用 `.js`、`.jsx` 或 `.tsx` 扩展名。
 - 您可以在 `app` 目录中放置其他文件，如组件、样式、测试等。[了解更多](/docs/app/building-your-application/routing)。
 - 数据获取函数如 `getServerSideProps` 和 `getStaticProps` 已被 `app` 中的 [新 API](/docs/app/building-your-application/data-fetching) 取代。`getStaticPaths` 已被 [`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 取代。
-- `pages/_app.js` 和 `pages/_document.js` 已被单个 `app/layout.js` 根布局取代。[了解更多](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)。
+- `pages/_app.js` 和 `pages/_document.js` 已被单一的 `app/layout.js` 根布局取代。[了解更多](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)。
 - `pages/_error.js` 已被更细粒度的 `error.js` 特殊文件取代。[了解更多](/docs/app/building-your-application/routing/error-handling)。
 - `pages/404.js` 已被 [`not-found.js`](/docs/app/api-reference/file-conventions/not-found) 文件取代。
 - `pages/api/*` API 路由已被 [`route.js`](/docs/app/api-reference/file-conventions/route)（路由处理程序）特殊文件取代。
 
 ### 步骤 1：创建 `app` 目录
 
-更新到最新的 Next.js 版本（需要 13.4 或更高版本）：
+更新至最新 Next.js 版本（需 13.4 或更高）：
 
 ```bash
 npm install next@latest
 ```
 
-然后，在项目根目录（或 `src/` 目录）中创建一个新的 `app` 目录。
+然后在项目根目录（或 `src/` 目录）创建新的 `app` 目录。
 
 ### 步骤 2：创建根布局
 
-在 `app` 目录中创建一个新的 `app/layout.tsx` 文件。这是一个 [根布局](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)，将应用于 `app` 目录中的所有路由。
+在 `app` 目录中创建新的 `app/layout.tsx` 文件。这是一个 [根布局 (root layout)](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)，将应用于 `app` 内的所有路由。
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
-  // 布局必须接受 children 属性。
+  // 布局必须接受 children 属性
   // 这将填充嵌套布局或页面
   children,
 }: {
@@ -151,7 +151,7 @@ export default function RootLayout({
 
 ```jsx filename="app/layout.js" switcher
 export default function RootLayout({
-  // 布局必须接受 children 属性。
+  // 布局必须接受 children 属性
   // 这将填充嵌套布局或页面
   children,
 }) {
@@ -163,7 +163,7 @@ export default function RootLayout({
 }
 ```
 
-- `app` 目录 **必须** 包含一个根布局。
+- `app` 目录 **必须** 包含根布局。
 - 根布局必须定义 `<html>` 和 `<body>` 标签，因为 Next.js 不会自动创建它们。
 - 根布局取代了 `pages/_app.tsx` 和 `pages/_document.tsx` 文件。
 - 布局文件可使用 `.js`、`.jsx` 或 `.tsx` 扩展名。
@@ -188,13 +188,13 @@ export const metadata = {
 
 #### 迁移 `_document.js` 和 `_app.js`
 
-如果您有现有的 `_app` 或 `_document` 文件，可以将内容（如全局样式）复制到根布局 (`app/layout.tsx`)。`app/layout.tsx` 中的样式 **不会** 应用于 `pages/*`。在迁移过程中应保留 `_app`/`_document` 以防止 `pages/*` 路由中断。完全迁移后，可安全删除它们。
+如果有现有的 `_app` 或 `_document` 文件，可以将内容（如全局样式）复制到根布局 (`app/layout.tsx`)。`app/layout.tsx` 中的样式 **不会** 应用于 `pages/*`。迁移期间应保留 `_app`/`_document` 以防止 `pages/*` 路由中断。完全迁移后可安全删除它们。
 
-如果您使用任何 React Context 提供者，需要将它们移动到 [客户端组件](/docs/app/getting-started/server-and-client-components)。
+如果使用任何 React Context 提供者，需将其移至 [客户端组件 (Client Component)](/docs/app/getting-started/server-and-client-components)。
 
-#### 将 `getLayout()` 模式迁移到布局（可选）
+#### 将 `getLayout()` 模式迁移至布局（可选）
 
-Next.js 建议在 `pages` 目录中 [向页面组件添加属性](/docs/pages/building-your-application/routing/pages-and-layouts#layout-pattern#per-page-layouts) 以实现每页布局。此模式可替换为 `app` 目录中对 [嵌套布局](/docs/app/building-your-application/routing/layouts-and-templates#layouts) 的原生支持。
+Next.js 建议在 `pages` 目录中 [为页面组件添加属性](/docs/pages/building-your-application/routing/pages-and-layouts#layout-pattern#per-page-layouts) 实现每页布局。此模式可被 `app` 目录中 [嵌套布局 (nested layouts)](/docs/app/building-your-application/routing/layouts-and-templates#layouts) 的原生支持取代。
 
 <details>
   <summary>查看前后示例</summary>
@@ -226,7 +226,7 @@ Page.getLayout = function getLayout(page) {
 
 **迁移后**
 
-- 从 `pages/dashboard/index.js` 中移除 `Page.getLayout` 属性，并按照 [迁移页面的步骤](#step-4-migrating-pages) 将其迁移到 `app` 目录。
+- 从 `pages/dashboard/index.js` 移除 `Page.getLayout` 属性，并按照 [迁移页面的步骤](#step-4-migrating-pages) 将其移至 `app` 目录。
 
   ```jsx filename="app/dashboard/page.js"
   export default function Page() {
@@ -234,10 +234,10 @@ Page.getLayout = function getLayout(page) {
   }
   ```
 
-- 将 `DashboardLayout` 的内容移动到新的 [客户端组件](/docs/app/getting-started/server-and-client-components) 以保留 `pages` 目录的行为。
+- 将 `DashboardLayout` 的内容移至新的 [客户端组件 (Client Component)](/docs/app/getting-started/server-and-client-components) 以保留 `pages` 目录的行为。
 
   ```jsx filename="app/dashboard/DashboardLayout.js"
-  'use client' // 此指令应位于文件顶部，在任何导入之前。
+  'use client' // 此指令应位于文件顶部，任何导入之前
 
   // 这是一个客户端组件
   export default function DashboardLayout({ children }) {
@@ -250,7 +250,7 @@ Page.getLayout = function getLayout(page) {
   }
   ```
 
-- 将 `DashboardLayout` 导入到 `app` 目录中的新 `layout.js` 文件。
+- 将 `DashboardLayout` 导入 `app` 目录中的新 `layout.js` 文件。
 
   ```jsx filename="app/dashboard/layout.js"
   import DashboardLayout from './DashboardLayout'
@@ -261,13 +261,13 @@ Page.getLayout = function getLayout(page) {
   }
   ```
 
-- 您可以逐步将 `DashboardLayout.js`（客户端组件）中的非交互部分移动到 `layout.js`（服务端组件）中，以减少发送到客户端的组件 JavaScript 数量。
+- 可以逐步将 `DashboardLayout.js`（客户端组件）中的非交互部分移至 `layout.js`（服务端组件），以减少发送至客户端的组件 JavaScript 量。
 
 </details>
 
 ### 步骤 3：迁移 `next/head`
 
-在 `pages` 目录中，`next/head` React 组件用于管理 `<head>` HTML 元素，如 `title` 和 `meta`。在 `app` 目录中，`next/head` 被新的 [内置 SEO 支持](/docs/app/getting-started/metadata-and-og-images) 取代。
+在 `pages` 目录中，`next/head` React 组件用于管理 `<head>` HTML 元素如 `title` 和 `meta`。在 `app` 目录中，`next/head` 被新的 [内置 SEO 支持](/docs/app/getting-started/metadata-and-og-images) 取代。
 
 **迁移前：**
 
@@ -325,28 +325,28 @@ export default function Page() {
 
 [查看所有元数据选项](/docs/app/api-reference/functions/generate-metadata)。
 
-### 步骤 4：迁移页面
+### 第4步：迁移页面
 
-- [`app` 目录](/docs/app/building-your-application/routing) 中的页面默认是 [服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components)。这与 `pages` 目录不同，后者中的页面是 [客户端组件 (Client Components)](/docs/app/getting-started/server-and-client-components)。
+- [`app` 目录](/docs/app/building-your-application/routing)中的页面默认是[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components)。这与 `pages` 目录不同，后者中的页面是[客户端组件 (Client Components)](/docs/app/getting-started/server-and-client-components)。
 - [`app` 目录中的数据获取 (Data fetching)](/docs/app/building-your-application/data-fetching) 已发生变化。`getServerSideProps`、`getStaticProps` 和 `getInitialProps` 已被更简单的 API 取代。
-- `app` 目录使用嵌套文件夹定义路由，并通过特殊的 `page.js` 文件使路由段公开可访问。
-- | `pages` 目录      | `app` 目录            | 路由           |
-  | ----------------- | --------------------- | -------------- |
-  | `index.js`        | `page.js`             | `/`            |
-  | `about.js`        | `about/page.js`       | `/about`       |
-  | `blog/[slug].js`  | `blog/[slug]/page.js` | `/blog/post-1` |
+- `app` 目录使用嵌套文件夹来定义路由，并使用特殊的 `page.js` 文件使路由段可公开访问。
+- | `pages` 目录       | `app` 目录             | 路由            |
+  | ------------------ | ---------------------- | --------------- |
+  | `index.js`         | `page.js`              | `/`             |
+  | `about.js`         | `about/page.js`        | `/about`        |
+  | `blog/[slug].js`   | `blog/[slug]/page.js`  | `/blog/post-1`  |
 
-我们建议将页面的迁移分为两个主要步骤：
+我们建议将页面迁移分为两个主要步骤：
 
-- 步骤 1：将默认导出的页面组件移至新的客户端组件中。
-- 步骤 2：将新的客户端组件导入到 `app` 目录中的新 `page.js` 文件。
+- 步骤1：将默认导出的页面组件移至新的客户端组件中。
+- 步骤2：将新的客户端组件导入到 `app` 目录中的新 `page.js` 文件。
 
 > **须知**：这是最简单的迁移路径，因为它的行为与 `pages` 目录最为相似。
 
-**步骤 1：创建新的客户端组件**
+**步骤1：创建新的客户端组件**
 
 - 在 `app` 目录中创建一个新的独立文件（例如 `app/home-page.tsx` 或类似文件），并导出一个客户端组件。要定义客户端组件，请在文件顶部（在任何导入之前）添加 `'use client'` 指令。
-  - 与 Pages Router 类似，有一个 [优化步骤](/docs/app/getting-started/server-and-client-components#on-the-client-first-load) 可以在初始页面加载时将客户端组件预渲染为静态 HTML。
+  - 与 Pages Router 类似，有一个[优化步骤](/docs/app/getting-started/server-and-client-components#on-the-client-first-load)，可以在初始页面加载时将客户端组件预渲染为静态 HTML。
 - 将 `pages/index.js` 中的默认导出页面组件移至 `app/home-page.tsx`。
 
 ```tsx filename="app/home-page.tsx" switcher
@@ -382,14 +382,14 @@ export default function HomePage({ recentPosts }) {
 }
 ```
 
-**步骤 2：创建新页面**
+**步骤2：创建新页面**
 
 - 在 `app` 目录中创建一个新的 `app/page.tsx` 文件。默认情况下，这是一个服务端组件。
 - 将 `home-page.tsx` 客户端组件导入到页面中。
-- 如果您之前在 `pages/index.js` 中获取数据，请将数据获取逻辑直接移至服务端组件中，使用新的 [数据获取 API](/docs/app/building-your-application/data-fetching/fetching)。更多详情请参阅 [数据获取升级指南](#step-6-migrating-data-fetching-methods)。
+- 如果之前在 `pages/index.js` 中获取数据，请将数据获取逻辑直接移至服务端组件中，使用新的[数据获取 API](/docs/app/building-your-application/data-fetching/fetching)。详情请参阅[数据获取升级指南](#step-6-migrating-data-fetching-methods)。
 
   ```tsx filename="app/page.tsx" switcher
-  // 导入您的客户端组件
+  // 导入你的客户端组件
   import HomePage from './home-page'
 
   async function getPosts() {
@@ -401,13 +401,13 @@ export default function HomePage({ recentPosts }) {
   export default async function Page() {
     // 直接在服务端组件中获取数据
     const recentPosts = await getPosts()
-    // 将获取的数据传递给您的客户端组件
+    // 将获取的数据传递给客户端组件
     return <HomePage recentPosts={recentPosts} />
   }
   ```
 
   ```jsx filename="app/page.js" switcher
-  // 导入您的客户端组件
+  // 导入你的客户端组件
   import HomePage from './home-page'
 
   async function getPosts() {
@@ -419,25 +419,25 @@ export default function HomePage({ recentPosts }) {
   export default async function Page() {
     // 直接在服务端组件中获取数据
     const recentPosts = await getPosts()
-    // 将获取的数据传递给您的客户端组件
+    // 将获取的数据传递给客户端组件
     return <HomePage recentPosts={recentPosts} />
   }
   ```
 
-- 如果您的旧页面使用了 `useRouter`，则需要更新为新的路由钩子。[了解更多](/docs/app/api-reference/functions/use-router)。
-- 启动开发服务器并访问 [`http://localhost:3000`](http://localhost:3000)。您应该会看到现有的索引路由，现在通过 `app` 目录提供服务。
+- 如果之前的页面使用了 `useRouter`，则需要更新为新的路由钩子。[了解更多](/docs/app/api-reference/functions/use-router)。
+- 启动开发服务器并访问 [`http://localhost:3000`](http://localhost:3000)。你应该会看到现有的索引路由，现在通过 `app` 目录提供服务。
 
-### 步骤 5：迁移路由钩子
+### 第5步：迁移路由钩子
 
-新增了一个路由器以支持 `app` 目录中的新行为。
+新增了一个路由器来支持 `app` 目录中的新行为。
 
-在 `app` 目录中，您应该使用从 `next/navigation` 导入的三个新钩子：[`useRouter()`](/docs/app/api-reference/functions/use-router)、[`usePathname()`](/docs/app/api-reference/functions/use-pathname) 和 [`useSearchParams()`](/docs/app/api-reference/functions/use-search-params)。
+在 `app` 目录中，你应该使用从 `next/navigation` 导入的三个新钩子：[`useRouter()`](/docs/app/api-reference/functions/use-router)、[`usePathname()`](/docs/app/api-reference/functions/use-pathname) 和 [`useSearchParams()`](/docs/app/api-reference/functions/use-search-params)。
 
 - 新的 `useRouter` 钩子从 `next/navigation` 导入，其行为与从 `next/router` 导入的 `pages` 中的 `useRouter` 钩子不同。
   - [从 `next/router` 导入的 `useRouter` 钩子](/docs/pages/api-reference/functions/use-router) 在 `app` 目录中不受支持，但可以继续在 `pages` 目录中使用。
 - 新的 `useRouter` 不返回 `pathname` 字符串。请改用单独的 `usePathname` 钩子。
 - 新的 `useRouter` 不返回 `query` 对象。搜索参数和动态路由参数现在是分开的。请改用 `useSearchParams` 和 `useParams` 钩子。
-- 您可以结合使用 `useSearchParams` 和 `usePathname` 来监听页面变化。更多详情请参阅 [路由事件](/docs/app/api-reference/functions/use-router#router-events) 部分。
+- 你可以结合使用 `useSearchParams` 和 `usePathname` 来监听页面变化。详情请参阅[路由事件](/docs/app/api-reference/functions/use-router#router-events)部分。
 - 这些新钩子仅在客户端组件中受支持，不能在服务端组件中使用。
 
 ```tsx filename="app/example-client-component.tsx" switcher
@@ -468,25 +468,25 @@ export default function ExampleClientComponent() {
 }
 ```
 
-此外，新的 `useRouter` 钩子还有以下变化：
+此外，新的 `useRouter` 钩子有以下变化：
 
-- `isFallback` 已被移除，因为 `fallback` 已被 [替换](#replacing-fallback)。
-- `locale`、`locales`、`defaultLocales` 和 `domainLocales` 值已被移除，因为 `app` 目录中不再需要内置的 Next.js i18n 功能。[了解更多关于 i18n 的信息](/docs/app/building-your-application/routing/internationalization)。
-- `basePath` 已被移除。替代方案将不属于 `useRouter`，目前尚未实现。
+- `isFallback` 已被移除，因为 `fallback` [已被替换](#replacing-fallback)。
+- `locale`、`locales`、`defaultLocales` 和 `domainLocales` 值已被移除，因为 `app` 目录中不再需要内置的 Next.js i18n 功能。[了解更多关于 i18n](/docs/app/guides/internationalization)。
+- `basePath` 已被移除。替代方案不会成为 `useRouter` 的一部分，目前尚未实现。
 - `asPath` 已被移除，因为新路由器中已移除 `as` 的概念。
-- `isReady` 已被移除，因为它不再必要。在 [静态渲染 (static rendering)](/docs/app/getting-started/partial-prerendering#static-rendering) 期间，任何使用 [`useSearchParams()`](/docs/app/api-reference/functions/use-search-params) 钩子的组件将跳过预渲染步骤，改为在运行时在客户端渲染。
+- `isReady` 已被移除，因为它不再必要。在[静态渲染 (static rendering)](/docs/app/getting-started/partial-prerendering#static-rendering) 期间，任何使用 [`useSearchParams()`](/docs/app/api-reference/functions/use-search-params) 钩子的组件将跳过预渲染步骤，改为在运行时在客户端渲染。
 - `route` 已被移除。可以使用 `usePathname` 或 `useSelectedLayoutSegments()` 作为替代。
 
 [查看 `useRouter()` API 参考](/docs/app/api-reference/functions/use-router)。
 
 #### 在 `pages` 和 `app` 之间共享组件
 
-为了使组件在 `pages` 和 `app` 路由器之间兼容，请参考 [从 `next/compat/router` 导入的 `useRouter` 钩子](/docs/pages/api-reference/functions/use-router#the-nextcompatrouter-export)。
-这是 `pages` 目录中的 `useRouter` 钩子，但旨在用于在路由器之间共享组件。当您准备好仅在 `app` 路由器中使用时，请更新为新的 [从 `next/navigation` 导入的 `useRouter`](/docs/app/api-reference/functions/use-router)。
+为了保持组件在 `pages` 和 `app` 路由器之间的兼容性，请参考[从 `next/compat/router` 导入的 `useRouter` 钩子](/docs/pages/api-reference/functions/use-router#the-nextcompatrouter-export)。
+这是 `pages` 目录中的 `useRouter` 钩子，但旨在用于在路由器之间共享组件。当你准备好仅在 `app` 路由器中使用时，请更新为新的[从 `next/navigation` 导入的 `useRouter`](/docs/app/api-reference/functions/use-router)。
 
-### 步骤 6：迁移数据获取方法
+### 第6步：迁移数据获取方法
 
-`pages` 目录使用 `getServerSideProps` 和 `getStaticProps` 为页面获取数据。在 `app` 目录中，这些旧的数据获取函数已被基于 `fetch()` 和 `async` React 服务端组件的 [更简单 API](/docs/app/building-your-application/data-fetching) 取代。
+`pages` 目录使用 `getServerSideProps` 和 `getStaticProps` 来获取页面数据。在 `app` 目录中，这些旧的数据获取函数被替换为基于 `fetch()` 和 `async` React 服务端组件的[更简单 API](/docs/app/building-your-application/data-fetching)。
 
 ```tsx filename="app/page.tsx" switcher
 export default async function Page() {
@@ -532,7 +532,7 @@ export default async function Page() {
 
 #### 服务端渲染 (`getServerSideProps`)
 
-在 `pages` 目录中，`getServerSideProps` 用于在服务器上获取数据并将 props 传递给文件中的默认导出 React 组件。页面的初始 HTML 由服务器预渲染，然后在浏览器中“水合”（使其可交互）。
+在 `pages` 目录中，`getServerSideProps` 用于在服务器上获取数据并将 props 传递给文件中的默认导出 React 组件。页面的初始 HTML 由服务器预渲染，随后在浏览器中“水合”（使其可交互）。
 
 ```jsx filename="pages/dashboard.js"
 // `pages` 目录
@@ -555,9 +555,9 @@ export default function Dashboard({ projects }) {
 }
 ```
 
-在 App Router 中，我们可以使用 [服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 将数据获取逻辑与 React 组件放在一起。这样可以在保持服务器渲染的 HTML 的同时，向客户端发送更少的 JavaScript。
+在 App Router 中，我们可以使用[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 将数据获取逻辑与 React 组件放在一起。这样可以在保持服务器渲染的 HTML 的同时，向客户端发送更少的 JavaScript。
 
-通过将 `cache` 选项设置为 `no-store`，我们可以指示获取的数据应 [永不缓存](/docs/app/building-your-application/data-fetching/fetching)。这与 `pages` 目录中的 `getServerSideProps` 类似。
+通过将 `cache` 选项设置为 `no-store`，我们可以指示获取的数据[不应缓存](/docs/app/building-your-application/data-fetching/fetching)。这与 `pages` 目录中的 `getServerSideProps` 类似。
 
 ```tsx filename="app/dashboard/page.tsx" switcher
 // `app` 目录
@@ -609,9 +609,9 @@ export default async function Dashboard() {
 
 #### 访问请求对象
 
-在 `pages` 目录中，您可以基于 Node.js HTTP API 获取请求相关的数据。
+在 `pages` 目录中，你可以基于 Node.js HTTP API 获取与请求相关的数据。
 
-例如，您可以从 `getServerSideProps` 获取 `req` 对象，并使用它获取请求的 cookies 和 headers。
+例如，你可以从 `getServerSideProps` 获取 `req` 对象，并使用它获取请求的 cookies 和 headers。
 
 ```jsx filename="pages/index.js"
 // `pages` 目录
@@ -630,8 +630,8 @@ export default function Page(props) {
 
 `app` 目录公开了新的只读函数来获取请求数据：
 
-- [`headers`](/docs/app/api-reference/functions/headers)：基于 Web Headers API，可以在 [服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 中使用以获取请求头。
-- [`cookies`](/docs/app/api-reference/functions/cookies)：基于 Web Cookies API，可以在 [服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 中使用以获取 cookies。
+- [`headers`](/docs/app/api-reference/functions/headers)：基于 Web Headers API，可以在[服务端组件](/docs/app/getting-started/server-and-client-components)中使用以获取请求头。
+- [`cookies`](/docs/app/api-reference/functions/cookies)：基于 Web Cookies API，可以在[服务端组件](/docs/app/getting-started/server-and-client-components)中使用以获取 cookies。
 
 ```tsx filename="app/page.tsx" switcher
 // `app` 目录
@@ -644,8 +644,8 @@ async function getData() {
 }
 
 export default async function Page() {
-  // 您可以直接在服务端组件中使用 `cookies` 或 `headers`，
-  // 或在数据获取函数中使用
+  // 你可以直接在服务端组件中使用 `cookies` 或 `headers`，
+  // 或者在数据获取函数中使用
   const theme = (await cookies()).get('theme')
   const data = await getData()
   return '...'
@@ -663,8 +663,8 @@ async function getData() {
 }
 
 export default async function Page() {
-  // 您可以直接在服务端组件中使用 `cookies` 或 `headers`，
-  // 或在数据获取函数中使用
+  // 你可以直接在服务端组件中使用 `cookies` 或 `headers`，
+  // 或者在数据获取函数中使用
   const theme = (await cookies()).get('theme')
   const data = await getData()
   return '...'
@@ -673,7 +673,7 @@ export default async function Page() {
 
 #### 静态站点生成 (`getStaticProps`)
 
-在 `pages` 目录中，`getStaticProps` 函数用于在构建时预渲染页面。此函数可用于从外部 API 或直接从数据库获取数据，并在构建期间将此数据传递给整个页面。
+在 `pages` 目录中，`getStaticProps` 函数用于在构建时预渲染页面。此函数可用于从外部 API 或直接从数据库获取数据，并在构建时将数据传递给整个页面。
 
 ```jsx filename="pages/index.js"
 // `pages` 目录
@@ -738,7 +738,7 @@ export default function Post({ post }) {
 
 在 `app` 目录中，`getStaticPaths` 被 [`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 取代。
 
-[`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 的行为与 `getStaticPaths` 类似，但提供了更简化的 API 来返回路由参数，并且可以在[布局 (layouts)](/docs/app/building-your-application/routing/layouts-and-templates) 内部使用。`generateStaticParams` 的返回形式是一个段 (segment) 数组，而不是嵌套的 `param` 对象数组或解析后的路径字符串。
+[`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 的行为与 `getStaticPaths` 类似，但提供了更简洁的 API 来返回路由参数，并且可以在[布局 (layouts)](/docs/app/building-your-application/routing/layouts-and-templates) 中使用。`generateStaticParams` 的返回形式是一个段数组，而不是嵌套的 `param` 对象数组或解析后的路径字符串。
 
 ```jsx filename="app/posts/[id]/page.js"
 // `app` 目录
@@ -762,7 +762,7 @@ export default async function Post({ params }) {
 }
 ```
 
-在 `app` 目录的新模型中，使用 `generateStaticParams` 比 `getStaticPaths` 更合适。`get` 前缀被更具描述性的 `generate` 取代，因为现在不再需要 `getStaticProps` 和 `getServerSideProps`。`Paths` 后缀被替换为 `Params`，这更适合具有多个动态段 (dynamic segments) 的嵌套路由。
+对于 `app` 目录中的新模型，使用 `generateStaticParams` 比 `getStaticPaths` 更合适。`get` 前缀被更具描述性的 `generate` 取代，这样更符合当前不再需要 `getStaticProps` 和 `getServerSideProps` 的情况。`Paths` 后缀被替换为 `Params`，这更适用于具有多个动态段的路由嵌套。
 
 ---
 
@@ -794,7 +794,7 @@ export default function Post({ post }) {
 - **`true`**：（默认值）未包含在 `generateStaticParams` 中的动态段会按需生成。
 - **`false`**：未包含在 `generateStaticParams` 中的动态段将返回 404。
 
-这取代了 `pages` 目录中 `getStaticPaths` 的 `fallback: true | false | 'blocking'` 选项。`dynamicParams` 中不包含 `fallback: 'blocking'` 选项，因为在流式传输 (streaming) 的情况下，`'blocking'` 和 `true` 之间的差异可以忽略不计。
+这取代了 `pages` 目录中 `getStaticPaths` 的 `fallback: true | false | 'blocking'` 选项。`fallback: 'blocking'` 选项未包含在 `dynamicParams` 中，因为在流式传输中 `'blocking'` 和 `true` 之间的差异可以忽略不计。
 
 ```jsx filename="app/posts/[id]/page.js"
 // `app` 目录
@@ -816,11 +816,11 @@ export default async function Post({ params }) {
 }
 ```
 
-当 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 设置为 `true`（默认值）时，如果请求的路由段尚未生成，它将在服务器端渲染并被缓存。
+当 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 设置为 `true`（默认值）时，如果请求的路由段尚未生成，它将被服务器渲染并缓存。
 
-#### 增量静态再生 (ISR)（`getStaticProps` 与 `revalidate`）
+#### 增量静态再生 (`getStaticProps` 与 `revalidate`)
 
-在 `pages` 目录中，`getStaticProps` 函数允许你添加 `revalidate` 字段以在一定时间后自动重新生成页面。
+在 `pages` 目录中，`getStaticProps` 函数允许你添加 `revalidate` 字段，以在一定时间后自动重新生成页面。
 
 ```jsx filename="pages/index.js"
 // `pages` 目录
@@ -844,7 +844,7 @@ export default function Index({ posts }) {
 }
 ```
 
-在 `app` 目录中，使用 [`fetch()`](/docs/app/api-reference/functions/fetch) 进行数据获取时可以使用 `revalidate`，这将缓存请求指定的秒数。
+在 `app` 目录中，使用 [`fetch()`](/docs/app/api-reference/functions/fetch) 获取数据时可以指定 `revalidate`，这将缓存请求指定的秒数。
 
 ```jsx filename="app/page.js"
 // `app` 目录
@@ -865,7 +865,7 @@ export default async function PostList() {
 
 #### API 路由
 
-API 路由在 `pages/api` 目录中继续正常工作，无需任何更改。然而，它们在 `app` 目录中被[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 取代。
+API 路由在 `pages/api` 目录中继续正常工作，无需任何更改。然而，在 `app` 目录中，它们已被[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 取代。
 
 路由处理器允许你使用 Web [Request](https://developer.mozilla.org/docs/Web/API/Request) 和 [Response](https://developer.mozilla.org/docs/Web/API/Response) API 为给定路由创建自定义请求处理器。
 
@@ -885,7 +885,7 @@ export async function GET(request) {}
 
 ### 步骤 7：样式
 
-在 `pages` 目录中，全局样式表仅限于 `pages/_app.js`。在 `app` 目录中，此限制已被取消。全局样式可以添加到任何布局、页面或组件中。
+在 `pages` 目录中，全局样式表仅限于 `pages/_app.js`。在 `app` 目录中，这一限制已被取消。全局样式可以添加到任何布局、页面或组件中。
 
 - [CSS 模块](/docs/app/getting-started/css#css-modules)
 - [Tailwind CSS](/docs/app/guides/tailwind-css)
@@ -926,10 +926,10 @@ export default function RootLayout({ children }) {
 
 ## 同时使用 App Router 和 Pages Router
 
-在不同 Next.js 路由器提供的路由之间导航时，会发生硬导航 (hard navigation)。使用 `next/link` 的自动链接预取 (prefetch) 不会跨路由器预取。
+在不同 Next.js 路由器提供的路由之间导航时，会发生硬导航。使用 `next/link` 的自动链接预取不会跨路由器预取。
 
-相反，你可以[优化 App Router 和 Pages Router 之间的导航](https://vercel.com/guides/optimizing-hard-navigations)以保留预取和快速的页面过渡。[了解更多](https://vercel.com/guides/optimizing-hard-navigations)。
+相反，你可以[优化导航](https://vercel.com/guides/optimizing-hard-navigations)以在 App Router 和 Pages Router 之间保留预取和快速页面切换。[了解更多](https://vercel.com/guides/optimizing-hard-navigations)。
 
 ## Codemods
 
-Next.js 提供了 Codemod 转换，以帮助在功能弃用时升级代码库。更多信息请参阅 [Codemods](/docs/app/guides/upgrading/codemods)。
+Next.js 提供了 Codemod 转换，以帮助在功能弃用时升级代码库。有关更多信息，请参阅 [Codemods](/docs/app/guides/upgrading/codemods)。
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-create-react-app.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-create-react-app.mdx
index 2560e3ac..3a026c06 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-create-react-app.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-create-react-app.mdx
@@ -1,12 +1,12 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:57:29.791Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:22:41.322Z
 title: 如何从 Create React App 迁移到 Next.js
 nav_title: Create React App
-description: 学习如何将现有的 React 应用从 Create React App 迁移到 Next.js。
+description: 了解如何将现有的 React 应用从 Create React App 迁移至 Next.js。
 ---
 
-本指南将帮助您将现有的 Create React App (CRA) 站点迁移至 Next.js。
+本指南将帮助您将现有的 Create React App (CRA) 站点迁移到 Next.js。
 
 ## 为何要迁移？
 
@@ -14,77 +14,77 @@ description: 学习如何将现有的 React 应用从 Create React App 迁移到
 
 ### 初始页面加载缓慢
 
-Create React App 仅使用客户端 React。纯客户端应用（也称为[单页应用 (SPA)](/docs/app/guides/single-page-applications)）通常会遇到初始页面加载缓慢的问题，原因如下：
+Create React App 仅使用客户端 React。纯客户端应用（也称为[单页应用 (SPA)](/docs/app/guides/single-page-applications)）通常会出现初始页面加载缓慢的问题。这主要由以下原因造成：
 
 1. 浏览器需要等待 React 代码和整个应用包下载并运行后，才能发送数据加载请求。
-2. 随着新功能和依赖项的添加，应用代码会不断增长。
+2. 应用代码会随着新增功能和依赖不断增长。
 
 ### 缺乏自动代码分割
 
-虽然通过代码分割可以缓解加载缓慢的问题，但手动操作可能会意外引入网络瀑布流。Next.js 的路由器和构建管道内置了自动代码分割和摇树优化功能。
+虽然通过代码分割可以缓解加载缓慢的问题，但手动进行代码分割可能会意外引入网络瀑布流。Next.js 的路由器和构建管道内置了自动代码分割和摇树优化功能。
 
 ### 网络瀑布流
 
-性能低下的常见原因是应用需要按顺序发起客户端-服务器请求来获取数据。[SPA](/docs/app/guides/single-page-applications) 中常见的数据获取模式是先渲染占位符，然后在组件挂载后获取数据。遗憾的是，子组件只能在父组件完成数据加载后才能开始获取数据，导致请求形成"瀑布流"。
+当应用需要连续发起客户端-服务器请求来获取数据时，常会导致性能不佳。[SPA](/docs/app/guides/single-page-applications) 中常见的数据获取模式是先渲染占位内容，待组件挂载后再获取数据。遗憾的是，子组件只能在父组件完成数据加载后才能开始获取数据，从而形成请求"瀑布流"。
 
-虽然 Next.js 支持客户端数据获取，但它也允许将数据获取移至服务器端，从而彻底消除客户端-服务器的瀑布流问题。
+虽然 Next.js 支持客户端数据获取，但它也允许您将数据获取移至服务器端，这通常能完全消除客户端-服务器的瀑布流问题。
 
 ### 快速且可控的加载状态
 
-通过内置的[React Suspense 流式传输支持](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense)，您可以定义 UI 的哪些部分优先加载及其顺序，避免产生网络瀑布流。
+通过内置的[React Suspense 流式传输](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense)支持，您可以定义 UI 各部分的加载顺序和优先级，同时避免产生网络瀑布流。
 
-这有助于构建加载更快的页面，并消除[布局偏移](https://vercel.com/blog/how-core-web-vitals-affect-seo)。
+这能让您构建出加载更快的页面，并消除[布局偏移](https://vercel.com/blog/how-core-web-vitals-affect-seo)。
 
 ### 灵活选择数据获取策略
 
-Next.js 允许根据页面或组件的需求选择数据获取策略。例如，您可以从 CMS 获取数据并在构建时（SSG）渲染博客文章以实现快速加载，或在必要时在请求时（SSR）获取数据。
+Next.js 允许您根据需求，在页面或组件级别选择数据获取策略。例如，您可以从 CMS 获取数据并在构建时 (SSG) 渲染博客文章以实现快速加载，或在必要时在请求时 (SSR) 获取数据。
 
 ### 中间件
 
-[Next.js 中间件](/docs/app/building-your-application/routing/middleware)允许在请求完成前在服务器上运行代码。例如，您可以通过中间件将用户重定向到登录页面，避免未授权内容的闪现。还可用于 A/B 测试、实验和[国际化](/docs/app/building-your-application/routing/internationalization)等功能。
+[Next.js 中间件](/docs/app/building-your-application/routing/middleware)允许您在请求完成前在服务器端运行代码。例如，对于需要认证的页面，您可以通过中间件将未认证用户重定向至登录页，避免显示未授权内容的闪烁。您还可以将其用于 A/B 测试、实验和[国际化](/docs/app/guides/internationalization)等功能。
 
 ### 内置优化
 
-[图片](/docs/app/api-reference/components/image)、[字体](/docs/app/api-reference/components/font)和[第三方脚本](/docs/app/guides/scripts)通常对应用性能影响较大。Next.js 提供了专用组件和 API 来自动优化它们。
+[图片](/docs/app/api-reference/components/image)、[字体](/docs/app/api-reference/components/font) 和[第三方脚本](/docs/app/guides/scripts)通常对应用性能有重大影响。Next.js 提供了专用组件和 API 来自动优化这些资源。
 
 ## 迁移步骤
 
-我们的目标是尽快获得一个可运行的 Next.js 应用，以便逐步采用 Next.js 的功能。首先，我们将您的应用视为纯客户端应用（[SPA](/docs/app/guides/single-page-applications)），暂不替换现有路由器，以减少复杂性和合并冲突。
+我们的目标是尽快获得一个可运行的 Next.js 应用，以便您能逐步采用 Next.js 的功能。首先，我们将您的应用视为纯客户端应用 ([SPA](/docs/app/guides/single-page-applications))，暂不替换现有路由器，这能减少复杂性和合并冲突。
 
-> **注意**：如果您使用了高级 CRA 配置（如 `package.json` 中的自定义 `homepage` 字段、自定义服务工作者或特定的 Babel/webpack 调整），请参阅本指南末尾的**其他注意事项**部分，了解如何在 Next.js 中复制或调整这些功能。
+> **注意**：如果您使用了高级 CRA 配置，如 `package.json` 中的自定义 `homepage` 字段、自定义 service worker 或特定的 Babel/webpack 调整，请参阅本指南末尾的**其他注意事项**部分，了解如何在 Next.js 中复制或适配这些功能。
 
 ### 步骤 1：安装 Next.js 依赖
 
 在现有项目中安装 Next.js：
 
-```bash filename="终端"
+```bash filename="Terminal"
 npm install next@latest
 ```
 
 ### 步骤 2：创建 Next.js 配置文件
 
-在项目根目录（与 `package.json` 同级）创建 `next.config.ts`。此文件包含[Next.js 配置选项](/docs/app/api-reference/config/next-config-js)。
+在项目根目录（与 `package.json` 同级）创建 `next.config.ts` 文件。此文件包含您的 [Next.js 配置选项](/docs/app/api-reference/config/next-config-js)。
 
 ```js filename="next.config.ts"
 import type { NextConfig } from 'next'
 
 const nextConfig: NextConfig = {
-  output: 'export', // 输出单页应用 (SPA)
+  output: 'export', // 输出为单页应用 (SPA)
   distDir: 'build', // 将构建输出目录改为 `build`
 }
 
 export default nextConfig
 ```
 
-> **注意**：使用 `output: 'export'` 表示进行静态导出。您将**无法**访问 SSR 或 API 等服务器端功能。如需使用 Next.js 服务器功能，请移除此行。
+> **注意**：使用 `output: 'export'` 表示您在进行静态导出。您将**无法**使用服务器端功能如 SSR 或 API。移除此行可启用 Next.js 服务器功能。
 
 ### 步骤 3：创建根布局
 
-Next.js [App Router](/docs/app) 应用必须包含[根布局文件](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)，这是一个[React 服务器组件](/docs/app/getting-started/server-and-client-components)，将包裹所有页面。
+Next.js [App Router](/docs/app) 应用必须包含一个[根布局](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)文件，这是一个[React 服务器组件](/docs/app/getting-started/server-and-client-components)，将包裹所有页面。
 
-CRA 应用中与根布局文件最接近的是 `public/index.html`，其中包含 `<html>`、`<head>` 和 `<body>` 标签。
+在 CRA 应用中，最接近根布局文件的是 `public/index.html`，它包含您的 `<html>`、`<head>` 和 `<body>` 标签。
 
-1. 在 `src` 文件夹内（或直接在项目根目录）创建新的 `app` 目录。
+1. 在 `src` 文件夹内（或项目根目录，如果您希望 `app` 位于根目录）新建 `app` 目录。
 2. 在 `app` 目录中创建 `layout.tsx`（或 `layout.js`）文件：
 
 ```tsx filename="app/layout.tsx" switcher
@@ -103,7 +103,7 @@ export default function RootLayout({ children }) {
 }
 ```
 
-将旧 `index.html` 的内容复制到此 `<RootLayout>` 组件中。将 `body div#root`（和 `body noscript`）替换为 `<div id="root">{children}</div>`。
+现在将旧 `index.html` 的内容复制到 `<RootLayout>` 组件中。将 `body div#root`（和 `body noscript`）替换为 `<div id="root">{children}</div>`。
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -147,11 +147,11 @@ export default function RootLayout({ children }) {
 }
 ```
 
-> **须知**：Next.js 默认忽略 CRA 的 `public/manifest.json`、额外图标和[测试配置](/docs/app/guides/testing)。如需这些功能，Next.js 提供了[Metadata API](/docs/app/getting-started/metadata-and-og-images) 和[测试](/docs/app/guides/testing)支持。
+> **须知**：Next.js 默认会忽略 CRA 的 `public/manifest.json`、额外图标和[测试配置](/docs/app/guides/testing)。如需这些功能，Next.js 提供了[元数据 API](/docs/app/getting-started/metadata-and-og-images) 和[测试](/docs/app/guides/testing)支持。
 
 ### 步骤 4：元数据
 
-Next.js 自动包含 `<meta charset="UTF-8" />` 和 `<meta name="viewport" content="width=device-width, initial-scale=1" />` 标签，因此可以从 `<head>` 中移除它们：
+Next.js 会自动包含 `<meta charset="UTF-8" />` 和 `<meta name="viewport" content="width=device-width, initial-scale=1" />` 标签，因此可以从 `<head>` 中移除它们：
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -191,7 +191,7 @@ export default function RootLayout({ children }) {
 }
 ```
 
-任何[元数据文件](/docs/app/getting-started/metadata-and-og-images#file-based-metadata)（如 `favicon.ico`、`icon.png`、`robots.txt`）只要放置在 `app` 目录的顶层，就会自动添加到应用的 `<head>` 标签中。将所有[支持的文件](/docs/app/getting-started/metadata-and-og-images#file-based-metadata)移至 `app` 目录后，可以安全删除它们的 `<link>` 标签：
+任何[元数据文件](/docs/app/getting-started/metadata-and-og-images#file-based-metadata)，如 `favicon.ico`、`icon.png`、`robots.txt`，只要放置在 `app` 目录的顶层，就会自动添加到应用的 `<head>` 标签中。将[所有支持的文件](/docs/app/getting-started/metadata-and-og-images#file-based-metadata)移至 `app` 目录后，您可以安全地删除它们的 `<link>` 标签：
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -229,7 +229,7 @@ export default function RootLayout({ children }) {
 }
 ```
 
-最后，Next.js 可以通过[Metadata API](/docs/app/getting-started/metadata-and-og-images) 管理剩余的 `<head>` 标签。将最后的元数据信息移至导出的[`metadata` 对象](/docs/app/api-reference/functions/generate-metadata#metadata-object)：
+最后，Next.js 可以通过[元数据 API](/docs/app/getting-started/metadata-and-og-images) 管理剩余的 `<head>` 标签。将最后的元数据信息移至导出的 [`metadata` 对象](/docs/app/api-reference/functions/generate-metadata#metadata-object)：
 
 ```tsx filename="app/layout.tsx" switcher
 import type { Metadata } from 'next'
@@ -271,13 +271,13 @@ export default function RootLayout({ children }) {
 }
 ```
 
-通过以上更改，您从在 `index.html` 中声明所有内容转变为使用 Next.js 内置的基于约定的方法（[Metadata API](/docs/app/getting-started/metadata-and-og-images)）。这种方法使您更容易提升页面的 SEO 和网络分享性。
+通过以上更改，您从在 `index.html` 中声明所有内容，转变为使用 Next.js 框架内置的基于约定的方法（[元数据 API](/docs/app/getting-started/metadata-and-og-images)）。这种方法能让您更轻松地提升页面的 SEO 和网络分享性。
 
 ### 步骤 5：样式
 
-与 CRA 类似，Next.js 开箱即支持[CSS 模块](/docs/app/getting-started/css#css-modules)和[全局 CSS 导入](/docs/app/getting-started/css#global-css)。
+与 CRA 类似，Next.js 开箱即支持 [CSS 模块](/docs/app/getting-started/css#css-modules)和[全局 CSS 导入](/docs/app/getting-started/css#global-css)。
 
-如果有全局 CSS 文件，请将其导入到 `app/layout.tsx`：
+如果您有全局 CSS 文件，请将其导入到 `app/layout.tsx`：
 
 ```tsx filename="app/layout.tsx" switcher
 import '../index.css'
@@ -302,13 +302,13 @@ export default function RootLayout({
 }
 ```
 
-如果使用 Tailwind CSS，请参阅我们的[安装文档](/docs/app/guides/tailwind-css)。
+如果您使用 Tailwind CSS，请参阅我们的[安装文档](/docs/app/guides/tailwind-css)。
 
 ### 步骤 6：创建入口页面
 
 Create React App 使用 `src/index.tsx`（或 `index.js`）作为入口点。在 Next.js (App Router) 中，`app` 目录内的每个文件夹对应一个路由，每个文件夹应包含一个 `page.tsx`。
 
-由于我们希望暂时将应用保持为 SPA 并拦截**所有**路由，我们将使用[可选的全捕获路由](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments)。
+由于我们希望暂时保持应用为 SPA 并拦截**所有**路由，我们将使用[可选的全捕获路由](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments)。
 
 1. **在 `app` 内创建 `[[...slug]]` 目录。**
 
@@ -327,7 +327,7 @@ export function generateStaticParams() {
 }
 
 export default function Page() {
-  return '...' // 稍后更新
+  return '...' // 我们稍后会更新此部分
 }
 ```
 
@@ -337,15 +337,15 @@ export function generateStaticParams() {
 }
 
 export default function Page() {
-  return '...' // 稍后更新
+  return '...' // 我们稍后会更新此部分
 }
 ```
 
-这告诉 Next.js 为空的 slug (`/`) 生成单个路由，实际上将所有路由映射到同一页面。此页面是一个[服务器组件](/docs/app/getting-started/server-and-client-components)，预渲染为静态 HTML。
+这会告知 Next.js 为空的 slug (`/`) 生成单一路由，实际上将**所有**路由映射到同一页面。此页面是一个[服务器组件](/docs/app/getting-started/server-and-client-components)，会被预渲染为静态 HTML。
 
-### 步骤 7：添加纯客户端入口点
+### 步骤 7：添加纯客户端入口
 
-接下来，我们将 CRA 的根 App 组件嵌入[客户端组件](/docs/app/getting-started/server-and-client-components)中，以便所有逻辑保留在客户端。如果是首次使用 Next.js，值得了解的是客户端组件（默认情况下）仍会在服务器端预渲染。可以将其视为额外具备运行客户端 JavaScript 的能力。
+接下来，我们将把 CRA 的根 App 组件嵌入到[客户端组件](/docs/app/getting-started/server-and-client-components)中，以便所有逻辑保持在客户端。如果您是首次使用 Next.js，值得了解的是客户端组件（默认情况下）仍会在服务器端预渲染。您可以将其视为额外具备运行客户端 JavaScript 的能力。
 
 在 `app/[[...slug]]/` 中创建 `client.tsx`（或 `client.js`）：
 
@@ -374,9 +374,9 @@ export function ClientOnly() {
 ```
 
 - `'use client'` 指令使此文件成为**客户端组件**。
-- 带有 `ssr: false` 的 `dynamic` 导入会禁用 `<App />` 组件的服务器端渲染，使其成为真正的纯客户端（SPA）。
+- 带 `ssr: false` 的 `dynamic` 导入会禁用 `<App />` 组件的服务器端渲染，使其成为真正的纯客户端组件 (SPA)。
 
-现在更新 `page.tsx`（或 `page.js`）以使用新组件：
+现在更新您的 `page.tsx`（或 `page.js`）以使用新组件：
 
 ```tsx filename="app/[[...slug]]/page.tsx" switcher
 import { ClientOnly } from './client'
@@ -402,7 +402,7 @@ export default function Page() {
 }
 ```
 
-### 步骤 8：更新静态图片导入
+### 步骤 8：更新静态图片导入方式
 
 在 CRA 中，导入图片文件会返回其公共 URL 字符串：
 
@@ -414,45 +414,45 @@ export default function App() {
 }
 ```
 
-使用 Next.js 时，静态图片导入会返回一个对象。该对象可直接用于 Next.js 的 [`<Image>` 组件](/docs/app/api-reference/components/image)，也可通过其 `src` 属性用于现有的 `<img>` 标签。
+而在 Next.js 中，静态图片导入会返回一个对象。该对象可直接用于 Next.js 的 [`<Image>` 组件](/docs/app/api-reference/components/image)，也可通过其 `src` 属性用于现有的 `<img>` 标签。
 
-`<Image>` 组件具有[自动图片优化](/docs/app/api-reference/components/image)的额外优势。该组件会根据图片尺寸自动设置最终 `<img>` 的 `width` 和 `height` 属性，防止图片加载时的布局偏移。但若应用中存在仅设置单维度样式而未将另一维度设为 `auto` 的图片，则可能导致显示失真（未设为 `auto` 的维度会默认使用 `<img>` 的尺寸属性值）。
+使用 `<Image>` 组件能获得[自动图片优化](/docs/app/api-reference/components/image)的额外优势。该组件会根据图片尺寸自动设置生成 `<img>` 的 `width` 和 `height` 属性，防止图片加载时的布局偏移。但若应用中存在仅设置单维度样式（另一维度未设为 `auto`）的图片，可能导致图片显示失真——未设为 `auto` 的维度会默认采用 `<img>` 维度属性的值。
 
-保留 `<img>` 标签可减少应用改动量并避免上述问题。后续您仍可选择迁移至 `<Image>` 组件，通过[配置 loader](/docs/app/api-reference/components/image#loader) 或使用自带图片优化功能的 Next.js 默认服务器来优化图片。
+保留 `<img>` 标签可减少应用改动量并避免上述问题。后续可选择性迁移至 `<Image>` 组件，通过[配置 loader](/docs/app/api-reference/components/image#loader) 或使用自带图片优化功能的 Next.js 默认服务器来优化图片。
 
-**将 `/public` 目录下图片的绝对导入路径改为相对导入：**
+**将 `/public` 目录图片的绝对导入路径改为相对导入：**
 
 ```tsx
-// 修改前
+// 迁移前
 import logo from '/logo.png'
 
-// 修改后
+// 迁移后
 import logo from '../public/logo.png'
 ```
 
 **向 `<img>` 标签传递图片的 `src` 属性而非整个图片对象：**
 
 ```tsx
-// 修改前
+// 迁移前
 <img src={logo} />
 
-// 修改后
+// 迁移后
 <img src={logo.src} />
 ```
 
-或者，您可以直接基于文件名引用图片资源的公共 URL。例如 `public/logo.png` 会通过 `/logo.png` 路径提供服务，该路径即可作为 `src` 值。
+也可直接基于文件名引用图片的公共 URL。例如 `public/logo.png` 对应的图片可通过 `/logo.png` 访问，该路径即可作为 `src` 值。
 
 > **警告：** 使用 TypeScript 时，访问 `src` 属性可能会触发类型错误。需将 `next-env.d.ts` 添加到 `tsconfig.json` 的 [`include` 数组](https://www.typescriptlang.org/tsconfig#include)中。执行步骤 9 时 Next.js 会自动生成此文件。
 
 ### 步骤 9：迁移环境变量
 
-Next.js 的[环境变量](/docs/app/guides/environment-variables)支持与 CRA 类似，但需为需在浏览器中暴露的变量添加 `NEXT_PUBLIC_` 前缀。
+Next.js 的[环境变量](/docs/app/guides/environment-variables)机制与 CRA 类似，但需为暴露给浏览器的变量添加 `NEXT_PUBLIC_` 前缀。
 
-主要区别在于客户端环境变量的前缀。将所有 `REACT_APP_` 前缀的环境变量改为 `NEXT_PUBLIC_`。
+主要区别在于客户端环境变量的前缀。将所有 `REACT_APP_` 前缀的变量改为 `NEXT_PUBLIC_`。
 
 ### 步骤 10：更新 `package.json` 脚本
 
-更新 `package.json` 脚本以使用 Next.js 命令，并将 `.next` 和 `next-env.d.ts` 添加到 `.gitignore`：
+将 `package.json` 脚本改为 Next.js 命令，并将 `.next` 和 `next-env.d.ts` 添加到 `.gitignore`：
 
 ```json filename="package.json"
 {
@@ -476,11 +476,11 @@ next-env.d.ts
 npm run dev
 ```
 
-访问 [http://localhost:3000](http://localhost:3000)，您的应用将以 SPA 模式运行在 Next.js 上。
+访问 [http://localhost:3000](http://localhost:3000)，应用将以 SPA 模式运行在 Next.js 上。
 
 ### 步骤 11：清理工作
 
-现在可移除 Create React App 的特定文件：
+移除 Create React App 的专属文件：
 - `public/index.html`
 - `src/index.tsx`
 - `src/react-app-env.d.ts`
@@ -510,7 +510,7 @@ export default nextConfig
 
 ### 代理 API 请求
 
-若曾通过 `package.json` 的 `proxy` 字段转发后端请求，可通过 Next.js 的[重写规则](/docs/app/api-reference/config/next-config-js/rewrites)实现：
+若通过 `package.json` 的 `proxy` 字段转发后端请求，可使用 Next.js 的[重写规则](/docs/app/api-reference/config/next-config-js/rewrites)：
 
 ```ts filename="next.config.ts"
 import { NextConfig } from 'next'
@@ -544,11 +544,11 @@ const nextConfig: NextConfig = {
 export default nextConfig
 ```
 
-> **注意：** 这将需要移除 `dev` 脚本中的 `--turbopack` 来禁用 Turbopack。
+> **注意：** 需从 `dev` 脚本移除 `--turbopack` 以停用 Turbopack。
 
 ### TypeScript 配置
 
-Next.js 在存在 `tsconfig.json` 时会自动配置 TypeScript。请确保 `next-env.d.ts` 包含在 `include` 数组中：
+Next.js 在存在 `tsconfig.json` 时会自动配置 TypeScript。确保 `next-env.d.ts` 在 `include` 数组中：
 
 ```json
 {
@@ -558,7 +558,7 @@ Next.js 在存在 `tsconfig.json` 时会自动配置 TypeScript。请确保 `nex
 
 ## 打包工具兼容性
 
-Create React App 和 Next.js 默认都使用 webpack 打包。Next.js 还提供 [Turbopack](/docs/app/api-reference/config/next-config-js/turbopack) 以加速本地开发：
+CRA 和 Next.js 默认均使用 webpack。Next.js 还提供 [Turbopack](/docs/app/api-reference/config/next-config-js/turbopack) 加速本地开发：
 
 ```bash
 next dev --turbopack
@@ -568,15 +568,15 @@ next dev --turbopack
 
 ## 后续步骤
 
-若一切顺利，您现在已拥有一个以单页应用模式运行的 Next.js 应用。虽然尚未使用服务端渲染或基于文件的路由等特性，但可逐步启用：
+若迁移成功，现已有运行在 Next.js 上的单页应用。接下来可逐步启用服务端渲染等特性：
 
-- **从 React Router 迁移**至 [Next.js 应用路由](/docs/app/building-your-application/routing)：
+- **从 React Router 迁移**至 [Next.js 应用路由](/docs/app/building-your-application/routing)，实现：
   - 自动代码分割
   - [流式服务端渲染](/docs/app/building-your-application/routing/loading-ui-and-streaming)
   - [React 服务端组件](/docs/app/getting-started/server-and-client-components)
 - 使用 [`<Image>` 组件](/docs/app/api-reference/components/image) **优化图片**
 - 通过 [`next/font`](/docs/app/api-reference/components/font) **优化字体**
-- 使用 [`<Script>` 组件](/docs/app/guides/scripts) **优化第三方脚本**
-- 运行 `npx next lint` **启用 ESLint** 并配置 Next.js 推荐规则
+- 利用 [`<Script>` 组件](/docs/app/guides/scripts) **优化第三方脚本**
+- 运行 `npx next lint` **启用 ESLint** 并配置符合项目的规则
 
-> **注意：** 使用静态导出 (`output: 'export'`) 时[暂不支持](https://github.com/vercel/next.js/issues/54393) `useParams` 钩子等服务器功能。如需使用全部特性，需从 `next.config.ts` 移除 `output: 'export'`。
+> **注意：** 使用静态导出 (`output: 'export'`) 时[暂不支持](https://github.com/vercel/next.js/issues/54393) `useParams` 等服务器功能。如需完整功能，需从 `next.config.ts` 移除 `output: 'export'`。
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-vite.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-vite.mdx
index 71179174..6e2049da 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-vite.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/migrating/from-vite.mdx
@@ -1,61 +1,61 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:57:34.085Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:22:21.504Z
 title: 如何从 Vite 迁移到 Next.js
 nav_title: Vite
 description: 了解如何将现有的 React 应用从 Vite 迁移至 Next.js。
 ---
 
-本指南将帮助您将现有的 Vite 应用迁移到 Next.js。
+本指南将帮助您将现有的 Vite 应用迁移至 Next.js。
 
 ## 为何要迁移？
 
-从 Vite 切换到 Next.js 有以下几个原因：
+从 Vite 切换到 Next.js 有以下几个主要原因：
 
 ### 初始页面加载缓慢
 
-如果使用 [Vite 默认的 React 插件](https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-react) 构建应用，您的应用是纯客户端应用。纯客户端应用（也称为单页应用 SPA）通常会遇到初始加载缓慢的问题，原因如下：
+如果使用 [Vite 默认的 React 插件](https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-react) 构建应用，您的应用将是一个纯客户端应用。纯客户端应用（也称为单页应用 SPA）通常会遇到初始页面加载缓慢的问题，原因包括：
 
-1. 浏览器需要等待 React 代码和整个应用包下载并运行后，才能发送请求加载数据。
-2. 随着新增功能和依赖项的增加，应用代码会不断膨胀。
+1. 浏览器需要等待 React 代码和整个应用包下载并运行后，才能发送数据加载请求
+2. 随着功能增加和依赖项增多，应用代码会不断膨胀
 
 ### 缺乏自动代码分割
 
-虽然通过代码分割可以缓解加载缓慢的问题，但手动进行代码分割往往会导致性能更差。手动分割容易意外引入网络瀑布流问题。Next.js 的路由器内置了自动代码分割功能。
+虽然通过代码分割可以缓解加载缓慢的问题，但手动进行代码分割往往会使性能更差。手动分割容易意外引入网络瀑布流问题。Next.js 的路由器内置了自动代码分割功能。
 
 ### 网络瀑布流
 
-当应用需要连续发起客户端-服务器请求来获取数据时，常会导致性能不佳。SPA 中常见的数据获取模式是先渲染占位内容，然后在组件挂载后获取数据。这意味着子组件必须等待父组件完成数据加载后才能开始自己的数据获取。
+当应用需要连续发起客户端-服务器请求来获取数据时，常会导致性能不佳。SPA 中常见的数据获取模式是先渲染占位符，然后在组件挂载后获取数据。这意味着子组件必须等待父组件完成数据加载后才能开始自己的数据获取。
 
-虽然 Next.js 支持客户端数据获取，但它也提供了将数据获取转移到服务端的选项，从而消除客户端-服务端瀑布流问题。
+虽然 Next.js 支持客户端数据获取，但它也提供了将数据获取移至服务端的选项，从而消除客户端-服务器瀑布流。
 
-### 快速且可控的加载状态
+### 快速可控的加载状态
 
-通过内置的 [React Suspense 流式传输](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense) 支持，您可以更精确地控制 UI 的加载顺序和优先级，同时避免网络瀑布流。
+通过内置的 [React Suspense 流式传输](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense) 支持，您可以更精准地控制 UI 各部分的加载顺序，避免网络瀑布流问题。
 
-这能让您构建加载更快的页面，并消除 [布局偏移](https://vercel.com/blog/how-core-web-vitals-affect-seo)。
+这能帮助您构建加载更快的页面，并消除 [布局偏移](https://vercel.com/blog/how-core-web-vitals-affect-seo)。
 
 ### 灵活选择数据获取策略
 
-Next.js 允许您根据需求为每个页面和组件选择数据获取策略：构建时获取、服务端请求时获取或客户端获取。例如，您可以从 CMS 获取数据并在构建时渲染博客文章，然后通过 CDN 高效缓存。
+Next.js 允许您基于页面和组件选择数据获取策略：构建时获取、服务端请求时获取或客户端获取。例如，您可以从 CMS 获取数据并在构建时渲染博客文章，然后通过 CDN 高效缓存。
 
 ### 中间件
 
-[Next.js 中间件](/docs/app/building-your-application/routing/middleware) 可以在请求完成前在服务端运行代码。这对于避免用户在访问需认证页面时闪现未认证内容非常有用（可通过重定向到登录页实现）。中间件还可用于实验功能和 [国际化](/docs/app/building-your-application/routing/internationalization)。
+[Next.js 中间件](/docs/app/building-your-application/routing/middleware) 允许在请求完成前在服务端运行代码。这特别适用于避免用户访问需要认证的页面时出现未授权内容闪烁，通过将用户重定向至登录页面。中间件也适用于实验性和 [国际化](/docs/app/guides/internationalization) 场景。
 
 ### 内置优化
 
-[图片](/docs/app/api-reference/components/image)、[字体](/docs/app/api-reference/components/font) 和 [第三方脚本](/docs/app/guides/scripts) 通常对应用性能有重大影响。Next.js 提供了自动优化这些资源的内置组件。
+[图片](/docs/app/api-reference/components/image)、[字体](/docs/app/api-reference/components/font) 和 [第三方脚本](/docs/app/guides/scripts) 通常对应用性能有重大影响。Next.js 提供内置组件来自动优化这些资源。
 
 ## 迁移步骤
 
-本次迁移的目标是快速获得一个可运行的 Next.js 应用，以便后续逐步采用 Next.js 特性。初始阶段我们将保持其为纯客户端应用（SPA），不迁移现有路由，以降低迁移过程中的问题风险和合并冲突。
+本次迁移的目标是快速获得可运行的 Next.js 应用，以便后续逐步采用 Next.js 功能。初始阶段我们将保持其为纯客户端应用（SPA），不迁移现有路由，以最小化迁移问题和减少合并冲突。
 
 ### 步骤 1：安装 Next.js 依赖
 
-首先需要安装最新版 `next` 依赖：
+首先安装 `next` 依赖：
 
-```bash filename="Terminal"
+```bash filename="终端"
 npm install next@latest
 ```
 
@@ -73,11 +73,11 @@ const nextConfig = {
 export default nextConfig
 ```
 
-> **须知**：Next.js 配置文件可使用 `.js` 或 `.mjs` 扩展名。
+> **须知**：配置文件名可使用 `.js` 或 `.mjs` 扩展名。
 
 ### 步骤 3：更新 TypeScript 配置
 
-如果使用 TypeScript，需要更新 `tsconfig.json` 文件以兼容 Next.js（非 TypeScript 项目可跳过）：
+使用 TypeScript 的项目需更新 `tsconfig.json` 文件以兼容 Next.js。非 TypeScript 项目可跳过此步骤。
 
 1. 移除对 `tsconfig.node.json` 的 [项目引用](https://www.typescriptlang.org/tsconfig#references)
 2. 在 [`include` 数组](https://www.typescriptlang.org/tsconfig#include) 添加 `./dist/types/**/*.ts` 和 `./next-env.d.ts`
@@ -89,7 +89,7 @@ export default nextConfig
 8. 设置 [`forceConsistentCasingInFileNames`](https://www.typescriptlang.org/tsconfig#forceConsistentCasingInFileNames) 为 `true`：`"forceConsistentCasingInFileNames": true`
 9. 设置 [`incremental`](https://www.typescriptlang.org/tsconfig#incremental) 为 `true`：`"incremental": true`
 
-配置示例：
+完整配置示例：
 
 ```json filename="tsconfig.json"
 {
@@ -124,7 +124,7 @@ export default nextConfig
 
 ### 步骤 4：创建根布局
 
-Next.js [应用路由](/docs/app) 必须包含一个 [根布局文件](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)，这是一个 [React 服务端组件](/docs/app/getting-started/server-and-client-components)，用于包裹所有页面。该文件位于 `app` 目录顶层。
+Next.js [应用路由](/docs/app) 必须包含 [根布局](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required) 文件，这是一个 [React 服务端组件](/docs/app/getting-started/server-and-client-components)，用于包裹所有页面。该文件位于 `app` 目录顶层。
 
 Vite 应用中与之最接近的是 [`index.html` 文件](https://vitejs.dev/guide/#index-html-and-project-root)，包含 `<html>`、`<head>` 和 `<body>` 标签。
 
@@ -151,7 +151,7 @@ export default function RootLayout({ children }) {
 
 > **须知**：布局文件可使用 `.js`、`.jsx` 或 `.tsx` 扩展名
 
-3. 将 `index.html` 内容复制到 `<RootLayout>` 组件，并将 `body.div#root` 和 `body.script` 替换为 `<div id="root">{children}</div>`：
+3. 将 `index.html` 内容复制到 `<RootLayout>` 组件，替换 `body.div#root` 和 `body.script` 标签为 `<div id="root">{children}</div>`：
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -176,26 +176,7 @@ export default function RootLayout({
 }
 ```
 
-```jsx filename="app/layout.js" switcher
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <head>
-        <meta charset="UTF-8" />
-        <link rel="icon" type="image/svg+xml" href="/icon.svg" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>My App</title>
-        <meta name="description" content="My App is a..." />
-      </head>
-      <body>
-        <div id="root">{children}</div>
-      </body>
-    </html>
-  )
-}
-```
-
-4. Next.js 默认包含 [meta charset](https://developer.mozilla.org/docs/Web/HTML/Element/meta#charset) 和 [meta viewport](https://developer.mozilla.org/docs/Web/HTML/Viewport_meta_tag) 标签，可从 `<head>` 中移除：
+4. 移除 Next.js 已默认包含的 [meta charset](https://developer.mozilla.org/docs/Web/HTML/Element/meta#charset) 和 [meta viewport](https://developer.mozilla.org/docs/Web/HTML/Viewport_meta_tag) 标签：
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -218,24 +199,7 @@ export default function RootLayout({
 }
 ```
 
-```jsx filename="app/layout.js" switcher
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <head>
-        <link rel="icon" type="image/svg+xml" href="/icon.svg" />
-        <title>My App</title>
-        <meta name="description" content="My App is a..." />
-      </head>
-      <body>
-        <div id="root">{children}</div>
-      </body>
-    </html>
-  )
-}
-```
-
-5. 将 [文件元数据](/docs/app/getting-started/metadata-and-og-images#file-based-metadata) 如 `favicon.ico`、`icon.png`、`robots.txt` 移至 `app` 目录顶层后，Next.js 会自动将其添加到 `<head>` 标签，此时可删除对应的 `<link>` 标签：
+5. 将 `favicon.ico`、`icon.png`、`robots.txt` 等 [元数据文件](/docs/app/getting-started/metadata-and-og-images#file-based-metadata) 移至 `app` 目录顶层后，可删除对应的 `<link>` 标签：
 
 ```tsx filename="app/layout.tsx" switcher
 export default function RootLayout({
@@ -257,23 +221,7 @@ export default function RootLayout({
 }
 ```
 
-```jsx filename="app/layout.js" switcher
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <head>
-        <title>My App</title>
-        <meta name="description" content="My App is a..." />
-      </head>
-      <body>
-        <div id="root">{children}</div>
-      </body>
-    </html>
-  )
-}
-```
-
-6. 最后，使用 [元数据 API](/docs/app/getting-started/metadata-and-og-images) 管理剩余的 `<head>` 标签，将元数据信息移至导出的 [`metadata` 对象](/docs/app/api-reference/functions/generate-metadata#metadata-object)：
+6. 最后使用 [元数据 API](/docs/app/getting-started/metadata-and-og-images) 管理剩余 `<head>` 标签，将元数据移至导出的 [`metadata` 对象](/docs/app/api-reference/functions/generate-metadata#metadata-object)：
 
 ```tsx filename="app/layout.tsx" switcher
 import type { Metadata } from 'next'
@@ -298,36 +246,19 @@ export default function RootLayout({
 }
 ```
 
-```jsx filename="app/layout.js" switcher
-export const metadata = {
-  title: 'My App',
-  description: 'My App is a...',
-}
-
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <body>
-        <div id="root">{children}</div>
-      </body>
-    </html>
-  )
-}
-```
-
-通过以上变更，您从在 `index.html` 中声明所有内容转变为使用 Next.js 框架内置的基于约定的方法（[元数据 API](/docs/app/getting-started/metadata-and-og-images)），这能更轻松地提升页面的 SEO 和网络可分享性。
+通过以上变更，您从声明式 `index.html` 转向了 Next.js 基于约定的框架内置方案（[元数据 API](/docs/app/getting-started/metadata-and-og-images)），这将更易于提升页面的 SEO 和网络可分享性。
 
 ### 步骤 5：创建入口页面
 
-在 Next.js 中，您可以通过创建 `page.tsx` 文件来声明应用的入口点。这与 Vite 中的 `main.tsx` 文件最为接近。本步骤将设置应用的入口点。
+在 Next.js 中，您通过创建 `page.tsx` 文件来声明应用的入口点。这与 Vite 中的 `main.tsx` 文件最为接近。本步骤将设置应用的入口点。
 
 1. **在 `app` 目录下创建 `[[...slug]]` 目录**
 
-由于本指南的目标是首先将 Next.js 设置为单页应用 (SPA)，您需要让页面入口捕获应用的所有可能路由。为此，请在 `app` 目录下创建一个新的 `[[...slug]]` 目录。
+由于本指南的目标是先将 Next.js 配置为单页应用 (SPA)，您需要让页面入口捕获应用的所有可能路由。为此，请在 `app` 目录下新建 `[[...slug]]` 目录。
 
-此目录称为 [可选全捕获路由段](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments)。Next.js 使用基于文件系统的路由系统，其中文件夹用于定义路由。这个特殊目录将确保应用的所有路由都会定向到其包含的 `page.tsx` 文件。
+此目录称为 [可选全捕获路由段](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments)。Next.js 使用基于文件系统的路由系统，其中文件夹用于定义路由。此特殊目录将确保应用的所有路由都会定向到其包含的 `page.tsx` 文件。
 
-2. **在 `app/[[...slug]]` 目录中创建一个新的 `page.tsx` 文件，内容如下：**
+2. **在 `app/[[...slug]]` 目录下创建新的 `page.tsx` 文件，内容如下：**
 
 ```tsx filename="app/[[...slug]]/page.tsx" switcher
 import '../../index.css'
@@ -355,9 +286,9 @@ export default function Page() {
 
 > **须知**：页面文件可以使用 `.js`、`.jsx` 或 `.tsx` 扩展名。
 
-此文件是一个 [服务端组件 (Server Component)](/docs/app/getting-started/server-and-client-components)。运行 `next build` 时，文件会被预渲染为静态资源，无需任何动态代码。
+此文件是一个 [服务端组件 (Server Component)](/docs/app/getting-started/server-and-client-components)。运行 `next build` 时，该文件会被预渲染为静态资源，_不_ 需要任何动态代码。
 
-该文件导入了全局 CSS，并告诉 [`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 我们只会生成一个路由，即根路径 `/`。
+该文件导入了全局 CSS 并告知 [`generateStaticParams`](/docs/app/api-reference/functions/generate-static-params) 我们仅生成一个路由，即根路径 `/`。
 
 接下来，我们将迁移 Vite 应用的其余部分，这部分将仅在客户端运行。
 
@@ -387,7 +318,7 @@ export function ClientOnly() {
 }
 ```
 
-此文件是一个 [客户端组件 (Client Component)](/docs/app/getting-started/server-and-client-components)，由 `'use client'` 指令定义。客户端组件在发送到客户端之前仍会在服务器上 [预渲染为 HTML](/docs/app/getting-started/server-and-client-components#how-do-server-and-client-components-work-in-nextjs)。
+此文件是一个 [客户端组件 (Client Component)](/docs/app/getting-started/server-and-client-components)，由 `'use client'` 指令定义。客户端组件在发送到客户端之前仍会在服务端 [预渲染为 HTML](/docs/app/getting-started/server-and-client-components#how-do-server-and-client-components-work-in-nextjs)。
 
 由于我们目前需要一个纯客户端应用，可以配置 Next.js 从 `App` 组件开始禁用预渲染：
 
@@ -395,7 +326,7 @@ export function ClientOnly() {
 const App = dynamic(() => import('../../App'), { ssr: false })
 ```
 
-现在，更新入口页面以使用新组件：
+现在更新入口页面以使用新组件：
 
 ```tsx filename="app/[[...slug]]/page.tsx" switcher
 import '../../index.css'
@@ -435,41 +366,41 @@ export default function App() {
 }
 ```
 
-在 Next.js 中，静态图片导入会返回一个对象。该对象可以直接用于 Next.js 的 [`<Image>` 组件](/docs/app/api-reference/components/image)，也可以通过其 `src` 属性用于现有的 `<img>` 标签。
+而在 Next.js 中，静态图片导入会返回一个对象。该对象可以直接用于 Next.js 的 [`<Image>` 组件](/docs/app/api-reference/components/image)，或者您可以使用对象的 `src` 属性配合现有的 `<img>` 标签。
 
-`<Image>` 组件具有 [自动图片优化](/docs/app/api-reference/components/image) 的额外优势。它会根据图片尺寸自动设置生成的 `<img>` 的 `width` 和 `height` 属性，防止图片加载时的布局偏移。但如果应用中存在仅设置了其中一个尺寸而未将另一个尺寸设为 `auto` 的图片，可能会导致问题。未设置为 `auto` 的尺寸会默认为 `<img>` 尺寸属性的值，可能导致图片显示失真。
+`<Image>` 组件具有 [自动图片优化](/docs/app/api-reference/components/image) 的额外优势。它会根据图片尺寸自动设置 `<img>` 的 `width` 和 `height` 属性，防止图片加载时的布局偏移。但如果应用中存在仅设置了一个维度样式而未将另一个维度设为 `auto` 的图片，可能会导致问题。未设置为 `auto` 的维度会默认使用 `<img>` 维度属性的值，可能导致图片显示变形。
 
-保留 `<img>` 标签可以减少应用的改动量并避免上述问题。之后您可以逐步迁移到 `<Image>` 组件，通过 [配置 loader](/docs/app/api-reference/components/image#loader) 或切换到默认的 Next.js 服务器（支持自动图片优化）来优化图片。
+保留 `<img>` 标签可以减少应用的改动量并避免上述问题。之后您可以逐步迁移到 `<Image>` 组件，通过 [配置加载器 (loader)](/docs/app/api-reference/components/image#loader) 或切换到默认的 Next.js 服务器（支持自动图片优化）来优化图片。
 
-1. **将 `/public` 导入的绝对路径转换为相对路径：**
+1. **将 `/public` 导入的绝对路径改为相对路径：**
 
 ```tsx
-// 之前
+// 修改前
 import logo from '/logo.png'
 
-// 之后
+// 修改后
 import logo from '../public/logo.png'
 ```
 
-2. **将图片的 `src` 属性而非整个图片对象传递给 `<img>` 标签：**
+2. **将图片对象的 `src` 属性而非整个对象传递给 `<img>` 标签：**
 
 ```tsx
-// 之前
+// 修改前
 <img src={logo} />
 
-// 之后
+// 修改后
 <img src={logo.src} />
 ```
 
-或者，您可以根据文件名引用图片资源的公共 URL。例如，`public/logo.png` 会在应用中通过 `/logo.png` 提供图片，该路径即为 `src` 值。
+或者，您可以根据文件名直接引用图片的公共 URL。例如，`public/logo.png` 会在应用中通过 `/logo.png` 提供图片，即 `src` 值。
 
-> **注意**：如果使用 TypeScript，访问 `src` 属性时可能会遇到类型错误。目前可以安全忽略这些错误，本指南后续会修复。
+> **注意**：如果您使用 TypeScript，可能会在访问 `src` 属性时遇到类型错误。目前可以安全忽略这些错误，本指南后续会解决。
 
 ### 步骤 7：迁移环境变量
 
-Next.js 支持与 Vite 类似的 `.env` [环境变量](/docs/app/guides/environment-variables)。主要区别在于客户端暴露环境变量的前缀。
+Next.js 支持类似于 Vite 的 `.env` [环境变量](/docs/app/guides/environment-variables)。主要区别在于客户端暴露环境变量时使用的前缀。
 
-- 将所有 `VITE_` 前缀的环境变量改为 `NEXT_PUBLIC_`。
+- 将所有以 `VITE_` 为前缀的环境变量改为 `NEXT_PUBLIC_`。
 
 Vite 在特殊的 `import.meta.env` 对象上暴露了一些内置环境变量，Next.js 不支持这些变量。需要按以下方式更新它们的用法：
 
@@ -478,7 +409,7 @@ Vite 在特殊的 `import.meta.env` 对象上暴露了一些内置环境变量
 - `import.meta.env.DEV` ⇒ `process.env.NODE_ENV !== 'production'`
 - `import.meta.env.SSR` ⇒ `typeof window !== 'undefined'`
 
-Next.js 也没有内置的 `BASE_URL` 环境变量。但如果需要，您可以自行配置：
+Next.js 也没有提供内置的 `BASE_URL` 环境变量。但如果您需要，仍可以配置一个：
 
 1. **在 `.env` 文件中添加以下内容：**
 
@@ -487,14 +418,14 @@ Next.js 也没有内置的 `BASE_URL` 环境变量。但如果需要，您可以
 NEXT_PUBLIC_BASE_PATH="/some-base-path"
 ```
 
-2. **在 `next.config.mjs` 文件中将 [`basePath`](/docs/app/api-reference/config/next-config-js/basePath) 设为 `process.env.NEXT_PUBLIC_BASE_PATH`：**
+2. **在 `next.config.mjs` 文件中将 [`basePath`](/docs/app/api-reference/config/next-config-js/basePath) 设置为 `process.env.NEXT_PUBLIC_BASE_PATH`：**
 
 ```js filename="next.config.mjs"
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  output: 'export', // 输出为单页应用 (SPA)
-  distDir: './dist', // 将构建输出目录改为 `./dist/`
-  basePath: process.env.NEXT_PUBLIC_BASE_PATH, // 设置基础路径为 `/some-base-path`
+  output: 'export', // 输出为单页应用 (SPA)。
+  distDir: './dist', // 将构建输出目录改为 `./dist/`。
+  basePath: process.env.NEXT_PUBLIC_BASE_PATH, // 将基础路径设置为 `/some-base-path`。
 }
 
 export default nextConfig
@@ -504,7 +435,7 @@ export default nextConfig
 
 ### 步骤 8：更新 `package.json` 中的脚本
 
-现在您应该可以运行应用以测试是否成功迁移到 Next.js。但在运行之前，需要更新 `package.json` 中的 `scripts` 为 Next.js 相关命令，并将 `.next` 和 `next-env.d.ts` 添加到 `.gitignore`：
+现在您应该可以运行应用以测试是否成功迁移到 Next.js。但在那之前，需要更新 `package.json` 中的 `scripts`，添加 Next.js 相关命令，并将 `.next` 和 `next-env.d.ts` 添加到 `.gitignore`：
 
 ```json filename="package.json"
 {
@@ -540,10 +471,10 @@ dist
 
 ## 后续步骤
 
-如果一切顺利，您现在已拥有一个作为单页应用运行的 Next.js 应用。但您尚未充分利用 Next.js 的大多数优势，接下来可以逐步进行更改以获取全部收益。以下是建议的后续步骤：
+如果一切顺利，您现在已拥有一个作为单页应用运行的 Next.js 应用。但您尚未充分利用 Next.js 的大多数优势，接下来可以逐步进行更改以获得全部收益。以下是建议的后续操作：
 
-- 从 React Router 迁移到 [Next.js App Router](/docs/app/building-your-application/routing)，以获得：
-  - 自动代码拆分
+- 从 React Router 迁移到 [Next.js 应用路由 (App Router)](/docs/app/building-your-application/routing)，以获得：
+  - 自动代码分割
   - [流式服务端渲染 (Streaming Server-Rendering)](/docs/app/building-your-application/routing/loading-ui-and-streaming)
   - [React 服务端组件 (React Server Components)](/docs/app/getting-started/server-and-client-components)
 - [使用 `<Image>` 组件优化图片](/docs/app/api-reference/components/image)
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/production-checklist.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/production-checklist.mdx
index 8e3ee747..8e028be5 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/production-checklist.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/production-checklist.mdx
@@ -1,14 +1,14 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-19T23:03:41.088Z
-title: 如何为生产环境优化 Next.js 应用
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:46.712Z
+title: 如何优化 Next.js 应用的生产环境部署
 nav_title: 生产环境
 description: 在将 Next.js 应用部署至生产环境前，确保最佳性能和用户体验的优化建议。
 ---
 
-在将 Next.js 应用部署至生产环境前，您应考虑实施以下优化措施和模式，以获得最佳用户体验、性能和安全性。
+在将 Next.js 应用部署至生产环境前，您应当考虑实施以下优化措施和模式，以获得最佳的用户体验、性能和安全性。
 
-本文档提供了在[应用开发阶段](#during-development)和[上线前准备](#before-going-to-production)可参考的最佳实践，以及您需要了解的[Next.js 自动优化机制](#automatic-optimizations)。
+本页提供了最佳实践指南，可作为[应用开发阶段](#during-development)和[上线前准备](#before-going-to-production)的参考，同时介绍了您需要了解的[Next.js自动优化机制](#automatic-optimizations)。
 
 ## 自动优化
 
@@ -16,19 +16,19 @@ description: 在将 Next.js 应用部署至生产环境前，确保最佳性能
 
 <AppOnly>
 
-- **[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components):** Next.js 默认使用服务端组件。这些组件在服务端运行，无需客户端 JavaScript 即可渲染，因此不会增加客户端 JavaScript 包体积。您可按需使用[客户端组件 (Client Components)](/docs/app/getting-started/server-and-client-components) 实现交互功能。
-- **[代码分割 (Code-splitting)](/docs/app/building-your-application/routing/linking-and-navigating#how-routing-and-navigation-works):** 服务端组件支持按路由段自动代码分割。您还可考虑在适当时[懒加载 (lazy loading)](/docs/app/guides/lazy-loading) 客户端组件和第三方库。
-- **[预获取 (Prefetching)](/docs/app/building-your-application/routing/linking-and-navigating#2-prefetching):** 当用户视图中出现新路由链接时，Next.js 会在后台预获取该路由，实现近乎即时的导航体验。您可在适当时选择禁用此功能。
-- **[静态渲染 (Static Rendering)](/docs/app/getting-started/partial-prerendering#static-rendering):** Next.js 在构建时于服务端静态渲染服务端和客户端组件，并缓存渲染结果以提升性能。您可为特定路由选择启用[动态渲染 (Dynamic Rendering)](/docs/app/getting-started/partial-prerendering#dynamic-rendering)。{/* TODO: 待 PPR 稳定后更新 */}
-- **[缓存 (Caching)](/docs/app/deep-dive/caching):** Next.js 会缓存数据请求、服务端/客户端组件渲染结果、静态资源等，以减少对服务器、数据库和后端服务的网络请求。您可在适当时选择禁用缓存。
+- **[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components):** Next.js 默认使用服务端组件。这些组件在服务器端运行，无需客户端 JavaScript 即可渲染，因此不会增加客户端 JavaScript 包的大小。您可按需使用[客户端组件 (Client Components)](/docs/app/getting-started/server-and-client-components)来实现交互功能。
+- **[代码分割 (Code-splitting)](/docs/app/building-your-application/routing/linking-and-navigating#how-routing-and-navigation-works):** 服务端组件支持按路由段自动代码分割。您还可以考虑在适当场景下对客户端组件和第三方库进行[懒加载 (lazy loading)](/docs/app/guides/lazy-loading)。
+- **[预获取 (Prefetching)](/docs/app/building-your-application/routing/linking-and-navigating#2-prefetching):** 当用户视图中出现新路由链接时，Next.js 会在后台预获取该路由，实现近乎即时的导航体验。您可以在必要时禁用此功能。
+- **[静态渲染 (Static Rendering)](/docs/app/getting-started/partial-prerendering#static-rendering):** Next.js 会在构建时静态渲染服务端和客户端组件，并缓存渲染结果以提升性能。您可以为特定路由选择启用[动态渲染 (Dynamic Rendering)](/docs/app/getting-started/partial-prerendering#dynamic-rendering)。{/* TODO: 待PPR稳定后更新 */}
+- **[缓存机制 (Caching)](/docs/app/deep-dive/caching):** Next.js 会自动缓存数据请求、服务端/客户端组件渲染结果、静态资源等，减少对服务器、数据库和后端服务的网络请求。您可以在必要时禁用缓存。
 
 </AppOnly>
 
 <PagesOnly>
 
-- **[代码分割 (Code-splitting)](/docs/pages/building-your-application/routing/pages-and-layouts):** Next.js 自动按页面分割应用代码，确保导航时仅加载当前页面所需代码。您还可考虑在适当时[懒加载 (lazy loading)](/docs/pages/guides/lazy-loading) 第三方库。
-- **[预获取 (Prefetching)](/docs/pages/api-reference/components/link#prefetch):** 当用户视图中出现新路由链接时，Next.js 会在后台预获取该路由，实现近乎即时的导航体验。您可在适当时选择禁用此功能。
-- **[自动静态优化 (Automatic Static Optimization)](/docs/pages/building-your-application/rendering/automatic-static-optimization):** 若页面无阻塞数据需求，Next.js 会自动判定为静态页面（可预渲染）。优化后的页面可被缓存，并通过多个 CDN 节点分发给终端用户。您可为特定路由选择启用[服务端渲染 (Server-side Rendering)](/docs/pages/building-your-application/data-fetching/get-server-side-props)。
+- **[代码分割 (Code-splitting)](/docs/pages/building-your-application/routing/pages-and-layouts):** Next.js 会按页面自动分割应用代码，确保导航时只加载当前页面所需的代码。您还可以考虑在适当场景下对第三方库进行[懒加载 (lazy loading)](/docs/pages/guides/lazy-loading)。
+- **[预获取 (Prefetching)](/docs/pages/api-reference/components/link#prefetch):** 当用户视图中出现新路由链接时，Next.js 会在后台预获取该路由，实现近乎即时的导航体验。您可以在必要时禁用此功能。
+- **[自动静态优化 (Automatic Static Optimization)](/docs/pages/building-your-application/rendering/automatic-static-optimization):** 对于没有阻塞数据需求的页面，Next.js 会自动判定为静态页面（可预渲染）。优化后的页面可被缓存，并通过多个CDN节点分发给终端用户。您也可以根据需要选择启用[服务端渲染 (Server-side Rendering)](/docs/pages/building-your-application/data-fetching/get-server-side-props)。
 
 </PagesOnly>
 
@@ -36,26 +36,26 @@ description: 在将 Next.js 应用部署至生产环境前，确保最佳性能
 
 ## 开发阶段
 
-在构建应用时，我们建议使用以下功能确保最佳性能和用户体验：
+在构建应用时，我们建议使用以下功能来确保最佳性能和用户体验：
 
 ### 路由与渲染
 
 <AppOnly>
 
-- **[布局 (Layouts)](/docs/app/building-your-application/routing/layouts-and-templates#layouts):** 使用布局在页面间共享 UI，并启用导航时的[部分渲染 (partial rendering)](/docs/app/building-your-application/routing/linking-and-navigating#4-partial-rendering)。
-- **[`<Link>` 组件](/docs/app/building-your-application/routing/linking-and-navigating#link-component):** 使用 `<Link>` 组件实现[客户端导航和预获取 (client-side navigation and prefetching)](/docs/app/building-your-application/routing/linking-and-navigating#how-routing-and-navigation-works)。
-- **[错误处理 (Error Handling)](/docs/app/building-your-application/routing/error-handling):** 通过创建自定义错误页优雅处理生产环境的[全局错误 (catch-all errors)](/docs/app/building-your-application/routing/error-handling) 和 [404 错误](/docs/app/api-reference/file-conventions/not-found)。
-- **[客户端与服务端组件 (Client and Server Components)](/docs/app/getting-started/server-and-client-components#examples):** 遵循服务端与客户端组件的推荐组合模式，检查 [`"use client"` 边界](/docs/app/getting-started/server-and-client-components#examples#moving-client-components-down-the-tree)的放置位置，避免不必要地增加客户端 JavaScript 包体积。
-- **[动态 API (Dynamic APIs)](/docs/app/getting-started/partial-prerendering#dynamic-rendering):** 注意 [`cookies`](/docs/app/api-reference/functions/cookies) 等动态 API 和 [`searchParams`](/docs/app/api-reference/file-conventions/page#searchparams-optional) 属性会使整个路由进入[动态渲染 (Dynamic Rendering)](/docs/app/getting-started/partial-prerendering#dynamic-rendering) 模式（若在[根布局 (Root Layout)](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required) 中使用则会影响整个应用）。确保动态 API 的使用是必要的，并在适当时用 `<Suspense>` 边界包裹。
+- **[布局 (Layouts)](/docs/app/building-your-application/routing/layouts-and-templates#layouts):** 使用布局在页面间共享UI，并启用导航时的[部分渲染 (partial rendering)](/docs/app/building-your-application/routing/linking-and-navigating#4-partial-rendering)功能。
+- **[`<Link>`组件](/docs/app/building-your-application/routing/linking-and-navigating#link-component):** 使用该组件实现[客户端导航和预获取](/docs/app/building-your-application/routing/linking-and-navigating#how-routing-and-navigation-works)功能。
+- **[错误处理 (Error Handling)](/docs/app/building-your-application/routing/error-handling):** 通过创建自定义错误页面，优雅处理生产环境中的[全局错误](/docs/app/building-your-application/routing/error-handling)和[404错误](/docs/app/api-reference/file-conventions/not-found)。
+- **[客户端与服务端组件](/docs/app/getting-started/server-and-client-components#examples):** 遵循服务端与客户端组件的推荐组合模式，检查[`"use client"`边界](/docs/app/getting-started/server-and-client-components#examples#moving-client-components-down-the-tree)的放置位置，避免不必要地增加客户端JavaScript包体积。
+- **[动态API](/docs/app/getting-started/partial-prerendering#dynamic-rendering):** 注意使用如[`cookies`](/docs/app/api-reference/functions/cookies)和[`searchParams`](/docs/app/api-reference/file-conventions/page#searchparams-optional)等动态API会将整个路由（若在[根布局](/docs/app/building-your-application/routing/layouts-and-templates#root-layout-required)中使用则会影响整个应用）切换至[动态渲染模式](/docs/app/getting-started/partial-prerendering#dynamic-rendering)。确保动态API的使用是必要的，并在适当时用`<Suspense>`边界包裹。
 
-> **须知**: [部分预渲染 (Partial Prerendering)（实验性）](/blog/next-14#partial-prerendering-preview) 将允许路由部分内容动态化，而无需使整个路由进入动态渲染模式。
+> **须知**: [部分预渲染 (实验性功能)](/blog/next-14#partial-prerendering-preview)将允许路由部分内容动态化，而无需将整个路由转为动态渲染。
 
 </AppOnly>
 
 <PagesOnly>
 
-- **[`<Link>` 组件](/docs/pages/building-your-application/routing/linking-and-navigating):** 使用 `<Link>` 组件实现客户端导航和预获取。
-- **[自定义错误页 (Custom Errors)](/docs/pages/building-your-application/routing/custom-error):** 优雅处理 [500](/docs/pages/building-your-application/routing/custom-error#500-page) 和 [404 错误](/docs/pages/building-your-application/routing/custom-error#404-page)。
+- **[`<Link>`组件](/docs/pages/building-your-application/routing/linking-and-navigating):** 使用该组件实现客户端导航和预获取功能。
+- **[自定义错误页](/docs/pages/building-your-application/routing/custom-error):** 优雅处理[500](/docs/pages/building-your-application/routing/custom-error#500-page)和[404错误](/docs/pages/building-your-application/routing/custom-error#404-page)。
 
 </PagesOnly>
 
@@ -63,89 +63,88 @@ description: 在将 Next.js 应用部署至生产环境前，确保最佳性能
 
 <AppOnly>
 
-- **[服务端组件 (Server Components)](/docs/app/building-your-application/data-fetching/fetching):** 充分利用服务端组件在服务端获取数据的优势。
-- **[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers):** 通过路由处理器从客户端组件访问后端资源。但避免从服务端组件调用路由处理器，以免产生额外的服务端请求。
-- **[流式传输 (Streaming)](/docs/app/building-your-application/routing/loading-ui-and-streaming):** 使用加载 UI 和 React Suspense 逐步从服务端向客户端发送 UI，防止数据获取时阻塞整个路由。
-- **[并行数据获取 (Parallel Data Fetching)](/docs/app/building-your-application/data-fetching/fetching#parallel-and-sequential-data-fetching):** 在适当时通过并行获取数据减少网络瀑布流。同时考虑在适当时[预加载数据 (preloading data)](/docs/app/building-your-application/data-fetching/fetching#preloading-data)。
-- **[数据缓存 (Data Caching)](/docs/app/deep-dive/caching#data-cache):** 验证数据请求是否被缓存，并在适当时启用缓存。确保未使用 `fetch` 的请求被[缓存](/docs/app/api-reference/functions/unstable_cache)。
-- **[静态资源 (Static Images)](/docs/app/api-reference/file-conventions/public-folder):** 使用 `public` 目录自动缓存应用的静态资源（如图片）。
+- **[服务端组件](/docs/app/building-your-application/data-fetching/fetching):** 充分利用服务端组件在服务器端获取数据的优势。
+- **[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers):** 通过路由处理器从客户端组件访问后端资源。但避免在服务端组件中调用路由处理器，以防止额外的服务器请求。
+- **[流式传输 (Streaming)](/docs/app/building-your-application/routing/loading-ui-and-streaming):** 使用加载UI和React Suspense逐步从服务端向客户端发送UI，防止数据获取期间阻塞整个路由。
+- **[并行数据获取 (Parallel Data Fetching)](/docs/app/getting-started/fetching-data#parallel-data-fetching):** 在适当时通过并行获取数据减少网络瀑布流。同时考虑在必要时[预加载数据](/docs/app/getting-started/fetching-data#preloading-data)。
+- **[数据缓存 (Data Caching)](/docs/app/deep-dive/caching#data-cache):** 验证数据请求是否被缓存，并在适当时启用缓存。确保未使用`fetch`的请求也能被[缓存](/docs/app/api-reference/functions/unstable_cache)。
+- **[静态资源 (Static Images)](/docs/app/api-reference/file-conventions/public-folder):** 使用`public`目录自动缓存应用的静态资源（如图像）。
 
 </AppOnly>
 
 <PagesOnly>
 
-- **[API 路由 (API Routes)](/docs/pages/building-your-application/routing/api-routes):** 使用路由处理器访问后端资源，防止敏感信息暴露给客户端。
-- **[数据缓存 (Data Caching)](/docs/pages/building-your-application/data-fetching/get-static-props):** 验证数据请求是否被缓存，并在适当时启用缓存。确保未使用 `getStaticProps` 的请求在适当时被缓存。
-- **[增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration):** 使用增量静态再生在构建后更新静态页面，而无需重建整个站点。
-- **[静态资源 (Static Images)](/docs/pages/api-reference/file-conventions/public-folder):** 使用 `public` 目录自动缓存应用的静态资源（如图片）。
+- **[API路由](/docs/pages/building-your-application/routing/api-routes):** 使用路由处理器访问后端资源，防止敏感信息暴露给客户端。
+- **[数据缓存](/docs/pages/building-your-application/data-fetching/get-static-props):** 验证数据请求是否被缓存，并在适当时启用缓存。确保未使用`getStaticProps`的请求在适当时被缓存。
+- **[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration):** 使用该功能在构建后更新静态页面，而无需重新构建整个站点。
+- **[静态资源](/docs/pages/api-reference/file-conventions/public-folder):** 使用`public`目录自动缓存应用的静态资源（如图像）。
 
 </PagesOnly>
 
-### UI 与可访问性
+### UI与可访问性
 
 <AppOnly>
 
-- **[表单与验证 (Forms and Validation)](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#forms):** 使用服务端操作 (Server Actions) 处理表单提交、服务端验证和错误处理。
+- **[表单与验证](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#forms):** 使用服务端动作 (Server Actions) 处理表单提交、服务端验证和错误处理。
 
 </AppOnly>
 
-- **[字体模块 (Font Module)](/docs/app/api-reference/components/font):** 使用字体模块优化字体，该模块会自动托管字体文件与其他静态资源，消除外部网络请求并减少[布局偏移 (layout shift)](https://web.dev/articles/cls)。
-- **[`<Image>` 组件](/docs/app/api-reference/components/image):** 使用 Image 组件优化图片，该组件会自动优化图片、防止布局偏移，并以 WebP 等现代格式提供。
-- **[`<Script>` 组件](/docs/app/guides/scripts):** 使用 Script 组件优化第三方脚本，该组件会自动延迟脚本加载，防止阻塞主线程。
-- **[ESLint](/docs/architecture/accessibility#linting):** 使用内置的 `eslint-plugin-jsx-a11y` 插件及早发现可访问性问题。
+- **[字体模块](/docs/app/api-reference/components/font):** 通过字体模块优化字体，自动托管字体文件与其他静态资源，消除外部网络请求，减少[布局偏移 (layout shift)](https://web.dev/articles/cls)。
+- **[`<Image>`组件](/docs/app/api-reference/components/image):** 使用该组件优化图像，自动转换现代格式（如WebP），防止布局偏移。
+- **[`<Script>`组件](/docs/app/guides/scripts):** 使用该组件优化第三方脚本，自动延迟加载避免阻塞主线程。
+- **[ESLint](/docs/architecture/accessibility#linting):** 使用内置的`eslint-plugin-jsx-a11y`插件早期发现可访问性问题。
 
 ### 安全性
 
 <AppOnly>
 
-- **[数据标记 (Tainting)](/docs/app/building-your-application/data-fetching/fetching#preventing-sensitive-data-from-being-exposed-to-the-client):** 通过标记数据对象或特定值，防止敏感数据暴露给客户端。
-- **[服务端操作 (Server Actions)](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#authentication-and-authorization):** 确保用户有权调用服务端操作。查阅推荐的[安全实践](/blog/security-nextjs-server-components-actions)。
+- **[数据污染防护 (Tainting)](/docs/app/api-reference/config/next-config-js/taint):** 通过标记数据对象或特定值，防止敏感数据暴露给客户端。
+- **[服务端动作](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#authentication-and-authorization):** 确保用户有权调用服务端动作。查阅推荐的[安全实践](/blog/security-nextjs-server-components-actions)。
 
 </AppOnly>
 
-- **[环境变量 (Environment Variables)](/docs/app/guides/environment-variables):** 确保 `.env.*` 文件已添加到 `.gitignore`，且仅公开变量以 `NEXT_PUBLIC_` 为前缀。
-- **[内容安全策略 (Content Security Policy)](/docs/app/guides/content-security-policy):** 考虑添加内容安全策略，防止应用遭受跨站脚本、点击劫持等代码注入攻击。
+- **[环境变量](/docs/app/guides/environment-variables):** 确保`.env.*`文件已加入`.gitignore`，且只有公共变量以`NEXT_PUBLIC_`为前缀。
+- **[内容安全策略 (Content Security Policy)](/docs/app/guides/content-security-policy):** 考虑添加CSP策略防范XSS、点击劫持等代码注入攻击。
 
-### 元数据与 SEO
+### 元数据与SEO
 
 <AppOnly>
 
-- **[元数据 API (Metadata API)](/docs/app/getting-started/metadata-and-og-images):** 使用元数据 API 添加页面标题、描述等信息，提升应用的搜索引擎优化 (SEO)。
-- **[Open Graph (OG) 图片](/docs/app/api-reference/file-conventions/metadata/opengraph-image):** 创建 OG 图片为社交分享做准备。
-- **[站点地图 (Sitemaps)](/docs/app/api-reference/functions/generate-sitemaps) 和 [Robots 文件](/docs/app/api-reference/file-conventions/metadata/robots):** 通过生成站点地图和 robots 文件帮助搜索引擎抓取和索引页面。
+- **[元数据API](/docs/app/getting-started/metadata-and-og-images):** 使用该API添加页面标题、描述等信息，提升搜索引擎优化(SEO)。
+- **[开放图谱(OG)图片](/docs/app/api-reference/file-conventions/metadata/opengraph-image):** 创建OG图片优化社交分享效果。
+- **[站点地图](/docs/app/api-reference/functions/generate-sitemaps)与[robots文件](/docs/app/api-reference/file-conventions/metadata/robots):** 生成这些文件帮助搜索引擎抓取和索引页面。
 
 </AppOnly>
 
 <PagesOnly>
 
-- **[`<Head>` 组件](/docs/pages/api-reference/components/head):** 使用 `next/head` 组件添加页面标题、描述等信息。
+- **[`<Head>`组件](/docs/pages/api-reference/components/head):** 使用该组件添加页面标题、描述等元信息。
 
 </PagesOnly>
 
 ### 类型安全
 
-- **TypeScript 和 [TS 插件](/docs/app/api-reference/config/typescript):** 使用 TypeScript 和 TypeScript 插件提升类型安全性，及早发现错误。
+- **TypeScript与[TS插件](/docs/app/api-reference/config/typescript):** 使用TypeScript及其插件增强类型安全，早期发现错误。
 
 ## 上线前准备
 
-在上线前，可运行 `next build` 在本地构建应用并捕获构建错误，然后运行 `next start` 测量应用在生产环境下的性能表现。
+在上线前，可运行`next build`本地构建应用并捕获构建错误，然后运行`next start`在类生产环境中测量性能。
 
-### 核心 Web 指标
+### 核心Web指标
 
-- **[Lighthouse](https://developers.google.com/web/tools/lighthouse):** 在隐身模式下运行 Lighthouse，更好地理解用户体验并识别改进点。此为模拟测试，应与实际数据（如核心 Web 指标）结合分析。
+- **[Lighthouse](https://developers.google.com/web/tools/lighthouse):** 在隐身模式下运行测试，了解用户体验并发现改进点（需结合真实用户的核心Web指标数据）。
 
 <AppOnly>
 
-- **[`useReportWebVitals` 钩子](/docs/app/api-reference/functions/use-report-web-vitals):** 使用此钩子向分析工具发送[核心 Web 指标 (Core Web Vitals)](https://web.dev/articles/vitals) 数据。
+- **[`useReportWebVitals`钩子](/docs/app/api-reference/functions/use-report-web-vitals):** 使用该钩子向分析工具发送[核心Web指标](https://web.dev/articles/vitals)数据。
 
 </AppOnly>
 
 ### 包分析
 
-使用 [`@next/bundle-analyzer` 插件](/docs/app/guides/package-bundling#analyzing-javascript-bundles) 分析 JavaScript 包大小，识别可能影响性能的大型模块和依赖。
-
-此外，以下工具可帮助您了解新增依赖对应用的影响：
+使用[`@next/bundle-analyzer`插件](/docs/app/guides/package-bundling#analyzing-javascript-bundles)分析JavaScript包大小，识别可能影响性能的大型模块和依赖。
 
+以下工具可帮助评估新依赖的影响：
 - [Import Cost](https://marketplace.visualstudio.com/items?itemName=wix.vscode-import-cost)
 - [Package Phobia](https://packagephobia.com/)
 - [Bundle Phobia](https://bundlephobia.com/)
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/self-hosting.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/self-hosting.mdx
index 531f8e35..50ebead7 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/self-hosting.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/self-hosting.mdx
@@ -1,12 +1,12 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-19T23:02:16.001Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:38.516Z
 title: 如何自托管你的 Next.js 应用
 nav_title: 自托管
 description: 学习如何在 Node.js 服务器、Docker 镜像或静态 HTML 文件（静态导出）上自托管你的 Next.js 应用。
 ---
 
-{/* 本文档内容在应用路由器和页面路由器之间共享。你可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由器的内容。任何共享内容不应包裹在组件中。 */}
+{/* 本文档内容在应用路由和页面路由间共享。你可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加仅适用于页面路由的内容。所有共享内容不应包裹在任何组件中。 */}
 
 当你[部署](/docs/app/getting-started/deploying) Next.js 应用时，可能需要根据基础设施配置不同功能的处理方式。
 
@@ -14,39 +14,39 @@ description: 学习如何在 Node.js 服务器、Docker 镜像或静态 HTML 文
 
 ## 图片优化
 
-通过 `next/image` 实现的[图片优化](/docs/app/api-reference/components/image)在自托管时使用 `next start` 部署无需额外配置即可工作。如果你希望使用单独的服务来优化图片，可以[配置图片加载器](/docs/app/api-reference/components/image#loader)。
+通过 `next/image` 实现的[图片优化](/docs/app/api-reference/components/image)在自托管时使用 `next start` 部署无需额外配置即可工作。如果希望使用独立服务优化图片，可以[配置图片加载器](/docs/app/api-reference/components/image#loader)。
 
-通过静态导出时，可以在 `next.config.js` 中定义自定义图片加载器来使用[图片优化](/docs/app/guides/static-exports#image-optimization)。注意图片是在运行时优化，而非构建时。
+通过静态导出 ([static export](/docs/app/guides/static-exports#image-optimization)) 使用图片优化时，需在 `next.config.js` 中定义自定义图片加载器。注意图片是在运行时而非构建时优化的。
 
 > **须知：**
 >
-> - 在基于 glibc 的 Linux 系统上，图片优化可能需要[额外配置](https://sharp.pixelplumbing.com/install#linux-memory-allocator)以防止内存使用过高。
-> - 了解更多关于[优化图片的缓存行为](/docs/app/api-reference/components/image#minimumcachettl)以及如何配置 TTL。
-> - 你也可以[禁用图片优化](/docs/app/api-reference/components/image#unoptimized)并保留使用 `next/image` 的其他优势。例如，如果你已自行优化图片。
+> - 在基于 glibc 的 Linux 系统上，图片优化可能需要[额外配置](https://sharp.pixelplumbing.com/install#linux-memory-allocator)以防止内存占用过高。
+> - 了解[优化图片的缓存行为](/docs/app/api-reference/components/image#minimumcachettl)及如何配置 TTL。
+> - 也可以[禁用图片优化](/docs/app/api-reference/components/image#unoptimized)同时保留 `next/image` 的其他优势。例如，如果你已自行优化图片。
 
 ## 中间件
 
-[中间件](/docs/app/building-your-application/routing/middleware)在自托管时使用 `next start` 部署无需额外配置即可工作。由于它需要访问传入请求，因此不支持[静态导出](/docs/app/guides/static-exports)。
+[中间件](/docs/app/building-your-application/routing/middleware)在自托管时使用 `next start` 部署无需额外配置即可工作。由于需要访问传入请求，静态导出 ([static export](/docs/app/guides/static-exports)) 不支持此功能。
 
-中间件使用 [Edge 运行时](/docs/app/api-reference/edge)，这是所有可用 Node.js API 的一个子集，有助于确保低延迟，因为它可能在应用中的每个路由或资源前运行。如果不希望这样，可以使用[完整的 Node.js 运行时](/blog/next-15-2#nodejs-middleware-experimental)来运行中间件。
+中间件使用 [Edge 运行时](/docs/app/api-reference/edge)，这是所有可用 Node.js API 的子集，有助于确保低延迟，因为它可能运行在应用的每个路由或资源前。如果不希望如此，可以使用[完整 Node.js 运行时](/blog/next-15-2#nodejs-middleware-experimental)运行中间件。
 
-如果你想添加需要所有 Node.js API 的逻辑（或使用外部包），可以将此逻辑移至[布局](/docs/app/building-your-application/routing/layouts-and-templates#layouts)作为[服务器组件](/docs/app/getting-started/server-and-client-components)。例如，检查[请求头](/docs/app/api-reference/functions/headers)和[重定向](/docs/app/api-reference/functions/redirect)。你也可以通过 `next.config.js` 使用请求头、Cookie 或查询参数进行[重定向](/docs/app/api-reference/config/next-config-js/redirects#header-cookie-and-query-matching)或[重写](/docs/app/api-reference/config/next-config-js/rewrites#header-cookie-and-query-matching)。如果这不可行，还可以使用[自定义服务器](/docs/pages/guides/custom-server)。
+如需添加需要全部 Node.js API 的逻辑（或使用外部包），可以考虑将此逻辑移至[布局](/docs/app/building-your-application/routing/layouts-and-templates#layouts)作为[服务端组件](/docs/app/getting-started/server-and-client-components)。例如，检查[请求头](/docs/app/api-reference/functions/headers)和[重定向](/docs/app/api-reference/functions/redirect)。也可以通过 `next.config.js` 使用请求头、cookie 或查询参数进行[重定向](/docs/app/api-reference/config/next-config-js/redirects#header-cookie-and-query-matching)或[重写](/docs/app/api-reference/config/next-config-js/rewrites#header-cookie-and-query-matching)。如果这些方法不适用，还可以使用[自定义服务器](/docs/pages/guides/custom-server)。
 
 ## 环境变量
 
 Next.js 支持构建时和运行时环境变量。
 
-**默认情况下，环境变量仅在服务器端可用**。要将环境变量暴露给浏览器，必须在其前添加 `NEXT_PUBLIC_` 前缀。然而，这些公共环境变量会在 `next build` 时内联到 JavaScript 包中。
+**默认情况下，环境变量仅在服务端可用**。要在浏览器中暴露环境变量，需添加 `NEXT_PUBLIC_` 前缀。但这些公共环境变量会在 `next build` 时内联到 JavaScript 包中。
 
 <PagesOnly>
 
-要读取运行时环境变量，建议使用 `getServerSideProps` 或[逐步采用应用路由器](/docs/app/guides/migrating/app-router-migration)。
+要读取运行时环境变量，建议使用 `getServerSideProps` 或[逐步迁移到应用路由](/docs/app/guides/migrating/app-router-migration)。
 
 </PagesOnly>
 
 <AppOnly>
 
-你可以在动态渲染期间安全地在服务器上读取环境变量。
+可以在动态渲染时安全地在服务端读取环境变量。
 
 ```tsx filename="app/page.ts" switcher
 import { connection } from 'next/server'
@@ -54,8 +54,8 @@ import { connection } from 'next/server'
 export default async function Component() {
   await connection()
   // cookies、headers 和其他动态 API
-  // 也会选择动态渲染，意味着
-  // 这个环境变量在运行时被评估
+  // 也会启用动态渲染，意味着
+  // 这个环境变量是在运行时评估的
   const value = process.env.MY_VALUE
   // ...
 }
@@ -67,8 +67,8 @@ import { connection } from 'next/server'
 export default async function Component() {
   await connection()
   // cookies、headers 和其他动态 API
-  // 也会选择动态渲染，意味着
-  // 这个环境变量在运行时被评估
+  // 也会启用动态渲染，意味着
+  // 这个环境变量是在运行时评估的
   const value = process.env.MY_VALUE
   // ...
 }
@@ -76,47 +76,47 @@ export default async function Component() {
 
 </AppOnly>
 
-这允许你使用单一的 Docker 镜像，通过多个环境推广时使用不同的值。
+这样可以使用单一的 Docker 镜像，在不同环境中部署时使用不同的值。
 
 > **须知：**
 >
-> - 你可以使用 [`register` 函数](/docs/app/guides/instrumentation)在服务器启动时运行代码。
-> - 不建议使用 [runtimeConfig](/docs/pages/api-reference/config/next-config-js/runtime-configuration) 选项，因为它不适用于独立输出模式。相反，建议[逐步采用](/docs/app/guides/migrating/app-router-migration)应用路由器。
+> - 可以使用 [`register` 函数](/docs/app/guides/instrumentation)在服务启动时运行代码。
+> - 不建议使用 [runtimeConfig](/docs/pages/api-reference/config/next-config-js/runtime-configuration) 选项，因为它不适用于独立输出模式。建议[逐步迁移](/docs/app/guides/migrating/app-router-migration)到应用路由。
 
 ## 缓存与 ISR
 
-Next.js 可以缓存响应、生成的静态页面、构建输出以及其他静态资源，如图片、字体和脚本。
+Next.js 可以缓存响应、生成的静态页面、构建输出以及其他静态资源如图片、字体和脚本。
 
-缓存和重新验证页面（通过[增量静态再生 (ISR)](/docs/app/building-your-application/data-fetching/incremental-static-regeneration)）使用**相同的共享缓存**。默认情况下，此缓存存储在 Next.js 服务器的文件系统（磁盘）上。**这在自托管时自动生效**，适用于页面路由器和应用路由器。
+缓存和重新验证页面（通过[增量静态生成 (ISR)](/docs/app/guides/incremental-static-regeneration)）使用**共享缓存**。默认情况下，此缓存存储在 Next.js 服务器的文件系统（磁盘）上。**自托管时**，无论是页面路由还是应用路由，此功能都会自动工作。
 
-如果你想将缓存的页面和数据持久化到持久存储中，或在多个容器或 Next.js 应用实例之间共享缓存，可以配置 Next.js 缓存位置。
+如果需要将缓存页面和数据持久化到持久存储，或在多个容器或 Next.js 应用实例间共享缓存，可以配置 Next.js 缓存位置。
 
 ### 自动缓存
 
-- Next.js 为真正不可变的资源设置 `Cache-Control` 头为 `public, max-age=31536000, immutable`。这不可覆盖。这些不可变文件在文件名中包含 SHA 哈希，因此可以安全地无限期缓存。例如，[静态图片导入](/docs/app/getting-started/images#local-images)。你可以为图片[配置 TTL](/docs/app/api-reference/components/image#minimumcachettl)。
-- 增量静态再生 (ISR) 设置 `Cache-Control` 头为 `s-maxage: <revalidate in getStaticProps>, stale-while-revalidate`。此重新验证时间在你的 [`getStaticProps` 函数](/docs/pages/building-your-application/data-fetching/get-static-props)中以秒为单位定义。如果设置 `revalidate: false`，则默认为一年缓存时长。
-- 动态渲染的页面设置 `Cache-Control` 头为 `private, no-cache, no-store, max-age=0, must-revalidate` 以防止用户特定数据被缓存。这适用于应用路由器和页面路由器。还包括[草稿模式](/docs/app/guides/draft-mode)。
+- Next.js 为真正不可变的资源设置 `Cache-Control` 头为 `public, max-age=31536000, immutable`。此设置不可覆盖。这些不可变文件包含文件名中的 SHA 哈希，因此可以安全地无限期缓存。例如，[静态图片导入](/docs/app/getting-started/images#local-images)。可以为图片[配置 TTL](/docs/app/api-reference/components/image#minimumcachettl)。
+- 增量静态生成 (ISR) 设置 `Cache-Control` 头为 `s-maxage: <在 getStaticProps 中定义的重新验证时间>, stale-while-revalidate`。此重新验证时间在 [`getStaticProps` 函数](/docs/pages/building-your-application/data-fetching/get-static-props)中以秒为单位定义。如果设置 `revalidate: false`，则默认为一年缓存时长。
+- 动态渲染的页面设置 `Cache-Control` 头为 `private, no-cache, no-store, max-age=0, must-revalidate`，以防止用户特定数据被缓存。这适用于应用路由和页面路由。也包括[草稿模式](/docs/app/guides/draft-mode)。
 
 ### 静态资源
 
-如果你想在不同的域名或 CDN 上托管静态资源，可以在 `next.config.js` 中使用 `assetPrefix` [配置](/docs/app/api-reference/config/next-config-js/assetPrefix)。Next.js 在获取 JavaScript 或 CSS 文件时会使用此资源前缀。将资源分离到不同域名的缺点是额外的 DNS 和 TLS 解析时间。
+如果希望在不同域名或 CDN 上托管静态资源，可以在 `next.config.js` 中使用 `assetPrefix` [配置](/docs/app/api-reference/config/next-config-js/assetPrefix)。Next.js 在获取 JavaScript 或 CSS 文件时会使用此前缀。将资源分离到不同域名会增加 DNS 和 TLS 解析时间。
 
 [了解更多关于 `assetPrefix`](/docs/app/api-reference/config/next-config-js/assetPrefix)。
 
 ### 配置缓存
 
-默认情况下，生成的缓存资源将存储在内存中（默认为 50MB）和磁盘上。如果你使用容器编排平台（如 Kubernetes）托管 Next.js，每个 pod 都会有一份缓存副本。为了防止显示过时数据（因为默认情况下缓存不在 pod 之间共享），可以配置 Next.js 缓存以提供缓存处理器并禁用内存缓存。
+默认情况下，生成的缓存资源会存储在内存中（默认为 50MB）和磁盘上。如果使用 Kubernetes 等容器编排平台托管 Next.js，每个 pod 都会有缓存的副本。为了防止因缓存默认不在 pod 间共享而显示过时数据，可以配置 Next.js 缓存提供缓存处理器并禁用内存缓存。
 
-在自托管时配置 ISR/数据缓存位置，可以在 `next.config.js` 文件中配置自定义处理器：
+自托管时配置 ISR/数据缓存位置，可以在 `next.config.js` 文件中配置自定义处理器：
 
 ```jsx filename="next.config.js"
 module.exports = {
   cacheHandler: require.resolve('./cache-handler.js'),
-  cacheMaxMemorySize: 0, // 禁用默认的内存缓存
+  cacheMaxMemorySize: 0, // 禁用默认内存缓存
 }
 ```
 
-然后，在项目根目录创建 `cache-handler.js`，例如：
+然后在项目根目录创建 `cache-handler.js`，例如：
 
 ```jsx filename="cache-handler.js"
 const cache = new Map()
@@ -152,28 +152,28 @@ module.exports = class CacheHandler {
     }
   }
 
-  // 如果你想为单个请求设置临时内存缓存，并在下一个请求前重置，
-  // 可以利用此方法
+  // 如果想为单个请求设置临时内存缓存，
+  // 并在下一个请求前重置，可以利用此方法
   resetRequestCache() {}
 }
 ```
 
-使用自定义缓存处理器可以确保所有托管 Next.js 应用的 pod 之间的一致性。例如，你可以将缓存值存储在任何地方，如 [Redis](https://github.com/vercel/next.js/tree/canary/examples/cache-handler-redis) 或 AWS S3。
+使用自定义缓存处理器可以确保所有托管 Next.js 应用的 pod 间的一致性。例如，可以将缓存值存储在任意位置，如 [Redis](https://github.com/vercel/next.js/tree/canary/examples/cache-handler-redis) 或 AWS S3。
 
 > **须知：**
 >
-> - `revalidatePath` 是缓存标签上的一个便利层。调用 `revalidatePath` 会使用提供的页面的特殊默认标签调用 `revalidateTag` 函数。
+> - `revalidatePath` 是缓存标签上的便利层。调用 `revalidatePath` 会使用提供的页面的特殊默认标签调用 `revalidateTag` 函数。
 
 ## 构建缓存
 
-Next.js 在 `next build` 期间生成一个 ID，用于标识正在服务的应用版本。相同的构建应该用于启动多个容器。
+Next.js 在 `next build` 时生成 ID 以标识正在服务的应用版本。相同的构建应被用于启动多个容器。
 
-如果你为环境的每个阶段重新构建，需要在容器之间使用一致的构建 ID。在 `next.config.js` 中使用 `generateBuildId` 命令：
+如果为环境的每个阶段重新构建，需要生成一致的构建 ID 以在容器间使用。在 `next.config.js` 中使用 `generateBuildId` 命令：
 
 ```jsx filename="next.config.js"
 module.exports = {
   generateBuildId: async () => {
-    // 可以是任何内容，使用最新的 git 哈希
+    // 可以是任何内容，如最新的 git 哈希
     return process.env.GIT_HASH
   },
 }
@@ -181,17 +181,17 @@ module.exports = {
 
 ## 版本偏差
 
-Next.js 会自动缓解大多数[版本偏差](https://www.industrialempathy.com/posts/version-skew/)的情况，并在检测到不匹配时自动重新加载应用以获取新资源。例如，如果 `deploymentId` 不匹配，页面之间的转换将执行硬导航而非使用预取的值。
+Next.js 会自动缓解大多数[版本偏差](https://www.industrialempathy.com/posts/version-skew/)情况，并在检测到不匹配时自动重新加载应用以获取新资源。例如，如果 `deploymentId` 不匹配，页面间的跳转会执行硬导航而非使用预取的值。
 
-当应用重新加载时，如果未设计为在页面导航之间保持状态，可能会丢失应用状态。例如，使用 URL 状态或本地存储会在页面刷新后保持状态。然而，像 `useState` 这样的组件状态会在这种导航中丢失。
+应用重新加载时，如果未设计为在页面导航间持久化状态，可能会丢失应用状态。例如，使用 URL 状态或本地存储会在页面刷新后保持状态。但组件状态如 `useState` 会在此类导航中丢失。
 
 <AppOnly>
 
 ## 流式传输与 Suspense
 
-Next.js 应用路由器在自托管时支持[流式响应](/docs/app/building-your-application/routing/loading-ui-and-streaming)。如果使用 Nginx 或类似代理，需要配置其禁用缓冲以启用流式传输。
+Next.js 应用路由在自托管时支持[流式响应](/docs/app/building-your-application/routing/loading-ui-and-streaming)。如果使用 Nginx 或类似代理，需要配置禁用缓冲以启用流式传输。
 
-例如，可以通过将 `X-Accel-Buffering` 设置为 `no` 来禁用 Nginx 中的缓冲：
+例如，可以在 Nginx 中通过设置 `X-Accel-Buffering` 为 `no` 来禁用缓冲：
 
 ```js filename="next.config.js"
 module.exports = {
@@ -213,15 +213,15 @@ module.exports = {
 
 ## 部分预渲染
 
-[部分预渲染（实验性）](/docs/app/getting-started/partial-prerendering)默认与 Next.js 一起工作，不是仅限 CDN 的功能。这包括作为 Node.js 服务器（通过 `next start`）部署和使用 Docker 容器时。
+[部分预渲染（实验性）](/docs/app/getting-started/partial-prerendering)在 Next.js 中默认工作，并非仅限 CDN 的功能。这包括作为 Node.js 服务器部署（通过 `next start`）和使用 Docker 容器时。
 
-## 与 CDN 一起使用
+## 与 CDN 配合使用
 
-当在 Next.js 应用前使用 CDN 时，页面在访问动态 API 时会包含 `Cache-Control: private` 响应头。这确保生成的 HTML 页面被标记为不可缓存。如果页面完全预渲染为静态，则会包含 `Cache-Control: public` 以允许页面在 CDN 上缓存。
+在 Next.js 应用前使用 CDN 时，当访问动态 API 时，页面会包含 `Cache-Control: private` 响应头。这确保生成的 HTML 页面标记为不可缓存。如果页面完全预渲染为静态，则会包含 `Cache-Control: public` 以允许在 CDN 上缓存页面。
 
-如果不需要混合静态和动态组件，可以将整个路由设为静态并在 CDN 上缓存输出 HTML。如果未使用动态 API，这是运行 `next build` 时的默认行为（自动静态优化）。
+如果不需要混合静态和动态组件，可以使整个路由静态化并在 CDN 上缓存输出 HTML。如果不使用动态 API，运行 `next build` 时的默认行为就是自动静态优化。
 
-随着部分预渲染趋于稳定，我们将通过部署适配器 API 提供支持。
+随着部分预渲染功能趋于稳定，我们将通过部署适配器 API 提供支持。
 
 </AppOnly>
 
@@ -231,7 +231,7 @@ module.exports = {
 
 [`after`](/docs/app/api-reference/functions/after) 在使用 `next start` 自托管时完全支持。
 
-停止服务器时，确保通过发送 `SIGINT` 或 `SIGTERM` 信号并等待来实现优雅关闭。这允许 Next.js 服务器等待 `after` 内使用的待处理回调函数或 Promise 完成。
+停止服务器时，通过发送 `SIGINT` 或 `SIGTERM` 信号并等待，确保优雅关闭。这允许 Next.js 服务器等待 `after` 内部使用的待处理回调函数或 promise 完成。
 
 </AppOnly>
 
@@ -239,9 +239,9 @@ module.exports = {
 
 ## 手动优雅关闭
 
-在自托管时，你可能希望在服务器因 `SIGTERM` 或 `SIGINT` 信号关闭时运行代码。
+自托管时，可能希望在服务器通过 `SIGTERM` 或 `SIGINT` 信号关闭时运行代码。
 
-你可以设置环境变量 `NEXT_MANUAL_SIG_HANDLE` 为 `true`，然后在 `_document.js` 文件中为该信号注册处理器。你需要在 `package.json` 脚本中直接注册环境变量，而不是在 `.env` 文件中。
+可以设置环境变量 `NEXT_MANUAL_SIG_HANDLE` 为 `true`，然后在 `_document.js` 文件中为该信号注册处理程序。需要直接在 `package.json` 脚本中注册环境变量，而非在 `.env` 文件中。
 
 > **须知**：手动信号处理在 `next dev` 中不可用。
 
@@ -258,11 +258,11 @@ module.exports = {
 ```js filename="pages/_document.js"
 if (process.env.NEXT_MANUAL_SIG_HANDLE) {
   process.on('SIGTERM', () => {
-    console.log('Received SIGTERM: cleaning up')
+    console.log('收到 SIGTERM：清理中')
     process.exit(0)
   })
   process.on('SIGINT', () => {
-    console.log('Received SIGINT: cleaning up')
+    console.log('收到 SIGINT：清理中')
     process.exit(0)
   })
 }
diff --git a/apps/docs/content/zh-hans/docs/01-app/02-guides/static-exports.mdx b/apps/docs/content/zh-hans/docs/01-app/02-guides/static-exports.mdx
index e20e8310..71899509 100644
--- a/apps/docs/content/zh-hans/docs/01-app/02-guides/static-exports.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/02-guides/static-exports.mdx
@@ -1,22 +1,22 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:01:54.467Z
-title: 如何生成 Next.js 应用的静态导出文件
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:35.767Z
+title: 如何创建 Next.js 应用的静态导出
 nav_title: 静态导出
-description: Next.js 允许您从静态站点或单页应用 (SPA) 开始，后续可选择升级使用需要服务器的功能。
+description: Next.js 允许您从静态站点或单页应用 (SPA) 开始，随后可选择升级使用需要服务器的功能。
 ---
 
-{/* 本文档内容在应用路由和页面路由间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。任何共享内容不应包裹在组件中。*/}
+{/* 本文档内容在应用路由器和页面路由器之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由器的内容。任何共享内容不应包裹在组件中。*/}
 
-Next.js 允许您从静态站点或单页应用 (SPA) 开始，后续可选择升级使用需要服务器的功能。
+Next.js 允许您从静态站点或单页应用 (SPA) 开始，随后可选择升级使用需要服务器的功能。
 
 当运行 `next build` 时，Next.js 会为每个路由生成一个 HTML 文件。通过将严格的 SPA 拆分为单独的 HTML 文件，Next.js 可以避免在客户端加载不必要的 JavaScript 代码，从而减少包体积并实现更快的页面加载。
 
-由于 Next.js 支持这种静态导出，因此可以部署在任何能够提供 HTML/CSS/JS 静态资源的 Web 服务器上。
+由于 Next.js 支持这种静态导出，它可以被部署和托管在任何能够提供 HTML/CSS/JS 静态资源的 Web 服务器上。
 
 ## 配置
 
-要启用静态导出，请在 `next.config.js` 中修改输出模式：
+要启用静态导出，请在 `next.config.js` 中更改输出模式：
 
 ```js filename="next.config.js" highlight={5}
 /**
@@ -25,24 +25,24 @@ Next.js 允许您从静态站点或单页应用 (SPA) 开始，后续可选择
 const nextConfig = {
   output: 'export',
 
-  // 可选：将链接 `/me` 改为 `/me/` 并生成 `/me.html` 为 `/me/index.html`
+  // 可选：将链接 `/me` 改为 `/me/` 并生成 `/me.html` -> `/me/index.html`
   // trailingSlash: true,
 
   // 可选：阻止自动将 `/me` 重定向到 `/me/`，保留原始 `href`
   // skipTrailingSlashRedirect: true,
 
-  // 可选：修改输出目录 `out` 为 `dist`
+  // 可选：更改输出目录 `out` -> `dist`
   // distDir: 'dist',
 }
 
 module.exports = nextConfig
 ```
 
-运行 `next build` 后，Next.js 会创建一个包含应用 HTML/CSS/JS 资源的 `out` 文件夹。
+运行 `next build` 后，Next.js 将创建一个包含应用程序 HTML/CSS/JS 资源的 `out` 文件夹。
 
 <PagesOnly>
 
-您可以使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 和 [`getStaticPaths`](/docs/pages/building-your-application/data-fetching/get-static-paths) 为 `pages` 目录中的每个页面（或更多 [动态路由](/docs/app/building-your-application/routing/dynamic-routes)）生成 HTML 文件。
+您可以使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 和 [`getStaticPaths`](/docs/pages/building-your-application/data-fetching/get-static-paths) 为 `pages` 目录中的每个页面（或更多用于[动态路由](/docs/app/building-your-application/routing/dynamic-routes)）生成 HTML 文件。
 
 </PagesOnly>
 
@@ -52,15 +52,15 @@ module.exports = nextConfig
 
 Next.js 的核心设计支持静态导出。
 
-### 服务端组件 (Server Components)
+### 服务器组件
 
-当您运行 `next build` 生成静态导出时，`app` 目录中的服务端组件会在构建期间运行，类似于传统的静态站点生成。
+当您运行 `next build` 生成静态导出时，`app` 目录中的服务器组件将在构建期间运行，类似于传统的静态站点生成。
 
-生成的组件将被渲染为初始页面加载的静态 HTML 和客户端路由导航的静态负载。使用静态导出时，除非服务端组件使用了 [动态服务器功能](#不支持的功能)，否则无需对它们进行任何更改。
+生成的组件将被渲染为初始页面加载的静态 HTML 和客户端路由导航之间的静态有效负载。使用静态导出时，除非服务器组件使用了[动态服务器功能](#不支持的功能)，否则无需对它们进行任何更改。
 
 ```tsx filename="app/page.tsx" switcher
 export default async function Page() {
-  // 此 fetch 会在 `next build` 期间在服务端运行
+  // 此 fetch 将在 `next build` 期间在服务器上运行
   const res = await fetch('https://api.example.com/...')
   const data = await res.json()
 
@@ -68,9 +68,9 @@ export default async function Page() {
 }
 ```
 
-### 客户端组件 (Client Components)
+### 客户端组件
 
-如果需要在客户端获取数据，可以使用客户端组件配合 [SWR](https://github.com/vercel/swr) 来缓存请求。
+如果需要在客户端获取数据，可以使用带有 [SWR](https://github.com/vercel/swr) 的客户端组件来缓存请求。
 
 ```tsx filename="app/other/page.tsx" switcher
 'use client'
@@ -154,22 +154,22 @@ export default function Page() {
 
 ## 支持的功能
 
-构建静态站点所需的大部分 Next.js 核心功能都得到支持，包括：
+构建静态站点所需的大多数核心 Next.js 功能都受支持，包括：
 
 - [使用 `getStaticPaths` 时的动态路由](/docs/app/building-your-application/routing/dynamic-routes)
 - 使用 `next/link` 预取
 - 预加载 JavaScript
 - [动态导入](/docs/pages/guides/lazy-loading)
-- 任何样式选项（例如 CSS 模块、styled-jsx）
+- 任何样式选项（如 CSS 模块、styled-jsx）
 - [客户端数据获取](/docs/pages/building-your-application/data-fetching/client-side)
 - [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)
 - [`getStaticPaths`](/docs/pages/building-your-application/data-fetching/get-static-paths)
 
 </PagesOnly>
 
-### 图片优化 (Image Optimization)
+### 图片优化
 
-通过 `next/image` 实现的 [图片优化](/docs/app/api-reference/components/image) 可以在静态导出中使用，只需在 `next.config.js` 中定义自定义图片加载器。例如，您可以使用 Cloudinary 等服务优化图片：
+通过 `next/image` 实现的[图片优化](/docs/app/api-reference/components/image)可以在静态导出中使用，方法是在 `next.config.js` 中定义自定义图片加载器。例如，您可以使用 Cloudinary 等服务优化图片：
 
 ```js filename="next.config.js"
 /** @type {import('next').NextConfig} */
@@ -212,7 +212,7 @@ export default function cloudinaryLoader({ src, width, quality }) {
 }
 ```
 
-然后您可以在应用中使用 `next/image`，定义 Cloudinary 中图片的相对路径：
+然后您可以在应用程序中使用 `next/image`，定义 Cloudinary 中图片的相对路径：
 
 ```tsx filename="app/page.tsx" switcher
 import Image from 'next/image'
@@ -232,29 +232,29 @@ export default function Page() {
 
 <AppOnly>
 
-### 路由处理器 (Route Handlers)
+### 路由处理器
 
-运行 `next build` 时，路由处理器会渲染静态响应。仅支持 `GET` HTTP 方法。这可用于从缓存或非缓存数据生成静态 HTML、JSON、TXT 或其他文件。例如：
+运行 `next build` 时，路由处理器将渲染静态响应。仅支持 `GET` HTTP 方法。这可用于从缓存或非缓存数据生成静态 HTML、JSON、TXT 或其他文件。例如：
 
 ```ts filename="app/data.json/route.ts" switcher
 export async function GET() {
-  return Response.json({ name: 'Lee' })
+  return Response.json({ name: '李' })
 }
 ```
 
 ```js filename="app/data.json/route.js" switcher
 export async function GET() {
-  return Response.json({ name: 'Lee' })
+  return Response.json({ name: '李' })
 }
 ```
 
-上述文件 `app/data.json/route.ts` 将在 `next build` 期间渲染为静态文件，生成包含 `{ name: 'Lee' }` 的 `data.json`。
+上述文件 `app/data.json/route.ts` 将在 `next build` 期间渲染为静态文件，生成包含 `{ name: '李' }` 的 `data.json`。
 
 如果需要从传入请求中读取动态值，则无法使用静态导出。
 
-### 浏览器 API (Browser APIs)
+### 浏览器 API
 
-客户端组件在 `next build` 期间会被预渲染为 HTML。由于 [Web API](https://developer.mozilla.org/docs/Web/API) 如 `window`、`localStorage` 和 `navigator` 在服务器上不可用，您需要确保仅在浏览器环境中安全访问这些 API。例如：
+客户端组件在 `next build` 期间会被预渲染为 HTML。由于 `window`、`localStorage` 和 `navigator` 等 [Web API](https://developer.mozilla.org/docs/Web/API) 在服务器上不可用，您需要仅在浏览器运行时安全地访问这些 API。例如：
 
 ```jsx
 'use client';
@@ -275,25 +275,25 @@ export default function ClientComponent() {
 
 ## 不支持的功能
 
-需要 Node.js 服务器或在构建过程中无法计算的动态逻辑的功能**不**支持：
+需要 Node.js 服务器或在构建过程中无法计算的动态逻辑的功能**不**受支持：
 
 <AppOnly>
 
-- 使用 `dynamicParams: true` 的 [动态路由](/docs/app/building-your-application/routing/dynamic-routes)
-- 没有 `generateStaticParams()` 的 [动态路由](/docs/app/building-your-application/routing/dynamic-routes)
-- 依赖 Request 的 [路由处理器](/docs/app/building-your-application/routing/route-handlers)
+- 使用 `dynamicParams: true` 的[动态路由](/docs/app/building-your-application/routing/dynamic-routes)
+- 没有 `generateStaticParams()` 的[动态路由](/docs/app/building-your-application/routing/dynamic-routes)
+- 依赖 Request 的[路由处理器](/docs/app/building-your-application/routing/route-handlers)
 - [Cookies](/docs/app/api-reference/functions/cookies)
 - [重写](/docs/app/api-reference/config/next-config-js/rewrites)
 - [重定向](/docs/app/api-reference/config/next-config-js/redirects)
-- [标头](/docs/app/api-reference/config/next-config-js/headers)
+- [Headers](/docs/app/api-reference/config/next-config-js/headers)
 - [中间件](/docs/app/building-your-application/routing/middleware)
-- [增量静态再生](/docs/app/building-your-application/data-fetching/incremental-static-regeneration)
-- 使用默认 `loader` 的 [图片优化](/docs/app/api-reference/components/image)
+- [增量静态再生](/docs/app/guides/incremental-static-regeneration)
+- 使用默认 `loader` 的[图片优化](/docs/app/api-reference/components/image)
 - [草稿模式](/docs/app/guides/draft-mode)
 - [服务器操作](/docs/app/building-your-application/data-fetching/server-actions-and-mutations)
 - [拦截路由](/docs/app/building-your-application/routing/intercepting-routes)
 
-尝试在 `next dev` 中使用这些功能会导致错误，类似于在根布局中将 [`dynamic`](/docs/app/api-reference/file-conventions/route-segment-config#dynamic) 选项设置为 `error`。
+尝试在 `next dev` 中使用这些功能将导致错误，类似于在根布局中将 [`dynamic`](/docs/app/api-reference/file-conventions/route-segment-config#dynamic) 选项设置为 `error`。
 
 ```jsx
 export const dynamic = 'error'
@@ -303,14 +303,14 @@ export const dynamic = 'error'
 
 <PagesOnly>
 
-- [国际化路由](/docs/pages/building-your-application/routing/internationalization)
+- [国际化路由](/docs/pages/guides/internationalization)
 - [API 路由](/docs/pages/building-your-application/routing/api-routes)
 - [重写](/docs/pages/api-reference/config/next-config-js/rewrites)
 - [重定向](/docs/pages/api-reference/config/next-config-js/redirects)
-- [标头](/docs/pages/api-reference/config/next-config-js/headers)
+- [Headers](/docs/pages/api-reference/config/next-config-js/headers)
 - [中间件](/docs/pages/building-your-application/routing/middleware)
-- [增量静态再生](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)
-- 使用默认 `loader` 的 [图片优化](/docs/pages/api-reference/components/image)
+- [增量静态再生](/docs/pages/guides/incremental-static-regeneration)
+- 使用默认 `loader` 的[图片优化](/docs/pages/api-reference/components/image)
 - [草稿模式](/docs/pages/guides/draft-mode)
 - [`getStaticPaths` 使用 `fallback: true`](/docs/pages/api-reference/functions/get-static-paths#fallback-true)
 - [`getStaticPaths` 使用 `fallback: 'blocking'`](/docs/pages/api-reference/functions/get-static-paths#fallback-blocking)
@@ -320,7 +320,7 @@ export const dynamic = 'error'
 
 ## 部署
 
-使用静态导出时，Next.js 可以部署在任何能够提供 HTML/CSS/JS 静态资源的 Web 服务器上。
+使用静态导出时，Next.js 可以部署和托管在任何能够提供 HTML/CSS/JS 静态资源的 Web 服务器上。
 
 运行 `next build` 时，Next.js 会将静态导出生成到 `out` 文件夹中。例如，假设您有以下路由：
 
@@ -334,7 +334,7 @@ export const dynamic = 'error'
 - `/out/blog/post-1.html`
 - `/out/blog/post-2.html`
 
-如果使用 Nginx 等静态主机，可以配置从传入请求到正确文件的重写：
+如果使用像 Nginx 这样的静态主机，您可以配置从传入请求到正确文件的重写：
 
 ```nginx filename="nginx.conf"
 server {
@@ -348,7 +348,7 @@ server {
   }
 
   # 当 `trailingSlash: false` 时需要此配置
-  # 当 `trailingSlash: true` 时可省略
+  # 当 `trailingSlash: true` 时可以省略
   location /blog/ {
       rewrite ^/blog/(.*)$ /blog/$1.html break;
   }
@@ -365,5 +365,5 @@ server {
 | 版本      | 变更                                                                                                               |
 | --------- | ------------------------------------------------------------------------------------------------------------------ |
 | `v14.0.0` | `next export` 已被移除，改用 `"output": "export"`                                                                  |
-| `v13.4.0` | 应用路由（稳定版）增强了静态导出支持，包括使用 React 服务端组件和路由处理器。                                      |
-| `v13.3.0` | `next export` 已弃用，替换为 `"output": "export"`                                                                  |
\ No newline at end of file
+| `v13.4.0` | 应用路由器（稳定版）增强了静态导出支持，包括使用 React 服务器组件和路由处理器。                                    |
+| `v13.3.0` | `next export` 已被弃用，替换为 `"output": "export"`                                                                |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/05-error-handling.mdx b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/05-error-handling.mdx
index 324d0d71..5d55f050 100644
--- a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/05-error-handling.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/05-error-handling.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:53:08.421Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:20:26.411Z
 title: 错误处理
 description: 学习如何显示预期错误并处理未捕获异常。
 related:
@@ -15,11 +15,11 @@ related:
 
 ## 处理预期错误
 
-预期错误指应用正常运行过程中可能出现的错误，例如来自[服务端表单验证](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#server-side-form-validation)或失败请求的错误。这些错误应被显式处理并返回至客户端。
+预期错误指应用正常运行过程中可能出现的错误，例如来自[服务端表单验证](/docs/app/building-your-application/data-fetching/server-actions-and-mutations#server-side-form-validation)或失败的请求。这些错误应被显式处理并返回至客户端。
 
-### 处理服务端操作的预期错误
+### 处理来自服务端操作的预期错误
 
-使用 `useActionState` 钩子管理服务端操作的状态，包括错误处理。此方法避免对预期错误使用 `try`/`catch` 块，这类错误应建模为返回值而非抛出异常。
+使用 `useActionState` 钩子管理服务端操作的状态，包括错误处理。此方法避免对预期错误使用 `try`/`catch` 块，这些错误应建模为返回值而非抛出异常。
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -31,7 +31,7 @@ export async function createUser(prevState: any, formData: FormData) {
   const json = await res.json()
 
   if (!res.ok) {
-    return { message: '请输入有效的邮箱地址' }
+    return { message: '请输入有效的邮箱' }
   }
 
   redirect('/dashboard')
@@ -48,14 +48,14 @@ export async function createUser(prevState, formData) {
   const json = await res.json()
 
   if (!res.ok) {
-    return { message: '请输入有效的邮箱地址' }
+    return { message: '请输入有效的邮箱' }
   }
 
   redirect('/dashboard')
 }
 ```
 
-然后，您可以将操作传递给 `useActionState` 钩子，并使用返回的 `state` 显示错误信息。
+然后，您可以将操作传递给 `useActionState` 钩子，并使用返回的 `state` 显示错误消息。
 
 ```tsx filename="app/ui/signup.tsx" highlight={11,18-20} switcher
 'use client'
@@ -107,11 +107,11 @@ export function Signup() {
 }
 ```
 
-您也可以使用返回的状态在客户端组件中显示 toast 通知。
+您也可以使用返回的状态在客户端组件中显示 toast 消息。
 
-### 处理服务端组件的预期错误
+### 处理来自服务端组件的预期错误
 
-在服务端组件内获取数据时，您可以使用响应条件式渲染错误信息或执行[重定向](/docs/app/building-your-application/routing/redirecting#redirect-function)。
+在服务端组件中获取数据时，可以使用响应条件渲染错误消息或执行[重定向](/docs/app/building-your-application/routing/redirecting#redirect-function)。
 
 ```tsx filename="app/page.tsx" switcher
 export default async function Page() {
@@ -141,17 +141,17 @@ export default async function Page() {
 
 ## 未捕获异常
 
-未捕获异常是意外错误，表明应用中不应出现的 bug 或问题。这些错误应通过抛出异常来处理，随后会被错误边界捕获。
+未捕获异常是意外错误，表示不应在应用正常流程中出现的 bug 或问题。这些错误应通过抛出异常处理，随后被错误边界捕获。
 
-- **常见方式**：使用 `error.js` 处理根布局下方的未捕获错误。
+- **常见方式**：使用 `error.js` 处理根布局下的未捕获错误。
 - **可选方式**：通过嵌套的 `error.js` 文件（如 `app/dashboard/error.js`）处理细粒度未捕获错误。
 - **不常见方式**：使用 `global-error.js` 处理根布局中的未捕获错误。
 
 ### 使用错误边界
 
-Next.js 使用错误边界处理未捕获异常。错误边界会捕获子组件中的错误，并显示备用 UI 而非崩溃的组件树。
+Next.js 使用错误边界处理未捕获异常。错误边界捕获其子组件中的错误，并显示备用 UI 而非崩溃的组件树。
 
-通过在路由段内创建 `error.tsx` 文件并导出 React 组件来建立错误边界：
+通过在路由段内创建 `error.tsx` 文件并导出 React 组件来创建错误边界：
 
 ```tsx filename="app/dashboard/error.tsx" switcher
 'use client' // 错误边界必须是客户端组件
@@ -213,11 +213,11 @@ export default function Error({ error, reset }) {
 }
 ```
 
-若希望错误冒泡至父级错误边界，可在渲染 `error` 组件时使用 `throw`。
+如果希望错误冒泡至父级错误边界，可以在渲染 `error` 组件时 `throw` 错误。
 
 ### 处理嵌套路由中的错误
 
-错误会冒泡至最近的父级错误边界。通过在[路由层级](/docs/app/getting-started/project-structure#component-hierarchy)的不同位置放置 `error.tsx` 文件，可实现细粒度的错误处理。
+错误会冒泡至最近的父级错误边界。通过在[路由层级](/docs/app/getting-started/project-structure#component-hierarchy)的不同层级放置 `error.tsx` 文件，可实现细粒度的错误处理。
 
 <Image
   alt="嵌套错误组件层级"
@@ -229,7 +229,7 @@ export default function Error({ error, reset }) {
 
 ### 处理全局错误
 
-虽然较少见，但您可以使用位于根应用目录的 `app/global-error.js` 处理根布局中的错误，即使在使用[国际化](/docs/app/building-your-application/routing/internationalization)时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签，因为它在激活时会替换根布局或模板。
+虽然不常见，但您可以使用位于根应用目录的 `app/global-error.js` 处理根布局中的错误，即使在使用[国际化](/docs/app/guides/internationalization)时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签，因为它在激活时会替换根布局或模板。
 
 ```tsx filename="app/global-error.tsx" switcher
 'use client' // 错误边界必须是客户端组件
diff --git a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/13-route-handlers.mdx b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/13-route-handlers.mdx
index e08f061f..ad4952a0 100644
--- a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/13-route-handlers.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/01-routing/13-route-handlers.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:52:48.045Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:22:10.044Z
 title: 路由处理器 (Route Handlers)
 description: 使用 Web 的 Request 和 Response API 为指定路由创建自定义请求处理器。
 related:
@@ -20,11 +20,11 @@ related:
   height="444"
 />
 
-> **须知**：路由处理器仅在 `app` 目录内可用。它们等同于 `pages` 目录中的 [API 路由](/docs/pages/building-your-application/routing/api-routes)，这意味着您**无需**同时使用 API 路由和路由处理器。
+> **须知**：路由处理器仅在 `app` 目录内可用。它们等同于 `pages` 目录中的 [API 路由](/docs/pages/building-your-application/routing/api-routes)，这意味着您**不需要**同时使用 API 路由和路由处理器。
 
 ## 约定
 
-路由处理器定义在 `app` 目录下的 [`route.js|ts` 文件](/docs/app/api-reference/file-conventions/route)中：
+路由处理器在 `app` 目录下的 [`route.js|ts` 文件](/docs/app/api-reference/file-conventions/route)中定义：
 
 ```ts filename="app/api/route.ts" switcher
 export async function GET(request: Request) {}
@@ -34,7 +34,7 @@ export async function GET(request: Request) {}
 export async function GET(request) {}
 ```
 
-路由处理器可以嵌套在 `app` 目录的任何位置，类似于 `page.js` 和 `layout.js`。但在与 `page.js` 相同的路由段级别**不能**存在 `route.js` 文件。
+路由处理器可以嵌套在 `app` 目录的任何位置，类似于 `page.js` 和 `layout.js`。但在与 `page.js` 相同的路由层级**不能**存在 `route.js` 文件。
 
 ### 支持的 HTTP 方法
 
@@ -42,13 +42,13 @@ export async function GET(request) {}
 
 ### 扩展的 `NextRequest` 和 `NextResponse` API
 
-除了支持原生 [Request](https://developer.mozilla.org/docs/Web/API/Request) 和 [Response](https://developer.mozilla.org/docs/Web/API/Response) API 外，Next.js 还通过 [`NextRequest`](/docs/app/api-reference/functions/next-request) 和 [`NextResponse`](/docs/app/api-reference/functions/next-response) 对其进行了扩展，为高级用例提供了便捷的辅助方法。
+除了支持原生 [Request](https://developer.mozilla.org/docs/Web/API/Request) 和 [Response](https://developer.mozilla.org/docs/Web/API/Response) API 外，Next.js 还通过 [`NextRequest`](/docs/app/api-reference/functions/next-request) 和 [`NextResponse`](/docs/app/api-reference/functions/next-response) 对其进行了扩展，为高级用例提供了便捷的辅助功能。
 
 ## 行为
 
 ### 缓存
 
-路由处理器默认不缓存。但您可以选择为 `GET` 方法启用缓存。其他支持的 HTTP 方法**不会**被缓存。要缓存 `GET` 方法，请在路由处理器文件中使用 [路由配置选项](/docs/app/api-reference/file-conventions/route-segment-config#dynamic)，例如 `export const dynamic = 'force-static'`。
+路由处理器默认不缓存。但您可以为 `GET` 方法启用缓存。其他支持的 HTTP 方法**不会**被缓存。要缓存 `GET` 方法，请在路由处理器文件中使用 [路由配置选项](/docs/app/api-reference/file-conventions/route-segment-config#dynamic)，例如 `export const dynamic = 'force-static'`。
 
 ```ts filename="app/items/route.ts" switcher
 export const dynamic = 'force-static'
@@ -86,14 +86,14 @@ export async function GET() {
 
 ### 特殊路由处理器
 
-特殊路由处理器如 [`sitemap.ts`](/docs/app/api-reference/file-conventions/metadata/sitemap)、[`opengraph-image.tsx`](/docs/app/api-reference/file-conventions/metadata/opengraph-image)、[`icon.tsx`](/docs/app/api-reference/file-conventions/metadata/app-icons) 和其他 [元数据文件](/docs/app/api-reference/file-conventions/metadata) 默认保持静态，除非它们使用了动态 API 或动态配置选项。
+特殊路由处理器如 [`sitemap.ts`](/docs/app/api-reference/file-conventions/metadata/sitemap)、[`opengraph-image.tsx`](/docs/app/api-reference/file-conventions/metadata/opengraph-image)、[`icon.tsx`](/docs/app/api-reference/file-conventions/metadata/app-icons) 和其他 [元数据文件](/docs/app/api-reference/file-conventions/metadata) 默认保持静态，除非它们使用动态 API 或动态配置选项。
 
 ### 路由解析
 
 您可以将 `route` 视为最低级别的路由原语。
 
 - 它们**不参与**布局或客户端导航，如 `page`。
-- 在与 `page.js` 相同的路由上**不能**存在 `route.js` 文件。
+- 在与 `page.js` 相同的路由层级**不能**存在 `route.js` 文件。
 
 | 页面                 | 路由              | 结果                       |
 | -------------------- | ------------------ | ---------------------------- |
@@ -101,7 +101,7 @@ export async function GET() {
 | `app/page.js`        | `app/api/route.js` | <Check size={18} /> 有效    |
 | `app/[user]/page.js` | `app/api/route.js` | <Check size={18} /> 有效    |
 
-每个 `route.js` 或 `page.js` 文件会接管该路由的所有 HTTP 方法。
+每个 `route.js` 或 `page.js` 文件接管该路由的所有 HTTP 方法。
 
 ```ts filename="app/page.ts" switcher
 export default function Page() {
@@ -129,7 +129,7 @@ export async function POST(request) {}
 
 ### 重新验证缓存数据
 
-您可以使用增量静态再生 (ISR) [重新验证缓存数据](/docs/app/building-your-application/data-fetching/incremental-static-regeneration)：
+您可以使用增量静态再生 (ISR) [重新验证缓存数据](/docs/app/guides/incremental-static-regeneration)：
 
 ```ts filename="app/posts/route.ts" switcher
 export const revalidate = 60
@@ -155,7 +155,7 @@ export async function GET() {
 
 ### Cookies
 
-您可以使用 `next/headers` 中的 [`cookies`](/docs/app/api-reference/functions/cookies) 读取或设置 cookies。此服务器函数可以直接在路由处理器中调用，或嵌套在另一个函数内。
+您可以使用 `next/headers` 中的 [`cookies`](/docs/app/api-reference/functions/cookies) 读取或设置 cookies。此服务器函数可以直接在路由处理器中调用，或嵌套在另一个函数中。
 
 或者，您可以使用 [`Set-Cookie`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Set-Cookie) 标头返回一个新的 `Response`。
 
@@ -205,7 +205,7 @@ export async function GET(request) {
 
 ### 标头
 
-您可以使用 `next/headers` 中的 [`headers`](/docs/app/api-reference/functions/headers) 读取标头。此服务器函数可以直接在路由处理器中调用，或嵌套在另一个函数内。
+您可以使用 `next/headers` 中的 [`headers`](/docs/app/api-reference/functions/headers) 读取标头。此服务器函数可以直接在路由处理器中调用，或嵌套在另一个函数中。
 
 此 `headers` 实例是只读的。要设置标头，您需要返回一个带有新 `headers` 的新 `Response`。
 
@@ -273,20 +273,20 @@ export async function GET(request) {
 
 ### 动态路由段
 
-路由处理器可以使用 [动态段](/docs/app/building-your-application/routing/dynamic-routes) 从动态数据创建请求处理器。
+路由处理器可以使用 [动态段 (Dynamic Segments)](/docs/app/building-your-application/routing/dynamic-routes) 从动态数据创建请求处理器。
 
 ```ts filename="app/items/[slug]/route.ts" switcher
 export async function GET(
   request: Request,
   { params }: { params: Promise<{ slug: string }> }
 ) {
-  const { slug } = await params // 'a'、'b' 或 'c'
+  const { slug } = await params // 'a', 'b' 或 'c'
 }
 ```
 
 ```js filename="app/items/[slug]/route.js" switcher
 export async function GET(request, { params }) {
-  const { slug } = await params // 'a'、'b' 或 'c'
+  const { slug } = await params // 'a', 'b' 或 'c'
 }
 ```
 
@@ -298,7 +298,7 @@ export async function GET(request, { params }) {
 
 ### URL 查询参数
 
-传递给路由处理器的请求对象是一个 `NextRequest` 实例，它包含 [一些额外的便捷方法](/docs/app/api-reference/functions/next-request#nexturl)，例如用于更轻松处理查询参数的方法。
+传递给路由处理器的请求对象是一个 `NextRequest` 实例，它包含 [一些额外的便捷方法](/docs/app/api-reference/functions/next-request#nexturl)，例如更轻松地处理查询参数的方法。
 
 ```ts filename="app/api/search/route.ts" switcher
 import { type NextRequest } from 'next/server'
@@ -320,7 +320,7 @@ export function GET(request) {
 
 ### 流式传输
 
-流式传输通常与大型语言模型 (LLM)（如 OpenAI）结合使用，用于生成 AI 内容。了解更多关于 [AI SDK](https://sdk.vercel.ai/docs/introduction) 的信息。
+流式传输通常与大型语言模型 (LLMs)（如 OpenAI）结合使用，用于生成 AI 内容。了解更多关于 [AI SDK](https://sdk.vercel.ai/docs/introduction) 的信息。
 
 ```ts filename="app/api/chat/route.ts" switcher
 import { openai } from '@ai-sdk/openai'
@@ -508,18 +508,18 @@ export async function GET(request) {
 
 > **须知**：
 >
-> - 要为多个路由处理器添加 CORS 标头，您可以使用 [中间件](/docs/app/building-your-application/routing/middleware#cors) 或 [`next.config.js` 文件](/docs/app/api-reference/config/next-config-js/headers#cors)。
+> - 要为多个路由处理器添加 CORS 标头，您可以使用 [中间件 (Middleware)](/docs/app/building-your-application/routing/middleware#cors) 或 [`next.config.js` 文件](/docs/app/api-reference/config/next-config-js/headers#cors)。
 > - 或者，查看我们的 [CORS 示例](https://github.com/vercel/examples/blob/main/edge-functions/cors/lib/cors.ts) 包。
 
-### Webhooks (Webhook 接口)
+### Webhooks 网络钩子
 
-您可以使用路由处理器 (Route Handler) 来接收来自第三方服务的 webhook 请求：
+您可以使用路由处理器 (Route Handler) 来接收来自第三方服务的网络钩子 (webhooks)：
 
 ```ts filename="app/api/route.ts" switcher
 export async function POST(request: Request) {
   try {
     const text = await request.text()
-    // 处理 webhook 有效载荷
+    // 处理 webhook 负载
   } catch (error) {
     return new Response(`Webhook error: ${error.message}`, {
       status: 400,
@@ -536,7 +536,7 @@ export async function POST(request: Request) {
 export async function POST(request) {
   try {
     const text = await request.text()
-    // 处理 webhook 有效载荷
+    // 处理 webhook 负载
   } catch (error) {
     return new Response(`Webhook error: ${error.message}`, {
       status: 400,
@@ -549,11 +549,11 @@ export async function POST(request) {
 }
 ```
 
-值得注意的是，与使用页面路由 (Pages Router) 的 API 路由不同，您不需要使用 `bodyParser` 或进行任何额外配置。
+值得注意的是，与使用页面路由 (Pages Router) 的 API 路由不同，您无需使用 `bodyParser` 或进行任何额外配置。
 
 ### 非 UI 响应
 
-您可以使用路由处理器返回非 UI 内容。请注意 [`sitemap.xml`](/docs/app/api-reference/file-conventions/metadata/sitemap#generating-a-sitemap-using-code-js-ts)、[`robots.txt`](/docs/app/api-reference/file-conventions/metadata/robots#generate-a-robots-file)、[`应用图标`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx) 和 [开放图谱图片](/docs/app/api-reference/file-conventions/metadata/opengraph-image) 都已内置支持。
+您可以使用路由处理器 (Route Handlers) 返回非 UI 内容。请注意 [`sitemap.xml`](/docs/app/api-reference/file-conventions/metadata/sitemap#generating-a-sitemap-using-code-js-ts)、[`robots.txt`](/docs/app/api-reference/file-conventions/metadata/robots#generate-a-robots-file)、[`应用图标`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx) 和 [开放图谱图片](/docs/app/api-reference/file-conventions/metadata/opengraph-image) 都已内置支持。
 
 ```ts filename="app/rss.xml/route.ts" switcher
 export async function GET() {
@@ -594,7 +594,7 @@ export async function GET() {
 
 ### 路由段配置选项
 
-路由处理器使用与页面和布局相同的[路由段配置](/docs/app/api-reference/file-conventions/route-segment-config)。
+路由处理器 (Route Handlers) 使用与页面和布局相同的 [路由段配置](/docs/app/api-reference/file-conventions/route-segment-config)。
 
 ```ts filename="app/items/route.ts" switcher
 export const dynamic = 'auto'
diff --git a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/01-fetching.mdx b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/01-fetching.mdx
index 4a1d8d6e..556f7603 100644
--- a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/01-fetching.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/01-fetching.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:51:53.435Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:20:09.929Z
 title: 数据获取与缓存
 nav_title: 数据获取与缓存
 description: 学习在 Next.js 中服务端或客户端获取数据的最佳实践。
@@ -17,7 +17,7 @@ description: 学习在 Next.js 中服务端或客户端获取数据的最佳实
 
 本指南将带您了解 Next.js 中数据获取与缓存的基础知识，并提供实用示例和最佳实践。
 
-以下是一个 Next.js 数据获取的极简示例：
+以下是 Next.js 中数据获取的最小示例：
 
 ```tsx filename="app/page.tsx" switcher
 export default async function Page() {
@@ -51,152 +51,10 @@ export default async function Page() {
 
 ## 参考文档
 
-- [`fetch` API](/docs/app/api-reference/functions/fetch)
+- [`fetch`](/docs/app/api-reference/functions/fetch)
 - React [`cache`](https://react.dev/reference/react/cache)
 - Next.js [`unstable_cache`](/docs/app/api-reference/functions/unstable_cache)
 
-## 示例
-
-### 使用 `fetch` API 在服务端获取数据
-
-此组件将获取并显示博客文章列表。默认情况下 `fetch` 的响应不会被缓存。
-
-```tsx filename="app/page.tsx" switcher
-export default async function Page() {
-  const data = await fetch('https://api.vercel.app/blog')
-  const posts = await data.json()
-  return (
-    <ul>
-      {posts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-```jsx filename="app/page.js" switcher
-export default async function Page() {
-  const data = await fetch('https://api.vercel.app/blog')
-  const posts = await data.json()
-  return (
-    <ul>
-      {posts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-如果您在此路由的其他位置没有使用任何 [动态 API](/docs/app/getting-started/partial-prerendering#dynamic-rendering)，它将在 `next build` 期间预渲染为静态页面。然后可以使用 [增量静态再生](/docs/app/building-your-application/data-fetching/incremental-static-regeneration) 更新数据。
-
-要阻止页面预渲染，可以在文件中添加：
-
-```js
-export const dynamic = 'force-dynamic'
-```
-
-不过，您通常会使用如 `cookies`、`headers` 或从页面属性读取传入的 `searchParams` 等函数，这些会自动使页面动态渲染。在这种情况下，您不需要显式使用 `force-dynamic`。
-
-### 使用 ORM 或数据库在服务端获取数据
-
-此组件将获取并显示博客文章列表。数据库响应默认不会被缓存，但可以通过 [额外配置](#caching-data-with-an-orm-or-database) 实现缓存。
-
-```tsx filename="app/page.tsx" switcher
-import { db, posts } from '@/lib/db'
-
-export default async function Page() {
-  const allPosts = await db.select().from(posts)
-  return (
-    <ul>
-      {allPosts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-```jsx filename="app/page.js" switcher
-import { db, posts } from '@/lib/db'
-
-export default async function Page() {
-  const allPosts = await db.select().from(posts)
-  return (
-    <ul>
-      {allPosts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-### 在客户端获取数据
-
-我们建议首先尝试在服务端获取数据。
-
-但在某些情况下，客户端数据获取仍然适用。在这些场景中，您可以手动在 `useEffect` 中调用 `fetch`（不推荐），或使用社区流行的 React 库（如 [SWR](https://swr.vercel.app/) 或 [React Query](https://tanstack.com/query/latest)）进行客户端获取。
-
-```tsx filename="app/page.tsx" switcher
-'use client'
-
-import { useState, useEffect } from 'react'
-
-export function Posts() {
-  const [posts, setPosts] = useState(null)
-
-  useEffect(() => {
-    async function fetchPosts() {
-      const res = await fetch('https://api.vercel.app/blog')
-      const data = await res.json()
-      setPosts(data)
-    }
-    fetchPosts()
-  }, [])
-
-  if (!posts) return <div>Loading...</div>
-
-  return (
-    <ul>
-      {posts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-```jsx filename="app/page.js" switcher
-'use client'
-
-import { useState, useEffect } from 'react'
-
-export function Posts() {
-  const [posts, setPosts] = useState(null)
-
-  useEffect(() => {
-    async function fetchPosts() {
-      const res = await fetch('https://api.vercel.app/blog')
-      const data = await res.json()
-      setPosts(data)
-    }
-    fetchPosts()
-  }, [])
-
-  if (!posts) return <div>Loading...</div>
-
-  return (
-    <ul>
-      {posts.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
 ### 使用 ORM 或数据库缓存数据
 
 您可以使用 `unstable_cache` API 在运行 `next build` 时缓存响应。
@@ -251,17 +109,17 @@ export default async function Page() {
 }
 ```
 
-此示例将数据库查询结果缓存 1 小时（3600 秒）。它还添加了缓存标签 `posts`，可以通过 [增量静态再生](/docs/app/building-your-application/data-fetching/incremental-static-regeneration) 进行失效。
+此示例将数据库查询结果缓存 1 小时（3600 秒），并添加了 `posts` 缓存标签，可通过[增量静态再生](/docs/app/guides/incremental-static-regeneration)进行失效处理。
 
-### 在多个函数间复用数据
+### 跨函数复用数据
 
-Next.js 使用如 `generateMetadata` 和 `generateStaticParams` 等 API，您需要在 `page` 中使用相同的数据获取。
+Next.js 使用如 `generateMetadata` 和 `generateStaticParams` 等 API，您需要在 `page` 中复用相同的数据获取逻辑。
 
-如果使用 `fetch`，可以通过添加 `cache: 'force-cache'` 来 [记忆化](/docs/app/deep-dive/caching#request-memoization) 请求。这意味着您可以安全地使用相同选项调用相同 URL，且只会发出一次请求。
+若使用 `fetch`，请求可通过添加 `cache: 'force-cache'` 进行[记忆化](/docs/app/deep-dive/caching#request-memoization)。这意味着您可以安全地使用相同参数调用相同 URL，仅会发起一次请求。
 
 > **须知：**
 >
-> - 在旧版 Next.js 中，使用 `fetch` 会默认 `cache` 值为 `force-cache`。在版本 15 中，默认值改为 `cache: no-store`。
+> - 在旧版 Next.js 中，`fetch` 默认使用 `cache: force-cache`。在版本 15 中已更改为默认 `cache: no-store`。
 
 ```tsx filename="app/blog/[id]/page.tsx" switcher
 import { notFound } from 'next/navigation'
@@ -363,7 +221,7 @@ export default async function Page({ params }) {
 }
 ```
 
-如果没有使用 `fetch`，而是直接使用 ORM 或数据库，可以用 React `cache` 函数包装数据获取。这将去重并只进行一次查询。
+若未使用 `fetch` 而是直接使用 ORM 或数据库，您可以使用 React `cache` 函数包装数据获取逻辑。这将实现去重，仅执行一次查询。
 
 ```jsx
 import { cache } from 'react'
@@ -382,369 +240,4 @@ export const getPost = cache(async (id) => {
 
 ### 重新验证缓存数据
 
-通过 [增量静态再生](/docs/app/building-your-application/data-fetching/incremental-static-regeneration) 了解更多关于重新验证缓存数据的信息。
-
-## 模式
-
-### 并行与顺序数据获取
-
-在组件内部获取数据时，需要注意两种数据获取模式：并行和顺序。
-
-<Image
-  alt="顺序与并行数据获取"
-  srcLight="/docs/light/sequential-parallel-data-fetching.png"
-  srcDark="/docs/dark/sequential-parallel-data-fetching.png"
-  width="1600"
-  height="525"
-/>
-
-- **顺序**：组件树中的请求相互依赖。这可能导致更长的加载时间。
-- **并行**：路由中的请求会立即启动并同时加载数据。这减少了加载数据的总时间。
-
-#### 顺序数据获取
-
-如果有嵌套组件，且每个组件都获取自己的数据，那么如果这些数据请求没有被 [记忆化](/docs/app/deep-dive/caching#request-memoization)，数据获取将按顺序进行。
-
-有些情况下您可能需要这种模式，因为一个请求依赖于另一个的结果。例如，`Playlists` 组件只有在 `Artist` 组件完成数据获取后才会开始获取数据，因为 `Playlists` 依赖于 `artistID` 属性：
-
-```tsx filename="app/artist/[username]/page.tsx" switcher
-export default async function Page({
-  params,
-}: {
-  params: Promise<{ username: string }>
-}) {
-  const { username } = await params
-  // 获取艺术家信息
-  const artist = await getArtist(username)
-
-  return (
-    <>
-      <h1>{artist.name}</h1>
-      {/* 在 Playlists 组件加载时显示备用 UI */}
-      <Suspense fallback={<div>Loading...</div>}>
-        {/* 将艺术家 ID 传递给 Playlists 组件 */}
-        <Playlists artistID={artist.id} />
-      </Suspense>
-    </>
-  )
-}
-
-async function Playlists({ artistID }: { artistID: string }) {
-  // 使用艺术家 ID 获取播放列表
-  const playlists = await getArtistPlaylists(artistID)
-
-  return (
-    <ul>
-      {playlists.map((playlist) => (
-        <li key={playlist.id}>{playlist.name}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-```jsx filename="app/artist/[username]/page.js" switcher
-export default async function Page({ params }) {
-  const { username } = await params
-  // 获取艺术家信息
-  const artist = await getArtist(username)
-
-  return (
-    <>
-      <h1>{artist.name}</h1>
-      {/* 在 Playlists 组件加载时显示备用 UI */}
-      <Suspense fallback={<div>Loading...</div>}>
-        {/* 将艺术家 ID 传递给 Playlists 组件 */}
-        <Playlists artistID={artist.id} />
-      </Suspense>
-    </>
-  )
-}
-
-async function Playlists({ artistID }) {
-  // 使用艺术家 ID 获取播放列表
-  const playlists = await getArtistPlaylists(artistID)
-
-  return (
-    <ul>
-      {playlists.map((playlist) => (
-        <li key={playlist.id}>{playlist.name}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-可以使用 [`loading.js`](/docs/app/building-your-application/routing/loading-ui-and-streaming)（用于路由段）或 [React `<Suspense>`](/docs/app/building-your-application/routing/loading-ui-and-streaming#streaming-with-suspense)（用于嵌套组件）来显示即时加载状态，同时 React 流式传输结果。
-
-这将防止整个路由被数据请求阻塞，用户可以立即与页面中已准备好的部分进行交互。
-
-#### 并行数据获取
-
-默认情况下，布局 (layout) 和页面 (page) 片段会并行渲染。这意味着请求将同时发起。
-
-但由于 `async`/`await` 的特性，在同一片段或组件中被等待的请求会阻塞其下方的所有请求。
-
-要实现并行数据获取，您可以在使用数据的组件外部预先发起请求。这种方式通过并行发起两个请求来节省时间，但用户需要等待两个 Promise 都完成后才能看到渲染结果。
-
-以下示例中，`getArtist` 和 `getAlbums` 函数定义在 `Page` 组件外部，并在组件内部使用 `Promise.all` 同时发起：
-
-```tsx filename="app/artist/[username]/page.tsx" switcher
-import Albums from './albums'
-
-async function getArtist(username: string) {
-  const res = await fetch(`https://api.example.com/artist/${username}`)
-  return res.json()
-}
-
-async function getAlbums(username: string) {
-  const res = await fetch(`https://api.example.com/artist/${username}/albums`)
-  return res.json()
-}
-
-export default async function Page({
-  params,
-}: {
-  params: Promise<{ username: string }>
-}) {
-  const { username } = await params
-  const artistData = getArtist(username)
-  const albumsData = getAlbums(username)
-
-  // 并行发起两个请求
-  const [artist, albums] = await Promise.all([artistData, albumsData])
-
-  return (
-    <>
-      <h1>{artist.name}</h1>
-      <Albums list={albums} />
-    </>
-  )
-}
-```
-
-```jsx filename="app/artist/[username]/page.js" switcher
-import Albums from './albums'
-
-async function getArtist(username) {
-  const res = await fetch(`https://api.example.com/artist/${username}`)
-  return res.json()
-}
-
-async function getAlbums(username) {
-  const res = await fetch(`https://api.example.com/artist/${username}/albums`)
-  return res.json()
-}
-
-export default async function Page({ params }) {
-  const { username } = await params
-  const artistData = getArtist(username)
-  const albumsData = getAlbums(username)
-
-  // 并行发起两个请求
-  const [artist, albums] = await Promise.all([artistData, albumsData])
-
-  return (
-    <>
-      <h1>{artist.name}</h1>
-      <Albums list={albums} />
-    </>
-  )
-}
-```
-
-此外，您可以添加 [Suspense 边界](/docs/app/building-your-application/routing/loading-ui-and-streaming) 来拆分渲染工作，尽快显示部分结果。
-
-### 预加载数据
-
-另一种避免瀑布流 (waterfall) 的方法是使用 _预加载_ 模式：创建一个工具函数，在阻塞请求前主动调用。例如 `checkIsAvailable()` 会阻塞 `<Item/>` 的渲染，您可以在它之前调用 `preload()` 来预先加载 `<Item/>` 的数据依赖。当 `<Item/>` 开始渲染时，其数据已经获取完成。
-
-注意 `preload` 函数不会阻塞 `checkIsAvailable()` 的执行。
-
-```tsx filename="components/Item.tsx" switcher
-import { getItem } from '@/utils/get-item'
-
-export const preload = (id: string) => {
-  // void 会执行给定表达式并返回 undefined
-  // https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/void
-  void getItem(id)
-}
-export default async function Item({ id }: { id: string }) {
-  const result = await getItem(id)
-  // ...
-}
-```
-
-```jsx filename="components/Item.js" switcher
-import { getItem } from '@/utils/get-item'
-
-export const preload = (id) => {
-  // void 会执行给定表达式并返回 undefined
-  // https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/void
-  void getItem(id)
-}
-export default async function Item({ id }) {
-  const result = await getItem(id)
-  // ...
-}
-```
-
-```tsx filename="app/item/[id]/page.tsx" switcher
-import Item, { preload, checkIsAvailable } from '@/components/Item'
-
-export default async function Page({
-  params,
-}: {
-  params: Promise<{ id: string }>
-}) {
-  const { id } = await params
-  // 开始加载项目数据
-  preload(id)
-  // 执行其他异步任务
-  const isAvailable = await checkIsAvailable()
-
-  return isAvailable ? <Item id={id} /> : null
-}
-```
-
-```jsx filename="app/item/[id]/page.js" switcher
-import Item, { preload, checkIsAvailable } from '@/components/Item'
-
-export default async function Page({ params }) {
-  const { id } = await params
-  // 开始加载项目数据
-  preload(id)
-  // 执行其他异步任务
-  const isAvailable = await checkIsAvailable()
-
-  return isAvailable ? <Item id={id} /> : null
-}
-```
-
-> **须知**："preload" 函数可以使用任意名称，因为它是一种模式而非特定 API。
-
-#### 结合 React `cache` 和 `server-only` 使用预加载模式
-
-您可以组合 `cache` 函数、预加载模式和 `server-only` 包，创建可在整个应用中使用的数据获取工具。
-
-```ts filename="utils/get-item.ts" switcher
-import { cache } from 'react'
-import 'server-only'
-
-export const preload = (id: string) => {
-  void getItem(id)
-}
-
-export const getItem = cache(async (id: string) => {
-  // ...
-})
-```
-
-```js filename="utils/get-item.js" switcher
-import { cache } from 'react'
-import 'server-only'
-
-export const preload = (id) => {
-  void getItem(id)
-}
-
-export const getItem = cache(async (id) => {
-  // ...
-})
-```
-
-通过这种方式，您可以预先获取数据、缓存响应，并确保数据获取 [仅在服务端进行](/docs/app/getting-started/server-and-client-components#examples#keeping-server-only-code-out-of-the-client-environment)。
-
-布局 (Layouts)、页面 (Pages) 或其他组件可以使用 `utils/get-item` 导出的方法，控制项目数据的获取时机。
-
-> **须知**：
->
-> - 我们推荐使用 [`server-only` 包](/docs/app/getting-started/server-and-client-components#examples#keeping-server-only-code-out-of-the-client-environment) 确保服务端数据获取函数不会在客户端使用。
-
-### 防止敏感数据暴露给客户端
-
-我们推荐使用 React 的污染 API [`taintObjectReference`](https://react.dev/reference/react/experimental_taintObjectReference) 和 [`taintUniqueValue`](https://react.dev/reference/react/experimental_taintUniqueValue)，防止整个对象实例或敏感值被传递到客户端。
-
-要启用污染功能，请在 Next.js 配置中将 `experimental.taint` 设为 `true`：
-
-```js filename="next.config.js"
-module.exports = {
-  experimental: {
-    taint: true,
-  },
-}
-```
-
-然后将需要污染的对象或值传递给 `experimental_taintObjectReference` 或 `experimental_taintUniqueValue` 函数：
-
-```ts filename="app/utils.ts" switcher
-import { queryDataFromDB } from './api'
-import {
-  experimental_taintObjectReference,
-  experimental_taintUniqueValue,
-} from 'react'
-
-export async function getUserData() {
-  const data = await queryDataFromDB()
-  experimental_taintObjectReference(
-    '禁止将整个用户对象传递给客户端',
-    data
-  )
-  experimental_taintUniqueValue(
-    "禁止将用户地址传递给客户端",
-    data,
-    data.address
-  )
-  return data
-}
-```
-
-```js filename="app/utils.js" switcher
-import { queryDataFromDB } from './api'
-import {
-  experimental_taintObjectReference,
-  experimental_taintUniqueValue,
-} from 'react'
-
-export async function getUserData() {
-  const data = await queryDataFromDB()
-  experimental_taintObjectReference(
-    '禁止将整个用户对象传递给客户端',
-    data
-  )
-  experimental_taintUniqueValue(
-    "禁止将用户地址传递给客户端",
-    data,
-    data.address
-  )
-  return data
-}
-```
-
-```tsx filename="app/page.tsx" switcher
-import { getUserData } from './data'
-
-export async function Page() {
-  const userData = getUserData()
-  return (
-    <ClientComponent
-      user={userData} // 由于 taintObjectReference 会导致错误
-      address={userData.address} // 由于 taintUniqueValue 会导致错误
-    />
-  )
-}
-```
-
-```jsx filename="app/page.js" switcher
-import { getUserData } from './data'
-
-export async function Page() {
-  const userData = await getUserData()
-  return (
-    <ClientComponent
-      user={userData} // 由于 taintObjectReference 会导致错误
-      address={userData.address} // 由于 taintUniqueValue 会导致错误
-    />
-  )
-}
-```
+了解如何使用[增量静态再生](/docs/app/guides/incremental-static-regeneration)重新验证缓存数据。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/03-server-actions-and-mutations.mdx b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/03-server-actions-and-mutations.mdx
index 4f651b0b..85cbafa4 100644
--- a/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/03-server-actions-and-mutations.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/03-building-your-application/02-data-fetching/03-server-actions-and-mutations.mdx
@@ -1,30 +1,30 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:53:04.090Z
-title: 服务端操作与数据变更
-nav_title: 服务端操作与数据变更
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:23:26.993Z
+title: 服务器操作与数据变更
+nav_title: 服务器操作与数据变更
 description: 学习如何使用 Next.js 处理表单提交和数据变更。
 related:
-  description: 了解如何在 Next.js 中配置服务端操作
+  description: 了解如何在 Next.js 中配置服务器操作
   links:
     - app/api-reference/config/next-config-js/serverActions
 ---
 
-[服务端操作 (Server Actions)](https://react.dev/reference/rsc/server-actions) 是**异步函数**，在服务端执行。它们可以在服务端和客户端组件中调用，用于处理 Next.js 应用中的表单提交和数据变更。
+[服务器操作 (Server Actions)](https://react.dev/reference/rsc/server-actions) 是在服务器端执行的**异步函数**。它们可以在服务端和客户端组件中调用，用于处理 Next.js 应用中的表单提交和数据变更。
 
-> **🎥 观看视频：** 了解更多关于服务端操作的数据变更 → [YouTube (10分钟)](https://youtu.be/dDpZfOQBMaU?si=cJZHlUu_jFhCzHUg)。
+> **🎥 观看视频：** 了解更多关于使用服务器操作进行数据变更 → [YouTube (10分钟)](https://youtu.be/dDpZfOQBMaU?si=cJZHlUu_jFhCzHUg)。
 
 ## 约定
 
-可以使用 React 的 [`"use server"`](https://react.dev/reference/react/use-server) 指令定义服务端操作。你可以将指令放在 `async` 函数的顶部，将该函数标记为服务端操作，或者放在单独文件的顶部，将该文件的所有导出标记为服务端操作。
+可以使用 React 的 [`"use server"`](https://react.dev/reference/react/use-server) 指令定义服务器操作。你可以将指令放在 `async` 函数的顶部以标记该函数为服务器操作，或者放在单独文件的顶部以将该文件的所有导出标记为服务器操作。
 
 ### 服务端组件
 
-服务端组件可以使用内联函数级别或模块级别的 `"use server"` 指令。要内联服务端操作，请在函数体顶部添加 `"use server"`：
+服务端组件可以使用内联函数级别或模块级别的 `"use server"` 指令。要内联一个服务器操作，请在函数体顶部添加 `"use server"`：
 
 ```tsx filename="app/page.tsx" switcher
 export default function Page() {
-  // 服务端操作
+  // 服务器操作
   async function create() {
     'use server'
     // 变更数据
@@ -36,7 +36,7 @@ export default function Page() {
 
 ```jsx filename="app/page.js" switcher
 export default function Page() {
-  // 服务端操作
+  // 服务器操作
   async function create() {
     'use server'
     // 变更数据
@@ -48,7 +48,7 @@ export default function Page() {
 
 ### 客户端组件
 
-要在客户端组件中调用服务端操作，创建一个新文件并在其顶部添加 `"use server"` 指令。文件中的所有导出函数将被标记为服务端操作，可以在客户端和服务端组件中复用：
+要在客户端组件中调用服务器操作，创建一个新文件并在其顶部添加 `"use server"` 指令。文件中的所有导出函数将被标记为可在客户端和服务端组件中复用的服务器操作：
 
 ```tsx filename="app/actions.ts" switcher
 'use server'
@@ -84,7 +84,7 @@ export function Button() {
 
 ### 将操作作为属性传递
 
-你也可以将服务端操作作为属性传递给客户端组件：
+你也可以将服务器操作作为属性传递给客户端组件：
 
 ```jsx
 <ClientComponent updateItemAction={updateItem} />
@@ -110,29 +110,29 @@ export default function ClientComponent({ updateItemAction }) {
 }
 ```
 
-通常，Next.js 的 TypeScript 插件会标记 `client-component.tsx` 中的 `updateItemAction`，因为它是一个通常无法跨客户端-服务端边界序列化的函数。然而，名为 `action` 或以 `Action` 结尾的属性被假定为接收服务端操作。这只是一个启发式规则，因为 TypeScript 插件实际上并不知道它接收的是服务端操作还是普通函数。运行时类型检查仍会确保你不会意外地将函数传递给客户端组件。
+通常，Next.js 的 TypeScript 插件会标记 `client-component.tsx` 中的 `updateItemAction`，因为它是一个通常无法在客户端-服务端边界序列化的函数。然而，名为 `action` 或以 `Action` 结尾的属性被假定为接收服务器操作。这只是一个启发式规则，因为 TypeScript 插件实际上并不知道它接收的是服务器操作还是普通函数。运行时类型检查仍会确保你不会意外将函数传递给客户端组件。
 
 ## 行为
 
-- 可以使用 [`<form>` 元素](#forms) 的 `action` 属性调用服务端操作：
-  - 服务端组件默认支持渐进增强，这意味着即使 JavaScript 尚未加载或已禁用，表单也会提交。
-  - 在客户端组件中，调用服务端操作的表单会在 JavaScript 未加载时排队提交，优先进行客户端水合。
-  - 水合后，浏览器不会在表单提交时刷新。
-- 服务端操作不仅限于 `<form>`，可以从事件处理程序、`useEffect`、第三方库和其他表单元素（如 `<button>`）调用。
-- 服务端操作与 Next.js 的[缓存和重新验证](/docs/app/deep-dive/caching)架构集成。当操作被调用时，Next.js 可以在一次服务器往返中返回更新的 UI 和新数据。
-- 在底层，操作使用 `POST` 方法，只有这种 HTTP 方法可以调用它们。
-- 服务端操作的参数和返回值必须可被 React 序列化。有关可序列化参数和值的列表，请参阅 React 文档。
-- 服务端操作是函数，这意味着它们可以在应用程序的任何地方复用。
-- 服务端操作继承它们所在页面或布局的运行时。
-- 服务端操作继承它们所在页面或布局的[路由段配置](/docs/app/api-reference/file-conventions/route-segment-config)，包括 `maxDuration` 等字段。
+- 服务器操作可以通过 [`<form>` 元素](#forms) 的 `action` 属性调用：
+  - 服务端组件默认支持渐进增强，这意味着即使 JavaScript 尚未加载或已禁用，表单也会被提交。
+  - 在客户端组件中，调用服务器操作的表单会在 JavaScript 未加载时排队提交，优先进行客户端水合。
+  - 水合后，浏览器在表单提交时不会刷新。
+- 服务器操作不仅限于 `<form>`，还可以从事件处理程序、`useEffect`、第三方库和其他表单元素（如 `<button>`）调用。
+- 服务器操作与 Next.js 的[缓存和重新验证](/docs/app/deep-dive/caching)架构集成。当操作被调用时，Next.js 可以在一次服务器往返中返回更新的 UI 和新数据。
+- 在底层，操作使用 `POST` 方法，并且只有这种 HTTP 方法可以调用它们。
+- 服务器操作的参数和返回值必须可被 React 序列化。有关可序列化参数和值的列表，请参阅 React 文档。
+- 服务器操作是函数，这意味着它们可以在应用程序的任何地方复用。
+- 服务器操作继承它们所在页面或布局的运行时。
+- 服务器操作继承它们所在页面或布局的[路由段配置](/docs/app/api-reference/file-conventions/route-segment-config)，包括 `maxDuration` 等字段。
 
 ## 示例
 
 ### 表单
 
-React 扩展了 HTML [`<form>`](https://developer.mozilla.org/docs/Web/HTML/Element/form) 元素，允许使用 `action` 属性调用服务端操作。
+React 扩展了 HTML [`<form>`](https://developer.mozilla.org/docs/Web/HTML/Element/form) 元素，允许通过 `action` 属性调用服务器操作。
 
-在表单中调用时，操作会自动接收 [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData/FormData) 对象。你不需要使用 React 的 `useState` 来管理字段，而是可以使用原生的 [`FormData` 方法](https://developer.mozilla.org/en-US/docs/Web/API/FormData#instance_methods)提取数据：
+在表单中调用时，操作会自动接收 [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData/FormData) 对象。你不需要使用 React 的 `useState` 来管理字段，而是可以使用原生的 [`FormData` 方法](https://developer.mozilla.org/en-US/docs/Web/API/FormData#instance_methods) 提取数据：
 
 ```tsx filename="app/invoices/page.tsx" switcher
 export default function Page() {
@@ -175,12 +175,12 @@ export default function Page() {
 > **须知：**
 >
 > - 示例：[带有加载和错误状态的表单](https://github.com/vercel/next.js/tree/canary/examples/next-forms)
-> - 处理具有多个字段的表单时，可以考虑使用 JavaScript 的 [`Object.fromEntries()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries) 与 [`entries()`](https://developer.mozilla.org/en-US/docs/Web/API/FormData/entries) 方法。例如：`const rawFormData = Object.fromEntries(formData)`。需要注意的是，`formData` 将包含额外的 `$ACTION_` 属性。
-> - 参阅 [React `<form>` 文档](https://react.dev/reference/react-dom/components/form#handle-form-submission-with-a-server-action) 了解更多信息。
+> - 当处理具有多个字段的表单时，你可能需要考虑使用 JavaScript 的 [`Object.fromEntries()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries) 与 [`entries()`](https://developer.mozilla.org/en-US/docs/Web/API/FormData/entries) 方法。例如：`const rawFormData = Object.fromEntries(formData)`。需要注意的是，`formData` 将包含额外的 `$ACTION_` 属性。
+> - 查看 [React `<form>` 文档](https://react.dev/reference/react-dom/components/form#handle-form-submission-with-a-server-action) 了解更多信息。
 
 ### 传递额外参数
 
-可以使用 JavaScript 的 `bind` 方法向服务端操作传递额外参数。
+你可以使用 JavaScript 的 `bind` 方法向服务器操作传递额外参数。
 
 ```tsx filename="app/client-component.tsx" highlight={6} switcher
 'use client'
@@ -216,7 +216,7 @@ export function UserProfile({ userId }) {
 }
 ```
 
-服务端操作将接收 `userId` 参数以及表单数据：
+服务器操作将接收 `userId` 参数以及表单数据：
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -232,18 +232,18 @@ export async function updateUser(userId, formData) {}
 
 > **须知：**
 >
-> - 另一种方法是将参数作为表单中的隐藏输入字段传递（例如 `<input type="hidden" name="userId" value={userId} />`）。然而，该值将成为渲染 HTML 的一部分，并且不会被编码。
-> - `.bind` 在服务端和客户端组件中都有效。它还支持渐进增强。
+> - 另一种方法是将参数作为表单中的隐藏输入字段传递（例如 `<input type="hidden" name="userId" value={userId} />`）。然而，该值将成为渲染 HTML 的一部分且不会被编码。
+> - `.bind` 在服务端和客户端组件中均有效。它还支持渐进增强。
 
 ### 嵌套表单元素
 
-你也可以在 `<form>` 内的嵌套元素（如 `<button>`、`<input type="submit">` 和 `<input type="image">`）中调用服务端操作。这些元素接受 `formAction` 属性或[事件处理程序](#event-handlers)。
+你也可以在 `<form>` 内的嵌套元素（如 `<button>`、`<input type="submit">` 和 `<input type="image">`）中调用服务器操作。这些元素接受 `formAction` 属性或[事件处理程序](#event-handlers)。
 
-这在需要在表单中调用多个服务端操作时非常有用。例如，除了发布帖子外，还可以为保存帖子草稿创建一个特定的 `<button>` 元素。更多信息请参阅 [React `<form>` 文档](https://react.dev/reference/react-dom/components/form#handling-multiple-submission-types)。
+这在需要在表单中调用多个服务器操作时非常有用。例如，你可以为保存草稿和发布分别创建特定的 `<button>` 元素。更多信息请参阅 [React `<form>` 文档](https://react.dev/reference/react-dom/components/form#handling-multiple-submission-types)。
 
 ### 编程式表单提交
 
-可以使用 [`requestSubmit()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/requestSubmit) 方法以编程方式触发表单提交。例如，当用户使用 `⌘` + `Enter` 键盘快捷键提交表单时，可以监听 `onKeyDown` 事件：
+你可以使用 [`requestSubmit()`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/requestSubmit) 方法以编程方式触发表单提交。例如，当用户使用 `⌘` + `Enter` 键盘快捷键提交表单时，你可以监听 `onKeyDown` 事件：
 
 ```tsx filename="app/entry.tsx" switcher
 'use client'
@@ -289,13 +289,13 @@ export function Entry() {
 }
 ```
 
-这将触发最近的 `<form>` 祖先的提交，从而调用服务端操作。
+这将触发最近的 `<form>` 祖先的提交，从而调用服务器操作。
 
 ### 服务端表单验证
 
-可以使用 HTML 属性（如 `required` 和 `type="email"`）进行基本的客户端表单验证。
+你可以使用 `required` 和 `type="email"` 等 HTML 属性进行基本的客户端表单验证。
 
-对于更高级的服务端验证，可以使用 [zod](https://zod.dev/) 等库在变更数据之前验证表单字段：
+对于更高级的服务端验证，可以使用像 [zod](https://zod.dev/) 这样的库在变更数据前验证表单字段：
 
 ```tsx filename="app/actions.ts" switcher
 'use server'
@@ -304,7 +304,7 @@ import { z } from 'zod'
 
 const schema = z.object({
   email: z.string({
-    invalid_type_error: '无效的邮箱',
+    invalid_type_error: '无效的电子邮件',
   }),
 })
 
@@ -331,7 +331,7 @@ import { z } from 'zod'
 
 const schema = z.object({
   email: z.string({
-    invalid_type_error: '无效的邮箱',
+    invalid_type_error: '无效的电子邮件',
   }),
 })
 
@@ -351,9 +351,9 @@ export default async function createsUser(formData) {
 }
 ```
 
-在服务端验证字段后，可以在操作中返回一个可序列化的对象，并使用 React 的 `useActionState` 钩子向用户显示消息。
+一旦字段在服务端验证通过，你可以在操作中返回一个可序列化的对象，并使用 React 的 `useActionState` 钩子向用户显示消息。
 
-- 通过将操作传递给 `useActionState`，操作的函数签名会更改，接收一个新的 `prevState` 或 `initialState` 参数作为其第一个参数。
+- 通过将操作传递给 `useActionState`，操作的函数签名会发生变化，接收一个新的 `prevState` 或 `initialState` 参数作为其第一个参数。
 - `useActionState` 是一个 React 钩子，因此必须在客户端组件中使用。
 
 ```tsx filename="app/actions.ts" switcher
@@ -366,7 +366,7 @@ export async function createUser(prevState: any, formData: FormData) {
   const json = await res.json()
 
   if (!res.ok) {
-    return { message: '请输入有效的邮箱' }
+    return { message: '请输入有效的电子邮件' }
   }
 
   redirect('/dashboard')
@@ -383,14 +383,14 @@ export async function createUser(prevState, formData) {
   const json = await res.json()
 
   if (!res.ok) {
-    return { message: '请输入有效的邮箱' }
+    return { message: '请输入有效的电子邮件' }
   }
 
   redirect('/dashboard')
 }
 ```
 
-然后，可以将操作传递给 `useActionState` 钩子，并使用返回的 `state` 显示错误消息。
+然后，你可以将操作传递给 `useActionState` 钩子，并使用返回的 `state` 显示错误消息。
 
 ```tsx filename="app/ui/signup.tsx" highlight={11,18-20} switcher
 'use client'
@@ -407,7 +407,7 @@ export function Signup() {
 
   return (
     <form action={formAction}>
-      <label htmlFor="email">邮箱</label>
+      <label htmlFor="email">电子邮件</label>
       <input type="text" id="email" name="email" required />
       {/* ... */}
       <p aria-live="polite">{state?.message}</p>
@@ -432,7 +432,7 @@ export function Signup() {
 
   return (
     <form action={formAction}>
-      <label htmlFor="email">邮箱</label>
+      <label htmlFor="email">电子邮件</label>
       <input type="text" id="email" name="email" required />
       {/* ... */}
       <p aria-live="polite">{state?.message}</p>
@@ -442,11 +442,11 @@ export function Signup() {
 }
 ```
 
-### 等待状态
+### 待处理状态
 
 [`useActionState`](https://react.dev/reference/react/useActionState) 钩子暴露了一个 `pending` 布尔值，可用于在操作执行时显示加载指示器。
 
-或者，可以使用 [`useFormStatus`](https://react.dev/reference/react-dom/hooks/useFormStatus) 钩子在操作执行时显示加载指示器。使用此钩子时，需要创建一个单独的组件来渲染加载指示器。例如，在操作等待时禁用按钮：
+或者，你可以使用 [`useFormStatus`](https://react.dev/reference/react-dom/hooks/useFormStatus) 钩子在操作执行时显示加载指示器。使用此钩子时，你需要创建一个单独的组件来渲染加载指示器。例如，在操作待处理时禁用按钮：
 
 ```tsx filename="app/ui/button.tsx" highlight={6} switcher
 'use client'
@@ -480,7 +480,7 @@ export function SubmitButton() {
 }
 ```
 
-然后可以将 `SubmitButton` 组件嵌套在表单中：
+然后，你可以在表单中嵌套 `SubmitButton` 组件：
 
 ```tsx filename="app/ui/signup.tsx" switcher
 import { SubmitButton } from './button'
@@ -510,11 +510,11 @@ export function Signup() {
 }
 ```
 
-> **须知：** 在 React 19 中，`useFormStatus` 包含返回对象上的其他键，如 data、method 和 action。如果未使用 React 19，则只有 `pending` 键可用。
+> **须知：** 在 React 19 中，`useFormStatus` 包含返回对象上的其他键，如 data、method 和 action。如果你不使用 React 19，则只有 `pending` 键可用。
 
-### 乐观更新
+### 乐观更新 (Optimistic updates)
 
-您可以使用 React 的 [`useOptimistic`](https://react.dev/reference/react/useOptimistic) 钩子，在服务器操作完成执行前乐观地更新 UI，而无需等待响应：
+您可以使用 React 的 [`useOptimistic`](https://react.dev/reference/react/useOptimistic) Hook 在服务器操作 (Server Action) 执行完成前乐观地更新 UI，而无需等待响应：
 
 ```tsx filename="app/page.tsx" switcher
 'use client'
@@ -584,9 +584,9 @@ export function Thread({ messages }) {
 }
 ```
 
-### 事件处理程序
+### 事件处理程序 (Event handlers)
 
-虽然通常在 `<form>` 元素中使用服务器操作，但它们也可以通过事件处理程序（如 `onClick`）调用。例如，增加点赞数：
+虽然通常在 `<form>` 元素中使用服务器操作 (Server Actions)，但它们也可以通过事件处理程序如 `onClick` 来调用。例如，增加点赞数：
 
 ```tsx filename="app/like-button.tsx" switcher
 'use client'
@@ -660,11 +660,11 @@ export default function EditPost() {
 }
 ```
 
-对于这种情况，如果多个事件可能快速连续触发，我们建议使用**防抖**来避免不必要的服务器操作调用。
+对于这种情况，当可能快速连续触发多个事件时，我们建议使用**防抖 (debouncing)** 来避免不必要的服务器操作调用。
 
 ### `useEffect`
 
-您可以使用 React 的 [`useEffect`](https://react.dev/reference/react/useEffect) 钩子在组件挂载或依赖项变化时调用服务器操作。这对于依赖于全局事件或需要自动触发的变更非常有用。例如，`onKeyDown` 用于应用快捷键、交叉观察器钩子用于无限滚动，或在组件挂载时更新视图计数：
+您可以使用 React 的 [`useEffect`](https://react.dev/reference/react/useEffect) Hook 在组件挂载或依赖项变化时调用服务器操作。这对于依赖于全局事件或需要自动触发的变更非常有用。例如，`onKeyDown` 用于应用快捷键、交叉观察器 Hook 用于无限滚动，或在组件挂载时更新视图计数：
 
 ```tsx filename="app/view-count.tsx" switcher
 'use client'
@@ -712,15 +712,15 @@ export default function ViewCount({ initialViews }: { initialViews: number }) {
 
 请记住考虑 [`useEffect` 的行为和注意事项](https://react.dev/reference/react/useEffect#caveats)。
 
-### 错误处理
+### 错误处理 (Error Handling)
 
-当抛出错误时，它会被客户端最近的 `error.js` 或 `<Suspense>` 边界捕获。更多信息请参阅[错误处理](/docs/app/building-your-application/routing/error-handling)。
+当抛出错误时，它将被客户端最近的 `error.js` 或 `<Suspense>` 边界捕获。更多信息请参阅[错误处理](/docs/app/building-your-application/routing/error-handling)。
 
 > **须知：**
 >
-> - 除了抛出错误外，您还可以返回一个对象供 `useActionState` 处理。请参阅[服务器端验证和错误处理](#server-side-form-validation)。
+> - 除了抛出错误外，您还可以返回一个对象供 `useActionState` 处理。请参阅[服务端验证和错误处理](#server-side-form-validation)。
 
-### 重新验证数据
+### 重新验证数据 (Revalidating data)
 
 您可以在服务器操作中使用 [`revalidatePath`](/docs/app/api-reference/functions/revalidatePath) API 重新验证 [Next.js 缓存](/docs/app/deep-dive/caching)：
 
@@ -790,9 +790,9 @@ export async function createPost() {
 }
 ```
 
-### 重定向
+### 重定向 (Redirecting)
 
-如果您希望在服务器操作完成后将用户重定向到不同的路由，可以使用 [`redirect`](/docs/app/api-reference/functions/redirect) API。`redirect` 需要在 `try/catch` 块外部调用：
+如果您希望在服务器操作完成后将用户重定向到不同的路由，可以使用 [`redirect`](/docs/app/api-reference/functions/redirect) API。`redirect` 需要在 `try/catch` 块之外调用：
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -832,7 +832,7 @@ export async function createPost(id) {
 
 ### Cookies
 
-您可以使用 [`cookies`](/docs/app/api-reference/functions/cookies) API 在服务器操作中 `get`、`set` 和 `delete` cookies：
+您可以在服务器操作中使用 [`cookies`](/docs/app/api-reference/functions/cookies) API 来 `get`、`set` 和 `delete` cookies：
 
 ```ts filename="app/actions.ts" switcher
 'use server'
@@ -873,40 +873,40 @@ export async function exampleAction() {
 }
 ```
 
-更多示例请参阅[删除服务器操作中的 cookies](/docs/app/api-reference/functions/cookies#deleting-cookies)。
+查看[更多示例](/docs/app/api-reference/functions/cookies#deleting-cookies)了解如何从服务器操作中删除 cookies。
 
-## 安全性
+## 安全性 (Security)
 
 默认情况下，当创建并导出一个服务器操作时，它会创建一个公共 HTTP 端点，并应遵循相同的安全假设和授权检查。这意味着，即使服务器操作或实用函数未在代码的其他地方导入，它仍然是公开可访问的。
 
 为了提高安全性，Next.js 具有以下内置功能：
 
-- **安全的操作 ID**：Next.js 创建加密的、非确定性的 ID，允许客户端引用和调用服务器操作。这些 ID 在构建之间定期重新计算以增强安全性。
+- **安全的操作 ID**：Next.js 创建加密的、非确定性的 ID，以允许客户端引用和调用服务器操作。这些 ID 在构建之间定期重新计算以增强安全性。
 - **死代码消除**：未使用的服务器操作（通过其 ID 引用）会从客户端包中移除，以避免第三方公开访问。
 
 > **须知**：
 >
 > ID 在编译期间创建，并缓存最多 14 天。它们将在新构建启动或构建缓存失效时重新生成。
-> 这种安全改进在缺少身份验证层的情况下降低了风险。但是，您仍应将服务器操作视为公共 HTTP 端点。
+> 这一安全改进减少了在缺少身份验证层的情况下的风险。然而，您仍应将服务器操作视为公共 HTTP 端点。
 
 ```jsx
 // app/actions.js
 'use server'
 
-// 此操作**用于**我们的应用程序，因此 Next.js
+// 此操作**已**在我们的应用中使用，因此 Next.js
 // 将创建一个安全 ID 以允许客户端引用
 // 并调用服务器操作。
 export async function updateUserAction(formData) {}
 
-// 此操作**未用于**我们的应用程序，因此 Next.js
+// 此操作**未**在我们的应用中使用，因此 Next.js
 // 将在 `next build` 期间自动移除此代码
 // 并且不会创建公共端点。
 export async function deleteUserAction(formData) {}
 ```
 
-### 身份验证和授权
+### 身份验证和授权 (Authentication and authorization)
 
-您应确保用户有权执行操作。例如：
+您应确保用户有权执行该操作。例如：
 
 ```tsx filename="app/actions.ts"
 'use server'
@@ -923,7 +923,7 @@ export function addItem() {
 }
 ```
 
-### 闭包和加密
+### 闭包和加密 (Closures and encryption)
 
 在组件内定义服务器操作会创建一个[闭包](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Closures)，其中操作可以访问外部函数的作用域。例如，`publish` 操作可以访问 `publishVersion` 变量：
 
@@ -967,31 +967,31 @@ export default async function Page() {
 }
 ```
 
-闭包在需要捕获数据的**快照**（例如 `publishVersion`）以便在操作调用时使用非常有用。
+闭包在需要捕获数据的**快照**（例如 `publishVersion`）以便在操作调用时使用的情况下非常有用。
 
-然而，为了实现这一点，捕获的变量会发送到客户端并在操作调用时返回服务器。为了防止敏感数据暴露给客户端，Next.js 会自动加密闭包变量。每次构建 Next.js 应用程序时，都会为每个操作生成一个新的私钥。这意味着操作只能针对特定构建调用。
+然而，为了实现这一点，捕获的变量会被发送到客户端，并在操作调用时返回到服务器。为了防止敏感数据暴露给客户端，Next.js 会自动加密闭包变量。每次构建 Next.js 应用时，都会为每个操作生成一个新的私钥。这意味着操作只能针对特定的构建调用。
 
-> **须知**：我们不建议仅依赖加密来防止敏感值暴露在客户端。相反，您应使用 [React taint APIs](/docs/app/building-your-application/data-fetching/fetching#preventing-sensitive-data-from-being-exposed-to-the-client) 主动阻止特定数据发送到客户端。
+> **须知**：我们不建议仅依赖加密来防止敏感值暴露在客户端。相反，您应使用 [React taint APIs](/docs/app/api-reference/config/next-config-js/taint) 主动防止特定数据发送到客户端。
 
-### 覆盖加密密钥（高级）
+### 覆盖加密密钥（高级）(Overwriting encryption keys (advanced))
 
-当自托管 Next.js 应用程序到多个服务器时，每个服务器实例可能最终使用不同的加密密钥，从而导致潜在的不一致。
+当自托管 Next.js 应用跨多个服务器时，每个服务器实例可能最终使用不同的加密密钥，导致潜在的不一致。
 
 为了缓解这种情况，您可以使用 `process.env.NEXT_SERVER_ACTIONS_ENCRYPTION_KEY` 环境变量覆盖加密密钥。指定此变量可确保您的加密密钥在构建之间保持一致，并且所有服务器实例使用相同的密钥。此变量**必须**是 AES-GCM 加密的。
 
-这是一个高级用例，其中跨多个部署的一致加密行为对您的应用程序至关重要。您应考虑标准的安全实践，例如密钥轮换和签名。
+这是一个高级用例，其中跨多个部署的一致加密行为对您的应用至关重要。您应考虑标准的安全实践，如密钥轮换和签名。
 
-> **须知**：部署到 Vercel 的 Next.js 应用程序会自动处理此问题。
+> **须知**：部署到 Vercel 的 Next.js 应用会自动处理此问题。
 
-### 允许的来源（高级）
+### 允许的来源（高级）(Allowed origins (advanced))
 
-由于服务器操作可以在 `<form>` 元素中调用，因此它们容易受到 [CSRF 攻击](https://developer.mozilla.org/en-US/docs/Glossary/CSRF)。
+由于服务器操作可以在 `<form>` 元素中调用，这使得它们容易受到 [CSRF 攻击](https://developer.mozilla.org/en-US/docs/Glossary/CSRF)。
 
-在幕后，服务器操作使用 `POST` 方法，并且仅允许此 HTTP 方法调用它们。这可以防止现代浏览器中的大多数 CSRF 漏洞，特别是默认情况下使用 [SameSite cookies](https://web.dev/articles/samesite-cookies-explained)。
+在幕后，服务器操作使用 `POST` 方法，并且只允许此 HTTP 方法调用它们。这可以防止现代浏览器中的大多数 CSRF 漏洞，特别是默认情况下使用 [SameSite cookies](https://web.dev/articles/samesite-cookies-explained)。
 
-作为额外的保护，Next.js 中的服务器操作还会比较 [Origin 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Origin) 和 [Host 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Host)（或 `X-Forwarded-Host`）。如果这些不匹配，请求将被中止。换句话说，服务器操作只能在托管它的页面所在的同一主机上调用。
+作为额外的保护措施，Next.js 中的服务器操作还会比较 [Origin 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Origin) 和 [Host 标头](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Host)（或 `X-Forwarded-Host`）。如果它们不匹配，请求将被中止。换句话说，服务器操作只能在托管它的页面所在的同一主机上调用。
 
-对于使用反向代理或多层后端架构（其中服务器 API 与生产域不同）的大型应用程序，建议使用配置选项 [`serverActions.allowedOrigins`](/docs/app/api-reference/config/next-config-js/serverActions) 指定安全来源列表。该选项接受字符串数组。
+对于使用反向代理或多层后端架构（其中服务器 API 与生产域不同）的大型应用，建议使用配置选项 [`serverActions.allowedOrigins`](/docs/app/api-reference/config/next-config-js/serverActions) 来指定安全来源列表。该选项接受一个字符串数组。
 
 ```js filename="next.config.js"
 /** @type {import('next').NextConfig} */
@@ -1006,7 +1006,7 @@ module.exports = {
 
 了解更多关于 [安全性和服务器操作](https://nextjs.org/blog/security-nextjs-server-components-actions)。
 
-## 其他资源
+## 其他资源 (Additional resources)
 
 更多信息，请查看以下 React 文档：
 
diff --git a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/03-file-conventions/error.mdx b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/03-file-conventions/error.mdx
index 8634da64..9d322ea1 100644
--- a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/03-file-conventions/error.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/03-file-conventions/error.mdx
@@ -1,15 +1,15 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:28:11.605Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:19:45.363Z
 title: error.js
 description: 关于 error.js 特殊文件的 API 参考文档。
 related:
   title: 了解更多错误处理相关内容
   links:
-    - app/building-your-your-application/routing/error-handling
+    - app/building-your-application/routing/error-handling
 ---
 
-**error** 文件允许您处理意外的运行时错误并显示回退 UI。
+**error** 文件允许您处理意外的运行时错误并显示备用 UI。
 
 <Image
   alt="error.js 特殊文件"
@@ -41,7 +41,7 @@ export default function Error({
       <h2>Something went wrong!</h2>
       <button
         onClick={
-          // 尝试通过重新渲染该分段来恢复
+          // 尝试通过重新渲染该片段来恢复
           () => reset()
         }
       >
@@ -68,7 +68,7 @@ export default function Error({ error, reset }) {
       <h2>Something went wrong!</h2>
       <button
         onClick={
-          // 尝试通过重新渲染该分段来恢复
+          // 尝试通过重新渲染该片段来恢复
           () => reset()
         }
       >
@@ -79,7 +79,7 @@ export default function Error({ error, reset }) {
 }
 ```
 
-`error.js` 将路由分段及其嵌套子节点包裹在一个 [React 错误边界](https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary)中。当边界内抛出错误时，`error` 组件会作为回退 UI 显示。
+`error.js` 将路由片段及其嵌套子项包裹在 [React 错误边界](https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary)中。当边界内抛出错误时，`error` 组件会显示为备用 UI。
 
 <Image
   alt="error.js 工作原理"
@@ -91,23 +91,23 @@ export default function Error({ error, reset }) {
 
 > **须知**:
 >
-> - 使用 [React DevTools](https://react.dev/learn/react-developer-tools) 可以切换错误边界来测试错误状态。
-> - 如果希望错误冒泡到父级错误边界，可以在渲染 `error` 组件时使用 `throw`。
+> - [React 开发者工具](https://react.dev/learn/react-developer-tools)允许您切换错误边界来测试错误状态
+> - 如果您希望错误冒泡到父级错误边界，可以在渲染 `error` 组件时使用 `throw`
 
 ## 参考
 
-### Props
+### 属性
 
 #### `error`
 
 传递给 `error.js` 客户端组件的 [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error) 对象实例。
 
-> **须知:** 在开发环境中，传递给客户端的 `Error` 对象会被序列化，并包含原始错误的 `message` 以便调试。但在生产环境中，**此行为会有所不同**，以避免将错误中可能包含的敏感信息泄露给客户端。
+> **须知:** 在开发环境下，转发给客户端的 `Error` 对象会被序列化并包含原始错误的 `message` 以便调试。但在生产环境中，**此行为会有所不同**，以避免将错误中可能包含的敏感信息泄露给客户端。
 
 #### `error.message`
 
-- 从客户端组件转发的错误会显示原始 `Error` 消息。
-- 从服务端组件转发的错误会显示带有标识符的通用消息。这是为了防止泄露敏感信息。您可以使用 `errors.digest` 下的标识符来匹配对应的服务端日志。
+- 从客户端组件转发的错误会显示原始 `Error` 消息
+- 从服务端组件转发的错误会显示带有标识符的通用消息。这是为了防止泄露敏感信息。您可以使用 `errors.digest` 下的标识符来匹配对应的服务端日志
 
 #### `error.digest`
 
@@ -115,9 +115,9 @@ export default function Error({ error, reset }) {
 
 #### `reset`
 
-有时错误的起因可能是暂时的。在这些情况下，重试可能会解决问题。
+有时错误的起因是暂时的。在这些情况下，重试可能会解决问题。
 
-错误组件可以使用 `reset()` 函数提示用户尝试从错误中恢复。执行该函数时，会尝试重新渲染错误边界的内容。如果成功，回退的错误组件将被重新渲染的结果替换。
+错误组件可以使用 `reset()` 函数提示用户尝试从错误中恢复。执行时，该函数会尝试重新渲染错误边界的内容。如果成功，备用错误组件将被重新渲染的结果替换。
 
 ```tsx filename="app/dashboard/error.tsx" switcher
 'use client' // 错误边界必须是客户端组件
@@ -155,7 +155,7 @@ export default function Error({ error, reset }) {
 
 ### 全局错误
 
-虽然不太常见，但您可以使用位于根应用目录中的 `global-error.js` 来处理根布局或模板中的错误，即使在使用[国际化](/docs/app/building-your-application/routing/internationalization)时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签。此文件在激活时会替换根布局或模板。
+虽然不常见，但您可以使用根应用目录中的 `global-error.js` 来处理根布局或模板中的错误，即使在使用[国际化](/docs/app/guides/internationalization)时也是如此。全局错误 UI 必须定义自己的 `<html>` 和 `<body>` 标签。该文件在激活时会替换根布局或模板。
 
 ```tsx filename="app/global-error.tsx" switcher
 'use client' // 错误边界必须是客户端组件
@@ -195,11 +195,11 @@ export default function GlobalError({ error, reset }) {
 }
 ```
 
-### 使用自定义错误边界优雅恢复错误
+### 使用自定义错误边界优雅地恢复错误
 
 当客户端渲染失败时，显示最后已知的服务端渲染 UI 可以提供更好的用户体验。
 
-`GracefullyDegradingErrorBoundary` 是一个自定义错误边界的示例，它捕获并保留错误发生前的当前 HTML。如果发生渲染错误，它会重新渲染捕获的 HTML 并显示一个持久通知栏来通知用户。
+`GracefullyDegradingErrorBoundary` 是一个自定义错误边界的示例，它会在错误发生前捕获并保留当前 HTML。如果发生渲染错误，它会重新渲染捕获的 HTML 并显示一个持久通知栏来通知用户。
 
 ```tsx filename="app/dashboard/error.tsx" switcher
 'use client'
@@ -318,7 +318,7 @@ export default GracefullyDegradingErrorBoundary
 ## 版本历史
 
 | 版本       | 变更                                      |
-| ---------- | ---------------------------------------- |
-| `v15.2.0` | 在开发环境中也显示 `global-error`。      |
-| `v13.1.0` | 引入 `global-error`。                    |
-| `v13.0.0` | 引入 `error`。                           |
\ No newline at end of file
+| ---------- | ----------------------------------------- |
+| `v15.2.0` | 在开发环境中也显示 `global-error`         |
+| `v13.1.0` | 引入 `global-error`                       |
+| `v13.0.0` | 引入 `error`                              |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/generate-metadata.mdx b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/generate-metadata.mdx
index 8eb92e6c..63aca44b 100644
--- a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/generate-metadata.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/generate-metadata.mdx
@@ -1,8 +1,8 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:31:07.995Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:25:22.716Z
 title: generateMetadata
-description: 了解如何为 Next.js 应用添加元数据 (Metadata) 以提升搜索引擎优化 (SEO) 和网页可分享性。
+description: 了解如何为 Next.js 应用添加元数据 (Metadata) 以提升搜索引擎优化 (SEO) 和网页分享效果。
 related:
   title: 后续步骤
   description: 查看所有元数据 API 选项。
@@ -37,11 +37,11 @@ export const metadata = {
 export default function Page() {}
 ```
 
-> 完整支持的选项列表请参阅 [元数据字段](#metadata-fields)。
+> 查看 [元数据字段](#metadata-fields) 获取完整支持的选项列表。
 
 ## `generateMetadata` 函数
 
-动态元数据依赖于**动态信息**，例如当前路由参数、外部数据或父段中的 `metadata`，可以通过导出一个返回 [`Metadata` 对象](#metadata-fields) 的 `generateMetadata` 函数来设置。
+动态元数据依赖于**动态信息**，例如当前路由参数、外部数据或父级段中的 `metadata`，可以通过导出一个返回 [`Metadata` 对象](#metadata-fields) 的 `generateMetadata` 函数来设置。
 
 ```tsx filename="app/products/[id]/page.tsx" switcher
 import type { Metadata, ResolvingMetadata } from 'next'
@@ -61,7 +61,7 @@ export async function generateMetadata(
   // 获取数据
   const product = await fetch(`https://.../${id}`).then((res) => res.json())
 
-  // 可选地访问并扩展（而非替换）父元数据
+  // 可选地访问并扩展（而非替换）父级元数据
   const previousImages = (await parent).openGraph?.images || []
 
   return {
@@ -83,7 +83,7 @@ export async function generateMetadata({ params, searchParams }, parent) {
   // 获取数据
   const product = await fetch(`https://.../${id}`).then((res) => res.json())
 
-  // 可选地访问并扩展（而非替换）父元数据
+  // 可选地访问并扩展（而非替换）父级元数据
   const previousImages = (await parent).openGraph?.images || []
 
   return {
@@ -101,11 +101,11 @@ export default function Page({ params, searchParams }) {}
 >
 > - 元数据可以添加到 `layout.js` 和 `page.js` 文件中。
 > - Next.js 会自动解析元数据，并为页面创建相关的 `<head>` 标签。
-> - `metadata` 对象和 `generateMetadata` 函数导出**仅支持在服务器组件中使用**。
+> - `metadata` 对象和 `generateMetadata` 函数导出**仅支持在服务端组件中使用**。
 > - 不能从同一路由段同时导出 `metadata` 对象和 `generateMetadata` 函数。
-> - `generateMetadata` 中的 `fetch` 请求会自动[记忆化](/docs/app/deep-dive/caching#request-memoization)，以便在 `generateMetadata`、`generateStaticParams`、布局、页面和服务器组件之间共享相同的数据。
-> - 如果 `fetch` 不可用，可以使用 React 的 [`cache` 函数](/docs/app/deep-dive/caching#react-cache-function)。
-> - [基于文件的元数据](/docs/app/api-reference/file-conventions/metadata)具有更高的优先级，会覆盖 `metadata` 对象和 `generateMetadata` 函数。
+> - `generateMetadata` 中的 `fetch` 请求会自动[记忆化](/docs/app/deep-dive/caching#request-memoization)，以便在 `generateMetadata`、`generateStaticParams`、布局、页面和服务端组件之间共享相同的数据。
+> - 如果无法使用 `fetch`，可以使用 React 的 [`cache` 函数](/docs/app/deep-dive/caching#react-cache-function)。
+> - [基于文件的元数据](/docs/app/api-reference/file-conventions/metadata) 优先级更高，会覆盖 `metadata` 对象和 `generateMetadata` 函数。
 
 ## 参考
 
@@ -114,7 +114,7 @@ export default function Page({ params, searchParams }) {}
 `generateMetadata` 函数接受以下参数：
 
 - `props` - 包含当前路由参数的对象：
-  - `params` - 包含从根段到调用 `generateMetadata` 的段的[动态路由参数](/docs/app/building-your-application/routing/dynamic-routes)对象。例如：
+  - `params` - 包含从根段到调用 `generateMetadata` 的段的[动态路由参数](/docs/app/building-your-application/routing/dynamic-routes) 对象。例如：
 
     | 路由                           | URL         | `params`                  |
     | ------------------------------- | ----------- | ------------------------- |
@@ -122,7 +122,7 @@ export default function Page({ params, searchParams }) {}
     | `app/shop/[tag]/[item]/page.js` | `/shop/1/2` | `{ tag: '1', item: '2' }` |
     | `app/shop/[...slug]/page.js`    | `/shop/1/2` | `{ slug: ['1', '2'] }`    |
 
-  - `searchParams` - 包含当前 URL 的[查询参数](https://developer.mozilla.org/docs/Learn/Common_questions/What_is_a_URL#parameters)的对象。例如：
+  - `searchParams` - 包含当前 URL 的[查询参数](https://developer.mozilla.org/docs/Learn/Common_questions/What_is_a_URL#parameters) 的对象。例如：
 
     | URL             | `searchParams`       |
     | --------------- | -------------------- |
@@ -130,16 +130,16 @@ export default function Page({ params, searchParams }) {}
     | `/shop?a=1&b=2` | `{ a: '1', b: '2' }` |
     | `/shop?a=1&a=2` | `{ a: ['1', '2'] }`  |
 
-- `parent` - 父路由段解析后的元数据的 Promise。
+- `parent` - 父级路由段解析后的元数据的 Promise。
 
 ### 返回值
 
-`generateMetadata` 应返回一个包含一个或多个元数据字段的 [`Metadata` 对象](#metadata-fields)。
+`generateMetadata` 应返回一个包含一个或多个元数字段的 [`Metadata` 对象](#metadata-fields)。
 
 > **须知**:
 >
-> - 如果元数据不依赖于运行时信息，应使用静态的 [`metadata` 对象](#the-metadata-object)而非 `generateMetadata` 来定义。
-> - `fetch` 请求会自动[记忆化](/docs/app/deep-dive/caching#request-memoization)，以便在 `generateMetadata`、`generateStaticParams`、布局、页面和服务器组件之间共享相同的数据。如果 `fetch` 不可用，可以使用 React 的 [`cache` 函数](/docs/app/deep-dive/caching#react-cache-function)。
+> - 如果元数据不依赖于运行时信息，应使用静态的 [`metadata` 对象](#the-metadata-object) 而非 `generateMetadata` 来定义。
+> - `fetch` 请求会自动[记忆化](/docs/app/deep-dive/caching#request-memoization)，以便在 `generateMetadata`、`generateStaticParams`、布局、页面和服务端组件之间共享相同的数据。如果无法使用 `fetch`，可以使用 React 的 [`cache` 函数](/docs/app/deep-dive/caching#react-cache-function)。
 > - `searchParams` 仅在 `page.js` 段中可用。
 > - Next.js 的 [`redirect()`](/docs/app/api-reference/functions/redirect) 和 [`notFound()`](/docs/app/api-reference/functions/not-found) 方法也可以在 `generateMetadata` 中使用。
 
@@ -149,7 +149,7 @@ export default function Page({ params, searchParams }) {}
 
 #### `title`
 
-`title` 属性用于设置文档的标题。可以定义为简单的[字符串](#string)或可选的[模板对象](#template)。
+`title` 属性用于设置文档的标题。可以定义为简单的[字符串](#string) 或可选的[模板对象](#template)。
 
 ##### 字符串
 
@@ -229,17 +229,17 @@ export const metadata = {
 
 > **须知**:
 >
-> - `title.template` 适用于**子**路由段，而非定义它的段。这意味着：
+> - `title.template` 应用于**子**路由段，而非定义它的段。这意味着：
 >
 >   - 添加 `title.template` 时，`title.default` 是**必需的**。
 >   - `layout.js` 中定义的 `title.template` 不会应用于同一路由段的 `page.js` 中定义的 `title`。
->   - `page.js` 中定义的 `title.template` 无效，因为页面始终是终止段（没有子路由段）。
+>   - `page.js` 中定义的 `title.template` 无效，因为页面始终是路由的终止段（它没有任何子路由段）。
 >
 > - 如果路由未定义 `title` 或 `title.default`，`title.template` **无效**。
 
 ##### `absolute`
 
-`title.absolute` 可用于提供**忽略**父段中设置的 `title.template` 的标题。
+`title.absolute` 可用于提供**忽略**父级段中设置的 `title.template` 的标题。
 
 ```tsx filename="app/layout.tsx" switcher
 import type { Metadata } from 'next'
@@ -285,14 +285,14 @@ export const metadata = {
 >
 > - `layout.js`
 >
->   - `title` (字符串) 和 `title.default` 为未定义自身 `title` 的子段定义默认标题。如果存在，它将增强最近父段的 `title.template`。
->   - `title.absolute` 为子段定义默认标题。它会忽略父段的 `title.template`。
+>   - `title` (字符串) 和 `title.default` 为未定义自身 `title` 的子段定义默认标题。如果存在，它将扩展最近父级段的 `title.template`。
+>   - `title.absolute` 为子段定义默认标题。它忽略父级段的 `title.template`。
 >   - `title.template` 为子段定义新的标题模板。
 >
 > - `page.js`
->   - 如果页面未定义自己的标题，将使用最近父段解析后的标题。
->   - `title` (字符串) 定义路由的标题。如果存在，它将增强最近父段的 `title.template`。
->   - `title.absolute` 定义路由标题。它会忽略父段的 `title.template`。
+>   - 如果页面未定义自己的标题，将使用最近父级解析后的标题。
+>   - `title` (字符串) 定义路由的标题。如果存在，它将扩展最近父级段的 `title.template`。
+>   - `title.absolute` 定义路由的标题。它忽略父级段的 `title.template`。
 >   - `title.template` 在 `page.js` 中无效，因为页面始终是路由的终止段。
 
 ### `description`
@@ -342,10 +342,10 @@ export const metadata = {
 
 #### `metadataBase`
 
-`metadataBase` 是一个便捷选项，用于为需要完全限定 URL 的 `metadata` 字段设置基础 URL 前缀。
+`metadataBase` 是一个便捷选项，用于为需要完整 URL 的元数字段设置基础 URL 前缀。
 
-- `metadataBase` 允许**当前路由段及以下**定义的基于 URL 的 `metadata` 字段使用**相对路径**，而非必需的绝对 URL。
-- 字段的相对路径将与 `metadataBase` 组合形成完全限定的 URL。
+- `metadataBase` 允许**当前路由段及以下**的基于 URL 的元数字段使用**相对路径**，而非必须的绝对 URL。
+- 字段的相对路径将与 `metadataBase` 组合形成完整的 URL。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -372,19 +372,19 @@ export const metadata = {
 
 > **须知**:
 >
-> - `metadataBase` 通常设置在根 `app/layout.js` 中，以应用于所有路由中基于 URL 的 `metadata` 字段。
-> - 所有需要绝对 URL 的基于 URL 的 `metadata` 字段都可以通过 `metadataBase` 选项配置。
+> - `metadataBase` 通常设置在根 `app/layout.js` 中，以应用于所有路由的基于 URL 的元数字段。
+> - 所有需要绝对 URL 的基于 URL 的元数字段都可以通过 `metadataBase` 选项配置。
 > - `metadataBase` 可以包含子域名（例如 `https://app.acme.com`）或基础路径（例如 `https://acme.com/start/from/here`）。
-> - 如果 `metadata` 字段提供了绝对 URL，`metadataBase` 将被忽略。
-> - 在未配置 `metadataBase` 的情况下在基于 URL 的 `metadata` 字段中使用相对路径会导致构建错误。
-> - Next.js 会规范化 `metadataBase`（例如 `https://acme.com/`）和相对字段（例如 `/path`）之间的重复斜杠为单个斜杠（例如 `https://acme.com/path`）。
+> - 如果元数字段提供了绝对 URL，`metadataBase` 将被忽略。
+> - 在未配置 `metadataBase` 的情况下在基于 URL 的元数字段中使用相对路径会导致构建错误。
+> - Next.js 会规范化 `metadataBase`（例如 `https://acme.com/`）和相对字段（例如 `/path`）之间的重复斜杠为单斜杠（例如 `https://acme.com/path`）。
 
 #### URL 组合
 
 URL 组合优先考虑开发者的意图而非默认的目录遍历语义。
 
-- `metadataBase` 和 `metadata` 字段之间的尾部斜杠会被规范化。
-- `metadata` 字段中的“绝对”路径（通常替换整个 URL 路径）被视为“相对”路径（从 `metadataBase` 的末尾开始）。
+- `metadataBase` 和元数字段之间的尾部斜杠会被规范化。
+- 元数字段中的 "绝对" 路径（通常替换整个 URL 路径）被视为 "相对" 路径（从 `metadataBase` 的末尾开始）。
 
 例如，给定以下 `metadataBase`：
 
@@ -402,16 +402,16 @@ export const metadata = {
 }
 ```
 
-任何继承上述 `metadataBase` 并设置自身值的 `metadata` 字段将按以下方式解析：
+继承上述 `metadataBase` 并设置自身值的任何元数字段将按以下方式解析：
 
-| `metadata` 字段                 | 解析后的 URL                     |
-| -------------------------------- | -------------------------------- |
-| `/`                              | `https://acme.com`               |
-| `./`                             | `https://acme.com`               |
-| `payments`                       | `https://acme.com/payments`      |
-| `/payments`                      | `https://acme.com/payments`      |
-| `./payments`                     | `https://acme.com/payments`      |
-| `../payments`                    | `https://acme.com/payments`      |
+| 元数字段                 | 解析后的 URL                     |
+| ------------------------ | -------------------------------- |
+| `/`                      | `https://acme.com`               |
+| `./`                     | `https://acme.com`               |
+| `payments`               | `https://acme.com/payments`      |
+| `/payments`              | `https://acme.com/payments`      |
+| `./payments`             | `https://acme.com/payments`      |
+| `../payments`            | `https://acme.com/payments`      |
 | `https://beta.acme.com/payments` | `https://beta.acme.com/payments` |
 
 ### `openGraph`
@@ -433,7 +433,7 @@ export const metadata = {
         url: 'https://nextjs.org/og-alt.png', // 必须是绝对 URL
         width: 1800,
         height: 1600,
-        alt: '我的自定义替代文本',
+        alt: '自定义替代文本',
       },
     ],
     videos: [
@@ -466,7 +466,7 @@ export const metadata = {
 <meta property="og:image" content="https://nextjs.org/og-alt.png" />
 <meta property="og:image:width" content="1800" />
 <meta property="og:image:height" content="1600" />
-<meta property="og:image:alt" content="我的自定义替代文本" />
+<meta property="og:image:alt" content="自定义替代文本" />
 <meta property="og:video" content="https://nextjs.org/video.mp4" />
 <meta property="og:video:width" content="800" />
 <meta property="og:video:height" content="600" />
@@ -497,7 +497,7 @@ export const metadata = {
 
 > **须知**:
 >
-> - 对于 Open Graph 图片，使用 [基于文件的元数据 API](/docs/app/api-reference/file-conventions/metadata/opengraph-image#image-files-jpg-png-gif) 可能更方便。相比手动同步配置文件与实际文件，基于文件的 API 会自动为你生成正确的元数据。
+> - 对于 Open Graph 图片，使用 [基于文件的元数据 API](/docs/app/api-reference/file-conventions/metadata/opengraph-image#image-files-jpg-png-gif) 可能更为便捷。相比手动同步配置导出与实际文件，基于文件的 API 会自动为您生成正确的元数据。
 
 ### `robots`
 
@@ -531,7 +531,7 @@ export const metadata: Metadata = {
 
 ### `icons`
 
-> **须知**：我们建议尽可能使用 [基于文件的元数据 API](/docs/app/api-reference/file-conventions/metadata/app-icons#image-files-ico-jpg-png) 来管理图标。相比手动同步配置文件与实际文件，基于文件的 API 会自动为你生成正确的元数据。
+> **须知**：我们建议尽可能使用 [基于文件的元数据 API](/docs/app/api-reference/file-conventions/metadata/app-icons#image-files-ico-jpg-png) 来处理图标。相比手动同步配置导出与实际文件，基于文件的 API 会自动为您生成正确的元数据。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -598,7 +598,7 @@ export const metadata = {
 />
 ```
 
-> **须知**：Chromium 版本的 Microsoft Edge 不再支持 `msapplication-*` 元标签，因此不再需要这些标签。
+> **须知**：`msapplication-*` 元标签在 Chromium 版本的 Microsoft Edge 中不再支持，因此不再需要。
 
 ### `themeColor`
 
@@ -889,9 +889,9 @@ export const metadata = {
 
 ### `facebook`
 
-你可以将 Facebook 应用或 Facebook 账号与你的网页连接，用于某些 Facebook 社交插件 [Facebook 文档](https://developers.facebook.com/docs/plugins/comments/#moderation-setup-instructions)
+您可以将 Facebook 应用或 Facebook 账户连接到您的网页，以使用某些 Facebook 社交插件 [Facebook 文档](https://developers.facebook.com/docs/plugins/comments/#moderation-setup-instructions)
 
-> **须知**：你可以指定 appId 或 admins，但不能同时指定两者。
+> **须知**：您可以指定 appId 或 admins，但不能同时指定两者。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -917,7 +917,7 @@ export const metadata = {
 <meta property="fb:admins" content="12345678" />
 ```
 
-如果你想生成多个 fb:admins 元标签，可以使用数组值。
+如果要生成多个 fb:admins 元标签，可以使用数组值。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -934,7 +934,7 @@ export const metadata = {
 
 ### `pinterest`
 
-你可以在网页上启用或禁用 [Pinterest Rich Pins](https://developers.pinterest.com/docs/web-features/rich-pins-overview/)。
+您可以在网页上启用或禁用 [Pinterest Rich Pins](https://developers.pinterest.com/docs/web-features/rich-pins-overview/)。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -950,7 +950,7 @@ export const metadata = {
 
 ### `other`
 
-所有元数据选项都应通过内置支持来覆盖。然而，可能存在特定于你的站点的自定义元数据标签，或刚刚发布的全新元数据标签。你可以使用 `other` 选项来渲染任何自定义元数据标签。
+所有元数据选项都应通过内置支持覆盖。然而，可能存在特定于您网站的自定义元数据标签，或刚刚发布的全新元数据标签。您可以使用 `other` 选项来渲染任何自定义元数据标签。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -964,7 +964,7 @@ export const metadata = {
 <meta name="custom" content="meta" />
 ```
 
-如果你想生成多个相同键的元标签，可以使用数组值。
+如果要生成多个相同键的元标签，可以使用数组值。
 
 ```jsx filename="layout.js | page.js"
 export const metadata = {
@@ -980,11 +980,11 @@ export const metadata = {
 
 ### 不支持的元数据
 
-以下元数据类型目前没有内置支持。不过，它们仍然可以在布局或页面本身中渲染。
+以下元数据类型目前没有内置支持。但是，它们仍然可以在布局或页面本身中渲染。
 
 ### 类型
 
-您可以通过使用 `Metadata` 类型为元数据添加类型安全。如果您的 IDE 中使用了 [内置 TypeScript 插件](/docs/app/api-reference/config/typescript)，则无需手动添加类型，但您仍可以显式添加。
+您可以通过使用 `Metadata` 类型为元数据添加类型安全。如果您的 IDE 中使用了[内置的 TypeScript 插件](/docs/app/api-reference/config/typescript)，则无需手动添加类型，但您仍然可以显式添加它。
 
 #### `metadata` 对象
 
@@ -998,7 +998,7 @@ export const metadata: Metadata = {
 
 #### `generateMetadata` 函数
 
-##### 普通函数
+##### 常规函数
 
 ```tsx filename="layout.tsx | page.tsx"
 import type { Metadata } from 'next'
@@ -1022,7 +1022,7 @@ export async function generateMetadata(): Promise<Metadata> {
 }
 ```
 
-##### 带片段属性
+##### 带分段属性
 
 ```tsx filename="layout.tsx | page.tsx"
 import type { Metadata } from 'next'
@@ -1067,11 +1067,11 @@ export const metadata = {
 }
 ```
 
-| 元数据                      | 推荐方式                                                                                                                                                                                                                                            |
+| 元数据                      | 建议                                                                                                                                                                                                                                            |
 | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `<meta http-equiv="...">`     | 通过 [`redirect()`](/docs/app/api-reference/functions/redirect)、[中间件](/docs/app/building-your-application/routing/middleware#nextresponse) 或 [安全头](/docs/app/api-reference/config/next-config-js/headers) 设置适当的 HTTP 头 |
-| `<base>`                      | 在布局或页面中直接渲染该标签。                                                                                                                                                                                                              |
-| `<noscript>`                  | 在布局或页面中直接渲染该标签。                                                                                                                                                                                                              |
+| `<meta http-equiv="...">`     | 通过 [`redirect()`](/docs/app/api-reference/functions/redirect)、[中间件](/docs/app/building-your-application/routing/middleware#nextresponse) 或 [安全头](/docs/app/api-reference/config/next-config-js/headers) 使用适当的 HTTP 头 |
+| `<base>`                      | 在布局或页面本身渲染该标签。                                                                                                                                                                                                              |
+| `<noscript>`                  | 在布局或页面本身渲染该标签。                                                                                                                                                                                                              |
 | `<style>`                     | 了解更多关于 [Next.js 中的样式](/docs/app/getting-started/css)。                                                                                                                                                                                     |
 | `<script>`                    | 了解更多关于 [使用脚本](/docs/app/guides/scripts)。                                                                                                                                                                                               |
 | `<link rel="stylesheet" />`   | 直接在布局或页面中 `import` 样式表。                                                                                                                                                                                               |
@@ -1081,7 +1081,7 @@ export const metadata = {
 
 ### 资源提示
 
-`<link>` 元素有一系列 `rel` 关键字，可用于向浏览器提示可能需要的外部资源。浏览器根据这些关键字应用预加载优化。
+`<link>` 元素有许多 `rel` 关键字，可用于向浏览器提示可能需要外部资源。浏览器根据这些关键字应用预加载优化。
 
 虽然元数据 API 不直接支持这些提示，但您可以使用新的 [`ReactDOM` 方法](https://github.com/facebook/react/pull/26237) 安全地将它们插入文档的 `<head>` 中。
 
@@ -1115,7 +1115,7 @@ export function PreloadResources() {
 
 #### `<link rel="preload">`
 
-在页面渲染 (浏览器) 生命周期的早期开始加载资源。[MDN 文档](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/preload)。
+在页面渲染（浏览器）生命周期的早期开始加载资源。[MDN 文档](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/preload)。
 
 ```tsx
 ReactDOM.preload(href: string, options: { as: string })
@@ -1151,7 +1151,7 @@ ReactDOM.prefetchDNS(href: string)
 
 > **须知**:
 >
-> - 这些方法目前仅在客户端组件中受支持，这些组件在初始页面加载时仍会进行服务端渲染。
+> - 这些方法目前仅在客户端组件中受支持，这些组件在初始页面加载时仍由服务端渲染。
 > - Next.js 内置功能如 `next/font`、`next/image` 和 `next/script` 会自动处理相关资源提示。
 
 ## 行为
@@ -1174,17 +1174,17 @@ ReactDOM.prefetchDNS(href: string)
 
 `generateMetadata` 返回的元数据会流式传输到客户端。这使得 Next.js 可以在元数据解析后立即将其注入 HTML。
 
-由于页面元数据主要针对机器人和爬虫，Next.js 会为能执行 JavaScript 并检查完整页面 DOM 的机器人（如 `Googlebot`）流式传输元数据。但对于 **HTML 受限** 的机器人（如 `Twitterbot`），由于它们无法在执行 JavaScript 时爬取页面，元数据会继续阻塞页面渲染。
+由于页面元数据主要针对机器人和爬虫，Next.js 会为可以执行 JavaScript 并检查完整页面 DOM 的机器人（如 `Googlebot`）流式传输元数据。但对于 **HTML 受限** 的机器人（如 `Twitterbot`），元数据会继续阻塞页面渲染，因为这些机器人在爬取时无法执行 JavaScript。
 
 Next.js 会自动检测传入请求的用户代理，以决定是提供流式元数据还是回退到阻塞式元数据。
 
-如果需要自定义此列表，可以在 `next.config.js` 中使用 `htmlLimitedBots` 选项手动定义。Next.js 将确保匹配此正则表达式的用户代理在请求您的网页时收到阻塞式元数据。
+如果需要自定义此列表，您可以在 `next.config.js` 中使用 `htmlLimitedBots` 选项手动定义它们。Next.js 会确保匹配此正则表达式的用户代理在请求您的网页时接收阻塞式元数据。
 
 ```ts filename="next.config.ts" switcher
 import type { NextConfig } from 'next'
 
 const config: NextConfig = {
-  htmlLimitedBots: 'MySpecialBot|MyAnotherSpecialBot|SimpleCrawler',
+  htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,
 }
 
 export default config
@@ -1192,25 +1192,25 @@ export default config
 
 ```js filename="next.config.js" switcher
 module.exports = {
-  htmlLimitedBots: 'MySpecialBot|MyAnotherSpecialBot|SimpleCrawler',
+  htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,
 }
 ```
 
-指定 `htmlLimitedBots` 配置将覆盖 Next.js 的默认列表，允许您完全控制哪些用户代理应选择此行为。这是高级行为，默认设置已能满足大多数情况。
+指定 `htmlLimitedBots` 配置将覆盖 Next.js 的默认列表，允许您完全控制哪些用户代理应选择此行为。这是高级行为，默认设置应能满足大多数情况。
 
 ### 顺序
 
-元数据按顺序评估，从根段开始，一直到最接近最终 `page.js` 的段。例如：
+元数据按顺序评估，从根分段开始，一直到最接近最终 `page.js` 分段的分段。例如：
 
-1. `app/layout.tsx` (根布局)
-2. `app/blog/layout.tsx` (嵌套博客布局)
-3. `app/blog/[slug]/page.tsx` (博客页面)
+1. `app/layout.tsx`（根布局）
+2. `app/blog/layout.tsx`（嵌套博客布局）
+3. `app/blog/[slug]/page.tsx`（博客页面）
 
 ### 合并
 
-按照 [评估顺序](#ordering)，同一路由中多个段导出的元数据对象会 **浅层合并** 形成路由的最终元数据输出。重复键会根据顺序 **替换**。
+按照[评估顺序](#ordering)，从同一路由的多个分段导出的元数据对象会**浅合并**在一起，形成路由的最终元数据输出。重复的键会根据它们的顺序**替换**。
 
-这意味着嵌套字段如 [`openGraph`](/docs/app/api-reference/functions/generate-metadata#opengraph) 和 [`robots`](/docs/app/api-reference/functions/generate-metadata#robots) 在较早段中定义的元数据会被最后定义它们的段 **覆盖**。
+这意味着在较早分段中定义的嵌套字段（如 [`openGraph`](/docs/app/api-reference/functions/generate-metadata#opengraph) 和 [`robots`](/docs/app/api-reference/functions/generate-metadata#robots)）会被最后一个定义它们的分段**覆盖**。
 
 #### 覆盖字段
 
@@ -1232,17 +1232,17 @@ export const metadata = {
   },
 }
 
-// 输出:
+// 输出：
 // <title>Blog</title>
 // <meta property="og:title" content="Blog" />
 ```
 
-在上例中：
+在上面的示例中：
 
 - `app/layout.js` 中的 `title` 被 `app/blog/page.js` 中的 `title` **替换**。
-- `app/layout.js` 中的所有 `openGraph` 字段在 `app/blog/page.js` 中被 **替换**，因为 `app/blog/page.js` 设置了 `openGraph` 元数据。注意 `openGraph.description` 的缺失。
+- `app/layout.js` 中的所有 `openGraph` 字段在 `app/blog/page.js` 中被**替换**，因为 `app/blog/page.js` 设置了 `openGraph` 元数据。注意缺少 `openGraph.description`。
 
-如果希望在段之间共享某些嵌套字段同时覆盖其他字段，可以将它们提取到单独的变量中：
+如果您希望在分段之间共享某些嵌套字段同时覆盖其他字段，可以将它们提取到单独的变量中：
 
 ```jsx filename="app/shared-metadata.js"
 export const openGraphImage = { images: ['http://...'] }
@@ -1270,7 +1270,7 @@ export const metadata = {
 }
 ```
 
-在上例中，OG 图片在 `app/layout.js` 和 `app/about/page.js` 之间共享，而标题不同。
+在上面的示例中，OG 图片在 `app/layout.js` 和 `app/about/page.js` 之间共享，而标题不同。
 
 #### 继承字段
 
@@ -1289,7 +1289,7 @@ export const metadata = {
   title: 'About',
 }
 
-// 输出:
+// 输出：
 // <title>About</title>
 // <meta property="og:title" content="Acme" />
 // <meta property="og:description" content="Acme is a..." />
@@ -1298,12 +1298,12 @@ export const metadata = {
 **说明**
 
 - `app/layout.js` 中的 `title` 被 `app/about/page.js` 中的 `title` **替换**。
-- `app/layout.js` 中的所有 `openGraph` 字段在 `app/about/page.js` 中被 **继承**，因为 `app/about/page.js` 未设置 `openGraph` 元数据。
+- `app/layout.js` 中的所有 `openGraph` 字段在 `app/about/page.js` 中被**继承**，因为 `app/about/page.js` 未设置 `openGraph` 元数据。
 
 ## 版本历史
 
 | 版本       | 变更                                                                                                                                                 |
 | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `v15.2.0` | 为 `generateMetadata` 引入流式支持。                                                                                                     |
-| `v13.2.0` | `viewport`、`themeColor` 和 `colorScheme` 弃用，推荐使用 [`viewport` 配置](/docs/app/api-reference/functions/generate-viewport)。 |
+| `v13.2.0` | `viewport`、`themeColor` 和 `colorScheme` 被弃用，转而支持 [`viewport` 配置](/docs/app/api-reference/functions/generate-viewport)。 |
 | `v13.2.0` | 引入 `metadata` 和 `generateMetadata`。                                                                                                           |
diff --git a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/next-request.mdx b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/next-request.mdx
index b260f595..08e95518 100644
--- a/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/next-request.mdx
+++ b/apps/docs/content/zh-hans/docs/01-app/05-api-reference/04-functions/next-request.mdx
@@ -1,11 +1,11 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:24:47.453Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:19:13.840Z
 title: NextRequest
 description: NextRequest 的 API 参考文档。
 ---
 
-{/* 本文档内容在应用路由和页面路由之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。任何共享内容不应包裹在组件中。*/}
+{/* 本文档内容在应用路由和页面路由间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加仅适用于页面路由的内容。任何共享内容不应包裹在组件中。 */}
 
 NextRequest 扩展了 [Web Request API](https://developer.mozilla.org/docs/Web/API/Request)，提供了更多便捷方法。
 
@@ -18,7 +18,7 @@ NextRequest 扩展了 [Web Request API](https://developer.mozilla.org/docs/Web/A
 根据给定的名称，在请求中设置具有对应值的 cookie。
 
 ```ts
-// 假设传入请求为 /home
+// 给定传入请求 /home
 // 设置一个 cookie 来隐藏横幅
 // 请求将包含 `Set-Cookie:show-banner=false;path=/home` 标头
 request.cookies.set('show-banner', 'false')
@@ -26,10 +26,10 @@ request.cookies.set('show-banner', 'false')
 
 ### `get(name)`
 
-根据 cookie 名称返回其值。如果未找到 cookie 则返回 `undefined`。如果找到多个同名 cookie，则返回第一个。
+根据 cookie 名称返回其值。如果未找到 cookie 则返回 `undefined`。如果找到多个同名 cookie，返回第一个。
 
 ```ts
-// 假设传入请求为 /home
+// 给定传入请求 /home
 // { name: 'show-banner', value: 'false', Path: '/home' }
 request.cookies.get('show-banner')
 ```
@@ -39,7 +39,7 @@ request.cookies.get('show-banner')
 根据 cookie 名称返回其所有值。如果未指定名称，则返回请求中的所有 cookie。
 
 ```ts
-// 假设传入请求为 /home
+// 给定传入请求 /home
 // [
 //   { name: 'experiments', value: 'new-pricing-page', Path: '/home' },
 //   { name: 'experiments', value: 'winter-launch', Path: '/home' },
@@ -77,30 +77,30 @@ request.cookies.clear()
 
 ## `nextUrl`
 
-扩展了原生 [`URL`](https://developer.mozilla.org/docs/Web/API/URL) API，提供更多便捷方法，包括 Next.js 特有的属性。
+扩展原生 [`URL`](https://developer.mozilla.org/docs/Web/API/URL) API，提供更多便捷方法，包括 Next.js 特有的属性。
 
 ```ts
-// 对于 /home 请求，pathname 为 /home
+// 给定请求 /home，pathname 为 /home
 request.nextUrl.pathname
-// 对于 /home?name=lee 请求，searchParams 为 { 'name': 'lee' }
+// 给定请求 /home?name=lee，searchParams 为 { 'name': 'lee' }
 request.nextUrl.searchParams
 ```
 
-可用选项如下：
+可用属性如下：
 
 <PagesOnly>
 
 | 属性              | 类型                      | 描述                                                                                                                            |
 | ----------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `basePath`        | `string`                  | URL 的 [基础路径 (base path)](/docs/pages/api-reference/config/next-config-js/basePath)。                                                  |
+| `basePath`        | `string`                  | URL 的 [基础路径](/docs/pages/api-reference/config/next-config-js/basePath)。                                                  |
 | `buildId`         | `string` \| `undefined`   | Next.js 应用的构建标识符。可[自定义](/docs/pages/api-reference/config/next-config-js/generateBuildId)。 |
-| `defaultLocale`   | `string` \| `undefined`   | [国际化 (internationalization)](/docs/pages/building-your-application/routing/internationalization) 的默认区域设置。                     |
+| `defaultLocale`   | `string` \| `undefined`   | [国际化](/docs/pages/guides/internationalization) 的默认语言。                                                |
 | `domainLocale`    |                           |                                                                                                                                        |
-| - `defaultLocale` | `string`                  | 域内的默认区域设置。                                                                                                    |
-| - `domain`        | `string`                  | 与特定区域设置关联的域名。                                                                                          |
-| - `http`          | `boolean` \| `undefined`  | 指示该域名是否使用 HTTP。                                                                                                 |
-| `locales`         | `string[]` \| `undefined` | 可用区域设置数组。                                                                                                         |
-| `locale`          | `string` \| `undefined`   | 当前活动的区域设置。                                                                                                           |
+| - `defaultLocale` | `string`                  | 域名内的默认语言。                                                                                                    |
+| - `domain`        | `string`                  | 与特定语言关联的域名。                                                                                          |
+| - `http`          | `boolean` \| `undefined`  | 表示域名是否使用 HTTP。                                                                                                 |
+| `locales`         | `string[]` \| `undefined` | 可用语言数组。                                                                                                         |
+| `locale`          | `string` \| `undefined`   | 当前使用的语言。                                                                                                           |
 | `url`             | `URL`                     | URL 对象。                                                                                                                        |
 
 </PagesOnly>
@@ -109,17 +109,17 @@ request.nextUrl.searchParams
 
 | 属性           | 类型                    | 描述                                                                                                                          |
 | -------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `basePath`     | `string`                | URL 的 [基础路径 (base path)](/docs/app/api-reference/config/next-config-js/basePath)。                                                  |
+| `basePath`     | `string`                | URL 的 [基础路径](/docs/app/api-reference/config/next-config-js/basePath)。                                                  |
 | `buildId`      | `string` \| `undefined` | Next.js 应用的构建标识符。可[自定义](/docs/app/api-reference/config/next-config-js/generateBuildId)。 |
-| `pathname`     | `string`                | URL 的路径名。                                                                                                             |
-| `searchParams` | `Object`                | URL 的搜索参数。                                                                                                    |
+| `pathname`     | `string`                | URL 的路径部分。                                                                                                             |
+| `searchParams` | `Object`                | URL 的查询参数。                                                                                                    |
 
-> **注意：** 页面路由中的国际化属性在应用路由中不可用。了解更多关于[应用路由的国际化](/docs/app/building-your-application/routing/internationalization)。
+> **注意：** 页面路由中的国际化属性在应用路由中不可用。了解更多关于[应用路由的国际化](/docs/app/guides/internationalization)。
 
 </AppOnly>
 
 ## 版本历史
 
-| 版本       | 变更                  |
-| ---------- | --------------------- |
+| 版本       | 变更                 |
+| ---------- | -------------------- |
 | `v15.0.0` | 移除了 `ip` 和 `geo`。 |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/02-guides/draft-mode.mdx b/apps/docs/content/zh-hans/docs/02-pages/02-guides/draft-mode.mdx
index 559dd4eb..ea54b1d9 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/02-guides/draft-mode.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/02-guides/draft-mode.mdx
@@ -1,24 +1,24 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:00:19.130Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:15:48.746Z
 title: 如何在 Next.js 中使用草稿模式预览内容
 nav_title: 草稿模式
-description: Next.js 提供了草稿模式，用于在静态页面与动态页面之间切换。您可以了解它如何与 Pages Router 协同工作。
+description: Next.js 提供草稿模式用于在静态页面与动态页面间切换。您可了解其如何与页面路由 (Pages Router) 协同工作。
 ---
 
-在 [Pages 文档](/docs/pages/building-your-application/routing/pages-and-layouts) 和 [数据获取文档](/docs/pages/building-your-application/data-fetching) 中，我们讨论了如何使用 `getStaticProps` 和 `getStaticPaths` 在构建时预渲染页面（**静态生成 (Static Generation)**）。
+在[页面文档](/docs/pages/building-your-application/routing/pages-and-layouts)和[数据获取文档](/docs/pages/building-your-application/data-fetching)中，我们讨论了如何使用 `getStaticProps` 和 `getStaticPaths` 在构建时预渲染页面（**静态生成**）。
 
-当您的页面从无头 CMS (headless CMS) 获取数据时，静态生成非常有用。然而，当您在无头 CMS 上撰写草稿并希望立即在页面上查看时，这种方式并不理想。此时您会希望 Next.js 在 **请求时 (request time)** 而非构建时渲染这些页面，并获取草稿内容而非已发布内容。您会希望 Next.js 仅在此特定情况下绕过静态生成。
+当页面从无头 CMS 获取数据时，静态生成非常有用。但如果您正在无头 CMS 上撰写草稿并希望立即在页面上查看，这种方式就不理想了。此时您会希望 Next.js 在**请求时**而非构建时渲染这些页面，并获取草稿内容而非已发布内容。您需要 Next.js 仅在此特定情况下绕过静态生成。
 
-Next.js 的 **草稿模式 (Draft Mode)** 功能可以解决这个问题。以下是使用指南。
+Next.js 的**草稿模式 (Draft Mode)** 功能正是为此而生。以下是使用指南。
 
-## 步骤 1：创建并访问 API 路由
+## 第一步：创建并访问 API 路由
 
-> 如果您不熟悉 Next.js 的 API 路由，请先查阅 [API 路由文档](/docs/pages/building-your-application/routing/api-routes)。
+> 如果您不熟悉 Next.js API 路由，请先查阅 [API 路由文档](/docs/pages/building-your-application/routing/api-routes)。
 
-首先创建 **API 路由**。它可以任意命名，例如 `pages/api/draft.ts`。
+首先创建 **API 路由**，可任意命名（例如 `pages/api/draft.ts`）。
 
-在此 API 路由中，您需要在响应对象上调用 `setDraftMode`。
+在此 API 路由中，需在响应对象上调用 `setDraftMode`。
 
 ```js
 export default function handler(req, res) {
@@ -28,9 +28,9 @@ export default function handler(req, res) {
 }
 ```
 
-这将设置一个 **Cookie** 以启用草稿模式。后续携带此 Cookie 的请求将触发 **草稿模式 (Draft Mode)**，从而改变静态生成页面的行为（稍后会详细说明）。
+这将设置一个**Cookie**来启用草稿模式。后续携带此 Cookie 的请求将触发**草稿模式**，从而改变静态生成页面的行为（下文详述）。
 
-您可以通过手动创建如下 API 路由并从浏览器访问来进行测试：
+您可以通过手动创建如下 API 路由并从浏览器访问来测试：
 
 ```ts filename="pages/api/draft.ts"
 // 用于从浏览器手动测试的简单示例
@@ -40,87 +40,86 @@ export default function handler(req, res) {
 }
 ```
 
-如果您打开浏览器的开发者工具并访问 `/api/draft`，会注意到响应头中有一个 `Set-Cookie` 字段，其 Cookie 名为 `__prerender_bypass`。
+如果在浏览器开发者工具中访问 `/api/draft`，会注意到响应头中有 `Set-Cookie` 字段，其值为名为 `__prerender_bypass` 的 Cookie。
 
 ### 从无头 CMS 安全访问
 
-实际应用中，您需要从无头 CMS **安全地** 调用此 API 路由。具体步骤因使用的无头 CMS 而异，但以下是通用的操作流程。
+实际应用中，您需要从无头 CMS**安全地**调用此 API 路由。具体步骤因 CMS 而异，但以下是通用方案：
 
-这些步骤假设您使用的无头 CMS 支持设置 **自定义草稿 URL**。如果不支持，您仍可使用此方法保护草稿 URL，但需要手动构建并访问草稿 URL。
+此方案假设您的无头 CMS 支持设置**自定义草稿 URL**。若不支持，您仍可用此方法保护草稿 URL，但需手动构建和访问。
 
-**首先**，使用您选择的令牌生成器创建一个 **密钥令牌字符串 (secret token string)**。该密钥仅由您的 Next.js 应用和无头 CMS 知晓，可防止无 CMS 访问权限的人获取草稿 URL。
+**首先**，使用任意令牌生成器创建**密钥字符串**。该密钥仅由 Next.js 应用和无头 CMS 知晓，可防止无 CMS 访问权限者获取草稿 URL。
 
-**其次**，如果无头 CMS 支持设置自定义草稿 URL，请将以下内容指定为草稿 URL。此处假设您的草稿 API 路由位于 `pages/api/draft.ts`。
+**其次**，若 CMS 支持自定义草稿 URL，请将以下内容设为草稿 URL（假设草稿 API 路由位于 `pages/api/draft.ts`）：
 
-```bash filename="Terminal"
+```bash filename="终端"
 https://<your-site>/api/draft?secret=<token>&slug=<path>
 ```
 
-- `<your-site>` 应替换为您的部署域名
-- `<token>` 应替换为您生成的密钥令牌
-- `<path>` 应替换为您希望预览的页面路径。例如要预览 `/posts/foo`，则应使用 `&slug=/posts/foo`
+- `<your-site>` 替换为部署域名
+- `<token>` 替换为生成的密钥
+- `<path>` 替换为目标页面路径（如欲查看 `/posts/foo`，则使用 `&slug=/posts/foo`）
 
-您的无头 CMS 可能允许在草稿 URL 中包含变量，从而能基于 CMS 数据动态设置 `<path>`，例如：`&slug=/posts/{entry.fields.slug}`
+某些 CMS 允许在草稿 URL 中包含变量，从而动态设置 `<path>`，例如：`&slug=/posts/{entry.fields.slug}`
 
 **最后**，在草稿 API 路由中：
-
-- 检查密钥是否匹配以及 `slug` 参数是否存在（否则请求应失败）
+- 检查密钥是否匹配及 `slug` 参数是否存在（否则请求应失败）
 - 调用 `res.setDraftMode`
-- 然后将浏览器重定向到 `slug` 指定的路径（以下示例使用 [307 重定向](https://developer.mozilla.org/docs/Web/HTTP/Status/307)）
+- 重定向浏览器到 `slug` 指定路径（下例使用 [307 重定向](https://developer.mozilla.org/docs/Web/HTTP/Status/307)）
 
 ```js
 export default async (req, res) => {
-  // 检查密钥和必要参数
-  // 该密钥应仅由此 API 路由和 CMS 知晓
+  // 验证密钥和必要参数
+  // 此密钥应仅限此API路由和CMS知晓
   if (req.query.secret !== 'MY_SECRET_TOKEN' || !req.query.slug) {
     return res.status(401).json({ message: '无效令牌' })
   }
 
-  // 查询无头 CMS 以验证提供的 `slug` 是否存在
-  // getPostBySlug 需实现从无头 CMS 获取数据的逻辑
+  // 向无头CMS查询该slug是否存在
+  // getPostBySlug需实现针对无头CMS的获取逻辑
   const post = await getPostBySlug(req.query.slug)
 
-  // 如果 slug 不存在，则阻止启用草稿模式
+  // 若slug不存在则阻止启用草稿模式
   if (!post) {
-    return res.status(401).json({ message: '无效 slug' })
+    return res.status(401).json({ message: '无效slug' })
   }
 
-  // 通过设置 Cookie 启用草稿模式
+  // 通过设置Cookie启用草稿模式
   res.setDraftMode({ enable: true })
 
-  // 重定向到从查询结果获取的路径
-  // 不直接重定向到 req.query.slug 以防止开放重定向漏洞
+  // 重定向到获取的文章路径
+  // 不直接重定向到req.query.slug以防开放重定向漏洞
   res.redirect(post.slug)
 }
 ```
 
-如果成功，浏览器将被重定向到您希望预览的路径，并携带草稿模式 Cookie。
+成功后，浏览器将携带草稿模式 Cookie 重定向到目标路径。
 
-## 步骤 2：更新 `getStaticProps`
+## 第二步：更新 `getStaticProps`
 
-下一步是更新 `getStaticProps` 以支持草稿模式。
+接下来需更新 `getStaticProps` 以支持草稿模式。
 
-如果请求的页面包含 `getStaticProps` 且已设置 Cookie（通过 `res.setDraftMode`），则 `getStaticProps` 将在 **请求时 (request time)**（而非构建时）被调用。
+若请求的页面具有 `getStaticProps` 且已设置 Cookie（通过 `res.setDraftMode`），则 `getStaticProps` 将在**请求时**被调用（而非构建时）。
 
-此外，它将被调用时接收一个 `context` 对象，其中 `context.draftMode` 为 `true`。
+此外，其调用时将接收 `context` 对象，其中 `context.draftMode` 为 `true`。
 
 ```js
 export async function getStaticProps(context) {
   if (context.draftMode) {
-    // 获取动态数据
+    // 动态数据
   }
 }
 ```
 
-由于我们在草稿 API 路由中使用了 `res.setDraftMode`，因此 `context.draftMode` 将为 `true`。
+由于我们在草稿 API 路由中使用了 `res.setDraftMode`，故 `context.draftMode` 将为 `true`。
 
-如果同时使用 `getStaticPaths`，则 `context.params` 也将可用。
+若同时使用 `getStaticPaths`，则 `context.params` 也可用。
 
 ### 获取草稿数据
 
-您可以根据 `context.draftMode` 修改 `getStaticProps` 以获取不同的数据。
+可根据 `context.draftMode` 修改 `getStaticProps` 以获取不同数据。
 
-例如，您的无头 CMS 可能为草稿文章提供了不同的 API 端点。如果是这样，您可以按如下方式修改 API 端点 URL：
+例如，无头 CMS 可能有专用的草稿文章 API 端点。此时可如下修改端点 URL：
 
 ```js
 export async function getStaticProps(context) {
@@ -132,11 +131,11 @@ export async function getStaticProps(context) {
 }
 ```
 
-就是这样！如果您从无头 CMS 或手动访问草稿 API 路由（携带 `secret` 和 `slug`），现在应该能看到草稿内容。当您更新草稿但未发布时，也能查看草稿。
+完成！现在从无头 CMS 或手动访问草稿 API 路由（携带 `secret` 和 `slug`）即可查看草稿内容。当您更新草稿但未发布时，也能立即查看。
 
-将此 URL 设置为无头 CMS 的草稿 URL 或手动访问，即可查看草稿：
+将此 URL 设为无头 CMS 的草稿 URL 或手动访问：
 
-```bash filename="Terminal"
+```bash filename="终端"
 https://<your-site>/api/draft?secret=<token>&slug=<path>
 ```
 
@@ -144,9 +143,9 @@ https://<your-site>/api/draft?secret=<token>&slug=<path>
 
 ### 清除草稿模式 Cookie
 
-默认情况下，草稿模式会话会在浏览器关闭时结束。
+默认情况下，草稿模式会话在浏览器关闭时结束。
 
-要手动清除草稿模式 Cookie，可创建一个调用 `setDraftMode({ enable: false })` 的 API 路由：
+要手动清除 Cookie，可创建调用 `setDraftMode({ enable: false })` 的 API 路由：
 
 ```ts filename="pages/api/disable-draft.ts"
 export default function handler(req, res) {
@@ -154,17 +153,17 @@ export default function handler(req, res) {
 }
 ```
 
-然后向 `/api/disable-draft` 发送请求以调用该 API 路由。如果使用 [`next/link`](/docs/pages/api-reference/components/link) 调用此路由，必须传递 `prefetch={false}` 以防止预取时意外删除 Cookie。
+然后向 `/api/disable-draft` 发送请求。若使用 [`next/link`](/docs/pages/api-reference/components/link) 调用此路由，必须传递 `prefetch={false}` 以防预取时意外删除 Cookie。
 
-### 与 `getServerSideProps` 协同工作
+### 与 `getServerSideProps` 协作
 
-草稿模式可与 `getServerSideProps` 配合使用，并通过 [`context`](/docs/pages/api-reference/functions/get-server-side-props#context-parameter) 对象中的 `draftMode` 键提供。
+草稿模式可与 `getServerSideProps` 协同工作，在[上下文对象](/docs/pages/api-reference/functions/get-server-side-props#context-parameter)中以 `draftMode` 键存在。
 
-> **须知**：使用草稿模式时不应设置 `Cache-Control` 标头，因为它无法被绕过。我们建议改用 [ISR (增量静态再生)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)。
+> **须知**：使用草稿模式时不应设置 `Cache-Control` 标头，因其无法被绕过。建议改用 [ISR](/docs/pages/guides/incremental-static-regeneration)。
 
-### 与 API 路由协同工作
+### 与 API 路由协作
 
-API 路由可以通过请求对象访问 `draftMode`。例如：
+API 路由可通过请求对象的 `draftMode` 访问该状态。例如：
 
 ```js
 export default function myApiRoute(req, res) {
@@ -176,8 +175,8 @@ export default function myApiRoute(req, res) {
 
 ### 每次 `next build` 生成唯一值
 
-每次运行 `next build` 时都会生成新的绕过 Cookie 值。
+每次运行 `next build` 都会生成新的绕过 Cookie 值。
 
 这确保了绕过 Cookie 无法被猜测。
 
-> **须知**：要通过 HTTP 在本地测试草稿模式，您的浏览器需要允许第三方 Cookie 和本地存储访问。
\ No newline at end of file
+> **须知**：要通过 HTTP 在本地测试草稿模式，浏览器需允许第三方 Cookie 和本地存储访问。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/02-guides/incremental-static-regeneration.mdx b/apps/docs/content/zh-hans/docs/02-pages/02-guides/incremental-static-regeneration.mdx
index 5a2613e4..2e3c33e2 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/02-guides/incremental-static-regeneration.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/02-guides/incremental-static-regeneration.mdx
@@ -1,9 +1,10 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:19:48.562Z
-title: 增量静态再生 (ISR)
-description: 了解如何使用增量静态再生 (ISR) 在运行时创建或更新静态页面。
-source: app/building-your-application/data-fetching/incremental-static-regeneration
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:14:39.214Z
+title: 如何实现增量静态再生 (ISR)
+nav_title: ISR
+description: 了解如何在运行时使用增量静态再生 (ISR) 创建或更新静态页面。
+source: app/guides/incremental-static-regeneration
 ---
 
-{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请前往编辑器中的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
+{/* 请勿编辑。本文档内容源自上方 source 链接。如需编辑页面内容，请前往编辑器中打开源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/02-guides/internationalization.mdx b/apps/docs/content/zh-hans/docs/02-pages/02-guides/internationalization.mdx
index 3a571a6c..c10f6899 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/02-guides/internationalization.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/02-guides/internationalization.mdx
@@ -1,45 +1,45 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:22:37.628Z
-title: 国际化 (i18n) 路由
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:26.421Z
+title: 如何在 Next.js 中实现国际化
 nav_title: 国际化
-description: Next.js 内置支持国际化路由和语言检测功能。了解更多信息请参阅本文档。
+description: Next.js 内置支持国际化路由和语言检测功能。了解更多详情。
 ---
 
 <details>
   <summary>示例</summary>
 
-- [i18n 路由](https://github.com/vercel/next.js/tree/canary/examples/i18n-routing-pages)
+- [国际化路由](https://github.com/vercel/next.js/tree/canary/examples/i18n-routing-pages)
 
 </details>
 
-自 `v10.0.0` 起，Next.js 已内置支持国际化 ([i18n](https://en.wikipedia.org/wiki/Internationalization_and_localization#Naming)) 路由。您可以提供语言环境列表、默认语言环境以及特定域名的语言环境配置，Next.js 将自动处理路由。
+自 `v10.0.0` 版本起，Next.js 已内置支持国际化（[i18n](https://en.wikipedia.org/wiki/Internationalization_and_localization#Naming)）路由功能。您只需提供语言环境列表、默认语言环境以及特定域名的语言环境配置，Next.js 便会自动处理路由转换。
 
-当前的 i18n 路由功能旨在与现有的 i18n 库解决方案（如 [`react-intl`](https://formatjs.io/docs/getting-started/installation)、[`react-i18next`](https://react.i18next.com/)、[`lingui`](https://lingui.dev/)、[`rosetta`](https://github.com/lukeed/rosetta)、[`next-intl`](https://github.com/amannn/next-intl)、[`next-translate`](https://github.com/aralroca/next-translate)、[`next-multilingual`](https://github.com/Avansai/next-multilingual)、[`tolgee`](https://tolgee.io/integrations/next)、[`paraglide-next`](https://inlang.com/m/osslbuzt/paraglide-next-i18n)、[`next-intlayer`](https://intlayer.org/doc/environment/nextjs) 等）互补，通过简化路由和语言环境解析来增强功能。
+当前的国际化路由支持旨在与现有国际化库方案（如 [`react-intl`](https://formatjs.io/docs/getting-started/installation)、[`react-i18next`](https://react.i18next.com/)、[`lingui`](https://lingui.dev/)、[`rosetta`](https://github.com/lukeed/rosetta)、[`next-intl`](https://github.com/amannn/next-intl)、[`next-translate`](https://github.com/aralroca/next-translate)、[`next-multilingual`](https://github.com/Avansai/next-multilingual)、[`tolgee`](https://tolgee.io/integrations/next)、[`paraglide-next`](https://inlang.com/m/osslbuzt/paraglide-next-i18n)、[`next-intlayer`](https://intlayer.org/doc/environment/nextjs) 等）形成互补，通过简化路由和语言环境解析来完善国际化方案。
 
 ## 快速开始
 
-首先，在您的 `next.config.js` 文件中添加 `i18n` 配置。
+首先在 `next.config.js` 文件中添加 `i18n` 配置。
 
-语言环境采用 [UTS 语言标识符](https://www.unicode.org/reports/tr35/tr35-59/tr35.html#Identifiers) 标准格式定义。
+语言环境需采用 [UTS 语言标识符](https://www.unicode.org/reports/tr35/tr35-59/tr35.html#Identifiers) 这一标准化格式。
 
-通常，语言标识符由语言、地区（可选）和文字（可选）组成，用连字符连接：`语言-地区-文字`。例如：
+通常语言标识符由语言代码、地区代码和文字代码组成，格式为 `语言-地区-文字`。其中地区代码和文字代码为可选项。例如：
 
 - `en-US` - 美国英语
 - `nl-NL` - 荷兰荷兰语
 - `nl` - 荷兰语（无特定地区）
 
-如果用户的语言环境是 `nl-BE` 但您的配置中未列出该语言环境，系统会尝试重定向到 `nl`（如果可用），否则将使用默认语言环境。因此，如果您不打算支持某个国家的所有地区，最佳实践是包含将作为后备的国家级语言环境。
+当用户访问的语言环境（如 `nl-BE`）未在配置中列出时，系统会尝试回退到 `nl`（如果存在），否则将使用默认语言环境。因此，若您不打算支持某个国家的所有地区变体，最佳实践是包含该国家的基础语言代码作为回退选项。
 
 ```js filename="next.config.js"
 module.exports = {
   i18n: {
-    // 这是您应用中希望支持的所有语言环境
+    // 应用中需要支持的所有语言环境
     locales: ['en-US', 'fr', 'nl-NL'],
-    // 当访问不带语言环境前缀的路径（如 `/hello`）时使用的默认语言环境
+    // 当访问无语言前缀路径（如 `/hello`）时使用的默认语言环境
     defaultLocale: 'en-US',
     // 域名路由配置（仅在设置域名路由时需要）
-    // 注意：子域名必须包含在 domain 值中才能匹配，例如 "fr.example.com"
+    // 注意：子域名需完整包含在 domain 值中才能匹配，例如 "fr.example.com"
     domains: [
       {
         domain: 'example.com',
@@ -52,7 +52,7 @@ module.exports = {
       {
         domain: 'example.fr',
         defaultLocale: 'fr',
-        // 可选 http 字段，可用于在本地使用 http 而非 https 测试语言环境域名
+        // 可选 http 字段，可用于本地测试时使用 http 而非 https
         http: true,
       },
     ],
@@ -62,11 +62,11 @@ module.exports = {
 
 ## 语言环境策略
 
-有两种语言环境处理策略：子路径路由和域名路由。
+Next.js 提供两种语言环境处理策略：子路径路由和域名路由。
 
 ### 子路径路由
 
-子路径路由将语言环境置于 URL 路径中。
+子路径路由将语言代码置于 URL 路径中。
 
 ```js filename="next.config.js"
 module.exports = {
@@ -77,17 +77,17 @@ module.exports = {
 }
 ```
 
-使用上述配置，`en-US`、`fr` 和 `nl-NL` 将可用于路由，其中 `en-US` 是默认语言环境。如果您有一个 `pages/blog.js` 页面，则以下 URL 将可用：
+使用上述配置时，`en-US`、`fr` 和 `nl-NL` 将成为可路由的语言环境，其中 `en-US` 为默认语言环境。假设您有一个 `pages/blog.js` 页面，则以下 URL 将生效：
 
 - `/blog`
 - `/fr/blog`
 - `/nl-nl/blog`
 
-默认语言环境不带前缀。
+默认语言环境不包含前缀。
 
 ### 域名路由
 
-通过域名路由，您可以配置不同域名服务不同语言环境：
+通过域名路由，您可以将不同语言环境配置到不同域名：
 
 ```js filename="next.config.js"
 module.exports = {
@@ -97,8 +97,8 @@ module.exports = {
 
     domains: [
       {
-        // 注意：子域名必须包含在 domain 值中才能匹配
-        // 例如若预期主机名为 www.example.com 则应使用该值
+        // 注意：子域名需完整包含在 domain 值中才能匹配
+        // 例如若预期主机名为 www.example.com 则应填写该值
         domain: 'example.com',
         defaultLocale: 'en-US',
       },
@@ -117,7 +117,7 @@ module.exports = {
 }
 ```
 
-例如，如果您有 `pages/blog.js` 页面，则以下 URL 将可用：
+例如对于 `pages/blog.js` 页面，以下 URL 将生效：
 
 - `example.com/blog`
 - `www.example.com/blog`
@@ -127,22 +127,22 @@ module.exports = {
 
 ## 自动语言环境检测
 
-当用户访问应用根路径（通常是 `/`）时，Next.js 会根据 [`Accept-Language`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Accept-Language) 请求头和当前域名自动检测用户偏好的语言环境。
+当用户访问应用根路径（通常为 `/`）时，Next.js 会根据 [`Accept-Language`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Accept-Language) 请求头和当前域名自动检测用户偏好的语言环境。
 
-如果检测到非默认语言环境，用户将被重定向至：
+若检测到非默认语言环境，用户将被重定向至：
 
-- **使用子路径路由时**：带语言环境前缀的路径
+- **使用子路径路由时**：带语言前缀的路径
 - **使用域名路由时**：配置了该语言环境为默认值的域名
 
-使用域名路由时，如果带有 `Accept-Language` 请求头 `fr;q=0.9` 的用户访问 `example.com`，他们将被重定向到 `example.fr`，因为该域名默认处理 `fr` 语言环境。
+例如在使用域名路由时，若带有 `Accept-Language: fr;q=0.9` 请求头的用户访问 `example.com`，将被重定向至 `example.fr`，因为该域名默认处理 `fr` 语言环境。
 
-使用子路径路由时，用户将被重定向到 `/fr`。
+使用子路径路由时，用户将被重定向至 `/fr`。
 
-### 为默认语言环境添加前缀
+### 为默认语言添加前缀
 
-在 Next.js 12 及更高版本中，结合 [中间件](/docs/pages/building-your-application/routing/middleware)，我们可以通过 [变通方案](https://github.com/vercel/next.js/discussions/18419) 为默认语言环境添加前缀。
+在 Next.js 12 及更高版本中，结合 [中间件](/docs/pages/building-your-application/routing/middleware) 功能，可通过 [变通方案](https://github.com/vercel/next.js/discussions/18419) 为默认语言环境添加前缀。
 
-例如，以下是一个支持多种语言的 `next.config.js` 文件配置。注意我们特意添加了 `"default"` 语言环境：
+例如，以下 `next.config.js` 文件支持多种语言，请注意其中特意添加了 `"default"` 语言环境：
 
 ```js filename="next.config.js"
 module.exports = {
@@ -155,7 +155,7 @@ module.exports = {
 }
 ```
 
-接下来，我们可以使用 [中间件](/docs/pages/building-your-application/routing/middleware) 添加自定义路由规则：
+然后使用 [中间件](/docs/pages/building-your-application/routing/middleware) 添加自定义路由规则：
 
 ```ts filename="middleware.ts"
 import { NextRequest, NextResponse } from 'next/server'
@@ -181,11 +181,11 @@ export async function middleware(req: NextRequest) {
 }
 ```
 
-此 [中间件](/docs/pages/building-your-application/routing/middleware) 会跳过为 [API 路由](/docs/pages/building-your-application/routing/api-routes) 和 [公共文件](/docs/pages/api-reference/file-conventions/public-folder)（如字体或图像）添加默认前缀。如果请求是针对默认语言环境的，我们会重定向到带前缀的 `/en` 路径。
+此 [中间件](/docs/pages/building-your-application/routing/middleware) 会跳过为 [API 路由](/docs/pages/building-your-application/routing/api-routes) 和 [公共文件](/docs/pages/api-reference/file-conventions/public-folder)（如字体或图片）添加默认前缀。当请求默认语言环境时，我们会重定向至带 `/en` 前缀的路径。
 
-### 禁用自动语言环境检测
+### 禁用自动语言检测
 
-可以通过以下方式禁用自动语言环境检测：
+可通过以下配置禁用自动语言检测：
 
 ```js filename="next.config.js"
 module.exports = {
@@ -195,25 +195,25 @@ module.exports = {
 }
 ```
 
-当 `localeDetection` 设置为 `false` 时，Next.js 将不再根据用户偏好语言环境自动重定向，仅提供从基于语言环境的域名或路径中检测到的语言环境信息。
+当 `localeDetection` 设为 `false` 时，Next.js 将不再根据用户偏好语言自动重定向，仅提供从基于语言的域名或路径中检测到的语言环境信息。
 
 ## 访问语言环境信息
 
-您可以通过 Next.js 路由访问语言环境信息。例如，使用 [`useRouter()`](/docs/pages/api-reference/functions/use-router) 钩子时，以下属性可用：
+您可以通过 Next.js 路由访问语言环境信息。例如使用 [`useRouter()`](/docs/pages/api-reference/functions/use-router) 钩子时，以下属性可用：
 
-- `locale` 包含当前活动的语言环境
-- `locales` 包含所有配置的语言环境
-- `defaultLocale` 包含配置的默认语言环境
+- `locale` - 当前活动的语言环境
+- `locales` - 所有配置的语言环境
+- `defaultLocale` - 配置的默认语言环境
 
 当使用 `getStaticProps` 或 `getServerSideProps` [预渲染](/docs/pages/building-your-application/rendering/static-site-generation) 页面时，语言环境信息会通过 [上下文参数](/docs/pages/building-your-application/data-fetching/get-static-props) 提供给函数。
 
-使用 `getStaticPaths` 时，配置的语言环境通过函数上下文参数中的 `locales` 提供，默认语言环境通过 `defaultLocale` 提供。
+使用 `getStaticPaths` 时，配置的语言环境会通过上下文参数的 `locales` 属性提供，默认语言环境通过 `defaultLocale` 属性提供。
 
-## 语言环境间切换
+## 语言环境切换
 
-您可以使用 `next/link` 或 `next/router` 在语言环境间切换。
+您可以使用 `next/link` 或 `next/router` 实现语言环境切换。
 
-对于 `next/link`，可以通过 `locale` 属性指定切换到不同于当前活动语言环境的其他语言环境。如果未提供 `locale` 属性，客户端切换时将使用当前活动的 `locale`。例如：
+对于 `next/link`，可通过 `locale` 属性指定要切换的目标语言环境。若不提供 `locale` 属性，客户端切换时将使用当前活动语言环境。例如：
 
 ```jsx
 import Link from 'next/link'
@@ -221,13 +221,13 @@ import Link from 'next/link'
 export default function IndexPage(props) {
   return (
     <Link href="/another" locale="fr">
-      跳转到 /fr/another
+      跳转至 /fr/another
     </Link>
   )
 }
 ```
 
-直接使用 `next/router` 方法时，可以通过过渡选项指定应使用的 `locale`。例如：
+直接使用 `next/router` 方法时，可通过过渡选项指定目标语言环境。例如：
 
 ```jsx
 import { useRouter } from 'next/router'
@@ -241,25 +241,25 @@ export default function IndexPage(props) {
         router.push('/another', '/another', { locale: 'fr' })
       }}
     >
-      跳转到 /fr/another
+      跳转至 /fr/another
     </div>
   )
 }
 ```
 
-注意，若要在仅切换 `locale` 的同时保留所有路由信息（如 [动态路由](/docs/pages/building-your-application/routing/dynamic-routes) 查询值或隐藏的 href 查询值），可以将 `href` 参数作为对象提供：
+注意：若需在保留所有路由信息（如 [动态路由](/docs/pages/building-your-application/routing/dynamic-routes) 查询参数或隐藏的 href 查询值）的同时仅切换语言环境，可将 `href` 参数作为对象传递：
 
 ```jsx
 import { useRouter } from 'next/router'
 const router = useRouter()
 const { pathname, asPath, query } = router
-// 仅更改语言环境，同时保留包括 href 查询在内的所有其他路由信息
+// 仅切换语言环境，保留其他所有路由信息
 router.push({ pathname, query }, asPath, { locale: nextLocale })
 ```
 
 有关 `router.push` 对象结构的更多信息，请参阅 [此处](/docs/pages/api-reference/functions/use-router#with-url-object)。
 
-如果您的 `href` 已包含语言环境，可以选择禁用自动处理语言环境前缀：
+若 href 已包含语言环境前缀，可通过以下方式禁用自动处理：
 
 ```jsx
 import Link from 'next/link'
@@ -267,7 +267,7 @@ import Link from 'next/link'
 export default function IndexPage(props) {
   return (
     <Link href="/fr/another" locale={false}>
-      跳转到 /fr/another
+      跳转至 /fr/another
     </Link>
   )
 }
@@ -275,29 +275,29 @@ export default function IndexPage(props) {
 
 ## 利用 `NEXT_LOCALE` Cookie
 
-Next.js 支持设置 `NEXT_LOCALE=语言环境` Cookie，其优先级高于 accept-language 请求头。可以通过语言切换器设置此 Cookie，当用户再次访问网站时，从 `/` 重定向到正确的语言环境位置时将使用 Cookie 中指定的语言环境。
+Next.js 支持设置 `NEXT_LOCALE=语言代码` Cookie，其优先级高于 accept-language 请求头。可通过语言切换器设置此 Cookie，当用户再次访问站点时，从 `/` 重定向时会优先使用 Cookie 中指定的语言环境。
 
-例如，如果用户的 accept-language 请求头偏好 `fr` 语言环境，但设置了 `NEXT_LOCALE=en` Cookie，则在访问 `/` 时，用户将被重定向到 `en` 语言环境位置，直到 Cookie 被删除或过期。
+例如，若用户请求头中的 accept-language 偏好为 `fr`，但设置了 `NEXT_LOCALE=en` Cookie，则访问 `/` 时将重定向至 `en` 语言环境，直到 Cookie 被删除或过期。
 
 ## 搜索引擎优化
 
-由于 Next.js 知道用户访问的语言环境，它会自动将 `lang` 属性添加到 `<html>` 标签。
+由于 Next.js 知晓用户访问的语言环境，它会自动为 `<html>` 标签添加 `lang` 属性。
 
-Next.js 不了解页面的变体，因此需要您使用 [`next/head`](/docs/pages/api-reference/components/head) 添加 `hreflang` 元标签。您可以在 [Google 网站管理员文档](https://support.google.com/webmasters/answer/189077) 中了解更多关于 `hreflang` 的信息。
+Next.js 不了解页面的语言变体，因此需要您使用 [`next/head`](/docs/pages/api-reference/components/head) 手动添加 `hreflang` 元标签。有关 `hreflang` 的更多信息，请参阅 [Google 站长文档](https://support.google.com/webmasters/answer/189077)。
 
-## 静态生成如何工作？
+## 静态生成如何运作？
 
-> 注意：国际化路由不与 [`output: 'export'`](/docs/pages/guides/static-exports) 集成，因为它不利用 Next.js 路由层。不使用 `output: 'export'` 的混合 Next.js 应用完全受支持。
+> 注意：国际化路由不与 [`output: 'export'`](/docs/pages/guides/static-exports) 兼容，因其不依赖 Next.js 路由层。不使用 `output: 'export'` 的混合式 Next.js 应用可获得完整支持。
 
-### 动态路由和 `getStaticProps` 页面
+### 动态路由与 `getStaticProps` 页面
 
-对于使用 `getStaticProps` 和 [动态路由](/docs/pages/building-your-application/routing/dynamic-routes) 的页面，所有希望预渲染的语言环境变体都需要从 [`getStaticPaths`](/docs/pages/building-your-application/data-fetching/get-static-paths) 返回。除了为 `paths` 返回的 `params` 对象外，您还可以返回一个 `locale` 字段指定要渲染的语言环境。例如：
+对于使用 `getStaticProps` 的 [动态路由](/docs/pages/building-your-application/routing/dynamic-routes) 页面，所有需要预渲染的语言变体都需通过 [`getStaticPaths`](/docs/pages/building-your-application/data-fetching/get-static-paths) 返回。除了为 `paths` 返回的 `params` 对象外，还可指定 `locale` 字段以声明要渲染的语言环境。例如：
 
 ```jsx filename="pages/blog/[slug].js"
 export const getStaticPaths = ({ locales }) => {
   return {
     paths: [
-      // 如果未提供 `locale`，则只会生成 defaultLocale
+      // 若不提供 `locale` 则仅生成 defaultLocale 版本
       { params: { slug: 'post-1' }, locale: 'en-US' },
       { params: { slug: 'post-1' }, locale: 'fr' },
     ],
@@ -306,24 +306,23 @@ export const getStaticPaths = ({ locales }) => {
 }
 ```
 
-对于 [自动静态优化](/docs/pages/building-your-application/rendering/automatic-static-optimization) 和非动态的 `getStaticProps` 页面，**将为每个语言环境生成一个页面版本**。这一点很重要，因为它可能会根据 `getStaticProps` 中配置的语言环境数量增加构建时间。
+对于 [自动静态优化](/docs/pages/building-your-application/rendering/automatic-static-optimization) 和非动态的 `getStaticProps` 页面，**每个语言环境都会生成对应的页面版本**。这需要特别注意，因为根据配置的语言环境数量，可能会显著增加构建时间。
 
-例如，如果您配置了 50 个语言环境和 10 个使用 `getStaticProps` 的非动态页面，这意味着 `getStaticProps` 将被调用 500 次。每次构建时将生成这 10 个页面的 50 个版本。
+例如若配置了 50 个语言环境，且有 10 个非动态页面使用 `getStaticProps`，则 `getStaticProps` 将被调用 500 次。每次构建时会生成这 10 个页面的 50 个语言版本。
 
-要减少使用 `getStaticProps` 的动态页面的构建时间，可以使用 [`fallback` 模式](/docs/pages/api-reference/functions/get-static-paths#fallback-true)。这允许您从 `getStaticPaths` 仅返回最受欢迎的路径和语言环境进行预渲染。然后，Next.js 将在请求时构建其余页面。
+要减少动态页面的构建时间，可使用 [`fallback` 模式](/docs/pages/api-reference/functions/get-static-paths#fallback-true)。这样您只需在 `getStaticPaths` 中返回最受欢迎的路径和语言环境进行预渲染，剩余页面将在运行时按需生成。
 
 ### 自动静态优化页面
 
-对于 [自动静态优化](/docs/pages/building-your-application/rendering/automatic-static-optimization) 的页面，将为每个语言环境生成一个页面版本。
+对于 [自动静态优化](/docs/pages/building-your-application/rendering/automatic-static-optimization) 的页面，每个语言环境都会生成对应的页面版本。
 
 ### 非动态 getStaticProps 页面
 
-对于非动态的 `getStaticProps` 页面，如上所述，将为每个语言环境生成一个版本。`getStaticProps` 会针对每个正在渲染的语言环境被调用。如果您希望跳过某些语言环境的预渲染，可以从 `getStaticProps` 返回 `notFound: true`，这样就不会生成该语言环境的页面版本。
+对于非动态的 `getStaticProps` 页面，同样会为每个语言环境生成版本。`getStaticProps` 会针对每个渲染的语言环境被调用。若需排除特定语言环境的预渲染，可从 `getStaticProps` 返回 `notFound: true`，该语言变体将不会被生成。
 
 ```js
 export async function getStaticProps({ locale }) {
-  // 调用外部 API 端点获取文章
-  // 您可以使用任何数据获取库
+  // 调用外部 API 获取数据
   const res = await fetch(`https://.../posts?locale=${locale}`)
   const posts = await res.json()
 
@@ -333,8 +332,6 @@ export async function getStaticProps({ locale }) {
     }
   }
 
-  // 通过返回 { props: posts }，Blog 组件
-  // 将在构建时接收 `posts` 作为 prop
   return {
     props: {
       posts,
@@ -345,7 +342,7 @@ export async function getStaticProps({ locale }) {
 
 ## i18n 配置限制
 
-- `locales`：最多 100 个语言环境
-- `domains`：最多 100 个语言环境域名项
+- `locales`：最多支持 100 个语言环境
+- `domains`：最多支持 100 个域名配置项
 
-> **须知**：这些限制最初是为了避免 [构建时可能出现的性能问题](#dynamic-routes-and-getstaticprops-pages) 而添加的。在 Next.js 12 中，您可以使用 [中间件](/docs/pages/building-your-application/routing/middleware) 实现自定义路由来绕过这些限制。
\ No newline at end of file
+> **须知**：这些限制最初是为了避免 [构建时的性能问题](#动态路由与-getstaticprops-页面)。在 Next.js 12 中，您可以通过 [中间件](/docs/pages/building-your-application/routing/middleware) 使用自定义路由来突破这些限制。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/02-guides/preview-mode.mdx b/apps/docs/content/zh-hans/docs/02-pages/02-guides/preview-mode.mdx
index 767ac856..4cf54123 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/02-guides/preview-mode.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/02-guides/preview-mode.mdx
@@ -1,13 +1,13 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:01:14.146Z
-title: 如何在 Next.js 中使用预览模式 (Preview Mode) 预览内容
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:16:30.614Z
+title: 如何在 Next.js 中使用预览模式查看内容
 nav_title: 预览模式
-description: Next.js 为静态生成页面提供了预览模式功能，您可在此了解其工作原理。
+description: Next.js 为静态生成页面提供了预览模式功能。您可以在此了解其工作原理。
 version: legacy
 ---
 
-> **注意**：此功能已被[草稿模式 (Draft Mode)](/docs/pages/guides/draft-mode)取代。
+> **注意**：此功能已被 [草稿模式 (Draft Mode)](/docs/pages/guides/draft-mode) 取代。
 
 <details>
   <summary>示例</summary>
@@ -42,19 +42,19 @@ version: legacy
 
 </details>
 
-在[页面文档](/docs/pages/building-your-application/routing/pages-and-layouts)和[数据获取文档](/docs/pages/building-your-application/data-fetching)中，我们讨论了如何使用 `getStaticProps` 和 `getStaticPaths` 在构建时预渲染页面（**静态生成 (Static Generation)**）。
+在 [页面文档](/docs/pages/building-your-application/routing/pages-and-layouts) 和 [数据获取文档](/docs/pages/building-your-application/data-fetching) 中，我们讨论了如何使用 `getStaticProps` 和 `getStaticPaths` 在构建时预渲染页面（**静态生成 (Static Generation)**）。
 
-当您的页面从无头 CMS (headless CMS) 获取数据时，静态生成非常有用。但是，当您在无头 CMS 上撰写草稿并希望立即在页面上**预览**草稿时，静态生成并不理想。您会希望 Next.js 在**请求时**而非构建时渲染这些页面，并获取草稿内容而非已发布内容。您会希望 Next.js 仅针对此特定情况绕过静态生成。
+当您的页面从无头 CMS (headless CMS) 获取数据时，静态生成非常有用。但是，当您在无头 CMS 上撰写草稿并希望立即在页面上**预览**草稿时，静态生成并不理想。您会希望 Next.js 在**请求时**而非构建时渲染这些页面，并获取草稿内容而非已发布内容。您会希望 Next.js 仅针对这种情况绕过静态生成。
 
-Next.js 提供了名为**预览模式 (Preview Mode)** 的功能来解决此问题。以下是使用该功能的说明。
+Next.js 提供了称为**预览模式 (Preview Mode)** 的功能来解决此问题。以下是使用方法的说明。
 
-## 步骤 1：创建并访问预览 API 路由
+## 第一步：创建并访问预览 API 路由
 
 > 如果您不熟悉 Next.js 的 API 路由，请先查看 [API 路由文档](/docs/pages/building-your-application/routing/api-routes)。
 
 首先，创建一个**预览 API 路由**。它可以有任何名称，例如 `pages/api/preview.js`（如果使用 TypeScript，则为 `.ts`）。
 
-在此 API 路由中，您需要在响应对象上调用 `setPreviewData`。`setPreviewData` 的参数应为一个对象，该对象可由 `getStaticProps` 使用（稍后会详细介绍）。目前，我们将使用 `{}`。
+在此 API 路由中，您需要在响应对象上调用 `setPreviewData`。`setPreviewData` 的参数应为一个对象，该对象可由 `getStaticProps` 使用（稍后会详细介绍）。现在，我们将使用 `{}`。
 
 ```js
 export default function handler(req, res) {
@@ -66,27 +66,27 @@ export default function handler(req, res) {
 
 `res.setPreviewData` 会在浏览器上设置一些 **cookies**，从而启用预览模式。任何包含这些 cookies 的 Next.js 请求都将被视为**预览模式**，静态生成页面的行为将发生变化（稍后会详细介绍）。
 
-您可以通过手动创建如下 API 路由并从浏览器手动访问来测试此功能：
+您可以通过手动创建如下 API 路由并从浏览器手动访问来进行测试：
 
 ```js filename="pages/api/preview.js"
 // 用于从浏览器手动测试的简单示例。
 export default function handler(req, res) {
   res.setPreviewData({})
-  res.end('预览模式已启用')
+  res.end('已启用预览模式')
 }
 ```
 
-如果您打开浏览器的开发者工具并访问 `/api/preview`，您会注意到 `__prerender_bypass` 和 `__next_preview_data` cookies 将在此请求上设置。
+如果您打开浏览器的开发者工具并访问 `/api/preview`，您会注意到此请求会设置 `__prerender_bypass` 和 `__next_preview_data` cookies。
 
 ### 从无头 CMS 安全访问
 
-实际上，您会希望从无头 CMS **安全地**调用此 API 路由。具体步骤将取决于您使用的无头 CMS，但以下是一些常见的步骤。
+实际上，您会希望从无头 CMS **安全地**调用此 API 路由。具体步骤会根据您使用的无头 CMS 而有所不同，但以下是一些常见的步骤。
 
 这些步骤假设您使用的无头 CMS 支持设置**自定义预览 URL**。如果不支持，您仍然可以使用此方法来保护您的预览 URL，但需要手动构建并访问预览 URL。
 
-**首先**，您应使用您选择的令牌生成器创建一个**秘密令牌字符串**。此秘密将仅由您的 Next.js 应用和无头 CMS 知晓。此秘密可防止无权访问您的 CMS 的人访问预览 URL。
+**首先**，您应使用您选择的令牌生成器创建一个**秘密令牌字符串**。此秘密仅由您的 Next.js 应用和无头 CMS 知晓。此秘密可防止无权访问您的 CMS 的人访问预览 URL。
 
-**其次**，如果您的无头 CMS 支持设置自定义预览 URL，请指定以下内容作为预览 URL。此示例假设您的预览 API 路由位于 `pages/api/preview.js`。
+**其次**，如果您的无头 CMS 支持设置自定义预览 URL，请将以下内容指定为预览 URL。此假设您的预览 API 路由位于 `pages/api/preview.js`。
 
 ```bash filename="终端"
 https://<your-site>/api/preview?secret=<token>&slug=<path>
@@ -102,7 +102,7 @@ https://<your-site>/api/preview?secret=<token>&slug=<path>
 
 - 检查秘密是否匹配以及 `slug` 参数是否存在（如果不存在，请求应失败）。
 - 调用 `res.setPreviewData`。
-- 然后将浏览器重定向到 `slug` 指定的路径（以下示例使用 [307 重定向](https://developer.mozilla.org/docs/Web/HTTP/Status/307)）。
+- 然后将浏览器重定向到由 `slug` 指定的路径。（以下示例使用 [307 重定向](https://developer.mozilla.org/docs/Web/HTTP/Status/307)）。
 
 ```js
 export default async (req, res) => {
@@ -113,7 +113,7 @@ export default async (req, res) => {
   }
 
   // 获取无头 CMS 以检查提供的 `slug` 是否存在
-  // getPostBySlug 将实现对无头 CMS 的必要获取逻辑
+  // getPostBySlug 将实现对无头 CMS 的所需获取逻辑
   const post = await getPostBySlug(req.query.slug)
 
   // 如果 slug 不存在，则阻止启用预览模式
@@ -130,22 +130,22 @@ export default async (req, res) => {
 }
 ```
 
-如果成功，浏览器将重定向到您想要预览的路径，并设置预览模式 cookies。
+如果成功，浏览器将被重定向到您想要预览的路径，并设置预览模式 cookies。
 
-## 步骤 2：更新 `getStaticProps`
+## 第二步：更新 `getStaticProps`
 
 下一步是更新 `getStaticProps` 以支持预览模式。
 
 如果您请求一个具有 `getStaticProps` 的页面，并且设置了预览模式 cookies（通过 `res.setPreviewData`），则 `getStaticProps` 将在**请求时**（而非构建时）被调用。
 
-此外，它将被调用时带有一个 `context` 对象，其中：
+此外，它将使用一个 `context` 对象调用，其中：
 
 - `context.preview` 将为 `true`。
 - `context.previewData` 将与 `setPreviewData` 使用的参数相同。
 
 ```js
 export async function getStaticProps(context) {
-  // 如果您在设置了预览模式 cookies 的情况下请求此页面：
+  // 如果您使用预览模式 cookies 请求此页面：
   //
   // - context.preview 将为 true
   // - context.previewData 将与
@@ -153,13 +153,13 @@ export async function getStaticProps(context) {
 }
 ```
 
-我们在预览 API 路由中使用了 `res.setPreviewData({})`，因此 `context.previewData` 将为 `{}`。如果需要，您可以使用此功能将会话信息从预览 API 路由传递到 `getStaticProps`。
+我们在预览 API 路由中使用了 `res.setPreviewData({})`，因此 `context.previewData` 将为 `{}`。您可以使用它将会话信息从预览 API 路由传递到 `getStaticProps`（如有必要）。
 
 如果您还使用 `getStaticPaths`，则 `context.params` 也将可用。
 
 ### 获取预览数据
 
-您可以更新 `getStaticProps`，根据 `context.preview` 和/或 `context.previewData` 获取不同的数据。
+您可以更新 `getStaticProps` 以根据 `context.preview` 和/或 `context.previewData` 获取不同的数据。
 
 例如，您的无头 CMS 可能有一个用于草稿帖子的不同 API 端点。如果是这样，您可以使用 `context.preview` 修改 API 端点 URL，如下所示：
 
@@ -183,14 +183,14 @@ https://<your-site>/api/preview?secret=<token>&slug=<path>
 
 ## 更多详情
 
-> **须知**：在渲染期间，`next/router` 会公开一个 `isPreview` 标志，有关更多信息，请参阅[路由器对象文档](/docs/pages/api-reference/functions/use-router#router-object)。
+> **须知**：在渲染期间，`next/router` 会公开一个 `isPreview` 标志，有关更多信息，请参阅 [路由器对象文档](/docs/pages/api-reference/functions/use-router#router-object)。
 
 ### 指定预览模式的持续时间
 
 `setPreviewData` 接受一个可选的第二个参数，该参数应为一个选项对象。它接受以下键：
 
 - `maxAge`：指定预览会话持续的秒数。
-- `path`：指定 cookie 应应用的路径。默认为 `/`，为所有路径启用预览模式。
+- `path`：指定应应用 cookie 的路径。默认为 `/`，为所有路径启用预览模式。
 
 ```js
 setPreviewData(data, {
@@ -225,13 +225,13 @@ export default function handler(req, res) {
 
 ### `previewData` 大小限制
 
-您可以向 `setPreviewData` 传递一个对象，并在 `getStaticProps` 中使用它。但是，由于数据将存储在 cookie 中，因此存在大小限制。目前，预览数据限制为 2KB。
+您可以传递一个对象给 `setPreviewData`，并在 `getStaticProps` 中使用它。但是，由于数据将存储在 cookie 中，因此存在大小限制。目前，预览数据限制为 2KB。
 
 ### 与 `getServerSideProps` 一起使用
 
 预览模式也适用于 `getServerSideProps`。它也将出现在包含 `preview` 和 `previewData` 的 `context` 对象上。
 
-> **须知**：使用预览模式时不应设置 `Cache-Control` 标头，因为它无法绕过。相反，我们建议使用 [ISR (增量静态再生)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)。
+> **须知**：使用预览模式时不应设置 `Cache-Control` 标头，因为它无法被绕过。相反，我们建议使用 [增量静态再生 (ISR)](/docs/pages/guides/incremental-static-regeneration)。
 
 ### 与 API 路由一起使用
 
@@ -247,6 +247,6 @@ export default function myApiRoute(req, res) {
 
 ### 每个 `next build` 唯一
 
-绕过 cookie 值和用于加密 `previewData` 的私钥在 `next build` 完成后都会更改。这确保绕过 cookie 无法被猜测。
+绕过 cookie 值和用于加密 `previewData` 的私钥在完成 `next build` 时会更改。这确保无法猜测绕过 cookie。
 
 > **须知**：要通过 HTTP 在本地测试预览模式，您的浏览器需要允许第三方 cookies 和本地存储访问。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/01-routing/07-api-routes.mdx b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/01-routing/07-api-routes.mdx
index ee76db4f..e8141737 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/01-routing/07-api-routes.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/01-routing/07-api-routes.mdx
@@ -1,9 +1,8 @@
 ---
-source-updated-at: 2025-05-19T22:31:51.000Z
-translation-updated-at: 2025-05-20T22:22:57.271Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:20:26.389Z
 title: API 路由
-description: Next.js 支持 API 路由功能，无需离开 Next.js 应用即可构建 API。了解其工作原理。
-
+description: Next.js 支持 API 路由功能，允许您无需离开 Next.js 应用即可构建 API。在此了解其工作原理。
 ---
 
 <details>
@@ -16,11 +15,11 @@ description: Next.js 支持 API 路由功能，无需离开 Next.js 应用即可
 
 </details>
 
-> **须知**：如果使用应用路由 (App Router)，可以用[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 或[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 替代 API 路由。
+> **须知**：如果您使用应用路由 (App Router)，可以使用[服务端组件 (Server Components)](/docs/app/getting-started/server-and-client-components) 或 [路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 替代 API 路由。
 
-API 路由提供了在 Next.js 中构建**公共 API**的解决方案。
+API 路由提供了一种使用 Next.js 构建**公共 API** 的解决方案。
 
-`pages/api` 目录下的任何文件都会被映射到 `/api/*` 路径，并被视为 API 端点而非页面。这些文件仅在服务端打包，不会增加客户端包体积。
+`pages/api` 目录下的任何文件都会映射到 `/api/*` 路径，并被视为 API 端点而非页面 (page)。这些文件仅在生产服务端打包，不会增加客户端包体积。
 
 例如，以下 API 路由会返回状态码为 `200` 的 JSON 响应：
 
@@ -47,8 +46,8 @@ export default function handler(req, res) {
 
 > **须知**：
 >
-> - API 路由[默认不指定 CORS 头信息](https://developer.mozilla.org/docs/Web/HTTP/CORS)，意味着默认仅支持**同源请求**。可通过 [CORS 请求辅助工具](https://github.com/vercel/next.js/tree/canary/examples/api-routes-cors) 包装请求处理器来自定义此行为。
-> - API 路由不能与[静态导出 (static exports)](/docs/pages/guides/static-exports) 同时使用，但应用路由中的[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 可以。
+> - API 路由[默认不指定 CORS 头信息](https://developer.mozilla.org/docs/Web/HTTP/CORS)，意味着它们默认仅支持**同源请求**。您可以通过使用 [CORS 请求辅助工具](https://github.com/vercel/next.js/tree/canary/examples/api-routes-cors) 包装请求处理函数来自定义此行为。
+> - API 路由不能与[静态导出 (static exports)](/docs/pages/guides/static-exports) 功能同时使用。但应用路由 (App Router) 中的[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 可以支持。
 > - API 路由会受到 `next.config.js` 中 [`pageExtensions` 配置](/docs/pages/api-reference/config/next-config-js/pageExtensions) 的影响。
 
 ## 参数
@@ -64,7 +63,7 @@ export default function handler(req: NextApiRequest, res: NextApiResponse) {
 
 ## HTTP 方法
 
-要在 API 路由中处理不同的 HTTP 方法，可以在请求处理器中使用 `req.method`，如下所示：
+要在 API 路由中处理不同的 HTTP 方法，可以在请求处理函数中使用 `req.method`，如下所示：
 
 ```ts filename="pages/api/hello.ts" switcher
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -90,11 +89,11 @@ export default function handler(req, res) {
 
 ## 请求辅助工具
 
-API 路由提供内置的请求辅助工具来解析传入请求 (`req`)：
+API 路由提供内置的请求辅助工具来解析传入的请求 (`req`)：
 
 - `req.cookies` - 包含请求发送的 cookie 的对象，默认为 `{}`
 - `req.query` - 包含[查询字符串 (query string)](https://en.wikipedia.org/wiki/Query_string) 的对象，默认为 `{}`
-- `req.body` - 由 `content-type` 解析的请求体对象，若无请求体则为 `null`
+- `req.body` - 包含根据 `content-type` 解析的请求体内容的对象，若无请求体则为 `null`
 
 ### 自定义配置
 
@@ -112,9 +111,9 @@ export const config = {
 }
 ```
 
-`bodyParser` 默认启用。如需以 `Stream` 形式或使用 [`raw-body`](https://www.npmjs.com/package/raw-body) 处理请求体，可将其设为 `false`。
+`bodyParser` 默认启用。如果您希望以 `Stream` 形式或使用 [`raw-body`](https://www.npmjs.com/package/raw-body) 处理请求体，可以将其设为 `false`。
 
-禁用自动 `bodyParsing` 的一个用例是验证**webhook**请求的原始内容，例如[来自 GitHub 的 webhook](https://docs.github.com/en/developers/webhooks-and-events/webhooks/securing-your-webhooks#validating-payloads-from-github)。
+禁用自动 `bodyParsing` 的一个用例是验证**webhook** 请求的原始内容，例如[来自 GitHub 的 webhook](https://docs.github.com/en/developers/webhooks-and-events/webhooks/securing-your-webhooks#validating-payloads-from-github)。
 
 ```js
 export const config = {
@@ -124,7 +123,7 @@ export const config = {
 }
 ```
 
-`bodyParser.sizeLimit` 是解析后请求体的最大允许大小，支持 [bytes](https://github.com/visionmedia/bytes.js) 库的任何格式：
+`bodyParser.sizeLimit` 是解析后请求体的最大允许大小，支持 [bytes](https://github.com/visionmedia/bytes.js) 库的任何格式，例如：
 
 ```js
 export const config = {
@@ -136,7 +135,7 @@ export const config = {
 }
 ```
 
-`externalResolver` 是一个显式标志，告知服务器此路由由外部解析器（如 _express_ 或 _connect_）处理。启用此选项会禁用未解析请求的警告。
+`externalResolver` 是一个显式标志，用于告知服务器此路由由外部解析器（如 _express_ 或 _connect_）处理。启用此选项会禁用未解析请求的警告。
 
 ```js
 export const config = {
@@ -146,9 +145,9 @@ export const config = {
 }
 ```
 
-`responseLimit` 默认启用，当 API 路由响应体超过 4MB 时会发出警告。
+`responseLimit` 默认启用，当 API 路由的响应体超过 4MB 时会发出警告。
 
-如果不在无服务器环境中使用 Next.js，且了解不使用 CDN 或专用媒体主机的性能影响，可将此限制设为 `false`。
+如果您不在无服务器环境中使用 Next.js，并且了解不使用 CDN 或专用媒体托管服务的性能影响，可以将此限制设为 `false`。
 
 ```js
 export const config = {
@@ -159,7 +158,7 @@ export const config = {
 ```
 
 `responseLimit` 也可以接受字节数或 `bytes` 支持的任何字符串格式，例如 `1000`、`'500kb'` 或 `'3mb'`。
-此值将成为触发警告前的最大响应大小。默认为 4MB（见上文）。
+此值将作为触发警告前的最大响应大小。默认值为 4MB（如上所述）。
 
 ```js
 export const config = {
@@ -171,21 +170,21 @@ export const config = {
 
 ## 响应辅助工具
 
-[服务器响应对象 (Server Response object)](https://nodejs.org/api/http.html#http_class_http_serverresponse)（通常缩写为 `res`）包含一组类似 Express.js 的辅助方法，用于提升开发体验并加速 API 端点的创建。
+[服务端响应对象 (Server Response object)](https://nodejs.org/api/http.html#http_class_http_serverresponse)（通常简写为 `res`）包含一组类似 Express.js 的辅助方法，用于提升开发体验并加速 API 端点的创建。
 
 包含的辅助方法有：
 
-- `res.status(code)` - 设置状态码的函数，`code` 必须是有效的 [HTTP 状态码](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)
-- `res.json(body)` - 发送 JSON 响应，`body` 必须是[可序列化对象](https://developer.mozilla.org/docs/Glossary/Serialization)
-- `res.send(body)` - 发送 HTTP 响应，`body` 可以是 `string`、`object` 或 `Buffer`
-- `res.redirect([status,] path)` - 重定向到指定路径或 URL，`status` 必须是有效的 [HTTP 状态码](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)。若未指定，默认为 "307" "临时重定向"。
-- `res.revalidate(urlPath)` - [按需重新验证页面](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)，需配合 `getStaticProps` 使用。`urlPath` 必须为 `string`。
+- `res.status(code)` - 设置状态码的函数。`code` 必须是有效的 [HTTP 状态码](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)
+- `res.json(body)` - 发送 JSON 响应。`body` 必须是[可序列化对象](https://developer.mozilla.org/docs/Glossary/Serialization)
+- `res.send(body)` - 发送 HTTP 响应。`body` 可以是 `string`、`object` 或 `Buffer`
+- `res.redirect([status,] path)` - 重定向到指定路径或 URL。`status` 必须是有效的 [HTTP 状态码](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes)。如未指定，`status` 默认为 "307" "临时重定向"。
+- `res.revalidate(urlPath)` - [按需重新验证页面](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 使用 `getStaticProps`。`urlPath` 必须为 `string`。
 
 ### 设置响应状态码
 
-向客户端发送响应时，可以设置响应的状态码。
+在向客户端发送响应时，可以设置响应的状态码。
 
-以下示例将响应状态码设为 `200`（`OK`）并返回包含 `message` 属性的 JSON 响应，其值为 `Hello from Next.js!`：
+以下示例将响应状态码设置为 `200`（`OK`），并以 JSON 格式返回包含 `message` 属性的响应，其值为 `Hello from Next.js!`：
 
 ```ts filename="pages/api/hello.ts" switcher
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -210,8 +209,8 @@ export default function handler(req, res) {
 
 ### 发送 JSON 响应
 
-向客户端发送响应时，可以发送 JSON 响应，这必须是一个[可序列化对象](https://developer.mozilla.org/docs/Glossary/Serialization)。
-在实际应用中，可能需要根据请求端点的结果让客户端知晓请求状态。
+向客户端发送响应时可以发送 JSON 响应，这必须是一个[可序列化对象](https://developer.mozilla.org/docs/Glossary/Serialization)。
+在实际应用中，您可能希望根据请求端点的结果让客户端了解请求的状态。
 
 以下示例发送状态码为 `200`（`OK`）的 JSON 响应，包含异步操作的结果。代码包含在 try catch 块中以处理可能出现的错误，捕获适当的状态码和错误消息并返回给客户端：
 
@@ -244,7 +243,7 @@ export default async function handler(req, res) {
 
 ### 发送 HTTP 响应
 
-发送 HTTP 响应的方式与发送 JSON 响应类似，区别在于响应体可以是 `string`、`object` 或 `Buffer`。
+发送 HTTP 响应的方式与发送 JSON 响应相同。唯一的区别是响应体可以是 `string`、`object` 或 `Buffer`。
 
 以下示例发送状态码为 `200`（`OK`）的 HTTP 响应，包含异步操作的结果：
 
@@ -277,7 +276,7 @@ export default async function handler(req, res) {
 
 ### 重定向到指定路径或 URL
 
-以表单为例，可能希望在客户端提交表单后将其重定向到指定路径或 URL。
+以表单为例，您可能希望在客户端提交表单后将其重定向到指定路径或 URL。
 
 以下示例在表单成功提交后将客户端重定向到 `/` 路径：
 
@@ -314,7 +313,7 @@ export default async function handler(req, res) {
 
 ### 添加 TypeScript 类型
 
-通过从 `next` 导入 `NextApiRequest` 和 `NextApiResponse` 类型，可以使 API 路由更具类型安全性，此外还可以为响应数据添加类型：
+通过从 `next` 导入 `NextApiRequest` 和 `NextApiResponse` 类型，您可以使 API 路由更具类型安全性。此外，您还可以为响应数据添加类型：
 
 ```ts
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -331,11 +330,11 @@ export default function handler(
 }
 ```
 
-> **须知**：`NextApiRequest` 的 body 为 `any` 类型，因为客户端可能包含任意负载。应在运行时验证 body 的类型/结构后再使用。
+> **须知**：`NextApiRequest` 的 body 为 `any` 类型，因为客户端可能包含任何负载。在使用前应验证 body 的类型/结构。
 
 ## 动态 API 路由
 
-API 路由支持[动态路由 (dynamic routes)](/docs/pages/building-your-application/routing/dynamic-routes)，遵循与 `pages/` 相同的文件命名规则。
+API 路由支持[动态路由 (dynamic routes)](/docs/pages/building-your-application/routing/dynamic-routes)，并遵循与 `pages/` 相同的文件命名规则。
 
 ```ts filename="pages/api/post/[pid].ts" switcher
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -355,27 +354,27 @@ export default function handler(req, res) {
 
 现在，请求 `/api/post/abc` 将返回文本：`Post: abc`。
 
-### 全捕获 API 路由
+### 通配 API 路由
 
-通过在方括号内添加三个点（`...`）可以扩展 API 路由以捕获所有路径。例如：
+通过在方括号内添加三个点（`...`），可以扩展 API 路由以匹配所有路径。例如：
 
-- `pages/api/post/[...slug].js` 会匹配 `/api/post/a`，也会匹配 `/api/post/a/b`、`/api/post/a/b/c` 等路径。
+- `pages/api/post/[...slug].js` 将匹配 `/api/post/a`，同时也匹配 `/api/post/a/b`、`api/post/a/b/c` 等路径。
 
-> **须知**：可以使用 `slug` 以外的名称，例如 `[...param]`
+> **须知**：您可以使用 `slug` 以外的名称，例如：`[...param]`
 
-匹配的参数会作为查询参数（示例中的 `slug`）发送到页面，且始终是数组。例如路径 `/api/post/a` 的 `query` 对象如下：
+匹配的参数将作为查询参数（示例中的 `slug`）传递给页面，且始终是一个数组。因此，路径 `/api/post/a` 的 `query` 对象如下：
 
 ```json
 { "slug": ["a"] }
 ```
 
-而 `/api/post/a/b` 或任何其他匹配路径，新参数会被添加到数组中：
+对于 `/api/post/a/b` 及任何其他匹配路径，新参数将被添加到数组中，如下所示：
 
 ```json
 { "slug": ["a", "b"] }
 ```
 
-示例：
+例如：
 
 ```ts filename="pages/api/post/[...slug].ts" switcher
 import type { NextApiRequest, NextApiResponse } from 'next'
@@ -395,13 +394,13 @@ export default function handler(req, res) {
 
 现在，请求 `/api/post/a/b/c` 将返回文本：`Post: a, b, c`。
 
-### 可选全捕获 API 路由
+### 可选通配 API 路由
 
-通过将参数放在双方括号中（`[[...slug]]`）可以使全捕获路由变为可选。
+通过在双括号中包含参数（`[[...slug]]`），可以将通配路由设为可选。
 
-例如，`pages/api/post/[[...slug]].js` 会匹配 `/api/post`、`/api/post/a`、`/api/post/a/b` 等路径。
+例如，`pages/api/post/[[...slug]].js` 将匹配 `/api/post`、`/api/post/a`、`/api/post/a/b` 等路径。
 
-全捕获路由与可选全捕获路由的主要区别在于，可选路由也会匹配不带参数的路径（示例中的 `/api/post`）。
+通配路由与可选通配路由的主要区别在于，可选通配路由也会匹配不带参数的路径（示例中的 `/api/post`）。
 
 `query` 对象如下：
 
@@ -413,16 +412,16 @@ export default function handler(req, res) {
 
 ### 注意事项
 
-- 预定义的 API 路由优先于动态 API 路由，动态 API 路由优先于全捕获 API 路由。请看以下示例：
-  - `pages/api/post/create.js` - 会匹配 `/api/post/create`
-  - `pages/api/post/[pid].js` - 会匹配 `/api/post/1`、`/api/post/abc` 等，但不匹配 `/api/post/create`
-  - `pages/api/post/[...slug].js` - 会匹配 `/api/post/1/2`、`/api/post/a/b/c` 等，但不匹配 `/api/post/create`、`/api/post/abc`
+- 预定义的 API 路由优先于动态 API 路由，动态 API 路由优先于通配 API 路由。请看以下示例：
+  - `pages/api/post/create.js` - 将匹配 `/api/post/create`
+  - `pages/api/post/[pid].js` - 将匹配 `/api/post/1`、`/api/post/abc` 等，但不匹配 `/api/post/create`
+  - `pages/api/post/[...slug].js` - 将匹配 `/api/post/1/2`、`/api/post/a/b/c` 等，但不匹配 `/api/post/create`、`/api/post/abc`
 
 ## 流式响应
 
-虽然页面路由 (Pages Router) 支持通过 API 路由实现流式响应，但如果使用 Next.js 14+，我们建议逐步采用应用路由 (App Router) 并使用[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers)。
+虽然页面路由 (Pages Router) 支持通过 API 路由实现流式响应，但我们建议在 Next.js 14+ 版本中逐步采用应用路由 (App Router) 并使用[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers)。
 
-以下是通过 `writeHead` 从 API 路由流式传输响应的示例：
+以下是如何通过 `writeHead` 从 API 路由流式传输响应：
 
 ```js filename="pages/api/hello.js"
 import { NextApiRequest, NextApiResponse } from 'next'
diff --git a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/02-rendering/05-client-side-rendering.mdx b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/02-rendering/05-client-side-rendering.mdx
index b38ef738..ba9388a6 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/02-rendering/05-client-side-rendering.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/02-rendering/05-client-side-rendering.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:20:17.236Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:18:28.406Z
 title: 客户端渲染 (CSR)
 description: 了解如何在 Pages Router 中实现客户端渲染。
 related:
@@ -8,17 +8,17 @@ related:
   links:
     - pages/building-your-application/rendering/server-side-rendering
     - pages/building-your-application/rendering/static-site-generation
-    - pages/building-your-application/data-fetching/incremental-static-regeneration
+    - pages/guides/incremental-static-regeneration
     - app/building-your-application/routing/loading-ui-and-streaming
 ---
 
-在使用 React 进行客户端渲染 (CSR) 时，浏览器会下载一个最小化的 HTML 页面和所需的 JavaScript 文件。随后 JavaScript 被用来更新 DOM 并渲染页面。当应用首次加载时，用户可能会注意到在完整页面显示前有轻微延迟，这是因为页面需要等待所有 JavaScript 下载、解析和执行完成后才会完全渲染。
+在使用 React 进行客户端渲染 (CSR) 时，浏览器会下载一个最小的 HTML 页面和所需的 JavaScript 文件。随后 JavaScript 被用于更新 DOM 并渲染页面。当应用首次加载时，用户可能会注意到在完整页面显示前有轻微延迟，这是因为页面需要等待所有 JavaScript 下载、解析和执行完成后才会完全渲染。
 
-首次加载页面后，在同一网站内导航到其他页面通常会更快，因为只需获取必要数据，JavaScript 可以重新渲染页面部分内容而无需整页刷新。
+首次加载页面后，在同一网站内导航到其他页面通常会更快，因为只需获取必要数据，JavaScript 可以重新渲染部分页面而无需完全刷新。
 
 在 Next.js 中，有两种方式可以实现客户端渲染：
 
-1. 在页面中使用 React 的 `useEffect()` 钩子而非服务端渲染方法 ([`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 和 [`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props))。
+1. 在页面中使用 React 的 `useEffect()` 钩子，而非服务端渲染方法 ([`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 和 [`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props))。
 2. 使用数据获取库如 [SWR](https://swr.vercel.app/) 或 [TanStack Query](https://tanstack.com/query/latest/) 在客户端获取数据（推荐方式）。
 
 以下是在 Next.js 页面中使用 `useEffect()` 的示例：
@@ -40,7 +40,7 @@ export function Page() {
     }
 
     fetchData().catch((e) => {
-      // 根据需要处理错误
+      // 按需处理错误
       console.error('An error occurred while fetching the data: ', e)
     })
   }, [])
@@ -49,7 +49,7 @@ export function Page() {
 }
 ```
 
-上述示例中，组件最初会渲染 `Loading...`。当数据获取完成后，组件会重新渲染并显示数据。
+在上例中，组件初始会渲染 `Loading...`。当数据获取完成后，组件会重新渲染并显示数据。
 
 虽然在 `useEffect` 中获取数据是旧版 React 应用中常见的模式，但我们推荐使用数据获取库以获得更好的性能、缓存、乐观更新等功能。以下是使用 [SWR](https://swr.vercel.app/) 在客户端获取数据的最小示例：
 
@@ -71,4 +71,4 @@ export function Page() {
 
 > **须知**:
 >
-> 请注意 CSR 可能会影响 SEO。某些搜索引擎爬虫可能不会执行 JavaScript，因此只能看到应用的初始空状态或加载状态。对于网络连接速度较慢或设备性能较差的用户，也可能导致性能问题，因为他们需要等待所有 JavaScript 加载并运行后才能看到完整页面。Next.js 提倡采用混合方式，允许您根据应用中每个页面的需求，组合使用 [服务端渲染](/docs/pages/building-your-application/rendering/server-side-rendering)、[静态站点生成](/docs/pages/building-your-application/rendering/static-site-generation) 和客户端渲染。在 App Router 中，您还可以使用 [Suspense 加载 UI](/docs/app/building-your-application/routing/loading-ui-and-streaming) 来显示页面渲染过程中的加载指示器。
\ No newline at end of file
+> 请注意 CSR 可能会影响 SEO。某些搜索引擎爬虫可能不会执行 JavaScript，因此只能看到应用的初始空状态或加载状态。对于网络连接或设备性能较差的用户，也可能导致性能问题，因为他们需要等待所有 JavaScript 加载并运行后才能看到完整页面。Next.js 提倡采用混合方案，允许您根据应用中每个页面的需求，组合使用[服务端渲染](/docs/pages/building-your-application/rendering/server-side-rendering)、[静态站点生成](/docs/pages/building-your-application/rendering/static-site-generation)和客户端渲染。在 App Router 中，您还可以使用[带 Suspense 的加载界面](/docs/app/building-your-application/routing/loading-ui-and-streaming)来显示页面渲染期间的加载指示器。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/01-get-static-props.mdx b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/01-get-static-props.mdx
index a68e2c05..9b3913c3 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/01-get-static-props.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/01-get-static-props.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:21:05.156Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:19:08.338Z
 title: getStaticProps
 description: 使用 `getStaticProps` 获取数据并生成静态页面。了解更多关于 Next.js 中这一数据获取 API 的信息。
 ---
@@ -42,9 +42,9 @@ export default function Page({ repo }) {
 }
 ```
 
-> 请注意，无论渲染类型如何，任何 `props` 都将传递给页面组件，并可在初始 HTML 的客户端查看。这是为了让页面能够正确进行[水合 (hydrate)](https://react.dev/reference/react-dom/hydrate)。请确保不要在 `props` 中传递任何不应在客户端可用的敏感信息。
+> 请注意，无论渲染类型如何，任何 `props` 都会传递给页面组件，并可以在初始 HTML 的客户端查看。这是为了让页面能够正确进行 [hydrate](https://react.dev/reference/react-dom/hydrate)。请确保不要在 `props` 中传递任何不应在客户端可用的敏感信息。
 
-[`getStaticProps` API 参考文档](/docs/pages/api-reference/functions/get-static-props)涵盖了可与 `getStaticProps` 一起使用的所有参数和 props。
+[`getStaticProps` API 参考文档](/docs/pages/api-reference/functions/get-static-props) 涵盖了可与 `getStaticProps` 一起使用的所有参数和 props。
 
 ## 何时应使用 getStaticProps？
 
@@ -52,26 +52,26 @@ export default function Page({ repo }) {
 
 - 渲染页面所需的数据在用户请求之前的构建时可用
 - 数据来自无头 CMS
-- 页面必须预渲染（为了 SEO）且速度极快 —— `getStaticProps` 会生成 `HTML` 和 `JSON` 文件，两者均可通过 CDN 缓存以提高性能
-- 数据可以公开缓存（非用户特定）。在某些特定情况下，可以通过使用中间件重写路径来绕过此条件。
+- 页面必须预渲染（为了 SEO）且速度非常快 —— `getStaticProps` 会生成 `HTML` 和 `JSON` 文件，两者都可以通过 CDN 缓存以提高性能
+- 数据可以公开缓存（非用户特定）。在某些特定情况下，可以通过使用中间件重写路径来绕过此条件
 
 ## getStaticProps 何时运行
 
-`getStaticProps` 始终在服务端运行，而不会在客户端运行。您可以使用[此工具](https://next-code-elimination.vercel.app/)验证 `getStaticProps` 内的代码已从客户端包中移除。
+`getStaticProps` 始终在服务端运行，而不会在客户端运行。您可以使用 [此工具](https://next-code-elimination.vercel.app/) 验证 `getStaticProps` 内的代码已从客户端包中移除。
 
 - `getStaticProps` 始终在 `next build` 期间运行
 - 使用 [`fallback: true`](/docs/pages/api-reference/functions/get-static-paths#fallback-true) 时，`getStaticProps` 会在后台运行
 - 使用 [`fallback: blocking`](/docs/pages/api-reference/functions/get-static-paths#fallback-blocking) 时，`getStaticProps` 会在初始渲染前调用
 - 使用 `revalidate` 时，`getStaticProps` 会在后台运行
-- 使用 [`revalidate()`](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 时，`getStaticProps` 会在后台按需运行
+- 使用 [`revalidate()`](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 时，`getStaticProps` 会在后台按需运行
 
-当与[增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration) 结合使用时，`getStaticProps` 会在过时页面被重新验证时在后台运行，并将新页面提供给浏览器。
+与 [增量静态再生](/docs/pages/guides/incremental-static-regeneration) 结合使用时，`getStaticProps` 会在重新验证过期页面的同时在后台运行，并将新页面提供给浏览器。
 
-`getStaticProps` 无法访问传入的请求（如查询参数或 HTTP 头），因为它生成的是静态 HTML。如果您的页面需要访问请求，请考虑在使用 `getStaticProps` 的同时使用[中间件 (Middleware)](/docs/pages/building-your-application/routing/middleware)。
+`getStaticProps` 无法访问传入的请求（如查询参数或 HTTP 头），因为它生成的是静态 HTML。如果您的页面需要访问请求，请考虑在使用 `getStaticProps` 的同时使用 [中间件](/docs/pages/building-your-application/routing/middleware)。
 
 ## 使用 getStaticProps 从 CMS 获取数据
 
-以下示例展示了如何从 CMS 获取博客文章列表。
+以下示例展示如何从 CMS 获取博客文章列表。
 
 ```tsx filename="pages/blog.tsx" switcher
 // posts 将在构建时由 getStaticProps() 填充
@@ -85,17 +85,17 @@ export default function Blog({ posts }) {
   )
 }
 
-// 此函数在构建时在服务端调用。
-// 它不会在客户端调用，因此甚至可以
-// 直接执行数据库查询。
+// 此函数在构建时在服务端调用
+// 不会在客户端调用，因此甚至可以
+// 直接执行数据库查询
 export async function getStaticProps() {
-  // 调用外部 API 端点获取文章。
+  // 调用外部 API 端点获取文章
   // 可以使用任何数据获取库
   const res = await fetch('https://.../posts')
   const posts = await res.json()
 
   // 通过返回 { props: { posts } }，Blog 组件
-  // 将在构建时接收到 `posts` 作为 prop
+  // 将在构建时接收 `posts` 作为 prop
   return {
     props: {
       posts,
@@ -116,17 +116,17 @@ export default function Blog({ posts }) {
   )
 }
 
-// 此函数在构建时在服务端调用。
-// 它不会在客户端调用，因此甚至可以
-// 直接执行数据库查询。
+// 此函数在构建时在服务端调用
+// 不会在客户端调用，因此甚至可以
+// 直接执行数据库查询
 export async function getStaticProps() {
-  // 调用外部 API 端点获取文章。
+  // 调用外部 API 端点获取文章
   // 可以使用任何数据获取库
   const res = await fetch('https://.../posts')
   const posts = await res.json()
 
   // 通过返回 { props: { posts } }，Blog 组件
-  // 将在构建时接收到 `posts` 作为 prop
+  // 将在构建时接收 `posts` 作为 prop
   return {
     props: {
       posts,
@@ -135,19 +135,19 @@ export async function getStaticProps() {
 }
 ```
 
-[`getStaticProps` API 参考文档](/docs/pages/api-reference/functions/get-static-props)涵盖了可与 `getStaticProps` 一起使用的所有参数和 props。
+[`getStaticProps` API 参考文档](/docs/pages/api-reference/functions/get-static-props) 涵盖了可与 `getStaticProps` 一起使用的所有参数和 props。
 
 ## 直接编写服务端代码
 
 由于 `getStaticProps` 仅在服务端运行，因此它永远不会在客户端运行。它甚至不会包含在浏览器的 JS 包中，因此您可以编写直接的数据库查询而无需担心它们被发送到浏览器。
 
-这意味着，与其从 `getStaticProps` 中获取**API 路由**（该路由本身从外部源获取数据），不如直接在 `getStaticProps` 中编写服务端代码。
+这意味着，与其从 `getStaticProps` 中获取 **API 路由**（该路由本身从外部源获取数据），不如直接在 `getStaticProps` 中编写服务端代码。
 
-请看以下示例。API 路由用于从 CMS 获取一些数据。然后直接从 `getStaticProps` 调用该 API 路由。这会增加额外的调用，降低性能。相反，可以通过使用 `lib/` 目录共享从 CMS 获取数据的逻辑。然后可以与 `getStaticProps` 共享。
+请看以下示例。API 路由用于从 CMS 获取一些数据，然后直接从 `getStaticProps` 调用该 API 路由。这会产生额外的调用，降低性能。相反，可以通过使用 `lib/` 目录共享从 CMS 获取数据的逻辑，然后与 `getStaticProps` 共享。
 
 ```js filename="lib/load-posts.js"
-// 以下函数与 getStaticProps 和 API 路由共享
-// 来自 `lib/` 目录
+// 以下函数与 getStaticProps 和 API 路由
+// 共享，位于 `lib/` 目录中
 export async function loadPosts() {
   // 调用外部 API 端点获取文章
   const res = await fetch('https://.../posts/')
@@ -163,8 +163,8 @@ import { loadPosts } from '../lib/load-posts'
 
 // 此函数仅在服务端运行
 export async function getStaticProps() {
-  // 无需获取 `/api` 路由，可以直接在 `getStaticProps` 中
-  // 调用相同的函数
+  // 无需获取 `/api` 路由，可以直接
+  // 在 `getStaticProps` 中调用相同的函数
   const posts = await loadPosts()
 
   // 返回的 props 将传递给页面组件
@@ -172,7 +172,7 @@ export async function getStaticProps() {
 }
 ```
 
-或者，如果您**没有**使用 API 路由来获取数据，那么可以直接在 `getStaticProps` 中使用 [`fetch()`](https://developer.mozilla.org/docs/Web/API/Fetch_API) API 获取数据。
+或者，如果您 **没有** 使用 API 路由来获取数据，则可以直接在 `getStaticProps` 中使用 [`fetch()`](https://developer.mozilla.org/docs/Web/API/Fetch_API) API 获取数据。
 
 要验证 Next.js 从客户端包中移除了哪些内容，可以使用 [next-code-elimination 工具](https://next-code-elimination.vercel.app/)。
 
@@ -180,19 +180,19 @@ export async function getStaticProps() {
 
 当使用 `getStaticProps` 的页面在构建时预渲染时，除了页面 HTML 文件外，Next.js 还会生成一个包含 `getStaticProps` 运行结果的 JSON 文件。
 
-此 JSON 文件将通过 [`next/link`](/docs/pages/api-reference/components/link) 或 [`next/router`](/docs/pages/api-reference/functions/use-router) 用于客户端路由。当您导航到使用 `getStaticProps` 预渲染的页面时，Next.js 会获取此 JSON 文件（在构建时预先计算）并将其用作页面组件的 props。这意味着客户端页面转换**不会**调用 `getStaticProps`，因为只使用导出的 JSON。
+此 JSON 文件将通过 [`next/link`](/docs/pages/api-reference/components/link) 或 [`next/router`](/docs/pages/api-reference/functions/use-router) 用于客户端路由。当导航到使用 `getStaticProps` 预渲染的页面时，Next.js 会获取此 JSON 文件（在构建时预计算）并将其用作页面组件的 props。这意味着客户端页面转换 **不会** 调用 `getStaticProps`，因为只使用导出的 JSON。
 
 使用增量静态生成时，`getStaticProps` 将在后台执行以生成客户端导航所需的 JSON。您可能会看到对同一页面的多个请求，但这是预期的，不会影响最终用户的性能。
 
 ## 可以在何处使用 getStaticProps
 
-`getStaticProps` 只能从**页面**导出。您**不能**从非页面文件、`_app`、`_document` 或 `_error` 中导出它。
+`getStaticProps` 只能从 **页面** 导出。不能从非页面文件、`_app`、`_document` 或 `_error` 导出。
 
 此限制的原因之一是 React 需要在页面渲染之前拥有所有必需的数据。
 
-此外，您必须将 `getStaticProps` 作为独立函数导出 —— 如果将其添加为页面组件的属性，它将**不会**工作。
+此外，必须将 `getStaticProps` 作为独立函数导出 —— 如果将其作为页面组件的属性添加，它将 **不会** 工作。
 
-> **须知**：如果您创建了[自定义应用](/docs/pages/building-your-application/routing/custom-app)，请确保按照链接文档中的说明将 `pageProps` 传递给页面组件，否则 props 将为空。
+> **须知**：如果您创建了 [自定义应用](/docs/pages/building-your-application/routing/custom-app)，请确保按照链接文档中的说明将 `pageProps` 传递给页面组件，否则 props 将为空。
 
 ## 开发环境中的每次请求运行
 
@@ -200,4 +200,4 @@ export async function getStaticProps() {
 
 ## 预览模式
 
-您可以使用[**预览模式 (Preview Mode)**](/docs/pages/guides/preview-mode) 暂时绕过静态生成，在**请求时**而非构建时渲染页面。例如，您可能正在使用无头 CMS，并希望在草稿发布之前预览它们。
\ No newline at end of file
+您可以使用 [**预览模式**](/docs/pages/guides/preview-mode) 临时绕过静态生成，在 **请求时** 而非构建时渲染页面。例如，您可能正在使用无头 CMS 并希望在草稿发布前预览它们。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/03-get-server-side-props.mdx b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/03-get-server-side-props.mdx
index ad9b3d3a..ee91770b 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/03-get-server-side-props.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/03-building-your-application/03-data-fetching/03-get-server-side-props.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-20T22:20:28.038Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:18:22.698Z
 title: getServerSideProps
 description: 使用 `getServerSideProps` 在每次请求时获取数据。
 ---
@@ -58,41 +58,41 @@ export default function Page({ repo }) {
 
 ## 何时使用 `getServerSideProps`？
 
-如果您需要渲染依赖个性化用户数据或只能在请求时获取的信息（例如 `authorization` 请求头或地理位置），则应使用 `getServerSideProps`。
+如果您需要渲染依赖个性化用户数据或仅在请求时才能获取的信息的页面，应使用 `getServerSideProps`。例如 `authorization` 请求头或地理位置信息。
 
-如果不需要在请求时获取数据，或者希望缓存数据和预渲染的 HTML，建议使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)。
+如果不需要在请求时获取数据，或希望缓存数据和预渲染的 HTML，建议使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)。
 
 ## 行为
 
 - `getServerSideProps` 在服务端运行。
-- `getServerSideProps` 只能从**页面**中导出。
+- `getServerSideProps` 只能从 **页面** 中导出。
 - `getServerSideProps` 返回 JSON 数据。
-- 当用户访问页面时，`getServerSideProps` 会在请求时获取数据，并使用这些数据渲染页面的初始 HTML。
-- 传递给页面组件的 `props` 可以在客户端作为初始 HTML 的一部分查看。这是为了确保页面能正确进行[水合 (hydrate)](https://react.dev/reference/react-dom/hydrate)。请确保不要在 `props` 中传递任何不应在客户端可用的敏感信息。
+- 当用户访问页面时，`getServerSideProps` 会在请求时获取数据，并使用该数据渲染页面的初始 HTML。
+- 传递给页面组件的 `props` 可以在客户端作为初始 HTML 的一部分查看。这是为了让页面能够正确进行 [hydration (注水)](https://react.dev/reference/react-dom/hydrate)。请确保不要在 `props` 中传递任何不应在客户端可用的敏感信息。
 - 当用户通过 [`next/link`](/docs/pages/api-reference/components/link) 或 [`next/router`](/docs/pages/api-reference/functions/use-router) 访问页面时，Next.js 会向服务端发送 API 请求，该请求会运行 `getServerSideProps`。
-- 使用 `getServerSideProps` 时，无需调用 Next.js 的 [API 路由 (API Route)](/docs/pages/building-your-application/routing/api-routes) 来获取数据，因为该函数在服务端运行。您可以直接在 `getServerSideProps` 中调用 CMS、数据库或其他第三方 API。
+- 使用 `getServerSideProps` 时无需调用 Next.js 的 [API 路由](/docs/pages/building-your-application/routing/api-routes) 来获取数据，因为该函数在服务端运行。您可以直接在 `getServerSideProps` 中调用 CMS、数据库或其他第三方 API。
 
 > **须知：**
 >
-> - 有关 `getServerSideProps` 可用的参数和 props，请参阅 [`getServerSideProps` API 参考文档](/docs/pages/api-reference/functions/get-server-side-props)。
-> - 您可以使用 [next-code-elimination 工具](https://next-code-elimination.vercel.app/) 来验证 Next.js 从客户端包中移除了哪些代码。
+> - 查看 [`getServerSideProps` API 参考文档](/docs/pages/api-reference/functions/get-server-side-props) 了解可与 `getServerSideProps` 一起使用的参数和 props。
+> - 您可以使用 [next-code-elimination 工具](https://next-code-elimination.vercel.app/) 验证 Next.js 从客户端包中移除了哪些内容。
 
 ## 错误处理
 
-如果在 `getServerSideProps` 中抛出错误，将显示 `pages/500.js` 文件。查看 [500 页面](/docs/pages/building-your-application/routing/custom-error#500-page) 文档以了解如何创建它。在开发环境下，不会使用此文件，而是会显示开发错误覆盖层。
+如果在 `getServerSideProps` 中抛出错误，将显示 `pages/500.js` 文件。查看 [500 页面](/docs/pages/building-your-application/routing/custom-error#500-page) 文档了解如何创建此文件。在开发环境下，不会使用此文件，而是显示开发错误覆盖层。
 
 ## 边缘情况
 
 ### 服务端渲染 (SSR) 的缓存
 
-您可以在 `getServerSideProps` 中使用缓存头 (`Cache-Control`) 来缓存动态响应。例如，使用 [`stale-while-revalidate`](https://web.dev/stale-while-revalidate/)。
+您可以在 `getServerSideProps` 中使用缓存头 (`Cache-Control`) 来缓存动态响应。例如使用 [`stale-while-revalidate`](https://web.dev/stale-while-revalidate/)。
 
 ```jsx
 // 此值在十秒内被视为最新 (s-maxage=10)。
-// 如果在接下来的 10 秒内重复请求，将仍使用缓存的旧值。
-// 如果在 59 秒内重复请求，缓存的旧值将过期但仍会渲染 (stale-while-revalidate=59)。
+// 如果在接下来的 10 秒内重复请求，将仍然使用之前缓存的最新值。
+// 如果在 59 秒内重复请求，缓存的值将过时但仍会渲染 (stale-while-revalidate=59)。
 //
-// 在后台，会发起重新验证请求以用新值更新缓存。
+// 在后台，将发出重新验证请求以使用新值填充缓存。
 // 如果刷新页面，您将看到新值。
 export async function getServerSideProps({ req, res }) {
   res.setHeader(
@@ -106,4 +106,4 @@ export async function getServerSideProps({ req, res }) {
 }
 ```
 
-不过，在考虑使用 `cache-control` 之前，建议先评估 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 结合 [ISR (增量静态再生)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration) 是否更适合您的用例。
\ No newline at end of file
+不过，在决定使用 `cache-control` 之前，我们建议先评估 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 配合 [ISR (增量静态再生)](/docs/pages/guides/incremental-static-regeneration) 是否更适合您的使用场景。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-paths.mdx b/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-paths.mdx
index a9fc8df0..8fd372cf 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-paths.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-paths.mdx
@@ -1,11 +1,11 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:07:48.180Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:19:17.208Z
 title: getStaticPaths
-description: API `getStaticPaths`参考文档。了解如何使用 `getStaticPaths` 获取数据并生成静态页面。
+description: API `getStaticPaths` 参考文档。了解如何使用 `getStaticPaths` 获取数据并生成静态页面。
 ---
 
-当从使用了 [动态路由 (Dynamic Routes)](/docs/pages/building-your-application/routing/dynamic-routes) 的页面中导出一个名为 `getStaticPaths` 的函数时，Next.js 将静态预渲染 `getStaticPaths` 指定的所有路径。
+当从使用[动态路由 (Dynamic Routes)](/docs/pages/building-your-application/routing/dynamic-routes) 的页面中导出一个名为 `getStaticPaths` 的函数时，Next.js 会静态预渲染 `getStaticPaths` 指定的所有路径。
 
 ```tsx filename="pages/repo/[name].tsx" switcher
 import type {
@@ -78,7 +78,7 @@ export default function Page({ repo }) {
 
 ### `paths`
 
-`paths` 键决定了哪些路径会被预渲染。例如，假设你有一个使用 [动态路由 (Dynamic Routes)](/docs/pages/building-your-application/routing/dynamic-routes) 的页面 `pages/posts/[id].js`。如果你从该页面导出 `getStaticPaths` 并为 `paths` 返回以下内容：
+`paths` 键决定了哪些路径会被预渲染。例如，假设你有一个使用[动态路由 (Dynamic Routes)](/docs/pages/building-your-application/routing/dynamic-routes) 的页面 `pages/posts/[id].js`。如果你从该页面导出 `getStaticPaths` 并为 `paths` 返回以下内容：
 
 ```js
 return {
@@ -86,7 +86,7 @@ return {
     { params: { id: '1' }},
     {
       params: { id: '2' },
-      // 如果配置了国际化 (i18n)，还可以返回路径的语言环境
+      // 如果配置了 i18n，也可以返回路径的语言环境
       locale: "en",
     },
   ],
@@ -94,25 +94,25 @@ return {
 }
 ```
 
-那么，Next.js 将在 `next build` 时使用 `pages/posts/[id].js` 中的页面组件静态生成 `/posts/1` 和 `/posts/2`。
+那么，Next.js 将在 `next build` 期间使用 `pages/posts/[id].js` 中的页面组件静态生成 `/posts/1` 和 `/posts/2`。
 
 每个 `params` 对象的值必须与页面名称中使用的参数匹配：
 
 - 如果页面名称是 `pages/posts/[postId]/[commentId]`，则 `params` 应包含 `postId` 和 `commentId`。
-- 如果页面名称使用了 [全捕获路由 (catch-all routes)](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments)，例如 `pages/[...slug]`，则 `params` 应包含 `slug`（这是一个数组）。如果该数组是 `['hello', 'world']`，则 Next.js 将在 `/hello/world` 处静态生成页面。
-- 如果页面使用了 [可选全捕获路由 (optional catch-all route)](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments)，可以使用 `null`、`[]`、`undefined` 或 `false` 来渲染根路由。例如，如果你为 `pages/[[...slug]]` 提供 `slug: false`，Next.js 将静态生成页面 `/`。
+- 如果页面名称使用[全捕获路由 (catch-all routes)](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments) 如 `pages/[...slug]`，则 `params` 应包含 `slug`（这是一个数组）。如果该数组是 `['hello', 'world']`，那么 Next.js 将在 `/hello/world` 处静态生成页面。
+- 如果页面使用[可选全捕获路由 (optional catch-all route)](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments)，可以使用 `null`、`[]`、`undefined` 或 `false` 来渲染根路径。例如，如果你为 `pages/[[...slug]]` 提供 `slug: false`，Next.js 将静态生成页面 `/`。
 
-`params` 字符串是 **区分大小写** 的，理想情况下应进行规范化以确保路径正确生成。例如，如果参数返回 `WoRLD`，则仅当实际访问的路径是 `WoRLD` 时才会匹配，而不是 `world` 或 `World`。
+`params` 字符串是 **区分大小写** 的，理想情况下应进行规范化以确保路径正确生成。例如，如果为参数返回 `WoRLD`，则仅当访问的实际路径是 `WoRLD` 时才会匹配，而不是 `world` 或 `World`。
 
-除了 `params` 对象外，当 [配置了国际化 (i18n)](/docs/pages/building-your-application/routing/internationalization) 时，还可以返回一个 `locale` 字段，用于配置生成路径的语言环境。
+除了 `params` 对象外，当[配置了 i18n](/docs/pages/guides/internationalization) 时，还可以返回一个 `locale` 字段，用于配置生成路径的语言环境。
 
 ### `fallback: false`
 
 如果 `fallback` 为 `false`，则任何未由 `getStaticPaths` 返回的路径将导致 **404 页面**。
 
-当运行 `next build` 时，Next.js 会检查 `getStaticPaths` 是否返回了 `fallback: false`，然后仅构建由 `getStaticPaths` 返回的路径。此选项适用于需要创建的路径数量较少或新页面数据不经常添加的情况。如果你发现需要添加更多路径，并且设置了 `fallback: false`，则需要再次运行 `next build` 以生成新路径。
+当运行 `next build` 时，Next.js 会检查 `getStaticPaths` 是否返回了 `fallback: false`，然后仅构建 `getStaticPaths` 返回的路径。如果你需要创建的路径数量较少，或者新页面数据不经常添加，此选项很有用。如果你发现需要添加更多路径，并且你设置了 `fallback: false`，则需要再次运行 `next build` 以生成新路径。
 
-以下示例预渲染了名为 `pages/posts/[id].js` 的每篇博客文章。博客文章列表将从 CMS 获取并由 `getStaticPaths` 返回。然后，对于每个页面，使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 从 CMS 获取文章数据。
+以下示例预渲染了一个名为 `pages/posts/[id].js` 的每篇博客文章页面。博客文章列表将从 CMS 获取并由 `getStaticPaths` 返回。然后，对于每个页面，使用 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props) 从 CMS 获取文章数据。
 
 ```jsx filename="pages/posts/[id].js"
 function Post({ post }) {
@@ -137,8 +137,8 @@ export async function getStaticPaths() {
 
 // 此函数也在构建时调用
 export async function getStaticProps({ params }) {
-  // params 包含文章的 `id`。
-  // 如果路由是 /posts/1，则 params.id 为 1
+  // params 包含文章 `id`。
+  // 如果路由是 /posts/1，则 params.id 是 1
   const res = await fetch(`https://.../posts/${params.id}`)
   const post = await res.json()
 
@@ -160,48 +160,48 @@ export default Post
 
 如果 `fallback` 为 `true`，则 `getStaticProps` 的行为会发生以下变化：
 
-- `getStaticPaths` 返回的路径将在构建时由 `getStaticProps` 渲染为 `HTML`。
-- 未在构建时生成的路径 **不会** 导致 404 页面。相反，Next.js 将在首次请求此类路径时提供一个 [“后备”](#fallback-pages) 版本的页面。网络爬虫（如 Google）不会收到后备页面，而是会像 [`fallback: 'blocking'`](#fallback-blocking) 一样处理路径。
-- 当通过 `next/link` 或 `next/router`（客户端）导航到 `fallback: true` 的页面时，Next.js 将 **不会** 提供后备页面，而是会像 [`fallback: 'blocking'`](#fallback-blocking) 一样处理页面。
+- 由 `getStaticPaths` 返回的路径将在构建时由 `getStaticProps` 渲染为 `HTML`。
+- 未在构建时生成的路径 **不会** 导致 404 页面。相反，Next.js 将在首次请求此类路径时提供一个[“回退”](#fallback-pages)版本的页面。Google 等网络爬虫不会被提供回退页面，而是会像 [`fallback: 'blocking'`](#fallback-blocking) 一样处理路径。
+- 当通过 `next/link` 或 `next/router`（客户端）导航到 `fallback: true` 的页面时，Next.js 将 **不会** 提供回退页面，而是会像 [`fallback: 'blocking'`](#fallback-blocking) 一样处理页面。
 - 在后台，Next.js 将静态生成请求路径的 `HTML` 和 `JSON`。这包括运行 `getStaticProps`。
-- 完成后，浏览器将收到生成路径的 `JSON`。这将用于自动渲染具有所需 props 的页面。从用户的角度来看，页面将从后备页面切换到完整页面。
-- 同时，Next.js 将此路径添加到预渲染页面的列表中。对同一路径的后续请求将像其他在构建时预渲染的页面一样提供生成的页面。
+- 完成后，浏览器会收到生成路径的 `JSON`。这将用于自动渲染具有所需 props 的页面。从用户的角度来看，页面将从回退页面切换到完整页面。
+- 同时，Next.js 将此路径添加到预渲染页面列表中。对同一路径的后续请求将像其他在构建时预渲染的页面一样提供生成的页面。
 
-> **须知**：当使用 [`output: 'export'`](/docs/pages/guides/static-exports) 时，不支持 `fallback: true`。
+> **须知**：使用 [`output: 'export'`](/docs/pages/guides/static-exports) 时不支持 `fallback: true`。
 
 #### 何时使用 `fallback: true`？
 
-`fallback: true` 适用于具有大量依赖数据的静态页面的应用（例如非常大的电子商务网站）。如果你想预渲染所有产品页面，构建时间会非常长。
+`fallback: true` 适用于具有大量依赖数据的静态页面（例如大型电子商务网站）。如果你想预渲染所有产品页面，构建将花费很长时间。
 
 相反，你可以静态生成一小部分页面，并对其余页面使用 `fallback: true`。当有人请求尚未生成的页面时，用户将看到一个带有加载指示器或骨架组件的页面。
 
-不久之后，`getStaticProps` 完成，页面将使用请求的数据渲染。从现在开始，任何请求同一页面的人都将获得静态预渲染的页面。
+不久之后，`getStaticProps` 完成，页面将使用请求的数据渲染。从此时起，任何请求同一页面的人都将获得静态预渲染的页面。
 
-这确保了用户始终获得快速的体验，同时保持快速构建和静态生成的优势。
+这确保了用户始终拥有快速的体验，同时保持了快速构建和静态生成的优势。
 
-`fallback: true` 不会 **更新** 已生成的页面，如需更新，请参阅 [增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)。
+`fallback: true` 不会 **更新** 生成的页面，如需更新生成的页面，请参阅[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration)。
 
 ### `fallback: 'blocking'`
 
-如果 `fallback` 为 `'blocking'`，则未由 `getStaticPaths` 返回的新路径将等待 `HTML` 生成（因此称为 _阻塞_），然后缓存以供将来请求，因此每个路径仅发生一次。
+如果 `fallback` 为 `'blocking'`，则未由 `getStaticPaths` 返回的新路径将等待 `HTML` 生成（因此称为 _阻塞_），然后缓存以供将来请求使用，因此每个路径仅发生一次。
 
 `getStaticProps` 的行为如下：
 
-- `getStaticPaths` 返回的路径将在构建时由 `getStaticProps` 渲染为 `HTML`。
-- 未在构建时生成的路径 **不会** 导致 404 页面。相反，Next.js 将在首次请求时进行 SSR 并返回生成的 `HTML`。
-- 完成后，浏览器将收到生成路径的 `HTML`。从用户的角度来看，它将从“浏览器正在请求页面”过渡到“完整页面已加载”。没有加载/后备状态的闪烁。
-- 同时，Next.js 将此路径添加到预渲染页面的列表中。对同一路径的后续请求将像其他在构建时预渲染的页面一样提供生成的页面。
+- 由 `getStaticPaths` 返回的路径将在构建时由 `getStaticProps` 渲染为 `HTML`。
+- 未在构建时生成的路径 **不会** 导致 404 页面。相反，Next.js 将在首次请求时 SSR 并返回生成的 `HTML`。
+- 完成后，浏览器会收到生成路径的 `HTML`。从用户的角度来看，它将从“浏览器正在请求页面”过渡到“完整页面已加载”。没有加载/回退状态的闪烁。
+- 同时，Next.js 将此路径添加到预渲染页面列表中。对同一路径的后续请求将像其他在构建时预渲染的页面一样提供生成的页面。
 
-默认情况下，`fallback: 'blocking'` 不会 **更新** 已生成的页面。要更新生成的页面，请结合使用 [增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration) 和 `fallback: 'blocking'`。
+默认情况下，`fallback: 'blocking'` 不会 **更新** 生成的页面。要更新生成的页面，请结合使用[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration) 和 `fallback: 'blocking'`。
 
-> **须知**：当使用 [`output: 'export'`](/docs/pages/guides/static-exports) 时，不支持 `fallback: 'blocking'`。
+> **须知**：使用 [`output: 'export'`](/docs/pages/guides/static-exports) 时不支持 `fallback: 'blocking'`。
 
-### 后备页面
+### 回退页面
 
-在页面的“后备”版本中：
+在页面的“回退”版本中：
 
 - 页面的 props 将为空。
-- 使用 [router](/docs/pages/api-reference/functions/use-router)，你可以检测是否正在渲染后备页面，`router.isFallback` 将为 `true`。
+- 使用[路由器 (router)](/docs/pages/api-reference/functions/use-router)，你可以检测是否正在渲染回退页面，`router.isFallback` 将为 `true`。
 
 以下示例展示了如何使用 `isFallback`：
 
@@ -233,15 +233,15 @@ export async function getStaticPaths() {
 
 // 此函数也在构建时调用
 export async function getStaticProps({ params }) {
-  // params 包含文章的 `id`。
-  // 如果路由是 /posts/1，则 params.id 为 1
+  // params 包含文章 `id`。
+  // 如果路由是 /posts/1，则 params.id 是 1
   const res = await fetch(`https://.../posts/${params.id}`)
   const post = await res.json()
 
   // 通过 props 将文章数据传递给页面
   return {
     props: { post },
-    // 如果收到请求，最多每秒重新生成文章一次
+    // 如果请求到来，最多每秒重新生成文章一次
     revalidate: 1,
   }
 }
@@ -253,8 +253,8 @@ export default Post
 
 | 版本       | 变更                                                                                                                                                                                                     |
 | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `v13.4.0` | [应用路由 (App Router)](/docs/app/building-your-application/data-fetching) 现已稳定，包含简化的数据获取，包括 [`generateStaticParams()`](/docs/app/api-reference/functions/generate-static-params) |
-| `v12.2.0` | [按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 稳定。                      |
-| `v12.1.0` | 添加了 [按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)（测试版）。                   |
-| `v9.5.0`  | 稳定的 [增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)                                                                               |
+| `v13.4.0` | [应用路由 (App Router)](/docs/app/building-your-application/data-fetching) 现已稳定，简化了数据获取，包括 [`generateStaticParams()`](/docs/app/api-reference/functions/generate-static-params) |
+| `v12.2.0` | [按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 稳定。                                                       |
+| `v12.1.0` | 添加了[按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)（测试版）。                                                    |
+| `v9.5.0`  | 稳定的[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration)                                                                                                                |
 | `v9.3.0`  | 引入 `getStaticPaths`。                                                                                                                                                                                |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-props.mdx b/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-props.mdx
index a9013705..9a1a63f9 100644
--- a/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-props.mdx
+++ b/apps/docs/content/zh-hans/docs/02-pages/04-api-reference/03-functions/get-static-props.mdx
@@ -1,6 +1,6 @@
 ---
-source-updated-at: 2025-05-16T04:52:11.000Z
-translation-updated-at: 2025-05-19T23:07:22.685Z
+source-updated-at: 2025-05-21T18:33:43.000Z
+translation-updated-at: 2025-05-21T19:18:42.033Z
 title: getStaticProps
 description: API `getStaticProps` 参考文档。了解如何使用 `getStaticProps` 在 Next.js 中生成静态页面。
 ---
@@ -42,30 +42,30 @@ export default function Page({ repo }) {
 }
 ```
 
-你可以在顶层作用域导入模块以在 `getStaticProps` 中使用。这些导入的模块**不会被打包到客户端**。这意味着你可以直接在 `getStaticProps` 中编写**服务端代码**，包括从数据库获取数据。
+你可以在顶层作用域导入模块用于 `getStaticProps`。使用的导入内容**不会打包到客户端**。这意味着你可以直接在 `getStaticProps` 中编写**服务端代码**，包括从数据库获取数据。
 
 ## Context 参数
 
 `context` 参数是一个包含以下键的对象：
 
-| 名称               | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `params`           | 包含使用[动态路由](/docs/pages/building-your-application/routing/dynamic-routes)的页面的路由参数。例如，如果页面名称是 `[id].js`，那么 `params` 将类似于 `{ id: ... }`。你应该将此与 `getStaticPaths` 一起使用，我们稍后会解释。                                                                                                                                                                  |
-| `preview`          | (已弃用，改用 `draftMode`) 如果页面处于[预览模式 (Preview Mode)](/docs/pages/guides/preview-mode)，则 `preview` 为 `true`，否则为 `false`。                                                                                                                                                                                                                                                                                                                         |
-| `previewData`      | (已弃用，改用 `draftMode`) 由 `setPreviewData` 设置的[预览 (preview)](/docs/pages/guides/preview-mode) 数据。                                                                                                                                                                                                                                                                                                                                                             |
-| `draftMode`        | 如果页面处于[草稿模式 (Draft Mode)](/docs/pages/guides/draft-mode)，则 `draftMode` 为 `true`，否则为 `false`。                                                                                                                                                                                                                                                                                                                                                        |
-| `locale`           | 包含当前活动的语言环境（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| `locales`          | 包含所有支持的语言环境（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| `defaultLocale`    | 包含配置的默认语言环境（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| `revalidateReason` | 提供函数被调用的原因。可能的值有："build"（在构建时运行）、"stale"（重新验证周期已过期，或在[开发模式 (development mode)](/docs/pages/building-your-application/data-fetching/get-static-props#runs-on-every-request-in-development) 中运行）、"on-demand"（通过[按需重新验证 (on-demand revalidation)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 触发） |
+| 名称               | 描述                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `params`           | 包含使用[动态路由](/docs/pages/building-your-application/routing/dynamic-routes)的页面的路由参数。例如，如果页面名称是 `[id].js`，那么 `params` 将类似于 `{ id: ... }`。你应该将其与 `getStaticPaths` 一起使用，我们稍后会解释。                                                                                                                                 |
+| `preview`          | (已弃用，改用 `draftMode`) 如果页面处于[预览模式](/docs/pages/guides/preview-mode)，则 `preview` 为 `true`，否则为 `false`。                                                                                                                                                                                                                                                                                        |
+| `previewData`      | (已弃用，改用 `draftMode`) 由 `setPreviewData` 设置的[预览](/docs/pages/guides/preview-mode)数据。                                                                                                                                                                                                                                                                                                                            |
+| `draftMode`        | 如果页面处于[草稿模式](/docs/pages/guides/draft-mode)，则 `draftMode` 为 `true`，否则为 `false`。                                                                                                                                                                                                                                                                                                                       |
+| `locale`           | 包含当前活动的区域设置（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                             |
+| `locales`          | 包含所有支持的区域设置（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                         |
+| `defaultLocale`    | 包含配置的默认区域设置（如果启用）。                                                                                                                                                                                                                                                                                                                                                                                 |
+| `revalidateReason` | 提供函数被调用的原因。可能的值包括："build"（在构建时运行）、"stale"（重新验证周期已过期，或在[开发模式](/docs/pages/building-your-application/data-fetching/get-static-props#runs-on-every-request-in-development)下运行）、"on-demand"（通过[按需重新验证](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)触发） |
 
 ## getStaticProps 返回值
 
-`getStaticProps` 函数应返回一个包含 `props`、`redirect` 或 `notFound` 的对象，后跟一个**可选的** `revalidate` 属性。
+`getStaticProps` 函数应返回一个包含 `props`、`redirect` 或 `notFound` 的对象，后跟一个**可选**的 `revalidate` 属性。
 
 ### `props`
 
-`props` 对象是一个键值对，其中每个值都会被页面组件接收。它应该是一个[可序列化对象 (serializable object)](https://developer.mozilla.org/docs/Glossary/Serialization)，以便传递的任何 props 都可以通过 [`JSON.stringify`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) 序列化。
+`props` 对象是一个键值对，其中每个值都由页面组件接收。它应该是一个[可序列化对象](https://developer.mozilla.org/docs/Glossary/Serialization)，以便传递的任何 props 都可以使用 [`JSON.stringify`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) 序列化。
 
 ```jsx
 export async function getStaticProps(context) {
@@ -98,7 +98,7 @@ export async function getStaticProps() {
 }
 ```
 
-了解更多关于[增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)。
+了解更多关于[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration)。
 
 利用 ISR 的页面的缓存状态可以通过读取 `x-nextjs-cache` 响应头的值来确定。可能的值如下：
 
@@ -108,7 +108,7 @@ export async function getStaticProps() {
 
 ### `notFound`
 
-`notFound` 布尔值允许页面返回 `404` 状态和[404 页面 (404 Page)](/docs/pages/building-your-application/routing/custom-error#404-page)。当 `notFound: true` 时，即使之前成功生成了页面，页面也会返回 `404`。这旨在支持诸如用户生成内容被作者删除等用例。注意，`notFound` 遵循与[此处描述的](#revalidate)相同的 `revalidate` 行为。
+`notFound` 布尔值允许页面返回 `404` 状态和[404 页面](/docs/pages/building-your-application/routing/custom-error#404-page)。使用 `notFound: true`，即使之前成功生成了页面，页面也会返回 `404`。这旨在支持诸如用户生成内容被其作者删除等用例。注意，`notFound` 遵循与[此处描述](#revalidate)相同的 `revalidate` 行为。
 
 ```js
 export async function getStaticProps(context) {
@@ -127,13 +127,13 @@ export async function getStaticProps(context) {
 }
 ```
 
-> **须知**：对于 [`fallback: false`](/docs/pages/api-reference/functions/get-static-paths#fallback-false) 模式，不需要 `notFound`，因为只有从 `getStaticPaths` 返回的路径会被预渲染。
+> **须知**：对于 [`fallback: false`](/docs/pages/api-reference/functions/get-static-paths#fallback-false) 模式不需要 `notFound`，因为只有从 `getStaticPaths` 返回的路径才会被预渲染。
 
 ### `redirect`
 
 `redirect` 对象允许重定向到内部或外部资源。它应匹配 `{ destination: string, permanent: boolean }` 的形状。
 
-在一些罕见情况下，你可能需要为旧的 `HTTP` 客户端分配自定义状态码以正确重定向。在这些情况下，你可以使用 `statusCode` 属性代替 `permanent` 属性，**但不能同时使用两者**。你也可以设置 `basePath: false`，类似于 `next.config.js` 中的重定向。
+在极少数情况下，你可能需要为旧的 `HTTP` 客户端分配自定义状态码以正确重定向。在这些情况下，你可以使用 `statusCode` 属性而不是 `permanent` 属性，**但不能同时使用两者**。你也可以像 `next.config.js` 中的重定向一样设置 `basePath: false`。
 
 ```js
 export async function getStaticProps(context) {
@@ -156,7 +156,7 @@ export async function getStaticProps(context) {
 }
 ```
 
-如果重定向在构建时已知，应改为添加到 [`next.config.js`](/docs/pages/api-reference/config/next-config-js/redirects) 中。
+如果重定向在构建时已知，应将其添加到 [`next.config.js`](/docs/pages/api-reference/config/next-config-js/redirects) 中。
 
 ## 读取文件：使用 `process.cwd()`
 
@@ -197,8 +197,8 @@ export async function getStaticProps() {
     const filePath = path.join(postsDirectory, filename)
     const fileContents = await fs.readFile(filePath, 'utf8')
 
-    // 通常你会在这里解析/转换内容
-    // 例如，你可以将 markdown 转换为 HTML
+    // 通常你会解析/转换内容
+    // 例如你可以在这里将 markdown 转换为 HTML
 
     return {
       filename,
@@ -206,7 +206,7 @@ export async function getStaticProps() {
     }
   })
   // 通过返回 { props: { posts } }，Blog 组件
-  // 将在构建时接收到 `posts` 作为 props
+  // 将在构建时接收 `posts` 作为 props
   return {
     props: {
       posts: await Promise.all(posts),
@@ -219,12 +219,12 @@ export default Blog
 
 ## 版本历史
 
-| 版本      | 变更                                                                                                                                                                                   |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `v13.4.0` | [应用路由 (App Router)](/docs/app/building-your-application/data-fetching) 现已稳定，并简化了数据获取                                                                               |
-| `v12.2.0` | [按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 稳定。    |
-| `v12.1.0` | 添加了[按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)（测试版）。 |
-| `v10.0.0` | 添加了 `locale`、`locales`、`defaultLocale` 和 `notFound` 选项。                                                                                                                       |
-| `v10.0.0` | 添加了 `fallback: 'blocking'` 返回选项。                                                                                                                                               |
-| `v9.5.0`  | 稳定的[增量静态再生 (Incremental Static Regeneration)](/docs/pages/building-your-application/data-fetching/incremental-static-regeneration)                                                             |
-| `v9.3.0`  | 引入了 `getStaticProps`。                                                                                                                                                              |
\ No newline at end of file
+| 版本      | 变更                                                                                                                                                  |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `v13.4.0` | [应用路由 (App Router)](/docs/app/building-your-application/data-fetching) 现已稳定，并简化了数据获取                                              |
+| `v12.2.0` | [按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath) 稳定。    |
+| `v12.1.0` | 添加了[按需增量静态再生 (On-Demand Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath)（测试版）。 |
+| `v10.0.0` | 添加了 `locale`、`locales`、`defaultLocale` 和 `notFound` 选项。                                                                                      |
+| `v10.0.0` | 添加了 `fallback: 'blocking'` 返回选项。                                                                                                              |
+| `v9.5.0`  | 稳定的[增量静态再生 (Incremental Static Regeneration)](/docs/pages/guides/incremental-static-regeneration)                                                             |
+| `v9.3.0`  | 引入了 `getStaticProps`。                                                                                                                             |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/01-getting-started/01-installation.mdx b/apps/docs/content/zh-hans/docs/13/01-getting-started/01-installation.mdx
new file mode 100644
index 00000000..358d2875
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/01-getting-started/01-installation.mdx
@@ -0,0 +1,194 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:15:03.122Z
+title: 安装指南
+description: 使用 `create-next-app` 创建新的 Next.js 应用。配置 TypeScript、样式以及 `next.config.js` 文件。
+related:
+  title: 后续步骤
+  description: 了解 Next.js 项目中的文件与目录结构。
+  links:
+    - getting-started/project-structure
+---
+
+系统要求：
+
+- [Node.js 16.14](https://nodejs.org/) 或更高版本
+- 支持 macOS、Windows（包括 WSL）和 Linux 系统
+
+## 自动安装
+
+推荐使用 [`create-next-app`](/docs/app/api-reference/create-next-app) 创建新项目，该工具会自动完成所有初始化配置。执行以下命令创建项目：
+
+```bash filename="终端"
+npx create-next-app@latest
+```
+
+安装过程中会看到以下选项提示：
+
+```txt filename="终端"
+请输入项目名称？my-app
+是否使用 TypeScript？否 / 是
+是否使用 ESLint？否 / 是
+是否使用 Tailwind CSS？否 / 是
+是否使用 `src/` 目录？否 / 是
+是否使用 App Router？（推荐）否 / 是
+是否自定义默认导入别名 (@/*)？否 / 是
+请输入需要配置的导入别名？@/*
+```
+
+完成选择后，`create-next-app` 会创建项目文件夹并安装所需依赖。
+
+> **须知**：
+>
+> - Next.js 现已默认集成 [TypeScript](/docs/app/building-your-application/configuring/typescript)、[ESLint](/docs/app/building-your-application/configuring/eslint) 和 [Tailwind CSS](/docs/app/building-your-application/styling/tailwind-css) 配置
+> - 可选择使用 [`src` 目录](/docs/app/building-your-application/configuring/src-directory) 将应用代码与配置文件分离
+
+## 手动安装
+
+手动创建 Next.js 项目需先安装必要依赖包：
+
+```bash filename="终端"
+npm install next@latest react@latest react-dom@latest
+```
+
+在 `package.json` 中添加以下运行脚本：
+
+```json filename="package.json"
+{
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  }
+}
+```
+
+这些脚本对应不同的开发阶段：
+
+- `dev`: 执行 [`next dev`](/docs/app/api-reference/next-cli#development) 启动开发模式
+- `build`: 执行 [`next build`](/docs/app/api-reference/next-cli#build) 构建生产环境应用
+- `start`: 执行 [`next start`](/docs/app/api-reference/next-cli#production) 启动生产服务器
+- `lint`: 执行 [`next lint`](/docs/app/api-reference/next-cli#lint) 配置内置 ESLint
+
+### 创建目录结构
+
+Next.js 采用文件系统路由，应用路由由文件结构决定。
+
+#### `app` 目录（推荐）
+
+新项目建议使用 [App Router](/docs/app)。该路由支持 React 最新特性，是根据社区反馈对 [Pages Router](/docs/pages) 的演进。
+
+创建 `app/` 目录后，需添加 `layout.tsx` 和 `page.tsx` 文件，这些文件会在用户访问根路径 (`/`) 时渲染。
+
+<Image
+  alt="App 目录结构"
+  srcLight="/docs/light/app-getting-started.png"
+  srcDark="/docs/dark/app-getting-started.png"
+  width="1600"
+  height="363"
+/>
+
+在 `app/layout.tsx` 中创建包含必需 `<html>` 和 `<body>` 标签的 [根布局](/docs/app/building-your-application/routing/pages-and-layouts#root-layout-required)：
+
+```tsx filename="app/layout.tsx" switcher
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+```
+
+```jsx filename="app/layout.js" switcher
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+```
+
+最后在 `app/page.tsx` 创建首页内容：
+
+```tsx filename="app/page.tsx" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+```jsx filename="app/page.js" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+> **须知**：如果忘记创建 `layout.tsx`，执行 `next dev` 启动开发服务器时 Next.js 会自动生成该文件。
+
+了解更多关于 [App Router 的使用](/docs/app/building-your-application/routing/defining-routes)。
+
+#### `pages` 目录（可选）
+
+如需使用 Pages Router 而非 App Router，可在项目根目录创建 `pages/` 文件夹。
+
+然后在 `pages` 目录中添加 `index.tsx` 作为首页 (`/`)：
+
+```tsx filename="pages/index.tsx" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+接着在 `pages/` 下创建 `_app.tsx` 定义全局布局，详见 [自定义 App 文件](/docs/pages/building-your-application/routing/custom-app)。
+
+```tsx filename="pages/_app.tsx" switcher
+import type { AppProps } from 'next/app'
+
+export default function App({ Component, pageProps }: AppProps) {
+  return <Component {...pageProps} />
+}
+```
+
+```jsx filename="pages/_app.js" switcher
+export default function App({ Component, pageProps }) {
+  return <Component {...pageProps} />
+}
+```
+
+最后添加 `_document.tsx` 控制服务端初始响应，详见 [自定义 Document 文件](/docs/pages/building-your-application/routing/custom-document)。
+
+```tsx filename="pages/_document.tsx" switcher
+import { Html, Head, Main, NextScript } from 'next/document'
+
+export default function Document() {
+  return (
+    <Html>
+      <Head />
+      <body>
+        <Main />
+        <NextScript />
+      </body>
+    </Html>
+  )
+}
+```
+
+了解更多关于 [Pages Router 的使用](/docs/pages/building-your-application/routing/pages-and-layouts)。
+
+> **须知**：虽然可以在同一项目中同时使用两种路由，但 `app` 目录下的路由优先级高于 `pages`。建议新项目只使用一种路由以避免混淆。
+
+#### `public` 目录（可选）
+
+创建 `public` 文件夹存放图片、字体等静态资源，这些文件可通过根路径 (`/`) 直接引用。
+
+## 启动开发服务器
+
+1. 执行 `npm run dev` 启动开发服务器
+2. 访问 `http://localhost:3000` 查看应用
+3. 修改 `app/layout.tsx`（或 `pages/index.tsx`）文件并保存，浏览器会自动更新变化
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/01-getting-started/02-project-structure.mdx b/apps/docs/content/zh-hans/docs/13/01-getting-started/02-project-structure.mdx
new file mode 100644
index 00000000..989b251d
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/01-getting-started/02-project-structure.mdx
@@ -0,0 +1,151 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:15:45.325Z
+title: Next.js 项目结构
+nav_title: 项目结构
+description: Next.js 项目中的文件夹与文件约定列表
+---
+
+本文档概述了 Next.js 项目的文件与文件夹结构，涵盖顶层文件与文件夹、配置文件，以及 `app` 和 `pages` 目录中的路由约定。
+
+## 顶层文件夹
+
+|                                                                          |                                    |
+| ------------------------------------------------------------------------ | ---------------------------------- |
+| [`app`](/docs/app/building-your-application/routing)                     | 应用路由 (App Router)              |
+| [`pages`](/docs/pages/building-your-application/routing)                 | 页面路由 (Pages Router)            |
+| [`public`](/docs/app/building-your-application/optimizing/static-assets) | 待托管的静态资源                   |
+| [`src`](/docs/app/building-your-application/configuring/src-directory)   | 可选的应用程序源码目录             |
+
+## 顶层文件
+
+|                                                                                             |                                         |
+| ------------------------------------------------------------------------------------------- | --------------------------------------- |
+| **Next.js**                                                                                 |                                         |
+| [`next.config.js`](/docs/app/api-reference/next-config-js)                                  | Next.js 配置文件                        |
+| [`package.json`](/docs/getting-started/installation#manual-installation)                    | 项目依赖与脚本                          |
+| [`instrumentation.ts`](/docs/app/building-your-application/optimizing/instrumentation)      | OpenTelemetry 与性能监控文件            |
+| [`middleware.ts`](/docs/app/building-your-application/routing/middleware)                   | Next.js 请求中间件                      |
+| [`.env`](/docs/app/building-your-application/configuring/environment-variables)             | 环境变量                                |
+| [`.env.local`](/docs/app/building-your-application/configuring/environment-variables)       | 本地环境变量                            |
+| [`.env.production`](/docs/app/building-your-application/configuring/environment-variables)  | 生产环境变量                            |
+| [`.env.development`](/docs/app/building-your-application/configuring/environment-variables) | 开发环境变量                            |
+| [`.eslintrc.json`](/docs/app/building-your-application/configuring/eslint)                  | ESLint 配置文件                         |
+| `.gitignore`                                                                                | Git 忽略文件列表                        |
+| `next-env.d.ts`                                                                             | Next.js 的 TypeScript 声明文件          |
+| `tsconfig.json`                                                                             | TypeScript 配置文件                     |
+| `jsconfig.json`                                                                             | JavaScript 配置文件                     |
+
+## `app` 路由约定
+
+### 路由文件
+
+|                                                                                 |                     |                              |
+| ------------------------------------------------------------------------------- | ------------------- | ---------------------------- |
+| [`layout`](/docs/app/api-reference/file-conventions/layout)                     | `.js` `.jsx` `.tsx` | 布局文件                     |
+| [`page`](/docs/app/api-reference/file-conventions/page)                         | `.js` `.jsx` `.tsx` | 页面文件                     |
+| [`loading`](/docs/app/api-reference/file-conventions/loading)                   | `.js` `.jsx` `.tsx` | 加载状态 UI                  |
+| [`not-found`](/docs/app/api-reference/file-conventions/not-found)               | `.js` `.jsx` `.tsx` | 404 页面 UI                  |
+| [`error`](/docs/app/api-reference/file-conventions/error)                       | `.js` `.jsx` `.tsx` | 错误页面 UI                  |
+| [`global-error`](/docs/app/api-reference/file-conventions/error#global-errorjs) | `.js` `.jsx` `.tsx` | 全局错误 UI                  |
+| [`route`](/docs/app/api-reference/file-conventions/route)                       | `.js` `.ts`         | API 端点                     |
+| [`template`](/docs/app/api-reference/file-conventions/template)                 | `.js` `.jsx` `.tsx` | 可重渲染的布局               |
+| [`default`](/docs/app/api-reference/file-conventions/default)                   | `.js` `.jsx` `.tsx` | 并行路由的备用页面           |
+
+### 嵌套路由
+
+|                                                                              |                      |
+| ---------------------------------------------------------------------------- | -------------------- |
+| [`folder`](/docs/app/building-your-application/routing#route-segments)       | 路由片段             |
+| [`folder/folder`](/docs/app/building-your-application/routing#nested-routes) | 嵌套路由片段         |
+
+### 动态路由
+
+|                                                                                                           |                                  |
+| --------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| [`[folder]`](/docs/app/building-your-application/routing/dynamic-routes#convention)                       | 动态路由片段                     |
+| [`[...folder]`](/docs/app/building-your-application/routing/dynamic-routes#catch-all-segments)            | 全捕获路由片段                   |
+| [`[[...folder]]`](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments) | 可选全捕获路由片段               |
+
+### 路由组与私有文件夹
+
+|                                                                                     |                                                  |
+| ----------------------------------------------------------------------------------- | ------------------------------------------------ |
+| [`(folder)`](/docs/app/building-your-application/routing/route-groups#convention)   | 不影响路由的分组文件夹                           |
+| [`_folder`](/docs/app/building-your-application/routing/colocation#private-folders) | 将文件夹及其子片段排除在路由系统外               |
+
+### 并行与拦截路由
+
+|                                                                                                |                            |
+| ---------------------------------------------------------------------------------------------- | -------------------------- |
+| [`@folder`](/docs/app/building-your-application/routing/parallel-routes#convention)            | 命名插槽                   |
+| [`(.)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)      | 拦截同级路由               |
+| [`(..)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)     | 拦截上一级路由             |
+| [`(..)(..)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention) | 拦截上两级路由             |
+| [`(...)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)    | 从根目录拦截路由           |
+
+### 元数据文件约定
+
+#### 应用图标
+
+|                                                                                                                 |                                     |                          |
+| --------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------------------ |
+| [`favicon`](/docs/app/api-reference/file-conventions/metadata/app-icons#favicon)                                | `.ico`                              | 网站图标文件             |
+| [`icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#icon)                                      | `.ico` `.jpg` `.jpeg` `.png` `.svg` | 应用图标文件             |
+| [`icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx)       | `.js` `.ts` `.tsx`                  | 动态生成的应用图标       |
+| [`apple-icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#apple-icon)                          | `.jpg` `.jpeg`, `.png`              | Apple 应用图标文件       |
+| [`apple-icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx) | `.js` `.ts` `.tsx`                  | 动态生成的 Apple 应用图标 |
+
+#### Open Graph 与 Twitter 图片
+
+|                                                                                                                             |                              |                            |
+| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------- |
+| [`opengraph-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#opengraph-image)                      | `.jpg` `.jpeg` `.png` `.gif` | Open Graph 图片文件        |
+| [`opengraph-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#generate-images-using-code-js-ts-tsx) | `.js` `.ts` `.tsx`           | 动态生成的 Open Graph 图片 |
+| [`twitter-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#twitter-image)                          | `.jpg` `.jpeg` `.png` `.gif` | Twitter 图片文件           |
+| [`twitter-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#generate-images-using-code-js-ts-tsx)   | `.js` `.ts` `.tsx`           | 动态生成的 Twitter 图片    |
+
+#### SEO
+
+|                                                                                             |             |                       |
+| ------------------------------------------------------------------------------------------- | ----------- | --------------------- |
+| [`sitemap`](/docs/app/api-reference/file-conventions/metadata/sitemap#static-sitemapxml)    | `.xml`      | 站点地图文件          |
+| [`sitemap`](/docs/app/api-reference/file-conventions/metadata/sitemap#generate-a-sitemap)   | `.js` `.ts` | 动态生成的站点地图    |
+| [`robots`](/docs/app/api-reference/file-conventions/metadata/robots#static-robotstxt)       | `.txt`      | Robots 文件           |
+| [`robots`](/docs/app/api-reference/file-conventions/metadata/robots#generate-a-robots-file) | `.js` `.ts` | 动态生成的 Robots 文件 |
+
+## `pages` 路由约定
+
+### 特殊文件
+
+|                                                                                                             |                     |                   |
+| ----------------------------------------------------------------------------------------------------------- | ------------------- | ----------------- |
+| [`_app`](/docs/pages/building-your-application/routing/custom-app)                                          | `.js` `.jsx` `.tsx` | 自定义 App        |
+| [`_document`](/docs/pages/building-your-application/routing/custom-document)                                | `.js` `.jsx` `.tsx` | 自定义 Document   |
+| [`_error`](/docs/pages/building-your-application/routing/custom-error#more-advanced-error-page-customizing) | `.js` `.jsx` `.tsx` | 自定义错误页面    |
+| [`404`](/docs/pages/building-your-application/routing/custom-error#404-page)                                | `.js` `.jsx` `.tsx` | 404 错误页面      |
+| [`500`](/docs/pages/building-your-application/routing/custom-error#500-page)                                | `.js` `.jsx` `.tsx` | 500 错误页面      |
+
+### 路由
+
+|                                                                                                |                     |             |
+| ---------------------------------------------------------------------------------------------- | ------------------- | ----------- |
+| **文件夹约定**                                                                                 |                     |             |
+| [`index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes)        | `.js` `.jsx` `.tsx` | 首页        |
+| [`folder/index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes) | `.js` `.jsx` `.tsx` | 嵌套页面    |
+| **文件约定**                                                                                   |                     |             |
+| [`index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes)        | `.js` `.jsx` `.tsx` | 首页        |
+| [`file`](/docs/pages/building-your-application/routing/pages-and-layouts)                      | `.js` `.jsx` `.tsx` | 嵌套页面    |
+
+### 动态路由
+
+|                                                                                                                   |                     |                                  |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------- | -------------------------------- |
+| **文件夹约定**                                                                                                    |                     |                                  |
+| [`[folder]/index`](/docs/pages/building-your-application/routing/dynamic-routes)                                  | `.js` `.jsx` `.tsx` | 动态路由片段                     |
+| [`[...folder]/index`](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments)            | `.js` `.jsx` `.tsx` | 全捕获路由片段                   |
+| [`[[...folder]]/index`](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments) | `.js` `.jsx` `.tsx` | 可选全捕获路由片段               |
+| **文件约定**                                                                                                      |                     |                                  |
+| [`[file]`](/docs/pages/building-your-application/routing/dynamic-routes)                                          | `.js` `.jsx` `.tsx` | 动态路由片段                     |
+| [`[...file]`](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments)                    | `.js` `.jsx` `.tsx` | 全捕获路由片段                   |
+| [`[[...file]]`](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments)         | `.js` `.jsx` `.tsx` | 可选全捕获路由片段               |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/01-getting-started/index.mdx b/apps/docs/content/zh-hans/docs/13/01-getting-started/index.mdx
new file mode 100644
index 00000000..d5dcb5df
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/01-getting-started/index.mdx
@@ -0,0 +1,6 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:00.168Z
+title: 入门指南
+description: 学习如何使用 Next.js 创建全栈 Web 应用程序。
+---
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/01-building-your-application/index.mdx b/apps/docs/content/zh-hans/docs/13/02-app/01-building-your-application/index.mdx
new file mode 100644
index 00000000..11a9c4af
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/01-building-your-application/index.mdx
@@ -0,0 +1,24 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:26.703Z
+title: 构建应用
+description: 学习如何使用 Next.js 功能来构建您的应用程序。
+---
+
+{/* 本文档内容在应用路由器和页面路由器之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由器的内容。任何共享内容不应包裹在组件中。 */}
+
+Next.js 提供了构建灵活的全栈 Web 应用的基础模块。**构建应用**指南将解释如何使用这些功能以及如何自定义应用程序行为。
+
+章节和页面按从基础到高级的顺序组织，您可以在构建 Next.js 应用时逐步遵循。当然，您也可以按任意顺序阅读或直接跳转到与您用例相关的页面。
+
+<AppOnly>
+
+如果您是 Next.js 新手，我们建议从 [路由](/docs/app/building-your-application/routing)、[渲染](/docs/app/building-your-application/rendering)、[数据获取](/docs/app/building-your-application/data-fetching) 和 [样式](/docs/app/building-your-application/styling) 章节开始，这些内容介绍了 Next.js 和 Web 的基础概念以帮助您入门。然后，您可以深入探索其他章节，如 [优化](/docs/app/building-your-application/optimizing) 和 [配置](/docs/app/building-your-application/configuring)。最后，当您准备就绪时，可以查看 [部署](/docs/app/building-your-application/deploying) 和 [升级](/docs/app/building-your-application/upgrading) 章节。
+
+</AppOnly>
+
+<PagesOnly>
+
+如果您是 Next.js 新手，我们建议从 [路由](/docs/pages/building-your-application/routing)、[渲染](/docs/pages/building-your-application/rendering)、[数据获取](/docs/pages/building-your-application/data-fetching) 和 [样式](/docs/pages/building-your-application/styling) 章节开始，这些内容介绍了 Next.js 和 Web 的基础概念以帮助您入门。然后，您可以深入探索其他章节，如 [优化](/docs/pages/building-your-application/optimizing) 和 [配置](/docs/pages/building-your-application/configuring)。最后，当您准备就绪时，可以查看 [部署](/docs/pages/building-your-application/deploying) 和 [升级](/docs/pages/building-your-application/upgrading) 章节。
+
+</PagesOnly>
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/06-create-next-app.mdx b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/06-create-next-app.mdx
new file mode 100644
index 00000000..a9451045
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/06-create-next-app.mdx
@@ -0,0 +1,132 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:46.818Z
+title: create-next-app
+description: 通过 create-next-app 一键创建 Next.js 应用。
+---
+
+{/* 本文档内容在应用路由和页面路由间共享。如需添加仅适用于页面路由的内容，可使用 `<PagesOnly>内容</PagesOnly>` 组件。所有共享内容不应包裹在任何组件中。 */}
+
+开始使用 Next.js 最简单的方式是使用 `create-next-app`。这个命令行工具能让你快速搭建新的 Next.js 应用，并自动完成所有基础配置。
+
+你可以使用默认的 Next.js 模板创建新应用，也可以选择 [Next.js 官方示例](https://github.com/vercel/next.js/tree/canary/examples) 中的模板。
+
+### 交互式创建
+
+通过以下命令以交互方式创建新项目：
+
+```bash filename="终端"
+npx create-next-app@latest
+```
+
+```bash filename="终端"
+yarn create next-app
+```
+
+```bash filename="终端"
+pnpm create next-app
+```
+
+```bash filename="终端"
+bunx create-next-app
+```
+
+随后会提示以下选项：
+
+```txt filename="终端"
+请输入项目名称？  my-app
+是否使用 TypeScript？  否 / 是
+是否使用 ESLint？  否 / 是
+是否使用 Tailwind CSS？  否 / 是
+是否使用 `src/` 目录？  否 / 是
+是否使用 App 路由？（推荐）  否 / 是
+是否自定义默认导入别名 (@/*)？  否 / 是
+```
+
+完成选择后，系统会根据你的回答自动创建配置正确的新项目。
+
+### 非交互式创建
+
+你也可以通过命令行参数直接创建项目（无需交互问答）。
+
+此外，可以通过 `--no-` 前缀取消默认选项（例如 `--no-eslint`）。
+
+查看 `create-next-app --help`：
+
+```bash filename="终端"
+用法: create-next-app <项目目录> [选项]
+
+选项:
+  -V, --version                        输出版本号
+  --ts, --typescript
+
+    初始化为 TypeScript 项目（默认值）
+
+  --js, --javascript
+
+    初始化为 JavaScript 项目
+
+  --tailwind
+
+    初始化包含 Tailwind CSS 配置（默认值）
+
+  --eslint
+
+    初始化包含 ESLint 配置
+
+  --app
+
+    初始化为 App 路由项目
+
+  --src-dir
+
+    在 `src/` 目录内初始化项目
+
+  --import-alias <配置别名>
+
+    指定导入别名（默认为 "@/*"）
+
+  --use-npm
+
+    明确告知 CLI 使用 npm 初始化应用
+
+  --use-pnpm
+
+    明确告知 CLI 使用 pnpm 初始化应用
+
+  --use-yarn
+
+    明确告知 CLI 使用 Yarn 初始化应用
+
+  --use-bun
+
+    明确告知 CLI 使用 Bun 初始化应用
+
+  -e, --example [名称]|[github-url]
+
+    基于示例初始化应用。可使用 Next.js 官方仓库中的示例名称
+    或公开 GitHub 仓库 URL。URL 可包含任意分支和/或子目录
+
+  --example-path <示例路径>
+
+    极少数情况下，你的 GitHub URL 可能包含带斜杠的分支名称
+    （如 bug/fix-1）和示例路径（如 foo/bar）。
+    此时必须单独指定示例路径：
+    --example-path foo/bar
+
+  --reset-preferences
+
+    明确告知 CLI 重置所有存储的首选项
+
+  -h, --help                           输出使用信息
+```
+
+### 为什么使用 Create Next App？
+
+`create-next-app` 让你能在几秒内创建新的 Next.js 应用。该工具由 Next.js 官方团队维护，具有以下优势：
+
+- **交互式体验**：直接运行 `npx create-next-app@latest`（不带参数）会启动交互式向导，引导你完成项目配置
+- **零依赖**：初始化项目最快仅需一秒。Create Next App 本身没有任何依赖
+- **离线支持**：当检测到离线状态时，Create Next App 会自动使用本地包缓存初始化项目
+- **示例支持**：可以从 Next.js 示例集合（如 `npx create-next-app --example api-routes`）或任意公开 GitHub 仓库初始化项目
+- **经过测试**：该工具是 Next.js 单体仓库的一部分，使用与 Next.js 相同的集成测试套件进行验证，确保每个版本都能正常工作
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/07-edge.mdx b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/07-edge.mdx
new file mode 100644
index 00000000..b0933c85
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/07-edge.mdx
@@ -0,0 +1,166 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:19:50.414Z
+title: Edge Runtime
+description: Edge Runtime 的 API 参考文档。
+---
+
+{/* 本文档内容在应用路由和页面路由之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。任何共享内容不应包裹在组件中。 */}
+
+Next.js 的 Edge Runtime 基于标准 Web API，支持以下 API：
+
+## 网络 API
+
+| API                                                                             | 描述                          |
+| ------------------------------------------------------------------------------- | ----------------------------- |
+| [`Blob`](https://developer.mozilla.org/docs/Web/API/Blob)                       | 表示二进制大对象 (Blob)        |
+| [`fetch`](https://developer.mozilla.org/docs/Web/API/Fetch_API)                 | 获取资源                      |
+| [`FetchEvent`](https://developer.mozilla.org/docs/Web/API/FetchEvent)           | 表示 fetch 事件               |
+| [`File`](https://developer.mozilla.org/docs/Web/API/File)                       | 表示文件对象                  |
+| [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData)               | 表示表单数据                  |
+| [`Headers`](https://developer.mozilla.org/docs/Web/API/Headers)                 | 表示 HTTP 头部信息            |
+| [`Request`](https://developer.mozilla.org/docs/Web/API/Request)                 | 表示 HTTP 请求                |
+| [`Response`](https://developer.mozilla.org/docs/Web/API/Response)               | 表示 HTTP 响应                |
+| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams) | 表示 URL 查询参数             |
+| [`WebSocket`](https://developer.mozilla.org/docs/Web/API/WebSocket)             | 表示 WebSocket 连接           |
+
+## 编码 API
+
+| API                                                                                 | 描述                          |
+| ----------------------------------------------------------------------------------- | ----------------------------- |
+| [`atob`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/atob) | 解码 base-64 编码字符串       |
+| [`btoa`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/btoa) | 将字符串编码为 base-64        |
+| [`TextDecoder`](https://developer.mozilla.org/docs/Web/API/TextDecoder)             | 将 Uint8Array 解码为字符串    |
+| [`TextDecoderStream`](https://developer.mozilla.org/docs/Web/API/TextDecoderStream) | 可链式调用的流解码器          |
+| [`TextEncoder`](https://developer.mozilla.org/docs/Web/API/TextEncoder)             | 将字符串编码为 Uint8Array     |
+| [`TextEncoderStream`](https://developer.mozilla.org/docs/Web/API/TextEncoderStream) | 可链式调用的流编码器          |
+
+## 流 API
+
+| API                                                                                                     | 描述                          |
+| ------------------------------------------------------------------------------------------------------- | ----------------------------- |
+| [`ReadableStream`](https://developer.mozilla.org/docs/Web/API/ReadableStream)                           | 表示可读流                    |
+| [`ReadableStreamBYOBReader`](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)       | 表示可读流的读取器            |
+| [`ReadableStreamDefaultReader`](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader) | 表示可读流的默认读取器        |
+| [`TransformStream`](https://developer.mozilla.org/docs/Web/API/TransformStream)                         | 表示转换流                    |
+| [`WritableStream`](https://developer.mozilla.org/docs/Web/API/WritableStream)                           | 表示可写流                    |
+| [`WritableStreamDefaultWriter`](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter) | 表示可写流的默认写入器        |
+
+## 加密 API
+
+| API                                                                       | 描述                                                                 |
+| ------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [`crypto`](https://developer.mozilla.org/docs/Web/API/Window/crypto)      | 提供对平台加密功能的访问                                             |
+| [`CryptoKey`](https://developer.mozilla.org/docs/Web/API/CryptoKey)       | 表示加密密钥                                                         |
+| [`SubtleCrypto`](https://developer.mozilla.org/docs/Web/API/SubtleCrypto) | 提供对常见加密原语的访问，如哈希、签名、加密或解密等操作             |
+
+## Web 标准 API
+
+| API                                                                                                                   | 描述                                                                                                                                                                                                 |
+| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`AbortController`](https://developer.mozilla.org/docs/Web/API/AbortController)                                       | 允许按需中止一个或多个 DOM 请求                                                                                                                                                                     |
+| [`Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)                           | 表示一个值数组                                                                                                                                                                                      |
+| [`ArrayBuffer`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer)               | 表示通用的固定长度原始二进制数据缓冲区                                                                                                                                                              |
+| [`Atomics`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Atomics)                       | 提供原子操作作为静态方法                                                                                                                                                                            |
+| [`BigInt`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigInt)                         | 表示任意精度的整数                                                                                                                                                                                  |
+| [`BigInt64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigInt64Array)           | 表示 64 位有符号整数的类型化数组                                                                                                                                                                    |
+| [`BigUint64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigUint64Array)         | 表示 64 位无符号整数的类型化数组                                                                                                                                                                    |
+| [`Boolean`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)                       | 表示逻辑实体，可以有两个值：`true` 和 `false`                                                                                                                                                       |
+| [`clearInterval`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval)                 | 取消先前通过 `setInterval()` 设置的定时重复操作                                                                                                                                                      |
+| [`clearTimeout`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/clearTimeout)                   | 取消先前通过 `setTimeout()` 设置的定时重复操作                                                                                                                                                       |
+| [`console`](https://developer.mozilla.org/docs/Web/API/Console)                                                       | 提供对浏览器调试控制台的访问                                                                                                                                                                        |
+| [`DataView`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DataView)                     | 表示 `ArrayBuffer` 的通用视图                                                                                                                                                                       |
+| [`Date`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date)                             | 以平台无关的格式表示单个时间点                                                                                                                                                                      |
+| [`decodeURI`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/decodeURI)                   | 解码先前由 `encodeURI` 或类似例程创建的统一资源标识符 (URI)                                                                                                                                         |
+| [`decodeURIComponent`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent) | 解码先前由 `encodeURIComponent` 或类似例程创建的 URI 组件                                                                                                                                           |
+| [`DOMException`](https://developer.mozilla.org/docs/Web/API/DOMException)                                             | 表示 DOM 中发生的错误                                                                                                                                                                               |
+| [`encodeURI`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/encodeURI)                   | 通过将某些字符的每个实例替换为一个、两个、三个或四个表示该字符 UTF-8 编码的转义序列，来编码统一资源标识符 (URI)                                                                                    |
+| [`encodeURIComponent`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) | 通过将某些字符的每个实例替换为一个、两个、三个或四个表示该字符 UTF-8 编码的转义序列，来编码 URI 组件                                                                                                |
+| [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error)                           | 表示尝试执行语句或访问属性时发生的错误                                                                                                                                                              |
+| [`EvalError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/EvalError)                   | 表示与全局函数 `eval()` 相关的错误                                                                                                                                                                  |
+| [`Float32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Float32Array)             | 表示 32 位浮点数的类型化数组                                                                                                                                                                        |
+| [`Float64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Float64Array)             | 表示 64 位浮点数的类型化数组                                                                                                                                                                        |
+| [`Function`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function)                     | 表示函数                                                                                                                                                                                            |
+| [`Infinity`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Infinity)                     | 表示数学上的无穷大值                                                                                                                                                                                |
+| [`Int8Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int8Array)                   | 表示 8 位有符号整数的类型化数组                                                                                                                                                                     |
+| [`Int16Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int16Array)                 | 表示 16 位有符号整数的类型化数组                                                                                                                                                                    |
+| [`Int32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int32Array)                 | 表示 32 位有符号整数的类型化数组                                                                                                                                                                    |
+| [`Intl`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl)                             | 提供国际化和本地化功能                                                                                                                                                                              |
+| [`isFinite`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/isFinite)                     | 判断一个值是否为有限数                                                                                                                                                                              |
+| [`isNaN`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/isNaN)                           | 判断一个值是否为 `NaN`                                                                                                                                                                              |
+| [`JSON`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON)                             | 提供将 JavaScript 值与 JSON 格式相互转换的功能                                                                                                                                                      |
+| [`Map`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)                               | 表示值的集合，其中每个值只能出现一次                                                                                                                                                                |
+| [`Math`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Math)                             | 提供数学函数和常量的访问                                                                                                                                                                            |
+| [`Number`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)                         | 表示数值                                                                                                                                                                                            |
+| [`Object`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)                         | 表示作为所有 JavaScript 对象基础的对象                                                                                                                                                              |
+| [`parseFloat`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/parseFloat)                 | 解析字符串参数并返回浮点数                                                                                                                                                                          |
+| [`parseInt`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/parseInt)                     | 解析字符串参数并返回指定基数的整数                                                                                                                                                                  |
+| [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)                       | 表示异步操作的最终完成（或失败）及其结果值                                                                                                                                                          |
+| [`Proxy`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Proxy)                           | 表示用于定义基本操作（如属性查找、赋值、枚举、函数调用等）自定义行为的对象                                                                                                                          |
+| [`queueMicrotask`](https://developer.mozilla.org/docs/Web/API/queueMicrotask)                                         | 将微任务加入队列等待执行                                                                                                                                                                            |
+| [`RangeError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RangeError)                 | 表示值不在允许的集合或范围内时发生的错误                                                                                                                                                            |
+| [`ReferenceError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError)         | 表示引用不存在的变量时发生的错误                                                                                                                                                                    |
+| [`Reflect`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Reflect)                       | 提供可拦截 JavaScript 操作的方法                                                                                                                                                                    |
+| [`RegExp`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp)                         | 表示正则表达式，允许匹配字符组合                                                                                                                                                                    |
+| [`Set`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set)                               | 表示值的集合，其中每个值只能出现一次                                                                                                                                                                |
+| [`setInterval`](https://developer.mozilla.org/docs/Web/API/setInterval)                                               | 以固定的时间延迟重复调用函数                                                                                                                                                                        |
+| [`setTimeout`](https://developer.mozilla.org/docs/Web/API/setTimeout)                                                 | 在指定的毫秒数后调用函数或计算表达式                                                                                                                                                                |
+| [`SharedArrayBuffer`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer)   | 表示通用的固定长度原始二进制数据缓冲区                                                                                                                                                              |
+| [`String`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)                         | 表示字符序列                                                                                                                                                                                        |
+| [`structuredClone`](https://developer.mozilla.org/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)            | 创建值的深拷贝                                                                                                                                                                                      |
+| [`Symbol`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Symbol)                         | 表示唯一且不可变的数据类型，用作对象属性的键                                                                                                                                                        |
+| [`SyntaxError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError)               | 表示尝试解释语法无效代码时发生的错误                                                                                                                                                                |
+| [`TypeError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/TypeError)                   | 表示值不是预期类型时发生的错误                                                                                                                                                                      |
+| [`Uint8Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array)                 | 表示 8 位无符号整数的类型化数组                                                                                                                                                                     |
+| [`Uint8ClampedArray`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray)   | 表示被限制在 0-255 范围内的 8 位无符号整数的类型化数组                                                                                                                                              |
+| [`Uint32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array)               | 表示 32 位无符号整数的类型化数组                                                                                                                                                                    |
+| [`URIError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/URIError)                     | 表示全局 URI 处理函数使用不当时的错误                                                                                                                                                               |
+| [`URL`](https://developer.mozilla.org/docs/Web/API/URL)                                                               | 表示提供用于创建对象 URL 的静态方法的对象                                                                                                                                                           |
+| [`URLPattern`](https://developer.mozilla.org/docs/Web/API/URLPattern)                                                 | 表示 URL 模式                                                                                                                                                                                       |
+| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams)                                       | 表示键/值对的集合                                                                                                                                                                                   |
+| [`WeakMap`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)                       | 表示键/值对的集合，其中键是弱引用                                                                                                                                                                  |
+| [`WeakSet`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WeakSet)                       | 表示对象的集合，其中每个对象只能出现一次                                                                                                                                                            |
+| [`WebAssembly`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly)               | 提供对 WebAssembly 的访问                                                                                                                                                                           |
+
+## Next.js 专用 Polyfills
+
+- [`AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage)
+
+## 环境变量
+
+你可以使用 `process.env` 来访问[环境变量](/docs/app/building-your-application/configuring/environment-variables)，适用于 `next dev` 和 `next build` 命令。
+
+## 不受支持的 API
+
+Edge 运行时存在以下限制：
+
+- **不支持**原生 Node.js API。例如，无法读写文件系统。
+- 可以使用 `node_modules`，但要求它们必须实现 ES 模块规范且不使用原生 Node.js API。
+- **不允许**直接调用 `require`。请改用 ES 模块。
+
+以下 JavaScript 语言特性已被禁用，**无法正常工作**：
+
+| API                                                                                                                             | 描述                                                                 |
+| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`eval`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/eval)                                       | 执行以字符串形式表示的 JavaScript 代码                                |
+| [`new Function(evalString)`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function)               | 通过字符串代码创建新函数                                              |
+| [`WebAssembly.compile`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/compile)         | 从缓冲区源码编译 WebAssembly 模块                                     |
+| [`WebAssembly.instantiate`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/instantiate) | 从缓冲区源码编译并实例化 WebAssembly 模块                             |
+
+在极少数情况下，你的代码可能包含（或引入）某些动态代码执行语句，这些语句_在运行时无法被访问_且无法通过 tree shaking 移除。你可以通过中间件或 Edge API 路由的导出配置来放宽检查，允许特定文件：
+
+```javascript
+export const config = {
+  runtime: 'edge', // 仅适用于 Edge API 路由
+  unstable_allowDynamic: [
+    // 允许单个文件
+    '/lib/utilities.js',
+    // 使用 glob 模式允许第三方模块 function-bind 中的所有内容
+    '/node_modules/function-bind/**',
+  ],
+}
+```
+
+`unstable_allowDynamic` 是一个 [glob](https://github.com/micromatch/micromatch#matching-features) 模式或 glob 模式数组，用于忽略特定文件的动态代码执行检查。这些 glob 路径相对于应用程序的根目录。
+
+请注意，如果这些语句在 Edge 环境中执行，_它们会抛出异常并导致运行时错误_。
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/08-next-cli.mdx b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/08-next-cli.mdx
new file mode 100644
index 00000000..591e4973
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/08-next-cli.mdx
@@ -0,0 +1,176 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:52.798Z
+title: Next.js CLI
+description: Next.js 命令行工具 (CLI) 允许您启动、构建和导出应用程序。了解更多相关信息。
+---
+
+{/* 本文档内容在应用路由和页面路由间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。任何共享内容不应包裹在组件中。 */}
+
+Next.js 命令行工具 (CLI) 允许您启动、构建和导出应用程序。
+
+要获取可用 CLI 命令列表，请在项目目录中运行以下命令：
+
+```bash filename="终端"
+npx next -h
+```
+
+_([npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) 随 npm 5.2+ 及更高版本提供)_
+
+输出应如下所示：
+
+```bash filename="终端"
+用法
+  $ next <命令>
+
+可用命令
+  build, start, export, dev, lint, telemetry, info
+
+选项
+  --version, -v   版本号
+  --help, -h      显示此帮助信息
+
+更多信息可通过 --help 标志运行命令查看
+  $ next build --help
+```
+
+您可以向 `next` 命令传递任何 [Node 参数](https://nodejs.org/api/cli.html#cli_node_options_options)：
+
+```bash filename="终端"
+NODE_OPTIONS='--throw-deprecation' next
+NODE_OPTIONS='-r esm' next
+NODE_OPTIONS='--inspect' next
+```
+
+> **须知**：直接运行 `next` 等同于运行 `next dev`
+
+## 构建
+
+`next build` 会创建应用程序的优化生产版本。输出会显示每个路由的信息。
+
+- **大小** - 客户端导航至页面时需要下载的资源量。每个路由的大小仅包含其依赖项。
+- **首次加载 JS** - 从服务端访问页面时需要下载的资源量。所有路由共享的 JS 量会单独显示。
+
+这些数值均为 **gzip 压缩后**的大小。首次加载会以绿色、黄色或红色标示。建议保持绿色以获得最佳性能。
+
+您可以通过 `next build` 的 `--profile` 标志启用 React 的生产环境性能分析。此功能需要 [Next.js 9.5](https://nextjs.org/blog/next-9-5)：
+
+```bash filename="终端"
+next build --profile
+```
+
+之后您可以像开发环境一样使用性能分析器。
+
+您可以通过 `next build` 的 `--debug` 标志启用更详细的构建输出。此功能需要 Next.js 9.5.3：
+
+```bash filename="终端"
+next build --debug
+```
+
+启用此标志后会显示额外的构建输出，如重写规则、重定向和标头信息。
+
+## 开发
+
+`next dev` 以开发模式启动应用程序，支持热重载、错误报告等功能：
+
+默认情况下，应用程序会启动在 `http://localhost:3000`。可以通过 `-p` 修改默认端口：
+
+```bash filename="终端"
+npx next dev -p 4000
+```
+
+或使用 `PORT` 环境变量：
+
+```bash filename="终端"
+PORT=4000 npx next dev
+```
+
+> **须知**：`PORT` 不能在 `.env` 中设置，因为 HTTP 服务器的启动早于其他代码初始化。
+
+您还可以修改默认主机名 `0.0.0.0`，这对于让网络中的其他设备访问应用程序很有用。通过 `-H` 修改默认主机名：
+
+```bash filename="终端"
+npx next dev -H 192.168.1.2
+```
+
+## 生产环境
+
+`next start` 以生产模式启动应用程序。应用程序应先用 [`next build`](#build) 编译。
+
+默认情况下，应用程序会启动在 `http://localhost:3000`。可以通过 `-p` 修改默认端口：
+
+```bash filename="终端"
+npx next start -p 4000
+```
+
+或使用 `PORT` 环境变量：
+
+```bash filename="终端"
+PORT=4000 npx next start
+```
+
+> **须知**：
+>
+> - `PORT` 不能在 `.env` 中设置，因为 HTTP 服务器的启动早于其他代码初始化。
+>
+> - `next start` 不能与 `output: 'standalone'` 或 `output: 'export'` 同时使用。
+
+### 保持活动超时
+
+当 Next.js 部署在下游代理（如负载均衡器 AWS ELB/ALB）后方时，必须将 Next.js 底层 HTTP 服务器的 [keep-alive 超时](https://nodejs.org/api/http.html#http_server_keepalivetimeout)配置为**大于**下游代理的超时时间。否则，当 TCP 连接达到 keep-alive 超时后，Node.js 会立即终止该连接而不通知下游代理。这会导致代理尝试重用已被 Node.js 终止的连接时出现错误。
+
+要为生产环境 Next.js 服务器配置超时值，可向 `next start` 传递 `--keepAliveTimeout`（毫秒单位）：
+
+```bash filename="终端"
+npx next start --keepAliveTimeout 70000
+```
+
+## 代码检查
+
+`next lint` 会对 `pages/`、`app/`、`components/`、`lib/` 和 `src/` 目录下的所有文件运行 ESLint。如果应用程序尚未配置 ESLint，它还会提供引导式安装所需依赖的功能。
+
+如需检查其他目录，可使用 `--dir` 标志指定：
+
+```bash filename="终端"
+next lint --dir utils
+```
+
+## 遥测
+
+Next.js 会收集**完全匿名**的通用使用情况遥测数据。参与此匿名计划是可选的，如果您不愿分享任何信息可以选择退出。
+
+要了解有关遥测的更多信息，[请阅读此文档](https://nextjs.org/telemetry/)。
+
+## 系统信息
+
+`next info` 会打印当前系统的相关信息，可用于报告 Next.js 错误。这些信息包括操作系统平台/架构/版本、二进制文件（Node.js、npm、Yarn、pnpm）和 npm 包版本（`next`、`react`、`react-dom`）。
+
+在项目根目录运行：
+
+```bash filename="终端"
+next info
+```
+
+将输出类似以下示例的信息：
+
+```bash filename="终端"
+
+操作系统:
+  平台: linux
+  架构: x64
+  版本: #22-Ubuntu SMP Fri Nov 5 13:21:36 UTC 2021
+二进制文件:
+  Node: 16.13.0
+  npm: 8.1.0
+  Yarn: 1.22.17
+  pnpm: 6.24.2
+相关包:
+  next: 12.0.8
+  react: 17.0.2
+  react-dom: 17.0.2
+
+```
+
+这些信息应粘贴至 GitHub Issues 中。
+
+如需诊断安装问题，可运行 `next info --verbose` 打印系统和 next 相关包安装的额外信息。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/index.mdx b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/index.mdx
new file mode 100644
index 00000000..703d90e1
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/02-api-reference/index.mdx
@@ -0,0 +1,8 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:00.458Z
+title: API 参考文档
+description: 关于 App Router 的 Next.js API 参考文档。
+---
+
+Next.js API 参考文档分为以下几个部分：
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/02-app/index.mdx b/apps/docs/content/zh-hans/docs/13/02-app/index.mdx
new file mode 100644
index 00000000..6100fc12
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/02-app/index.mdx
@@ -0,0 +1,72 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:43.800Z
+title: 应用路由 (App Router)
+description: 使用 Next.js 和 React 的最新功能，包括布局 (Layouts)、服务端组件 (Server Components)、Suspense 等特性构建应用。
+---
+
+Next.js 应用路由 (App Router) 是利用 React 最新功能构建应用程序的新范式。如果您已经熟悉 Next.js，会发现应用路由是现有[页面路由 (Pages Router)](/docs/pages) 基于文件系统路由的自然演进。
+
+对于新应用，**我们推荐使用应用路由**。对于现有应用，您可以[逐步迁移到应用路由](/docs/app/building-your-application/upgrading/app-router-migration)。也可以在同一个应用中同时使用两种路由。
+
+## 常见问题
+
+### 如何在布局中访问请求对象？
+
+出于设计考虑，您无法直接访问原始请求对象。但可以通过服务端专用函数访问 [`headers`](/docs/app/api-reference/functions/headers) 和 [`cookies`](/docs/app/api-reference/functions/cookies)。您也可以[设置 cookies](#如何设置-cookies)。
+
+[布局 (Layouts)](/docs/app/building-your-application/routing/pages-and-layouts#layouts) 不会重新渲染。它们可以被缓存并复用以避免页面导航时不必要的计算。通过限制布局访问原始请求，Next.js 可以防止在布局中执行可能缓慢或昂贵的用户代码，从而避免性能下降。
+
+这种设计还确保了布局在不同页面间具有一致且可预测的行为，简化了开发和调试过程，因为开发者可以信赖布局的行为不会因应用的具体页面而改变。
+
+根据您构建的 UI 模式，[并行路由 (Parallel Routes)](/docs/app/building-your-application/routing/parallel-routes) 允许您在同一个布局中渲染多个页面，且页面可以访问路由段和 URL 查询参数。
+
+### 如何在页面中访问 URL？
+
+默认情况下，页面是服务端组件 (Server Components)。您可以通过 [`params`](/docs/app/api-reference/file-conventions/page#params-optional) 属性访问路由段，通过 [`searchParams`](/docs/app/api-reference/file-conventions/page#searchparams-optional) 属性访问 URL 查询参数。
+
+如果使用客户端组件 (Client Components)，可以使用 [`usePathname`](/docs/app/api-reference/functions/use-pathname)、[`useSelectedLayoutSegment`](/docs/app/api-reference/functions/use-selected-layout-segment) 和 [`useSelectedLayoutSegments`](/docs/app/api-reference/functions/use-selected-layout-segments) 处理更复杂的路由。
+
+此外，根据您构建的 UI 模式，[并行路由](/docs/app/building-your-application/routing/parallel-routes) 允许您在同一个布局中渲染多个页面，且页面可以访问路由段和 URL 查询参数。
+
+### 如何从服务端组件重定向？
+
+您可以使用 [`redirect`](/docs/app/api-reference/functions/redirect) 将页面重定向到相对或绝对 URL。[`redirect`](/docs/app/api-reference/functions/redirect) 是临时重定向 (307)，而 [`permanentRedirect`](/docs/app/api-reference/functions/permanentRedirect) 是永久重定向 (308)。当在流式渲染 UI 时使用这些函数，它们会插入 meta 标签在客户端触发重定向。
+
+### 如何使用应用路由处理身份验证？
+
+以下是支持应用路由的常见身份验证解决方案：
+
+- [NextAuth.js](https://next-auth.js.org/configuration/nextjs#in-app-router)
+- [Clerk](https://clerk.com/docs/quickstarts/nextjs)
+- [Auth0](https://github.com/auth0/nextjs-auth0#app-router)
+- [Stytch](https://stytch.com/docs/example-apps/frontend/nextjs)
+- 或手动处理会话或 JWT
+
+### 如何设置 cookies？
+
+您可以在[服务器操作 (Server Actions)](/docs/app/building-your-application/data-fetching/forms-and-mutations#setting-cookies) 或[路由处理器 (Route Handlers)](/docs/app/building-your-application/routing/route-handlers) 中使用 [`cookies`](/docs/app/api-reference/functions/cookies) 函数设置 cookies。
+
+由于 HTTP 不允许在流式传输开始后设置 cookies，因此无法直接从页面或布局设置 cookies。您也可以从[中间件 (Middleware)](/docs/app/building-your-application/routing/middleware#using-cookies) 设置 cookies。
+
+### 如何构建多租户应用？
+
+如果您想构建一个服务于多个租户的 Next.js 应用，我们提供了[示例项目](https://vercel.com/templates/next.js/platforms-starter-kit)展示推荐架构。
+
+### 如何使应用路由缓存失效？
+
+Next.js 有多层缓存机制，因此有多种方式可以使不同部分的缓存失效。[了解更多关于缓存的信息](/docs/app/building-your-application/caching)。
+
+### 是否有基于应用路由构建的综合开源应用？
+
+是的。您可以查看 [Next.js Commerce](https://vercel.com/templates/next.js/nextjs-commerce) 或 [Platforms Starter Kit](https://vercel.com/templates/next.js/platforms-starter-kit) 这两个使用应用路由的大型开源示例。
+
+## 了解更多
+
+- [路由基础](/docs/app/building-your-application/routing)
+- [数据获取、缓存和重新验证](/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating)
+- [表单和变更](/docs/app/building-your-application/data-fetching/forms-and-mutations)
+- [缓存机制](/docs/app/building-your-application/caching)
+- [渲染基础](/docs/app/building-your-application/rendering)
+- [服务端组件](/docs/app/building-your-application/rendering/server-components)
+- [客户端组件](/docs/app/building-your-application/rendering/client-components)
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/01-building-your-application/index.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/01-building-your-application/index.mdx
new file mode 100644
index 00000000..74add0fe
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/01-building-your-application/index.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:02.727Z
+title: 构建您的应用
+description: 学习如何使用 Next.js 功能来构建您的应用。
+source: app/building-your-application
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑本页内容，请前往编辑器中的源页面进行操作。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/04-create-next-app.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/04-create-next-app.mdx
new file mode 100644
index 00000000..5d06e375
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/04-create-next-app.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:55.003Z
+title: create-next-app
+description: 关于 create-next-app 的使用说明
+source: app/api-reference/create-next-app
+---
+
+{/* 请勿直接编辑此文档。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/05-next-cli.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/05-next-cli.mdx
new file mode 100644
index 00000000..78ba00ec
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/05-next-cli.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:54.987Z
+title: Next.js 命令行工具 (CLI)
+description: Next.js 命令行工具 (CLI)
+source: app/api-reference/next-cli
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/06-edge.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/06-edge.mdx
new file mode 100644
index 00000000..06dd42a1
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/06-edge.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:53.253Z
+title: Edge Runtime
+description: 关于 Edge Runtime 的 API 参考文档。
+source: app/api-reference/edge
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑本页内容，请在编辑器中导航至源文件页面。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/index.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/index.mdx
new file mode 100644
index 00000000..d0c6a163
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/02-api-reference/index.mdx
@@ -0,0 +1,6 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:46.321Z
+title: API 参考文档
+description: 关于 Pages Router 的 Next.js API 参考文档。
+---
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/03-pages/index.mdx b/apps/docs/content/zh-hans/docs/13/03-pages/index.mdx
new file mode 100644
index 00000000..fb438fba
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/03-pages/index.mdx
@@ -0,0 +1,10 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:13:55.434Z
+title: 页面路由 (Pages Router)
+description: 在 Next.js 13 之前，页面路由 (Pages Router) 是通过直观的文件系统路由在 Next.js 中创建路由的主要方式。
+---
+
+在 Next.js 13 之前，页面路由 (Pages Router) 是 Next.js 中创建路由的主要方式。它采用直观的文件系统路由，将每个文件映射到一个路由路径。新版本的 Next.js 仍支持页面路由 (Pages Router)，但我们建议迁移至新的 [应用路由 (App Router)](/docs/app) 以利用 React 的最新特性。
+
+本部分文档适用于使用页面路由 (Pages Router) 的现有应用程序。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/accessibility.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/accessibility.mdx
new file mode 100644
index 00000000..28b7df6a
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/accessibility.mdx
@@ -0,0 +1,36 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:14.380Z
+title: 无障碍访问
+description: Next.js 内置的无障碍访问功能。
+---
+
+Next.js 团队致力于让所有开发者（及其终端用户）都能无障碍使用 Next.js。通过在 Next.js 中默认集成无障碍访问功能，我们旨在让网络世界对每个人更加包容。
+
+## 路由播报
+
+当在服务端渲染的页面之间切换时（例如使用 `<a href>` 标签），屏幕阅读器和其他辅助技术会在页面加载时播报页面标题，以便用户知晓页面已变更。
+
+除了传统的页面导航方式外，Next.js 还支持客户端转场以提升性能（使用 `next/link`）。为确保客户端转场也能被辅助技术播报，Next.js 默认内置了路由播报器。
+
+Next.js 路由播报器会依次检查 `document.title`、`<h1>` 元素和 URL 路径名来确定要播报的页面名称。为了提供最佳的无障碍用户体验，请确保应用中的每个页面都具有唯一且描述性的标题。
+
+## 代码检查
+
+Next.js 提供了[开箱即用的 ESLint 集成体验](/docs/pages/building-your-application/configuring/eslint)，包含针对 Next.js 的定制规则。默认情况下，Next.js 包含 `eslint-plugin-jsx-a11y` 插件来帮助及早发现无障碍问题，包括对以下情况的警告：
+
+- [aria-props](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/aria-props.md?rgh-link-date=2021-06-04T02%3A10%3A36Z)
+- [aria-proptypes](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/aria-proptypes.md?rgh-link-date=2021-06-04T02%3A10%3A36Z)
+- [aria-unsupported-elements](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/aria-unsupported-elements.md?rgh-link-date=2021-06-04T02%3A10%3A36Z)
+- [role-has-required-aria-props](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/role-has-required-aria-props.md?rgh-link-date=2021-06-04T02%3A10%3A36Z)
+- [role-supports-aria-props](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/HEAD/docs/rules/role-supports-aria-props.md?rgh-link-date=2021-06-04T02%3A10%3A36Z)
+
+例如，该插件能确保您为 `img` 标签添加替代文本、使用正确的 `aria-*` 属性、使用正确的 `role` 属性等。
+
+## 无障碍资源
+
+- [WebAIM WCAG 检查清单](https://webaim.org/standards/wcag/checklist)
+- [WCAG 2.1 指南](https://www.w3.org/TR/WCAG21/)
+- [A11y 项目](https://www.a11yproject.com/)
+- 检查前景与背景元素的[色彩对比度](https://developer.mozilla.org/docs/Web/Accessibility/Understanding_WCAG/Perceivable/Color_contrast)
+- 处理动画时使用 [`prefers-reduced-motion`](https://web.dev/prefers-reduced-motion/)
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/fast-refresh.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/fast-refresh.mdx
new file mode 100644
index 00000000..d4ae1d46
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/fast-refresh.mdx
@@ -0,0 +1,65 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:30.435Z
+title: 快速刷新 (Fast Refresh)
+description: 快速刷新 (Fast Refresh) 是一种热模块重载体验，能在您编辑 React 组件时提供即时反馈。
+---
+
+<details open>
+  <summary>示例</summary>
+
+- [快速刷新演示](https://github.com/vercel/next.js/tree/canary/examples/fast-refresh-demo)
+
+</details>
+
+快速刷新 (Fast Refresh) 是 Next.js 的一项功能，可在您编辑 React 组件时提供即时反馈。该功能在 **9.4 及以上版本** 的所有 Next.js 应用中默认启用。启用快速刷新后，大多数编辑内容都能在 **不丢失组件状态** 的情况下 **一秒内可见**。
+
+## 工作原理
+
+- 如果您编辑的文件 **仅导出 React 组件**，快速刷新将仅更新该文件的代码并重新渲染您的组件。您可以编辑该文件中的任何内容，包括样式、渲染逻辑、事件处理程序或副作用 (effects)。
+- 如果您编辑的文件包含 _非_ React 组件的导出，快速刷新将重新执行该文件及其导入文件。例如，若 `Button.js` 和 `Modal.js` 都导入了 `theme.js`，那么编辑 `theme.js` 将同时更新这两个组件。
+- 最后，如果您编辑的文件被 **React 树之外的文件导入**，快速刷新 **将回退到完全重新加载**。您可能有一个文件既渲染 React 组件，又导出一个被 **非 React 组件** 导入的值。例如，您的组件可能还导出了一个常量，而一个非 React 工具文件导入了它。这种情况下，建议将该常量迁移到单独的文件中，然后由两个文件分别导入。这将恢复快速刷新的正常工作。其他情况通常也可以通过类似方式解决。
+
+## 错误恢复能力
+
+### 语法错误
+
+如果您在开发过程中出现语法错误，修复后重新保存文件即可。错误会自动消失，无需重新加载应用。**组件状态不会丢失**。
+
+### 运行时错误
+
+如果您的组件中出现导致运行时错误的代码，将会显示上下文错误遮罩层。修复错误后，遮罩层会自动消失，无需重新加载应用。
+
+若错误未发生在渲染过程中，组件状态将被保留。若错误发生在渲染过程中，React 将使用更新后的代码重新挂载您的应用。
+
+如果应用中配置了 [错误边界 (error boundaries)](https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary)（这在生产环境中实现优雅降级是个好做法），它们会在渲染错误后的下一次编辑时重试渲染。这意味着使用错误边界可以避免应用状态总是被重置到根状态。但请注意，错误边界不应划分得 _过于_ 细粒度。它们在 React 生产环境中使用，应当始终被有意设计。
+
+## 限制
+
+快速刷新会尝试保留您正在编辑的组件中的本地 React 状态，但仅在安全的情况下进行。以下是可能导致每次编辑文件时本地状态被重置的原因：
+
+- 类组件 (class components) 的本地状态不会被保留（仅函数组件和 Hooks 会保留状态）。
+- 您编辑的文件可能 _除了_ React 组件外还有其他导出。
+- 有时，文件可能导出高阶组件 (HOC) 的调用结果，如 `HOC(WrappedComponent)`。如果返回的组件是类组件，其状态将被重置。
+- 匿名箭头函数如 `export default () => <div />;` 会导致快速刷新无法保留本地组件状态。对于大型代码库，可以使用 [`name-default-component` 代码迁移工具](/docs/pages/building-your-application/upgrading/codemods#name-default-component)。
+
+随着代码库中更多部分迁移到函数组件和 Hooks，您将看到更多情况下状态得以保留。
+
+## 使用技巧
+
+- 默认情况下，快速刷新会保留函数组件（和 Hooks）中的 React 本地状态。
+- 有时您可能希望 _强制_ 重置状态并重新挂载组件。例如，在调整仅挂载时触发的动画时这很有用。为此，您可以在编辑的文件中添加 `// @refresh reset`。该指令仅作用于当前文件，会指示快速刷新在每次编辑时重新挂载该文件中定义的组件。
+- 您可以在开发期间编辑的组件中添加 `console.log` 或 `debugger;` 语句。
+- 请注意导入区分大小写。当导入路径与实际文件名不匹配时，快速刷新和完全刷新都可能失败。例如 `'./header'` 和 `'./Header'`。
+
+## 快速刷新与 Hooks
+
+在可能的情况下，快速刷新会尝试保留组件编辑之间的状态。特别是，只要不更改参数或 Hook 调用顺序，`useState` 和 `useRef` 会保留其先前值。
+
+具有依赖项的 Hook（如 `useEffect`、`useMemo` 和 `useCallback`）在快速刷新期间会 _始终_ 更新。此时它们的依赖项列表将被忽略。
+
+例如，当您将 `useMemo(() => x * 2, [x])` 编辑为 `useMemo(() => x * 10, [x])` 时，即使依赖项 `x` 未更改也会重新执行。如果 React 不这样做，您的编辑将不会反映在屏幕上！
+
+有时这可能导致意外结果。例如，即使是依赖项数组为空的 `useEffect` 在快速刷新期间也会重新执行一次。
+
+然而，编写能够适应 `useEffect` 偶尔重新执行的代码是良好实践，即使没有快速刷新也是如此。这将便于您后续添加新的依赖项，同时也是我们强烈建议启用的 [React 严格模式 (React Strict Mode)](/docs/pages/api-reference/next-config-js/reactStrictMode) 所要求的。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/index.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/index.mdx
new file mode 100644
index 00000000..e582b44c
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/index.mdx
@@ -0,0 +1,8 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:13:46.691Z
+title: 架构
+description: Next.js 工作原理
+---
+
+了解 Next.js 的架构及其底层工作原理。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/nextjs-compiler.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/nextjs-compiler.mdx
new file mode 100644
index 00000000..c789099c
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/nextjs-compiler.mdx
@@ -0,0 +1,305 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:15:18.234Z
+title: Next.js 编译器
+description: Next.js 编译器采用 Rust 编写，用于转换和压缩 Next.js 应用。
+---
+
+Next.js 编译器基于 [SWC](http://swc.rs/) 并使用 Rust 编写，能够为生产环境转换和压缩 JavaScript 代码。它取代了 Babel 的单文件转换和 Terser 的代码压缩功能。
+
+自 Next.js 12 版本起，该编译器的编译速度比 Babel 快 17 倍且默认启用。若您已有 Babel 配置或使用了[不支持的功能](#不支持的功能)，应用将回退使用 Babel 而非 Next.js 编译器。
+
+## 为何选择 SWC？
+
+[SWC](http://swc.rs/) 是一个基于 Rust 的可扩展平台，旨在为下一代快速开发者工具提供支持。
+
+SWC 可用于编译、压缩、打包等操作，并支持功能扩展。您可以通过高级工具（如 Next.js）调用它执行代码转换（内置或自定义）。我们选择 SWC 的原因包括：
+
+- **可扩展性**：SWC 可作为 Crate 直接集成到 Next.js 中，无需分叉库或规避设计限制
+- **性能**：切换至 SWC 后，Next.js 实现了快 3 倍的快速刷新和快 5 倍的构建速度，仍有优化空间
+- **WebAssembly**：Rust 对 WASM 的支持使其能覆盖所有平台，让 Next.js 开发无处不在
+- **社区**：Rust 社区和生态系统蓬勃发展且充满活力
+
+## 支持的功能
+
+### Styled Components
+
+我们正在将 `babel-plugin-styled-components` 移植到 Next.js 编译器。
+
+首先升级至最新版 Next.js：`npm install next@latest`，然后更新 `next.config.js` 文件：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    // 配置选项详见 https://styled-components.com/docs/tooling#babel-plugin
+    styledComponents: boolean | {
+      // 开发环境默认启用，生产环境禁用以减少文件体积
+      // 设置此项将覆盖所有环境的默认值
+      displayName?: boolean,
+      // 默认启用
+      ssr?: boolean,
+      // 默认启用
+      fileName?: boolean,
+      // 默认为空
+      topLevelImportPaths?: string[],
+      // 默认为 ["index"]
+      meaninglessFileNames?: string[],
+      // 默认启用
+      cssProp?: boolean,
+      // 默认为空
+      namespace?: string,
+      // 暂不支持
+      minify?: boolean,
+      // 暂不支持
+      transpileTemplateLiterals?: boolean,
+      // 暂不支持
+      pure?: boolean,
+    },
+  },
+}
+```
+
+`minify`、`transpileTemplateLiterals` 和 `pure` 功能尚未实现，进度可追踪[此 issue](https://github.com/vercel/next.js/issues/30802)。`ssr` 和 `displayName` 转换是 Next.js 中使用 `styled-components` 的主要需求。
+
+### Jest
+
+Next.js 编译器可转译测试代码，并简化 Jest 与 Next.js 的配置，包括：
+
+- 自动模拟 `.css`、`.module.css`（及其 `.scss` 变体）和图片导入
+- 使用 SWC 自动设置 `transform`
+- 将 `.env`（及其所有变体）加载到 `process.env`
+- 从测试解析和转换中排除 `node_modules`
+- 从测试解析中忽略 `.next` 目录
+- 加载 `next.config.js` 以启用实验性 SWC 转换
+
+首先升级至最新版 Next.js：`npm install next@latest`，然后更新 `jest.config.js` 文件：
+
+```js filename="jest.config.js"
+const nextJest = require('next/jest')
+
+// 提供 Next.js 应用路径以加载 next.config.js 和 .env 文件
+const createJestConfig = nextJest({ dir: './' })
+
+// 传递给 Jest 的自定义配置
+const customJestConfig = {
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
+}
+
+// 以此方式导出确保 next/jest 能异步加载 Next.js 配置
+module.exports = createJestConfig(customJestConfig)
+```
+
+### Relay
+
+启用 [Relay](https://relay.dev/) 支持：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    relay: {
+      // 需与 relay.config.js 保持一致
+      src: './',
+      artifactDirectory: './__generated__',
+      language: 'typescript',
+      eagerEsModules: false,
+    },
+  },
+}
+```
+
+> **须知**：在 Next.js 中，`pages` 目录下所有 JavaScript 文件均被视为路由。因此 `relay-compiler` 需将 `artifactDirectory` 配置在 `pages` 目录外，否则生成的文件会被视为路由导致生产构建失败。
+
+### 移除 React 属性
+
+支持移除 JSX 属性（常用于测试），类似 `babel-plugin-react-remove-properties`。
+
+移除匹配默认正则 `^data-test` 的属性：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    reactRemoveProperties: true,
+  },
+}
+```
+
+移除自定义属性：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    // 正则表达式在 Rust 中处理，语法与 JavaScript 的 RegExp 不同
+    // 详见 https://docs.rs/regex
+    reactRemoveProperties: { properties: ['^data-custom$'] },
+  },
+}
+```
+
+### 移除 Console
+
+此转换可移除应用代码（非 `node_modules`）中的所有 `console.*` 调用，类似 `babel-plugin-transform-remove-console`。
+
+移除所有 `console.*` 调用：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    removeConsole: true,
+  },
+}
+```
+
+仅保留 `console.error`：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    removeConsole: {
+      exclude: ['error'],
+    },
+  },
+}
+```
+
+### 传统装饰器
+
+Next.js 会自动检测 `jsconfig.json` 或 `tsconfig.json` 中的 `experimentalDecorators`。传统装饰器常用于旧版库（如 `mobx`）。
+
+此功能仅为兼容现有应用，不建议在新项目中使用。
+
+首先升级至最新版 Next.js：`npm install next@latest`，然后更新配置文件：
+
+```js
+{
+  "compilerOptions": {
+    "experimentalDecorators": true
+  }
+}
+```
+
+### importSource
+
+Next.js 会自动检测 `jsconfig.json` 或 `tsconfig.json` 中的 `jsxImportSource`（常用于 [Theme UI](https://theme-ui.com) 等库）。
+
+首先升级至最新版 Next.js：`npm install next@latest`，然后更新配置文件：
+
+```js
+{
+  "compilerOptions": {
+    "jsxImportSource": "theme-ui"
+  }
+}
+```
+
+### Emotion
+
+我们正在将 `@emotion/babel-plugin` 移植到 Next.js 编译器。
+
+首先升级至最新版 Next.js：`npm install next@latest`，然后更新 `next.config.js`：
+
+```js filename="next.config.js"
+module.exports = {
+  compiler: {
+    emotion: boolean | {
+      // 默认 true，生产构建时禁用
+      sourceMap?: boolean,
+      // 默认 'dev-only'
+      autoLabel?: 'never' | 'dev-only' | 'always',
+      // 默认 '[local]'
+      // 可选值: `[local]` `[filename]` `[dirname]`
+      // 仅当 autoLabel 为 'dev-only' 或 'always' 时生效
+      labelFormat?: string,
+      // 默认为 undefined
+      // 用于指定需要转换的导入
+      importMap?: {
+        [packageName: string]: {
+          [exportName: string]: {
+            canonicalImport?: [string, string],
+            styledBaseImport?: [string, string],
+          }
+        }
+      },
+    },
+  },
+}
+```
+
+### 代码压缩
+
+自 v13 起默认使用 SWC 压缩，速度比 Terser 快 7 倍。
+
+如需使用 Terser 可配置：
+
+```js filename="next.config.js"
+module.exports = {
+  swcMinify: false,
+}
+```
+
+### 模块转译
+
+Next.js 可自动转译和打包本地包（如 monorepos）或外部依赖（`node_modules`），替代 `next-transpile-modules` 包。
+
+```js filename="next.config.js"
+module.exports = {
+  transpilePackages: ['@acme/ui', 'lodash-es'],
+}
+```
+
+### 模块化导入
+
+此功能在 Next.js 13.5 中已被 [`optimizePackageImports`](/docs/app/api-reference/next-config-js/optimizePackageImports) 取代，建议升级使用无需手动配置的新方案。
+
+## 实验性功能
+
+### SWC 性能分析
+
+可生成符合 Chromium [trace event 格式](https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview?mode=html#%21=)的分析数据。
+
+```js filename="next.config.js"
+module.exports = {
+  experimental: {
+    swcTraceProfiling: true,
+  },
+}
+```
+
+启用后会在 `.next/` 下生成 `swc-trace-profile-${timestamp}.json` 文件，可用 Chromium 跟踪查看器或兼容的火焰图工具查看。
+
+### SWC 插件（实验性）
+
+可通过 WASM 编写的实验性插件自定义转换行为：
+
+```js filename="next.config.js"
+module.exports = {
+  experimental: {
+    swcPlugins: [
+      [
+        'plugin',
+        {
+          ...pluginOptions,
+        },
+      ],
+    ],
+  },
+}
+```
+
+`swcPlugins` 接受插件配置元组数组，包含插件路径（npm 包名或 .wasm 二进制文件绝对路径）和配置对象。
+
+## 不支持的功能
+
+当应用存在 `.babelrc` 文件时，Next.js 会自动回退使用 Babel 转换文件，确保与使用自定义 Babel 插件的现有应用兼容。
+
+如果您使用自定义 Babel 配置，[请分享您的配置](https://github.com/vercel/next.js/discussions/30174)。我们正在移植常用 Babel 转换功能，未来将支持插件系统。
+
+## 版本历史
+
+| 版本       | 变更                                                                                                                                                                                                 |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `v13.1.0` | [模块转译](https://nextjs.org/blog/next-13-1#built-in-module-transpilation-stable) 和 [模块化导入](https://nextjs.org/blog/next-13-1#import-resolution-for-smaller-bundles) 功能稳定 |
+| `v13.0.0` | 默认启用 SWC 压缩器                                                                                                                                                                                 |
+| `v12.3.0` | SWC 压缩器[稳定](https://nextjs.org/blog/next-12-3#swc-minifier-stable)                                                                                                                             |
+| `v12.2.0` | 新增 [SWC 插件](#swc-插件实验性) 实验性支持                                                                                                                                                         |
+| `v12.1.0` | 新增 Styled Components、Jest、Relay、移除 React 属性、传统装饰器、移除 Console 和 jsxImportSource 支持                                                                                              |
+| `v12.0.0` | 正式推出 [Next.js 编译器](https://nextjs.org/blog/next-12)                                                                                                                                          |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/supported-browsers.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/supported-browsers.mdx
new file mode 100644
index 00000000..0347fcc2
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/supported-browsers.mdx
@@ -0,0 +1,72 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:16.545Z
+title: 支持的浏览器
+description: Next.js 的浏览器支持情况及其支持的 JavaScript 功能。
+---
+
+Next.js **开箱即用支持现代浏览器**，无需额外配置：
+
+- Chrome 64+
+- Edge 79+
+- Firefox 67+
+- Opera 51+
+- Safari 12+
+
+## Browserslist
+
+如需针对特定浏览器或功能，Next.js 支持在 `package.json` 中配置 [Browserslist](https://browsersl.ist)。默认使用以下配置：
+
+```json filename="package.json"
+{
+  "browserslist": [
+    "chrome 64",
+    "edge 79",
+    "firefox 67",
+    "opera 51",
+    "safari 12"
+  ]
+}
+```
+
+## Polyfills
+
+我们自动注入了[广泛使用的 polyfill](https://github.com/vercel/next.js/blob/canary/packages/next-polyfill-nomodule/src/index.js)，包括：
+
+- [**fetch()**](https://developer.mozilla.org/docs/Web/API/Fetch_API) — 替代方案：`whatwg-fetch` 和 `unfetch`
+- [**URL**](https://developer.mozilla.org/docs/Web/API/URL) — 替代方案：[`url` 包 (Node.js API)](https://nodejs.org/api/url.html)
+- [**Object.assign()**](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign) — 替代方案：`object-assign`、`object.assign` 和 `core-js/object/assign`
+
+如果依赖项已包含这些 polyfill，生产构建时会自动去重以避免重复加载。
+
+此外，为减少包体积，Next.js 只会为需要 polyfill 的浏览器加载它们。全球大部分网络流量不会下载这些 polyfill。
+
+### 自定义 Polyfill
+
+若您的代码或外部 npm 依赖需要目标浏览器不支持的功能（如 IE 11），需自行添加 polyfill。
+
+此时，应在[自定义 `<App>`](/docs/pages/building-your-application/routing/custom-app) 或具体组件中**按需导入特定 polyfill**。
+
+## JavaScript 语言特性
+
+Next.js 默认支持最新 JavaScript 特性，除 [ES6 功能](https://github.com/lukehoban/es6features)外还包括：
+
+- [Async/await](https://github.com/tc39/ecmascript-asyncawait) (ES2017)
+- [对象展开/剩余属性](https://github.com/tc39/proposal-object-rest-spread) (ES2018)
+- [动态 `import()`](https://github.com/tc39/proposal-dynamic-import) (ES2020)
+- [可选链](https://github.com/tc39/proposal-optional-chaining) (ES2020)
+- [空值合并](https://github.com/tc39/proposal-nullish-coalescing) (ES2020)
+- [类字段](https://github.com/tc39/proposal-class-fields) 与 [静态属性](https://github.com/tc39/proposal-static-class-features) (stage 3 提案)
+- 以及更多！
+
+### 服务端 Polyfill
+
+除客户端 `fetch()` 外，Next.js 还在 Node.js 环境中自动 polyfill `fetch()`（使用与 Node.js 相同的 `undici` 实现）。您可在服务端代码（如 `getStaticProps`/`getServerSideProps`）中直接使用 `fetch()`，无需额外引入 `isomorphic-unfetch` 或 `node-fetch`。
+
+### TypeScript 特性
+
+Next.js 内置 TypeScript 支持。[了解更多](/docs/pages/building-your-application/configuring/typescript)。
+
+### 自定义 Babel 配置（高级）
+
+支持自定义 Babel 配置。[了解更多](/docs/pages/building-your-application/configuring/babel)。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/04-architecture/turbopack.mdx b/apps/docs/content/zh-hans/docs/13/04-architecture/turbopack.mdx
new file mode 100644
index 00000000..38690bf2
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/04-architecture/turbopack.mdx
@@ -0,0 +1,31 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:13:54.801Z
+title: Turbopack
+description: Turbopack 是一个专为 JavaScript 和 TypeScript 优化的增量打包工具，采用 Rust 编写，并内置于 Next.js 中。
+---
+
+[Turbopack](https://turbo.build/pack) (测试版) 是一个专为 JavaScript 和 TypeScript 优化的增量打包工具，采用 Rust 编写，并内置于 Next.js 中。
+
+## 使用方法
+
+Turbopack 可在 Next.js 的 `pages` 和 `app` 目录中使用，以加速本地开发。要启用 Turbopack，请在运行 Next.js 开发服务器时使用 `--turbo` 标志。
+
+```json filename="package.json" highlight={3}
+{
+  "scripts": {
+    "dev": "next dev --turbo",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  }
+}
+```
+
+## 支持的功能
+
+要了解 Turbopack 当前支持的功能，请查看 [文档](https://turbo.build/pack/docs/features)。
+
+## 不支持的功能
+
+Turbopack 目前仅支持 `next dev`，不支持 `next build`。我们正在努力实现对构建的支持，以逐步实现稳定版本。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/13/05-community/01-contribution-guide.mdx b/apps/docs/content/zh-hans/docs/13/05-community/01-contribution-guide.mdx
new file mode 100644
index 00000000..eb1dcc01
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/05-community/01-contribution-guide.mdx
@@ -0,0 +1,410 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:11.027Z
+title: 文档贡献指南
+nav_title: 贡献指南
+description: 了解如何为 Next.js 文档做出贡献
+---
+
+欢迎阅读 Next.js 文档贡献指南！我们很高兴您的加入。
+
+本页面提供了编辑 Next.js 文档的指导说明。我们的目标是让社区中的每个人都能轻松参与并改进文档。
+
+## 为何贡献？
+
+开源工作永无止境，文档亦是如此。贡献文档是初学者参与开源的好方式，也是经验丰富的开发者分享知识、澄清复杂概念的机会。
+
+通过为 Next.js 文档做贡献，您正在帮助我们为所有开发者构建更强大的学习资源。无论是发现拼写错误、难以理解的章节，还是意识到某个主题缺失，您的贡献都备受欢迎和赞赏。
+
+## 如何贡献
+
+文档内容位于 [Next.js 代码库](https://github.com/vercel/next.js/tree/canary/docs)。您可以直接在 GitHub 上编辑文件，或克隆代码库后在本地修改。
+
+### GitHub 工作流
+
+如果您是 GitHub 新手，建议阅读 [GitHub 开源指南](https://opensource.guide/how-to-contribute/#opening-a-pull-request) 了解如何复刻仓库、创建分支和提交拉取请求。
+
+> **须知**：文档底层代码存放在私有代码库中，会同步到 Next.js 公共仓库。这意味着您无法在本地预览文档变更，但合并拉取请求后可以在 [nextjs.org](https://nextjs.org/docs) 看到修改效果。
+
+### 编写 MDX
+
+文档采用 [MDX](https://mdxjs.com/) 格式编写，这是一种支持 JSX 语法的 Markdown 格式。这使得我们能在文档中嵌入 React 组件。请参阅 [GitHub Markdown 指南](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) 快速了解 Markdown 语法。
+
+### VSCode 配置
+
+#### 本地预览修改
+
+VSCode 内置了 Markdown 预览器，可用于本地查看编辑效果。要为 MDX 文件启用预览器，需在用户设置中添加配置项。
+
+打开命令面板（Mac 使用 `⌘ + ⇧ + P`，Windows 使用 `Ctrl + Shift + P`），搜索 `Preferences: Open User Settings (JSON)`。
+
+然后在 `settings.json` 文件中添加以下内容：
+
+```json filename="settings.json"
+{
+  "files.associations": {
+    "*.mdx": "markdown"
+  }
+}
+```
+
+再次打开命令面板，搜索 `Markdown: Preview File` 或 `Markdown: Open Preview to the Side`，这将打开预览窗口显示格式化后的内容。
+
+#### 推荐扩展
+
+我们为 VSCode 用户推荐以下扩展：
+
+- [MDX](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx)：提供 MDX 的智能提示和语法高亮
+- [Grammarly](https://marketplace.visualstudio.com/items?itemName=znck.grammarly)：语法和拼写检查工具
+- [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)：保存时自动格式化 MDX 文件
+
+### 审核流程
+
+提交贡献后，Next.js 或开发者体验团队将审核您的修改，提供反馈并在准备就绪时合并拉取请求。
+
+如有任何问题或需要进一步帮助，请在 PR 评论中告知我们。感谢您为 Next.js 文档做出贡献并成为我们社区的一员！
+
+> **提示**：提交 PR 前可运行 `pnpm prettier-fix` 执行 Prettier 格式化。
+
+## 文件结构
+
+文档采用**文件系统路由**。每个文件夹和 [`/docs`](https://github.com/vercel/next.js/tree/canary/docs) 内的文件代表一个路由段，用于生成 URL 路径、导航和面包屑导航。
+
+文件结构反映网站导航，默认情况下导航项按字母顺序排序。但我们可以通过在文件夹或文件名前添加两位数编号 (`00-`) 来调整顺序。
+
+例如在 [函数 API 参考](/docs/app/api-reference/functions) 中，页面按字母排序便于开发者查找特定函数：
+
+```txt
+03-functions
+├── cookies.mdx
+├── draft-mode.mdx
+├── fetch.mdx
+└── ...
+```
+
+而在 [路由章节](/docs/app/building-your-application/routing) 中，文件添加了两位数前缀，按学习顺序排列：
+
+```txt
+02-routing
+├── 01-defining-routes.mdx
+├── 02-pages-and-layouts.mdx
+├── 03-linking-and-navigating.mdx
+└── ...
+```
+
+要快速定位页面，可在 VSCode 中使用 `⌘ + P` (Mac) 或 `Ctrl + P` (Windows) 打开搜索栏，输入页面 slug。例如 `defining-routes`
+
+> **为何不使用清单文件？**
+>
+> 我们考虑过使用清单文件（另一种流行的文档导航生成方式），但发现清单容易与文件不同步。文件系统路由迫使我们思考文档结构，也更符合 Next.js 的原生特性。
+
+## 元数据
+
+每个文件顶部都有一个由三个破折号分隔的元数据块。
+
+### 必填字段
+
+以下字段为**必填项**：
+
+| 字段          | 说明                                      |
+| ------------- | ----------------------------------------- |
+| `title`       | 页面 `<h1>` 标题，用于 SEO 和 OG 图片     |
+| `description` | 页面描述，用于 SEO 的 `<meta name="description">` 标签 |
+
+```yaml filename="required-fields.mdx"
+---
+title: 页面标题
+description: 页面描述
+---
+```
+
+最佳实践是将标题限制在 2-3 个词（如"图片优化"），描述控制在 1-2 句话（如"学习如何在 Next.js 中优化图片"）。
+
+### 可选字段
+
+以下字段为**可选项**：
+
+| 字段        | 说明                                                                 |
+| ----------- | -------------------------------------------------------------------- |
+| `nav_title` | 覆盖导航中显示的标题。当页面标题过长时特别有用，未提供时使用 `title` |
+| `source`    | 从共享页面拉取内容。参见 [共享页面](#共享页面)                       |
+| `related`   | 页面底部的相关链接列表，会自动转换为卡片。参见 [相关链接](#相关链接) |
+
+```yaml filename="optional-fields.mdx"
+---
+nav_title: 导航项标题
+source: app/building-your-application/optimizing/images
+related:
+  description: 查看图片组件 API 参考。
+  links:
+    - app/api-reference/components/image
+---
+```
+
+## `App` 与 `Pages` 文档
+
+由于**应用路由 (App Router)** 和**页面路由 (Pages Router)** 的大多数功能完全不同，它们的文档分别存放在不同章节 (`02-app` 和 `03-pages`)。但有些功能是两者共用的。
+
+### 共享页面
+
+为避免内容重复和不同步风险，我们使用 `source` 字段将内容从一个页面拉取到另一个页面。例如 `<Link>` 组件在**应用**和**页面**中的行为基本一致，我们可以从 `app/.../link.mdx` 拉取内容到 `pages/.../link.mdx`：
+
+```mdx filename="app/.../link.mdx"
+---
+title: <Link>
+description: 关于 <Link> 组件的 API 参考文档。
+---
+
+本 API 参考将帮助您理解如何使用 Link 组件的属性和配置选项。
+```
+
+```mdx filename="pages/.../link.mdx"
+---
+title: <Link>
+description: 关于 <Link> 组件的 API 参考文档。
+source: app/api-reference/components/link
+---
+
+{/* 请勿编辑本页面 */}
+{/* 本页面内容来自上方源文件 */}
+```
+
+这样我们只需在一处编辑内容，变更就会同步到两个章节。
+
+### 共享内容
+
+在共享页面中，有时可能需要区分**应用路由**或**页面路由**特有的内容。例如 `<Link>` 组件的 `shallow` 属性仅在**页面路由**中可用。
+
+为确保内容只显示在正确的路由文档中，我们可以用 `<AppOnly>` 或 `<PagesOnly>` 组件包裹内容块：
+
+```mdx filename="app/.../link.mdx"
+此内容在应用和页面路由中共享。
+
+<PagesOnly>
+
+此内容仅显示在页面路由文档中。
+
+</PagesOnly>
+
+此内容在应用和页面路由中共享。
+```
+
+这些组件通常用于示例和代码块。
+
+## 代码块
+
+代码块应包含可复制粘贴的最小工作示例，确保无需额外配置即可运行。
+
+例如展示 `<Link>` 组件用法时，应包含 `import` 语句和组件本身：
+
+```tsx filename="app/page.tsx"
+import Link from 'next/link'
+
+export default function Page() {
+  return <Link href="/about">关于</Link>
+}
+```
+
+提交前请务必在本地运行示例，确保代码是最新且可工作的。
+
+### 语言与文件名
+
+代码块应包含语言和 `filename` 的头部信息。添加 `filename` 属性会显示特殊的终端图标，帮助用户定位输入位置：
+
+````mdx filename="code-example.mdx"
+```bash filename="终端"
+npx create-next-app
+```
+````
+
+文档中大多数示例使用 `tsx` 和 `jsx`，少数使用 `bash`。但您可以使用任何支持的语言，完整列表参见 [此处](https://github.com/shikijs/shiki/blob/main/docs/languages.md#all-languages)。
+
+编写 JavaScript 代码块时，我们使用以下语言和扩展名组合：
+
+|                                | 语言    | 扩展名   |
+| ------------------------------ | ------- | -------- |
+| 含 JSX 的 JavaScript 文件      | ```jsx  | .js      |
+| 不含 JSX 的 JavaScript 文件    | ```js   | .js      |
+| 含 JSX 的 TypeScript 文件      | ```tsx  | .tsx     |
+| 不含 JSX 的 TypeScript 文件    | ```ts   | .ts      |
+
+### TS 与 JS 切换器
+
+添加语言切换器可在 TypeScript 和 JavaScript 间切换。代码块应优先提供 TypeScript 版本，同时包含 JavaScript 版本以满足不同用户需求。
+
+目前我们依次编写 TS 和 JS 示例，并通过 `switcher` 属性关联：
+
+````mdx filename="code-example.mdx"
+```tsx filename="app/page.tsx" switcher
+
+```
+
+```jsx filename="app/page.js" switcher
+
+```
+````
+
+> **须知**：我们计划未来自动将 TypeScript 代码片段编译为 JavaScript。目前可使用 [transform.tools](https://transform.tools/typescript-to-javascript) 进行转换。
+
+### 行高亮
+
+可以高亮代码行以突出特定部分。通过向 `highlight` 属性传递数字实现高亮。
+
+**单行高亮**：`highlight={1}`
+
+```tsx filename="app/page.tsx" {1}
+import Link from 'next/link'
+
+export default function Page() {
+  return <Link href="/about">关于</Link>
+}
+```
+
+**多行高亮**：`highlight={1,3}`
+
+```tsx filename="app/page.tsx" highlight={1,3}
+import Link from 'next/link'
+
+export default function Page() {
+  return <Link href="/about">关于</Link>
+}
+```
+
+**行范围高亮**：`highlight={1-5}`
+
+```tsx filename="app/page.tsx" highlight={1-5}
+import Link from 'next/link'
+
+export default function Page() {
+  return <Link href="/about">关于</Link>
+}
+```
+
+## 图标
+
+文档中可使用以下图标：
+
+```mdx filename="mdx-icon.mdx"
+<Check size={18} />
+<Cross size={18} />
+```
+
+**效果：**
+
+<Check size={18} />
+<Cross size={18} />
+
+文档中不使用表情符号。
+
+## 注释
+
+对于重要但非关键的信息，可使用注释。注释能添加信息而不分散用户对主要内容的注意力。
+
+```mdx filename="notes.mdx"
+> **须知**：这是单行注释。
+
+> **须知**：
+>
+> - 多行注释也采用此格式
+> - 有时会有多个值得了解或注意的事项
+```
+
+**效果：**
+
+> **须知**：这是单行注释。
+
+> **须知**：
+>
+> - 多行注释也采用此格式
+> - 有时会有多个值得了解或注意的事项
+
+## 相关链接
+
+相关链接通过添加逻辑后续步骤引导用户学习。
+
+- 链接会以卡片形式显示在页面主要内容下方
+- 对于有子页面的页面会自动生成链接。例如 [优化](/docs/app/building-your-application/optimizing) 章节会显示所有子页面链接
+
+使用页面元数据中的 `related` 字段创建相关链接：
+
+```yaml filename="example.mdx"
+---
+related:
+  description: 了解如何快速开始您的第一个应用。
+  links:
+    - app/building-your-application/routing/defining-routes
+    - app/building-your-application/data-fetching
+    - app/api-reference/file-conventions/page
+---
+```
+
+### 嵌套字段
+
+| 字段          | 是否必填 | 说明                                                                                     |
+| ------------- | -------- | ---------------------------------------------------------------------------------------- |
+| `title`       | 可选     | 卡片列表标题，默认为 **下一步**                                                          |
+| `description` | 可选     | 卡片列表描述                                                                            |
+| `links`       | 必填     | 其他文档页面的链接列表。每个列表项应为相对 URL 路径（不带前导斜杠），如 `app/api-reference/file-conventions/page` |
+
+## 图表
+
+图表是解释复杂概念的好方法。我们使用 [Figma](https://www.figma.com/) 创建图表，遵循 Vercel 设计指南。
+
+当前图表存放在 Next.js 私有站点的 `/public` 文件夹中。如需更新或添加图表，请提交 [GitHub issue](https://github.com/vercel/next.js/issues/new?assignees=&labels=template%3A+documentation&projects=&template=4.docs_request.yml&title=Docs%3A+)。
+
+## 自定义组件与 HTML
+
+文档中可用的 React 组件包括：`<Image />` (next/image)、`<PagesOnly />`、`<AppOnly />`、`<Cross />` 和 `<Check />`。除 `<details>` 标签外，文档中不允许使用原始 HTML。
+
+如有新组件想法，请提交 [GitHub issue](https://github.com/vercel/next.js/issues/new/choose)。
+
+## 风格指南
+
+本节为技术写作新手提供文档编写指南。
+
+### 页面模板
+
+虽然我们没有严格的页面模板，但文档中常见以下章节：
+
+- **概述**：首段应说明功能用途，随后提供最小工作示例或 API 参考
+- **约定**：如果功能有特殊约定，应在此说明
+- **示例**：展示不同使用场景下的功能用法
+- **API 表格**：API 页面应在底部提供带跳转链接的概览表格（如适用）
+- **后续步骤（相关链接）**：添加相关页面链接引导用户学习路径
+
+根据需要自由添加这些章节。
+
+### 页面类型
+
+文档页面分为两类：概念性文档和参考文档。
+
+- **概念性文档**用于解释某个概念或功能。这类文档通常篇幅较长，包含的信息比参考文档更丰富。在 Next.js 文档中，概念性文档位于**构建应用 (Building Your Application)** 部分。
+- **参考文档**用于说明具体的 API。这类文档通常更简短且专注。在 Next.js 文档中，参考文档位于**API 参考 (API Reference)** 部分。
+
+> **须知**：根据您贡献的文档类型，可能需要采用不同的语气和风格。例如，概念性文档更具指导性，会使用"您"来称呼读者；而参考文档则更技术化，会使用更多命令式词汇（如"创建、更新、接受"），并倾向于省略"您"这个词。
+
+### 写作风格
+
+以下指南有助于保持文档风格和语气的一致性：
+
+- 撰写清晰简洁的句子，避免离题
+  - 如果发现句子中使用了很多逗号，考虑将其拆分为多个句子或改用列表形式
+  - 用简单词汇替代复杂词汇，例如用"使用"而非"利用"
+- 谨慎使用"这"字，它可能造成歧义和困惑。如果指代不清，不要害怕重复主语
+  - 例如："Next.js 使用 React"优于"Next.js 使用这个"
+- 使用主动语态而非被动语态。主动句更易于阅读
+  - 例如："Next.js 使用 React"优于"React 被 Next.js 使用"。如果发现使用了"被"、"由"等词，可能正在使用被动语态
+- 避免使用"简单"、"快速"、"只需"等主观性词汇，这可能让用户感到沮丧
+- 避免使用"不要"、"不能"、"不会"等否定性词汇，这可能打击读者积极性
+  - 例如："您可以使用 `Link` 组件在页面间创建链接"优于"不要使用 `<a>` 标签在页面间创建链接"
+- 使用第二人称（您/您的），这样更具亲和力
+- 使用性别中立语言。提及受众时使用"开发者"、"用户"或"读者"
+- 如果添加代码示例，请确保格式正确且可运行
+
+虽然这些指南并不全面，但能帮助您快速入门。如需深入了解技术写作，请参阅[Google 技术写作课程](https://developers.google.com/tech-writing/overview)。
+
+---
+
+感谢您为文档做出贡献，成为 Next.js 社区的一员！
+
+{/* 待办事项：最新贡献者组件 */}
diff --git a/apps/docs/content/zh-hans/docs/13/05-community/index.mdx b/apps/docs/content/zh-hans/docs/13/05-community/index.mdx
new file mode 100644
index 00000000..853dfb11
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/13/05-community/index.mdx
@@ -0,0 +1,33 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:01.543Z
+title: Next.js 社区
+nav_title: 社区
+description: 参与 Next.js 社区互动。
+---
+
+Next.js 每周下载量超过 400 万次，拥有遍布全球的庞大开发者社区。以下是您可以参与社区互动的方式：
+
+## 贡献代码
+
+您可以通过以下几种方式为 Next.js 的发展做出贡献：
+
+- [文档](/docs/community/contribution-guide)：提出改进建议或撰写新章节，帮助用户理解如何使用 Next.js
+- [示例项目](https://github.com/vercel/next.js/tree/canary/contributing/examples)：通过创建新示例或改进现有示例，帮助开发者将 Next.js 与其他工具和服务集成
+- [代码库](https://github.com/vercel/next.js/tree/canary/contributing/core)：了解底层架构，参与错误修复，并提出新功能建议
+
+## 讨论交流
+
+如果您对 Next.js 有疑问，或想帮助他人，欢迎随时加入讨论：
+
+- [GitHub 讨论区](https://github.com/vercel/next.js/discussions)
+- [Discord](https://discord.com/invite/bUG2bvbtHy)
+- [Reddit](https://www.reddit.com/r/nextjs)
+
+## 社交媒体
+
+关注 [Twitter](https://twitter.com/nextjs) 获取最新动态，订阅 [Vercel YouTube 频道](https://www.youtube.com/@VercelHQ) 观看 Next.js 相关视频。
+
+## 行为准则
+
+我们致力于创建包容、友好的社区环境。因此，我们要求所有成员遵守[行为准则](https://github.com/vercel/next.js/blob/canary/CODE_OF_CONDUCT.md)。该文件明确了我们对参与者行为的期望，请阅读并协助我们维护安全、尊重的社区环境。
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/01-getting-started/01-installation.mdx b/apps/docs/content/zh-hans/docs/14/01-getting-started/01-installation.mdx
new file mode 100644
index 00000000..90ae2064
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/01-getting-started/01-installation.mdx
@@ -0,0 +1,196 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:14:47.894Z
+title: 安装
+description: 使用 `create-next-app` 创建新的 Next.js 应用。配置 TypeScript、样式以及 `next.config.js` 文件。
+related:
+  title: 后续步骤
+  description: 了解 Next.js 项目中的文件与目录结构。
+  links:
+    - getting-started/project-structure
+---
+
+系统要求：
+
+- [Node.js 18.17](https://nodejs.org/) 或更高版本
+- 支持 macOS、Windows（包括 WSL）和 Linux 系统
+
+## 自动安装
+
+推荐使用 [`create-next-app`](/docs/app/api-reference/cli/create-next-app) 创建新的 Next.js 应用，该工具会自动完成所有配置。执行以下命令创建项目：
+
+```bash filename="终端"
+npx create-next-app@latest
+```
+
+安装过程中会显示以下选项：
+
+```txt filename="终端"
+请输入项目名称？my-app
+是否使用 TypeScript？否 / 是
+是否使用 ESLint？否 / 是
+是否使用 Tailwind CSS？否 / 是
+是否使用 `src/` 目录？否 / 是
+是否使用 App Router？（推荐）否 / 是
+是否自定义默认导入别名 (@/*)？否 / 是
+请输入需要配置的导入别名？@/*
+```
+
+完成选项后，[`create-next-app`](/docs/app/api-reference/cli/create-next-app) 会创建以项目名命名的文件夹并安装所需依赖。
+
+如果你是 Next.js 新手，请参阅 [项目结构](/docs/getting-started/project-structure) 文档了解应用中可能存在的所有文件和目录。
+
+> **须知**：
+>
+> - Next.js 现在默认内置 [TypeScript](/docs/app/building-your-application/configuring/typescript)、[ESLint](/docs/app/building-your-application/configuring/eslint) 和 [Tailwind CSS](/docs/app/building-your-application/styling/tailwind-css) 配置
+> - 可选择在项目根目录使用 [`src` 目录](/docs/app/building-your-application/configuring/src-directory) 将应用代码与配置文件分离
+
+## 手动安装
+
+要手动创建 Next.js 应用，请先安装必要依赖包：
+
+```bash filename="终端"
+npm install next@latest react@latest react-dom@latest
+```
+
+打开 `package.json` 文件并添加以下 `scripts`：
+
+```json filename="package.json"
+{
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  }
+}
+```
+
+这些脚本对应应用开发的不同阶段：
+
+- `dev`: 运行 [`next dev`](/docs/app/api-reference/cli/next#next-dev-options) 启动开发模式
+- `build`: 运行 [`next build`](/docs/app/api-reference/cli/next#next-build-options) 构建生产环境应用
+- `start`: 运行 [`next start`](/docs/app/api-reference/cli/next#next-start-options) 启动生产服务器
+- `lint`: 运行 [`next lint`](/docs/app/api-reference/cli/next#next-lint-options) 配置内置 ESLint
+
+### 创建目录
+
+Next.js 使用文件系统路由，意味着应用路由由文件结构决定。
+
+#### `app` 目录
+
+对于新项目，推荐使用 [App Router](/docs/app)。该路由支持 React 最新特性，是根据社区反馈对 [Pages Router](/docs/pages) 的演进。
+
+创建 `app/` 文件夹后，添加 `layout.tsx` 和 `page.tsx` 文件。这些文件会在用户访问应用根路径 (`/`) 时渲染。
+
+<Image
+  alt="App 目录结构"
+  srcLight="/docs/light/app-getting-started.png"
+  srcDark="/docs/dark/app-getting-started.png"
+  width="1600"
+  height="363"
+/>
+
+在 `app/layout.tsx` 中创建包含必需 `<html>` 和 `<body>` 标签的 [根布局](/docs/app/building-your-application/routing/pages-and-layouts#root-layout-required)：
+
+```tsx filename="app/layout.tsx" switcher
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+```
+
+```jsx filename="app/layout.js" switcher
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+```
+
+最后创建包含初始内容的首页 `app/page.tsx`：
+
+```tsx filename="app/page.tsx" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+```jsx filename="app/page.js" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+> **须知**：如果忘记创建 `layout.tsx`，运行 `next dev` 启动开发服务器时 Next.js 会自动生成该文件。
+
+了解更多关于 [使用 App Router](/docs/app/building-your-application/routing/defining-routes) 的内容。
+
+#### `pages` 目录（可选）
+
+如果更倾向于使用 Pages Router 而非 App Router，可以在项目根目录创建 `pages/` 文件夹。
+
+然后在 `pages` 目录中添加 `index.tsx` 文件作为首页 (`/`)：
+
+```tsx filename="pages/index.tsx" switcher
+export default function Page() {
+  return <h1>Hello, Next.js!</h1>
+}
+```
+
+接着在 `pages/` 中添加 `_app.tsx` 文件定义全局布局。了解更多关于 [自定义 App 文件](/docs/pages/building-your-application/routing/custom-app) 的内容。
+
+```tsx filename="pages/_app.tsx" switcher
+import type { AppProps } from 'next/app'
+
+export default function App({ Component, pageProps }: AppProps) {
+  return <Component {...pageProps} />
+}
+```
+
+```jsx filename="pages/_app.js" switcher
+export default function App({ Component, pageProps }) {
+  return <Component {...pageProps} />
+}
+```
+
+最后在 `pages/` 中添加 `_document.tsx` 文件控制服务端初始响应。了解更多关于 [自定义 Document 文件](/docs/pages/building-your-application/routing/custom-document) 的内容。
+
+```tsx filename="pages/_document.tsx" switcher
+import { Html, Head, Main, NextScript } from 'next/document'
+
+export default function Document() {
+  return (
+    <Html>
+      <Head />
+      <body>
+        <Main />
+        <NextScript />
+      </body>
+    </Html>
+  )
+}
+```
+
+了解更多关于 [使用 Pages Router](/docs/pages/building-your-application/routing/pages-and-layouts) 的内容。
+
+> **须知**：虽然可以在同一项目中同时使用两种路由，但 `app` 中的路由优先级高于 `pages`。建议在新项目中仅使用一种路由以避免混淆。
+
+#### `public` 文件夹（可选）
+
+创建 `public` 文件夹存放静态资源（如图片、字体等）。`public` 目录中的文件可以通过根 URL (`/`) 在代码中引用。
+
+## 运行开发服务器
+
+1. 执行 `npm run dev` 启动开发服务器
+2. 访问 `http://localhost:3000` 查看应用
+3. 修改 `app/page.tsx`（或 `pages/index.tsx`）文件并保存后，可在浏览器中实时查看更新效果
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/01-getting-started/02-project-structure.mdx b/apps/docs/content/zh-hans/docs/14/01-getting-started/02-project-structure.mdx
new file mode 100644
index 00000000..83bd5628
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/01-getting-started/02-project-structure.mdx
@@ -0,0 +1,169 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:15:31.560Z
+title: Next.js 项目结构
+nav_title: 项目结构
+description: Next.js 项目中的文件夹与文件约定列表
+---
+
+本文概述了 Next.js 应用程序的项目结构，涵盖顶级文件与文件夹、配置文件，以及 `app` 和 `pages` 目录中的路由约定。
+
+点击文件或文件夹名称可了解每个约定的详细信息。
+
+## 顶级文件夹
+
+顶级文件夹用于组织应用程序代码和静态资源。
+
+<Image
+  alt="路由段到路径段的映射"
+  srcLight="/docs/light/top-level-folders.png"
+  srcDark="/docs/dark/top-level-folders.png"
+  width="1600"
+  height="525"
+/>
+
+|                                                                          |                                    |
+| ------------------------------------------------------------------------ | ---------------------------------- |
+| [`app`](/docs/app/building-your-application/routing)                     | 应用路由 (App Router)              |
+| [`pages`](/docs/pages/building-your-application/routing)                 | 页面路由 (Pages Router)            |
+| [`public`](/docs/app/building-your-application/optimizing/static-assets) | 待服务的静态资源                   |
+| [`src`](/docs/app/building-your-application/configuring/src-directory)   | 可选的应用程序源码目录             |
+
+## 顶级文件
+
+顶级文件用于配置应用程序、管理依赖项、运行中间件、集成监控工具以及定义环境变量。
+
+|                                                                                             |                                         |
+| ------------------------------------------------------------------------------------------- | --------------------------------------- |
+| **Next.js**                                                                                 |                                         |
+| [`next.config.js`](/docs/app/api-reference/next-config-js)                                  | Next.js 配置文件                       |
+| [`package.json`](/docs/getting-started/installation#manual-installation)                    | 项目依赖项与脚本                       |
+| [`instrumentation.ts`](/docs/app/building-your-application/optimizing/instrumentation)      | OpenTelemetry 与性能监控文件            |
+| [`middleware.ts`](/docs/app/building-your-application/routing/middleware)                   | Next.js 请求中间件                     |
+| [`.env`](/docs/app/building-your-application/configuring/environment-variables)             | 环境变量                               |
+| [`.env.local`](/docs/app/building-your-application/configuring/environment-variables)       | 本地环境变量                           |
+| [`.env.production`](/docs/app/building-your-application/configuring/environment-variables)  | 生产环境变量                           |
+| [`.env.development`](/docs/app/building-your-application/configuring/environment-variables) | 开发环境变量                           |
+| [`.eslintrc.json`](/docs/app/building-your-application/configuring/eslint)                  | ESLint 配置文件                        |
+| `.gitignore`                                                                                | Git 忽略文件与目录                     |
+| `next-env.d.ts`                                                                             | Next.js 的 TypeScript 声明文件         |
+| `tsconfig.json`                                                                             | TypeScript 配置文件                    |
+| `jsconfig.json`                                                                             | JavaScript 配置文件                    |
+
+## `app` 路由约定
+
+以下文件约定用于在 [`app` 路由](/docs/app)中定义路由和处理元数据。
+
+### 路由文件
+
+|                                                                                 |                     |                              |
+| ------------------------------------------------------------------------------- | ------------------- | ---------------------------- |
+| [`layout`](/docs/app/api-reference/file-conventions/layout)                     | `.js` `.jsx` `.tsx` | 布局文件                     |
+| [`page`](/docs/app/api-reference/file-conventions/page)                         | `.js` `.jsx` `.tsx` | 页面文件                     |
+| [`loading`](/docs/app/api-reference/file-conventions/loading)                   | `.js` `.jsx` `.tsx` | 加载状态 UI                  |
+| [`not-found`](/docs/app/api-reference/file-conventions/not-found)               | `.js` `.jsx` `.tsx` | 404 页面 UI                  |
+| [`error`](/docs/app/api-reference/file-conventions/error)                       | `.js` `.jsx` `.tsx` | 错误页面 UI                  |
+| [`global-error`](/docs/app/api-reference/file-conventions/error#global-errorjs) | `.js` `.jsx` `.tsx` | 全局错误页面 UI              |
+| [`route`](/docs/app/api-reference/file-conventions/route)                       | `.js` `.ts`         | API 端点                     |
+| [`template`](/docs/app/api-reference/file-conventions/template)                 | `.js` `.jsx` `.tsx` | 可重新渲染的布局             |
+| [`default`](/docs/app/api-reference/file-conventions/default)                   | `.js` `.jsx` `.tsx` | 并行路由的备用页面           |
+
+### 嵌套路由
+
+|                                                                              |                      |
+| ---------------------------------------------------------------------------- | -------------------- |
+| [`folder`](/docs/app/building-your-application/routing#route-segments)       | 路由段               |
+| [`folder/folder`](/docs/app/building-your-application/routing#nested-routes) | 嵌套路由段           |
+
+### 动态路由
+
+|                                                                                                           |                                  |
+| --------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| [`[folder]`](/docs/app/building-your-application/routing/dynamic-routes#convention)                       | 动态路由段                       |
+| [`[...folder]`](/docs/app/building-your-application/routing/dynamic-routes#catch-all-segments)            | 全捕获路由段                     |
+| [`[[...folder]]`](/docs/app/building-your-application/routing/dynamic-routes#optional-catch-all-segments) | 可选全捕获路由段                 |
+
+### 路由组与私有文件夹
+
+|                                                                                     |                                                  |
+| ----------------------------------------------------------------------------------- | ------------------------------------------------ |
+| [`(folder)`](/docs/app/building-your-application/routing/route-groups#convention)   | 不影响路由的分组                                 |
+| [`_folder`](/docs/app/building-your-application/routing/colocation#private-folders) | 将文件夹及其子段从路由中排除                     |
+
+### 并行与拦截路由
+
+|                                                                                                |                            |
+| ---------------------------------------------------------------------------------------------- | -------------------------- |
+| [`@folder`](/docs/app/building-your-application/routing/parallel-routes#slots)                 | 命名插槽                   |
+| [`(.)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)      | 拦截同级路由               |
+| [`(..)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)     | 拦截上一级路由             |
+| [`(..)(..)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention) | 拦截上两级路由             |
+| [`(...)folder`](/docs/app/building-your-application/routing/intercepting-routes#convention)    | 从根路由拦截               |
+
+### 元数据文件约定
+
+#### 应用图标
+
+|                                                                                                                 |                                     |                          |
+| --------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ------------------------ |
+| [`favicon`](/docs/app/api-reference/file-conventions/metadata/app-icons#favicon)                                | `.ico`                              | 网站图标文件             |
+| [`icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#icon)                                      | `.ico` `.jpg` `.jpeg` `.png` `.svg` | 应用图标文件             |
+| [`icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx)       | `.js` `.ts` `.tsx`                  | 动态生成的应用图标       |
+| [`apple-icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#apple-icon)                          | `.jpg` `.jpeg`, `.png`              | Apple 应用图标文件       |
+| [`apple-icon`](/docs/app/api-reference/file-conventions/metadata/app-icons#generate-icons-using-code-js-ts-tsx) | `.js` `.ts` `.tsx`                  | 动态生成的 Apple 应用图标 |
+
+#### Open Graph 与 Twitter 图片
+
+|                                                                                                                             |                              |                            |
+| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------- |
+| [`opengraph-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#opengraph-image)                      | `.jpg` `.jpeg` `.png` `.gif` | Open Graph 图片文件        |
+| [`opengraph-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#generate-images-using-code-js-ts-tsx) | `.js` `.ts` `.tsx`           | 动态生成的 Open Graph 图片 |
+| [`twitter-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#twitter-image)                          | `.jpg` `.jpeg` `.png` `.gif` | Twitter 图片文件           |
+| [`twitter-image`](/docs/app/api-reference/file-conventions/metadata/opengraph-image#generate-images-using-code-js-ts-tsx)   | `.js` `.ts` `.tsx`           | 动态生成的 Twitter 图片    |
+
+#### SEO
+
+|                                                                                                              |             |                       |
+| ------------------------------------------------------------------------------------------------------------ | ----------- | --------------------- |
+| [`sitemap`](/docs/app/api-reference/file-conventions/metadata/sitemap#sitemap-files-xml)                     | `.xml`      | 站点地图文件          |
+| [`sitemap`](/docs/app/api-reference/file-conventions/metadata/sitemap#generating-a-sitemap-using-code-js-ts) | `.js` `.ts` | 动态生成的站点地图    |
+| [`robots`](/docs/app/api-reference/file-conventions/metadata/robots#static-robotstxt)                        | `.txt`      | Robots 文件           |
+| [`robots`](/docs/app/api-reference/file-conventions/metadata/robots#generate-a-robots-file)                  | `.js` `.ts` | 动态生成的 Robots 文件 |
+
+## `pages` 路由约定
+
+以下文件约定用于在 [`pages` 路由](/docs/pages)中定义路由。
+
+### 特殊文件
+
+|                                                                                                             |                     |                   |
+| ----------------------------------------------------------------------------------------------------------- | ------------------- | ----------------- |
+| [`_app`](/docs/pages/building-your-application/routing/custom-app)                                          | `.js` `.jsx` `.tsx` | 自定义 App        |
+| [`_document`](/docs/pages/building-your-application/routing/custom-document)                                | `.js` `.jsx` `.tsx` | 自定义 Document   |
+| [`_error`](/docs/pages/building-your-application/routing/custom-error#more-advanced-error-page-customizing) | `.js` `.jsx` `.tsx` | 自定义错误页面    |
+| [`404`](/docs/pages/building-your-application/routing/custom-error#404-page)                                | `.js` `.jsx` `.tsx` | 404 错误页面      |
+| [`500`](/docs/pages/building-your-application/routing/custom-error#500-page)                                | `.js` `.jsx` `.tsx` | 500 错误页面      |
+
+### 路由
+
+|                                                                                                |                     |             |
+| ---------------------------------------------------------------------------------------------- | ------------------- | ----------- |
+| **文件夹约定**                                                                                 |                     |             |
+| [`index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes)        | `.js` `.jsx` `.tsx` | 首页        |
+| [`folder/index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes) | `.js` `.jsx` `.tsx` | 嵌套页面    |
+| **文件约定**                                                                                   |                     |             |
+| [`index`](/docs/pages/building-your-application/routing/pages-and-layouts#index-routes)        | `.js` `.jsx` `.tsx` | 首页        |
+| [`file`](/docs/pages/building-your-application/routing/pages-and-layouts)                      | `.js` `.jsx` `.tsx` | 嵌套页面    |
+
+### 动态路由
+
+|                                                                                                                   |                     |                                  |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------- | -------------------------------- |
+| **文件夹约定**                                                                                                    |                     |                                  |
+| [`[folder]/index`](/docs/pages/building-your-application/routing/dynamic-routes)                                  | `.js` `.jsx` `.tsx` | 动态路由段                       |
+| [`[...folder]/index`](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments)            | `.js` `.jsx` `.tsx` | 全捕获路由段                     |
+| [`[[...folder]]/index`](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments) | `.js` `.jsx` `.tsx` | 可选全捕获路由段                 |
+| **文件约定**                                                                                                      |                     |                                  |
+| [`[file]`](/docs/pages/building-your-application/routing/dynamic-routes)                                          | `.js` `.jsx` `.tsx` | 动态路由段                       |
+| [`[...file]`](/docs/pages/building-your-application/routing/dynamic-routes#catch-all-segments)                    | `.js` `.jsx` `.tsx` | 全捕获路由段                     |
+| [`[[...file]]`](/docs/pages/building-your-application/routing/dynamic-routes#optional-catch-all-segments)         | `.js` `.jsx` `.tsx` | 可选全捕获路由段                 |
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/02-app/01-building-your-application/index.mdx b/apps/docs/content/zh-hans/docs/14/02-app/01-building-your-application/index.mdx
new file mode 100644
index 00000000..0ffbcc09
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/02-app/01-building-your-application/index.mdx
@@ -0,0 +1,24 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:17:02.660Z
+title: 构建应用
+description: 学习如何使用 Next.js 功能来构建您的应用。
+---
+
+{/* 本文档内容在应用路由器和页面路由器之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由器的内容。任何共享内容不应包裹在组件中。 */}
+
+Next.js 提供了构建灵活、全栈 Web 应用的基础模块。**构建应用**指南将解释如何使用这些功能以及如何自定义应用行为。
+
+章节和页面按从基础到高级的顺序组织，因此您在构建 Next.js 应用时可以逐步遵循。不过，您也可以按任意顺序阅读或直接跳转到符合您用例的页面。
+
+<AppOnly>
+
+如果您是 Next.js 新手，我们建议从 [路由](/docs/app/building-your-application/routing)、[渲染](/docs/app/building-your-application/rendering)、[数据获取](/docs/app/building-your-application/data-fetching) 和 [样式](/docs/app/building-your-application/styling) 部分开始，这些章节介绍了 Next.js 和 Web 的基础概念以帮助您入门。然后，您可以深入探索其他部分，如 [优化](/docs/app/building-your-application/optimizing) 和 [配置](/docs/app/building-your-application/configuring)。最后，当您准备就绪时，可以查看 [部署](/docs/app/building-your-application/deploying) 和 [升级](/docs/app/building-your-application/upgrading) 部分。
+
+</AppOnly>
+
+<PagesOnly>
+
+如果您是 Next.js 新手，我们建议从 [路由](/docs/pages/building-your-application/routing)、[渲染](/docs/pages/building-your-application/rendering)、[数据获取](/docs/pages/building-your-application/data-fetching) 和 [样式](/docs/pages/building-your-application/styling) 部分开始，这些章节介绍了 Next.js 和 Web 的基础概念以帮助您入门。然后，您可以深入探索其他部分，如 [优化](/docs/pages/building-your-application/optimizing) 和 [配置](/docs/pages/building-your-application/configuring)。最后，当您准备就绪时，可以查看 [部署](/docs/pages/building-your-application/deploying) 和 [升级](/docs/pages/building-your-application/upgrading) 部分。
+
+</PagesOnly>
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/07-edge.mdx b/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/07-edge.mdx
new file mode 100644
index 00000000..d6b465db
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/07-edge.mdx
@@ -0,0 +1,166 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:19:25.022Z
+title: Edge 运行时
+description: Edge 运行时的 API 参考文档。
+---
+
+{/* 本文档内容在应用路由和页面路由之间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。任何共享内容不应包裹在组件中。 */}
+
+Next.js 的 Edge 运行时基于标准 Web API，支持以下 API：
+
+## 网络 API
+
+| API                                                                             | 描述                          |
+| ------------------------------------------------------------------------------- | ----------------------------- |
+| [`Blob`](https://developer.mozilla.org/docs/Web/API/Blob)                       | 表示二进制大对象 (Blob)        |
+| [`fetch`](https://developer.mozilla.org/docs/Web/API/Fetch_API)                 | 获取资源                      |
+| [`FetchEvent`](https://developer.mozilla.org/docs/Web/API/FetchEvent)           | 表示 fetch 事件               |
+| [`File`](https://developer.mozilla.org/docs/Web/API/File)                       | 表示文件对象                  |
+| [`FormData`](https://developer.mozilla.org/docs/Web/API/FormData)               | 表示表单数据                  |
+| [`Headers`](https://developer.mozilla.org/docs/Web/API/Headers)                 | 表示 HTTP 头部                |
+| [`Request`](https://developer.mozilla.org/docs/Web/API/Request)                 | 表示 HTTP 请求                |
+| [`Response`](https://developer.mozilla.org/docs/Web/API/Response)               | 表示 HTTP 响应                |
+| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams) | 表示 URL 查询参数             |
+| [`WebSocket`](https://developer.mozilla.org/docs/Web/API/WebSocket)             | 表示 WebSocket 连接           |
+
+## 编码 API
+
+| API                                                                                 | 描述                          |
+| ----------------------------------------------------------------------------------- | ----------------------------- |
+| [`atob`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/atob) | 解码 base-64 编码的字符串     |
+| [`btoa`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/btoa) | 将字符串编码为 base-64        |
+| [`TextDecoder`](https://developer.mozilla.org/docs/Web/API/TextDecoder)             | 将 Uint8Array 解码为字符串    |
+| [`TextDecoderStream`](https://developer.mozilla.org/docs/Web/API/TextDecoderStream) | 可链式调用的流解码器          |
+| [`TextEncoder`](https://developer.mozilla.org/docs/Web/API/TextEncoder)             | 将字符串编码为 Uint8Array     |
+| [`TextEncoderStream`](https://developer.mozilla.org/docs/Web/API/TextEncoderStream) | 可链式调用的流编码器          |
+
+## 流 API
+
+| API                                                                                                     | 描述                          |
+| ------------------------------------------------------------------------------------------------------- | ----------------------------- |
+| [`ReadableStream`](https://developer.mozilla.org/docs/Web/API/ReadableStream)                           | 表示可读流                   |
+| [`ReadableStreamBYOBReader`](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)       | 表示可读流的读取器           |
+| [`ReadableStreamDefaultReader`](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader) | 表示可读流的默认读取器       |
+| [`TransformStream`](https://developer.mozilla.org/docs/Web/API/TransformStream)                         | 表示转换流                   |
+| [`WritableStream`](https://developer.mozilla.org/docs/Web/API/WritableStream)                           | 表示可写流                   |
+| [`WritableStreamDefaultWriter`](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter) | 表示可写流的默认写入器       |
+
+## 加密 API
+
+| API                                                                       | 描述                          |
+| ------------------------------------------------------------------------- | ----------------------------- |
+| [`crypto`](https://developer.mozilla.org/docs/Web/API/Window/crypto)      | 提供平台加密功能访问          |
+| [`CryptoKey`](https://developer.mozilla.org/docs/Web/API/CryptoKey)       | 表示加密密钥                  |
+| [`SubtleCrypto`](https://developer.mozilla.org/docs/Web/API/SubtleCrypto) | 提供常见加密原语操作（如哈希、签名、加密/解密） |
+
+## Web 标准 API
+
+| API                                                                                                                   | 描述                                                                                                                                                                                          |
+| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`AbortController`](https://developer.mozilla.org/docs/Web/API/AbortController)                                       | 允许按需中止一个或多个 DOM 请求                                                                                                                                     |
+| [`Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)                           | 表示一个值数组                                                                                                                                                                        |
+| [`ArrayBuffer`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer)               | 表示一个通用的、固定长度的原始二进制数据缓冲区                                                                                                                                            |
+| [`Atomics`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Atomics)                       | 提供原子操作作为静态方法                                                                                                                                                         |
+| [`BigInt`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigInt)                         | 表示任意精度的整数                                                                                                                                                   |
+| [`BigInt64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigInt64Array)           | 表示 64 位有符号整数的类型化数组                                                                                                                                                   |
+| [`BigUint64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/BigUint64Array)         | 表示 64 位无符号整数的类型化数组                                                                                                                                                 |
+| [`Boolean`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)                       | 表示逻辑实体，可以有两个值：`true` 和 `false`                                                                                                                              |
+| [`clearInterval`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/clearInterval)                 | 取消之前通过 `setInterval()` 设置的定时重复操作                                                                                                      |
+| [`clearTimeout`](https://developer.mozilla.org/docs/Web/API/WindowOrWorkerGlobalScope/clearTimeout)                   | 取消之前通过 `setTimeout()` 设置的定时重复操作                                                                                                       |
+| [`console`](https://developer.mozilla.org/docs/Web/API/Console)                                                       | 提供对浏览器调试控制台的访问                                                                                                                                                   |
+| [`DataView`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DataView)                     | 表示 `ArrayBuffer` 的通用视图                                                                                                                                                        |
+| [`Date`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date)                             | 以平台无关的格式表示单个时间点                                                                                                                                  |
+| [`decodeURI`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/decodeURI)                   | 解码之前由 `encodeURI` 或类似例程创建的统一资源标识符 (URI)                                                                                                |
+| [`decodeURIComponent`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent) | 解码之前由 `encodeURIComponent` 或类似例程创建的 URI 组件                                                                             |
+| [`DOMException`](https://developer.mozilla.org/docs/Web/API/DOMException)                                             | 表示 DOM 中发生的错误                                                                                                                                                           |
+| [`encodeURI`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/encodeURI)                   | 通过将某些字符的每个实例替换为一个、两个、三个或四个表示该字符 UTF-8 编码的转义序列来编码 URI           |
+| [`encodeURIComponent`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) | 通过将某些字符的每个实例替换为一个、两个、三个或四个表示该字符 UTF-8 编码的转义序列来编码 URI 组件 |
+| [`Error`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error)                           | 表示执行语句或访问属性时发生的错误                                                                                                                       |
+| [`EvalError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/EvalError)                   | 表示与全局函数 `eval()` 相关的错误                                                                                                                               |
+| [`Float32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Float32Array)             | 表示 32 位浮点数的类型化数组                                                                                                                                            |
+| [`Float64Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Float64Array)             | 表示 64 位浮点数的类型化数组                                                                                                                                            |
+| [`Function`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function)                     | 表示一个函数                                                                                                                                                                                |
+| [`Infinity`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Infinity)                     | 表示数学上的无穷大值                                                                                                                                                           |
+| [`Int8Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int8Array)                   | 表示 8 位有符号整数的类型化数组                                                                                                                                                    |
+| [`Int16Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int16Array)                 | 表示 16 位有符号整数的类型化数组                                                                                                                                                   |
+| [`Int32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Int32Array)                 | 表示 32 位有符号整数的类型化数组                                                                                                                                                   |
+| [`Intl`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl)                             | 提供国际化和本地化功能的访问                                                                                                                               |
+| [`isFinite`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/isFinite)                     | 判断一个值是否为有限数                                                                                                                                                        |
+| [`isNaN`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/isNaN)                           | 判断一个值是否为 `NaN`                                                                                                                                                           |
+| [`JSON`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON)                             | 提供将 JavaScript 值与 JSON 格式相互转换的功能                                                                                                                      |
+| [`Map`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)                               | 表示值的集合，其中每个值只能出现一次                                                                                                                              |
+| [`Math`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Math)                             | 提供对数学函数和常量的访问                                                                                                                                              |
+| [`Number`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)                         | 表示一个数值                                                                                                                                                                           |
+| [`Object`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)                         | 表示作为所有 JavaScript 对象基础的基类对象                                                                                                                                     |
+| [`parseFloat`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/parseFloat)                 | 解析字符串参数并返回浮点数                                                                                                                                         |
+| [`parseInt`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/parseInt)                     | 解析字符串参数并返回指定基数的整数                                                                                                                               |
+| [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)                       | 表示异步操作的最终完成（或失败）及其结果值                                                                                                |
+| [`Proxy`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Proxy)                           | 表示用于为基本操作（如属性查找、赋值、枚举、函数调用等）定义自定义行为的对象                                     |
+| [`queueMicrotask`](https://developer.mozilla.org/docs/Web/API/queueMicrotask)                                         | 将微任务加入队列等待执行                                                                                                                                                                    |
+| [`RangeError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RangeError)                 | 表示值不在允许的集合或范围内的错误                                                                                                                        |
+| [`ReferenceError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError)         | 表示引用不存在的变量时发生的错误                                                                                                                                       |
+| [`Reflect`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Reflect)                       | 提供可拦截 JavaScript 操作的方法                                                                                                                                             |
+| [`RegExp`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp)                         | 表示正则表达式，允许匹配字符组合                                                                                                                    |
+| [`Set`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set)                               | 表示值的集合，其中每个值只能出现一次                                                                                                                              |
+| [`setInterval`](https://developer.mozilla.org/docs/Web/API/setInterval)                                               | 以固定的时间间隔重复调用函数                                                                                                                               |
+| [`setTimeout`](https://developer.mozilla.org/docs/Web/API/setTimeout)                                                 | 在指定的毫秒数后调用函数或计算表达式                                                                                                                 |
+| [`SharedArrayBuffer`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer)   | 表示通用的、固定长度的原始二进制数据缓冲区                                                                                                                                            |
+| [`String`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)                         | 表示字符序列                                                                                                                                                                  |
+| [`structuredClone`](https://developer.mozilla.org/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)            | 创建值的深拷贝                                                                                                                                                                       |
+| [`Symbol`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Symbol)                         | 表示唯一且不可变的数据类型，用作对象属性的键                                                                                                            |
+| [`SyntaxError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError)               | 表示尝试解释语法无效代码时发生的错误                                                                                                                              |
+| [`TypeError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/TypeError)                   | 表示值不是预期类型时发生的错误                                                                                                                                         |
+| [`Uint8Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array)                 | 表示 8 位无符号整数的类型化数组                                                                                                                                                  |
+| [`Uint8ClampedArray`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray)   | 表示被限制在 0-255 范围内的 8 位无符号整数的类型化数组                                                                                                                                 |
+| [`Uint32Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array)               | 表示 32 位无符号整数的类型化数组                                                                                                                                                 |
+| [`URIError`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/URIError)                     | 表示全局 URI 处理函数使用不当时的错误                                                                                                                      |
+| [`URL`](https://developer.mozilla.org/docs/Web/API/URL)                                                               | 表示提供用于创建对象 URL 的静态方法的对象                                                                                                                          |
+| [`URLPattern`](https://developer.mozilla.org/docs/Web/API/URLPattern)                                                 | 表示 URL 模式                                                                                                                                                                             |
+| [`URLSearchParams`](https://developer.mozilla.org/docs/Web/API/URLSearchParams)                                       | 表示键/值对的集合                                                                                                                                                           |
+| [`WeakMap`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)                       | 表示键/值对的集合，其中键是弱引用                                                                                                                   |
+| [`WeakSet`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WeakSet)                       | 表示对象的集合，其中每个对象只能出现一次                                                                                                                          |
+| [`WebAssembly`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly)               | 提供对 WebAssembly 的访问                                                                                                                                                                       |
+
+## Next.js 专用 Polyfills
+
+- [`AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage)
+
+## 环境变量
+
+你可以使用 `process.env` 来访问[环境变量](/docs/app/building-your-application/configuring/environment-variables)，该方式同时适用于 `next dev` 和 `next build` 命令。
+
+## 不受支持的 API
+
+Edge 运行时存在以下限制：
+
+- **不支持**原生 Node.js API。例如，你无法读写文件系统。
+- 可以使用 `node_modules`，但要求它们必须实现 ES 模块规范且不使用原生 Node.js API。
+- **不允许**直接调用 `require`。请改用 ES 模块。
+
+以下 JavaScript 语言特性已被禁用，**无法正常工作**：
+
+| API                                                                                                                             | 描述                                                                 |
+| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| [`eval`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/eval)                                       | 执行以字符串形式表示的 JavaScript 代码                               |
+| [`new Function(evalString)`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Function)               | 根据传入的代码字符串创建新函数                                       |
+| [`WebAssembly.compile`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/compile)         | 从缓冲区源码编译 WebAssembly 模块                                    |
+| [`WebAssembly.instantiate`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/instantiate) | 从缓冲区源码编译并实例化 WebAssembly 模块                            |
+
+在极少数情况下，你的代码可能包含（或导入）某些动态代码执行语句，这些语句_在运行时无法被访问_且无法通过 tree shaking 移除。你可以通过中间件或 Edge API 路由的导出配置来放宽检查，允许特定文件使用这些语句：
+
+```javascript
+export const config = {
+  runtime: 'edge', // 仅适用于 Edge API 路由
+  unstable_allowDynamic: [
+    // 允许单个文件
+    '/lib/utilities.js',
+    // 使用 glob 模式允许第三方模块 function-bind 中的所有内容
+    '**/node_modules/function-bind/**',
+  ],
+}
+```
+
+`unstable_allowDynamic` 是一个 [glob](https://github.com/micromatch/micromatch#matching-features) 模式或 glob 模式数组，用于忽略特定文件的动态代码执行检查。这些 glob 路径相对于应用程序根目录。
+
+请注意，如果这些语句在 Edge 环境中执行，_它们会抛出异常并导致运行时错误_。
diff --git a/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/index.mdx b/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/index.mdx
new file mode 100644
index 00000000..0208ab18
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/02-app/02-api-reference/index.mdx
@@ -0,0 +1,8 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:42.081Z
+title: API 参考文档
+description: 关于 App Router 的 Next.js API 参考文档。
+---
+
+Next.js API 参考文档分为以下几个部分：
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/01-building-your-application/index.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/01-building-your-application/index.mdx
new file mode 100644
index 00000000..ad961738
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/01-building-your-application/index.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:38.449Z
+title: 构建您的应用
+description: 学习如何使用 Next.js 功能来构建您的应用。
+source: app/building-your-application
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑本页内容，请在编辑器中导航至源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-report-web-vitals.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-report-web-vitals.mdx
new file mode 100644
index 00000000..6ef67667
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-report-web-vitals.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:47.752Z
+title: useReportWebVitals
+description: useReportWebVitals 钩子函数
+source: app/api-reference/functions/use-report-web-vitals
+---
+
+{/* 请勿直接编辑此文档。本文档内容是从上述源文件自动生成的。如需编辑本页内容，请前往编辑器的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加专属于 Pages 路由器的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-router.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-router.mdx
new file mode 100644
index 00000000..92bab8bf
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/use-router.mdx
@@ -0,0 +1,516 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:24:26.662Z
+title: useRouter
+description: 了解 Next.js 路由器的 API，并通过 useRouter 钩子在页面中访问路由器实例。
+---
+
+如果需要在应用中的任何函数组件内访问 [`router` 对象](#router-object)，可以使用 `useRouter` 钩子，参考以下示例：
+
+```jsx
+import { useRouter } from 'next/router'
+
+function ActiveLink({ children, href }) {
+  const router = useRouter()
+  const style = {
+    marginRight: 10,
+    color: router.asPath === href ? 'red' : 'black',
+  }
+
+  const handleClick = (e) => {
+    e.preventDefault()
+    router.push(href)
+  }
+
+  return (
+    <a href={href} onClick={handleClick} style={style}>
+      {children}
+    </a>
+  )
+}
+
+export default ActiveLink
+```
+
+> `useRouter` 是一个 [React Hook](https://react.dev/learn#using-hooks)，意味着它不能与类组件一起使用。你可以使用 [withRouter](#withrouter) 或将类组件包装在函数组件中。
+
+## `router` 对象
+
+以下是 [`useRouter`](#top) 和 [`withRouter`](#withrouter) 返回的 `router` 对象的定义：
+
+- `pathname`: `String` - 当前路由文件在 `/pages` 之后的路径。因此不包含 `basePath`、`locale` 和尾部斜杠 (`trailingSlash: true`)。
+- `query`: `Object` - 解析为对象的查询字符串，包括 [动态路由](/docs/pages/building-your-application/routing/dynamic-routes) 参数。如果页面未使用 [服务端渲染 (SSR)](/docs/pages/building-your-application/data-fetching/get-server-side-props)，则在预渲染期间为空对象。默认为 `{}`。
+- `asPath`: `String` - 浏览器中显示的路径，包括搜索参数并遵循 `trailingSlash` 配置。不包含 `basePath` 和 `locale`。
+- `isFallback`: `boolean` - 当前页面是否处于 [回退模式 (fallback mode)](/docs/pages/api-reference/functions/get-static-paths#fallback-true)。
+- `basePath`: `String` - 当前激活的 [basePath](/docs/app/api-reference/next-config-js/basePath)（如果启用）。
+- `locale`: `String` - 当前激活的语言环境 (locale)（如果启用）。
+- `locales`: `String[]` - 所有支持的语言环境（如果启用）。
+- `defaultLocale`: `String` - 当前的默认语言环境（如果启用）。
+- `domainLocales`: `Array<{domain, defaultLocale, locales}>` - 任何已配置的域名语言环境。
+- `isReady`: `boolean` - 路由器字段是否已在客户端更新并准备就绪。应仅在 `useEffect` 方法中使用，不可用于服务端条件渲染。相关用例请参阅 [自动静态优化页面](/docs/pages/building-your-application/rendering/automatic-static-optimization) 文档。
+- `isPreview`: `boolean` - 应用当前是否处于 [预览模式 (preview mode)](/docs/pages/building-your-application/configuring/preview-mode)。
+
+> 如果页面使用服务端渲染或 [自动静态优化 (automatic static optimization)](/docs/pages/building-your-application/rendering/automatic-static-optimization)，使用 `asPath` 字段可能导致客户端与服务端不匹配。在 `isReady` 字段为 `true` 之前，避免使用 `asPath`。
+
+`router` 包含以下方法：
+
+### router.push
+
+处理客户端导航，此方法适用于 [`next/link`](/docs/pages/api-reference/components/link) 不够用的情况。
+
+```js
+router.push(url, as, options)
+```
+
+- `url`: `UrlObject | String` - 要导航到的 URL（`UrlObject` 属性请参阅 [Node.JS URL 模块文档](https://nodejs.org/api/url.html#legacy-urlobject)）。
+- `as`: `UrlObject | String` - 可选修饰符，用于浏览器地址栏中显示的路径。Next.js 9.5.3 之前用于动态路由。
+- `options` - 可选配置对象，包含以下选项：
+  - `scroll` - 可选布尔值，控制导航后是否滚动到页面顶部。默认为 `true`。
+  - [`shallow`](/docs/pages/building-your-application/routing/linking-and-navigating#shallow-routing): 更新当前页面路径而不重新运行 [`getStaticProps`](/docs/pages/building-your-application/data-fetching/get-static-props)、[`getServerSideProps`](/docs/pages/building-your-application/data-fetching/get-server-side-props) 或 [`getInitialProps`](/docs/pages/api-reference/functions/get-initial-props)。默认为 `false`。
+  - `locale` - 可选字符串，指定新页面的语言环境。
+
+> 外部 URL 无需使用 `router.push`。[window.location](https://developer.mozilla.org/docs/Web/API/Window/location) 更适合此类情况。
+
+导航到预定义路由 `pages/about.js`：
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  return (
+    <button type="button" onClick={() => router.push('/about')}>
+      点击我
+    </button>
+  )
+}
+```
+
+导航到动态路由 `pages/post/[pid].js`：
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  return (
+    <button type="button" onClick={() => router.push('/post/abc')}>
+      点击我
+    </button>
+  )
+}
+```
+
+将用户重定向到 `pages/login.js`，适用于 [身份验证 (authentication)](/docs/pages/building-your-application/authentication) 后的页面：
+
+```jsx
+import { useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+// 此处获取并返回用户信息
+const useUser = () => ({ user: null, loading: false })
+
+export default function Page() {
+  const { user, loading } = useUser()
+  const router = useRouter()
+
+  useEffect(() => {
+    if (!(user || loading)) {
+      router.push('/login')
+    }
+  }, [user, loading])
+
+  return <p>正在跳转...</p>
+}
+```
+
+#### 导航后重置状态
+
+在 Next.js 中导航到同一页面时，默认情况下页面状态**不会**重置，因为除非父组件发生变化，否则 React 不会卸载组件。
+
+```jsx filename="pages/[slug].js"
+import Link from 'next/link'
+import { useState } from 'react'
+import { useRouter } from 'next/router'
+
+export default function Page(props) {
+  const router = useRouter()
+  const [count, setCount] = useState(0)
+  return (
+    <div>
+      <h1>页面: {router.query.slug}</h1>
+      <p>计数: {count}</p>
+      <button onClick={() => setCount(count + 1)}>增加计数</button>
+      <Link href="/one">one</Link> <Link href="/two">two</Link>
+    </div>
+  )
+}
+```
+
+在上例中，在 `/one` 和 `/two` 之间导航**不会**重置计数。`useState` 在渲染之间保持不变，因为顶级 React 组件 `Page` 是相同的。
+
+如果不希望此行为，你有几个选择：
+
+- 使用 `useEffect` 手动更新每个状态。在上例中，可以这样实现：
+
+  ```jsx
+  useEffect(() => {
+    setCount(0)
+  }, [router.query.slug])
+  ```
+
+- 使用 React `key` [告诉 React 重新挂载组件](https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key)。要为所有页面实现此功能，可以使用自定义应用：
+
+  ```jsx filename="pages/_app.js"
+  import { useRouter } from 'next/router'
+
+  export default function MyApp({ Component, pageProps }) {
+    const router = useRouter()
+    return <Component key={router.asPath} {...pageProps} />
+  }
+  ```
+
+#### 使用 URL 对象
+
+可以像在 [`next/link`](/docs/pages/api-reference/components/link#with-url-object) 中一样使用 URL 对象。适用于 `url` 和 `as` 参数：
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function ReadMore({ post }) {
+  const router = useRouter()
+
+  return (
+    <button
+      type="button"
+      onClick={() => {
+        router.push({
+          pathname: '/post/[pid]',
+          query: { pid: post.id },
+        })
+      }}
+    >
+      点击此处阅读更多
+    </button>
+  )
+}
+```
+
+### router.replace
+
+类似于 [`next/link`](/docs/pages/api-reference/components/link) 中的 `replace` 属性，`router.replace` 会阻止将新 URL 添加到 `history` 堆栈中。
+
+```js
+router.replace(url, as, options)
+```
+
+- `router.replace` 的 API 与 [`router.push`](#routerpush) 完全相同。
+
+参考以下示例：
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  return (
+    <button type="button" onClick={() => router.replace('/home')}>
+      点击我
+    </button>
+  )
+}
+```
+
+### router.prefetch
+
+预取页面以实现更快的客户端导航。此方法仅适用于没有使用 [`next/link`](/docs/pages/api-reference/components/link) 的导航，因为 `next/link` 会自动处理页面预取。
+
+> 这是仅在生产环境中有效的功能。Next.js 在开发环境中不会预取页面。
+
+```js
+router.prefetch(url, as, options)
+```
+
+- `url` - 要预取的 URL，包括显式路由（如 `/dashboard`）和动态路由（如 `/product/[id]`）。
+- `as` - `url` 的可选修饰符。Next.js 9.5.3 之前用于预取动态路由。
+- `options` - 可选对象，包含以下允许的字段：
+  - `locale` - 允许提供与当前激活语言环境不同的语言环境。如果为 `false`，则 `url` 必须包含语言环境，因为当前激活的语言环境不会被使用。
+
+假设你有一个登录页面，登录后将用户重定向到仪表盘。对于这种情况，我们可以预取仪表盘以实现更快的跳转，如下例所示：
+
+```jsx
+import { useCallback, useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+export default function Login() {
+  const router = useRouter()
+  const handleSubmit = useCallback((e) => {
+    e.preventDefault()
+
+    fetch('/api/login', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        /* 表单数据 */
+      }),
+    }).then((res) => {
+      // 快速客户端跳转到已预取的仪表盘页面
+      if (res.ok) router.push('/dashboard')
+    })
+  }, [])
+
+  useEffect(() => {
+    // 预取仪表盘页面
+    router.prefetch('/dashboard')
+  }, [router])
+
+  return (
+    <form onSubmit={handleSubmit}>
+      {/* 表单字段 */}
+      <button type="submit">登录</button>
+    </form>
+  )
+}
+```
+
+### router.beforePopState
+
+在某些情况下（例如使用 [自定义服务器 (Custom Server)](/docs/pages/building-your-application/configuring/custom-server)），你可能希望监听 [popstate](https://developer.mozilla.org/docs/Web/Events/popstate) 并在路由器处理之前执行某些操作。
+
+```js
+router.beforePopState(cb)
+```
+
+- `cb` - 在 `popstate` 事件上运行的函数。该函数接收事件状态作为对象，包含以下属性：
+  - `url`: `String` - 新状态的路由。通常是 `page` 的名称。
+  - `as`: `String` - 将在浏览器中显示的 URL。
+  - `options`: `Object` - [router.push](#routerpush) 发送的附加选项。
+
+如果 `cb` 返回 `false`，Next.js 路由器将不会处理 `popstate`，你需要自行处理。请参阅 [禁用文件系统路由 (Disabling file-system routing)](/docs/pages/building-your-application/configuring/custom-server#disabling-file-system-routing)。
+
+可以使用 `beforePopState` 来操作请求或强制 SSR 刷新，如下例所示：
+
+```jsx
+import { useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  useEffect(() => {
+    router.beforePopState(({ url, as, options }) => {
+      // 我只允许这两个路由！
+      if (as !== '/' && as !== '/other') {
+        // 让 SSR 将错误路由渲染为 404。
+        window.location.href = as
+        return false
+      }
+
+      return true
+    })
+  }, [router])
+
+  return <p>欢迎访问本页面</p>
+}
+```
+
+### router.back
+
+在历史记录中后退。等同于点击浏览器的后退按钮。执行 `window.history.back()`。
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  return (
+    <button type="button" onClick={() => router.back()}>
+      点击此处返回
+    </button>
+  )
+}
+```
+
+### router.reload
+
+重新加载当前 URL。等同于点击浏览器的刷新按钮。执行 `window.location.reload()`。
+
+```jsx
+import { useRouter } from 'next/router'
+
+export default function Page() {
+  const router = useRouter()
+
+  return (
+    <button type="button" onClick={() => router.reload()}>
+      点击此处重新加载
+    </button>
+  )
+}
+```
+
+### router.events
+
+你可以监听 Next.js 路由器内部发生的不同事件。以下是支持的事件列表：
+
+- `routeChangeStart(url, { shallow })` - 路由开始变化时触发。
+- `routeChangeComplete(url, { shallow })` - 路由完全变化后触发。
+- `routeChangeError(err, url, { shallow })` - 路由变化出错或取消时触发。
+  - `err.cancelled` - 表示导航是否被取消。
+- `beforeHistoryChange(url, { shallow })` - 浏览器历史记录变化前触发。
+- `hashChangeStart(url, { shallow })` - 哈希值将变化但页面不变时触发。
+- `hashChangeComplete(url, { shallow })` - 哈希值已变化但页面不变时触发。
+
+> **须知**：这里的 `url` 是浏览器中显示的 URL，包含 [`basePath`](/docs/app/api-reference/next-config-js/basePath)。
+
+例如，要监听 `routeChangeStart` 路由器事件，打开或创建 `pages/_app.js` 并订阅事件，如下所示：
+
+```jsx
+import { useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+export default function MyApp({ Component, pageProps }) {
+  const router = useRouter()
+
+  useEffect(() => {
+    const handleRouteChange = (url, { shallow }) => {
+      console.log(
+        `应用正在跳转到 ${url} ${
+          shallow ? '使用' : '未使用'
+        } 浅路由`
+      )
+    }
+
+    router.events.on('routeChangeStart', handleRouteChange)
+
+    // 组件卸载时，使用 `off` 方法取消订阅：
+    return () => {
+      router.events.off('routeChangeStart', handleRouteChange)
+    }
+  }, [router])
+
+  return <Component {...pageProps} />
+}
+```
+
+> 本例使用 [自定义应用 (Custom App)](/docs/pages/building-your-application/routing/custom-app) (`pages/_app.js`) 订阅事件，因为它在页面导航时不会卸载，但你可以在应用中的任何组件订阅路由器事件。
+
+路由器事件应在组件挂载时（[useEffect](https://react.dev/reference/react/useEffect) 或 [componentDidMount](https://react.dev/reference/react/Component#componentdidmount) / [componentWillUnmount](https://react.dev/reference/react/Component#componentwillunmount)）或在事件发生时显式注册。
+
+如果路由加载被取消（例如快速连续点击两个链接），`routeChangeError` 将触发。传递的 `err` 将包含设置为 `true` 的 `cancelled` 属性，如下例所示：
+
+```jsx
+import { useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+export default function MyApp({ Component, pageProps }) {
+  const router = useRouter()
+
+  useEffect(() => {
+    const handleRouteChangeError = (err, url) => {
+      if (err.cancelled) {
+        console.log(`跳转到 ${url} 被取消！`)
+      }
+    }
+
+    router.events.on('routeChangeError', handleRouteChangeError)
+
+    // 组件卸载时，使用 `off` 方法取消订阅：
+    return () => {
+      router.events.off('routeChangeError', handleRouteChangeError)
+    }
+  }, [router])
+
+  return <Component {...pageProps} />
+}
+```
+
+## 潜在的 ESLint 错误
+
+`router` 对象上可访问的某些方法会返回 Promise。如果您启用了 ESLint 规则 [no-floating-promises](https://typescript-eslint.io/rules/no-floating-promises)，可以考虑全局禁用该规则，或仅在受影响的行中禁用。
+
+如果您的应用需要此规则，您应该使用 `void` 处理 Promise —— 或者使用 `async` 函数、`await` Promise，然后 void 函数调用。**当方法在 `onClick` 处理程序内部调用时，此方法不适用**。
+
+受影响的方法包括：
+
+- `router.push`
+- `router.replace`
+- `router.prefetch`
+
+### 可能的解决方案
+
+```jsx
+import { useEffect } from 'react'
+import { useRouter } from 'next/router'
+
+// 这里您将获取并返回用户
+const useUser = () => ({ user: null, loading: false })
+
+export default function Page() {
+  const { user, loading } = useUser()
+  const router = useRouter()
+
+  useEffect(() => {
+    // 在下一行禁用 lint 检查 - 这是最简洁的解决方案
+    // eslint-disable-next-line no-floating-promises
+    router.push('/login')
+
+    // 使用 void 处理 router.push 返回的 Promise
+    if (!(user || loading)) {
+      void router.push('/login')
+    }
+    // 或者使用 async 函数，await Promise，然后 void 函数调用
+    async function handleRouteChange() {
+      if (!(user || loading)) {
+        await router.push('/login')
+      }
+    }
+    void handleRouteChange()
+  }, [user, loading])
+
+  return <p>Redirecting...</p>
+}
+```
+
+## withRouter
+
+如果 [`useRouter`](#router-object) 不适合您的需求，`withRouter` 也可以将相同的 [`router` 对象](#router-object) 添加到任何组件中。
+
+### 使用方法
+
+```jsx
+import { withRouter } from 'next/router'
+
+function Page({ router }) {
+  return <p>{router.pathname}</p>
+}
+
+export default withRouter(Page)
+```
+
+### TypeScript
+
+要在类组件中使用 `withRouter`，组件需要接受 router 属性：
+
+```tsx
+import React from 'react'
+import { withRouter, NextRouter } from 'next/router'
+
+interface WithRouterProps {
+  router: NextRouter
+}
+
+interface MyComponentProps extends WithRouterProps {}
+
+class MyComponent extends React.Component<MyComponentProps> {
+  render() {
+    return <p>{this.props.router.pathname}</p>
+  }
+}
+
+export default withRouter(MyComponent)
+```
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/userAgent.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/userAgent.mdx
new file mode 100644
index 00000000..589a6b34
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/02-functions/userAgent.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:46.398Z
+title: userAgent
+description: userAgent 辅助工具扩展了 Web Request API，提供了额外的属性和方法，用于与请求中的用户代理 (user agent) 对象进行交互。
+source: app/api-reference/functions/userAgent
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请前往编辑器的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/assetPrefix.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/assetPrefix.mdx
new file mode 100644
index 00000000..e1cf41d4
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/assetPrefix.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:45.624Z
+title: assetPrefix
+description: 了解如何使用 assetPrefix 配置选项来配置您的 CDN (内容分发网络)。
+source: app/api-reference/next-config-js/assetPrefix
+---
+
+{/* 请勿编辑。本文档内容源自上方源文件。如需编辑页面内容，请前往编辑器中的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/basePath.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/basePath.mdx
new file mode 100644
index 00000000..e794ea75
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/basePath.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:39.068Z
+title: basePath
+description: 使用 `basePath` 将 Next.js 应用部署在域名的子路径下。
+source: app/api-reference/next-config-js/basePath
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请前往编辑器中的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/compress.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/compress.mdx
new file mode 100644
index 00000000..112d2712
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/compress.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:38.527Z
+title: compress
+description: Next.js 提供了 gzip 压缩功能来压缩渲染内容和静态文件，该功能仅适用于服务端目标 (server target)。了解更多相关信息请点击此处。
+source: app/api-reference/next-config-js/compress
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。你可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/crossOrigin.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/crossOrigin.mdx
new file mode 100644
index 00000000..c174fbb4
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/crossOrigin.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:37.077Z
+title: crossOrigin
+description: 使用 `crossOrigin` 选项可在 `next/script` 和 `next/head` 生成的 `script` 标签上添加跨域属性。
+source: app/api-reference/next-config-js/crossOrigin
+---
+
+{/* 本文档内容在应用路由和页面路由间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加页面路由专属内容。所有共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/devIndicators.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/devIndicators.mdx
new file mode 100644
index 00000000..75ba904f
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/devIndicators.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:34.660Z
+title: devIndicators
+description: 经过优化的页面会包含一个指示器，用于告知该页面是否正在进行静态优化。您可以在此处选择关闭该功能。
+source: app/api-reference/next-config-js/devIndicators
+---
+
+{/* 请勿编辑。本文档内容源自上方指定来源。如需编辑本页内容，请前往编辑器中对应的源文件。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/distDir.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/distDir.mdx
new file mode 100644
index 00000000..d673a62d
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/distDir.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:29.063Z
+title: distDir
+description: 设置自定义构建目录以替代默认的 .next 目录。
+source: app/api-reference/next-config-js/distDir
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/env.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/env.mdx
new file mode 100644
index 00000000..61ba03f1
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/env.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:31.511Z
+title: env
+description: 学习如何在构建时向 Next.js 应用添加并访问环境变量。
+source: app/api-reference/next-config-js/env
+---
+
+{/* 请勿编辑。本文档内容源自上方链接的源文件。如需编辑本页内容，请在编辑器中打开源文件。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/eslint.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/eslint.mdx
new file mode 100644
index 00000000..4260f88c
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/eslint.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:29.967Z
+title: eslint
+description: Next.js 在构建过程中默认会报告 ESLint 错误和警告。本文介绍如何禁用此行为。
+source: app/api-reference/next-config-js/eslint
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/exportPathMap.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/exportPathMap.mdx
new file mode 100644
index 00000000..0d1914d3
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/exportPathMap.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:26.587Z
+title: exportPathMap
+description: 自定义在使用 `next export` 时会被导出为 HTML 文件的页面。
+source: app/api-reference/next-config-js/exportPathMap
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请前往编辑器中的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateBuildId.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateBuildId.mdx
new file mode 100644
index 00000000..b606ca77
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateBuildId.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:21.449Z
+title: generateBuildId
+description: 配置构建 ID，用于标识当前服务应用所使用的构建版本。
+source: app/api-reference/next-config-js/generateBuildId
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateEtags.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateEtags.mdx
new file mode 100644
index 00000000..dc957c20
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/generateEtags.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:21.933Z
+title: generateEtags
+description: Next.js 默认会为每个页面生成 etag。在此了解如何禁用 etag 生成。
+source: app/api-reference/next-config-js/generateEtags
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/headers.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/headers.mdx
new file mode 100644
index 00000000..5d7eff72
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/headers.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:18.717Z
+title: headers
+description: 为你的 Next.js 应用添加自定义 HTTP 头部
+source: app/api-reference/next-config-js/headers
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑本页内容，请前往编辑器中的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/httpAgentOptions.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/httpAgentOptions.mdx
new file mode 100644
index 00000000..14122394
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/httpAgentOptions.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:19.296Z
+title: httpAgentOptions
+description: Next.js 默认会自动使用 HTTP Keep-Alive。了解如何在此处禁用 HTTP Keep-Alive。
+source: app/api-reference/next-config-js/httpAgentOptions
+---
+
+{/* 请勿编辑。本文档内容源自上方指定来源。如需编辑本页内容，请前往编辑器中的源页面进行操作。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/images.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/images.mdx
new file mode 100644
index 00000000..0b9f94a0
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/images.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:11.913Z
+title: images
+description: 关于 next/image 加载器的自定义配置
+source: app/api-reference/next-config-js/images
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请前往编辑器中的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/index.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/index.mdx
new file mode 100644
index 00000000..20f3fc0f
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/index.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:13.964Z
+title: next.config.js 配置选项
+description: 了解 Pages Router 中 next.config.js 文件的可用配置选项。
+source: app/api-reference/next-config-js
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/instrumentationHook.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/instrumentationHook.mdx
new file mode 100644
index 00000000..42fae4e7
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/instrumentationHook.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:11.542Z
+title: instrumentationHook
+description: 使用 instrumentationHook 选项在您的 Next.js 应用中设置监控工具
+source: app/api-reference/next-config-js/instrumentationHook
+---
+
+{/* 本文档内容在应用路由和页面路由间共享。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于页面路由的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/onDemandEntries.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/onDemandEntries.mdx
new file mode 100644
index 00000000..5a8fda1b
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/onDemandEntries.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:09.418Z
+title: onDemandEntries
+description: 配置 Next.js 在开发环境下如何处理内存中页面的创建与释放。
+source: app/api-reference/next-config-js/onDemandEntries
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需修改页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加仅适用于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/optimizePackageImports.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/optimizePackageImports.mdx
new file mode 100644
index 00000000..eb6030b8
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/optimizePackageImports.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:03.586Z
+title: optimizePackageImports
+description: 关于 Next.js 配置选项 optmizedPackageImports 的 API 参考文档
+source: app/api-reference/next-config-js/compress
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/output.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/output.mdx
new file mode 100644
index 00000000..2599e529
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/output.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:03.425Z
+title: output
+description: Next.js 会自动追踪每个页面所需的文件，以便轻松部署您的应用。在此了解其工作原理。
+source: app/api-reference/next-config-js/output
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑本页内容，请前往编辑器中的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/pageExtensions.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/pageExtensions.mdx
new file mode 100644
index 00000000..3e1d6309
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/pageExtensions.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:55.061Z
+title: pageExtensions
+description: 扩展 Next.js 在解析 Pages Router 中的页面时使用的默认页面扩展名。
+source: app/api-reference/next-config-js/pageExtensions
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/poweredByHeader.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/poweredByHeader.mdx
new file mode 100644
index 00000000..6f7a52d6
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/poweredByHeader.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:55.268Z
+title: poweredByHeader
+description: Next.js 默认会添加 `x-powered-by` 请求头。本文介绍如何禁用该功能。
+source: app/api-reference/next-config-js/poweredByHeader
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/productionBrowserSourceMaps.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/productionBrowserSourceMaps.mdx
new file mode 100644
index 00000000..e20cc956
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/productionBrowserSourceMaps.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:02.185Z
+title: productionBrowserSourceMaps
+description: 在生产环境构建期间启用浏览器源码映射 (source map) 生成功能。
+source: app/api-reference/next-config-js/productionBrowserSourceMaps
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑本页面内容，请前往编辑器中的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/reactStrictMode.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/reactStrictMode.mdx
new file mode 100644
index 00000000..e7ccb11b
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/reactStrictMode.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:46.695Z
+title: reactStrictMode
+description: 完整的 Next.js 运行时现已兼容严格模式 (Strict Mode)，了解如何启用该功能
+source: app/api-reference/next-config-js/reactStrictMode
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑本页内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/redirects.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/redirects.mdx
new file mode 100644
index 00000000..64dc0812
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/redirects.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:43.242Z
+title: 重定向 (redirects)
+description: 为您的 Next.js 应用添加重定向功能。
+source: app/api-reference/next-config-js/redirects
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需修改页面内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/rewrites.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/rewrites.mdx
new file mode 100644
index 00000000..3ef60466
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/rewrites.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:42.970Z
+title: rewrites
+description: 为你的 Next.js 应用添加 rewrites 重定向规则。
+source: app/api-reference/next-config-js/rewrites
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/runtime-configuration.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/runtime-configuration.mdx
new file mode 100644
index 00000000..caf840cf
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/runtime-configuration.mdx
@@ -0,0 +1,62 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:21:01.073Z
+title: 运行时配置
+description: 为你的 Next.js 应用添加客户端和服务端运行时配置。
+---
+
+> **警告：**
+>
+> - **此功能已弃用。** 我们建议改用[环境变量](/docs/pages/building-your-application/configuring/environment-variables)，它也支持读取运行时值。
+> - 你可以使用 [`register` 函数](/docs/app/building-your-application/optimizing/instrumentation)在服务端启动时运行代码。
+> - 此功能不适用于[自动静态优化 (Automatic Static Optimization)](/docs/pages/building-your-application/rendering/automatic-static-optimization)、[输出文件追踪 (Output File Tracing)](/docs/pages/api-reference/next-config-js/output#automatically-copying-traced-files) 或 [React 服务端组件 (React Server Components)](/docs/app/building-your-application/rendering/server-components)。
+
+要为应用添加运行时配置，请打开 `next.config.js` 并添加 `publicRuntimeConfig` 和 `serverRuntimeConfig` 配置：
+
+```js filename="next.config.js"
+module.exports = {
+  serverRuntimeConfig: {
+    // 仅在服务端可用
+    mySecret: 'secret',
+    secondSecret: process.env.SECOND_SECRET, // 通过环境变量传递
+  },
+  publicRuntimeConfig: {
+    // 在服务端和客户端都可用
+    staticFolder: '/static',
+  },
+}
+```
+
+将所有仅限服务端的运行时配置放在 `serverRuntimeConfig` 下。
+
+任何客户端和服务端代码均可访问的配置应放在 `publicRuntimeConfig` 下。
+
+> 依赖 `publicRuntimeConfig` 的页面**必须**使用 `getInitialProps` 或 `getServerSideProps`，或者你的应用必须具有带有 `getInitialProps` 的[自定义应用 (Custom App)](/docs/pages/building-your-application/routing/custom-app) 以退出[自动静态优化 (Automatic Static Optimization)](/docs/pages/building-your-application/rendering/automatic-static-optimization)。运行时配置不会对任何未进行服务端渲染的页面（或页面中的组件）可用。
+
+要在应用中访问运行时配置，请使用 `next/config`，如下所示：
+
+```jsx
+import getConfig from 'next/config'
+import Image from 'next/image'
+
+// 仅包含 serverRuntimeConfig 和 publicRuntimeConfig
+const { serverRuntimeConfig, publicRuntimeConfig } = getConfig()
+// 仅在服务端可用
+console.log(serverRuntimeConfig.mySecret)
+// 在服务端和客户端都可用
+console.log(publicRuntimeConfig.staticFolder)
+
+function MyImage() {
+  return (
+    <div>
+      <Image
+        src={`${publicRuntimeConfig.staticFolder}/logo.png`}
+        alt="logo"
+        layout="fill"
+      />
+    </div>
+  )
+}
+
+export default MyImage
+```
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/trailingSlash.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/trailingSlash.mdx
new file mode 100644
index 00000000..6f3d46b0
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/trailingSlash.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:36.623Z
+title: trailingSlash
+description: 配置 Next.js 页面解析时是否包含尾部斜杠。
+source: app/api-reference/next-config-js/trailingSlash
+---
+
+{/* 请勿编辑。本文档内容源自上方源文件。如需编辑页面内容，请在编辑器中打开源文件。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加仅适用于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/transpilePackages.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/transpilePackages.mdx
new file mode 100644
index 00000000..90855b2d
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/transpilePackages.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:34.528Z
+title: transpilePackages
+description: 自动转译并打包来自本地包（如 monorepos）或外部依赖项（`node_modules`）的依赖关系。
+source: app/api-reference/next-config-js/transpilePackages
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/turbo.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/turbo.mdx
new file mode 100644
index 00000000..9c45eea4
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/turbo.mdx
@@ -0,0 +1,10 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:33.940Z
+title: turbo（实验性功能）
+nav_title: turbo
+description: 配置 Next.js 的 Turbopack 专属选项
+source: app/api-reference/next-config-js/turbo
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加仅适用于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/typescript.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/typescript.mdx
new file mode 100644
index 00000000..7fedcaa5
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/typescript.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:34.458Z
+title: TypeScript
+description: Next.js 默认会报告 TypeScript 错误。本文介绍如何禁用此行为。
+source: app/api-reference/next-config-js/typescript
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑页面内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/urlImports.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/urlImports.mdx
new file mode 100644
index 00000000..e84f2263
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/urlImports.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:27.748Z
+title: urlImports
+description: 配置 Next.js 以允许从外部 URL 导入模块（实验性功能）。
+source: app/api-reference/next-config-js/urlImports
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。如需编辑本页内容，请在编辑器中导航至源文件。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webVitalsAttribution.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webVitalsAttribution.mdx
new file mode 100644
index 00000000..91f8e4ca
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webVitalsAttribution.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:25.789Z
+title: webVitalsAttribution
+description: 了解如何使用 webVitalsAttribution 选项来定位 Web Vitals 问题的根源。
+source: app/api-reference/next-config-js/webVitalsAttribution
+---
+
+{/* 请勿编辑。本文档内容源自上方链接的源文件。如需编辑本页内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。所有共享内容不应包裹在任何组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webpack.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webpack.mdx
new file mode 100644
index 00000000..29253b55
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/03-next-config-js/webpack.mdx
@@ -0,0 +1,10 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:18.586Z
+title: 自定义 Webpack 配置
+nav_title: webpack
+description: 了解如何自定义 Next.js 使用的 webpack 配置
+source: app/api-reference/next-config-js/webpack
+---
+
+{/* 请勿编辑。本文档内容由上述源文件生成。若要编辑本页内容，请前往编辑器中的源页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/05-edge.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/05-edge.mdx
new file mode 100644
index 00000000..b1ae64e6
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/05-edge.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:38.169Z
+title: Edge Runtime
+description: 关于 Edge Runtime 的 API 参考文档。
+source: app/api-reference/edge
+---
+
+{/* 请勿直接编辑此文档。本文档内容由上述源文件生成。如需编辑页面内容，请前往编辑器的源文件页面。你可以使用 `<PagesOnly>Content</PagesOnly>` 组件来添加专属于 Pages Router 的内容。任何共享内容都不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/create-next-app.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/create-next-app.mdx
new file mode 100644
index 00000000..7293f7e9
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/create-next-app.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:15.999Z
+title: CLI
+description: 使用 create-next-app CLI 通过一条命令创建 Next.js 应用。
+source: app/api-reference/cli/create-next-app
+---
+
+{/* 请勿编辑。本文档内容源自上方源文件。如需编辑页面内容，请在编辑器中导航至源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages Router 的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/index.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/index.mdx
new file mode 100644
index 00000000..b292bd54
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/index.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:20:08.241Z
+title: CLI
+description: Next.js 命令行工具 (CLI) 的 API 参考文档。
+source: app/api-reference/cli
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑本页内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>内容</PagesOnly>` 组件添加专属于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/next.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/next.mdx
new file mode 100644
index 00000000..8774b3ef
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/06-cli/next.mdx
@@ -0,0 +1,9 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:19:58.759Z
+title: next 命令行工具 (CLI)
+description: 了解如何使用 Next.js 命令行工具 (CLI) 运行和构建您的应用。
+source: app/api-reference/cli/next
+---
+
+{/* 请勿编辑。本文档内容由上方源文件生成。如需编辑本页内容，请前往编辑器的源文件页面。您可以使用 `<PagesOnly>Content</PagesOnly>` 组件添加特定于 Pages 路由器的内容。任何共享内容不应包裹在组件中。 */}
\ No newline at end of file
diff --git a/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/index.mdx b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/index.mdx
new file mode 100644
index 00000000..a4a9f960
--- /dev/null
+++ b/apps/docs/content/zh-hans/docs/14/03-pages/02-api-reference/index.mdx
@@ -0,0 +1,6 @@
+---
+source-updated-at: 2025-05-16T04:52:11.000Z
+translation-updated-at: 2025-05-21T19:16:31.101Z
+title: API 参考文档
+description: 关于 Pages Router 的 Next.js API 参考文档。
+---
\ No newline at end of file