@kky42/pi-sandbox
为Pi提供文件系统感知的沙盒化Bash环境
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@kky42/pi-sandbox。 它的用途是：为Pi提供文件系统感知的沙盒化Bash环境 完整的 Skill 内容见：https://321skill.com/skills/kky42-pi-sandbox/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用沙盒，在`/tmp/myproject`目录下列出所有.js文件并计算行数。’ 它会通过沙盒环境安全地进入该目录，执行`find`和`wc`命令，并将结果返回给您，整个过程不会触及系统其他部分。
介绍
Pi Sandbox 是一个专为 Pi 设计的沙盒扩展，它解决了在AI助手环境中安全、可控地执行Bash命令和系统工具的需求。传统上，AI直接调用系统命令存在潜在风险，而该工具通过创建一个隔离的、文件系统感知的环境，确保操作被限制在指定目录内，防止对宿主系统造成意外影响。
使用时，您需要先安装此npm包。在Pi的对话中，当您需要执行文件操作、运行脚本或使用命令行工具时，可以调用此沙盒扩展。它会接管命令执行过程，在预设的安全边界内运行您的指令，并返回结果。
这个技能非常适合需要在Pi协助下进行本地文件管理、自动化脚本测试、项目构建或依赖安装的开发者、运维人员和高级用户。它特别适合那些希望将Pi作为命令行助手，但又不想完全开放系统权限的场景。
建议在使用前明确您的工作目录和允许的工具列表。请注意，虽然沙盒提供了隔离，但执行恶意代码或对沙盒内文件进行破坏性操作的风险依然存在。建议仅用于可信任务，并定期检查沙盒内的文件状态。
核心特点
与仅提供命令执行接口的通用技能不同，它深度集成了文件系统感知能力，能严格将操作限制在指定工作目录内；同时，它具备工具强制策略，可以精确控制沙盒内可访问的系统命令，安全性更高。
注意事项
不适合需要直接与宿主系统深层交互或访问沙盒外特定硬件设备的场景。
常见问题
这个沙盒能完全防止系统被破坏吗？
不能完全防止，但能通过文件系统隔离和工具限制大幅降低风险。
支持Windows系统吗？
主要面向类Unix环境（如Linux/macOS），Windows支持可能有限。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/kky42-pi-sandbox/raw/index.md 读取 @kky42/pi-sandbox 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/kky42-pi-sandbox/raw/index.md（查看排版版本）