挂在循环上的扩展点 — 像墙壁上的插座一样优雅
主循环是承重墙,结构稳定不动
预先埋好的接口,随时可以接入
插入即生效,拔出不留痕迹
你不需要拆墙重装来加一盏灯。Hook System 让你在不修改核心循环的情况下,
像插电器一样"挂上"新功能。
「挂在循环上,不写进循环里」
这句话是 Hook System 的灵魂。想象一下:如果每次想加日志、加权限检查都要改 Agent Loop 的源代码, 那代码会膨胀成什么样?开闭原则(Open-Closed Principle)告诉我们: 对扩展开放,对修改关闭。
Agent 循环的四个关键节点,每个都是一个 Hook 插座
用户输入后
LLM 处理前
工具调用前
可以拦截/审批
工具执行后
可以记录/修改
循环即将结束
可强制继续
注册表 — 管理所有 Hook 的中央枢纽
Hook 的返回值决定了"继续"还是"拦截"
什么都不返回(或显式返回 None)
返回一个字符串(拦截原因)
从权限检查到自动 git add,看 Hook 如何在真实场景中发挥作用
从零开始创建你自己的 Hook
写一个函数,接收事件相关的参数,返回 None(放行)或字符串(拦截):
选择事件、设置名称和优先级:
触发事件,确认 Hook 行为符合预期:
测试你对 Hook System 的理解
sort(key=lambda h: -h.priority),负号意味着降序——数字越大越靠前。进阶话题,想深入的同学请展开阅读
回顾 Hook System 的核心要点
← 上一模块: 03 Permission System — Hook System 的 PreToolUse 事件是权限系统的天然挂载点。
→ 下一模块: 05 Planning System — 规划系统利用 Hook 监控任务执行进度。