用途:分析 Rspack/Webpack 打包产物,基于本地 rsdoctor-data.json 给出有证据的优化建议。仅在数据文件真实存在后使用全局安装的 @rsdoctor/agent-cli 中的 rsdoctor-agent CLI;除用户明确要求安装或配置外,分析保持只读。
主要能力:按固定顺序输出结果——高优先级问题、建议方案、可选的引用链追踪选择、下一步深入分析的问题类别(非命令)。先复用当前会话结果与有效的 .rsdoctor-analysis-cache.json。定位数据文件顺序:用户路径、dist/、output/、static/、.rsdoctor/ 下的 rsdoctor-data.json,再做一次有界 rg --files 搜索(排除 node_modules 与 .git);manifest.json 仅作索引。数据存在则跳过插件版本/配置/构建生成逻辑。
使用方式:数据存在后,在首个数据获取命令前最多运行一次 Analysis Gate,用 npm view @rsdoctor/agent-cli version 与 rsdoctor-agent --version 校验全局 CLI,仅在缺失、过旧、版本报错或用户要求刷新时安装最新版。先只取默认证据集(buildCost、assetsTop、packagesTop、duplicatePackages、crossChunkPackages、retainedModulesTop),独立抓取尽量并行,输出用 --filter、分页与 --limit 限制。推荐修复前先跑 ROI 分诊,按实测影响排序成本桶(资源/媒体、大包/模块、重复与跨 chunk 成本、tree-shaking 浪费、构建耗时),从可落地修复的最大桶入手。
适用场景:Rspack/Webpack 项目体积与构建性能诊断。限制:数据缺失时停止分析,不运行分析命令与 Analysis Gate,改为询问路径或按 Generation Gate 处理;链追踪、优化改动、splitChunks 实验与重新构建需用户确认;命令输出超过约 5k tokens、500 KB 或数百行时改用定向紧凑查询;安装、构建、版本检查等仅在宿主授权且具备项目、依赖与网络访问的环境执行,否则停止并说明缺失权限。