docs: 登记诊断 trace observer effect

2026-07-11 22:29:39 +02:00
parent 67e9d49b49
commit 41d279d6b6
2 changed files with 11 additions and 0 deletions
@@ -33,3 +33,7 @@
 ### R2.3

 由主代理完成架构 diff review、定向 CLI 验收、PR 合并与 issue 收口；只接受局部诊断/可见性修改，rollout 不适用，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.3_Task_Report.md)。
+
+### R2.4 [completed]
+
+登记 [UniDesk #1801](https://github.com/pikasTech/unidesk/issues/1801)：diagnose 的 command/result 读取会向同一业务 trace 补记 command_result span，使重复读取改变 instrumentation completeness；该问题涉及 trace context 与诊断证据隔离，本轮按架构变更边界跳过，完成任务后将详细报告写入[任务报告](./details/agentrun-runtime-reliability/R2.4_Task_Report.md)。
@@ -0,0 +1,7 @@
+# R2.4 任务报告
+
+[UniDesk #1801](https://github.com/pikasTech/unidesk/issues/1801) 已登记并保持 open。
+
+固定 warm-session trace 的验收表明，diagnose-code-agent 读取既有 command-specific result 时会产生 command_result OTel span，并写入同一业务 trace，使首次读取的 missing-command-terminal-span 在再次读取时变为 complete。
+
+该问题涉及 trace context propagation、诊断 instrumentation ownership 与原始/诊断证据隔离，属于架构变更。本轮未修改代码或运行面，也未通过过滤、第二事实源或 Kafka/SSE 补洞处理。