pi-guard-sandbox
为树莓派AI代理提供轻量级系统级沙箱防护
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-guard-sandbox。 它的用途是：为树莓派AI代理提供轻量级系统级沙箱防护 完整的 Skill 内容见：https://321skill.com/skills/pi-guard-sandbox/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请分析`/var/log/sensor_data.log`并生成报告。” 由于pi-guard-sandbox已将该日志文件所在目录加入工作空间，AI可以正常读取。如果AI试图执行“查看`/root/.bash_history`”的命令，该请求会被沙箱直接阻断并返回错误，从而保护系统隐私。
介绍
pi-guard-sandbox 旨在解决在树莓派等边缘设备上运行AI代理时的安全与隔离问题。当AI代理（如Claude、Cursor）需要访问本地文件系统执行任务时，它可能意外或恶意地读取敏感文件（如SSH密钥、系统配置）或向系统关键路径写入数据，导致安全风险或系统损坏。该工具通过在操作系统层面设置防护层，将代理的读写操作限制在用户允许的工作空间内，从而避免此类问题。
使用方式非常简单。开发者通过npm安装该工具后，可以在启动AI代理进程前，通过简单的命令或API调用，预先定义好允许访问的目录（工作空间）和需要完全屏蔽的敏感路径。之后，该工具会透明地拦截并重定向代理的所有文件系统操作，确保其行为被约束在安全范围内，而无需修改代理本身的代码。
它非常适合在树莓派上部署AI助手进行自动化运维、数据分析或物联网应用开发的开发者、极客和研究人员。这些人需要在资源受限的边缘设备上安全地利用AI能力，但又担心给予AI过高的系统权限会带来风险。
建议在部署前，仔细规划工作空间的范围，确保AI代理完成任务所需的所有资源（如脚本、数据文件）都包含在内。同时，务必将/etc、/home/*/.ssh等包含密码或密钥的目录加入阻止列表。由于它工作在系统调用层，对性能影响极小，但首次配置时建议在测试环境中验证规则是否按预期生效。
核心特点
与依赖Docker等容器技术实现隔离的方案相比，它无需容器运行时开销，直接在OS层面拦截系统调用，更轻量且性能损耗极低；与简单的文件权限管理相比，它提供了动态、进程级别的强制访问控制，能更精确地限制单个AI代理进程的行为。
注意事项
不适合需要完全虚拟化环境或跨网络文件访问的复杂隔离场景。
常见问题
pi-guard-sandbox 和 Docker 有什么区别？
它更轻量，无容器开销，通过拦截系统调用来实现文件访问控制，适合资源有限的树莓派和单进程隔离。
会影响AI代理的正常功能吗？
只要正确配置允许的工作空间，包含代理所需的所有文件，就不会影响其功能，只会阻止它越界访问。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-guard-sandbox/raw/index.md 读取 pi-guard-sandbox 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-guard-sandbox/raw/index.md（查看排版版本）