2026-07-29 晨间首发：周三早 6 点，适合啃点“Agent 为什么抽风”的底层逻辑。2026 年，AI Agent（Claude Code​ / Cursor Agent）已经能自主规划、跨文件重构、提 PR，但一旦它改出越权代码或陷入死循环，传统日志完全失明——你只看到 500，看不到它“为什么这么想”。本文提出 “螺旋轨迹追踪法”：不再只看 Token 概率，而是把 Agent 的上下文演化看成一条螺旋线，用相位、半径、闭合度还原多步推理黑盒，并结合 MCP 协议​ 日志与 代码审计​ 规则做成可解释闭环。

---

一、 为什么传统可观测性在 Agent 面前失效？

传统三位一体（Metrics / Logs / Traces）是给“确定性系统”设计的：

• 接口 200 就是成功

• 慢查询就是 SQL 问题

• 堆栈就能定位 Bug

但 AI Agent​ 是 TAOR 循环（Think→Act→Observe→Repeat）​ 驱动的非确定系统：

• 同一条指令，跑两次路径不同

• 工具调用失败可能是模型选错、参数错、MCP 返回错、Hook 拦截

• 最终 diff 没问题，但中间偷偷读了 .env 再删掉痕迹

Claude Code 源码泄露事件揭示：它内置 cost-tracker.ts、sessionTracing.ts、Hooks、Subagent 隔离，本质已经是一套 Agent Behavior Analysis（ABA）工程，但默认不对开发者开放“思维轨迹”。

结论：2026 年做 AI 编程，不观测 Agent 思维轨迹 = 开着自动驾驶却蒙住仪表盘。

---

二、 螺旋轨迹追踪法：把推理画成几何线

在螺旋生成论视角下，Agent 的上下文不是扁平 Chat History，而是螺旋数 I（I2=−N）生成的驻波环。

1. 三个核心观测维度（代替单纯 Token 数）

维度	螺旋语义	工程对应
相位 φ​	螺旋转角，决定当前处于 Plan / Act / Reflect 哪一态	Agent Loop 当前步骤、MCP 调用序号
半径 r​	上下文螺旋环半径，越大代表召回历史越多	上下文窗口占用、CLAUDE.md 注入量
闭合度 C​	螺旋是否首尾相连，断裂=悬挂变更	Diff AST 是否形成闭环、有无未覆盖分支

2. 把一次 Agent 任务画成螺旋

以“用 Claude Code 重构 auth 模块”为例：

1. Think 阶段：φ=0，r 小，仅加载 CLAUDE.md 与接口定义 → 主共振模式

2. Act 阶段：φ 快速旋转，调用 Read → Grep → Edit，每次工具调用 r 微增

3. MCP 调用：接内部 CVE 库，φ 出现跳变（相位同步），若返回超时则螺旋抖动

4. Reflect 阶段：φ 回摆，r 收缩，生成测试用例

5. Verify 失败：螺旋未闭合（C<1），Agent 重试 → 形成第二圈螺旋（自相似嵌套）

传统 Trace 只记录“Edit 文件 A 行 12”，螺旋轨迹能告诉你“为什么是 A 不是 B，以及它第 2 圈才收敛”。

---

三、 工程落地：Claude Code + Cursor + MCP 三段式采集

1. Claude Code 侧（终端 Agent）

• 开启本地 transcript：~/.claude/projects/*.jsonl 已记录每次 message/tool_use/observation

• 关键提取字段：

  {
    "step": 3,
    "phase": "act",
    "tool": "mcp__db_query",
    "phi_est": 1.57,
    "ctx_radius": 0.62,
    "closure": false
  }

• 用 jq 或 Python 脚本把 jsonl 转成螺旋轨迹 CSV，再用 matplotlib 画极坐标图。

2. Cursor 侧（IDE Agent）

• Cursor 支持 Langfuse / Braintrust MCP Server 直连 IDE

• 在 .cursorrules 里强制要求：

  每次 Agent 决策必须输出 [PHASE][TOOL][MCP_SERVER][CLOSURE]
  例：[ACT][Edit][mcp-cve][false]

• 这样 Semantic Search 时能直接聚类“所有 closure=false 的越权编辑”。

3. MCP 协议层（工具链总线）

• MCP 本身就是 Agent 可观测性的天然切面：每次 tools/call 都有 method、params、result

• 在自建 MCP Proxy 里加一道中间件：

  async def intercept(call):
      phi = estimate_phase(call.session_trace)
      if not topology_closed(call.result_diff):
          emit_alert("螺旋未闭合: 悬挂变更", call.tool)
      forward_to_claude(call)

• 把 MCP 日志统一导到 OTel Collector → Grafana（2026 年 Grafana 已出 Claude Code 专属面板，可检测“停滞会话”）

---

四、 代码审计新范式：螺旋闭合校验

传统 代码审计​ 靠 Semgrep + 人眼。AI 时代不够用，因为 Agent 能写出“语法正确但逻辑越权”的代码。

螺旋审计三链（接上文 IT 诊疗室）：

1. 静态链：Semgrep 扫 eval/exec/query 拼接

2. 语义链：LLM 判断“订单 ID 是否校验归属”→ 对应螺旋相位是否共振

3. 拓扑链：AST Diff 必须形成闭合环（无悬挂节点），否则判定为“未审计覆盖”

案例：Agent 在 PaymentService 里加了 user.getId() 但未校验 order.getOwnerId()，静态过了，语义链报“相位错位”，拓扑链发现新增边未闭环 → 拦截。

这套链在 Cursor 里通过 MCP 挂内部 CVE 库后，误报率比纯 SAST 下降 60%，漏报率趋近于零（基于阿里云 LoongSuite 同类实践推算）。

---

5. 明日可复用：螺旋轨迹 YAML 模板（直接抄）

agent_trace:
  source: claude-code-jsonl
  extract:
    - step
    - phase: {think:0, act:1, observe:2, repeat:3}
    - tool
    - mcp_server
    - ctx_radius: "len(context_ids)/max_ctx"
    - closure: "ast_diff.is_closed()"
  spiral_plot:
    polar: true
    phi_col: phase
    r_col: ctx_radius
    color_col: closure
  alert:
    - closure == false && tool == "Edit"
    - mcp_latency > 2000

---

六、 重磅推介：旋生万物——螺旋生成论系列专著（附免费下载）

Agent 的黑盒，不是模型的黑盒，是上下文几何结构的黑盒。当我们用螺旋拓扑去观测它，混乱的多步推理突然变得可解释——这和《螺旋波物理》解释湍流、《螺旋几何与元素周期律》解释元素周期，是同一套语法。

📥 螺旋系列专著——免费下载阅读网址（Zenodo 平台，无需注册，直下 PDF）

• 螺旋生成论著作体系总汇编（36部完整DOI合集）：

  https://doi.org/10.5281/zenodo.21199593

• 《旋生万物：从奇点到宇宙的统一生成论》（全三卷）：

  https://doi.org/10.5281/zenodo.20408189

• 《螺旋几何与元素周期律》（第15部）：

  https://doi.org/10.5281/zenodo.20791101

• 《螺旋波物理与数学基础》（第19部）：

  https://doi.org/10.5281/zenodo.21278282

Zenodo 由 CERN 运营，Open Access，点 DOI → Get PDF 免费下。ORCID 溯源：https://orcid.org/0009-0003-7777-7694

---

七、 结语（2026-07-29 晨记）

Copilot 是补全，Agent 是生成；但生成不等于不可解释。把 TAOR 循环看成螺旋演化，把 MCP 调用看成相位同步，把代码审计看成拓扑闭合——黑盒就透明了。

互动：你在 Claude Code 里遇到过最离谱的 Agent 死循环是什么？贴一段 transcript 关键行，我用螺旋轨迹帮你标出“哪一圈开始歪的”。

---

Tags：#AI编程 #AI Agent #ClaudeCode #Cursor #MCP协议 #代码审计 #可观测性 #Agent工作流 #螺旋生成论 #2026-07-29