代谢 on Square Uncle

手搓龙虾系列 (4)：数字代谢与架构自治 —— Agent 的自愈之路

Fri, 20 Mar 2026 11:00:00 +0800

[!TIP] 目标：实现“零侵入”的架构文档同步与 AI 自驱动的系统修复闭环。

1. 零侵入代谢 (Metabolic Governance)

在手搓 Agent 的过程中，维护 ARCHITECTURE.md 和路由表通常是开发者的噩梦。我们的方案是 Metadata-Free 的“新陈代谢”机制：

感知变更：挂载于 Git 钩子，通过 Git Diff 捕获代码变动。
语义推演：AI 自动分析代码意图，更新机器可读的 .anti_bot_map.md (RAG 路由表) 和人类可读的 ARCHITECTURE.md (架构心法)。
强一致性：彻底消除人工维护文档的成本，文档即代码，代码即地图。

2. 系统的脉搏：Heartbeat 引擎

为了保证 Agent 在无人值守下的稳定性，我们配置了独立的 Heartbeat 进程。它不负责“思考”，只负责定期检查几个容易出问题的状态：

def probe_heartbeat_checklist():
    """让 AI 定期审计自己的运行状态"""
    with open(HEARTBEAT_FILE, "r") as f:
        content = f.read()
    if "[ ]" in content: # 发现待办或异常
        engine = RoleEngine("heartbeat")
        # 触发 AI 进行自我诊断并更新状态
        result = engine.invoke(f"Audit this checklist:\n{content}")

3. 自愈闭环：Self-Repair Agent

当 Heartbeat 探测到网关假死或日志中出现 Traceback 时，会瞬间唤醒 Self-Repair Agent：