Stroq: AI 编程代理的本地安全审计与防护栏

概述

Stroq 是一个本地安全平台,旨在审计和保护 AI 编程代理,包括 Claude Code、Cursor 和 Codex CLI。它通过跟踪代理基于已读取内容执行的命令来提供行为可见性,同时监控敏感凭据的意外泄露。该工具完全在本地运行,无遥测功能,仅需 Node.js 22 或更高版本。

核心功能

Stroq 既可作为事后审计工具,也可作为实时防护栏系统。

审计过往会话

用户可以使用 stroq replay 和 stroq sent 命令分析过去 30 天的代理活动。这些工具会解析本地会话记录以识别:

  • 密钥泄露: 如果凭据(如 AWS 密钥或 API 令牌)可能被发送到外部服务或暴露给 AI 模型,它会进行标记。它会明确显示密钥名称,同时掩盖实际值。
  • 来源追踪: 它将命令追溯到代理之前读取的特定文件或文本,帮助用户理解代理为何决定执行特定操作。

实时防护栏

通过运行 npx @stroq/cli init,用户可以安装在工具调用执行前进行拦截的钩子。这些钩子:

  • 拒绝诸如 curl | sh 之类的风险模式。
  • 阻止包含已知密钥的出站网络调用。
  • 当命令重复代理之前读取的文本时,提示用户进行确认。

安全与隐私

Stroq 强调隐私优先的架构。它不会将数据发送到外部服务器,不需要账户,也不使用遥测。所有分析均在本地机器上执行,控制台界面运行在 127.0.0.1 上。该工具旨在作为代理操作的过滤器,而非完整的沙箱,并且它依赖于钩子,其能力因所使用的特定代理和版本而异。

社区反馈与未来方向

围绕该项目的讨论突显了进一步开发的潜在途径,包括:

  • eBPF 集成: 一些用户建议转向基于 eBPF 的后端,通过在内核级别捕获对抗性场景来提高安全覆盖范围,尽管这将使该工具仅限于 Linux 环境。
  • 守护进程监控: 有人建议开发一个后台守护进程,通过菜单栏应用程序提供实时警报,从而允许对标记的代理操作进行即时编辑或管理。

"你可以通过 eBPF 后端覆盖更多的对抗性场景。它需要 Linux,但考虑到目前所有的补丁,你本就应该在虚拟机中进行所有开发工作。" — @maven29

入门指南

Stroq 通过 npm 分发。主要命令包括:

  • npx @stroq/cli:显示近期代理会话的摘要卡片。
  • npx @stroq/cli init:将安全钩子安装到你的代理配置中。
  • npx @stroq/cli console:启动本地 Web 界面以管理规则并查看会话历史记录。
  • npx @stroq/cli attack:在沙箱环境中运行一套 36 种已知攻击模式,以测试当前策略的有效性。

Sources