SuperAPI AI 工具集

mobile-platform-offline-validate

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:对 Lightning Web Component(LWC)执行结构化的离线预置(offline priming)合规检查,生成问题报告与代码级修复,使其符合 Komaci 静态分析要求,适用于 Salesforce Mobile App Plus 与 Field Service Mobile App。

适用时机:用户要求对某个 LWC 做“mobile offline review”“Komaci check”或“offline priming audit”;准备将组件发布到上述移动应用的离线模式;排查离线分析器报告的预置失败。不适用于使用原生移动能力(条码、生物识别、定位等)的 LWC,也不用于通用 LWC 代码审查。

前置条件:组件路径(modules/… 下的 LWC bundle);可访问其 JS/TS 与 HTML 模板;本地 Node + npm,能运行 npx eslint 及 @salesforce/eslint-plugin-lwc-graph-analyzer 插件。

主要能力与流程:先确定审查范围(.html、.js/.ts,CSS 与 meta 不在范围内);阅读 Mobile Offline Grounding 与三份 reviewer 参考(Inline GraphQL、lwc:if、Komaci ESLint);检查所有 lwc:if/lwc:elseif/lwc:else 并给出 if:true/if:false 改写;检查 @wire 中直接或经顶层常量引用的 gql 模板字面量,改为具体 getter;运行 Komaci ESLint 分析:scripts/run-komaci.sh path/to/component.js,输出 ESLint --format json,按 ruleId 分组并引用参考中的修复文本;最后按指定报告格式输出,标注 reviewer 或规则 id,并在用户要求时直接应用修复,冲突项列入 deferred。

限制:仅覆盖上述三类问题,其他关注点属于其他技能;插件需可从工作目录解析,且 JS 同级需有 HTML 模板供 bundleAnalyzer 处理器解析离线数据图;不得编造规则或建议。若脚本不可用,参考中提供手动 npx eslint 调用方式。