@rsdoctor/docs 1.2.3 → 1.2.4-beta.1

package/docs/en/config/options/output.mdx

@@ -0,0 +1,162 @@
+import { Badge } from '@theme';
+
+# output
+
+## mode
+
+<Badge text="V1.2.4 Added" type="tip" />
+
+- **Type:** `"normal" | "brief"`
+
+Rsdoctor report mode, default is `normal`.
+
+- **normal:** Generates a `.rsdoctor` folder in the build output directory, containing various data files and displaying code in the report page. The output directory can be configured via [reportDir](#reportdir).
+- **brief:** Generates an HTML report file in the `.rsdoctor` folder of the build output directory. All build analysis data is integrated and injected into this HTML file, which can be opened in a browser to view the report. Brief mode has more configuration options, see [brief](#brief) for details.
+
+:::tip
+Mode does not have a lite configuration option. The lite mode will be deprecated. Refer to [lite mode deprecation notice](./options-v2.mdx#lite-mode-deprecation-notice).
+:::
+
+## options
+
+<Badge text="V1.2.4 Added" type="tip" />
+
+- **Type:** `BriefModeOptions | NormalModeOptions`
+- **Optional:** `true`
+- **Default:** `undefined`
+- **Description:**
+  Based on different `mode` configurations, `options` supports different configuration items:
+
+### mode: 'brief'
+
+Brief mode is used to generate lightweight analysis reports, supporting both HTML and JSON output formats.
+
+- **`type`**: Output type, supports `'html'` and `'json'` arrays, allowing multiple formats to be selected simultaneously
+- **`htmlOptions`**: HTML output related configuration
+  - **`reportHtmlName`**: HTML report filename, defaults to `report-rsdoctor.html`
+- **`jsonOptions`**: JSON output related configuration
+  - **`sections`**: Module configuration for JSON output
+    - **`moduleGraph`**: Whether to include module graph data, defaults to `true`
+    - **`chunkGraph`**: Whether to include Chunk graph data, defaults to `true`
+    - **`rules`**: Whether to include rules data, defaults to `true`
+
+**Configuration Example:**
+
+```js
+new RsdoctorRspackPlugin({
+  output: {
+    mode: 'brief',
+    options: {
+      // Output both HTML and JSON formats
+      type: ['html', 'json'],
+      htmlOptions: {
+        reportHtmlName: 'my-report.html',
+      },
+    },
+  },
+});
+```
+
+**Notes:**
+
+- In Brief mode, the **`reportCodeType`** configuration item is invalid because only **`'noCode'`** is supported.
+- In Brief mode, when **type is 'html'**, analysis data is directly injected into the HTML file, making it convenient for single-file sharing.
+- In Brief mode, when **type is 'json'**, structured data files are generated, making it convenient for programmatic processing.
+
+### mode: 'normal'
+
+In Normal mode, `options` is an empty object with no additional configuration items.
+
+### Type Definitions
+
+#### BriefModeOptions
+
+```ts
+interface BriefModeOptions {
+  /** Output type, supports HTML and JSON */
+  type?: Array<'html' | 'json'>;
+  /** HTML output related configuration */
+  htmlOptions?: BriefConfig;
+  /** JSON output related configuration */
+  jsonOptions?: JsonOptions;
+}
+
+interface BriefConfig {
+  /** HTML report filename, defaults to report-rsdoctor.html */
+  reportHtmlName?: string;
+  /** Whether to additionally generate JSON data files, defaults to false */
+  writeDataJson: boolean;
+}
+
+interface JsonOptions {
+  /** Module configuration for JSON output */
+  sections?: JsonSectionOptions;
+}
+
+interface JsonSectionOptions {
+  /** Whether to include module graph data, defaults to true */
+  moduleGraph?: boolean;
+  /** Whether to include Chunk graph data, defaults to true */
+  chunkGraph?: boolean;
+  /** Whether to include rules data, defaults to true */
+  rules?: boolean;
+}
+```
+
+#### NormalModeOptions
+
+NormalModeOptions currently has an empty Object type.
+
+## reportCodeType
+
+- **Type:** `"noModuleSource" | "noAssetsAndModuleSource" | "noCode" | { noModuleSource?: boolean; noAssetsAndModuleSource?: boolean; noCode?: boolean }`
+  - **In V2, only String type will be supported.**
+- **Optional:** `true`
+- **Default:** `undefined`, when undefined, outputs all complete data.
+- **Description:**
+  Select the scope of output analysis data:
+  - **Default**: Output all complete data
+  - **`noModuleSource`**: Output data excluding module ([Module](https://rspack.rs/config/module#module)) code. Module code refers to the packaged module code of individual files within the Bundle.
+  - **`noAssetsAndModuleSource`**: Output data excluding module ([Module](https://rspack.rs/config/module#module)) code and Assets product code
+  - **`noCode`**: Output data excluding code, i.e., no code is output
+
+### Output Data Comparison Table
+
+| Configuration               | Included Data                                                                                                            | Excluded Data                                                     | Use Cases                                                                                   | File Size |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | --------- |
+| **Default** (No Config)     | **Complete build information:**<br/>• Module graph data and its bundled code<br/>• Assets code<br/>• Other analysis data | None                                                              | • Development debugging<br/>• Complete analysis                                             | Largest   |
+| **noModuleSource**          | • Build information<br/>• Module graph data and its bundled code<br/>• Assets code<br/>• Other analysis data             | Module source code                                                | • No need to view source code<br/>• Memory leak issues                                      | Medium    |
+| **noAssetsAndModuleSource** | • Build information<br/>• Module graph data and its bundled code<br/>• Other analysis data                               | Module source code, Assets code                                   | • Large projects<br/>• No need to view source code and Assets code<br/>• Memory leak issues | Smaller   |
+| **noCode**                  | • Build information<br/>• Module graph data<br/>• Other analysis data                                                    | All code (Module source code + Module bundled code + Assets code) | • Large projects<br/>• CI/CD<br/>• Memory leak issues                                       | Smallest  |
+
+**Data output order from rich to simple:** `Default` > `noModuleSource` > `noAssetsAndModuleSource` > `noCode`
+
+> For the explanation of Asset and Module, see [Term](./term).
+
+- **Example:**
+
+```js
+new RsdoctorRspackPlugin({
+  reportCodeType: { noModuleSource: true } // { noAssetsAndModuleSource: true }
+}),
+```
+
+## reportDir
+
+- **Type:** `string`
+- **Optional:** `true`
+- **Default:** `undefined`
+
+The output directory for Rsdoctor reports. By default, it is the build output directory.
+
+## compressData
+
+:::warning
+Deprecated in V2, please use `output.mode: 'brief'` and `output.options.type: 'json'` instead. Refer to [compressData configuration migration](/config/options/options-v2#compressdata).
+:::
+
+- **Type:** `boolean`
+- **Optional:** `true`
+- **Default:** `true`
+
+compressData is used to configure whether to compress the analysis data under `[outputDir]/.rsdoctor`.

package/docs/en/config/options/port.mdx

@@ -0,0 +1,7 @@
+# port
+
+- **Type:** `number`
+- **Optional:** `true`
+- **Default:** `random(3000, 8999)`
+
+Configure the port for the Rsdoctor server.

package/docs/en/config/options/supports.mdx

@@ -0,0 +1,72 @@
+import { Badge } from '@theme';
+
+# supports
+
+- **Type:** [Supports Types](#supports-types)
+- **Optional:** `true`
+- **Default:** `undefined`
+
+This option is used to configure whether Rsdoctor enables support for certain detailed feature analysis capabilities, such as whether to enable compatibility with BannerPlugin.
+
+## supportsTypes
+
+```ts
+type ISupport = {
+  banner?: boolean;
+  parseBundle?: boolean;
+  generateTileGraph?: boolean;
+};
+```
+
+## banner
+
+:::danger
+`supports.banner` option is only used for debugging, do not use it in production.
+:::
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+If `supports.banner` is enabled, Rsdoctor will enable compatibility logic for BannerPlugin. For more details, please refer to: [Supports BannerPlugin](../../guide/usage/bundle-size#supports-bannerplugin)
+
+## ~~generateTileGraph [**Deprecated**]~~
+
+<Badge text="Deprecated" type="warning" />
+
+Rsdoctor supports generating Tree Map graphs by default, so this option does not need to be configured.
+
+## parseBundle
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+In some large repositories, the execution time of parsing the bundle is too long. Since the Parse Bundle analysis utilizes AST parsing and processing, it can be time-consuming when there are a large number of output files.
+If this capability is not necessary, it can be selectively disabled using the supports.parseBundle configuration. An example is shown below:
+
+```ts
+chain.plugin('Rsdoctor').use(RsdoctorRspackPlugin, [
+  {
+    supports: {
+      parseBundle: false,
+    },
+  },
+]);
+```
+
+Disabling the Parse Bundle capability will only affect the visibility of the Bundled Size and Bundled Code of the modules in the bundle:
+
+<div style={{ display: 'flex' }}>
+  <img
+    src="https://assets.rspack.rs/others/assets/rsdoctor/bundled-size.jpeg"
+    height="300px"
+    width="300px"
+    style={{ margin: 'auto' }}
+  />
+
+  <img
+    src="https://assets.rspack.rs/others/assets/rsdoctor/bundled-code.png"
+    height="300px"
+    width="400px"
+    style={{ margin: 'auto' }}
+  />
+</div>

package/docs/en/config/options/term.mdx

@@ -1,10 +1,43 @@
 # Terminology
 
-## Common terminology
+## Common Terminology
 
 ### manifest.json
 
 When your project integrates with plugins provided by **Rsdoctor** (such as `@rsdoctor/webpack-plugin`, etc.), Rsdoctor will write **build-related data information** into a local JSON file:
 
 - The **filename is `manifest.json`**
-- The output path of this file is `output directory of the project/.rsdoctor/manifest.json`
+- The output **path is `project output directory/.rsdoctor/manifest.json`**
+
+### Artifact Terminology Definitions
+
+### assets (Resources | Artifact Files)
+
+**Definition:**  
+Refers to all static files in the project, such as images, fonts, CSS, JS, SVG, etc. They are files that are output to the target directory after build and will eventually be loaded and used by the browser.
+
+**Examples:**
+
+- `logo.png`, `main.css`, `app.js` are all assets.
+
+### chunk
+
+**Definition:**  
+Rspack will package multiple modules (JS, CSS, etc.) into one or more files, and these files are bundles. A chunk may contain multiple Assets, for example: a chunk named index may contain two artifacts: index.js and index.css.
+
+### module
+
+**Definition:**  
+In Rspack, any file can be considered a module. The most common are JS modules (via `import` or `require`), but they can also be CSS, images, etc. Modules are the smallest units in the build process, and Rspack organizes them through a dependency graph. Assets are composed of collections of Modules.
+
+**Examples:**
+
+- Third-party files or source files, such as `index.js`, `button.js`, `style.css`, are all modules. These files are not artifact files, but they participate in the packaging process of artifact files and may eventually be packaged into artifact files.
+
+### Summary Comparison
+
+| English Name | Role in Rspack                                             |
+| ------------ | ---------------------------------------------------------- |
+| assets       | Final artifacts, static files                              |
+| chunk        | Output packaged files, a chunk may contain multiple assets |
+| module       | Smallest unit in build, source files                       |

package/docs/en/guide/more/faq.mdx

@@ -12,9 +12,9 @@ new RsdoctorRspackPlugin({
 });
 ```
 
-## Loader time-consuming data is inaccurate?
+## Loader timing data is inaccurate?
 
-The time-consuming data provided by Rsdoctor for loaders is an **estimated time**. Why can't it accurately measure the timing? It's because we know that loader execution can be both **asynchronous** and **synchronous**.
+The timing data provided by Rsdoctor for loaders is an **estimated time**. Why can't it accurately measure the timing? It's because we know that loader execution can be both **asynchronous** and **synchronous**.
 Additionally, the bundler will **parallelize the execution** of multiple non-conflicting loader functions. Since JavaScript is single-threaded, multiple loader functions can **compete for the current task queue**.
 Furthermore, the asynchronous logic within loader functions cannot be recognized, causing a single loader function to potentially span across the execution of multiple other loaders. As a result, there are three possible cases, as shown in the following diagram:
 
@@ -96,19 +96,19 @@ export default {
 - In the rspeedy project, configure it in `rspeedy.config.ts`:
 
 ```js rspeedy.config.ts
-  export default {
-    tools: {
-      rspack(config, { env }) {
-        if (process.env.RSDOCTOR === 'true') {
-            config.optimization = {
-              ...config.optimization,
-              concatenateModules: false,
-            },
-            return config
-          }
-      },
+export default {
+  tools: {
+    rspack(config, { env }) {
+      if (process.env.RSDOCTOR === 'true') {
+        config.optimization = {
+          ...config.optimization,
+          concatenateModules: false,
+        };
+        return config;
+      }
     },
-  };
+  },
+};
 ```
 
 ## The loader of CssExtractRspackPlugin takes too long

package/docs/en/guide/rules/rule-custom.mdx

@@ -72,7 +72,7 @@ When writing custom rules, in addition to installing the basic `@rsdoctor/rspack
 
 import { PackageManagerTabs } from '@theme';
 
-import { Tab, Tabs } from 'rspress/theme';
+import { Tab, Tabs } from '@rspress/core/theme';
 
 <PackageManagerTabs command="add @rsdoctor/core -D" />
 
@@ -199,19 +199,15 @@ At the same time, Rsdoctor also has two components that can be used to display r
   [LinkRule Type](#linkrulestoredata)
 
 - Component Input
-
   - type
-
     - The type of the component.
     - value: 'link'.
 
   - title
-
     - The title of the rule.
     - type: string.
 
   - description
-
     - The description of the rule. The data comes from the `message` or `detail.description` in the `report` function:
       ```js
       report({
@@ -225,7 +221,6 @@ At the same time, Rsdoctor also has two components that can be used to display r
     - type: string.
 
   - level
-
     - The level of the rule.
     - type: warn | error.
 
@@ -266,19 +261,15 @@ report({
   [CodeViewRule Type](#codeviewrule)
 
 - Component Input
-
   - type
-
     - The type of the component.
     - value: 'code-view'.
 
   - title
-
     - The title of the rule.
     - type: string.
 
   - description
-
     - The description of the rule. The data comes from the `message` or `detail.description` in the `report` function:
       ```js
       report({
@@ -292,7 +283,6 @@ report({
     - type: string.
 
   - level
-
     - The level of the rule.
     - type: warn | error.
 

package/docs/en/guide/start/cli.mdx

@@ -17,7 +17,7 @@ We provide `@rsdoctor/cli` for you to use Rsdoctor's features locally through th
 
 import { PackageManagerTabs } from '@theme';
 
-import { Tab, Tabs } from 'rspress/theme';
+import { Tab, Tabs } from '@rspress/core/theme';
 
 <PackageManagerTabs command="add @rsdoctor/cli -D" />
 
@@ -76,18 +76,18 @@ We provide a Node.js API in `@rsdoctor/cli` that allows you to make calls during
 
 <Tabs>
 
-<Tab label="cjs">
+<Tab label="esm">
 
 ```js
-const { execute } = require('@rsdoctor/cli');
+import { execute } from '@rsdoctor/cli';
 ```
 
 </Tab>
 
-<Tab label="esm">
+<Tab label="cjs">
 
 ```js
-import { execute } from '@rsdoctor/cli';
+const { execute } = require('@rsdoctor/cli');
 ```
 
 </Tab>

package/docs/en/guide/start/intro.mdx

@@ -4,7 +4,7 @@ Rsdoctor is a build analyzer tailored for the [Rspack](https://rspack.rs/) ecosy
 
 Rsdoctor is committed to being a one-stop, intelligent build analyzer that makes the build process transparent, predictable, and optimizable through visualization and smart analysis, helping development teams precisely identify bottlenecks, optimize performance, and improve engineering quality.
 
-Rsdoctor supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://lib.rsbuild.rs/).
+Rsdoctor supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://rslib.rs/).
 
 <video
   src="https://assets.rspack.rs/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"

package/docs/en/guide/start/quick-start-shared.mdx

@@ -84,7 +84,7 @@ For projects using Modern.js's webpack mode, please register the `RsdoctorWebpac
 
 Initialize the [RsdoctorRspackPlugin](#rspack-projects)([RsdoctorWebpackPlugin](#webpack-projects)) plugin in the [Rspack Config](https://rspack.rs/guide/tech/next)([webpack config](https://nextjs.org/docs/pages/api-reference/config/next-config-js/webpack)) of `next.config.ts`.
 
-import { Tab, Tabs } from 'rspress/theme';
+import { Tab, Tabs } from '@rspress/core/theme';
 
 <Tabs>
 

package/docs/en/guide/usage/bundle-size.mdx

@@ -5,7 +5,7 @@
 **Rsdoctor** provides the `Bundle Size` module, which is mainly used to analyze the information of the build artifacts of **Webpack** or **Rspack**, including the **size of resources**, **duplicate packages**, and **module reference relationships**:
 
 - **Bundle Overview**: Displays the total number and size of artifacts, as well as the number and size of each file type. It also shows the duplicate packages and their reference chains.
-- **Bundle Analysis Module**: Analyzes the size and code information of the build artifacts' resources (**Assets**) and the included **Modules**. In this module, you can view the **actual code size of modules after packaging** in the Assets, as well as the original code or **packaged code segments** and **module reference relationships**.
+- **Bundle Analysis Module**: Analyzes the size and code information of the build artifacts (**Assets**) and the included **Modules**. In this module, you can view the **actual code size of modules after packaging** in the Assets, as well as the original code or **packaged code segments** and **module reference relationships**.
 
 <img
   src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-overall.png"

package/docs/en/guide/usage/module-analysis.mdx

@@ -46,9 +46,8 @@ The `Reasons Tree` displays the dependency chain of this `Module`, showing which
 - The `Usage` tag displays the purpose of various module tags.
 
 - The `Concatenated` tag:
-
   - The `Concatenated` tag indicates that the module is a concatenated sub-module. Hover over it to see which main module it is aggregated into. This type of aggregated module cannot be further unpacked, so the specific `Bundled Size` cannot be determined, only the size of the entire concatenated module can be known.
-  - Glossary: A **concatenated module** is when multiple modules are promoted or **concatenated into a closure** during packaging. For an explanation of `Concatenated Module`, refer to the [Glossary](guide/usage/bundle-size#glossary).
+  - Glossary: A **concatenated module** is when multiple modules are promoted or **concatenated into a closure** during packaging. For an explanation of `Concatenated Module`, refer to the [Glossary](/guide/usage/bundle-size#glossary).
 
 - The `!` tag, hover over it to display the detailed path of the module.
 

package/docs/en/shared/mode-intro.md

@@ -1,5 +1,6 @@
 - **normal mode:** Generates a `.rsdoctor` folder in the build output directory, which contains various data files and displays code in the report page. The output directory can be configured via [reportDir](/config/options/options#reportdir).
 
-- **brief mode:** Generates an HTML report file in the `.rsdoctor` folder within the build output directory. All build analysis data will be consolidated into this HTML file, which can be viewed by opening it in a browser. Brief mode also has additional configuration options, detailed at: [brief](/config/options/options#brief).
+- **brief mode:** Generates an HTML report file in the `.rsdoctor` folder within the build output directory. All build analysis data will be consolidated and injected into this HTML file, which can be viewed by opening it in a browser. Brief mode also has additional configuration options, detailed at: [brief](/config/options/options#brief).
 
 - **lite mode:** Based on the normal mode, this mode does not display source code and product code, only showing the information of the bundled code.
+  - lite mode will be deprecated in V2, refer to [lite mode deprecation notice](/config/options/options-v2#lite).

package/docs/public/netlify.toml

@@ -5,6 +5,18 @@ to = "https://rsdoctor.rs/:splat"
 status = 301
 force = true
 
+[[redirects]]
+from = "/preview/#/"
+to = "https://rsdoctor.rs"
+status = 302
+force = true
+
+[[redirects]]
+from = "/zh/preview/#/"
+to = "https://rsdoctor.rs"
+status = 302
+force = true
+
 [[redirects]]
 from = "/*"
 to = "/404.html"

package/docs/zh/{_meta.json → _nav.json}

@@ -13,5 +13,10 @@
     "text": "博客",
     "link": "/blog/release/release-note-1_2",
     "activeMatch": "/blog/"
+  },
+  {
+    "text": "Playground",
+    "link": "https://rsdoctor.rs/preview/#/resources/uploader",
+    "activeMatch": "/preview/"
   }
 ]

package/docs/zh/blog/release/release-note-1_0.mdx

@@ -46,7 +46,7 @@ Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可
 
 我们为 Rsdoctor 设计了直观的用户界面，将构建数据可视化。同时，Rsdoctor 在结合多种工具的基础上，额外扩展了 loader 分析能力以更深入 loader 的编译行为，内置了产物及编译的扫描和检测规则，并支持用户自定义规则。
 
-Rsdoctor 不仅支持 Rspack 和 webpack，也支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://lib.rsbuild.rs/) 等。
+Rsdoctor 不仅支持 Rspack 和 webpack，也支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://rslib.rs/) 等。
 
 Rsdoctor 可以被用于：
 

package/docs/zh/config/options/_meta.json

@@ -1 +1,13 @@
-["options", "term"]
+[
+  "options",
+  "term",
+  "disableClientServer",
+  "experiments",
+  "features",
+  "output",
+  "port",
+  "supports",
+  "brief",
+  "mode",
+  "options-v2"
+]

package/docs/zh/config/options/brief.mdx

@@ -0,0 +1,35 @@
+# brief
+
+import { Badge } from '@theme';
+
+:::warning
+V2 中即将废弃，请使用 [output.mode: 'brief'](/config/options/output#mode) 代替。参考 [brief 配置迁移](/config/options/options-v2#brief)。
+:::
+
+- **类型：** [BriefType](#brieftype)
+- **可选：** `true`
+- **默认值：** `undefined`
+
+Brief 模式的详细配置选项如下：
+
+- **reportHtmlName:** 配置 Brief 模式下 HTML 报告的文件名称，默认值为 `report-rsdoctor.html`。
+- **writeDataJson:** (已废弃，请使用 `output.options.type: ['json', 'html']`, 参考 [output.options.type](/config/options/options-v2#options)。)默认情况下，Brief 模式会将分析数据直接注入到 HTML 文件中，因此不会额外生成构建分析数据文件。如果需要额外在本地生成 JSON 数据文件，则需要配置 `writeDataJson: true`。
+
+## briefType
+
+```ts
+interface BriefConfig {
+  reportHtmlName?: string | undefined;
+  writeDataJson: boolean;
+}
+```
+
+- **示例：**
+
+```js
+new RsdoctorRspackPlugin({
+  output: {
+    mode: 'brief',
+  },
+});
+```

package/docs/zh/config/options/disableClientServer.mdx

@@ -0,0 +1,11 @@
+# disableClientServer
+
+- **类型：** `boolean`
+- **可选：** `true`
+- **默认值：** `false`，当 `process.CI` 为 true 时，默认值为 true，即在 CI 环境中默认不启动报告服务。
+
+:::tip
+建议在 CI 环境下将 disableClientServer 设置为 true，否则启动的服务会卡住 pipeline 流程。
+:::
+
+是否需要自动打开 Rsdoctor 报告页面。如果你不需要在浏览器内查看本次 Rsdoctor 提供的分析报告，则可以开启这个配置项。

package/docs/zh/config/options/experiments.mdx

@@ -0,0 +1,21 @@
+import { Badge } from '@theme';
+
+# experiments
+
+<Badge text="Version: 1.0.0" type="warning" />
+
+## enableNativePlugin
+
+- **类型：** `boolean`
+- **可选：** `true`
+- **默认值：** `false`
+
+通过 enableNativePlugin 选项开启 Rspack 原生插件，将 Rsdoctor 中耗时较大的数据处理逻辑前置到 Rspack 构建阶段，从而显著提升构建分析效率并大幅降低 Rsdoctor 自身的分析耗时。
+
+- **示例：**
+
+```js
+new RsdoctorRspackPlugin({
+  experiments: { enableNativePlugin: true }
+}),
+```