[!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：

  1. 日志脱敏提取：抓取最后 200 行错误上下文。
  2. 根因分析：AI 判断是环境依赖（如 pip 缺失）还是逻辑 Bug。
  3. 自主修复：尝试 subprocess 安装缺失包或提交代码修正。
  4. 服务重启：自动执行 systemctl restart (Linux) 或进程重启。

4. 架构主权：心法与地图的融合

最终，VISAGENT 形成了一个闭环的操作主权。通过 sovereignty.py 约束权限，通过 metabolism 记录演进。Agent 不再是一个一次性的工具，而是一个在文件系统中不断“呼吸”、自我调节的数字生命。

总结 (全系列终)

“手搓 Claw”不仅仅是为了好玩，更是为了掌握 AI 原生时代的 主动权。通过封装 CLI、设计 DAG 工作流、构建多模态感知和引入数字代谢，我们证明了：不需要庞杂的框架，只要架构清晰，每个人都可以构建出深度定制、稳定且自进化的私有 Agent。

感谢关注这个系列，手搓快乐！