用途:扫描 React 代码库,检查安全、性能、正确性和架构问题,并输出 0–100 健康评分。可在完成功能、修复 bug、提交 React 代码前使用,或由用户输入 /doctor、要求扫描、triage、清理时触发。
主要能力:支持完整扫描与增量扫描;--verbose 显示每条规则涉及的文件与行号;--scope changed 只报告相对基线分支新引入的问题,--scope lines 只报告变更行上的问题;--score 仅输出数字评分;design 子命令只运行聚焦的 UI 设计诊断,涵盖设计相关的 UI 组合、排版、交互、可访问性与动效规则,其中部分规则在常规健康扫描中默认不启用。
用法:改动 React 代码后运行 npx react-doctor@latest --verbose --scope changed,确认评分未回退;若下降,先修复回归再提交。通用清理或改进时运行 npx react-doctor@latest --verbose(默认 --scope full)扫描整个代码库,按严重程度修复,先错误后警告。聚焦 UI 设计审计运行 npx react-doctor@latest design --verbose。查看或调整规则时,先运行 npx react-doctor@latest rules explain <rule>,再用 rules disable|set|category|ignore-tag 做最小范围控制,会修改 doctor.config.* 或 package.json#reactDoctor。
/doctor 完整本地 triage:当用户输入 /doctor 或要求完整排查/清理时,获取并遵循本地 triage 手册:curl --fail --silent --show-error --header 'Cache-Control: no-cache' https://www.react.doctor/prompts/react-doctor-agent.md。该手册是唯一事实来源,执行扫描→过滤→排查→修复→验证循环,直接编辑工作树,不提交、不开 PR。配合按规则提示 https://www.react.doctor/prompts/rules/<plugin>/<rule>.md 使用。
限制:资料未提供支持的 React 版本、Node 版本、平台兼容性、性能数据或收费信息。