香色 webViewJs 求值语义与防闪退要点

香色的 webViewJs 不是普通 JS 环境，按 Script 语义求值。理解错语义 = 真机闪退。这篇是硬规则速查。

四条硬规则

1. 单表达式 IIFE：webViewJs 整体按 Script 求值，禁顶层 return。骨架：

javascript
(function(){
    // 全部逻辑放这里
    return result;   // IIFE 内部的 return 是合法的
})()

2. DOM 步骤第三参是 TFHpple 节点，不是字符串：@js: 会包成 functionName 执行；@path: 走 XPath 查询。写代码前先确认自己拿到的是节点对象还是文本。
3. 正文必须 XPath：正文规则用 XPath 定位，混用其它方式会被派发到错误路径。
4. 字段白名单 23 键强制过滤：解析结果只保留白名单字段；要保留原始 HTML 的字段走 removeHtmlKeys。

分段规则语义

• @js: 段会吞掉后续段——分段顺序有讲究，兜底段放在不会被吞的位置。
• | 与 || 行为不同：前者是简单级联，后者带短路；空串会吞并兜底段。

JSONPath 双路径（高频坑）

同一个源里混用两种写法是数据错位的经典来源——统一风格，并在注释里写明用的是哪套。

列表动作响应形态

8 个列表类动作要求「字典 + 非空 list + 首末元素是对象」；目录空标题会自动补「第N章」——但别依赖这个兜底掩盖解析错误，它会让「目录解析失败」看起来像「章节没抓全」。

诊断输出范式

调试时用结构化诊断输出，别用 alert：

javascript
(function(){
    var out = { step: 3, url: location.href, keys: Object.keys(payload||{}) };
    /* ... */
    return JSON.stringify(out);   // 步骤号 + 关键中间值
})()

缓存与重试逻辑放在 IIFE 内部；转义与结构化生成遵守「生成而非拼接」纪律——用 JSON 序列化构造载荷，不要手拼字符串。