Hooks 配置
- 项目级别:
{项目路径}/.hcode/settings.json - 用户级别:
~/.hcode/settings.json
Matcher
当前 Hook 支持 Matcher,用于匹配工具名称或 Subagent 名称。匹配规则如下:
- 单一匹配:匹配单个属性,例如
"Edit"。 - 多个匹配:使用竖线
|分隔多个属性,例如"Edit|Write"。 - 通配符匹配:使用
*进行通配匹配,例如"mcp__memory__.*"、"mcp__.*__write.*"、"mcp__.*__write.*|Edit"。
可用的 Hooks
- Stop - 主 Agent 对话结束时触发
- SubagentStop - Subagent 对话结束时触发
- SubagentStart - Subagent 开始执行前触发
- PostToolUse - 工具成功执行后触发
- PostToolUseFailure - 工具执行失败时触发
- SessionStart - 会话启动时触发
- SessionEnd - 会话终止时触发