Permission Modes Skill

本技能定义了 pi 的三种权限模式，以及对应的安全备份机制。

权限模式总览

安全备份机制

在 所有模式 下，write 和 edit 操作在执行前会自动备份目标文件：

• 备份位置: ~/.pi/agent/backups/
• 备份命名: <文件路径>.<时间戳>-<随机ID>.bak
• 最大保留: 200 个最新备份（自动淘汰最旧的）
• 保留期限: 30 天
• 文件大小限制: 超过 10MB 的文件不备份

备份命令

Auto 模式分类规则

危险操作（会弹窗确认）

# 文件删除
rm -rf / rm --recursive

# 权限提升
sudo

# 权限修改
chmod 777 / chown 777

# 磁盘操作
dd / mkfs / fdisk / parted / mkswap

# 远程下载并执行
curl | bash / wget | sh

# 系统用户管理
passwd / useradd / usermod

# 进程管理
killall / pkill

# 系统重启/关机
systemctl reboot / systemctl poweroff

# 包卸载
apt-get remove/purge / pip uninstall / npm uninstall

# Git 破坏性操作
git push --force / git reset --hard / git clean -fd

# 修改系统配置
> /etc/  / mv ... /etc/  / rm /etc/

状态变更操作（auto 模式会弹窗确认）

# 包安装
git/npm/pip/apt install

# 发布操作
npm publish/unpublish / gh pr merge

# Git 推送
git push

# Docker 构建/推送
docker build/push/tag/rmi/system prune

# HTTP 写操作
curl -X POST/PUT/DELETE/PATCH

敏感文件（auto 模式下修改这些会弹窗确认）

• .env / .env.* — 环境变量/密钥
• .pem / .key — 证书/私钥
• id_rsa / id_ed25519 — SSH 密钥
• credentials.json — 凭证文件
• secrets.* — 机密文件
• .htpasswd / .pgpass — 密码文件
• service-account* — 服务账户

LLM 行为指导

在 bypass 模式下

• 你有完全的执行自主权
• 文件在修改前会自动备份，可随时用 /restore 恢复
• 建议：先读取文件了解内容再修改
• 建议：批量操作分步执行，不要一次完成所有修改

在 auto 模式下

• 安全操作自动执行，不需要用户确认
• 危险操作会弹窗，需要在发起前向用户解释
• 在调用危险操作前，先在回复中说明你要做什么

在 default 模式下

• 每次工具调用都会弹窗等待用户批准
• 在发起每次操作前，先向用户解释你要做什么以及为什么
• 如果用户反复拒绝，换一种方法尝试

故障恢复流程

如果 LLM 操作失误导致文件损坏：

1. 运行 /backups --file <路径> 查看该文件的备份
2. 运行 /restore <backup-id> 恢复
3. 如果备份也不理想，可以切换模式到 default 重新操作

注意: 备份机制自动在每次 write/edit 前快照文件，所以即使 bypass 模式翻车了，也能找回修改前的版本。