Vigil — 代理安全护栏

校验 AI 代理实际执行（DO）的操作，而非其声称（SAY）将执行的内容。可即插即用的安全层，适用于任意支持工具调用的代理。

前提条件

本能力依赖 vigil-agent-safety npm 包（12.3KB，Apache 2.0 许可证）：

npm install vigil-agent-safety

• 源代码： https://github.com/hexitlabs/vigil
• npm 页面： https://www.npmjs.com/package/vigil-agent-safety
• 该 npm 包无任何运行时依赖。 本能力仅为对该包的封装调用。

快速开始

import { checkAction } from 'vigil-agent-safety';

const result = checkAction({
  agent: 'my-agent',
  tool: 'exec',
  params: { command: 'rm -rf /' },
});

// result.decision === "BLOCK"
// result.reason === "Destructive command pattern"
// result.latencyMs === 0.3

检测范围

• 破坏性命令（如 rm -rf、mkfs、反向 Shell）→ BLOCK
• 服务器端请求伪造（SSRF，如访问元数据端点、localhost、内网 IP）→ BLOCK
• 数据外泄（如通过 curl 发送至外部地址、读取 .ssh/id_rsa）→ BLOCK
• SQL 注入（如 DROP TABLE、UNION SELECT）→ BLOCK
• 路径遍历（如 ../../../etc/shadow）→ BLOCK
• 提示词注入（如忽略指令、含 [INST] 标签）→ BLOCK
• 编码攻击（如 base64 解码、eval(atob())）→ BLOCK
• 凭据泄露（如 API Keys、AWS Keys、Tokens）→ ESCALATE

共 22 条规则；零依赖；单次检查耗时低于 2ms。

运行模式

import { configure } from 'vigil-agent-safety';

// warn = 记录违规行为但不拦截（推荐初始启用）
configure({ mode: 'warn' });

// enforce = 拦截高危调用
configure({ mode: 'enforce' });

// log = 仅静默记录（不输出警告或拦截）
configure({ mode: 'log' });

与 Clawdbot 集成

将 Vigil 作为代理工具调用的安全层。借助 scripts/vigil-check.js 封装脚本，即可在命令行中完成校验：

# 校验一次工具调用
node scripts/vigil-check.js exec '{"command":"rm -rf /"}'
# → BLOCK: Destructive command pattern

# 校验一次安全调用
node scripts/vigil-check.js read '{"path":"./README.md"}'
# → ALLOW

策略配置

加载内置策略模板：

import { loadPolicy } from 'vigil-agent-safety';

loadPolicy('restrictive');  // 最严格规则
loadPolicy('moderate');     // 平衡型（默认）
loadPolicy('permissive');   // 最小化拦截

CLI 工具

npx vigil-agent-safety check --tool exec --params '{"command":"ls -la"}'
npx vigil-agent-safety policies

相关链接

• GitHub：https://github.com/hexitlabs/vigil
• npm：https://www.npmjs.com/package/vigil-agent-safety
• 文档：https://hexitlabs.com/vigil