Agent Skills
返回列表
🔒

PluginGuard 插件安检工具

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3cdbf8ea/plugin-guard。

技能介绍

要解决的问题

往 Hermes 里装第三方插件/skill 时，风险往往藏得很深：一个看起来人畜无害的 SKILL.md，背后可能写着改 ~/.hermes/config.yaml、偷读 os.environ 里的 API key、用 importlib 动态导入绕过检查，甚至把数据 requests.post 到外部服务器。多数用户装之前并不会逐行审代码，等配置被篡改、密钥外泄再补救，为时已晚。PluginGuard 的目标就是把这个「装前审查」环节自动化。

它如何工作

PluginGuard 是纯 Python 标准库实现的只读扫描工具，无需 pip install 任何依赖，支持 Windows/Linux/macOS，扫描脚本大小写不敏感。它接受两种输入：

  • 本地目录：直接扫描插件目录
  • GitHub 仓库链接：先 git clone 到临时目录再扫描，结束后自动清理

扫描分三层：

  1. 功能分析：解析 SKILL.md 提取元信息，统计调用了哪些 Hermes 工具、文件操作范围和网络请求，并用一句话总结插件用途
  2. 安全检测：覆盖 11 类风险项，按分值加权——写主配置、改 model/provider/api_key、importlib 动态导入、字符串拼接构造函数名各 25 分；os.system/subprocess、网络外发数据、读环境变量并外发、越权写其他目录各 15 分；eval/exec/compile 5 分；base64 混淆、敏感日志各 2 分
  3. 风险评分：输出 0–100 分和四级结论——🟢 安全（0–20）、🟡 需注意（21–50）、🟠 高风险（51–80）、🔴 危险（81–100）

报告分三大区块：功能分析、安全评估（五项检测清单 + 风险项明细）、结论。🟢 可装，🟡/🟠 需人工审核，🔴 禁止安装。

能判断「值不值得装」

安全之外，PluginGuard 还内置一套实用性评估框架，回答「这插件对我有用吗」：功能是否冗余（现有方案能否覆盖）、token/成本开销、项目体量是否匹配、技术栈场景是否对口（如 TKinter/Python 桌面/小程序）、整合代价是否大于价值。五个维度任一否决，就建议不装。

适用边界

  • 工具自身只读不改，扫描过程零副作用
  • 扫 GitHub 链接依赖系统已装 git
  • 静态分析无法覆盖运行时才拼接的行为，评分是风险信号而非绝对判定，🟡 及以上仍需人工复核

使用场景

  • 从GitHub或本地目录安装第三方Hermes插件前，扫描插件目录确认无篡改配置或外泄API密钥的风险，并输出风险等级。
  • 手头只有一个单文件小项目，不确定是否值得接入第三方Hermes插件，需结合功能与项目体量判断其安装价值。
  • 团队协作开发Hermes插件，需审查代码中是否存在危险系统调用、网络外联等违规行为。
  • 定期维护Hermes环境，批量检查历史安装的插件是否新增敏感操作或越权写文件的行为。

适合人员

  • 负责维护Hermes环境的开发者，希望安装第三方插件前先确认其不会篡改配置或窃取密钥。
  • 喜欢尝试新插件的Hermes使用者，需要先评估插件的安全性和实用性再决定是否安装。
  • 管理团队Hermes配置的运维人员，需要统一扫描外部插件以确保其符合安全规范。