# Rsdoctor > A one-stop build analyzer for Rspack projects. ## 指南 - [介绍](/zh/guide/start/intro.md): 了解 Rsdoctor 如何分析 Rspack 构建，包括 loader、插件、模块解析、产物体积和构建差异。 - [快速开始](/zh/guide/start/quick-start.md): 在 Rspack 2.0 或更高版本的项目中安装和配置 Rsdoctor 2.0，包括 Rsbuild 和 Rslib 集成。 - [功能导航](/zh/guide/start/features.md): 浏览 Rsdoctor 分析功能，包括构建概览、编译性能和产物分析等。 - [CI/CD 使用教程](/zh/guide/start/cicd.md): 使用 brief 模式生成独立的 Rsdoctor 报告，作为 CI 产物保存或部署到 CDN。 - [GitHub Actions 集成](/zh/guide/start/action.md): 使用 rsdoctor-action 在 CI/CD 流程中集成 Rsdoctor 分析 - [CLI 使用教程](/zh/guide/start/cli.md): 使用 @rsdoctor/cli 打开分析报告、通过 bundle-diff 对比构建结果，并调用 Node API。 - [AI](/zh/guide/start/ai.md): 通过 Rsdoctor Agent Skills、agent-cli、llms.txt 和 Markdown 文档进行 AI 辅助构建分析。 - [Playground](/zh/guide/start/playground.md): 将 Rsdoctor 报告或 Webpack/Rspack Stats 数据上传到在线 playground，无需本地安装即可分析构建。 - [项目概览](/zh/guide/usage/project-overall.md): 在 Rsdoctor Project Overall 中查看项目配置、依赖版本以及构建错误和警告。 - [产物概览](/zh/guide/usage/bundle-overall.md): 查看 Rsdoctor 的 Bundle Overall 概览，了解构建产物、体积指标和重复依赖包。 - [编译概览](/zh/guide/usage/compile-overall.md): 通过 Rsdoctor 的 Compile Overall 视图查看初始化、编译和压缩等阶段的耗时。 - [编译预警](/zh/guide/usage/compile-alerts.md): 查看 Rsdoctor 编译告警，以及根据编译数据检测问题的规则。 - [产物预警](/zh/guide/usage/bundle-alerts.md): 查看 Rsdoctor 产物告警，并通过关联的诊断规则排查构建产物问题。 - [Loaders 时序图](/zh/guide/usage/loaders-timeline.md): 查看 Rsdoctor loader 时间线，对比 loader 总体耗时和单次调用情况。 - [Loaders 分析](/zh/guide/usage/loaders-analysis.md): 在 Rsdoctor Loader Analysis 中按目录和文件查看 loader 执行及源码转换情况。 - [Plugin 分析](/zh/guide/usage/plugins-analysis.md): 在 Rsdoctor Plugin Analysis 中查看 Rspack compiler 和 compilation 钩子的调用及插件耗时。 - [产物分析](/zh/guide/usage/bundle-size.md): 通过树状矩形图、模块关系、重复依赖和模块详情分析 Rsdoctor 产物体积。 - [Module 引用链分析](/zh/guide/usage/module-analysis.md): 通过 Rsdoctor 追踪模块被包含在产物中的原因，并检查引用链和 tree shaking 失效原因。 - [Resolver 分析](/zh/guide/usage/resolver.md): 在 Rsdoctor 中启用 resolver 功能，查看模块解析路径和解析详情。 - [编译诊断规则](/zh/guide/usage/rule-config.md): 启用 Rsdoctor 内置及自定义构建诊断规则，并在 CLI 和报告界面查看诊断结果。 - [Bundle diff](/zh/guide/usage/bundle-diff.md): 对比 Rsdoctor 报告，检查资源、模块和包的变化，并将产物差异导出为 HTML 或 JSON。 - [内置规则](/zh/guide/rules/rules.md): 配置 Rsdoctor 内置诊断规则，包括重复依赖、loader 性能和 tree shaking 等检查。 - [自定义扩展规则](/zh/guide/rules/rule-custom.md): 使用 defineRule 编写自定义 Rsdoctor 诊断规则、上报问题，并配置结果在报告中的展示。 - [数据上报](/zh/guide/rules/upload-data.md): 通过自定义规则的 check 函数收集和上传 Rsdoctor 构建分析数据。 - [迁移到 Rsdoctor 2.0](/zh/guide/migration/migration-v2.md): 通过更新 Rspack 版本、依赖包、导入、CLI 命令、AI 工作流和配置迁移到 Rsdoctor 2.0。 - [FAQ](/zh/guide/more/faq.md): 排查 Rsdoctor 常见问题，如 loader 耗时不准确、内存限制和产物体积缺失等。 - [Rule index](/zh/guide/more/rules.md): 在规则索引中浏览 Rsdoctor 诊断规则及其元数据。 - [MCP server](/zh/guide/usage/mcp.md): 在 Rsdoctor 2.x 中使用 @rsdoctor/agent-cli 替代已移除的 @rsdoctor/mcp-server，或查阅 v1 文档。 ## 配置 - [总览](/zh/config/options/options.md): 参考 RsdoctorRspackPluginOptions 配置 @rsdoctor/core 导出的 RsdoctorRspackPlugin。 - [术语](/zh/config/options/term.md): 了解 Rsdoctor 常用术语，包括 manifest.json 报告、asset、chunk 和 module 等。 - [disableClientServer](/zh/config/options/disableClientServer.md): 通过 disableClientServer 控制 Rsdoctor 是否启动报告服务，包括 CI 环境中的使用方式。 - [features](/zh/config/options/features.md): 通过 features 选项选择 Rsdoctor 功能，包括 loader、插件、产物、模块解析和 tree-shaking 分析等。 - [output](/zh/config/options/output.md): 配置 Rsdoctor 报告输出，包括报告模式、文件格式、代码内容和输出目录等。 - [server](/zh/config/options/server.md): 配置 Rsdoctor 报告服务，包括端口和跨源访问等设置。 - [supports](/zh/config/options/supports.md): 通过 supports 配置 Rsdoctor 的详细分析行为，如产物解析和压缩体积计算等。 - [multiCompiler](/zh/config/options/multiCompiler.md): 通过 multiCompiler 配置多个 Rspack compiler 的 Rsdoctor 报告分组，并选择各 compiler 的结果。 - [experiments](/zh/config/options/experiments.md): 升级到 Rsdoctor 2.0 时移除 experiments.enableNativePlugin，该版本始终使用 Rspack 原生插件。 - [mode](/zh/config/options/mode.md): 在 Rsdoctor 2.x 中将已移除的顶层 mode 选项迁移到 output.mode 和 output.reportCodeType。 ## 博客 - [Rsdoctor 博客](/zh/blog/index.md): Rsdoctor 版本发布动态，以及构建分析与优化的实践指南。 - [Rsdoctor 2.0 发布公告](/zh/blog/release/release-note-2_0.md): 我们很高兴地宣布 Rsdoctor 2.0 正式发布！🎉 Rsdoctor 是专为 Rspack 打造的构建分析工具，既能通过可视化报告帮助开发者排查问题，也能为 agent 提供数据，实现自动化诊断与优化。 本次更新的主要亮点包括： 面向 agent 的构建分析：同一份分析数据，既支持开发者可视化排查，也支持 agent 自动化分析更小的安装体积：安装体积减少 56%，依赖数量减少 78%更快的分析速度：构建分析耗时减少 57%更快的增量构建：减少重构建过程中的分析开销，HMR 耗时降低约 47%改进多 compiler 支持：在同一份报告中查看多个 compiler 的分析结果 - [Rsdoctor 1.2 发布公告](/zh/blog/release/release-note-1_2.md): Rsdoctor 1.2 版本已经发布啦 🎉 深入 concatenate module 分析：新增对 concatenate module（聚合模块）体积的分析能力，帮助开发者更精确地识别 Tree Shaking 后的实际打包体积。Bundle 体积分析支持 Gzip：Bundle 体积分析新增对 gzip 压缩体积的展示，让开发者能方便了解产物上线后的真实体积表现。Treemap 可视化增强：新增并优化了 Treemap（矩形树图）功能，帮助开发者以更直观方式洞察 bundle 组成和资源分布。Rsdoctor MCP Rsdoctor MCP 是一个借助 LLM 的构建分析工具，通过问答形式帮助开发者快速获取构建分析结果。 - [Rsdoctor 1.0 发布公告](/zh/blog/release/release-note-1_0.md): 我们很高兴地宣布 Rsdoctor 1.0 已经正式发布！ 在经过一年的迭代与验证后，我们正式推出 Rsdoctor 1.0 —— 一款为 Rspack 生态量身打造的构建分析工具，同时也完全兼容 webpack 生态。 Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可视化与智能分析，使整个构建流程变得透明、可预测和可优化，从而帮助开发团队精准定位瓶颈、优化性能并提升工程质量。