用途:对 Lightning Web Component(LWC)执行结构化的移动离线预置合规检查,输出问题报告与代码级修复,使其符合 Salesforce Mobile App Plus 与 Field Service Mobile App 下 Komaci 静态分析的要求。适用于用户要求“mobile offline review”“Komaci check”或“offline priming audit”,或组件准备在移动离线模式发布、排查离线分析器报出的预置失败时。
主要能力:覆盖三类违规——lwc:if/lwc:elseif/lwc:else 条件渲染兼容性、@wire 中内联 GraphQL(gql 模板字面量)配置、以及 Komaci ESLint 静态分析规则;每条发现引用对应审查来源,报告含文件行列范围、描述、意图分析与建议动作。
使用方式:先确定组件 bundle 的 .html 与 .js/.ts(CSS 与 meta 不在范围内),通读 Mobile Offline Grounding 与三个审查参考。对每个 lwc:if/lwc:elseif/lwc:else 给出改为 if:true / if:false 的改写;对每个直接引用 gql 的 @wire 给出具名 getter 与改写后的配置。再运行 Komaci ESLint: scripts/run-komaci.sh path/to/component.js 脚本要求工作目录可解析 @salesforce/eslint-plugin-lwc-graph-analyzer,且组件同级 HTML 模板须与 JS 同目录(bundleAnalyzer 处理器借此解析离线数据图),输出为 ESLint --format json。按 ruleId 分组并对照规则修复说明,逐条报告。
限制:不用于构建使用原生移动能力(条码、生物识别、定位等)的 LWC,也不做通用代码审查。未提供脚本时的手动 npx eslint 调用方式见参考;插件解析失败需在工作区安装该插件;bundleAnalyzer 报错时不应移除其处理器并需保证同级 HTML 可被发现。修复若与离线外行为冲突,应列入延期项而非静默改写。不要臆造规则或建议。