@modern-js/main-doc 2.67.6 → 2.67.8

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

@@ -17,7 +17,7 @@ import type { CliPluginFuture, AppTools } from '@modern-js/app-tools';
 
 const myCliPlugin = (): CliPluginFuture<AppTools<'shared'>> => ({
   name: '@my-org/my-plugin', // 插件名称，确保唯一性
-  setup: (api) => {
+  setup: api => {
     // 在这里使用 API 注册钩子、添加命令等
     api.onBeforeBuild(() => {
       console.log('构建即将开始...');
@@ -38,30 +38,30 @@ export default myCliPlugin;
 
 - **返回值：** `AppContext` 对象，包含以下字段：
 
-| 字段名               | 类型                 | 描述                                                                  | 何时可用                               |
-| -------------------- | -------------------- | --------------------------------------------------------------------- | -------------------------------------- |
-| `command`            | `string`             | 当前执行的命令 (e.g.， `dev`， `build`， `deploy`)                        | -                                   |
-| `port`               | `number`             | 开发服务器端口号                                                      | `onPrepare` 之后                        |
-| `configFile`         | `string`             | 配置文件的绝对路径                                                    | -                                   |
-| `isProd`             | `boolean`            | 是否为生产模式                                                        | -                                   |
-| `appDirectory`       | `string`             | 项目根目录的绝对路径                                                  | -                                   |
-| `srcDirectory`       | `string`             | 项目源码目录的绝对路径                                                | -                                   |
-| `distDirectory`      | `string`             | 项目产物输出目录的绝对路径                                            | `modifyResolvedConfig` 之后              |
-| `sharedDirectory`    | `string`             | 公共模块目录的绝对路径                                                | -                                   |
-| `nodeModulesDirectory` | `string`             | `node_modules` 目录的绝对路径                                         | -                                   |
-| `ip`                 | `string`             | 当前机器的 IPv4 地址                                                  | -                                   |
-| `packageName`        | `string`             | 项目 `package.json` 中的 `name` 字段                                   | -                                   |
-| `plugins`            | `object[]`           | 当前已注册的插件列表                                                  | -                                   |
-| `entrypoints`        | `object[]`           | 页面入口信息                                                          | -                                   |
-| `serverRoutes`       | `object[]`           | 服务端路由信息                                                        | -                                   |
-| `bundlerType`        | `webpack \| rspack` | 当前使用的打包工具类型 (`webpack` 或 `rspack`)                          | `onPrepare` 之后                        |
-| `metaName`           | `string`             | 框架内部名称                                                          | -                                   |
-| `apiDirectory`       | `string`             | API 模块目录的绝对路径 (BFF 使用)                                     | -                                   |
-| `lambdaDirectory`    | `string`             | Lambda 模块目录的绝对路径 (BFF 使用)                                  | -                                   |
-| `runtimeConfigFile`  | `string`             | 运行时配置文件的名称                                                  | -                                   |
-| `serverConfigFile`   | `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`            | 项目产物输出目录的绝对路径                         | `modifyResolvedConfig` 之后 |
+| `sharedDirectory`      | `string`            | 公共模块目录的绝对路径                             | -                           |
+| `nodeModulesDirectory` | `string`            | `node_modules` 目录的绝对路径                      | -                           |
+| `ip`                   | `string`            | 当前机器的 IPv4 地址                               | -                           |
+| `packageName`          | `string`            | 项目 `package.json` 中的 `name` 字段               | -                           |
+| `plugins`              | `object[]`          | 当前已注册的插件列表                               | -                           |
+| `entrypoints`          | `object[]`          | 页面入口信息                                       | -                           |
+| `serverRoutes`         | `object[]`          | 服务端路由信息                                     | -                           |
+| `bundlerType`          | `webpack \| rspack` | 当前使用的打包工具类型 (`webpack` 或 `rspack`)     | `onPrepare` 之后            |
+| `metaName`             | `string`            | 框架内部名称                                       | -                           |
+| `apiDirectory`         | `string`            | API 模块目录的绝对路径 (BFF 使用)                  | -                           |
+| `lambdaDirectory`      | `string`            | Lambda 模块目录的绝对路径 (BFF 使用)               | -                           |
+| `runtimeConfigFile`    | `string`            | 运行时配置文件的名称                               | -                           |
+| `serverConfigFile`     | `string`            | 服务器配置文件的名称                               | -                           |
+| `checkedEntries`       | `string[]`          | 指定的入口信息                                     | -                           |
+| `apiOnly`              | `boolean`           | 是否为 `apiOnly` 模式                              | -                           |
 
 - **示例：**
 
@@ -83,17 +83,16 @@ api.onPrepare(() => {
 
 获取用户在 `modern.config.ts` 文件中定义的配置。
 
--   **返回值：**  用户定义的配置对象。
--   **示例：**
+- **返回值：** 用户定义的配置对象。
+- **示例：**
 
 ```typescript
 api.onPrepare(() => {
-    const userConfig = api.getConfig();
-    if (userConfig.output) {
-        console.log('用户自定义了 output 配置');
-    }
+  const userConfig = api.getConfig();
+  if (userConfig.output) {
+    console.log('用户自定义了 output 配置');
+  }
 });
-
 ```
 
 ---
@@ -162,7 +161,7 @@ hooks.onPrepare.call();
 
 修改 Modern.js 的初始配置。
 
-- **类型：**  `api.config(configFn: () => UserConfig | Promise<UserConfig>)`
+- **类型：** `api.config(configFn: () => UserConfig | Promise<UserConfig>)`
 - **参数：**
   - `configFn`： 一个返回配置对象或 Promise 的函数。
 - **执行阶段：** 解析完 `modern.config.ts` 中的配置之后。
@@ -190,11 +189,11 @@ api.config(() => {
 
 使用 chain API 修改 webpack 或者 Rspack 配置。
 
-- **类型：**  `api.modifyBundlerChain(modifyFn: (chain: WebpackChain | RspackChain, utils: WebpackUtils | RspackUtils) => void | Promise<void>)`
+- **类型：** `api.modifyBundlerChain(modifyFn: (chain: WebpackChain | RspackChain, utils: WebpackUtils | RspackUtils) => void | Promise<void>)`
 - **参数：**
   - `modifyFn`： 修改函数，接收 `webpack-chain` 或 `RspackChain` 实例和实用工具作为参数。
 - **执行阶段：** 在生成最终的 Webpack 或 Rspack 配置时。
-- **对应 Rsbuild Hook**： [modifybundlerchain](https://rsbuild.dev/zh/plugins/dev/hooks#modifybundlerchain)
+- **对应 Rsbuild Hook**： [modifybundlerchain](https://rsbuild.rs/zh/plugins/dev/hooks#modifybundlerchain)
 - **示例：**
 
 ```typescript
@@ -210,32 +209,32 @@ api.modifyBundlerChain((chain, utils) => {
 
 修改 Rsbuild 的配置。
 
--   **类型：**  `api.modifyRsbuildConfig(modifyFn: (config: RsbuildConfig, utils: RsbuildUtils) => RsbuildConfig | Promise<RsbuildConfig> | void)`
--   **参数：**
-    -   `modifyFn`： 修改函数，接收 Rsbuild 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
--   **执行阶段：** 在生成最终的 Rsbuild 配置时。
--   **对应 Rsbuild Hook**： [modifyRsbuildConfig](https://rsbuild.dev/zh/plugins/dev/hooks#modifyrsbuildconfig)
--   **示例：**
+- **类型：** `api.modifyRsbuildConfig(modifyFn: (config: RsbuildConfig, utils: RsbuildUtils) => RsbuildConfig | Promise<RsbuildConfig> | void)`
+- **参数：**
+  - `modifyFn`： 修改函数，接收 Rsbuild 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
+- **执行阶段：** 在生成最终的 Rsbuild 配置时。
+- **对应 Rsbuild Hook**： [modifyRsbuildConfig](https://rsbuild.rs/zh/plugins/dev/hooks#modifyrsbuildconfig)
+- **示例：**
 
 ```typescript
 api.modifyRsbuildConfig((config, utils) => {
   // 添加一个自定义的 Rsbuild 插件
   config.plugins.push(myCustomRsbuildPlugin());
 });
-
 ```
+
 ---
 
 #### `api.modifyRspackConfig`
 
 修改 Rspack 的配置。(当使用 Rspack 作为打包工具时)
 
--   **类型：**  `api.modifyRspackConfig(modifyFn: (config: RspackConfig, utils: RspackUtils) => RspackConfig | Promise<RspackConfig> | void)`
--   **参数：**
-    -   `modifyFn`： 修改函数，接收 Rspack 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
--   **执行阶段：** 在生成最终的 Rspack 配置时。
--   **对应 Rsbuild Hook**： [modifyRspackConfig](https://rsbuild.dev/zh/plugins/dev/hooks#modifyrspackconfig)
--   **示例：**
+- **类型：** `api.modifyRspackConfig(modifyFn: (config: RspackConfig, utils: RspackUtils) => RspackConfig | Promise<RspackConfig> | void)`
+- **参数：**
+  - `modifyFn`： 修改函数，接收 Rspack 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
+- **执行阶段：** 在生成最终的 Rspack 配置时。
+- **对应 Rsbuild Hook**： [modifyRspackConfig](https://rsbuild.rs/zh/plugins/dev/hooks#modifyrspackconfig)
+- **示例：**
 
 ```typescript
 api.modifyRspackConfig((config， utils) => {
@@ -252,7 +251,7 @@ api.modifyRspackConfig((config， utils) => {
 
 使用 [webpack-chain](https://github.com/neutrinojs/webpack-chain) 修改 Webpack 配置。(当使用 Webpack 作为打包工具时)
 
-- **类型：**  `api.modifyWebpackChain(modifyFn: (chain: WebpackChain, utils: WebpackUtils) => void | Promise<void>)`
+- **类型：** `api.modifyWebpackChain(modifyFn: (chain: WebpackChain, utils: WebpackUtils) => void | Promise<void>)`
 - **参数：**
   - `modifyFn`： 修改函数，接收 `webpack-chain` 实例和实用工具作为参数。
 - **执行阶段：** 在生成最终的 Webpack 配置时。
@@ -275,39 +274,38 @@ api.modifyWebpackChain((chain, utils) => {
 
 直接修改 Webpack 配置对象。(当使用 Webpack 作为打包工具时)
 
--   **类型：**  `api.modifyWebpackConfig(modifyFn: (config: WebpackConfig, utils: WebpackUtils) => WebpackConfig | Promise<WebpackConfig> | void)`
--   **参数：**
-    -   `modifyFn`： 修改函数，接收 Webpack 配置对象和实用工具作为参数，可以返回修改后的配置对象、Promise 或不返回（直接修改原对象）。
--   **执行阶段：** 在生成最终的 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;
 });
-
 ```
 
 **构建配置修改顺序**
 
--   **使用 Rspack 构建**：
-    ```
-    modifyRsbuildConfig
-    modifyBundlerChain
-    tools.bundlerChain
-    modifyRspackConfig
-    tools.rspack
-    ```
--   **使用 Webpack 构建**：
-    ```
-    modifyBundlerChain
-    tools.bundlerChain
-    modifyWebpackChain
-    tools.webpackChain
-    modifyWebpackConfig
-    tools.webpack
-    ```
+- **使用 Rspack 构建**：
+  ```
+  modifyRsbuildConfig
+  modifyBundlerChain
+  tools.bundlerChain
+  modifyRspackConfig
+  tools.rspack
+  ```
+- **使用 Webpack 构建**：
+  ```
+  modifyBundlerChain
+  tools.bundlerChain
+  modifyWebpackChain
+  tools.webpackChain
+  modifyWebpackConfig
+  tools.webpack
+  ```
 
 ---
 
@@ -324,7 +322,7 @@ api.modifyWebpackConfig((config, utils) => {
 ```typescript
 api.modifyServerRoutes(routes => {
   // 添加一个新的 API 路由
-  routes.concat({
+  routes.push({
     urlPath: '/api',
     isApi: true,
     entryPath: '',
@@ -352,7 +350,7 @@ api.modifyServerRoutes(routes => {
 api.modifyHtmlPartials(({ entrypoint, partials }) => {
   // 在所有页面的 <head> 标签中添加一个 meta 标签
   if (partials.head && partials.head.append) {
-      partials.head.append(`<meta name="my-custom-meta" content="value">`);
+    partials.head.append(`<meta name="my-custom-meta" content="value">`);
   }
 });
 ```
@@ -460,84 +458,88 @@ api.onFileChanged(({ filename, eventType }) => {
 - **参数：**
   - `buildFn`： 构建前执行的函数，无参数，可异步。
 - **执行阶段：** 在执行构建流程之前。
-- **对应 Rsbuild Hook**： [onBeforeBuild](https://rsbuild.dev/zh/plugins/dev/hooks#onbeforebuild)
+- **对应 Rsbuild Hook**： [onBeforeBuild](https://rsbuild.rs/zh/plugins/dev/hooks#onbeforebuild)
 - **示例：**
 
 ```typescript
-api.onBeforeBuild(()=>{
-    // 构建前做一些环境检查
-})
+api.onBeforeBuild(() => {
+  // 构建前做一些环境检查
+});
 ```
+
 ---
 
 #### `api.onAfterBuild`
 
 在构建完成后添加额外的逻辑。
 
--   **类型：**  `api.onAfterBuild(buildFn: () => void | Promise<void>)`
--   **参数：**
-    -   `buildFn`： 构建后执行的函数，无参数，可异步。
--   **执行阶段：** 在执行构建流程之后。
--   **对应 Rsbuild Hook**： [onAfterBuild](https://rsbuild.dev/zh/plugins/dev/hooks#onafterbuild)
--   **示例：**
+- **类型：** `api.onAfterBuild(buildFn: () => void | Promise<void>)`
+- **参数：**
+  - `buildFn`： 构建后执行的函数，无参数，可异步。
+- **执行阶段：** 在执行构建流程之后。
+- **对应 Rsbuild Hook**： [onAfterBuild](https://rsbuild.rs/zh/plugins/dev/hooks#onafterbuild)
+- **示例：**
 
 ```typescript
-api.onAfterBuild(()=>{
-    // 构建后上传sourceMap
-})
+api.onAfterBuild(() => {
+  // 构建后上传sourceMap
+});
 ```
 
 ---
 
 #### `api.onDevCompileDone`
+
 在开发服务器编译完成后添加额外的逻辑。
 
--   **类型：**  `api.onDevCompileDone(compileFn: () => void | Promise<void>)`
--   **参数：**
-    -   `compileFn`： 编译完成后执行的函数。
--   **执行阶段：** 开发服务器启动，且首次编译完成后。
--   **对应 Rsbuild Hook**： [onDevCompileDone](https://rsbuild.dev/zh/plugins/dev/hooks#ondevcompiledone)
--   **示例：**
+- **类型：** `api.onDevCompileDone(compileFn: () => void | Promise<void>)`
+- **参数：**
+  - `compileFn`： 编译完成后执行的函数。
+- **执行阶段：** 开发服务器启动，且首次编译完成后。
+- **对应 Rsbuild Hook**： [onDevCompileDone](https://rsbuild.rs/zh/plugins/dev/hooks#ondevcompiledone)
+- **示例：**
 
 ```typescript
 api.onDevCompileDone(() => {
-    // 首次编译完成，打开浏览器
+  // 首次编译完成，打开浏览器
 });
 ```
+
 ---
 
 #### `api.onBeforeCreateCompiler`
 
 在创建编译器实例之前添加额外的逻辑。
 
--   **类型：**  `api.onBeforeCreateCompiler(createFn: () => void | Promise<void>)`
--   **参数：**
-    -   `createFn`： 创建前执行的函数，无参数，可异步。
--   **执行阶段：** 在创建 Webpack 或 Rspack 编译器实例之前。
--   **对应 Rsbuild Hook**： [onBeforeCreateCompiler](https://rsbuild.dev/zh/plugins/dev/hooks#onbeforecreatecompiler)
--   **示例：**
+- **类型：** `api.onBeforeCreateCompiler(createFn: () => void | Promise<void>)`
+- **参数：**
+  - `createFn`： 创建前执行的函数，无参数，可异步。
+- **执行阶段：** 在创建 Webpack 或 Rspack 编译器实例之前。
+- **对应 Rsbuild Hook**： [onBeforeCreateCompiler](https://rsbuild.rs/zh/plugins/dev/hooks#onbeforecreatecompiler)
+- **示例：**
 
 ```typescript
 api.onBeforeCreateCompiler(() => {
-    // 可以获取 compiler 相关配置
+  // 可以获取 compiler 相关配置
 });
 ```
 
 ---
 
 #### `api.onAfterCreateCompiler`
+
 在创建编译器实例之后添加额外的逻辑。
 
--   **类型：**  `api.onAfterCreateCompiler(createFn: () => void | Promise<void>)`
--   **参数：**
-    -   `createFn`： 创建后执行的函数，无参数，可异步。
--   **执行阶段：** 在创建 Webpack 或 Rspack 编译器实例之后。
--   **对应 Rsbuild Hook**： [onAfterCreateCompiler](https://rsbuild.dev/zh/plugins/dev/hooks#onaftercreatecompiler)
--   **示例：**
+- **类型：** `api.onAfterCreateCompiler(createFn: () => void | Promise<void>)`
+- **参数：**
+  - `createFn`： 创建后执行的函数，无参数，可异步。
+- **执行阶段：** 在创建 Webpack 或 Rspack 编译器实例之后。
+- **对应 Rsbuild Hook**： [onAfterCreateCompiler](https://rsbuild.rs/zh/plugins/dev/hooks#onaftercreatecompiler)
+- **示例：**
 
 ```typescript
 api.onAfterCreateCompiler(() => {
-    // 可以获取 compiler 实例
+  // 可以获取 compiler 实例
 });
 ```
 
@@ -568,15 +570,15 @@ api.onBeforeDev(async () => {
 
 - **类型：** `api.onAfterDev(devFn: () => void | Promise<void>)`
 - **参数：**
-    -   `devFn`： 开发服务器启动后执行的函数。
+  - `devFn`： 开发服务器启动后执行的函数。
 - **执行阶段：** 开发服务器成功启动后。
-- **对应 Rsbuild Hook**： [onAfterStartDevServer](https://rsbuild.dev/zh/plugins/dev/hooks#onafterstartdevserver)
+- **对应 Rsbuild Hook**： [onAfterStartDevServer](https://rsbuild.rs/zh/plugins/dev/hooks#onafterstartdevserver)
 - **示例：**
 
 ```typescript
-api.onAfterDev(()=>{
-    // 上报 dev 相关信息
-})
+api.onAfterDev(() => {
+  // 上报 dev 相关信息
+});
 ```
 
 ---
@@ -604,20 +606,20 @@ api.onBeforeExit(async () => {
 
 在打印成功信息前添加额外的逻辑。
 
--   **类型：**  `api.onBeforePrintInstructions(printFn: ({instructions: string}) => {instructions: string} | Promise<{instructions: string}>)`
--   **参数：**
-    -   `printFn`： 修改打印信息的函数， 返回修改后的信息。
--   **执行阶段：** 打印成功信息前。
--   **示例：**
+- **类型：** `api.onBeforePrintInstructions(printFn: ({instructions: string}) => {instructions: string} | Promise<{instructions: string}>)`
+- **参数：**
+  - `printFn`： 修改打印信息的函数， 返回修改后的信息。
+- **执行阶段：** 打印成功信息前。
+- **示例：**
 
 ```typescript
 api.onBeforePrintInstructions(({ instructions }) => {
   // do something
-  return { instructions }
+  return { instructions };
 });
 ```
 
 ## 其他说明
 
--   可以参考 [CLI 插件生命周期](./life-cycle.mdx) 了解插件钩子的执行顺序。
--   可以参考 [CLI 插件迁移指南](./migration.mdx) 了解如何从旧版插件迁移到新版。
+- 可以参考 [CLI 插件生命周期](./life-cycle.mdx) 了解插件钩子的执行顺序。
+- 可以参考 [CLI 插件迁移指南](./migration.mdx) 了解如何从旧版插件迁移到新版。

package/docs/zh/plugin/introduction.mdx

@@ -19,16 +19,17 @@ Modern.js 提供了一套强大的插件体系，允许开发者通过编写插
 Modern.js 提供了两种主要的插件类型：Modern.js 框架插件和 Rsbuild 构建插件。选择哪种插件取决于你的具体需求：
 
 - **Rsbuild 构建插件：** 如果你的需求与构建过程密切相关，特别是涉及到 Webpack 或 Rspack 配置的修改，那么你应该选择 Rsbuild 插件。例如：
-    - 修改 Webpack/Rspack 的 `loader` 或 `plugin` 配置。
-    - 处理新的文件类型。
-    - 修改或编译文件内容。
-    - 对构建产物进行优化或处理。
+
+  - 修改 Webpack/Rspack 的 `loader` 或 `plugin` 配置。
+  - 处理新的文件类型。
+  - 修改或编译文件内容。
+  - 对构建产物进行优化或处理。
 
 - **Modern.js 框架插件：** 如果你的需求与 Modern.js 框架本身的功能扩展、运行时行为或服务端逻辑相关，那么你应该选择 Modern.js 插件。例如：
-    - 添加自定义的命令行命令。
-    - 修改应用的路由配置。
-    - 定制化应用的渲染过程（如 SSR）。
-    - 添加服务端中间件或处理函数。
+  - 添加自定义的命令行命令。
+  - 修改应用的路由配置。
+  - 定制化应用的渲染过程（如 SSR）。
+  - 添加服务端中间件或处理函数。
 
 简单来说，需要修改 Webpack/Rspack 配置时，使用 Rsbuild 插件；其他与框架相关的功能扩展，使用 Modern.js 插件。
 
@@ -69,13 +70,14 @@ export default defineRuntimeConfig({
 });
 ```
 
+{/* prettier-ignore */}
 {/* #### Server 插件
 
 Server 插件用于在应用接受请求时提供额外功能，例如添加中间件、修改请求响应等。
 
 Server 插件通过 `server/modern.server.ts` 中的 `plugins` 字段进行配置。
 
-```ts title="src/modern.server.ts"
+````ts title="src/modern.server.ts"
 import { defineConfig } from '@modern-js/app-tools/server';
 import bffPlugin from '@modern-js/plugin-bff/server';
 
@@ -106,13 +108,13 @@ 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.dev/)。
+Modern.js 从 `MAJOR_VERSION.46.0` 起，底层构建工具升级为 [Rsbuild](https://rsbuild.rs/)。
 
 如果你的当前版本低于 MAJOR_VERSION.46.0，可通过执行 `npx modern upgrade` 进行升级。
 :::
 
 :::info
-可以阅读 [Rsbuild 官网 - 插件](https://rsbuild.dev/plugins/list/index) 了解更多 Rsbuild 插件体系内容。
+可以阅读 [Rsbuild 官网 - 插件](https://rsbuild.rs/plugins/list/index) 了解更多 Rsbuild 插件体系内容。
 :::
 
 ### 官方插件
@@ -123,10 +125,10 @@ Modern.js 从 `MAJOR_VERSION.46.0` 起，底层构建工具升级为 [Rsbuild](h
 
 | 插件                                                                                         | 介绍                                                                                     | Modern.js 链接                                                                                                                        |
 | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| [React 插件](https://rsbuild.dev/zh/plugins/list/plugin-react)                               | 提供对 React 的支持                                                                      | -                                                                                                                                     |
-| [SVGR 插件](https://rsbuild.dev/zh/plugins/list/plugin-svgr)                                 | 支持将 SVG 图片转换为一个 React 组件                                                     | [output.disableSvgr](/configure/app/output/disable-svgr)<br />[output.svgDefaultExport](/configure/app/output/svg-default-export)     |
+| [React 插件](https://rsbuild.rs/zh/plugins/list/plugin-react)                               | 提供对 React 的支持                                                                      | -                                                                                                                                     |
+| [SVGR 插件](https://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)     |
 | [Styled Components 插件](https://github.com/rspack-contrib/rsbuild-plugin-styled-components) | 提供对 styled-components 的编译时支持                                                    | [tools.styledComponents](/configure/app/tools/styled-components.html)                                                                 |
-| [Assets Retry 插件](https://rsbuild.dev/zh/plugins/list/plugin-assets-retry)                 | 用于在静态资源加载失败时自动发起重试请求                                                 | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
+| [Assets Retry 插件](https://rsbuild.rs/zh/plugins/list/plugin-assets-retry)                 | 用于在静态资源加载失败时自动发起重试请求                                                 | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
 | [Type Check 插件](https://github.com/rspack-contrib/rsbuild-plugin-type-check)               | 用于在单独的进程中运行 TypeScript 类型检查                                               | [output.disableTsChecker](/configure/app/output/disable-ts-checker.html)<br />[tools.tsChecker](/configure/app/tools/ts-checker.html) |
 | [Node Polyfill 插件](https://github.com/rspack-contrib/rsbuild-plugin-node-polyfill)         | 用于注入 Node 核心模块在浏览器端的 polyfills                                             | [output.disableNodePolyfill](/configure/app/output/disable-node-polyfill.html)                                                        |
 | [Source Build 插件](https://github.com/rspack-contrib/rsbuild-plugin-source-build)           | 用于 monorepo 场景，支持引用其他子目录的源代码，并完成构建和热更新                       | [experiments.sourceBuild](/configure/app/experiments/source-build.html)                                                               |
@@ -142,9 +144,10 @@ Modern.js 从 `MAJOR_VERSION.46.0` 起，底层构建工具升级为 [Rsbuild](h
 以下是未在 Modern.js 中内置的 Rsbuild 官方插件：
 
 - [Image Compress 插件](https://github.com/rspack-contrib/rsbuild-plugin-image-compress)：将项目中用到的图片资源进行压缩处理。
-- [Stylus 插件](https://rsbuild.dev/zh/plugins/list/plugin-stylus)：使用 Stylus 作为 CSS 预处理器。
+- [Stylus 插件](https://rsbuild.rs/zh/plugins/list/plugin-stylus)：使用 Stylus 作为 CSS 预处理器。
 - [UMD 插件](https://github.com/rspack-contrib/rsbuild-plugin-umd)：用于构建 UMD 格式的产物。
 
 import OtherPlugins from '@site-docs/components/other-plugins.mdx';
 
 <OtherPlugins />
+````