跳到文章正文
Grok 实用教程

Grok Build Hook怎么拦截命令?PreToolUse决策与fail-open检查

按Grok官方Hook协议配置执行前检查,区分显式deny与超时崩溃;使用人工事件样本验证输入和…

Grok Build可在生命周期事件调用命令或HTTP处理器,但只有PreToolUse用于阻断。重要区别是官方明确超时、崩溃和错误输出按fail-open继续,只有明确拒绝才阻止。本文只验证协议,不实际执行危险命令。

第一步:核对配置范围与信任

个人Hook位于~/.grok/hooks的JSON,项目Hook位于项目.grok/hooks,另有Claude和Cursor兼容来源。先盘点并备份,不能只看自己新增的一份。/hooks可检查已加载处理器。

项目Hook需要信任,首次仓库通过/hooks-trust或启动–trust批准时还涉及项目MCP和LSP,不能盲目接受未知项目。处理器是本机执行代码,应先审阅再授权,不将信任当成纯界面设置。

第二步:定义匹配与人工标记

matcher按工具名正则匹配,省略可能匹配全部。首次仅针对Bash和无副作用人工标记,避免为了测试拒绝而实际发起删除命令。Grok事件输入使用toolName、toolInput等字段,不直接沿用Claude脚本字段。

{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":[{"type":"command","command":"python3 /已确认路径/demo-hook.py","timeout":5}]}]}}

第三步:先做离线样本检查

处理器从stdin读取JSON,拒绝时返回decision=deny与reason。以下脚本只拒绝精确人工标记,其他情况正常退出;它不是完整Shell策略,不宣称能防所有危险命令。

import json, sys
data = json.load(sys.stdin)
if data.get("toolInput", {}).get("command") == "DEMO_BLOCK_MARKER":
    print(json.dumps({"decision": "deny", "reason": "人工练习标记被拒绝"}))
    sys.exit(2)

第四步:理解失败不会自动阻断

官方说明退出0允许、退出2拒绝;超时、崩溃或畸形输出会被记录但工具继续。因此需要测试拒绝、允许、超时、脚本错误和坏JSON,而不是只测试一条成功路径。

不能把脚本未输出当成安全检查通过。需要强隔离或失败关闭的业务,应结合权限、沙箱与应用架构设计,不靠提示词要求Hook永不失败。被动事件如PostToolUse输出被忽略,不具备同样阻断能力。

验收矩阵:标记命中明确deny;正常样本不误拒;超时行为符合官方说明;崩溃可发现;配置来源正确;没有真实破坏动作;日志不含凭据;回滚可恢复。

第五步:加载后再验证实际触发

离线样本正确还不等于运行时加载。进入受控练习项目核对/hooks显示、事件匹配和拒绝说明,并确认工具没有执行。没有发生工具调用就不能计作Hook验证通过。

配置修改后重新检查兼容来源和重复处理器,避免一次调用触发多份脚本。结束练习只移除本次条目,保留已有规则。完成标准是实际触发、协议正确、失败行为明确;不把这个示例宣传为完整安全方案。

处理JSON前还要验证顶层和toolInput类型,缺字段或错误类型不应造成无法察觉的崩溃。错误路径要有脱敏可观测记录,并向维护者显示检查未完成;不要在日志中复制完整私人命令参数来换取排错便利。

官方资料

资料核对日期:2026年11月19日。

本文地址:https://www.163264.com/21904