@modern-js/main-doc 3.0.0-alpha.0 → 3.0.0-alpha.1

package/docs/zh/guides/basic-features/render/rsc.mdx

@@ -14,7 +14,6 @@ React Server Components (RSC) 是一种新的组件类型，允许在服务端
 - **自动代码分割**：基于实际渲染的数据进行代码分割，而不仅仅是路由，实现更精细的代码优化
 - **更高的内聚性**：与数据、权限、缓存等紧密相关的逻辑可以留在 Server Component 中，组件内聚度更高，减少状态上浮和跨层级传递
 
-
 :::tip 前置阅读
 在开始之前，建议你阅读 React 官方的 [Server Components 文档](https://react.dev/reference/rsc/server-components)，对 Server Component 有一个基本的了解。
 
@@ -31,6 +30,7 @@ npm install react-server-dom-webpack
 ```
 
 :::warning 注意事项
+
 1. 目前暂不支持在 SPA 项目中使用 [Server Functions](https://react.dev/reference/rsc/server-functions)
 2. 目前在 Rspack 构建时，产物分片和体积还未达到最优状态，我们将在近期进一步优化
 
@@ -91,7 +91,7 @@ export default defineConfig({
 :::
 
 ```tsx title="components/InteractiveCard.tsx"
-"use client"; // <--- 这里是 Client Boundary 的起点
+'use client'; // <--- 这里是 Client Boundary 的起点
 
 import { useState } from 'react';
 import Button from './Button'; // Button.tsx 没有 "use client"，但会被包含在客户端 bundle 中
@@ -143,7 +143,7 @@ export default async function Page() {
 ```
 
 ```tsx title="routes/CounterButton.tsx"
-"use client"; // Client Component
+'use client'; // Client Component
 
 import { useState } from 'react';
 
@@ -164,7 +164,7 @@ export default function CounterButton() {
 你可以将 Server Components 作为 `children` Prop 传递给一个 Client Component。假设一个带动画的 Tabs 组件，Tabs 的切换逻辑本身是客户端的，但每个标签页的内容可能是静态的、从服务器获取的。
 
 ```tsx title="app/components/Tabs.tsx"
-"use client"; // Client Component
+'use client'; // Client Component
 
 import React, { useState } from 'react';
 
@@ -199,7 +199,7 @@ import Analytics from '../components/Analytics'; // Server Component
 import UserSettings from '../components/UserSettings'; // Server Component
 
 export default function DashboardPage() {
-  const labels = ["Analytics", "Settings"];
+  const labels = ['Analytics', 'Settings'];
 
   return (
     <main>
@@ -225,7 +225,7 @@ export default function DashboardPage() {
 
 每一级的路由组件（如 `layout.tsx`、`page.tsx`）可以独立选择是 Client Component 还是 Server Component：
 
-```ts
+```bash
 - routes
     - layout.tsx  // 可以是 Client Component
     - page.tsx    // 可以是 Server Component
@@ -237,15 +237,13 @@ export default function DashboardPage() {
 
 ### 旧 CSR 项目
 
-如果是 CSR 项目，且项目中使用了 EdenX  的 data loader，开启 RSC 后，data loader 默认是在服务端执行，这意味着需要先把所有的 `.data.ts` 文件改为`.data.client.ts`，才能和之前的行为保持一致。
-
-
+如果是 CSR 项目，且项目中使用了 EdenX 的 data loader，开启 RSC 后，data loader 默认是在服务端执行，这意味着需要先把所有的 `.data.ts` 文件改为`.data.client.ts`，才能和之前的行为保持一致。
 
 ### 使用 Streaming SSR 的项目
 
 如果你同时使用了 Streaming SSR 和 RSC，在 react19 中需要通过使用 `use`，而不再需要使用 `Await` 组件：
 
-```typescript
+```ts
 function NonCriticalUI({ p }: { p: Promise<string> }) {
   let value = React.use(p);
   return <h3>Non critical value {value}</h3>;
@@ -256,45 +254,37 @@ function NonCriticalUI({ p }: { p: Promise<string> }) {
 </React.Suspense>
 ```
 
-
-
 ## 最佳实践
 
 ### 获取数据
 
-1. 不管是 SSR 还是 RSC 项目，建议在服务端执行的数据获取逻辑默认使用 edenx 提供的 `cache` 函数，这样每一次服务端渲染，不管调用该函数多少次，只会执行一次。
+1. 不管是 SSR 还是 RSC 项目，建议在服务端执行的数据获取逻辑默认使用 Modern.js 提供的 `cache` 函数，这样每一次服务端渲染，不管调用该函数多少次，只会执行一次。
 
-> 这也是 react.js 推荐的用法，为此 react.js 提供了 [cache](https://react.dev/reference/react/cache) 函数，edenx 的 [cache](https://edenx.bytedance.net/guides/basic-features/data/data-cache.html) 可以视作其超集。
+> 这也是 react.js 推荐的用法，为此 react.js 提供了 [cache](https://react.dev/reference/react/cache), Modern.js 的 [cache](/guides/basic-features/data/data-cache.html) 可以视作其超集。
 
 ```typescript
-import { cache } from '@edenx/runtime/cache'
+import { cache } from '@modern-js/runtime/cache';
 
 const getCriticalCached = cache(getCritical);
 ```
 
-
-
-* 在使用 `cache` 函数的基础上，你不再需要通过 `props`，`context` 等管理服务端的状态，我们推荐哪个组件需要数据就在最近的 Server Component 中获取数据，通过 cache 函数，即使多次调用同一个函数，这样可以使项目的状态管理，业务逻辑，性能优化更简单。
+- 在使用 `cache` 函数的基础上，你不再需要通过 `props`，`context` 等管理服务端的状态，我们推荐哪个组件需要数据就在最近的 Server Component 中获取数据，通过 cache 函数，即使多次调用同一个函数，这样可以使项目的状态管理，业务逻辑，性能优化更简单。
 
 ```typescript
 // layout.tsx
-export default async function Layout(){
-    const criticalData = await getCriticalCached();
+export default async function Layout() {
+  const criticalData = await getCriticalCached();
 }
 
-export default async function Page(){
-    const criticalData = await getCriticalCached();
+export default async function Page() {
+  const criticalData = await getCriticalCached();
 }
 ```
 
-
-
 ### 最佳性能
 
 为了发挥 RSC 或 Streaming SSR 的优势，我们需要使尽可能多的组件流动起来，一个核心原则是使 Suspense 包裹的区域尽可能地小（这也是我们推荐使用 `cache` 函数的原因之一）
 
-
-
 对于直接消费数据的 Server Component，我们推荐在其上层包裹 Suspense：
 
 > 这种场景下 Server Component 往往是异步的，还有一种情况 Server Component 为同步的，由 Client Component 消费数据，在下面进行描述
@@ -306,7 +296,9 @@ export default async function PostsList() {
 
   return (
     <ul>
-      {posts.map(post => <li key={post.id}>{post.title}</li>)}
+      {posts.map(post => (
+        <li key={post.id}>{post.title}</li>
+      ))}
     </ul>
   );
 }
@@ -339,19 +331,19 @@ export default function ProfilePage() {
 }
 ```
 
-
-
 还有一种场景是在 Client Component 中消费数据，此时我们应避免在 Server Component 中使用 `await`，避免阻塞渲染：
 
 ```javascript
 // profile/components/PostsList.tsx
-'use client'
+'use client';
 export default function PostsList({ postsPromise }) {
   const posts = use(postsPromise);
 
   return (
     <ul>
-      {posts.map(post => <li key={post.id}>{post.title}</li>)}
+      {posts.map(post => (
+        <li key={post.id}>{post.title}</li>
+      ))}
     </ul>
   );
 }
@@ -386,11 +378,8 @@ export default function ProfilePage() {
     </div>
   );
 }
-
 ```
 
-
-
 ### Helmet
 
 当使用 react19 时，无需再使用 Helmet，推荐直接使用 react 提供的[组件](https://react.dev/reference/react-dom/components)。
@@ -401,7 +390,6 @@ export default function ProfilePage() {
 
 项目中的 bundle 引入了非 19 的 react 版本，常见于 monorepo。请确保所有依赖都使用 React 19 版本。
 
-
 ## 相关链接
 
 - [React Server Components 官方文档](https://react.dev/reference/rsc/server-components)
@@ -409,5 +397,3 @@ export default function ProfilePage() {
 - [数据缓存](/guides/basic-features/data/data-cache)
 - [服务端渲染（SSR）](/guides/basic-features/render/ssr)
 - [Streaming SSR](/guides/basic-features/render/streaming-ssr)
-
-

package/docs/zh/guides/basic-features/render/ssr-cache.mdx

@@ -8,10 +8,6 @@ title: 渲染缓存
 
 Modern.js 支持将服务器端渲染（SSR）结果进行缓存，减少服务器每次请求时的计算和渲染时间，从而加速页面加载速度，提高用户体验。同时，缓存也能降低服务端负载，节省计算资源，提高用户访问速度。
 
-:::tip
-需要 x.43.0+
-:::
-
 ## 配置方式
 
 在应用中创建 `server/cache.[t|j]s` 文件，并导出 `cacheOption` 配置缓存即可开启 SSR 渲染缓存：

package/docs/zh/guides/basic-features/static-assets/svg-assets.mdx

@@ -32,10 +32,6 @@ import Logo from './logo.svg?react';
 export default () => <Logo />;
 ```
 
-:::tip
-Modern.js >= MAJOR_VERSION.48.3 版本支持上述用法。
-:::
-
 Modern.js 也支持以下用法，通过具名导入 `ReactComponent` 来转换 SVG 为 React 组件：
 
 ```tsx title="src/component/Logo.tsx"

package/docs/zh/guides/get-started/tech-stack.mdx

@@ -34,7 +34,7 @@ Modern.js 使用 [Rspack](https://rspack.rs/) 来打包你的 Web 应用。
 
 Modern.js 使用 [SWC](https://swc.rs/) 作为 JS 转译工具，将 TypeScript 或 JSX 转义为可以在浏览器上运行的 JavaScript 代码，并进行语法降级。
 
-在启用 Rspack 构建时，`babel-loader` 默认不会被启用。如需添加 [Babel](https://babeljs.io/) 插件，可通过 `tools.babel` 配置，此时会产生额外的编译开销，在一定程度上拖慢 Rspack 构建速度。
+在启用 Rspack 构建时，`babel-loader` 默认不会被启用。如需添加 [Babel](https://babeljs.io/) 插件，可通过 [`babel plugin`](https://rsbuild.rs/plugins/list/plugin-babel#babel-plugin) 配置，此时会产生额外的编译开销，在一定程度上拖慢 Rspack 构建速度。
 
 ## 压缩工具
 

package/docs/zh/guides/troubleshooting/builder.mdx

@@ -182,7 +182,7 @@ import type { DebouncedFunc } from 'lodash';
 
 ### 升级 Modern.js 版本后，检查出新的 TypeScript 类型错误？
 
-从 MAJOR_VERSION.47.0 版本开始，Modern.js 优化了 Type Checker 的检查范围。在之前的版本中，Type Checker 只输出 src 目录的类型错误，导致其他目录的类型错误无法被正确输出。
+Modern.js 优化了 Type Checker 的检查范围。在之前的版本中，Type Checker 只输出 src 目录的类型错误，导致其他目录的类型错误无法被正确输出。
 
 在新版本中，Modern.js 的 Type Checker 对齐了原生 tsc 的类型检查范围（即 tsconfig.json 的 `include` 和 `exclude` 字段定义的范围），能够完整输出项目中的类型错误。
 

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

@@ -341,6 +341,53 @@ export default {
 };
 ```
 
+### tools.babel
+
+**变更内容**: 该配置已废弃，框架不再内置 Babel，请使用 [Rsbuild 的 Babel 插件](https://v0.rsbuild.rs/plugins/list/plugin-babel) 来启用支持。
+
+**迁移示例**:
+
+```typescript
+// v2
+tools: {
+  babel: {
+    plugins: [
+      [
+        'babel-plugin-import',
+        {
+          libraryName: 'xxx-components',
+          libraryDirectory: 'es',
+          style: true,
+        },
+      ],
+    ],
+  },
+}
+
+// v3
+import { pluginBabel } from '@rsbuild/plugin-babel';
+
+export default {
+  // ...
+  builderPlugins: [
+    pluginBabel({
+      babelLoaderOptions: {
+        plugins: [
+          [
+            'babel-plugin-import',
+            {
+              libraryName: 'my-components',
+              libraryDirectory: 'es',
+              style: true,
+            },
+          ],
+        ],
+      },
+    })
+  ];
+}
+```
+
 ### tools.tailwindcss
 
 **变更内容**: 该配置已废弃，请参考 [Tailwind 插件变更](/guides/upgrade/tailwindcss)，使用 Rsbuild 的方式来接入 Tailwind CSS。
@@ -734,6 +781,10 @@ export default {
 };
 ```
 
+import ConfigDeploy from '@site-docs/components/upgrade-config-deploy.mdx';
+
+<ConfigDeploy />
+
 ## plugins
 
 ### app-tools 插件
@@ -756,18 +807,98 @@ plugins: [
 ],
 ```
 
+## security
+
+### security.sri
+
+**变更内容**: `security.sri.hashLoading` 不再需要，可以直接移除。
+
 ## runtime
 
 ### runtime.router
 
-**变更内容**: 不再需要，可以直接移除。
+**变更内容**: 不再需要，可以直接移除。该配置移动到 modern.runtime.ts 中的 router 配置中。
+
+**迁移示例**:
+
+```typescript
+// v2
+// modern.config.ts
+export default {
+  runtime: {
+    router: {
+      // 路由配置
+    },
+  },
+};
+
+// v3
+// modern.runtime.ts
+import { defineRuntimeConfig } from '@modern-js/runtime';
+
+export default defineRuntimeConfig({
+  router: {
+    // 路由配置
+  },
+});
+```
 
 ### runtime.state
 
 **变更内容**: 该配置被废弃，建议使用第三方状态管理库。
 
+### runtime.masterApp
+
+**变更内容**: 该配置被废弃，将该配置移动到 modern.runtime.ts 中的 masterApp 配置。
+
+**迁移示例**:
+
+```typescript
+// v2
+// modern.config.ts
+export default {
+  runtime: {
+    masterApp: {
+      apps: [
+        {
+          name: 'Table',
+          entry: 'http://localhost:8081',
+        },
+        {
+          name: 'Dashboard',
+          entry: 'http://localhost:8082',
+        },
+      ],
+    },
+  },
+};
+
+// v3
+// modern.runtime.ts
+import { defineRuntimeConfig } from '@modern-js/runtime';
+
+export default defineRuntimeConfig({
+  masterApp: {
+    apps: [
+      {
+        name: 'Table',
+        entry: 'http://localhost:8081',
+      },
+      {
+        name: 'Dashboard',
+        entry: 'http://localhost:8082',
+      },
+    ],
+  },
+});
+```
+
 ## performance
 
+### performance.bundleAnalyze
+
+**变更内容**: 该配置已废弃，建议使用 [Rsdoctor](https://rsbuild.rs/zh/guide/debug/rsdoctor) 来分析产物体积
+
 ### performance.transformLodash
 
 **变更内容**: 不再需要，可以直接移除。

package/docs/zh/plugin/_meta.json

@@ -11,6 +11,11 @@
     "name": "runtime-plugins",
     "label": "runtime-plugins"
   },
+  {
+    "type": "dir",
+    "name": "server-plugins",
+    "label": "server-plugins"
+  },
   {
     "type": "dir",
     "name": "official",

package/docs/zh/plugin/cli-plugins/_meta.json

@@ -1 +1 @@
-["api", "life-cycle", "migration"]
+["api", "life-cycle"]

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

@@ -1,6 +1,6 @@
 # 插件 API
 
-本文档详细介绍了 Modern.js CLI 插件的 API。CLI 插件允许您在 Modern.js 项目的构建和开发过程中扩展和定制功能。
+Modern.js 的 CLI 插件允许您在 Modern.js 项目的构建和开发过程中扩展和定制功能。
 
 :::info
 
@@ -28,7 +28,8 @@ const myCliPlugin = (): CliPlugin<AppTools> => ({
 export default myCliPlugin;
 ```
 
-`setup` 函数接收一个 `api` 对象，该对象提供了所有可用的 CLI 插件 API。
+- `name`： 插件的唯一标识符。
+- `setup` 函数接收一个 `api` 对象，该对象提供了所有可用的 CLI 插件 API。
 
 ## 信息获取
 
@@ -54,7 +55,7 @@ export default myCliPlugin;
 | `plugins`              | `object[]`          | 当前已注册的插件列表                               | -                           |
 | `entrypoints`          | `object[]`          | 页面入口信息                                       | -                           |
 | `serverRoutes`         | `object[]`          | 服务端路由信息                                     | -                           |
-| `bundlerType`          | `webpack \| rspack` | 当前使用的打包工具类型 (`webpack` 或 `rspack`)     | `onPrepare` 之后            |
+| `bundlerType`          | `rspack`            | 当前使用的打包工具类型                             | `onPrepare` 之后            |
 | `metaName`             | `string`            | 框架内部名称                                       | -                           |
 | `apiDirectory`         | `string`            | API 模块目录的绝对路径 (BFF 使用)                  | -                           |
 | `lambdaDirectory`      | `string`            | Lambda 模块目录的绝对路径 (BFF 使用)               | -                           |
@@ -186,12 +187,12 @@ api.config(() => {
 
 #### `api.modifyBundlerChain`
 
-使用 chain API 修改 webpack 或者 Rspack 配置。
+使用 chain API 修改 Rspack 配置。
 
-- **类型：** `api.modifyBundlerChain(modifyFn: (chain: WebpackChain | RspackChain, utils: WebpackUtils | RspackUtils) => void | Promise<void>)`
+- **类型：** `api.modifyBundlerChain(modifyFn: (chain: RspackChain, utils: RspackUtils) => void | Promise<void>)`
 - **参数：**
-  - `modifyFn`： 修改函数，接收 `webpack-chain` 或 `RspackChain` 实例和实用工具作为参数。
-- **执行阶段：** 在生成最终的 Webpack 或 Rspack 配置时。
+  - `modifyFn`： 修改函数，接收 `RspackChain` 实例和实用工具作为参数。
+- **执行阶段：** 在生成最终的 Rspack 配置时。
 - **对应 Rsbuild Hook**： [modifybundlerchain](https://rsbuild.rs/zh/plugins/dev/hooks#modifybundlerchain)
 - **示例：**
 
@@ -236,7 +237,7 @@ api.modifyRsbuildConfig((config, utils) => {
 - **示例：**
 
 ```typescript
-api.modifyRspackConfig((config， utils) => {
+api.modifyRspackConfig((config, utils) => {
   config.builtins.minify = {
     enable: true,
     implementation: utils.rspack.SwcJsMinimizerRspackPlugin,
@@ -246,66 +247,16 @@ api.modifyRspackConfig((config， utils) => {
 
 ---
 
-#### `api.modifyWebpackChain`
-
-使用 [webpack-chain](https://github.com/neutrinojs/webpack-chain) 修改 Webpack 配置。(当使用 Webpack 作为打包工具时)
-
-- **类型：** `api.modifyWebpackChain(modifyFn: (chain: WebpackChain, utils: WebpackUtils) => void | Promise<void>)`
-- **参数：**
-  - `modifyFn`： 修改函数，接收 `webpack-chain` 实例和实用工具作为参数。
-- **执行阶段：** 在生成最终的 Webpack 配置时。
-- **示例：**
+**构建配置修改顺序**
 
-```typescript
-api.modifyWebpackChain((chain, utils) => {
-  // 添加一个自定义的 Webpack loader
-  chain.module
-    .rule('my-loader')
-    .test(/\.my-ext$/)
-    .use('my-loader')
-    .loader(require.resolve('./my-loader'));
-});
 ```
-
----
-
-#### `api.modifyWebpackConfig`
-
-直接修改 Webpack 配置对象。(当使用 Webpack 作为打包工具时)
-
-- **类型：** `api.modifyWebpackConfig(modifyFn: (config: WebpackConfig, utils: WebpackUtils) => WebpackConfig | Promise<WebpackConfig> | void)`
-- **参数：**
-  - `modifyFn`： 修改函数，接收 Webpack 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
-- **执行阶段：** 在生成最终的 Webpack 配置时。
-- **示例：**
-
-```typescript
-api.modifyWebpackConfig((config, utils) => {
-  // 禁用 source map
-  config.devtool = false;
-});
+modifyRsbuildConfig
+modifyBundlerChain
+tools.bundlerChain
+modifyRspackConfig
+tools.rspack
 ```
 
-**构建配置修改顺序**
-
-- **使用 Rspack 构建**：
-  ```
-  modifyRsbuildConfig
-  modifyBundlerChain
-  tools.bundlerChain
-  modifyRspackConfig
-  tools.rspack
-  ```
-- **使用 Webpack 构建**：
-  ```
-  modifyBundlerChain
-  tools.bundlerChain
-  modifyWebpackChain
-  tools.webpackChain
-  modifyWebpackConfig
-  tools.webpack
-  ```
-
 ---
 
 #### `api.modifyServerRoutes`
@@ -621,4 +572,3 @@ api.onBeforePrintInstructions(({ instructions }) => {
 ## 其他说明
 
 - 可以参考 [CLI 插件生命周期](./life-cycle.mdx) 了解插件钩子的执行顺序。
-- 可以参考 [CLI 插件迁移指南](./migration.mdx) 了解如何从旧版插件迁移到新版。

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

@@ -36,8 +36,6 @@ flowchart TD
     modifyBundlerChain(modifyBundlerChain)
     modifyRsbuildConfig(modifyRsbuildConfig)
     modifyRspackConfig(modifyRspackConfig)
-    modifyWebpackChain(modifyWebpackChain)
-    modifyWebpackConfig(modifyWebpackConfig)
 
     onBeforeBuild_rsbuild(onBeforeBuild)
     onAfterBuild_rsbuild(onAfterBuild)
@@ -63,8 +61,6 @@ flowchart TD
     registry_rsbuild_hooks --> modifyBundlerChain
     modifyBundlerChain --> modifyRsbuildConfig
     modifyRsbuildConfig --> modifyRspackConfig
-    modifyRspackConfig --> modifyWebpackChain
-    modifyWebpackChain --> modifyWebpackConfig
     registry_rsbuild_hooks --> onBeforeBuild_rsbuild
     onBeforeBuild_rsbuild --> onAfterBuild_rsbuild
     onAfterBuild_rsbuild --> onDevCompileDone

package/docs/zh/plugin/introduction.mdx

@@ -18,20 +18,20 @@ Modern.js 提供了一套强大的插件体系，允许开发者通过编写插
 
 Modern.js 提供了两种主要的插件类型：Modern.js 框架插件和 Rsbuild 构建插件。选择哪种插件取决于你的具体需求：
 
-- **Rsbuild 构建插件：** 如果你的需求与构建过程密切相关，特别是涉及到 Webpack 或 Rspack 配置的修改，那么你应该选择 Rsbuild 插件。例如：
+- **Rsbuild 构建插件：** 如果你的需求与构建过程密切相关，特别是涉及到 Rspack 配置的修改，那么你应该选择 Rsbuild 插件。例如：
 
-  - 修改 Webpack/Rspack 的 `loader` 或 `plugin` 配置。
+  - 修改 Rspack 的 `loader` 或 `plugin` 配置。
   - 处理新的文件类型。
   - 修改或编译文件内容。
   - 对构建产物进行优化或处理。
 
 - **Modern.js 框架插件：** 如果你的需求与 Modern.js 框架本身的功能扩展、运行时行为或服务端逻辑相关，那么你应该选择 Modern.js 插件。例如：
   - 添加自定义的命令行命令。
-  - 修改应用的路由配置。
+  - 修改运行时信息。
   - 定制化应用的渲染过程（如 SSR）。
   - 添加服务端中间件或处理函数。
 
-简单来说，需要修改 Webpack/Rspack 配置时，使用 Rsbuild 插件；其他与框架相关的功能扩展，使用 Modern.js 插件。
+简单来说，需要修改 Rspack 配置时，使用 Rsbuild 插件；其他与框架相关的功能扩展，使用 Modern.js 插件。
 
 ## Modern.js 框架插件
 
@@ -101,12 +101,6 @@ export default defineServerConfig({
 });
 ```
 
-:::tip
-Modern.js 从 `MAJOR_VERSION.66.0` 起正式对外使用新的插件机制。
-
-如果你的当前版本低于 MAJOR_VERSION.66.0，可通过执行 `npx modern upgrade` 进行升级。
-:::
-
 ### 开发插件
 
 如果你需要开发 Modern.js 框架插件，请阅读 [Modern.js 插件系统](/plugin/plugin-system) 获取更多信息。
@@ -122,12 +116,6 @@ Rsbuild 是 Modern.js 底层的构建工具，通过添加 Rsbuild 插件可修
 
 你可以在 `modern.config.ts` 中通过 `builderPlugins` 选项注册 Rsbuild 插件，详见 [builderPlugins 构建插件](/configure/app/builder-plugins.html)。
 
-:::tip
-Modern.js 从 `MAJOR_VERSION.46.0` 起，底层构建工具升级为 [Rsbuild](https://rsbuild.rs/)。
-
-如果你的当前版本低于 MAJOR_VERSION.46.0，可通过执行 `npx modern upgrade` 进行升级。
-:::
-
 :::info
 可以阅读 [Rsbuild 官网 - 插件](https://rsbuild.rs/plugins/list/index) 了解更多 Rsbuild 插件体系内容。
 :::

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

@@ -57,12 +57,12 @@ const myPlugin: Plugin = {
   usePlugins: [], // 内部使用的插件实例列表，默认为空数组
 
   // 注册新的 Hook (可选)
-  registryHook: {},
+  registryHooks: {},
 
   // 插件的入口函数（必需）
   setup(api) {
     // 插件的核心逻辑，通过 api 对象调用插件 API
-    api.modifyWebpackConfig(config => {
+    api.modifyRspackConfig(config => {
       /* ... */
     });
     api.onPrepare(() => {
@@ -173,7 +173,7 @@ const myPlugin2 = () => ({
   name: 'my-plugin-2',
   setup: api => {
     api.onAfterPrepare(async () => {
-      // TOOD
+      // TODO
     });
   },
 });
@@ -214,17 +214,6 @@ const myPlugin = () => ({
     });
   },
 });
-
-// 其他插件使用 Hooks
-const myPlugin2 = () => ({
-  name: 'my-plugin',
-  setup: api => {
-    api.modifyRoutes(async routes => {
-      // 修改 routes
-      return routes;
-    });
-  },
-});
 ```
 
 ## 插件开发最佳实践

package/docs/zh/plugin/runtime-plugins/_meta.json

@@ -1 +1 @@
-["api", "life-cycle", "migration"]
+["api", "life-cycle"]

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

@@ -37,7 +37,7 @@ export default myRuntimePlugin;
 ```
 
 - `name`： 插件的唯一标识符。
-- `setup`： 插件的主要逻辑，接收一个 `api` 对象作为参数，用于注册钩子。
+- `setup`： 函数接收一个 `api` 对象，该对象提供了所有可用的 Runtime 插件 API。
 
 ## API 概览
 

package/docs/zh/plugin/server-plugins/_meta.json

@@ -0,0 +1 @@
+["api", "life-cycle"]