附录A：配置速查表
Hook类型速查
| Hook类型 | 触发时机 | 输入格式 | 输出格式 | 可阻止 | 重要 |
|---|---|---|---|---|---|
| UserPromptSubmit | 用户输入后 | JSON | 文本（注入上下文） | V | |
| Notification | 通知发送时 | JSON | 无 | X | |
| SessionStart | 会话开始 | 无 | 无 | X | |
| SessionEnd | 会话结束 | 无 | 无 | X | |
| Stop | AI停止 | JSON | 无 | X | |
| SubagentStart 🆕 | 子代理启动 | JSON | 无 | X | |
| SubagentStop 🆕 | 子代理停止 | JSON | 无 | X | |
| PermissionRequest 🆕 | 权限请求 | JSON | JSON决策 | V | |
| PreCompact 🆕 | 上下文压缩前 | JSON | 无 | X | |
| ConfigChange 🆕 | 配置变更 | JSON | 无 | X | |
| TeammateIdle 🆕 | 队友空闲 | JSON | 无 | X | |
| WorktreeCreate | 工作树创建 | JSON | 无 | X | |
| WorktreeRemove | 工作树删除 | JSON | 无 | X | |
| StopFailure 🆕 | API异常停止 | JSON | 无 | X | |
| PostCompact 🆕 | 上下文压缩后 | JSON | 无 | X | |
| InstructionsLoaded 🆕 | 指令文件加载 | JSON | 无 | X | |
| Elicitation 🆕 | MCP请求输入 | JSON | 无 | X | |
| ElicitationResult 🆕 | MCP输入完成 | JSON | 无 | X |
常用工具名速查
| 工具名 | 功能 | 常用Hook | 重要 |
|---|---|---|---|
| Edit | 编辑文件 | PostToolUse备份 | |
| Read | 读取文件 | PreToolUse权限控制 | |
| Glob | 文件搜索 | - | |
| Grep | 内容搜索 | - | |
| WebSearch | 网络搜索 | - |
Decision值速查
PreToolUse 新版API（hookSpecificOutput.permissionDecision，推荐）：
| 值 | 含义 | 工具执行 | 重要 |
|---|---|---|---|
"ask" | 暂停，询问用户 | ? | |
| 无输出 | 默认允许 | V |
PreToolUse 旧版 API：decision 字段仍可兼容旧脚本，映射关系沿用前文“旧版决策值”表；新脚本优先写新版字段。
PostToolUse / UserPromptSubmit：
| 值 | 含义 |
|---|---|
"block" | 阻止/提供反馈 |
| 无输出 | 默认允许 |