术语表(小白必读)
在开始之前,先了解这些关键术语。用生活类比帮助理解:
| 术语 | 英文全称 | 通俗解释 | 生活类比 |
|---|---|---|---|
| Hook | - | 在特定事件发生时自动执行的脚本 | 汽车传感器(检测到碰撞自动弹安全气囊) |
| PreToolUse | Pre Tool Use | 工具调用前触发的Hook | 机场安检门(登机前检查) |
| PostToolUse | Post Tool Use | 工具调用后触发的Hook | 快递签收后的自动通知 |
| UserPromptSubmit | User Prompt Submit | 用户输入提交时触发的Hook | 邮件发送前的拼写检查 |
| Notification | - | 通知事件触发的Hook | 手机APP推送通知 |
| SessionStart | Session Start | 会话开始时触发的Hook | 开机自动启动程序 |
| SessionEnd | Session End | 会话结束时触发的Hook | 关机前自动保存 |
| Stop | - | AI停止响应时触发的Hook | 紧急刹车后的状态保存 |
| WorktreeCreate 🆕 | Worktree Create | 工作树创建时触发的Hook | 新开一个平行工作台时的初始化 |
| WorktreeRemove 🆕 | Worktree Remove | 工作树删除时触发的Hook | 关闭平行工作台时的清理 |
| Matcher | - | 匹配规则,决定Hook对哪些工具生效 | 筛选器(只检查特定行李) |
| Decision | - | PreToolUse Hook的返回决策 | 安检结果(放行/拦截/询问) |
| stdin | Standard Input | 标准输入,Hook接收数据的方式 | 传送带送入检查口 |
| stdout | Standard Output | 标准输出,Hook返回结果的方式 | 检查结果显示屏 |
| stderr | Standard Error | 标准错误输出,仅用于调试日志(不会显示在Claude Code界面) | 后台监控日志(用户看不到) |
| timeout | - | 超时时间,Hook最长运行时间 | 限时检查(超时自动放行) |
| JSON | JavaScript Object Notation | 一种通用的数据格式,用花括号\{\}组织数据,settings.json配置文件就是JSON格式 | 标准化的表格模板 |
~(波浪号) | Home Directory | 用户的"家目录",macOS是/Users/用户名,Linux是/home/用户名,Windows对应C:\Users\用户名 | 你电脑上"我的文档"的上级目录 |