CLI

lynx-doctor [directory] [options]

常用命令:

npx lynx-doctor@latest
npx lynx-doctor@latest --verbose
npx lynx-doctor@latest --diff origin/main
npx lynx-doctor@latest --category reactlynx --json
npx lynx-doctor@latest --agent-prompt
npx lynx-doctor@latest install

如果在交互式终端中发现诊断结果或源码解析错误,Lynx Doctor 会在扫描后弹出可用方向键选择的 coding agent 菜单。 --json、--score 和非 TTY 输出不会弹出交互提示。

选项:

选项说明
--verbose展示每条诊断的源码上下文、文档链接和 skill source
--json输出结构化 JSON 报告
--json-compact配合 --json 输出压缩 JSON
--score只输出数字分数;源码解析不完整时输出 N/A
--diff [base]只扫描相对 base 变化的文件
--staged只扫描 git index 中 staged 文件
--package构建后检查组件库入口是否对应实际产物
--category <category>只展示某个分类,可重复:reactlynx、lynx-ui、rspeedy 或 lynx-css
--no-warnings隐藏 warning,只看 error
--blocking <level>设置失败阈值:error、warning、none
--agent-prompt打印可交给 agent 的修复提示
--agent [command]启动本地 agent 命令并把提示写入 stdin
--no-agent-select关闭扫描后的交互式 agent 选择

增量扫描范围

--diff 合并分支相对 merge base 的改动、暂存改动、未暂存改动和未跟踪文件。PR 目标不是 main 或 master 时,请显式指定实际目标分支。两种增量模式都会遵守与全量扫描相同的文件忽略规则和 package 边界,并跳过已删除文件。

--staged 从 Git index 读取源码,包括已暂存但在工作区中删除的文件。项目依赖和配置仍从工作区读取。两种增量模式不能同时启用;无效 base 或非 Git 目录会直接报错,不会悄悄变成全量扫描。

文本报告显示 full/diff/staged 范围及适用源文件数量。空扫描和没有适用 Lynx 源码的扫描不会显示 healthy 标签。为保持兼容,JSON 的数字分数仍按规则诊断计算;解释分数前请同时查看 ok、parseErrors、scope、cssCoverage 和 notices,不要把分数当作覆盖率。

源码解析错误

JavaScript、TypeScript 或参与检查的 CSS 文件无法解析时,Doctor 会记录文件路径、行号、列号和解析器消息,然后继续检查其他文件。这些错误会出现在文本报告、JSON 的 parseErrors 和 agent prompt 中。解析失败的文件不会计入已检查源码,文本报告会标记扫描不完整,并停止展示健康分数。

扫描不完整时退出码为 1,即使传入了 --blocking none;--score 会输出 N/A。修复解析错误后重新运行;如果文件是故意构造的非法测试样例,可用范围明确的 ignore.files 排除。配置错误和内部异常仍会中止扫描。