[!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 记录变更，Heartbeat 负责发现异常。它还谈不上“自治”，但至少能把运行状态和修复线索留下来。

总结 (全系列终)

“手搓 Claw”这一轮主要解决了三个问题：命令有统一入口，任务能按顺序跑，日志和状态能留下来。它不神秘，也不完美，但比只靠一堆聊天记录和临时脚本更容易维护。

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