CLI
常用命令:
如果在交互式终端中发现诊断结果或源码解析错误,Lynx Doctor 会在扫描后弹出可用方向键选择的 coding agent 菜单。
--json、--score 和非 TTY 输出不会弹出交互提示。
选项:
增量扫描范围
--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 排除。配置错误和内部异常仍会中止扫描。
