@nqbao/pi-sandbox
为AI编程助手提供操作系统级代码沙箱隔离
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@nqbao/pi-sandbox。 它的用途是：为AI编程助手提供操作系统级代码沙箱隔离 完整的 Skill 内容见：https://321skill.com/skills/nqbao-pi-sandbox/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请用沙箱安全地运行这段Python代码，检查其输出。”，AI会调用此Skill，将代码置于隔离环境中执行，并返回结果，同时确保你的主系统文件不被意外修改或访问。
介绍
该Skill旨在解决AI编程助手（如Pi）在本地执行用户代码时可能带来的安全风险。它通过调用操作系统级别的沙箱工具（macOS的sandbox-exec和Linux的bubblewrap），为代码执行创建一个内核强制的隔离环境，防止恶意或意外代码对宿主系统造成损害。
使用时，需要将此Skill集成到AI编程助手的后端或执行流程中。当用户请求执行代码时，AI助手会调用此工具，将代码放入一个严格限制的沙箱环境中运行，从而控制其对文件系统、网络和系统资源的访问权限。
它主要适合需要集成AI代码执行能力的开发者、AI Agent框架的维护者，以及对本地代码执行安全性有较高要求的项目团队。
使用建议是，在部署前务必根据具体业务场景仔细配置沙箱的权限策略（如允许访问的目录、网络权限等），以达到安全与功能之间的平衡。注意，它依赖于宿主操作系统的特定工具，在Windows上可能无法直接使用。
核心特点
核心区别在于直接利用操作系统内核（macOS sandbox-exec / Linux bubblewrap）进行强制隔离，而非应用层模拟，提供了更底层、更严格的执行环境安全保障。
注意事项
不适合需要在沙箱内进行复杂图形界面操作或深度系统集成的场景。
常见问题
这个沙箱支持Windows吗？
目前主要支持macOS和Linux，Windows支持有限或需要其他方案。
如何配置沙箱的权限？
需要通过配置文件或参数来定义允许的文件访问路径、网络权限等规则。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/nqbao-pi-sandbox/raw/index.md 读取 @nqbao/pi-sandbox 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/nqbao-pi-sandbox/raw/index.md（查看排版版本）