权限自动分发机（PVM）

面向 AI Agent 的多通道权限审批系统。

将敏感操作（如文件删除、Git 强制推送等）置于人工审批环节之后。支持通过 iMessage/SMS、电子邮件、Discord、Telegram 或 Slack 发送通知，并在执行危险命令前强制验证权限授予状态。

适用场景

当 AI Agent 需执行可能具有破坏性的操作时，请使用本系统：

• 删除文件或目录
• 向 Git 仓库执行强制推送（force-push）
• 将文件移至 Agent 工作区（workspace）之外的回收站

快速配置

# 1. 安装
git clone https://github.com/tylerdotai/permission-vending-machine.git
cd permission-vending-machine
pip install -e .

# 2. 配置
cp config.example.yaml config.yaml
# 编辑 config.yaml，填入您的 API 密钥

# 3. 启动守护进程（macOS）
launchctl load ~/Library/LaunchAgents/ai.flume.pvm.plist

# 4. Agent 发起权限请求
pvm request --scope "/tmp/build" --reason "cleaning artifacts" --duration 5

# 5. 审批人通过 iMessage、电子邮件或 Discord 链接完成审批

# 6. Agent 执行受保护命令
safe-rm -rf /tmp/build

工作原理

Agent → pvm request → Vault（待审批状态） → 向所有启用通道发送通知
                                                ↓
                 审批人可通过任意通道完成审批
                                                ↓
                 创建授权 → Agent 解除阻塞 → 执行 safe-* 命令

审批方式

配置说明

config.yaml 中的关键配置项：

channels:
  sendblue:        # macOS 专用 — 通过 CLI 使用 iMessage
    enabled: true
    from_number: "+1..."
    approver_numbers: ["+1..."]
  email:           # 跨平台支持
    enabled: true
    imap_host: "imap.example.com"
    username: "user"
    password: "pass"
  discord:         # 跨平台支持
    enabled: true
    webhook_url: "https://discord.com/api/webhooks/..."
    http_approval_base: "http://your-server:7823"

CLI 命令

pvm request --scope  --reason  --duration   # 发起审批请求
pvm status --agent-id                                     # 查看当前有效授权列表
pvm revoke --grant-id                                     # 提前撤销某项授权
pvm log --limit 50                                           # 查看审计日志（最近 50 条）
pvm serve --port 7823                                         # 启动 HTTP 服务
pvm approve-daemon --port 7823                               # 启动完整守护进程

封装命令（Wrappers）

在受保护命令前添加 safe- 前缀：

• safe-rm -rf /path — 检查路径范围（scope）授权
• safe-git-push --force — 检查仓库范围（repo scope）授权
• safe-trash /path — 检查路径范围（scope）授权

平台支持

• macOS：支持 launchd 服务；Sendblue iMessage 功能可用
• Linux：支持 systemd 服务；推荐使用 Discord / 电子邮件 / Telegram 进行审批
• Windows：支持 NSSM 或任务计划程序（Task Scheduler）；推荐使用 Discord / 电子邮件 / Telegram 进行审批

详细平台配置请参阅 docs/PLATFORMS.md。

相关链接

• 代码仓库：https://github.com/tylerdotai/permission-vending-machine
• 文档：PLATFORMS.md · ARCHITECTURE.md