用途:HOL Guard 在工具执行前保护本地 AI 运行环境(harness),覆盖运行时安全、审批审查、包验证与可审计证据。
主要能力:检测受支持的 harness;通过 Guard 自有流程引导与安装;以 dry-run 试运行;查看审批队列与回执;生成清单、ABOM 与事件等审计证据;可选云同步。支持的 harness 名称包括 codex、claude-code、copilot、cursor、gemini、hermes、openclaw、opencode、antigravity。plugin-scanner 为独立发行包,用于扫描插件、技能与 MCP 配置。
使用方式:先探测 CLI:hol-guard --version、plugin-scanner --version。缺失时建议隔离安装:pipx install hol-guard、pipx install plugin-scanner(注意 hol-guard 发行包不提供 plugin-scanner 命令)。安装后执行 hol-guard status、hol-guard detect --json。保护流程:hol-guard detect --json、hol-guard bootstrap、hol-guard install <harness>、hol-guard run <harness> --dry-run、hol-guard run <harness>、hol-guard doctor <harness> --json、hol-guard status。Hermes 使用 hol-guard hermes bootstrap。审批与证据:hol-guard approvals、hol-guard approvals open <request-id>、hol-guard receipts、hol-guard diff <harness>;终端审批用 hol-guard approvals approve/deny <request-id>;审计用 hol-guard inventory、hol-guard abom --format json、hol-guard events、hol-guard explain <artifact-id>;云同步为可选:hol-guard connect status、hol-guard sync。扫描:plugin-scanner lint <path>、plugin-scanner verify <path>,JSON 证据加 --json。
限制与规则:不得读取 .env 文件;不得绕过 Guard 审批;未经命令证明不得声称工作区受保护;优先使用可逆的 Guard 命令而非手动改配置;扫描失败须视为真实问题;编辑仓库前先查看 git status --short;不要为扫描而执行不可信仓库,应直接扫描其包或仓库文件;仅在阅读风险原因并理解请求范围后才批准。报告时须说明所运行命令、发现内容、仍被阻止或存在风险的部分、已有证据及下一步确切命令。