pikasTech-unidesk/docs/MDTODO/details/observability-trace-reliability/R1.1_Task_Report.md

R1.1 任务报告

结论

• 业务 trace：
  • 只承载原业务执行 span。
• diagnostic trace：
  • 使用独立 traceId；
  • 通过标准 OTLP Span Link 引用目标业务 trace；
  • 保留有界关联字段。
• 禁止路径：
  • 过滤新增 span；
  • 关闭 OTel；
  • 绕过正式 result/events authority；
  • 修改 Kafka/SSE 链路。

固定证据

• 父问题：UniDesk #1801。
• 单步调查：UniDesk #1805。
• AgentRun 实现问题：AgentRun #302。
• 固定 OTel trace：de11d47d1bab0ca4d3f6259279f3a332。
• 一次诊断后：
  • span 总数 375 -> 376；
  • command_result 3 -> 4；
  • 证明诊断读取污染了业务 trace。

实现边界

• AgentRun：
  • 接收 request-scoped diagnostic context；
  • 生成独立 diagnostic trace；
  • 为 result/events 等读取 span 写入标准 link/correlation。
• UniDesk：
  • 生成并注入 diagnostic context；
  • 展示关联与重复诊断不变性。
• 保持项：
  • 普通产品读取维持现有业务语义；
  • 纯 Kafka + SSE 实时与刷新路径不变。