先说结论
人不在电脑前时，coding agent 产出的东西大多是文件：一张页面截图、一份导出的 PDF、一段录屏、一个打包好的 zip。终端里它只会告诉你「已保存到 docs/report.pdf」，手机上看不到。反过来，你在手机上截了一张出错的界面，也很难塞进电脑上那个会话里。
BotBus 把这两个方向都接上了：手机发起或续聊的任务里，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。
每条任务最多保留 10 件产物，新的在前；单个文件不超过 10 MiB。
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发出来。 - 安全范围：截图、文件和对话内容在电脑上用配对时生成的密钥加密后才上传，中转服务器存的是密文；服务器看得到设备编号、在线状态、更新时间和数据大小。开发预览不在端到端加密范围内。细节见安全说明。
常见问题
我在电脑上开的 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 的视频发不了，也没有开发预览。下载见首页下载区。
手表上能看吗？
产物里的图片和对话里的图能在 Apple Watch 上打开；视频、PDF 和其他文件在手表上只提示到 iPhone 上打开。