hashgraph-online/hol-guard

HOL Guard – AI代理的开源防病毒软件

简介 – 基于 Python 的本地优先安全层，在 AI 代理（例如 Codex、Claude Code、GitHub Copilot CLI、Gemini CLI 等）运行 shell 命令、访问文件、安装包或调用外部工具之前对其进行监控。它会标记秘密泄露、破坏性操作、提示注入尝试和供应链风险，然后允许您允许、阻止或请求批准。

安装

pipx install hol-guard      # 在隔离环境中安装 CLI
hol-guard init             # 运行发现代理并配置保护的向导

您可以使用 hol-guard --version 检查版本，并通过 hol-guard update 更新。

核心功能

领域	HOL Guard 的功能
Shell / 文件访问	扫描命令和文件读取中的破坏性模式、凭据泄露和可疑的对外调用。
包安装	拦截 pip、npm 等，并在允许安装之前与供应链情报数据库进行核对。
插件、技能、代理配置	盘点本地插件，并在代理启动之前审查任何新增或更改的工具。
MCP 服务器和工具	检查 MCP 服务器配置，并通过受管挂钩代理工具调用。
提示和工具结果	检测提示注入并过滤代理生成的文本中的敏感内容。
批准和证据	将风险操作路由到原生提示或仪表板，并记录收据以供日后审计。

典型工作流程

# 查看当前保护状态
hol-guard status

# 诊断特定代理集成
hol-guard doctor codex

# 预览不执行会发生什么
hol-guard diff codex

# 处理待处理的批准请求
hol-guard approvals            # 列出
hol-guard approvals approve <id>

# 查看决策历史
hol-guard receipts

干运行（hol-guard run codex --dry-run）在不实际启动代理的情况下记录工件状态，可用于安全检查。

支持的代理 – Codex、Claude Code、GitHub Copilot CLI、Cursor、Cline、Gemini CLI、Grok、Hermes、Kimi Code、Pi、oh‑my‑pi、OpenClaw、OpenCode、Antigravity、ZCode、Devin 和 Paseo（通过原生提供商适配器）。README 中提供了详细的支持矩阵链接。

插件扫描器 – 同一仓库还附带 plugin‑scanner，这是一个供插件/技能作者和 CI 流水线使用的 CLI。它可以：

• scan 扫描安全问题，
• lint 提供规则级作者反馈，
• verify 验证安装时的就绪状态，
• submit 提交打包好的工件以进行市场提交，
• doctor 收集诊断信息。 它支持多种生态系统（Codex、Claude Code、DeepSeek Harness、Gemini CLI、Kimi Code、OpenCode），并输出 text、json、markdown 或 sarif 格式以供 CI 集成。现成的 GitHub Action（hashgraph-online/ai-plugin-scanner-action）可让您按最低分数控制 PR。

可选 Guard Cloud – SaaS 附加组件（非必需），可同步批准历史记录、在团队间共享策略，并提供车队级管理。

重要性 – 随着 AI 代理能够运行任意命令和安装依赖项，它们成为新的攻击面。HOL Guard 为这些代理提供了熟悉的“防病毒”体验，在保持机器安全的同时，仍然允许 AI 增强工具带来的生产力优势。

链接

• 文档： https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md
• PyPI 包： hol-guard 和 plugin-scanner
• 仪表板和云： https://hol.org/guard/activate
• GitHub 仓库： https://github.com/hashgraph-online/hol-guard