项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1080
使用教程
环境要求
- Python 3.10 或更高版本
- 已安装 pipx(用于隔离安装命令行工具)
- 与平台匹配的原生运行时(Windows ARM64 等平台需先查阅官方平台支持说明)
- 可选:与 Claude Code、Codex、Cursor、Gemini CLI 等智能体客户端集成
安装与启动步骤
-
1安装 pipx
hol-guard 通过 pipx 安装,先确认本机已有 pipx;已安装可跳过此步。
python -m pip install --user pipx python -m pipx ensurepath -
2安装 hol-guard
用 pipx 安装 hol-guard 到独立环境,避免污染系统 Python 依赖。
pipx install hol-guard -
3运行首次配置向导
向导会自动发现受支持的智能体并引导完成防护配置,每项改动前都会询问确认。
hol-guard init -
4检查安装结果
查看版本号确认安装成功,再查看运行状态确认防护层已生效。
hol-guard --version hol-guard status -
5检查并打包插件
如需分发插件,可用 Plugin Kit 校验源目录并生成各运行时可直接加载的副本,全程本地执行。
hol-guard plugin check hol-guard plugin package -
6后续升级
需要更新已安装版本时执行自带更新命令,无需重新安装。
hol-guard update
如何确认成功
执行 hol-guard --version 能输出版本号,且 hol-guard status 正常显示当前防护运行状态。
常见问题
Q:提示找不到 hol-guard 命令怎么办?
A:多为 pipx 的可执行目录未加入 PATH。执行 python -m pipx ensurepath 后重开终端再试。
Q:Python 版本不够会怎样?
A:项目要求 Python 3.10 或更新版本,低版本会导致安装失败,请先升级 Python 再安装。
Q:首次运行会擅自修改配置吗?
A:不会。init 向导在打开仪表盘、安装智能体集成、连接可选云服务等每项改动前都会先询问。
Q:必须注册账号才能用吗?
A:不需要。可在本地无账号运行,使用命令行和本地仪表盘管理防护、处理审批与查看决策历史。
Q:在 Windows ARM64 上安装失败怎么办?
A:需先阅读官方 get-started 文档中的平台支持与 Windows ARM64 配置说明,按说明准备匹配的原生运行时。
注意事项
- 本地优先运行,插件打包与校验命令只读取指定目录,不发起网络请求。
- 可选云端功能仅用于共享历史、团队策略与设备管理,本地使用无需开启。
- 升级前建议查看官方发布说明,了解版本变更与升级注意事项。
- hol-guard 处于早期阶段,接口与命令可能随版本调整,以官方文档为准。
核心亮点
- 运行时实时拦截,不依赖事后审计,直接阻断高风险工具调用和提示注入
- 覆盖多种攻击面:工具、秘密、包、MCP 服务器、插件,防护全面
- 与主流 AI 编程助手(Claude Code、Cursor 等)无缝集成,易用性高
不足之处
- 早期项目,文档和社区生态尚待完善
- 运行时拦截可能带来性能开销,需评估对代理响应速度的影响
适用场景
- 企业内使用 AI 编程助手时,防止敏感数据泄露和恶意指令注入
- 开发基于 MCP 或插件架构的 AI 应用,加固供应链安全
- DevSecOps 流程中,对 AI 代理行为进行合规审计和风险控制
替代项目
Rebuff、Prompt Guard、Lasso Security
同类项目推荐
Awesome-Jailbreak-on-LLMs
开源
一站式掌握LLM越狱攻击最新研究,快速上手安全测试
Awesome-Jailbreak-on-LLMs is a collection of state-of-the-art, novel, exciting jailb···
evals
开源
配置驱动的 Agent 评测,批量跑完直接看结果
Fast, robust, configurable agent evals
MMStar
开源
更公平地测出大模型真实视觉能力,避免作弊分
[NeurIPS 2024] This repo contains evaluation code for the paper "Are We on the Right···
AdvUnlearn
开源
对抗训练让概念擦除更抗攻击,生成更安全
Official implementation of NeurIPS'24 paper "Defensive Unlearning with Adversarial T···
AlignLLMHumanSurvey
开源
一张图看懂大模型如何对齐人类偏好
Aligning Large Language Models with Human: A Survey
matharena
开源
用最新数学竞赛题测大模型真实推理水平
Evaluation of LLMs on latest math competitions
WindowsAgentArena
开源
在真实 Windows 环境中,一键测试和对比 AI 智能体的任务完成能力。
Windows Agent Arena (WAA) is a scalable OS platform for testing and benchmarking of···
Awesome-LLMs-for-Vulnerability-D···
开源
一站式追踪LLM漏洞检测前沿论文与数据集
The community's most comprehensive, continuously-updated index of research on Large ···
evaluation-guidebook
开源
学透 LLM 评估,避开 benchmark 陷阱,科学选模型。
Sharing both practical insights and theoretical knowledge about LLM evaluation that ···
