DevTools 面板字段参考
DevTools 扩展面板里每个 Tab、每一列、每个标签具体是什么意思？这页给一份字段对照表，便于你在面板上看到某个值时回来对一眼。
面板顶部有工具栏，下方是三个 Tab：事件流、管线、元素。
想看实操流程
本页只解释「字段是什么」。面板怎么打开、典型调试场景见 DevTools 扩展；为什么有些事件被丢弃见 远程配置 与 排查：没有上报。
工具栏
| 元素 | 含义 |
|---|---|
Tripo Lens | 品牌标识，仅展示。 |
| 状态徽标 | 捕获中（绿）= 网络监听挂上、新批次会入库；已暂停（默认色）= 入库被冻结。 |
类型 下拉 | 按 event_type 过滤事件流。全部 = 不过滤；其余选项来自当前已捕获的事件类型集合。 |
扫描元素 按钮 | 触发 content script 重扫页面 data-trace* 元素；结果写入「元素」Tab。打开面板时会自动扫一次。 |
暂停 / 继续 按钮 | 切换事件流入库开关；暂停期间网络仍在跑，只是不写入。 |
清空 按钮 | 清空事件流与背压计数（只清事件流 Tab；管线 Tab 的「清空」按钮单独管管线缓冲）。 |
事件流 Tab
布局：左侧事件列表 + 右侧事件详情 + 底部背压条。点左侧任一行 → 右侧展开该事件的完整信封。
事件列表（左栏）
每行一个事件，最新在最上；最多保留 2000 条，超限丢最旧。
| 列 | 含义 |
|---|---|
event_type（左） | 事件类型字符串，如 click、pageview、error、performance。字体颜色 = 优先级（见下表）。 |
event_format | 该事件的 TracePath 坐标（如 tripo.home.banner）；非坐标类事件显示 —（半透明）。 |
×N 计数 | 折叠计数。SDK 在源头对同坐标连续事件做了去重折叠，×N 表示这一条代表 N 次实际触发；N=1 时不显示。 |
| 时间戳（右） | 事件信封的 timestamp，格式 HH:mm:ss.SSS，本地时区。 |
| 选中态 | 被选中行底色为浅橙。 |
事件详情（右栏）
选中事件后展示该事件的完整统一信封：
| 字段 | 含义 |
|---|---|
event_type | 事件类型（同左栏）。 |
优先级 | 由 event_type 推断的三级优先级（见下表）。 |
event_format | 坐标字符串；可点击 → 通知页面高亮对应元素（反向定位事件来源）。非坐标事件显示「（非坐标事件）」。 |
timestamp | 原始数值时间戳 + 友好格式 HH:mm:ss.SSS。 |
批次 sentAt | 该事件所在的上报批次离开浏览器的时刻（HH:mm:ss.SSS）；与 timestamp 的差值反映批量延迟。 |
context | 信封的环境上下文（device / session / page 等），可折叠 JSON 树。 |
payload | 事件载荷（业务字段），可折叠 JSON 树。 |
JSON 不会执行
详情中的 JSON 全部由 textContent 渲染，不会执行其中的脚本字符串。
优先级标签
字段颜色取自 SDK 的 priorityOf(event_type) 推断，与队列优先级一致。
| 标签 | 字体颜色 | 含义 | 包含的 event_type |
|---|---|---|---|
| P0 | 红 #e0434f | 关键身份 / 归因事件，必须送达 | landing · identity |
| P1 | 橙 #e3633d | 行为事件，常规优先级 | click · expo · pageview · hide · show · leave · track |
| P2 | 默认色 | 错误 / 性能与表外未知，背压时最先被淘汰 | error · performance，以及上表之外的任意类型 |
这只是「面板呈现」的颜色
SDK 内部还有更细的子分类，但面板只展示这三档。
背压条（底部）
| 元素 | 含义 |
|---|---|
device <id> | 来自批量壳 device_id，截短显示首 8 + 末 4 位。 |
session <id> | 来自批量壳 session_id，截短同上。 |
背压淘汰 P1:<x> P2:<y> | 从首个观测到的批次开始累计的背压淘汰条数（黄字 #e0a000）；x、y 同时为 0 时整段不显示。该数字来自批量壳的 dropped 字段，由 SDK 在队列里淘汰时回填。 |
管线 Tab
需要点「开启内部观测」并刷新被检页面才会有数据；它来自 SDK 的内部 Debug 桥（不再是网络层观测）。
布局：顶部操作栏 + 队列快照栏 + 生命周期列表。
顶部操作栏
| 元素 | 含义 |
|---|---|
开启内部观测 按钮 | 通知页面打开 SDK 的 Debug 桥；之后管线事件会广播给面板。 |
已通知页面 → 请刷新被检页面使 lens 装配生效 | 黄色提示：装配只发生一次，需要刷新页面才能让新装配带 Debug 桥起来。 |
清空 按钮 | 仅清空管线生命周期与队列快照，不影响事件流 Tab。 |
队列快照栏
显示来自 SDK 的最近一次队列状态（QueueDebugSnapshot）。
| 字段 | 含义 |
|---|---|
size | 当前队列里待发送的事件总数。 |
P0 / P1 / P2 | 队列内按优先级分桶的事件数。 |
淘汰 P1 / P2 | 因背压累计淘汰的事件数；与事件流 Tab 底部条同源。 |
末批 <N> 条 / <B>B | 最近一次 flush 的条数与序列化字节数；尚未 flush 时该段不显示。 |
生命周期列表
每一条事件展开后是它流经 SDK 管线的完整轨迹。最新在最上；最多保留 1000 条。
折叠态从左到右：
| 元素 | 含义 |
|---|---|
▸ / ▾ | 展开 / 折叠该条。 |
| 类型 | 该事件原始 type（采样前的 RawEvent.type）；如该事件任一阶段被丢弃，类型字会变红。 |
| 阶段标识序列 | 经过的管线阶段，每个阶段一个小色块（见阶段标识颜色）；hover 可看到 阶段: 结果 详情。 |
✕ <stage> 丢弃 | 该事件最终在哪一阶段被丢弃；未丢弃时不显示。 |
展开态：
| 块 | 含义 |
|---|---|
原始 raw（采样前） | SDK 拿到的原始事件对象（含 type、format、context、payload 等）。 |
每个阶段一块 <stage> · <outcome> | 该阶段的产物 JSON 树；outcome=dropped 时无产物，仅显示标签。 |
「丢弃 N」与 SDK 队列里的「P1/P2 淘汰」是两回事
顶部「丢弃 N」统计的是任一管线阶段（采样 / Schema / PII / beforeEmit 等）抛弃的条数；队列快照里的 淘汰 P1/P2 统计的是进入队列后因背压在出队前被丢的条数。
阶段标识颜色
来自 StageBadge，按该阶段对事件的处置着色：
| 标签底色 | outcome | 含义 |
|---|---|---|
绿（#2ec47a） | kept | 该阶段保留事件、未做改写。 |
红（#e0434f） | dropped | 该阶段丢弃事件；后续阶段不再有产物。 |
橙（#e3633d） | mutated | 该阶段改写了事件（典型：PII 清洗）；产物 JSON 是改写后的版本。 |
阶段名（stage 文本）由 SDK 内部约定，常见值：enrich / sample / schema / pii / beforeEmit / serialize。具体阶段集合与顺序属内部约定，会随 SDK 版本演进；底层协议契约见仓库 llmdoc/reference（维护者文档）。
元素 Tab
工具栏点「扫描元素」（或打开面板时自动扫一次）后填充。每一行一个页面 data-trace* 元素。
| 列 | 含义 |
|---|---|
| 坐标（首行） | 合法 TracePath 直接显示，如 tripo.home.banner.cta。坐标非法时显示 ⚠ <原始字符串> 并标黄——通常是 data-trace* 组合不符合 [a-z0-9_-]{1,32} × 2–8 段规则，见行为埋点。 |
| 元数据（次行） | types 用 / 连接，例如 click/expo；若该元素带 data-trace-params 则末尾追加 · params。 |
| 整行 | 点击 → 页面滚动到对应元素并闪烁（按扫描时的 index 高亮，页面发生重排后需要重新点「扫描元素」刷新）。 |
坐标非法 = 没埋上
扫得到、坐标却标黄，说明 data-trace* 写错了——这种事件不会触发 click / expo 上报，事件流里也就看不到。修正坐标格式后重新扫描即可。
下一步
- DevTools 扩展：面板的工作原理、构建加载、典型调试场景。
- 行为埋点：坐标规则与命令式 API。
- 远程配置：采样 / killSwitch / 错误分级——决定哪些事件能走到上报。
- 排查：没有上报：自上而下的定位路径。