Module trace 

stderr 阶段打点(ACTL_TRACE=1 启用):慢环境归因仪器。

stdout 契约不变(ADR-002)——trace 只进 stderr,禁用时零输出。 用途:慢日把“命令总耗时“分解到引擎阶段(窗口解析/唤醒/树遍历/L4/pattern), 与 envelope 的 duration_ms/wake_ms/waited_ms 构成完整观测面: envelope 字段 = 机器消费的常态数据;trace = 人类诊断的按需旁路。 env 只在进程内读一次(OnceLock,同 timing.rs 纪律)。

Structs

TraceScope

区间计时 guard:let _t = trace::scope("locate.dfs"); 离开作用域自动打点。 未启用时 Drop 内不输出(构造开销一次 Instant,纳秒级)。

Functions

enabled

是否启用(ACTL_TRACE 存在且非 “0”/空，或设置了 ACTL_TRACE_FILE)。

scope

stage

打一个阶段耗时点:[actl-trace] <stage> <ms>ms(未启用时 no-op)。