Legado 真机调试入门：Web 服务五阶段 TDD

Legado 写源不靠猜，靠真机调试闭环。这是效率最高的路径，也是「验证文化」在 Legado 平台的具体形态。

开启调试服务

Legado App 开启 Web 服务：HTTP 端口 1122、WebSocket 端口 1123。开启后：

• 规则改动可以直接推到真机执行，改完立刻看到结果；
• 调试会话有标签页概念，与 App 内的搜索/详情/目录/正文/发现一一对应。

五阶段（前置阶段须先成功一次）

text
正文 → 目录 → 详情 → 搜索 → 发现

为什么要按这个顺序：正文规则是地基（DOM/接口结构认知），目录依赖详情页字段，发现页是搜索的多入口变体。先让正文规则跑通一次，再调目录，然后详情、搜索、发现。跳级调试是翻车主因——上层规则引用了下层还没验证的字段，报错信息会把人带偏。

调试纪律（四条）

1. 定义预期 → 写规则 → 真机验证，每个功能点走一遍循环；预期就是「这一步应该拿到什么字段、什么形态」。
2. 失败先加 java.log() 定位中间值，再改规则；禁止盲改——连改三个可能点之后如果还没定位到根因，回滚到上一个能跑的版本重来。
3. 不批量写完再统一调试；每改一个变量验一次。
4. 选择器必须基于真实 HTML / 接口响应，不编造。抓真实响应的途径：调试服务的日志、抓包工具、浏览器开发者工具。

高频报错速查表

会话管理小技巧

• 每轮调试从干净状态开始：清掉 App 缓存的旧规则结果再验证，否则你看到的可能是缓存而非新规则的效果。
• 长会话注意记录「当前版本改了什么」——建议直接在工程化目录里做版本归档（见《大源工程化》）。
• 调试通过 ≠ 长期可用：发布前留给第 7 级（用户长期确认）至少几天观察期。