@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 格式),按其中说明在我的环境里完成安装和配置。