【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载HOL Guard 插件扫描器 plugin-scanner是开源项目 HOL Guard 随仓库发布的命令行安全扫描工具专为 AI agent 的插件、skills、MCP 集成提供发布前的安全与质量检查。它通过scan、lint、verify三大命令帮你一键找出硬编码密钥、危险 MCP 命令、危险审批默认值等风险。本教程面向新手带你在 5 分钟内跑通完整扫描流程。什么是 plugin-scannerAI agent 插件安全扫描工具HOL Guard 定位为“AI agent 的开源杀毒软件”在 AI 执行 shell 命令、文件访问、包安装、MCP 工具调用之前进行审查。而plugin-scanner是其中的“发布前体检器”覆盖以下检查面检查类别覆盖内容Manifest 校验必填字段、版本、声明路径、接口元数据、链接与资源安全硬编码密钥、不安全的 MCP 命令/传输协议、危险审批默认值运维安全GitHub Actions 权限、依赖锁文件、Dependabot、特权 checkout打包规范README、License、skill frontmatter、误提交的.env文件Marketplace清单有效性、本地包发现、安全 source 路径代码质量动态代码执行、shell 注入模式它支持自动识别 Codex、Claude Code、DeepSeek Harness、Gemini CLI、Kimi Code、OpenCode 等多种生态的插件包格式。一键安装 plugin-scanner 并确认版本安装只需两条命令要求 Python 3.10 和 pipxpipx install plugin-scanner plugin-scanner --version命令入口定义见 pyproject.tomlplugin-scanner、plugin-guard等可执行名都指向同一个 CLI 主程序 cli.py。 小贴士如果不知道仓库支持哪些生态先运行plugin-scanner --list-ecosystems列出全部受支持的插件生态。命令一scan 全量安全扫描输出质量评分scan是核心命令对整个插件目录执行“加权全量扫描”输出安全发现项findings加质量评分报告。最常用的 scan 参数参数作用--format text/json/markdown/sarif选择报告格式SARIF 便于接入 CI--fail-on-severity high出现 high 及以上发现即失败适合门禁--min-score 80最低质量分门禁--ecosystem claude显式指定生态默认auto自动检测--profile public-marketplace切换策略画像default / public-marketplace / strict-security-o report.json输出到文件典型用法# 快速体检 plugin-scanner scan . # 结构化安全报告发布前推荐 plugin-scanner scan ./my-plugin --format json --profile public-marketplace # CI 门禁high 级别发现直接失败 plugin-scanner scan . --fail-on-severity highscan 的评分引擎与检查模块位于 scanner.py具体检查实现分布在 checks/ 目录例如安全类检查 checks/security.py。scan 会查出哪些典型问题规则注册表 rules/registry.py 中定义了完整规则集常见的高价值规则包括HARDCODED_SECRET—— 发现硬编码密钥/凭据DANGEROUS_MCP_COMMAND—— MCP 服务器配置了危险命令MCP_REMOTE_URL_INSECURE—— 远程 MCP 地址未走安全传输RISKY_APPROVAL_DEFAULT—— 危险的工具审批默认值SHELL_INJECTION_PATTERN—— shell 注入风险模式GITHUB_ACTIONS_WRITE_ALL—— Actions 配置了过宽权限命令二lint 规则级编写检查支持自动修复lint面向“作者视角”给出规则级rule-level的编写反馈比 scan 更偏写作规范与可修复建议# 查看所有可用规则 plugin-scanner lint ./my-plugin --list-rules # 查看某条规则的详细解释 plugin-scanner lint ./my-plugin --explain README_MISSING # 自动应用机械式修复strict-security 画像更严格 plugin-scanner lint ./my-plugin --fix --profile strict-security常用规则 ID 示例README_MISSING缺 README、LICENSE_MISSING缺 License、ENV_FILE_COMMITTED误提交 .env、SKILL_FRONTMATTER_INVALIDskill frontmatter 格式错误、DEPENDENCY_LOCKFILE_MISSING缺依赖锁文件。可自动修复的能力由 lint_fixes.py 提供--fix只会应用它明确支持的机械式修复不会改动语义内容。命令三verify 运行时验证确认发布就绪verify执行安装面install-surface与运行时就绪检查回答的问题是“这个包真的能被安装和运行吗”# 离线验证默认最快 plugin-scanner verify ./my-plugin # 允许发起真实网络探测如远程 MCP 端点可达性 plugin-scanner verify ./my-plugin --online --format jsonverify会检查清单文件、marketplace 配置、MCP 的 HTTP 远程地址与 stdio 服务器配置、skills、apps 及 assets 等目录。核心实现见 verification.py 的verify_plugin入口。⚠️ 注意--online会向声明的远程端点发起真实探测请在可信网络环境下使用。scan、lint、verify 三大命令对比速查维度scanlintverify定位安全发现 质量评分规则级编写反馈安装面/运行时就绪典型场景CI 门禁、发布体检本地开发修问题上线前最终确认报告格式text / json / markdown / sariftext / jsontext / json特色参数--fail-on-severity、--min-score--list-rules、--explain、--fix--online建议顺序先跑再修最后确认推荐的日常工作流scan定位安全风险 →lint --fix快速修复规范问题 →verify确认发布就绪。进阶接入 GitHub Actions 与多生态扫描官方 Action 源码在 action/可通过min_score、fail_on_severity等输入项实现 CI 门禁。多生态仓库可显式指定生态plugin-scanner scan ./plugins-repo --ecosystem claude plugin-scanner scan ./dsh-plugin --ecosystem deepseek-harness除三大命令外还有两个辅助命令submitscanverifypolicy 全过后生成提交产物与doctor组件级诊断定义见 cli.py。新手常见问题 FAQQ1scan 报分低应该先修什么先看--fail-on-severity high能否通过high/critical 发现如HARDCODED_SECRET务必先修质量分其次。Q2lint 和 scan 都会报问题有什么区别lint 偏“写法规范”大多可--fix一键修复scan 偏“安全与评分”产出 findings 与质量等级是 CI 门禁的主力。Q3仓库里同时有多种生态插件怎么办用默认--ecosystem auto让扫描器自动发现Codex marketplace 根目录下的本地插件条目会被自动识别。Q4报告想接入缺陷平台使用plugin-scanner scan . --format sarif --output plugin-scanner.sarif输出 SARIF 文件即可。参考资料插件扫描器章节README.mdCLI 命令定义cli.py扫描引擎scanner.py运行时验证verification.py规则规格模型rules/specs.py安全规则说明docs/rules/信任评分参考docs/trust/赞分享【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载相关推荐10 分钟把自定义词库接进 Qwerty Learner当天就能打字练起来10 分钟把自定义词库接进 Qwerty Learner当天就能打字练起来 你手上有一份自己的单词表——可能是考研重点、某个编程领域的 API、或者客户项目的前端教育桌面应用Firebase APK 安全扫描实战scan-apk 命令与 firebase-apk-scanner 自动化审计工作流Firebase APK 安全扫描实战scan apk 命令与 firebase apk scanner 自动化审计工作流 scan apk 是 firebaAI 技能/插件人工智能应用安全静态分析SAST漏洞扫描WhisperLiveKit 快速上手跑通实时转录与说话人识别的 4 个步骤WhisperLiveKit 快速上手跑通实时转录与说话人识别的 4 个步骤 WhisperLiveKit 是一个自托管的实时语音识别服务音频通过 WebS人工智能语音模型推理服务本地部署上一篇掌握Adobe Downloader高效获取Adobe全家桶的macOS专业工具下一篇Vimium安全审计全面解析代码安全性与漏洞防范措施创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考