Permission Vending Machine_开发编程 skill-PHP中文网

Permission Vending Machine

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

多渠道审批系统用于管理 AI 代理权限。将敏感操作（如文件删除、git 强制推送）设置为需人工审批，并通过 iMessage 通知。

允许 Vending 机 (PVM)

功能概述

允许 Vending 机 (PVM)是一项面向实际任务的技能，主要用于AI 代理权限的多通道批准系统；将敏感操作( 文件删除、 git 强制推伸等) 置于人类批准者之后；

核心要点

通过 i 通知。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

权限自动分发机（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-* 命令

审批方式

方式	审批方法
iMessage	回复 `APPROVE`（无需提供 token）
Email	在审批邮件中直接回复 `APPROVE`
Discord	点击 “Click to approve” 链接
HTTP	`curl http://host:7823/approve/`

配置说明

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                               # 启动完整守护进程