@modern-js/main-doc 3.9.3 → 3.10.1

package/docs/zh/guides/basic-features/routes/config-routes.mdx

@@ -6,7 +6,6 @@ sidebar_position: 3
 
 默认情况下，Modern.js 推荐使用 [约定式路由](./routes.mdx) 作为路由定义的方式。同时，Modern.js 也提供了一个配置式路由的能力，其可以和约定式路由一起使用，或两者分别单独使用。
 
-
 ## 何时使用配置式路由
 
 配置式路由在以下场景中特别有用：
@@ -22,27 +21,26 @@ sidebar_position: 3
 在 `src` 或每个入口目录下，你可以定义一个 `modern.routes.ts` 文件，通过该文件，你可以对路由进行配置：
 
 ```ts
-import { defineRoutes } from '@modern-js/runtime/config-routes'
+import { defineRoutes } from '@modern-js/runtime/config-routes';
 
 export default defineRoutes(({ route, layout, page, $ }, fileRoutes) => {
-  return [
-    route("home.tsx", "/"),
-  ]
-})
+  return [route('home.tsx', '/')];
+});
 ```
 
 ### 函数签名说明
 
 `defineRoutes` 接受一个回调函数，该回调函数有两个参数：
+
 1. `routeFunctions`：包含 `route`、`layout`、`page`、`$` 函数的对象
 2. `fileRoutes`：约定式路由生成的路由配置数组
 
 路由函数的基本签名：
+
 - 第一个参数：相对于 `modern.routes.ts` 的文件路径
 - 第二个参数：路由路径（可选，必须是字符串）
 - 第三个参数：子路由数组（可选）
 
-
 ## 路由函数
 
 Modern.js 提供了四个主要的路由配置函数：
@@ -50,6 +48,7 @@ Modern.js 提供了四个主要的路由配置函数：
 :::tip 路径说明
 
 所有路由函数的第一个参数（路径）都是**相对路径**，会与父级路径拼接生成最终的路由路径：
+
 - **根路径**：`"/"` 或 "" 表示当前层级的根路径
 - **相对路径**：子路由的路径会相对于父级路径进行拼接
 - **动态路径**：使用 `:param` 语法表示动态参数
@@ -57,7 +56,6 @@ Modern.js 提供了四个主要的路由配置函数：
 
 :::
 
-
 :::info
 
 - `route`、`layout`、`page`、`$` 等函数的第一个参数（组件文件路径）必须指向当前项目中的真实文件，暂不支持 `node_modules` 及 Monorepo 下其他仓库中的文件
@@ -73,27 +71,28 @@ Modern.js 提供了四个主要的路由配置函数：
 export default defineRoutes(({ route }, fileRoutes) => {
   return [
     // 无子路由时，自动生成页面路由
-    route("home.tsx", "/"),
-    route("about.tsx", "about"),
+    route('home.tsx', '/'),
+    route('about.tsx', 'about'),
 
     // 有子路由时，自动生成布局路由
     // dashboard/layout.tsx 需要包含 <Outlet> 来渲染子路由
-    route("dashboard/layout.tsx", "dashboard", [
-      route("dashboard/overview.tsx", "overview"),  // 生成路径：/dashboard/overview
-      route("dashboard/settings.tsx", "settings"),  // 生成路径：/dashboard/settings
+    route('dashboard/layout.tsx', 'dashboard', [
+      route('dashboard/overview.tsx', 'overview'), // 生成路径：/dashboard/overview
+      route('dashboard/settings.tsx', 'settings'), // 生成路径：/dashboard/settings
     ]),
 
     // 动态路由
-    route("products/detail.tsx", "products/:id"),
+    route('products/detail.tsx', 'products/:id'),
 
     // 多路径指向同一组件
-    route("user/profile.tsx", "user"),
-    route("user/profile.tsx", "profile"),
-  ]
-})
+    route('user/profile.tsx', 'user'),
+    route('user/profile.tsx', 'profile'),
+  ];
+});
 ```
 
 **使用场景**：
+
 - 快速配置路由，无需明确指定是页面还是布局
 - 简化路由配置的复杂度
 
@@ -105,15 +104,16 @@ export default defineRoutes(({ route }, fileRoutes) => {
 export default defineRoutes(({ layout, page }, fileRoutes) => {
   return [
     // 生成布局路由，路径为 "/auth"，必须包含子路由
-    layout("auth/layout.tsx", "auth", [
-      page("auth/login/page.tsx", "login"),      // 生成路径：/auth/login
-      page("auth/register/page.tsx", "register"), // 生成路径：/auth/register
+    layout('auth/layout.tsx', 'auth', [
+      page('auth/login/page.tsx', 'login'), // 生成路径：/auth/login
+      page('auth/register/page.tsx', 'register'), // 生成路径：/auth/register
     ]),
-  ]
-})
+  ];
+});
 ```
 
 **使用场景**：
+
 - 需要明确指定某个组件为布局组件
 - 为多个页面提供共同的布局结构
 - 需要在多个路由间共享导航、侧边栏等UI组件
@@ -125,15 +125,16 @@ export default defineRoutes(({ layout, page }, fileRoutes) => {
 ```ts
 export default defineRoutes(({ layout, page }, fileRoutes) => {
   return [
-    layout("dashboard/layout.tsx", "dashboard", [
-      page("dashboard/overview.tsx", "overview"),  // 生成路径：/dashboard/overview
-      page("dashboard/settings.tsx", "settings"),  // 生成路径：/dashboard/settings
+    layout('dashboard/layout.tsx', 'dashboard', [
+      page('dashboard/overview.tsx', 'overview'), // 生成路径：/dashboard/overview
+      page('dashboard/settings.tsx', 'settings'), // 生成路径：/dashboard/settings
     ]),
-  ]
-})
+  ];
+});
 ```
 
 **使用场景**：
+
 - 需要明确指定某个组件为页面组件
 - 确保组件不包含 `<Outlet>` 子组件渲染
 - 提供更清晰的语义表达
@@ -145,16 +146,17 @@ export default defineRoutes(({ layout, page }, fileRoutes) => {
 ```ts
 export default defineRoutes(({ layout, page, $ }, fileRoutes) => {
   return [
-    layout("blog/layout.tsx", "blog", [
-      page("blog/page.tsx", ""),                    // 生成路径：/blog
-      page("blog/[id]/page.tsx", ":id"),            // 生成路径：/blog/:id
-      $("blog/$.tsx", "*"),                         // 通配路由，匹配 /blog 下的所有未匹配路径
+    layout('blog/layout.tsx', 'blog', [
+      page('blog/page.tsx', ''), // 生成路径：/blog
+      page('blog/[id]/page.tsx', ':id'), // 生成路径：/blog/:id
+      $('blog/$.tsx', '*'), // 通配路由，匹配 /blog 下的所有未匹配路径
     ]),
-  ]
-})
+  ];
+});
 ```
 
 **使用场景**：
+
 - 自定义 404 页面
 - 处理特定路径下的所有未匹配请求
 
@@ -170,11 +172,11 @@ export default defineRoutes(({ layout, page, $ }, fileRoutes) => {
 export default defineRoutes(({ page }, fileRoutes) => {
   return [
     // 使用 page 函数明确指定页面路由
-    page("home.tsx", "/"),
-    page("about.tsx", "about"),
-    page("contact.tsx", "contact"),
-  ]
-})
+    page('home.tsx', '/'),
+    page('about.tsx', 'about'),
+    page('contact.tsx', 'contact'),
+  ];
+});
 ```
 
 ### 无路径路由
@@ -186,15 +188,16 @@ export default defineRoutes(({ layout, page }, fileRoutes) => {
   return [
     // 使用 layout 函数明确指定布局路由
     // auth/layout.tsx 需要包含 <Outlet> 来渲染子路由
-    layout("auth/layout.tsx", [
-      page("login/page.tsx", "login"),
-      page("register/page.tsx", "register"),
+    layout('auth/layout.tsx', [
+      page('login/page.tsx', 'login'),
+      page('register/page.tsx', 'register'),
     ]),
-  ]
-})
+  ];
+});
 ```
 
 上述配置会生成：
+
 - `/login` → `auth/layout.tsx` + `login/page.tsx`
 - `/register` → `auth/layout.tsx` + `register/page.tsx`
 
@@ -203,11 +206,11 @@ export default defineRoutes(({ layout, page }, fileRoutes) => {
 ```ts
 export default defineRoutes(({ page }, fileRoutes) => {
   return [
-    page("user.tsx", "user"),
-    page("user.tsx", "profile"),
-    page("user.tsx", "account"),
-  ]
-})
+    page('user.tsx', 'user'),
+    page('user.tsx', 'profile'),
+    page('user.tsx', 'account'),
+  ];
+});
 ```
 
 ### 动态路由
@@ -218,12 +221,12 @@ export default defineRoutes(({ page }, fileRoutes) => {
 export default defineRoutes(({ page }, fileRoutes) => {
   return [
     // 必需参数
-    page("blog/detail.tsx", "blog/:id"),
+    page('blog/detail.tsx', 'blog/:id'),
 
     // 可选参数
-    page("blog/index.tsx", "blog/:slug?"),
-  ]
-})
+    page('blog/index.tsx', 'blog/:slug?'),
+  ];
+});
 ```
 
 ## 路由相关文件自动查找
@@ -234,10 +237,10 @@ export default defineRoutes(({ page }, fileRoutes) => {
 // modern.routes.ts
 export default defineRoutes(({ route }, fileRoutes) => {
   return [
-    route("pages/profile.tsx", "profile"),
-    route("pages/user/detail.tsx", "user/:id"),
-  ]
-})
+    route('pages/profile.tsx', 'profile'),
+    route('pages/user/detail.tsx', 'user/:id'),
+  ];
+});
 ```
 
 Modern.js 会自动查找并加载：
@@ -259,7 +262,6 @@ Modern.js 会自动查找并加载：
 
 :::
 
-
 ## 路由合并
 
 配置式路由可以与约定式路由一起使用，你可以通过修改 `fileRoutes` 参数来实现路由的合并：
@@ -274,7 +276,6 @@ Modern.js 会自动查找并加载：
 
 :::
 
-
 ### 合并示例
 
 以下示例展示了配置式路由与约定式路由的合并方式：
@@ -312,6 +313,7 @@ export default defineRoutes(({ page }, fileRoutes) => {
   return fileRoutes;
 });
 ```
+
 ## 调试路由
 
 由于路由合并后的最终结构可能不够直观，Modern.js 提供了调试命令来帮助你查看完整路由信息：

package/docs/zh/guides/basic-features/testing/playwright.mdx

@@ -6,8 +6,13 @@ Playwright 是一个测试框架，它允许你使用单一的 API，自动的
 
 import { PackageManagerTabs } from '@theme';
 
-<PackageManagerTabs command={{ npm: "npm init playwright", yarn: "yarn create playwright", pnpm: "pnpm create playwright" }} />
-
+<PackageManagerTabs
+  command={{
+    npm: 'npm init playwright',
+    yarn: 'yarn create playwright',
+    pnpm: 'pnpm create playwright',
+  }}
+/>
 
 上述命令会自动安装 Playwright 依赖，并通过一系列提示帮助你在项目中安装和配置，包括添加一个 `playwright.config.ts` 文件。
 
@@ -75,18 +80,18 @@ export default Index;
 接下来，添加测试用例，来保证你页面的链接能够正常工作。
 
 ```ts title="tests/example.spec.ts"
-import { test, expect } from '@playwright/test'
- 
+import { test, expect } from '@playwright/test';
+
 test('should navigate to the about page', async ({ page }) => {
   // Start from the index page (the baseURL is set via the webServer in the playwright.config.ts)
-  await page.goto('http://localhost:8080/')
+  await page.goto('http://localhost:8080/');
   // Find an element with the text 'About' and click on it
-  await page.click('text=About')
+  await page.click('text=About');
   // The new URL should be "/about" (baseURL is used there)
-  await expect(page).toHaveURL('http://localhost:8080/about')
+  await expect(page).toHaveURL('http://localhost:8080/about');
   // The new page should contain an h1 with "About"
-  await expect(page.locator('h1')).toContainText('About')
-})
+  await expect(page.locator('h1')).toContainText('About');
+});
 ```
 
 ## 运行测试用例
@@ -109,4 +114,4 @@ Running 3 tests using 3 workers
 To open last HTML report run:
 
   npx playwright show-report
-```
+```

package/docs/zh/guides/basic-features/testing/rstest.mdx

@@ -84,9 +84,9 @@ test('Page', async () => {
     </Router>,
   );
 
-  await expect.element(
-    page.getByRole('heading', { level: 1, name: 'Home' }),
-  ).toBeVisible();
+  await expect
+    .element(page.getByRole('heading', { level: 1, name: 'Home' }))
+    .toBeVisible();
 });
 ```
 
@@ -181,12 +181,14 @@ First install and use the migrate-to-rstest skill. If it is not installed, insta
 npx skills add rstackjs/agent-skills --skill migrate-to-rstest
 
 Follow the migrate-to-rstest skill instructions and the official Rstest migration guides:
+
 - Jest: https://rstest.rs/guide/migration/jest
 - Vitest: https://rstest.rs/guide/migration/vitest
 
 Modern.js-specific requirement:
+
 - Install and use @modern-js/adapter-rstest together with @rstest/core.
 - Create or update rstest.config.ts to import withModernConfig from @modern-js/adapter-rstest.
 - Reuse the Modern.js app configuration with extends: withModernConfig().
 - Do not replace this with a plain Rstest config unless the project explicitly does not need Modern.js config integration.`}
-/>
+  />

package/docs/zh/guides/get-started/ai-coding-agents.mdx

@@ -15,10 +15,10 @@ AI Agent 由此获取与当前框架版本严格匹配的 API、配置与约定
 
 ## AGENTS.md
 
-`AGENTS.md` 是给 AI 编码助手的项目指引，告诉它在动手前先阅读随包文档、并遵循 Modern.js 的约定；同时会生成 `CLAUDE.md`，通过 `@AGENTS.md` 让 Claude Code 复用同一份指引。
+`AGENTS.md` 是给 AI 编码助手的项目指引，告诉它在动手前先阅读随包文档、并遵循 Modern.js 的约定。
 
-- **新建项目**：`npx @modern-js/create` 默认生成这两个文件，加 `--no-agents-md` 可跳过。
-- **已有项目**：在项目根运行 `npx @modern-js/create --agents-md-only` 生成或更新，可随时重复运行，你添加的自定义内容会被保留。
+- **新建项目**：`npx @modern-js/create` 默认生成 `AGENTS.md`，加 `--no-agents-md` 可跳过。
+- **已有项目**：在项目根运行 `npx @modern-js/create --agents-md-only` 生成或更新 `AGENTS.md`，可随时重复运行，你添加的自定义内容会被保留。
 
 Modern.js 只维护 `AGENTS.md` 中 `<!-- BEGIN:modernjs-agent-rules -->` 标记内的内容，标记之外你写的内容不会被改动。
 
@@ -35,10 +35,10 @@ llms.txt 是遵循 [llms.txt 规范](https://llmstxt.org/) 的在线文档索引
 
 Skills 是按需触发的 AI 辅助能力，遵循 [Agent Skills 开放标准](https://github.com/vercel-labs/skills)。用户向 Skills：
 
-| Skill | 标识 | 说明 |
-|---|---|---|
-| 升级到 v3 | `modernjs-migrate-to-v3` | v2 应用迁移到 v3：安全改写 + 复杂项人工清单 + 迁移报告 |
-| 启用特性 | `modernjs-feature-enable` | 为 v3 应用启用 BFF / SSG / styled-components，并脚手架化 Tailwind CSS / 自定义 Web Server |
+| Skill     | 标识                      | 说明                                                                                      |
+| --------- | ------------------------- | ----------------------------------------------------------------------------------------- |
+| 升级到 v3 | `modernjs-migrate-to-v3`  | v2 应用迁移到 v3：安全改写 + 复杂项人工清单 + 迁移报告                                    |
+| 启用特性  | `modernjs-feature-enable` | 为 v3 应用启用 BFF / SSG / styled-components，并脚手架化 Tailwind CSS / 自定义 Web Server |
 
 > Skills 默认不强装、不隐式安装，由你显式安装。RSC、微前端等属于配置或架构决策，不是 `modernjs-feature-enable` 的一键启用项。
 

package/docs/zh/guides/topic-detail/module-federation/deploy.mdx

@@ -63,9 +63,9 @@ export default defineConfig({
     "name": "remote",
     "publicPath": "https://my-remote-module/"
   },
-  "shared": [ /* xxx */ ],
+  "shared": [/* xxx */],
   "remotes": [],
-  "exposes": [ /* xxx */ ]
+  "exposes": [/* xxx */]
 }
 ```
 

package/docs/zh/guides/upgrade/config.mdx

@@ -22,6 +22,18 @@ server: {
 }
 ```
 
+### dev.lazyCompilation
+
+**变更内容**：开发环境下的默认值变化。纯 CSR 与流式 SSR 应用默认开启按需编译，默认值为 `{ imports: true, entries: false }`；使用 string SSR、RSC 或 SSG 的应用仍默认关闭。该变更只影响开发环境，不影响生产构建产物。
+
+**迁移示例**：如需保持 2.0 的行为，可以显式关闭：
+
+```typescript
+dev: {
+  lazyCompilation: false;
+}
+```
+
 ## html
 
 ### html.appIcon

package/docs/zh/guides/upgrade/other.md

@@ -22,10 +22,10 @@ Modern.js 3.0 将项目默认入口名称改为 `index`，默认构建出的 HTM
 
 Modern.js 3.0 对部分运行时进行了调整，需要更新相关的导入路径。路径映射对照如下：
 
-| 旧版路径 | 新版路径 | 说明 |
-|---------|---------|------|
-| `@modern-js/runtime/bff` | `@modern-js/plugin-bff/runtime` | BFF 运行时路径 |
-| `@modern-js/runtime/server` | `@modern-js/server-runtime` | 服务端运行时路径 |
+| 旧版路径                    | 新版路径                        | 说明             |
+| --------------------------- | ------------------------------- | ---------------- |
+| `@modern-js/runtime/bff`    | `@modern-js/plugin-bff/runtime` | BFF 运行时路径   |
+| `@modern-js/runtime/server` | `@modern-js/server-runtime`     | 服务端运行时路径 |
 
 ## useRuntimeContext 已废弃
 
@@ -81,7 +81,6 @@ Modern.js 3.0 将 `server.ssr.mode` 的默认值从 `'string'` 改为 `'stream'`
 
 对于 React 18 及以上项目，把 `ssr.mode` 的值由 `'stream'` 改为 `'string'`，不对 Data Loader 中的代码进行修改或使用 Suspense 的话，从渲染结果上没有任何影响。如果你的项目依赖了 React17，请把 `ssr.mode` 的值手动设置为 `'string'`。
 
-
 ## 使用 React Router v7
 
 Modern.js 3.0 默认使用 React Router v7 作为路由库。React Router v7 相比 v6 只有少量的 [不兼容变更](https://reactrouter.com/upgrading/v6)。
@@ -182,9 +181,3 @@ antd v5 使用了 CSS-in-JS 方案，已原生支持按需加载，无需配置
 ## Eslint 规则集
 
 Modern.js 之前提供了 ESLint 的完整规则集，涵盖了 @modern-js（针对 Node.js 项目的 Lint 规则）和 @modern-js-app（针对前端项目的 Lint 规则）。在 [v2.60.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.60.0) 版本中，我们正式移除了这些规则集。我们鼓励开发者根据自身需求选择合适的代码规范工具，直接使用 ESLint 并结合社区推荐的规则，或使用 Biome 以提升代码格式化的性能。
-
-
-
-
-
-

package/docs/zh/guides/upgrade/overview.mdx

@@ -14,15 +14,13 @@ Modern.js 3.0 带来了多项重大改进和变化，主要包括：
 - **SSG 能力完善**：提供完整的[静态站点生成（SSG）](/guides/basic-features/render/ssg)支持。
 - **路由配置增强**：支持[配置式路由](/guides/basic-features/routes/config-routes)，可单独使用或与[约定式路由](/guides/basic-features/routes/routes)结合，提供更灵活的路由定义方式。
 
-
 ## 升级前置检查
 
 在开始升级之前，请确认：
 
 1. 当前项目使用的是 Modern.js 2.0
 2. 确定使用的 react 版本是 17 及以上
-2. 确定使用的 node.js 版本是 18.20.8 及以上，推荐使用 node.js 22 以上版本
-
+3. 确定使用的 node.js 版本是 18.20.8 及以上，推荐使用 node.js 22 以上版本
 
 ## 获取帮助
 
@@ -33,4 +31,3 @@ Modern.js 3.0 带来了多项重大改进和变化，主要包括：
 - 加入 [Modern.js Discord 社区](https://discord.gg/modernjs)与其他开发者交流
 
 我们建议在提交 issue 时提供尽可能详细的信息，包括错误日志、配置文件和复现步骤，以便更快地解决问题
-

package/docs/zh/guides/upgrade/tailwindcss.mdx

@@ -89,4 +89,3 @@ export default {
 @tailwind components;
 @tailwind utilities;
 ```
-

package/docs/zh/guides/upgrade/web-server.md

@@ -7,7 +7,6 @@
 
 这两种写法在旧版中互斥，迁移时请根据项目实际使用的能力选择对应路径。
 
-
 ## unstableMiddleware
 
 ### 核心差异
@@ -22,7 +21,10 @@
 
 ```typescript
 // 旧版 - server/index.ts
-export const unstableMiddleware: UnstableMiddleware[] = [middleware1, middleware2];
+export const unstableMiddleware: UnstableMiddleware[] = [
+  middleware1,
+  middleware2,
+];
 
 // 新版 - server/modern.server.ts
 import { defineServerConfig } from '@modern-js/server-runtime';
@@ -39,13 +41,22 @@ export default defineServerConfig({
 
 ```typescript
 // 旧版
-import type { UnstableMiddleware, UnstableMiddlewareContext } from '@modern-js/server-runtime';
-const middleware: UnstableMiddleware = async (c: UnstableMiddlewareContext, next) => {
+import type {
+  UnstableMiddleware,
+  UnstableMiddlewareContext,
+} from '@modern-js/server-runtime';
+const middleware: UnstableMiddleware = async (
+  c: UnstableMiddlewareContext,
+  next,
+) => {
   return c.response.raw('response'); // 不调用 next 也会继续渲染
 };
 
 // 新版
-import { defineServerConfig, type MiddlewareHandler } from '@modern-js/server-runtime';
+import {
+  defineServerConfig,
+  type MiddlewareHandler,
+} from '@modern-js/server-runtime';
 const middleware: MiddlewareHandler = async (c, next) => {
   await next(); // 必须调用
   return c.text('response');
@@ -54,18 +65,17 @@ const middleware: MiddlewareHandler = async (c, next) => {
 
 ### Context API 对照
 
-| 旧版 API               | 新版 API                 | 说明            |
-| -------------------- | ---------------------- | ------------- |
-| `c.request.cookie`   | `getCookie(c, 'key')`  | Cookie 读取      |
-| `c.req.cookie()`     | `getCookie(c, 'key')`  | Hono v4 已废弃    |
-| `c.request.pathname` | `c.req.path`           | 请求路径          |
-| `c.request.host`     | `c.req.header('Host')` | 请求主机          |
-| `c.request.query`    | `c.req.query()`        | 查询参数          |
-| `c.request.headers`  | `c.req.header()`       | 请求头           |
-| `c.response.status`  | `c.status()`           | 响应状态码         |
-| `c.response.set`     | `c.res.headers.set`    | 设置响应头         |
-| `c.response.raw`     | `c.text` / `c.json`    | 响应体           |
-
+| 旧版 API             | 新版 API               | 说明           |
+| -------------------- | ---------------------- | -------------- |
+| `c.request.cookie`   | `getCookie(c, 'key')`  | Cookie 读取    |
+| `c.req.cookie()`     | `getCookie(c, 'key')`  | Hono v4 已废弃 |
+| `c.request.pathname` | `c.req.path`           | 请求路径       |
+| `c.request.host`     | `c.req.header('Host')` | 请求主机       |
+| `c.request.query`    | `c.req.query()`        | 查询参数       |
+| `c.request.headers`  | `c.req.header()`       | 请求头         |
+| `c.response.status`  | `c.status()`           | 响应状态码     |
+| `c.response.set`     | `c.res.headers.set`    | 设置响应头     |
+| `c.response.raw`     | `c.text` / `c.json`    | 响应体         |
 
 ## afterRender Hook
 
@@ -90,7 +100,10 @@ export const afterRender = (ctx, next) => {
 };
 
 // 新版 - server/modern.server.ts
-import { defineServerConfig, type MiddlewareHandler } from '@modern-js/server-runtime';
+import {
+  defineServerConfig,
+  type MiddlewareHandler,
+} from '@modern-js/server-runtime';
 
 const renderMiddleware: MiddlewareHandler = async (c, next) => {
   await next(); // 先等待页面渲染
@@ -106,6 +119,8 @@ const renderMiddleware: MiddlewareHandler = async (c, next) => {
 };
 
 export default defineServerConfig({
-  renderMiddlewares: [{ name: 'custom-content-injection', handler: renderMiddleware }],
+  renderMiddlewares: [
+    { name: 'custom-content-injection', handler: renderMiddleware },
+  ],
 });
 ```

package/docs/zh/index.md

@@ -1,4 +1,5 @@
 ---
 pageType: home
 ---
+
 # Modern.js - 基于 React 的渐进式 Web 开发框架

package/docs/zh/plugin/cli-plugins/api.mdx

@@ -39,29 +39,29 @@ export default myCliPlugin;
 
 - **返回值：** `AppContext` 对象，包含以下字段：
 
-| 字段名                 | 类型                | 描述                                               | 何时可用                    |
-| ---------------------- | ------------------- | -------------------------------------------------- | --------------------------- |
-| `command`              | `string`            | 当前执行的命令 (e.g.， `dev`， `build`， `deploy`) | -                           |
-| `port`                 | `number`            | 开发服务器端口号                                   | `onPrepare` 之后            |
-| `configFile`           | `string`            | 配置文件的绝对路径                                 | -                           |
-| `isProd`               | `boolean`           | 是否为生产模式                                     | -                           |
-| `appDirectory`         | `string`            | 项目根目录的绝对路径                               | -                           |
-| `srcDirectory`         | `string`            | 项目源码目录的绝对路径                             | -                           |
-| `distDirectory`        | `string`            | 项目产物输出目录的绝对路径                         | `onPrepare`（及之后）       |
-| `sharedDirectory`      | `string`            | 公共模块目录的绝对路径                             | -                           |
-| `nodeModulesDirectory` | `string`            | `node_modules` 目录的绝对路径                      | -                           |
-| `ip`                   | `string`            | 当前机器的 IPv4 地址                               | -                           |
-| `packageName`          | `string`            | 项目 `package.json` 中的 `name` 字段               | -                           |
-| `plugins`              | `object[]`          | 当前已注册的插件列表                               | -                           |
-| `entrypoints`          | `object[]`          | 页面入口信息                                       | -                           |
-| `serverRoutes`         | `object[]`          | 服务端路由信息                                     | -                           |
-| `bundlerType`          | `rspack`            | 当前使用的打包工具类型                             | `onPrepare` 之后            |
-| `metaName`             | `string`            | 框架内部名称                                       | -                           |
-| `apiDirectory`         | `string`            | API 模块目录的绝对路径 (BFF 使用)                  | -                           |
-| `lambdaDirectory`      | `string`            | Lambda 模块目录的绝对路径 (BFF 使用)               | -                           |
-| `runtimeConfigFile`    | `string`            | 运行时配置文件的名称                               | -                           |
-| `checkedEntries`       | `string[]`          | 指定的入口信息                                     | -                           |
-| `apiOnly`              | `boolean`           | 是否为 `apiOnly` 模式                              | -                           |
+| 字段名                 | 类型       | 描述                                               | 何时可用              |
+| ---------------------- | ---------- | -------------------------------------------------- | --------------------- |
+| `command`              | `string`   | 当前执行的命令 (e.g.， `dev`， `build`， `deploy`) | -                     |
+| `port`                 | `number`   | 开发服务器端口号                                   | `onPrepare` 之后      |
+| `configFile`           | `string`   | 配置文件的绝对路径                                 | -                     |
+| `isProd`               | `boolean`  | 是否为生产模式                                     | -                     |
+| `appDirectory`         | `string`   | 项目根目录的绝对路径                               | -                     |
+| `srcDirectory`         | `string`   | 项目源码目录的绝对路径                             | -                     |
+| `distDirectory`        | `string`   | 项目产物输出目录的绝对路径                         | `onPrepare`（及之后） |
+| `sharedDirectory`      | `string`   | 公共模块目录的绝对路径                             | -                     |
+| `nodeModulesDirectory` | `string`   | `node_modules` 目录的绝对路径                      | -                     |
+| `ip`                   | `string`   | 当前机器的 IPv4 地址                               | -                     |
+| `packageName`          | `string`   | 项目 `package.json` 中的 `name` 字段               | -                     |
+| `plugins`              | `object[]` | 当前已注册的插件列表                               | -                     |
+| `entrypoints`          | `object[]` | 页面入口信息                                       | -                     |
+| `serverRoutes`         | `object[]` | 服务端路由信息                                     | -                     |
+| `bundlerType`          | `rspack`   | 当前使用的打包工具类型                             | `onPrepare` 之后      |
+| `metaName`             | `string`   | 框架内部名称                                       | -                     |
+| `apiDirectory`         | `string`   | API 模块目录的绝对路径 (BFF 使用)                  | -                     |
+| `lambdaDirectory`      | `string`   | Lambda 模块目录的绝对路径 (BFF 使用)               | -                     |
+| `runtimeConfigFile`    | `string`   | 运行时配置文件的名称                               | -                     |
+| `checkedEntries`       | `string[]` | 指定的入口信息                                     | -                     |
+| `apiOnly`              | `boolean`  | 是否为 `apiOnly` 模式                              | -                     |
 
 - **示例：**
 
@@ -236,7 +236,7 @@ api.modifyRspackConfig((config, utils) => {
   config.builtins.minify = {
     enable: true,
     implementation: utils.rspack.SwcJsMinimizerRspackPlugin,
-  }
+  };
 });
 ```