所有生命周期事件通过 stdin（command 类型）或 POST body（http 类型）接收 JSON 输入。以下字段在所有事件中都存在：
| 字段 | 说明 |
|---|---|
session_id | 当前会话标识符 |
transcript_path | 对话 JSON 文件路径 |
cwd | Hook 被调用时的工作目录 |
hook_event_name | 触发的事件名称 |
permission_mode | 当前权限模式（default / plan / acceptEdits / auto / dontAsk / bypassPermissions） |
在 SubAgent 内部触发时，额外附加两个字段：
| 字段 | 说明 |
|---|---|
agent_id | SubAgent 唯一标识符，用于区分主线程和子代理 |
agent_type | Agent 名称（Explore、Plan、自定义名称等） |
if 字段：Hook 处理器可配置 if 字段，使用权限规则语法做精细过滤（如 "Bash(git *)" 或 "Edit(*.ts)"）。仅在工具事件（PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、PermissionDenied）上评估。与 matcher 的区别：matcher 匹配工具名，if 匹配工具名 + 参数模式。
所有事件都支持以下 JSON 输出字段（exit 0 时生效）：
本页目录
一、一句话摘要二、核心内容公共输入字段与输出控制additionalContext 统一机制matcher 求值规则三档prompt-based Hook 默认配置/hooks 菜单来源标记28 种事件的完整规格SessionStart -- 会话开始Setup -- 会话初始化PreToolUse -- 工具执行前PermissionRequest -- 权限请求PermissionDenied -- 权限被拒绝Stop -- 响应完成PostToolUse -- 工具执行成功后PostToolUseFailure -- 工具执行失败后PostToolBatch -- 批量工具完成后UserPromptExpansion -- 命令路径展开InstructionsLoaded -- 指令文件加载UserPromptSubmit -- 用户提交提示高级处理器机制三、动手试试四、常见问题五、小结