Rsdoctor 2.0 发布:Agent 驱动的全自动优化工具

Rsdoctor 2.0 发布,支持 Agent 驱动的构建分析,安装体积减少 56%,分析速度提升 57%,并优化了增量构建与多 compiler 支持。

Rsdoctor 2.0 发布横幅
Rsdoctor 2.0 发布横幅

我们很高兴地宣布 Rsdoctor 2.0 正式发布!🎉

Rsdoctor 是专为 Rspack 打造的构建分析工具,既能帮助开发者可视化排查构建问题,也能为 agent 提供构建数据,对 JavaScript 程序进行自动诊断与优化。

本次更新的主要亮点包括:

  • 面向 agent 的构建分析:同一份分析数据,既支持开发者可视化排查,也支持 agent 自动化分析

  • 更小的安装体积:安装体积减少 56%,依赖数量减少 78%

  • 更快的分析速度:构建分析耗时减少 57%

  • 更快的增量构建:减少重构建过程中的分析开销,HMR 耗时降低约 47%

  • 改进多 compiler 支持:在同一份报告中查看多个 compiler 的分析结果

面向 agent 的构建分析

随着 agent 承担越来越多的分析、诊断和优化工作,我们希望 Rsdoctor 能为这些任务提供所需的构建数据,帮助 agent 理解项目的构建过程并找到优化方向。

Rsdoctor 的可视化界面主要服务于开发者。为了让 agent 也能使用这些数据,我们在 Rsdoctor 1.x 中推出了 Agent CLI[1]。它直接读取 rsdoctor-data.json,支持检索和过滤报告数据,并返回结构化 JSON,让 agent 可以按需查询、逐步排查问题。

在 2.0 中,Agent CLI 成为推荐的自动化分析方式。配合 Rsdoctor analysis skill[2],agent 可以根据任务选择查询命令并分析结果。首先,在项目中安装 Agent CLI,也可以为 agent 安装配套的 skill:

# 安装 Agent CLI

pnpm add -D @rsdoctor/agent-cli

# 安装 Rsdoctor analysis skill(可选)

npx skills add rstackjs/agent-skills --skill rsdoctor-analysis

接下来,在 Rsdoctor 插件中配置 brief 模式[3],生成供 agent 查询的 rsdoctor-data.json:

new RsdoctorRspackPlugin({

  output: {

    mode: 'brief',

    options: { type: ['json'] },

  },

});

配置后运行 pnpm run build。临时生成 JSON 数据时,也可以使用 RSDOCTOR_OUTPUT=json pnpm run build。

生成报告后,就可以用自然语言向 agent 提出分析需求,例如:

使用 Rsdoctor 分析当前项目,找出可以优化产物体积的方向。

agent 会根据问题调用相应的 rsdoctor-agent 命令,结合项目上下文定位大 chunk、重复依赖等问题,并继续查询模块引用链、loader 耗时或 tree shaking 失败原因,逐步缩小排查范围并提出优化建议。

随着 agent 的分析入口统一到 Agent CLI,我们在 Rsdoctor 2.0 中下线了原有的 MCP Server 用法。使用 @rsdoctor/mcp-server 的项目可以参考 **2.0 迁移指南[4]**完成迁移。

更小的安装体积

Rsdoctor 2.0 将原先分散在多个包中的分析能力整合到 @rsdoctor/core,并精简运行时依赖。这减少了安装时需要下载的包数量,也降低了本地开发和 CI 环境中的磁盘占用。

经过这些调整,Rsdoctor 2.0 的安装体积从 25.5 MB 降至 11.1 MB,依赖数量从 83 个减少到 18 个:

指标

Rsdoctor 1.x

Rsdoctor 2.0

降幅

安装体积

25.5 MB

11.1 MB

56.6%

依赖数量

83

18

78.3%

更快的分析速度

自 1.5 起,Rsdoctor 已默认使用 Rspack 原生插件采集构建数据。2.0 进一步精简了 JavaScript 侧的实现,将更多数据采集逻辑交给原生插件,原有的 `experiments.enableNativePlugin`[5] 配置也随之移除。

这些优化进一步降低了 Rsdoctor 的分析开销。在基准测试中,Rsdoctor 2.0 相比 1.4 的耗时减少了 57%:

指标

Rsdoctor 1.4

Rsdoctor 2.0

降幅

分析耗时

18.07 s

7.77 s

57.0%

峰值 RSS

2,186 MiB

1,755 MiB

19.7%

更快的增量构建

在开发过程中开启 Rsdoctor,可以随着代码修改持续分析构建结果,但分析带来的额外开销也会增加每次等待更新的时间。Rsdoctor 2.0 优化了 watch 模式下的分析流程,让你在保留构建分析能力的同时,更快地看到修改效果。

现在每次重构建时,Rsdoctor 会复用已有的分析结果和报告服务。对于开发时不必每次计算的模块和产物 gzip 体积,watch 模式会跳过计算,并采用更快的压缩级别保存报告,减少等待时间。

在基准测试中,这些优化带来了以下收益:

基准测试指标

优化前

优化后

耗时降幅

HMR 耗时中位数

6.81 s

3.64 s

47%

重复构建中的分析耗时

250.9 ms

14.2 ms

94.3%

改进多 Compiler 支持

Rsdoctor 2.0 改进了对多 compiler 的支持,以改善在全栈框架中的使用体验。

Rsdoctor 会自动将多个 compiler 的分析结果聚合到一份报告中。你可以通过 compiler 名称切换查看各自的结果,无需在多份报告之间来回查找。插件创建的 child compiler[6] 也会被自动识别,并与 main compiler 的数据分开展示。

包含 main compiler 和带 Child 标签的 child-assets 的 compiler 选择器
包含 main compiler 和带 Child 标签的 child-assets 的 compiler 选择器

这些能力默认开启。如果需要自定义报告分组,例如将 SSR 项目的客户端和服务端构建归为一组,可以为插件实例指定相同的分组名称:

new RsdoctorRspackPlugin({ multiCompiler: { group: 'ssr' }, });

同一进程中的 compiler 若属于互不相关的构建,也可以通过 `multiCompiler: false`[7] 关闭自动聚合。Agent CLI 同样支持选择 compiler[8],让 agent 针对指定构建进行分析。

产物分析界面改进

分析产物体积时,我们往往需要先找到较大的产物或 chunk,再逐层查看其中的模块。随着项目规模增长,模块可能分布在多层目录中,浏览和定位也会变得费时。Rsdoctor 2.0 围绕这一过程,改善了 Bundle Size 页面的浏览体验。

在 Tree Graph 中,即使产物包含数千个模块,展开目录和连续滚动也能更加流畅。通过虚拟滚动和渲染缓存,页面只渲染视窗附近的节点,并减少提示框等交互组件在滚动时的开销,让你更顺畅地查找模块、查看详情:

优化前

Tree Graph 优化前
Tree Graph 优化前

优化后

Tree Graph 优化后
Tree Graph 优化后

Treemap 则让你更方便地从整体体积分布深入查看具体模块:点击即可缩放到关注的区域,再通过面包屑导航返回上层。需要查看大型产物时,可以进入全屏模式或收起侧边栏,为图表留出更多空间;布局也会随窗口大小调整。

你还可以筛选 JavaScript 产物,将注意力集中在相关代码上,并通过统一的 Stat、Parsed 和 Gzipped 体积指标,从不同角度了解模块的体积占比。

相关 PR:#1705[9]、#1782[10]、#1830[11]、#1839[12]。

如何升级

升级到 Rsdoctor 2.0 时,主要需要关注以下变化:

  • 运行环境[13]:要求 Node.js ^20.19.0 || >=22.12.0 和 Rspack 2.0 及以上版本。

  • 包名与模块格式[14]:使用 @rsdoctor/core 替换 @rsdoctor/rspack-plugin,并使用 ESM 导入。

  • AI 工作流[15]:从已移除的 @rsdoctor/mcp-server 迁移到 Agent CLI。

  • Rsdoctor 2.0 不再兼容 webpack,使用 webpack 的项目可以继续使用 Rsdoctor 1.x。

完整的升级步骤、配置变更和验证方法,请参考 Rsdoctor 2.0 升级指南[16]。指南也提供了迁移 skill,可让 agent 协助完成升级。

欢迎试用 Rsdoctor 2.0 并分享反馈,完整更新内容见 release 页面[17]。

致谢

感谢所有参与贡献和提供反馈的开发者与用户。你们的参与帮助我们完善了 Rsdoctor 2.0 ❤️

参考资料
  1. Agent CLI: https://rsdoctor.rs/zh/guide/start/ai#agent-cli
  2. Rsdoctor analysis skill: https://rsdoctor.rs/zh/guide/start/ai#agent-skills
  3. brief 模式: https://rsdoctor.rs/zh/config/options/output#mode-brief
  4. 2.0 迁移指南: https://rsdoctor.rs/zh/guide/migration/migration-v2#ai-工作流迁移
  5. experiments.enableNativePlugin: https://rsdoctor.rs/zh/config/options/experiments#enablenativeplugin
  6. child compiler: https://github.com/web-infra-dev/rsdoctor/pull/1842
  7. multiCompiler: false: https://rsdoctor.rs/zh/config/options/multiCompiler
  8. 选择 compiler: https://rsdoctor.rs/zh/guide/start/ai#selecting-a-compiler
  9. #1705: https://github.com/web-infra-dev/rsdoctor/pull/1705
  10. #1782: https://github.com/web-infra-dev/rsdoctor/pull/1782
  11. #1830: https://github.com/web-infra-dev/rsdoctor/pull/1830
  12. #1839: https://github.com/web-infra-dev/rsdoctor/pull/1839
  13. 运行环境: https://rsdoctor.rs/zh/guide/migration/migration-v2#检查构建工具
  14. 包名与模块格式: https://rsdoctor.rs/zh/guide/migration/migration-v2#更新-rspack-插件
  15. AI 工作流: https://rsdoctor.rs/zh/guide/migration/migration-v2#ai-工作流迁移
  16. Rsdoctor 2.0 升级指南: https://rsdoctor.rs/zh/guide/migration/migration-v2
  17. release 页面: https://github.com/web-infra-dev/rsdoctor/releases

雁评

真实、有观点的好评或吐槽,欢迎分享你的使用体验。

登录后可查看你的发表权限