技能介绍

问题在哪

Agent 有算力、记忆和上下文，但要把文件交给真人、另一台机器或下游管道时，往往只能绕一圈：上传对象存储、发临时链接，或让人手动拷盘。Perkoon 把这件事收成 WebRTC 点对点传输，从设计上就按机器可读输出组织——JSON 事件流、结构化退出码，以及不依赖浏览器 UI 的状态机。

技能在做什么

本技能围绕 Perkoon 的四种接入方式说明如何完成传收：

MCP Server：在 Claude Code、Cursor 等宿主里直接调用 send_file、receive_file、check_session，无需自己拼 shell。
CLI：有终端时用固定版本 perkoon，--json 解析 session_created、transfer_complete 等事件；发送后要等到完成或失败再向用户汇报。
A2A Protocol：只能发 HTTP、不能跑 shell 时，对 https://perkoon.com/a2a 做 JSON-RPC，用 sender_key 加入已有会话。
浏览器自动化：Playwright/Puppeteer 走完整 UI，适合必须目视确认的流程。

典型路径包括 Agent → Human（分享 share_url，对方浏览器即可下载）、Agent → Agent（会话码 + sender key 对发）、Agent → Pipeline（receive 输出到 stdout，不落盘）。传输本身免费、加密；敏感文件应加 --password，否则持有链接者均可下载。

边界与注意

两端需同时在线；创建/加入会话有 按 IP 的速率限制，频繁失败且快速 exit_code: 3 时应退避重试。发送前必须与用户确认路径，勿从 ~/.ssh、~/.gnupg 等目录擅自发包。自动化时始终用 --json，发送侧建议较长 --timeout，接收侧注意 --overwrite；传输过程中不要中途杀进程。

截图预览

使用场景

在 Cursor 或 Claude Code 中，Agent 需把本地构建产物或日志发给客户，对方用浏览器打开 share_url 下载，接收端无需安装 Perkoon。
两台仅有终端的 Agent 通过 A2A 或 CLI 的会话码与 sender_key 互传数据集或配置文件，实现 Agent → Agent 闭环。
流水线 Agent 用 `receive CODE --json --output -` 将收到的文件流式 pipe 给下游解析命令，避免中间落盘。
只能发起 HTTP 请求、无法执行 shell 的网页 Agent，调用 A2A 创建发送会话并把 sender_url 交给真人完成浏览器侧上传。