From 41d279d6b66a36defd99fb92c9a889fa4465a4e5 Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 11 Jul 2026 22:29:39 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=99=BB=E8=AE=B0=E8=AF=8A=E6=96=AD=20?= =?UTF-8?q?trace=20observer=20effect?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/MDTODO/agentrun-runtime-reliability.md | 4 ++++ .../agentrun-runtime-reliability/R2.4_Task_Report.md | 7 +++++++ 2 files changed, 11 insertions(+) create mode 100644 docs/MDTODO/details/agentrun-runtime-reliability/R2.4_Task_Report.md diff --git a/docs/MDTODO/agentrun-runtime-reliability.md b/docs/MDTODO/agentrun-runtime-reliability.md index 472cfabd..9e3e271b 100644 --- a/docs/MDTODO/agentrun-runtime-reliability.md +++ b/docs/MDTODO/agentrun-runtime-reliability.md @@ -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)。 diff --git a/docs/MDTODO/details/agentrun-runtime-reliability/R2.4_Task_Report.md b/docs/MDTODO/details/agentrun-runtime-reliability/R2.4_Task_Report.md new file mode 100644 index 00000000..27faf380 --- /dev/null +++ b/docs/MDTODO/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 补洞处理。