执行前安全闸 hashgraph-online/hol-guard-plugin

HOL Guard 插件

skills.sh

HOL Guard 是 hol-guard 提供的本地 AI 安全层，本仓库是它的 Codex 与 DeepSeek Harness 插件。

HOL Guard 在工具运行之前保护本地 AI harness。它能检查 Codex、Claude Code、Copilot CLI、Cursor、DeepSeek Harness、Gemini、Hermes、OpenClaw、OpenCode 和 Antigravity 这些界面，再把有风险的改动交给本地审批与回执处理。

在 DeepSeek Harness 中安装

先安装 HOL Guard：

pipx install hol-guard
hol-guard status

给你用到的每个 DSH 配置档添加插件：

dsh plugin --profile headless add github:hashgraph-online/hol-guard-plugin
dsh plugin --profile web add github:hashgraph-online/hol-guard-plugin

确认组装后的配置档里包含 hol-guard-plugin：

dsh --profile headless --dump-config

也可以让 HOL Guard 把它托管的本地副本装进检测到的 DSH 配置档：

hol-guard install dsh

DSH 强制执行约定

插件同时使用 DSH 的两层策略，不只依赖一个可被重排的监听器：

1. tools/pre-execute 执行有界的异步 HOL Guard 审查。
2. Guard 给出 ask、review、require-reapproval 结果时，如果 DSH 原生的一次性审批服务已挂载，就使用该服务。
3. 解析出的决定锁定到这次具体的 DSH 执行上。
4. 派发之前，ctx.tools.guard() 把锁定结果作为单调的最终拒绝边界强制执行。

Guard 命令缺失、超时、响应格式错误、审批被拒或不可用、结果为 sandbox-required、审查未完成，或者另一个插件让 pre-execute 瀑布流短路——这些情况一律按失败关闭处理，阻止工具运行。普通 pre-execute 监听器无法强行放行 HOL Guard 的拒绝。

排序规则、失败矩阵、信任属性和明确的限制，见 DeepSeek Harness 安全边界。

安装安全技能

用开放的 Skills 命令行安装可移植的 plugin-scanner 技能：

npx skills add hashgraph-online/hol-guard-plugin --skill plugin-scanner

Skills 命令行支持多种编码智能体。安装独立的 plugin-scanner 包之前，技能会先征求你的同意；它绝不会为了扫描而执行仓库里的代码。

本插件新增的内容

- 一个原生 DSH 包，包含异步 Guard 审查、原生一次性审批，以及派发前的单调拒绝守卫。
- 一个公开的 Codex 技能，位于 skills/hol-guard/SKILL.md。
- 一个可移植的安全技能，位于 skills/plugin-scanner/SKILL.md。
- 为 Codex、Claude Code、Copilot CLI、Cursor、DeepSeek Harness、Gemini、Hermes、OpenClaw、OpenCode 和 Antigravity 提供防护配置指引。
- 为 Codex 插件、Claude Code 项目界面、技能、MCP 服务器和 marketplace 包提供扫描指引。
- 提供辅助脚本，覆盖常见的 hol-guard 和 plugin-scanner 工作流。
- 校验 Codex manifest、DSH bundle、技能资源、脚本路径和 .mcp.json。

MCP 服务器

本插件包含 .mcp.json，用于注册 HOL Guard 本地 MCP 服务器（guard-mcp.v1）。服务器直接通过 hol-guard 二进制运行，无需包管理器启动，也没有 shell 包装层。

前置条件

- 已安装 hol-guard 命令行，且位于 PATH 中（最低版本：2.0.1024）
- Python >= 3.10

工具

| 工具 | 输入 | 返回 |
| search | {query: string} | 最多 20 条脱敏结果，来自本地回执与清单 |
| fetch | {id: string} | 单条回执或清单项，脱敏文本最大 32 KiB |
| get_guard_status | {} | 命令行可用性、回执数量、清单数量 |

所有工具都返回 guard-mcp.v1 契约信封，包含 contractVersion、source: local、generatedAt 和 freshness: real-time。

本地与云端

- 本地（hol-guard mcp serve --stdio）：离线读取本地 Guard 数据，无需网络访问。
- 云端（门户上的 /api/guard/mcp）：读取已同步的工作区数据。需要 OAuth Bearer token，且具备 guard:workspace.read 和 guard:receipt.read 权限范围。

安装

pipx install hol-guard
hol-guard status

兼容 MCP 的客户端会自动发现 .mcp.json，无需额外配置。

在本地安装 HOL Guard

推荐方式：

pipx install hol-guard

备选方式：

python3 -m pip install --user hol-guard

验证：

hol-guard status
hol-guard detect --json

在 Codex 中使用

在 Codex 中安装本插件，然后输入：

Use HOL Guard to protect this workspace before running agent tools.

或者：

Use HOL Guard to scan this plugin before release.

本地辅助脚本

bash scripts/hol-guard-plugin status
bash scripts/hol-guard-plugin harnesses
bash scripts/hol-guard-plugin protect claude-code
bash scripts/hol-guard-plugin protect codex
bash scripts/hol-guard-plugin protect dsh
bash scripts/hol-guard-plugin scan-system claude .
bash scripts/hol-guard-plugin scan-system codex .
bash scripts/hol-guard-plugin scan .
bash scripts/hol-guard-plugin evidence

辅助脚本不读取 .env 文件，只调用各自上游发行版已暴露的 hol-guard 和 plugin-scanner 命令。

支持的 harness 系统

| 系统 | 辅助命令 | 防护命令 |
| Codex | bash scripts/hol-guard-plugin protect codex | hol-guard install codex |
| Claude Code | bash scripts/hol-guard-plugin protect claude-code | hol-guard install claude-code |
| Copilot CLI | bash scripts/hol-guard-plugin protect copilot | hol-guard install copilot |
| Cursor | bash scripts/hol-guard-plugin protect cursor | hol-guard install cursor |
| DeepSeek Harness | bash scripts/hol-guard-plugin protect dsh | hol-guard install dsh |
| Gemini CLI | bash scripts/hol-guard-plugin protect gemini | hol-guard install gemini |
| Hermes | bash scripts/hol-guard-plugin protect hermes | hol-guard hermes bootstrap |
| OpenClaw | bash scripts/hol-guard-plugin protect openclaw | hol-guard install openclaw |
| OpenCode | bash scripts/hol-guard-plugin protect opencode | hol-guard install opencode |
| Antigravity | bash scripts/hol-guard-plugin protect antigravity | hol-guard install antigravity |

验证

npm test

仓库还会跑一次真实的 DSH 无头会话，连到本地一个兼容 OpenAI 的模拟推理端点。对照组会话执行一次 bash 工具调用，受保护会话则证明 HOL Guard 的原生 DSH 网关会拦下同一次调用：

npm run test:dsh-e2e

端到端测试不需要任何服务商密钥。

源项目

- 插件仓库：https://github.com/hashgraph-online/hol-guard-plugin
- Guard 与扫描器源码：https://github.com/hashgraph-online/hol-guard
- DeepSeek Harness 源码：https://github.com/deepseek-ai/deepseek-harness
- HOL Guard 产品：https://hol.org/guard
- 插件安全数据集：https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security

目录评分快照（约 205 个已评分插件）、按 Guard 运行时建模的测试夹具，以及公开安全公告。扫描 ≠ 安全保证。目录里的插件数量不是 Registry Broker 的智能体目录。这些数据由 HOL 发布，并非独立验证。不要把 Hashgraph Online 整个组织在 GitHub 上的 star 数算到这个插件仓库头上。