@alexanderfortin/pi-freestyle-sandbox
在云端沙箱中安全运行子代理的Pi扩展
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@alexanderfortin/pi-freestyle-sandbox。 它的用途是:在云端沙箱中安全运行子代理的Pi扩展 完整的 Skill 内容见:https://321skill.com/skills/alexanderfortin-pi-freestyle-sandbox/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我创建一个隔离沙箱,在云端虚拟机中运行一个Python脚本,分析这个GitHub仓库的代码结构,完成后自动清理。',它会自动创建Freestyle云VM,克隆指定仓库,运行子代理执行分析任务,任务完成后自动销毁虚拟机,并返回分析结果。
介绍
这个Skill解决了在Pi编码代理中运行不可信或高风险任务时的安全和隔离问题。在日常开发中,当你需要让子代理执行代码、访问外部资源或操作敏感数据时,往往担心会影响本地环境或泄露信息。该扩展通过Freestyle云VM提供完全隔离的执行环境,确保子代理无法访问你的本地机器,从而保护开发环境安全。
使用方式很简单,你只需要配置一个有效的FREESTYLE_API_KEY环境变量,然后通过pi install npm:@alexanderfortin/pi-freestyle-sandbox安装。之后就可以通过自然语言指令来创建沙箱子代理,例如:‘帮我在隔离沙箱中分析这个开源项目的代码,然后返回报告’。系统会自动将项目上下文(如AGENTS.md)注入子代理,任务完成后VM自动销毁。你还可以通过/freestyle list查看活跃VM,用/freestyle cleanup清理所有跟踪的VM。
它非常适合需要安全执行第三方代码、测试敏感操作、或进行安全审计的团队和个人。尤其是那些已经使用Pi作为编码助手,但担心子代理权限过大导致安全风险的开发者。此外,对于需要频繁运行网络爬虫、处理私有仓库代码或运行临时脚本的场景,这个扩展能显著降低安全风险。
建议在首次使用时耐心等待Docker快照创建(约几分钟),后续调用会复用快照,速度会快很多。需要注意的是,它主要依赖Freestyle云服务,需要稳定的网络连接,并且免费API密钥有配额限制。如果任务涉及敏感数据,建议在VM内使用GITHUB_TOKEN进行私有仓库认证,避免将密钥暴露在本地环境。
常见问题
如何获取FREESTYLE_API_KEY?
访问 https://dash.freestyle.sh/ 免费注册即可获取API密钥。
第一次运行很慢,正常吗?
正常。首次运行需要创建Docker快照,后续调用会复用,速度会快很多。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/alexanderfortin-pi-freestyle-sandbox/raw/index.md 读取 @alexanderfortin/pi-freestyle-sandbox 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/alexanderfortin-pi-freestyle-sandbox/raw/index.md(查看排版版本)