superhq-ai/shuru

解决的问题

Shuru 为 AI 代理提供了一个安全、隔离的环境来执行代码、安装包并运行工具，而不会危及主机的安全性或稳定性。它通过提供每次运行后都会重置的短暂、可抛弃式 microVM，解决了“弄脏”本地系统的问题。

运作原理

它在 macOS 上使用 Apple 的 Virtualization.framework，并在 Linux (ARM64) 上使用 KVM 后端来启动轻量级 Linux VM。该系统使用 tmpfs 覆盖层来处理客体写入，默认保持主机不受影响，并支持用于目录挂载的 VirtioFS。它包含一个用于密钥管理的代理，确保真实的 API 密钥永远不会进入 VM 客体。

目标用户

正在构建 AI 代理（使用 Claude Code、Cursor 或 Copilot 等工具）的开发者，他们需要一种安全、程序化的方式，让代理在受控环境中执行代码。

特色亮点

• 短暂沙盒 (Ephemeral Sandboxes)：每次运行都是一次性的；根文件系统会自动重置。
• 检查点 (Checkpoints)：保存并重复使用磁盘状态，避免每次都重新安装依赖项。
• 安全密钥 (Secure Secrets)：API 密钥在 HTTPS 请求时由代理替换，将真实密钥保留在主机上。
• 网络控制 (Network Control)：对网络访问进行细粒度控制，包括主机特定的允许列表。
• TypeScript SDK：通过 Node.js/Bun 包对沙盒进行程序化控制。
• 端口转发 (Port Forwarding)：通过 vsock 将客体服务暴露给主机，无需完整的网络访问权限。