📄️ Hooks 系统全景：设计哲学与核心价值
从架构视角理解 Claude Code Hook 系统的设计动机、4个核心应用场景，以及 Hook 与 Tool 的根本区别
📄️ Hook 类型全解：types/hooks.ts 数据结构拆解
深入解析 HookCommand、HookMatcher、HookEvent 等核心类型定义，以及 exit code 语义和 JSON 输出协议
📄️ Hook 注册与发现机制深度解读
深入解析 Hook 的 5 大配置来源、发现算法、工具名称 glob 匹配、去重与优先级排序
📄️ Hook 执行引擎与错误处理深度解读
剖析 Hook 的 shell 子进程执行方式、stdin/stdout 数据传递、async 协议、超时处理与错误隔离机制
📄️ sessionHooks.ts：会话级 Hook 的生命周期
深入解析会话级 Hook 的注册、执行、清理机制，以及 FunctionHook 的高性能内存执行模式
📄️ PreToolUse / PostToolUse：拦截工具执行的完整流程
深入解析工具执行前后的 Hook 机制，包括修改工具输入、阻断执行、观察输出的完整实战指南
📄️ SessionStart / Setup：会话初始化 Hook 实战
深入解析会话启动和仓库初始化 Hook 的触发机制、使用场景与完整配置示例
📄️ PreCompact / PostCompact：压缩前后的数据处理
深入解析对话压缩时的 Hook 机制，包括状态保存、自定义压缩指令注入与压缩后恢复
📄️ hooks.json 配置详解：如何编写自定义 Hook
完整的 hooks.json 配置指南，包含 5 个即用示例：日志、安全检查、通知、数据备份与代码质量
📄️ Hook 与权限系统的联动：hooks/toolPermission/ 解析
深入解析 Hook 如何参与权限决策，PermissionContext 的设计，以及用 Hook 实现自定义权限规则