Trace 概览¶

Trace 是 AutoLXB 的运行日志系统。遇到任务没有启动、路线没有命中、通知没有触发、模型点错位置、输入失败等问题时，优先查看 Trace。

Trace 的作用不是让你背内部实现，而是帮助判断：问题发生在哪个阶段。

如何查看 Trace¶

进入 App 的 日志页，可以看到最近的 core trace。每条 trace 会以卡片形式显示，点击卡片可以打开详细字段。

日志页通常可以：

查看最新 trace。
打开单条 trace 详情。
加载更早的 trace。
导出本地缓存 trace。

Trace 长什么样？¶

Trace 本质是一行一行 JSON。每条记录都有一个 event 字段表示事件类型，还有一个 ts 字段表示时间。

后续分类页面里的示例使用的都是 AutoLXB 真实的 trace 事件名和字段结构；示例里的时间、任务名、包名和坐标只是演示值，实际内容以你导出的 trace 文件为准。

示例：

{
  "task_id": "2f1c...",
  "state": "VISION_ACT",
  "size": 384221,
  "attached": true,
  "ts": "2026-05-06T16:20:31.318+0800",
  "event": "vision_screenshot_ready"
}

最重要的是：

字段	说明
`event`	这条 trace 是什么事件。
`ts`	事件发生时间。
`task_id`	这条事件属于哪一次任务。反馈问题时很有用。
其它字段	不同事件会有不同字段，例如状态、包名、失败原因、点击坐标等。

遇到问题怎么用 Trace？¶

建议按顺序看：

有没有任务开始相关事件。
有没有进入目标 App。
有没有命中或回放任务路线。
有没有进入视觉执行。
有没有执行点击、输入、滑动。
最后失败原因是什么。

反馈问题时最好提供什么？¶

反馈问题时，建议提供：

设备型号和系统版本。
使用 Root 启动还是 ADB 启动。
任务类型：快速任务 / 定时任务 / 通知触发任务。
任务描述和关键配置截图。
失败时手机界面截图。
导出的 Trace 文件。

为什么最好提供 Trace 文件？

截图只能看到任务停在哪个页面，Trace 能看到它为什么停在那里。很多问题必须通过 Trace 才能判断是配置问题、路线问题、通知匹配问题、模型问题还是设备权限问题。

分类说明¶

后续页面会按类别介绍常见 trace：

任务流程 Trace：任务从开始到结束经历了哪些阶段。
任务路线 Trace：路线是否命中、回放到哪一步、为什么降级。
视觉执行 Trace：模型看到了什么、输出了什么动作、是否解析失败。
通知触发 Trace：通知是否被读取、规则是否命中、任务是否提交。
动作执行 Trace：点击、滑动、输入等底层动作是否成功。