TangJia025 · Oct 29, 2026 · Oct 28, 2026 · Oct 28, 2026 · Oct 28, 2026 · Oct 28, 2026
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,3 @@
+{
+    "java.configuration.updateBuildConfiguration": "interactive"
+}
diff --git a/docs/CI workflow可观测一期执行清单.md b/docs/CI workflow可观测一期执行清单.md
diff --git a/docs/CI workflow可观测技术设计.md b/docs/CI workflow可观测技术设计.md
diff --git a/docs/CI可观测目标.md b/docs/CI可观测目标.md
@@ -1,7 +1,7 @@
 # CI 可观测目标：从问题发现到根因分析与故障自愈
 
 本文定义 CI 可观测要达成的目标，以及为达成目标需要建设的能力。具体指标、组件与实现细节见
-[可观测接入指南](可观测接入指南.md) 第 5 章，本文只回答三个问题：**目标是什么、路线是否成熟、每一步的前置条件是什么**。
+[CI workflow 可观测技术设计](CI%20workflow可观测技术设计.md)，本文只回答三个问题：**目标是什么、路线是否成熟、每一步的前置条件是什么**。
 
 ## 1. 目标与边界
 
@@ -34,7 +34,7 @@ L2 与 L3 都建立在三期之上——**没有 run 身份，根因分析只能
 | L4 故障自愈 | 低～中 | 无标准。共识是 K8s operator 控制回路 + 动作白名单 + shadow/审批/熔断 |
 | L5 效果评估 | 低 | MTTD / MTTR / 自愈成功率 / 误判率，各家都在用，口径不统一 |
 
-**一条硬约束**：`cicd.pipeline.run.id` 用作 metrics 标签会造成高基数，OTel 语义约定本身就要求必须 opt-in。这与指南 5.4.1「`run_id` / `head_sha` 禁止做标签」一致——**run 身份走日志、事件与 resource attribute，不走指标标签**。
+**一条硬约束**：`cicd.pipeline.run.id` 用作 metrics 标签会造成高基数，OTel 语义约定本身就要求必须 opt-in。这与技术设计 4.1「`run_id` / `head_sha` 禁止做标签」一致——**run 身份走日志、事件与 resource attribute，不走指标标签**。
 
 ## 3. 参考架构
 
@@ -172,7 +172,7 @@ L0 语义         统一身份与字段：run_id / job_id / platform / repo / wo
 - **CI 失败的主体是代码与测试**，基础设施类只占少数。目标定的应是「把基础设施类故障的发现与恢复做快」，而不是「让所有失败都能自愈」。
 - **自愈可能掩盖故障**：自动重跑会让真实回归变成间歇失败。因此重跑必须限次，且「重跑后仍失败」与「重跑后成功」要分开计数。
 - **GitCode 侧能力不完整**：没有 EphemeralRunner 与 ghalistener，L2 之后的分析在一期只能覆盖 GitHub 半边，接入前需实测其 API 能提供的事件粒度。
-- **单点与静默失效**：aggregator 单副本、凭据过期会让采集静默归零。自监控告警必须先于 RCA 上线（见指南 5.2.3）。
+- **单点与静默失效**：aggregator 单副本、凭据过期会让采集静默归零。自监控告警必须先于 RCA 上线（见技术设计 2.3）。
 - **不要先上 LLM**：没有签名库与拓扑关联时，模型只会给出无法验证的解释。
 
 ## 8. 待决事项