📄️ Agent Hook 系统对比
范围：对比 LangChain v1 Middleware、LangChain 旧版 Callback、Pi 三层 Hook、Kameo Actor 监督钩子、Kosong 事 件订阅等 Agent 框架的"扩展点"机制，分析各家的能力边界与设计取舍
📄️ LangChain Callback 系统架构
范围：拆解 LangChain 0.x BaseCallbackHandler 的事件模型、on_* 钩子协议、CallbackManager 的多 handler 编排，以及它与 LangChain v1 AgentMiddleware 的演进关系
📄️ LangChain Middleware vs Pi 执行管线对比
范围：对比 LangChain v1 AgentMiddleware 系统与 Pi 的多层执行管线（Agent Loop 回调 + AgentEvent + Harness/Extension Hook），分析 Middleware 模式在 Pi 中的等价实现
📄️ Pi Agent 三层 Hook 系统架构
范围：拆解 Pi（pi-mono）Agent Loop 内三层 Hook 系统的分层职责——AgentLoopConfig 生命周期回调、AgentEvent 事件流订阅、Harness/Extension 层的 HookEvent + ExtensionRunner 拦截器，并画出它们与对应外部系统的等价关系