# 在手机上拿到 agent 生成的截图和文件，也把截图发给它

> Codex、Claude Code 生成的截图、PDF、视频想在手机上打开，手机上的截图想发给 agent？比较 scp、网盘、聊天机器人等办法，说清 BotBus 怎么回传产物、能发几张图、有哪些限制。

Canonical: https://botbus.io/blog/view-agent-screenshots-and-files-on-phone  
Published: 2026-10-29

## 先说结论

人不在电脑前时，coding agent 产出的东西大多是文件：一张页面截图、一份导出的 PDF、一段录屏、一个打包好的 zip。终端里它只会告诉你「已保存到 `docs/report.pdf`」，手机上看不到。反过来，你在手机上截了一张出错的界面，也很难塞进电脑上那个会话里。

[BotBus](https://botbus.io/) 把这两个方向都接上了：手机发起或续聊的任务里，agent 可以用 `botbus share` 把文件和截图主动分享回这条任务；agent 回复里写到的本机图片、视频、PDF 路径会变成卡片，点一下从电脑取回；给 Codex 和 Claude Code 续聊时还能附上手机相册里的图。下面先讲不装任何东西的办法各适合谁，再讲 BotBus 这条路怎么走、卡在哪里。

## 不装新东西的办法

这件事本来就有免费办法，很多人用得好好的：

**SSH + scp / sftp。** 手机上装一个 SSH 客户端（Termius、Blink 之类），配好 Tailscale 或端口转发，就能把电脑上的文件拉下来，也能把手机上的图传上去再告诉 agent 路径。适合本来就天天开 SSH 的人。卡点是步骤多：先找到文件在哪个目录，传完还得在终端里打一句「看一下 `/tmp/shot.png`」，单手在路上操作很累。

**网盘或同步盘。** 让 agent 把产物存进 iCloud Drive、Dropbox 或坚果云的同步目录，手机上的网盘 app 等它同步过来。适合产物本来就要长期留存的人。卡点是要事先跟 agent 约定目录，同步有延迟，截图这类一次性的东西会堆满网盘；而且文件会落进第三方云盘，按各家自己的隐私条款处理。

**聊天机器人。** 自己写个 hook 或脚本，让 agent 把文件发到 Telegram、飞书或企业微信。适合已经有一套机器人、只想要「跑完给我发一张图」的人。卡点是机器人只能单向推送，图发出去以后你想接着说「左边按钮再往右挪一点」，还得回到别的入口；文件同样经过聊天平台的服务器。

这些办法的共同问题是：文件和对话是分开的。你在一个 app 里看图，在另一个 app 里回话，agent 也不知道你看到的是哪一张。

## agent 把文件送到手机：三条路

### 1. agent 主动分享

从手机新建或续聊的任务，BotBus 会告诉 agent「用户不在电脑前、看不到屏幕」，同时给它一套把东西送回手机的工具：命令行 `botbus share <文件>`，以及同样能力的 MCP 工具 `share_file`、`share_link`。Claude Code、Codex 和经 ACP 接入的 agent（例如 OpenCode）在手机发起的会话里都会拿到这套工具。你只要在手机上说一句「截个图给我看看」或「把生成的 PDF 发给我」，agent 自己决定发哪个文件。

分享出来的东西挂在这条任务的「产物」里，输入框上方那颗按钮带着件数，点开是一个底部弹层：

- **图片**：PNG、JPEG、GIF、WebP、BMP、HEIC 直接显示，能放大看细节；Apple Watch 上也能打开。
- **视频**：在手机上直接播放，带封面和时长。Mac 版遇到超过 10 MiB 的视频会自动压成 720p、540p 或 480p 的 mp4；Linux 和 Windows 版不转码，超过 10 MiB 要先剪短或压缩。
- **其他文件**：PDF、文本、zip、PSD 都照收。iPhone 用系统的 Quick Look 预览，Android 在应用内看文字和 PDF、其余交给系统打开，打不开的也能保存下来。
- **链接**：只收 http / https，本机地址不行。想看本机网页要用预览，见[在手机上看电脑的 localhost](https://botbus.io/blog/preview-localhost-dev-server-on-iphone)。

每条任务最多保留 10 件产物，新的在前；单个文件不超过 10 MiB。

![BotBus 手机上一条任务的产物弹层](https://botbus.io/shots/zh/phone-artifacts.webp)

### 2. 回复里提到的文件，点一下取回

agent 常常只在回复里写一句「截图在 `screenshots/home.png`」，没有主动分享。BotBus 会从回复原文里认出图片、视频和 PDF 的路径，画成文件卡片。点卡片，手机向电脑发一个取回请求，电脑核对这个路径确实出现在这条回复里、而且落在这条任务的工作目录之内，才把文件加密上传，传完自动打开。

这条路不需要 agent 配合，电脑上你自己开的会话也适用；但只认最近 40 条对话里的图片、视频和 PDF，项目目录太宽（比如直接在主目录里开的会话）时不出卡片。

### 3. 「发附件给我」

产物弹层一件都没有时，里面有一个「发附件给我」。点它等于替你续聊一句，让 agent 把这一轮相关的文件分享过来。具体发哪些由 agent 判断，所以每点一次 agent 都会跑一轮。

## 把手机上的截图发给 agent

反方向是：你在手机上截了一张出错的页面、拍了一张白板，想让 agent 照着改。

给 Codex 或 Claude Code 的任务续聊、或者在手机上新建这两种 agent 的对话时，输入框左下角有选图按钮，一次最多附 4 张。几个细节：

- iPhone 用系统的照片选择器，不需要给 BotBus 相册权限；Android 用系统的照片选择器。
- 发出去之前，图会缩到长边 1920 像素、重新编码成 JPEG，原图的 EXIF 和定位信息不会跟着走。
- 其他 agent（Hermes、Pi、OpenClaw、DeepSeek Harness 等）目前不接收手机发的图，界面上不出选图按钮。

如果你只是想在电脑上随便翻一个文件、不想经过 agent，可以用聊天页的「操作电脑」：文件段能浏览电脑上的目录、打开和编辑文件、从手机上传文件。上传和改动要先在手机上解锁，闲置 10 分钟自动锁回。

## 前提和限制

- **电脑要开着、联网**，BotBus 在电脑上运行，agent 装在同一台电脑上。电脑离线时，已经传上来的产物还能看；还没取回的文件卡片点不动。
- **主动分享只在手机发起或续聊的任务里有。** 电脑上你自己开的会话不会被注入这套工具，只能靠回复里的文件卡片。
- **大小和保留时间**：单个文件不超过 10 MiB；文件字节在中转服务器上默认保留 7 天，过期后要电脑在线时重新取。Mac 版很长的视频转码可能超过本机工具约 150 秒的等待而先报失败。
- **工具截图不显示**：Claude Code 用浏览器、模拟器或 Read 读图时产生的截图，对话里只留一行文字摘要。要看图就让 agent 用 `botbus share` 发出来。
- **安全范围**：截图、文件和对话内容在电脑上用配对时生成的密钥加密后才上传，中转服务器存的是密文；服务器看得到设备编号、在线状态、更新时间和数据大小。开发预览不在端到端加密范围内。细节见[安全说明](https://botbus.io/docs/security)。

## 常见问题

### 我在电脑上开的 Claude Code 会话，能把截图发到手机吗？

不能主动发：`botbus share` 只注入到手机发起或续聊的任务。但只要它在回复里写了图片、视频或 PDF 的路径，手机上会出现文件卡片，点一下就能取回。你也可以从手机续聊这个会话，续聊那一轮起就有分享工具。

### 手机能一次发几张图给 agent？

一次最多 4 张，只有 Codex 和 Claude Code 接收。图会缩到长边 1920 像素、转成 JPEG，去掉原图的 EXIF 和定位信息。

### 支持哪些文件类型？

几乎任何文件都能分享，PNG、JPEG、GIF、WebP、BMP、HEIC 当图片显示，视频直接播放，其余按文件处理：iPhone 用 Quick Look，Android 应用内看 PDF 和文本、其他交给系统。回复里的文件卡片只认图片、视频和 PDF。

### Linux 或 Windows 电脑也能用吗？

能。Linux 和 Windows 版同样有 `botbus share` 和文件卡片；差别是不给视频转码，超过 10 MiB 的视频发不了，也没有开发预览。下载见[首页下载区](https://botbus.io/#download)。

### 手表上能看吗？

产物里的图片和对话里的图能在 Apple Watch 上打开；视频、PDF 和其他文件在手表上只提示到 iPhone 上打开。