SuperAPI AI 工具集

experience-lwc-runtime-observe

营销与增长

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能引导智能体完成两件连续任务——先用 Salesforce CLI 启动本地 Lightning Preview,让 LWC 应用或组件在本地开发环境渲染;再导航到预览 URL 并提取运行时 DOM 子树,用于差异对比、截图流程或理解渲染结果。预览是 DOM 检查的前置条件,顺序不可颠倒。

适用场景:部署前在本地预览 LWC 应用或组件(sf lightning dev app / sf lightning dev component);获取某组件运行时的渲染 HTML 子树;排查模板内容“不在 DOM 中”的问题,通常是 Shadow DOM 误解。

前提条件:已安装 Salesforce CLI(sf version 检查)、@salesforce/plugin-lightning-dev(sf plugins 检查)、已认证且 Connected 的组织;DOM 提取还需智能体环境中具备浏览器自动化能力(Playwright、Puppeteer、Chrome DevTools Protocol 等)。

主要步骤:1)用捆绑脚本验证工具链 "<skill_dir>/scripts/verify-toolchain.sh" <orgAlias>,失败时按提示执行 sf org login web --alias <orgAlias> 或安装插件;2)查看子命令帮助后启动预览,所有预览命令需前置 OPEN_BROWSER=false,例如应用范围 OPEN_BROWSER=false sf lightning dev app -o <orgAlias> -n <appName> -t desktop,组件范围 OPEN_BROWSER=false sf lightning dev component -o <orgAlias> -n <componentName>,并记录 URL;3)通过 <skill_dir>/scripts/open-frontdoor.sh 获取认证入口 URL,避免直接运行 sf org open 导致令牌泄露,先捕获输出再 eval,浏览器驱动从 $FRONTDOOR_URL_FILE 读取,用后立即删除临时文件;4)等待网络空闲和渲染完成后提取子树,组件范围用 extract-dom.sh selector 计算选择器,穿透 lwr_dev-preview-container 的 shadow root,读取 element.shadowRoot.innerHTML,再经 extract-dom.sh wrap 包装输出;应用范围优先取 document.body 或主应用容器。

限制与注意:预览命令的 OPEN_BROWSER=false 未在帮助中记录;入口令牌有效期短,需在约 60 秒内导航;LWC 使用 Shadow DOM,宿主元素的 innerHTML 或 outerHTML 无法获得真实模板内容,必须遍历 shadowRoot;DOM 输出须由脚本生成标记,不要自行拼写。资料未提供具体收费、价格或平台扩展信息。