@modern-js/main-doc 3.9.2 → 3.10.0

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,
-  }
+  };
 });
 ```
 

package/docs/zh/plugin/cli-plugins/life-cycle.mdx

@@ -131,5 +131,7 @@ flowchart TD
     style spacer7 fill:none,stroke:none,height:0px;
     style spacer8 fill:none,stroke:none,height:0px;
     style spacer9 fill:none,stroke:none,height:0px;
+
 `}
+
 </Mermaid>

package/docs/zh/plugin/introduction.mdx

@@ -126,12 +126,12 @@ Rsbuild 是 Modern.js 底层的构建工具，通过添加 Rsbuild 插件可修
 
 以下为已在 Modern.js 中内置的 Rsbuild 官方插件，无需安装，即可启用：
 
-| 插件                                                                                 | 介绍                                                                                   | Modern.js 链接                                                                                                                        |
-| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| [React 插件](https://v2.rsbuild.rs/zh/plugins/list/plugin-react)                        | 提供对 React 的支持                                                                    | -                                                                                                                                     |
-| [SVGR 插件](https://v2.rsbuild.rs/zh/plugins/list/plugin-svgr)                          | 支持将 SVG 图片转换为一个 React 组件                                                   | [output.disableSvgr](/configure/app/output/disable-svgr)<br />[output.svgDefaultExport](/configure/app/output/svg-default-export)     |
-| [Assets Retry 插件](https://github.com/rstackjs/rsbuild-plugin-assets-retry)          | 用于在静态资源加载失败时自动发起重试请求                                               | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
-| [Type Check 插件](https://github.com/rstackjs/rsbuild-plugin-type-check)             | 用于在单独的进程中运行 TypeScript 类型检查                                             | [output.disableTsChecker](/configure/app/output/disable-ts-checker.html)<br />[tools.tsChecker](/configure/app/tools/ts-checker.html) |
+| 插件                                                                           | 介绍                                                                                   | Modern.js 链接                                                                                                                        |
+| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| [React 插件](https://v2.rsbuild.rs/zh/plugins/list/plugin-react)               | 提供对 React 的支持                                                                    | -                                                                                                                                     |
+| [SVGR 插件](https://v2.rsbuild.rs/zh/plugins/list/plugin-svgr)                 | 支持将 SVG 图片转换为一个 React 组件                                                   | [tools.svgr](/configure/app/tools/svgr)                                                                                               |
+| [Assets Retry 插件](https://github.com/rstackjs/rsbuild-plugin-assets-retry)   | 用于在静态资源加载失败时自动发起重试请求                                               | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
+| [Type Check 插件](https://github.com/rstackjs/rsbuild-plugin-type-check)       | 用于在单独的进程中运行 TypeScript 类型检查                                             | [output.disableTsChecker](/configure/app/output/disable-ts-checker.html)<br />[tools.tsChecker](/configure/app/tools/ts-checker.html) |
 | [Source Build 插件](https://github.com/rstackjs/rsbuild-plugin-source-build)   | 用于 monorepo 场景，支持引用其他子目录的源代码，并完成构建和热更新                     | [experiments.sourceBuild](/configure/app/experiments/source-build.html)                                                               |
 | [Check Syntax 插件](https://github.com/rstackjs/rsbuild-plugin-check-syntax)   | 用于分析产物的语法兼容性，判断是否存在导致兼容性问题的高级语法                         | [security.checkSyntax](/configure/app/security/check-syntax.html)                                                                     |
 | [CSS Minimizer 插件](https://github.com/rstackjs/rsbuild-plugin-css-minimizer) | 用于自定义 CSS 压缩工具，切换到 [cssnano](https://cssnano.co/) 或其他工具进行 CSS 压缩 | [tools.minifyCss](/configure/app/tools/minify-css.html)                                                                               |

package/docs/zh/plugin/official/cli-plugins/plugin-bff.mdx

@@ -2,4 +2,4 @@
 
 在 Modern.js 应用中，通过 BFF 插件，开发者可以在 `api/lambda` 目录下定义接口文件，并导出接口函数。在前端代码中，可以用文件引用的方式，直接调用这些接口函数，发起接口请求。
 
-详细内容可以参考 [BFF - 基础用法](/guides/advanced-features/bff/function)。
+详细内容可以参考 [BFF - 基础用法](/guides/advanced-features/bff/function)。

package/docs/zh/plugin/official/cli-plugins/plugin-ssg.mdx

@@ -2,4 +2,4 @@
 
 SSG（Static Site Generation）是一种基于数据与模板，在构建时渲染完整静态网页的技术解决方案。这意味着在生产环境中，页面默认就是有内容的，并且可以被 CDN 缓存。对于无需数据的页面，SSG 可以提供更好的性能和更高的安全性。
 
-详细内容可以参考 [静态站点生成（SSG）](/guides/basic-features/render/ssg)。
+详细内容可以参考 [静态站点生成（SSG）](/guides/basic-features/render/ssg)。

package/docs/zh/plugin/plugin-system.mdx

@@ -14,31 +14,26 @@ Modern.js 秉承“一切皆插件”的设计哲学，将框架的各项功能
 ## 插件类型与适用场景
 
 **CLI 插件**：
-    -   **作用阶段**：构建时（执行 `modern` 命令时）。
-    -   **典型场景**：
-        -   扩展命令行工具。
-        -   修改构建配置。
-        -   监听文件变化。
-        -   控制构建流程。
-    -   **配置方式**：`modern.config.ts` 中的 `plugins` 字段。
+
+- **作用阶段**：构建时（执行 `modern` 命令时）。
+- **典型场景**：
+  - 扩展命令行工具。
+  - 修改构建配置。
+  - 监听文件变化。
+  - 控制构建流程。
+- **配置方式**：`modern.config.ts` 中的 `plugins` 字段。
 
 **Runtime 插件**：
-    -   **作用阶段**：应用运行时（浏览器/Node.js 环境）。
-    -   **典型场景**：
-        -   初始化全局状态或服务。
-        -   封装 React 高阶组件（HOC）。
-        -   拦截或修改路由行为。
-        -   控制渲染流程。
-    -   **配置方式**：`src/modern.runtime.ts` 中的 `plugins` 字段。
-
-{/* **Server 插件**：
-    -   **作用阶段**：服务端请求处理阶段。
-    -   **典型场景**：
-        -   添加自定义中间件。
-        -   扩展服务端 API。
-        -   定制化 SSR 逻辑。
-        -   与后端框架集成。
-    -   **配置方式**：`server/modern.server.ts` 中的 `plugins` 字段。 */}
+
+- **作用阶段**：应用运行时（浏览器/Node.js 环境）。
+- **典型场景**：
+  - 初始化全局状态或服务。
+  - 封装 React 高阶组件（HOC）。
+  - 拦截或修改路由行为。
+  - 控制渲染流程。
+- **配置方式**：`src/modern.runtime.ts` 中的 `plugins` 字段。
+
+{/* **Server 插件**： - **作用阶段**：服务端请求处理阶段。 - **典型场景**： - 添加自定义中间件。 - 扩展服务端 API。 - 定制化 SSR 逻辑。 - 与后端框架集成。 - **配置方式**：`server/modern.server.ts` 中的 `plugins` 字段。 */}
 
 ## 插件结构
 
@@ -194,9 +189,7 @@ const myPlugin2 = () => ({
 // 定义 Hooks
 import { createSyncHook } from '@modern-js/plugin';
 
-type RouteObject = {
-  /** TODO **/
-};
+type RouteObject = {/** TODO **/};
 const modifyRoutes = createSyncHook<(routes: RouteObject[]) => RouteObject[]>();
 
 // 插件中注册 Hooks

package/docs/zh/plugin/runtime-plugins/life-cycle.mdx

@@ -25,5 +25,7 @@ flowchart TD
     style registry_hooks stroke-dasharray:5 5,fill:#9CA3AF,font-size:10px;
     style wrapRoot font-size:10px;
     style onBeforeRender font-size:10px;
+
 `}
+
 </Mermaid>

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

@@ -46,17 +46,17 @@ export default myServerPlugin;
 
 - **返回值：** `ServerContext` 对象，包含以下字段：
 
-| 字段名            | 类型                | 描述                           |
-| ----------------- | ------------------- | ------------------------------ |
-| `middlewares`     | `MiddlewareObj[]`   | 中间件列表                     |
-| `renderMiddlewares` | `MiddlewareObj[]` | 渲染中间件列表                 |
-| `routes`          | `ServerRoute[]`     | 服务器路由信息                 |
-| `appDirectory`    | `string`            | 项目根目录的绝对路径           |
-| `apiDirectory`    | `string`            | API 模块目录的绝对路径         |
-| `lambdaDirectory` | `string`            | Lambda 模块目录的绝对路径     |
-| `sharedDirectory` | `string`            | 公共模块目录的绝对路径         |
-| `distDirectory`   | `string`            | 项目产物输出目录的绝对路径     |
-| `plugins`         | `ServerPlugin[]`    | 当前已注册的插件列表           |
+| 字段名              | 类型              | 描述                       |
+| ------------------- | ----------------- | -------------------------- |
+| `middlewares`       | `MiddlewareObj[]` | 中间件列表                 |
+| `renderMiddlewares` | `MiddlewareObj[]` | 渲染中间件列表             |
+| `routes`            | `ServerRoute[]`   | 服务器路由信息             |
+| `appDirectory`      | `string`          | 项目根目录的绝对路径       |
+| `apiDirectory`      | `string`          | API 模块目录的绝对路径     |
+| `lambdaDirectory`   | `string`          | Lambda 模块目录的绝对路径  |
+| `sharedDirectory`   | `string`          | 公共模块目录的绝对路径     |
+| `distDirectory`     | `string`          | 项目产物输出目录的绝对路径 |
+| `plugins`           | `ServerPlugin[]`  | 当前已注册的插件列表       |
 
 - **示例：**
 
@@ -111,7 +111,6 @@ await hooks.onPrepare.call();
 
 ---
 
-
 ## 上下文修改
 
 #### `api.updateServerContext`
@@ -143,7 +142,6 @@ api.onPrepare(() => {
 
 ---
 
-
 ## 生命周期钩子
 
 #### `api.onPrepare`
@@ -205,7 +203,6 @@ api.onReset(async ({ event }) => {
 
 ---
 
-
 ## 其他说明
 
 - 可以参考 [Server 插件生命周期](./life-cycle.mdx) 了解插件钩子的执行顺序。

package/docs/zh/plugin/server-plugins/life-cycle.mdx

@@ -28,7 +28,9 @@ flowchart TD
     style modifyConfig font-size:10px;
     style onPrepare font-size:10px;
     style apply_middlewares font-size:10px;
+
 `}
+
 </Mermaid>
 
 :::info

package/package.json

@@ -16,19 +16,18 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.9.2",
+  "version": "3.10.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
-    "mermaid": "^11.15.0",
-    "@modern-js/sandpack-react": "3.9.2"
+    "mermaid": "^11.17.2",
+    "@modern-js/sandpack-react": "3.10.0"
   },
   "devDependencies": {
-    "rsbuild-plugin-open-graph": "1.1.3",
     "@rsbuild/plugin-sass": "2.0.1",
-    "@rspress/core": "2.0.13",
+    "@rspress/core": "2.0.23",
     "@rspress/plugin-llms": "2.0.2",
     "@rspress/shared": "2.0.2",
     "@shikijs/transformers": "^3.23.0",
@@ -37,8 +36,9 @@
     "classnames": "^2.5.1",
     "clsx": "^1.2.1",
     "fs-extra": "^10.1.0",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "rsbuild-plugin-open-graph": "1.1.3",
     "ts-node": "^10.9.2",
     "typescript": "^5"
   },
@@ -48,8 +48,7 @@
         "inputs": [
           "build",
           "^build",
-          "{projectRoot}/docs/**/*",
-          "{projectRoot}/rspress.config.ts"
+          "{projectRoot}/docs/**/*"
         ],
         "outputs": [
           "{projectRoot}/doc_build"
@@ -58,9 +57,8 @@
     }
   },
   "scripts": {
-    "dev": "rspress dev",
-    "dev:no_lazy": "LAZY=false rspress dev",
-    "build": "rspress build",
-    "preview": "rspress preview"
+    "dev": "rs doc",
+    "build": "rs doc build",
+    "preview": "rs doc preview"
   }
 }

package/{rspress.config.ts → rstack.config.mts}

@@ -1,10 +1,10 @@
 import path from 'path';
 import { pluginSass } from '@rsbuild/plugin-sass';
-import { defineConfig } from '@rspress/core';
 import { transformerNotationHighlight } from '@shikijs/transformers';
 import { pluginOpenGraph } from 'rsbuild-plugin-open-graph';
+import { define } from 'rstack';
 
-const docPath = path.join(__dirname, 'docs');
+const docPath = path.join(import.meta.dirname, 'docs');
 const siteTitle = 'Modern.js';
 const siteDescription =
   'The Modern.js framework is a progressive web framework based on React. At ByteDance, we use Modern.js to build upper-level frameworks that have supported the development of thousands of web applications.';
@@ -13,7 +13,7 @@ const socialDescription =
 const socialImage =
   'https://lf3-static.bytednsdoc.com/obj/eden-cn/nuvjhpqnuvr/modern-website/banner.jpeg';
 
-export default defineConfig({
+define.doc({
   root: docPath,
   llms: true,
   title: siteTitle,
@@ -22,7 +22,7 @@ export default defineConfig({
   logo: 'https://lf-cdn-tos.bytescm.com/obj/static/webinfra/modern-js-website/assets/images/images/modernjs-logo.svg',
   icon: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/uhbfnupenuhf/favicon.ico',
   lang: 'en',
-  themeDir: path.join(__dirname, 'src'),
+  themeDir: path.join(import.meta.dirname, 'src'),
   markdown: {
     checkDeadLinks: true,
     shiki: {
@@ -111,14 +111,11 @@ export default defineConfig({
     output: {
       dataUriLimit: 0,
     },
-    dev: {
-      lazyCompilation: process.env.LAZY !== 'false',
-    },
     resolve: {
       alias: {
-        '@site-docs': path.join(__dirname, './docs/zh'),
-        '@site-docs-en': path.join(__dirname, './docs/en'),
-        '@site': require('path').resolve(__dirname),
+        '@site-docs': path.join(import.meta.dirname, './docs/zh'),
+        '@site-docs-en': path.join(import.meta.dirname, './docs/en'),
+        '@site': import.meta.dirname,
       },
     },
     plugins: [

package/src/components/Footer/styles.module.scss

@@ -2,7 +2,7 @@
   display: flex;
   justify-content: center;
   padding: 10vh 0;
-  border-top: 1px solid rgba(0,0,0,0.1);
+  border-top: 1px solid rgba(0, 0, 0, 0.1);
 }
 
 .logo {

package/src/components/SolutionCards/index.module.scss

@@ -9,7 +9,9 @@
   cursor: pointer;
   border: 1px solid var(--rp-c-bg-soft);
   background-color: var(--rp-c-bg-soft);
-  transition: color 0.5s, background-color 0.5s;
+  transition:
+    color 0.5s,
+    background-color 0.5s;
   padding: 22px;
   border-radius: 16px;
   flex: 0 1 32%;