feat(saas): SaaS 无埋点采集与可视化圈选支持

[YoloMao]

概述

本 PR 为 SaaS 模式补齐两大能力：无埋点采集（原生 + Hybrid 的点击 / 输入变更 / 页面浏览）与可视化圈选（扫码圈选原生页面 + Hybrid 页面）。完成后 SaaS 模式在采集与圈选层面与 New SaaS / CDP 对齐，并与 iOS / Android SaaS SDK 的协议保持一致。

说明：本描述以最终交付结果为准，不逐条对应中间 commit。

---

一、SaaS 无埋点采集

原生采集

• SaaS 模式下启用无埋点点击（clck）、输入变更（chng）、页面浏览（PAGE）采集，xpath / page 生成逻辑复用 CDP（PATH_SEPARATOR + node[xcontent] 格式）。
• 上报走新增的 SaaS_OTHER 发送通道（/harmonyos/other），事件按 MeasurementProtocol V2 序列化为 clck / chng。
• 同页面（t/u/s/d/p/ptm/r 一致）的多条点击事件在 JSON 序列化阶段合并为一条（mergeSaaSClick）：公共字段提升至顶层，元素专属字段（x/v/idx/h/gesid/esid）收入 e 数组，降低上报体积，与 iOS SaaS 行为一致。

Hybrid 采集

• WebView 内的 clck / chng 事件经 _vds_bridge 上报后，由 SDK 解析元素信息（xpath、textValue、index、hyperlink）并拼接原生页面路径前缀后入库上报。

接入方使用方式（README_SaaS）

• 新增配置项 autotrackEnabled（默认 false）、autotrackAllPages（默认 false）。
• 无埋点监听需在 onWindowStageCreate 中调用 GrowingAnalytics.onWindowStageCreate(...)；仅配置开关而不注册监听不会产生事件。
• 支持通过 growing_alias / growing_title / growing_attributes 设置页面别名 / 标题 / 属性（Navigation 与 @ohos.router 两种导航方式）。

---

二、SaaS 可视化圈选

圈选入口（URL Scheme 回跳）

• 接入方在 module.json5 配置 URL Scheme，并在 EntryAbility 的 onCreate / onNewWant 中调用 GrowingAnalytics.handleOpenURL(uri)。
• SaaS 模式下解析回跳参数 circleType / wsHost / circleRoomNumber，由 wsHost + accountId + circleRoomNumber 拼接圈选 wss 地址并建连。

连接签名

• SaaS 圈选 wss 连接追加 timestamp 查询参数，并附带 Authorization: Sign SHA1 <sig> 头，其中 sig = SHA1("<path>:<timestamp>") 的小写 hex。New SaaS / CDP 与 MobileDebugger 连接不受影响。

圈选数据上报

• SaaS 圈选采用独立的 UserAction 协议（refresh / click / page），携带页面信息、截图、impress 元素列表及命中的 targets，相关模型集中在新增的 mobileDebugger/SaaSModel.ets。

Hybrid 圈选

• 新增公开 API GrowingAnalytics.onPageEnd(controller, webviewId?)，接入方在 WebView onPageEnd 回调中调用。圈选激活时动态注入圈选脚本（vds_web_circle_plugin.min.js），并通过 runJavaScript 把 WebView 所在的原生 xpath 写入 window._vds_hybrid_native_info，供 Web 侧定位。
• createHybridProxy 增加可选 webviewId 参数，配合 Web 控件 .id(webviewId) 支持多 WebView 圈选。
• 服务端下发圈选指令时：携带坐标则通过 FrameNode 布局矩形命中目标 WebView 并做坐标系转换（server vp → device px）后定向转发，无坐标则广播给所有已注册 WebView，最终转发给 Web 侧 _vds_hybrid.helper.handleWebEvent()。
• 新增插件回调 PluginsInterface.onWebViewSaaSCircleEvent(message, webviewId?)，由核心模块内的 Circle 圈选插件消费（Hybrid 收到 Web 侧圈选事件 → Plugins 广播 → Circle 转发给服务端）。

---

三、配套修复与改动

• 混淆：将 Hybrid JS Bridge 方法名（New SaaS 的 GrowingWebViewJavascriptBridge、SaaS 的 _vds_bridge）加入 consumer-rules.txt / obfuscation-rules.txt 的 -keep-property-name，修复 release 包属性混淆导致原生桥方法不可达（webview FindMethod fail）、Hybrid 页面零事件的问题。
• ViewElementEvent：新增 query / hyperlink 字段；SaaS 模式补齐 pageShowTimestamp；index 在非 New SaaS 模式下允许 0。
• Context：SaaS 模式初始化 3 个 EventSender（PV + CSTM + OTHER）。

---

四、公开 API / 配置变更（接入方可见）

变更	说明
GrowingAnalytics.onPageEnd(controller, webviewId?)	新增 API，WebView onPageEnd 时调用
createHybridProxy(controller, webviewId?)	新增可选 webviewId 参数
config.autotrackEnabled	新增，开启无埋点点击 / 变更采集
config.autotrackAllPages	新增，开启页面浏览自动采集
PluginsInterface.onWebViewSaaSCircleEvent	新增插件回调

---

Test Plan

• SaaS 模式点击 Button / Text / ListItem，上报 clck，xpath 格式正确
• SaaS 模式输入变更上报 chng；页面浏览上报 PAGE
• autotrackAllPages=true 时全页面自动上报；growing_alias/title/attributes 生效
• SaaS + Hybrid：WebView 内点击 / 变更上报，路径含原生页面前缀
• mergeSaaSClick：同页面多条点击合并为单条 JSON，e 数组元素个数正确
• 扫码 → URL Scheme 回跳 → handleOpenURL 正确解析并建立圈选 wss 连接
• wss 连接携带 timestamp 及 Authorization: Sign SHA1 头，服务端验签通过
• 圈选过程正确上报 refresh / click / page UserAction 及截图、impress 元素
• SaaS + Hybrid 圈选：onPageEnd 后圈选脚本成功注入，native xpath 写入正确
• 多 WebView：带坐标指令只转发命中 WebView，坐标偏移正确；无坐标广播
• release 包下 Hybrid 桥方法可达，Hybrid 页面正常上报事件
• dataCollectionEnabled=false 时上述事件均不上报

🤖 Generated with Claude Code