用途:当用户要求 review、check、audit、look over Qt6 QML 代码,或提交前做质量校验时使用。支持两种范围:提交/差异范围(依据 git diff、git diff --cached 或 git diff HEAD~1..HEAD,仅报告改动行及 ±50 行上下文内的问题)与代码库范围(按路径 glob 匹配 *.qml 全量审查)。
主要能力:分三阶段执行。阶段一运行统一 Python 检查脚本,需 Python 3.6+、无外部依赖:python3 references/lint-scripts/qt_qml_lint.py <files...>(无 python3 时回退 python)。覆盖导入、排序、绑定、布局、Loader、委托、状态、图片、性能、风格、信号、错误与安全、JavaScript 等 47+ 条规则,结果确定可复现。阶段一b 可选运行系统 qmllint:qmllint --json - -I <import-paths> <files...>,按文件+行+问题去重合并,类型级检查以 qmllint 为准。阶段二并行启动六个只读代理:绑定与属性、布局与锚定、组件加载与生命周期、ListView 与委托、状态与结构、性能与代码质量。阶段三合并、去重、按置信度评分并输出报告。
置信度:80 以上为确认问题,60–79 为待人工验证项(全报告最多 10 条),低于 60 直接抑制。报告结构含范围、文件数、问题数、lint 结果、深度分析结果、待验证项与汇总表。
限制:代理只读,不修改文件;不提供代码补丁,仅给出文字性缓解建议;qmllint 不可用时跳过并提示;具体安装方式与平台支持资料未提供。