Auto-sync: 2026-04-23 04:02

wiki/concepts/Hidden-Failure-Paths.md

@@ -0,0 +1,30 @@
+---
+title: "Hidden Failure Paths"
+type: concept
+last_updated: 2026-04-10
+---
+
+## Definition
+Hidden Failure Paths 是指在复杂分布式系统中，故障可能隐藏在多个层面和路径中，单点排查无法发现全部问题来源。
+
+## OpenClaw 中的隐藏路径
+在 OpenClaw 这类分布式 AI Agent 系统中，一个"Context Limit Exceeded"问题可能藏在：
+1. Session 文件（历史对话积累）
+2. Memory plugin（记忆注入量）
+3. Model config（context window 大小）
+4. Routing rules（模型绑定）
+5. Compaction 策略（token 预留量）
+
+## Debugging Strategy
+逐一排除法：按层级逐层排查，每层确认无误后再进入下一层。
+
+## Key Insight
+> **工具/系统越复杂，问题的隐藏路径越深。**
+
+## Related
+- [[Error-Surface-vs-Root-Cause]]: 隐藏路径导致表象与根因分离
+- [[Log-Driven-Debugging]]: 日志是发现隐藏路径的唯一可靠手段
+- [[Layered-Configuration]]: 分层架构本身就产生隐藏路径
+
+## Sources
+- [[养虾日记4-一次「context-limit-exceeded」错误排查-我以为是小问题-结果踩了大坑]]