PairOnce

paironce

通过终端，使用 PairOnce 将文件和文本发送到你自己的手机或电脑。输入六位数代码配对一次；之后，运行 npx paironce send report.pdf 即可将文件发送到手机。端到端加密；网络允许时在设备之间直接传输，不允许时则通过加密中继传输。无需账户。

npx paironce pair                 # shows a code: type it at paironce.com on your phone
npx paironce send build.zip       # sends to the paired device
npx paironce text "https://example.com/some/long/link"
npx paironce receive --to ./inbox # receives files sent from the phone

另一台设备可以是打开了 https://paironce.com 的任意浏览器：iPhone、Android、Windows、Mac 或 Linux。无需在那台设备上安装任何东西。

命令

命令	功能
paironce pair	显示六位数代码。在另一台设备上打开 paironce.com，选择 Enter a code 并输入代码。两个屏幕会显示相同的安全码；在终端中批准该设备。
paironce pair 123456	使用另一台设备显示的代码加入，适用于使用此终端的人。
paironce send <file>...	将文件发送到已配对的设备。若有多个已配对设备，请添加 --to "<name>"。另一台设备会在每个文件到达前先确认接收。
paironce text "<message>"	发送消息或链接。
paironce receive	将文件接收到当前文件夹（使用 --to <folder> 指定文件夹）。每个文件都会先询问是否接收；--yes 会在本次运行期间自动接收所有文件。大文件会直接写入磁盘，因此大小不受限制；如果传输中断，再次发送时会从中断处继续。
paironce devices	列出已配对的设备。
paironce forget <name>	忘记已配对的设备。
paironce mcp	作为 MCP 服务运行，供 AI Agent 使用。

--name "<name>"（或 PAIRONCE_NAME 变量）用于设置另一台设备上显示的本设备名称，例如 --name "Build server"。密钥保持不变，因此已配对的设备仍能识别本设备。--agent 会将本设备标记为另一台设备上的 AI Agent（MCP 服务始终会这样标记）。MCP 服务会在最后一次工具调用后保持连接 30 分钟，因此下一个任务无需在你的设备上点按；你可以看到它处于已连接状态，并可在另一台设备上结束连接。MCP 工具会将文件保存在服务运行所在的文件夹中（默认为 inbox）。--ephemeral 会在临时文件夹中使用一次性身份；断开连接一天后，另一台设备便会忘记它：适合即用即弃的沙盒。

当已配对的设备未连接时，命令会请求该设备连接：该设备上的 PairOnce 会显示 "Windows · Terminal wants to reconnect"，并提供 Connect 按钮。

在 AI Agent 中使用（MCP）

paironce mcp 为 Agent 提供十种工具：

工具	功能
pair_device	配对你的其中一台设备。Agent 会给你一个六位数代码；在那台设备上打开 paironce.com，选择 Enter a code 并输入代码。随后，Agent 会告诉你一个安全码，只有在你确认设备上显示的安全码相同后才会继续。每台设备只需配对一次。
send_file、send_text	发送到已配对的设备；你需要在设备上确认接收每个文件。
receive_files	等待你从设备发送文件（白板照片、扫描件、文档），并将其保存到 ./inbox。
request_photo、request_scan、request_file	说明原因并请求特定内容。你的设备会显示请求；你可以在设备上拍照、扫描页面或选择文件，也可以拒绝。内容会保存到 ./inbox。
watch_frames、watch_stop	说明原因并请求查看你的摄像头或屏幕。你可以在设备上共享，也可以拒绝；之后，Agent 每次请求时都会收到一张静态图片（每秒最多两张），并可逐步引导你。你的设备会显示共享状态和停止按钮；任意一方停止后，共享就会结束。
list_devices	列出已配对的设备。

Agent 只能访问你配对并批准的设备，不会有任何内容在未经请求的情况下传到任何地方。你的设备会在请求批准以及已保存的设备列表中将它标记为 Agent。设计和计划： Agent as a Device。

send_file 不会发送隐藏文件和文件夹（例如 .env 或 .ssh）、Windows 的 AppData、Mac 的 Library 或此设备自身的 PairOnce 文件；你仍可使用 paironce send 自行发送这些内容。在 receive_files 仍在等待时收到的文件，或请求停止等待后收到的文件，都会保存到已接受文件的文件夹中，下次调用 receive_files 时会报告该文件。各版本的变更见发行说明。

Claude Code：

claude mcp add paironce -e PAIRONCE_NAME="Claude Code · Agent" -- npx -y paironce mcp
# in a throwaway sandbox: ... -- npx -y paironce mcp --ephemeral
# on Windows, through cmd: claude mcp add paironce -- cmd /c npx -y paironce mcp

其他客户端（Cursor、Claude Desktop 等）的 MCP 配置：

{ "mcpServers": { "paironce": { "command": "npx", "args": ["-y", "paironce", "mcp"], "env": { "PAIRONCE_NAME": "Cursor · Agent" } } } }

然后提出请求：“与我的手机配对”“把构建日志发送到我的手机”，或者让 Agent 向你请求：“我需要一张路由器背面标签的照片”。

工作原理

CLI 运行的连接代码与 paironce.com 相同：配对和加密使用 PairOnce 协议 和 @paironce/core，直接连接使用来自 node-datachannel 的 WebRTC，中继则使用 @roamhq/wrtc（libwebrtc）。文件和消息会在此计算机上加密，并在另一台设备上解密；PairOnce 服务只负责引导两台设备建立连接，并在必要时中继其无法读取的加密字节。

此计算机的设备密钥和已配对设备列表保存在 ~/.paironce（或 $PAIRONCE_HOME）中，仅你可读取。私钥不会离开此计算机。

只要网络允许，就会直接连接；否则会通过加密中继连接，使用端口 443 上的 UDP、TCP 或 TLS；如果这些方式也被阻止，则会通过 PairOnce 隧道连接：使用安全 WebSocket 将相同的加密数据传输到 paironce.com。因此，它可在服务器上运行、可用于阻止 UDP 的容器，也可在 Web 代理之后运行（会自动使用 HTTPS_PROXY）。在具有允许列表的云沙盒中（例如网页版 Claude Code），请将 paironce.com 添加到允许的域名中。PAIRONCE_DEBUG=1 可显示连接的每个步骤。

需要在 Windows、macOS（x64 和 arm64）或 Linux（x64 和 arm64）上运行 Node.js 22 或更高版本。

许可证

Apache-2.0。PairOnce 是其所有者的商标；详见 https://paironce.com。