@rsdoctor/docs 1.1.3 → 1.1.5

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

@@ -295,18 +295,11 @@ type ISupport = {
 
 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
+#### ~~generateTileGraph [**Deprecated**]~~
 
-- default: true. The default value in rspack is false.
-- type: boolean.
-
-Whether to enable the ability to generate tile graphs, which affects whether the Bundle Size page has a tile graph from `webpack-bundle-analyzer`.
+<Badge text="Deprecated" type="warning" />
 
-<img
-  src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-tile-graph.png"
-  width="500px"
-  style={{ margin: 'auto' }}
-/>
+Rsdoctor supports generating Tree Map graphs by default, so this option does not need to be configured.
 
 #### parseBundle
 

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

@@ -61,6 +61,56 @@ module.exports = {
 - Cause: During the build process, the source code information is stored, which exceeds the memory limit. Enabling the `lite` mode can alleviate this issue.
 - Difference: The difference between the **lite mode** and the **normal mode** is that the **lite mode** no longer stores the **source code information**, only the **bundled code** is stored. Additionally, the code displayed in the analysis report will only consist of the **bundled code**.
 
+## Bundle analysis page no `Bundled Size`?
+
+### Issue Description
+
+The difference between `Source Size` and `Bundled Size`:
+
+- **Source Size**: The original size of the Module source code file (marked in purple in the image below).
+- **Bundled Size**: The final code size of the Module after bundling and minification (marked in cyan in the image below).
+
+<img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-overall.png" />
+
+### Root Cause
+
+When [optimization.concatenateModules](https://rspack.rs/config/optimization#optimizationconcatenatemodules) is set to `true`, Rsdoctor cannot use `acorn` to parse the build artifacts and break down the actual code size of each **Module**, therefore it cannot display the `Bundled Size`.
+
+### Solution
+
+:::danger
+**Important Note:** You must check the `RSDOCTOR` environment variable and not modify ConcatenateModules directly! ConcatenateModules is enabled by default in production environments, and disabling it in production builds will increase the bundle size.
+:::
+
+When enabling Rsdoctor analysis, set **concatenateModules to false** as shown below. **Note: Disabling `concatenateModules` will slightly increase bundle size, creating differences from production builds.**
+
+```js rspack.config.mjs
+export default {
+  optimization: {
+    concatenateModules:
+      process.env.NODE_ENV === 'production' && !process.env.RSDOCTOR, // Must check RSDOCTOR environment variable, do not modify concatenateModules directly!
+  },
+};
+```
+
+- 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
+          }
+      },
+    },
+  };
+```
+
 ## The loader of CssExtractRspackPlugin takes too long
 
 When using Rsdoctor to analyze the compilation time of Rspack projects, you may find that the loader of [CssExtractRspackPlugin](https://rspack.rs/plugins/rspack/css-extract-rspack-plugin) takes a long time. However, this figure does not represent the actual time taken by the CssExtractRspackPlugin's loader; it also includes the time taken by other loaders involved in compiling this module.

package/docs/en/guide/start/_meta.json

@@ -1 +1 @@
-["intro", "quick-start", "features", "cicd", "cli"]
+["intro", "quick-start", "features", "cicd", "cli", "mcp"]

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

@@ -0,0 +1,239 @@
+# MCP Server
+
+## Introduction
+
+@rsdoctor/mcp-server is an MCP Server tool designed to help users more conveniently utilize Rsdoctor's build data. It works with Rsdoctor's local build analysis data and helps you quickly obtain build analysis results through a Q&A interface.
+
+## Core features
+
+**@rsdoctor/mcp-server** provides four core analysis capabilities:
+
+- **Bundle Analysis**: Analyzes bundle size, composition and other information
+- **Dependency Analysis**: Analyzes project dependencies and duplicate dependency issues
+- **Bundle Optimization Suggestions**: Provides suggestions for bundle size optimization and code splitting
+- **Compilation Optimization Suggestions**: Analyzes compilation time and provides compilation performance optimization suggestions
+
+## Usage examples
+
+### 1. Bundle optimization analysis
+
+By asking "Please help me to optimize the bundle or artifacts", the tool will analyze the build output and provide optimization suggestions.
+
+Example video:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/mcp-bundle-optimize-2.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+### 2. Dependency analysis
+
+By asking "Please investigate the referrer dependency of node_modules/dayjs/index.js", the tool will analyze the dependency relationships of the specified module.
+
+Example video:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/issuer-path.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+### 3. Compilation performance analysis
+
+By asking "Please help me find files or loaders with high compilation time and provide optimization suggestions", the tool will analyze compilation time and provide optimization suggestions.
+
+Example video:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/loader-mcp.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+## Quick start
+
+### 💡 Version requirements
+
+:::warning
+The following Rsdoctor plugin versions are required:
+
+- @rsdoctor/rspack-plugin >= 1.1.2
+- @rsdoctor/webpack-plugin >= 1.1.2
+
+Note: Please ensure you are using the latest version for the best experience.
+:::
+
+### 1. Plugin configuration
+
+If you haven't added the Rsdoctor plugin yet, you need to configure it in your project. [👉🏻 Quick Start](https://rsdoctor.rs/guide/start/quick-start).
+
+### 2. Enable Rsdoctor and run local build
+
+Enable Rsdoctor and run the build. **Do not use MCP Client to start the project, as Rsdoctor's local service will block the MCP Client's dialogue process**.
+
+```bash
+# Enable Rsdoctor
+
+RSDOCTOR=true npm run build
+```
+
+- Note: If `disableClientServer: true` is configured, it needs to be modified to `disableClientServer: false`, and `disableClientServer` defaults to false.
+
+### 3. Start MCP Server
+
+#### Cursor
+
+1. Create a `.cursor/mcp.json` file in the project root directory:
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+2. Restart the Cursor editor
+3. Start interaction in the MCP panel
+
+#### Claude
+
+Add configuration in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Cline
+
+Add configuration in the configuration file:
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+## Configuration instructions
+
+### Command line parameters
+
+| Parameter  | Description                                 | Default                                                       | Example          |
+| ---------- | ------------------------------------------- | ------------------------------------------------------------- | ---------------- |
+| `compiler` | Specify the name of the compiler to analyze | Automatically detected                                        | `--compiler web` |
+| `port`     | Specify the MCP Server port                 | Latest port number (written to ` ~/.cache/rsdoctor/mcp.json`) | `--port 1000`    |
+
+### Multi-compiler project configuration
+
+In a multi-compiler project, each compiler will have a separate Rsdoctor build analysis data. Use the `--compiler` parameter to specify the compiler to analyze:
+
+```bash
+npx @rsdoctor/mcp-server@latest --compiler web
+```
+
+### Port configuration
+
+1. Configure the MCP Server port:
+
+```bash
+npx @rsdoctor/mcp-server@latest --port 1000
+```
+
+2. Configure the Rsdoctor local service port:
+
+```js
+new RsdoctorRspackPlugin({
+  port: 9988,
+});
+```
+
+## Tools list
+
+### Product analysis tool
+
+| Tool                     | Description                                 | Parameters       |
+| ------------------------ | ------------------------------------------- | ---------------- |
+| `get_chunks`             | Get all code block information              | -                |
+| `get_chunk_by_id`        | Get specific code block information         | chunkId (Number) |
+| `get_large_chunks`       | Get code blocks with large volume           | -                |
+| `get_media_asset_prompt` | Get media resource optimization suggestions | -                |
+
+### Dependency analysis tool
+
+| Tool                       | Description                | Parameters          |
+| -------------------------- | -------------------------- | ------------------- |
+| `get_modules`              | Get all module information | -                   |
+| `get_module_by_id`         | Get module information     | moduleId (Number)   |
+| `get_module_by_path`       | Get module by path         | modulePath (String) |
+| `get_module_issuer_path`   | Get module source path     | moduleId (String)   |
+| `get_package_info`         | Get package information    | -                   |
+| `get_package_dependencies` | Get dependency list        | -                   |
+| `get_duplicate_packages`   | Get duplicate package list | -                   |
+| `get_similar_packages`     | Get similar package list   | -                   |
+
+### Performance analysis tool
+
+| Tool                        | Description                           | Parameters |
+| --------------------------- | ------------------------------------- | ---------- |
+| `get_loader_time_all_files` | Get file loader time                  | -          |
+| `get_loader_times`          | Get compilation directory loader time | -          |
+| `get_rule_info`             | Get build rule scan results           | -          |
+
+## Q&A
+
+### 1. Connection issues
+
+**Issue**: Unable to connect to Rsdoctor MCP Server or no data returned successfully
+
+**Solution**:
+
+- Ensure the Rsdoctor local Server has been successfully started.
+  - Manually start the local Server, do not use MCP Client to start the project, as the local service of Rsdoctor will block the dialogue process of MCP Client.
+- If the Rsdoctor MCP server uses the `--port` parameter, please ensure the Rsdoctor startup port configuration is correct.
+- Check if the Rsdoctor plugin version meets the requirements. [Version requirements](/guide/start/mcp#-version-requirements)

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

@@ -19,8 +19,8 @@ Click on the **"Bundle Size"** option in the navigation bar to view the Bundle a
 
 - **`Assets`**: Resources refer to images, fonts, media, and other file types. They are the files that ultimately exist in the output folder. Each Chunk has corresponding [Assets resources](https://webpack.js.org/concepts/under-the-hood/#chunks).
 - **`Module`**: One or more Modules combine to form a Chunk. For more information about Module types, please refer to [Rspack Modules](https://www.rspack.rs/api/modules.html) and [Webpack Modules](https://webpack.js.org/concepts/modules/#what-is-a-webpack-module).
-- **`Bundle Size`**: The final packaged size of the resource artifact, which is the final size after being processed by the bundler.
-- **`Module Bundled Source & Size`**: **Module Parsed Source** refers to the final code fragment of the **Module** in the packaged artifact, and **Module Parsed Size** refers to the size of the final code fragment of the **Module** in the packaged artifact.
+- **`Source Size`**: The original size of the file, before any transformations and minification.
+- **`Bundle Size`**: The final output size of the files. If you enabled minification, this value shows the minified size.
 - **`Package Count`**: The number of third-party packages.
 - **`Initial Chunk`**: The **initial** chunk is the main chunk of the entry point. This chunk contains all the modules specified by the entry point and their dependencies, unlike the **chunks** for "on-demand loading".
   - For more information about Initial Chunk, please refer to [Initial Chunk Introduction](https://webpack.js.org/concepts/under-the-hood/#chunks).
@@ -128,12 +128,20 @@ The **Modules** tag is shown in the right image, from left to right representing
 - **Module Explorer** tag: Click to open the dependency analysis page between `Modules`.
 - **Code View** tag: Click to expand code segments, including `Source` (source code), `Transformed` (compiled code), and `Bundled` (bundled code).
 
-## Bundle overview tile graph
+## Bundle tile graph
 
-Click the **"Bundle Analyzer Graph"** button on the **"Bundle Size"** page to view the classic tile graph.
+Click the **"Tile Graph"** label on the **"Bundle Size"** page to view the tile graph. The tile graph clearly shows the proportion and relationship between resources and modules, as shown in the following image:
 
 <img
-  src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-tile-graph.png"
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/usage/bundle/treemap.png"
+  width="500px"
+  style={{ margin: 'auto' }}
+/>
+
+You can also click the 🔍 button on the card title to search for Module resources, click the Module resource, and zoom in to the Module area, as shown in the following image:
+
+<img
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/usage/bundle/treemap.gif"
   width="500px"
   style={{ margin: 'auto' }}
 />

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

@@ -294,18 +294,12 @@ type ISupport = {
 
 如果开启 `supports.banner` 则会开启 Rsdoctor 对 BannerPlugin 的兼容逻辑。详细请看：[支持 BannerPlugin](../../guide/usage/bundle-size#%E6%94%AF%E6%8C%81-bannerplugin)
 
-#### generateTileGraph
+#### ~~generateTileGraph [**Deprecated**]~~
 
-- **默认值：** 使用 Rspack 时默认值是 `false`，否则为 `true`
-- **类型：** `boolean`
+<Badge text="Deprecated" type="warning" />
 
-是否开启生成瓦片图的能力，影响是 Bundle Size 页面中是否有 `webpack-bundle-analyzer` 的瓦片图。
+Rsdoctor 默认支持生成 Tree Map 图，所以不需要配置此选项。
 
-<img
-  src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-tile-graph.png"
-  width="500px"
-  style={{ margin: 'auto' }}
-/>
 #### parseBundle
 
 - **类型：** `boolean`

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

@@ -59,6 +59,56 @@ module.exports = {
 - 原因：因为构建过程中，存储了源码信息，超过了内存，所以开启 `lite` 模式可以缓解。
 - 区别：`lite` 模式和普通模式的区别就是不再存储**源码信息**，只存储**打包后的代码**，同时分析报告上的代码也将**只有打包后的代码**。
 
+## 产物分析界面没有 `Bundled Size` 怎么办？
+
+### 问题说明
+
+`Source Size` 和 `Bundled Size` 的区别：
+
+- **Source Size**：Module 文件源码的原始大小（如下图紫色标识）。
+- **Bundled Size**：经过打包及压缩后的 Module 的最终代码大小（如下图青色标识）。
+
+<img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-overall.png" />
+
+### 原因分析
+
+当 [optimization.concatenateModules](https://rspack.rs/zh/config/optimization#optimizationconcatenatemodules) 配置为 `true` 时，Rsdoctor 无法通过 `acorn` 解析产物来分解出每个 **Module** 的实际代码大小，因此无法显示 `Bundled Size`。
+
+### 解决方案
+
+:::danger
+**重要提醒：** 必须判断 `RSDOCTOR` 环境变量，不能直接修改 ConcatenateModules！线上环境默认开启 ConcatenateModules，线上构建环境中关闭会导致产物体积变大。
+:::
+
+**在开启 Rsdoctor 分析时，配置 concatenateModules 为 false**，如下所示。**同时要注意，关闭 concatenateModules 一定会导致产物体积略微变大，与线上环境的体积有一些差异。**
+
+```js rspack.config.mjs
+export default {
+  optimization: {
+    concatenateModules:
+      process.env.NODE_ENV === 'production' && !process.env.RSDOCTOR, // 需要判断 RSDOCTOR 环境变量，不可以直接修改 concatenateModules！
+  },
+};
+```
+
+- rspeedy 项目中，在 `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
+          }
+      },
+    },
+  };
+```
+
 ## CssExtractRspackPlugin 的 loader 耗时过长问题
 
 在使用 Rsdoctor 对 Rspack 项目进行编译耗时分析时，可能会发现 [CssExtractRspackPlugin](https://rspack.rs/plugins/rspack/css-extract-rspack-plugin) 的 loader 耗时较长。然而，这个数值并不代表 CssExtractRspackPlugin 的 loader 的真实耗时，它还包含了对本模块编译的其他 loader 的耗时。

package/docs/zh/guide/start/_meta.json

@@ -1 +1 @@
-["intro", "quick-start", "features", "cicd", "cli"]
+["intro", "quick-start", "features", "cicd", "cli", "mcp"]

package/docs/zh/guide/start/mcp.mdx

@@ -0,0 +1,239 @@
+# MCP Server
+
+## 介绍
+
+@rsdoctor/mcp-server 是一个 MCP Server，旨在帮助用户更便捷地使用 Rsdoctor 的构建数据。它可以与 Rsdoctor 的本地构建分析数据配合使用，通过问答的形式，帮助你快速获取构建分析结果。
+
+## 主要功能
+
+**@rsdoctor/mcp-server** 提供四大类核心分析能力：
+
+- **产物信息分析**: 分析构建产物的体积、组成等信息
+- **依赖问题分析**: 分析项目依赖关系、重复依赖等问题
+- **产物优化建议**: 提供产物体积优化、代码分割等建议
+- **编译优化建议**: 分析编译耗时，提供编译性能优化建议
+
+## 使用示例
+
+### 1. 产物优化分析
+
+通过提问 "Please help me to optimize the bundle or artifacts"，工具会分析构建产物并给出优化建议。
+
+示例视频:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/mcp-bundle-optimize-2.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+### 2. 依赖分析
+
+通过提问 "Please investigate the referrer dependency of node_modules/dayjs/index.js"，工具会分析指定模块的依赖关系。
+
+示例视频:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/issuer-path.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+### 3. 编译性能分析
+
+通过提问 "Please help me find files or loaders with high compilation time and provide optimization suggestions"，工具会分析编译耗时并给出优化建议。
+
+示例视频:
+
+<video
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/loader-mcp.mp4"
+  style={{
+    width: '100%',
+    height: 'auto',
+    maxHeight: '50vh',
+    objectFit: 'cover',
+    display: 'block',
+  }}
+  autoPlay={true}
+  muted={true}
+  controls={true}
+  loop={true}
+  playsInline
+/>
+
+## 快速开始
+
+### 💡 版本要求
+
+:::warning
+需要使用以下 rsdoctor 插件（版本要求）：
+
+- @rsdoctor/rspack-plugin >= 1.1.2
+- @rsdoctor/webpack-plugin >= 1.1.2
+
+注意：请确保使用最新版本以获得最佳体验。
+:::
+
+### 1. 插件配置
+
+如果还没有添加 Rsdoctor 插件，那么需要在项目中配置，[👉🏻 快速开始](https://rsdoctor.rs/guide/start/quick-start)。
+
+### 2. 开启 Rsdoctor 并执行本地构建
+
+开启 Rsdoctor 的情况下，执行构建。**不要使用 MCP Client 启动项目，因为 Rsdoctor 挂载的本地服务会卡住 MCP Client 的对话进程**。
+
+```bash
+# 开启 Rsdoctor
+
+RSDOCTOR=true npm run build
+```
+
+- 注：如果配置了 `disableClientServer: true`，需要修改为 `disableClientServer: false`，disableClientServer 默认是 false。
+
+### 3. 启动 MCP Server
+
+#### Cursor
+
+1. 在项目根目录创建 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+2. 重启 Cursor 编辑器
+3. 在 MCP 面板中开始交互
+
+#### Claude
+
+在 `claude_desktop_config.json` 中添加配置：
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Cline
+
+在配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "rsdoctor": {
+      "command": "npx",
+      "args": ["-y", "@rsdoctor/mcp-server@latest"]
+    }
+  }
+}
+```
+
+## 配置说明
+
+### 命令行参数
+
+| 参数       | 说明                   | 默认值                                                      | 示例             |
+| ---------- | ---------------------- | ----------------------------------------------------------- | ---------------- |
+| `compiler` | 指定要分析的编译器名称 | 自动检测                                                    | `--compiler web` |
+| `port`     | 指定 MCP Server 端口   | 最新启动的端口号（写入到 ` ~/.cache/rsdoctor/mcp.json` 中） | `--port 1000`    |
+
+### 多编译器项目配置
+
+在多编译器项目中，每个编译器会有一份 Rsdoctor 构建分析数据。使用 `--compiler` 参数指定要分析的编译器：
+
+```bash
+npx @rsdoctor/mcp-server@latest --compiler web
+```
+
+### 端口配置
+
+1. 配置 MCP Server 端口：
+
+```bash
+npx @rsdoctor/mcp-server@latest --port 1000
+```
+
+2. 配置 Rsdoctor 本地服务端口：
+
+```js
+new RsdoctorRspackPlugin({
+  port: 9988,
+});
+```
+
+## Tools 介绍
+
+### 产物分析工具
+
+| 工具                     | 说明                 | 参数             |
+| ------------------------ | -------------------- | ---------------- |
+| `get_chunks`             | 获取所有代码块信息   | -                |
+| `get_chunk_by_id`        | 获取特定代码块信息   | chunkId (Number) |
+| `get_large_chunks`       | 获取体积过大的代码块 | -                |
+| `get_media_asset_prompt` | 获取媒体资源优化建议 | -                |
+
+### 依赖分析工具
+
+| 工具                       | 说明             | 参数                |
+| -------------------------- | ---------------- | ------------------- |
+| `get_modules`              | 获取所有模块信息 | -                   |
+| `get_module_by_id`         | 获取模块信息     | moduleId (Number)   |
+| `get_module_by_path`       | 根据路径获取模块 | modulePath (String) |
+| `get_module_issuer_path`   | 获取模块来源路径 | moduleId (String)   |
+| `get_package_info`         | 获取包信息       | -                   |
+| `get_package_dependencies` | 获取依赖列表     | -                   |
+| `get_duplicate_packages`   | 获取重复包列表   | -                   |
+| `get_similar_packages`     | 获取相似包列表   | -                   |
+
+### 性能分析工具
+
+| 工具                        | 说明                     | 参数 |
+| --------------------------- | ------------------------ | ---- |
+| `get_loader_time_all_files` | 获取文件 loader 耗时     | -    |
+| `get_loader_times`          | 获取编译目录 loader 耗时 | -    |
+| `get_rule_info`             | 获取构建规则扫描结果     | -    |
+
+## 常见问题
+
+### 1. 连接问题
+
+**问题**: 无法连接到 Rsdoctor MCP Server 或没有成功返回数据
+
+**解决方案**:
+
+- 确保 Rsdoctor 本地 Server 已成功启动。
+  - 手动启动本地 Server，请勿使用 MCP Client 启动项目，因为 Rsdoctor 的挂载的本地服务会卡住 MCP Client 的对话进程。
+- 如果 Rsdoctor MCP server 使用了 `--port` 参数，请确保 Rsdoctor 的启动端口配置正确。
+- 检查 Rsdoctor 插件版本是否符合要求。[版本要求](/guide/start/mcp#-%E7%89%88%E6%9C%AC%E8%A6%81%E6%B1%82)

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

@@ -19,8 +19,8 @@
 
 - **`Assets`**：资源是对图像、字体、媒体和其他文件类型的统称，是最终存在于输出文件夹内的文件，同时，每个 Chunk 都有对应的 [Assets 资源](https://webpack.js.org/concepts/under-the-hood/#chunks)。
 - **`Module`**：一个或多个 Module 组合成了 Chunk。有关 Module 类型的详细信息，请参阅 [Rspack Modules](https://www.rspack.rs/api/modules.html) 和 [Webpack Modules](https://webpack.js.org/concepts/modules/#what-is-a-webpack-module)。
-- **`Bundle Size`**：资源产物的最终打包大小，这是打包工具处理后的最终大小。
-- **`Module Bundled Source & Size`**：**Module Parsed Source** 是指 **Module** 在打包产物中的最终代码片段，**Module Parsed Size** 是指 **Module** 在打包产物中的最终代码片段的大小。
+- **`Source Size`**：文件的原始大小，未经过任何转换和压缩。
+- **`Bundle Size`**：文件最终输出的大小。如果开启了压缩，这个值代表压缩后的大小。
 - **`Package Count`**：第三方包的数量。
 - **`Initial Chunk`**: **initial(初始化)** 是入口起点的主 Chunk，该 chunk 包含入口起点指定的所有模块及其依赖项，与「**按需加载**」的 **Chunk** 资源不同。
   - 有关 Initial Chunk 的详细信息，请参阅 [Initial Chunk 介绍](https://webpack.js.org/concepts/under-the-hood/#chunks)。
@@ -121,10 +121,18 @@
 
 ## 产物总览瓦片图
 
-点击 **「Bundle Size」** 页面的 **「Bundle Analyzer Graph」** 按钮，可以查看经典的瓦片图。
+点击 **「Bundle Size」** 页面的 **「Tile Graph」** 标签，可以查看瓦片图。通过瓦片图可以清晰的看到各个资源和模块之间的占比和关系，如下图所示：
 
 <img
-  src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-size-tile-graph.png"
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/usage/bundle/treemap.png"
+  width="500px"
+  style={{ margin: 'auto' }}
+/>
+
+同时可以点击卡片标题侧的 🔍 按钮，搜索 Module 资源，点击 Module 资源，可以放大到该 Module 区域，如下图所示：
+
+<img
+  src="https://lf3-static.bytednsdoc.com/obj/eden-cn/lognuvj/rsdoctor/docs/usage/bundle/treemap.gif"
   width="500px"
   style={{ margin: 'auto' }}
 />

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdoctor/docs",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/rsdoctor",
@@ -20,22 +20,22 @@
   },
   "devDependencies": {
     "@rspress/plugin-rss": "2.0.0-beta.6",
-    "@rspress/plugin-llms": "2.0.0-beta.7",
-    "@rspress/plugin-algolia": "2.0.0-beta.7",
+    "@rspress/plugin-llms": "2.0.0-beta.16",
+    "@rspress/plugin-algolia": "2.0.0-beta.16",
     "@types/node": "^22.8.1",
-    "@types/react": "^18.3.22",
+    "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "rsbuild-plugin-google-analytics": "^1.0.3",
     "rsbuild-plugin-open-graph": "^1.0.2",
     "rspress-plugin-font-open-sans": "^1.0.0",
-    "rspress-plugin-sitemap": "^1.1.2",
+    "rspress-plugin-sitemap": "^1.1.4",
     "typescript": "^5.2.2",
-    "@rsdoctor/types": "1.1.3"
+    "@rsdoctor/types": "1.1.5"
   },
   "dependencies": {
-    "@rstack-dev/doc-ui": "1.10.5",
+    "@rstack-dev/doc-ui": "1.10.6",
     "react-markdown": "^9.1.0",
     "rspress": "2.0.0-beta.6"
   },