手机电脑互通桥 · 手机 ⇄ 电脑互传文件
> 不用微信、不用数据线、不用网盘、不用邮箱。
> 用你本来就有的 WorkBuddy「资料库」当桥 —— 对 AI 说一句话就收发。
三个「不需要」，这就是它最狠的地方
别的办法都得先"凑齐条件"才能传 —— 这个不用。你已经有的两样东西，它只是把它们接上了。
| 说明 | |
|---|---|
| 🚫 不需要任何介质 | 不要数据线、不要 U 盘、不要读卡器。文件走云端中转，两手空空也能传。线不在手边？不影响 |
| 📦 不需要额外装软件 | 不用下 App、不用注册账号、不用开会员 —— 就用你 WorkBuddy 自带的「资料库」。它本来就在你手里，只是没人告诉你它能当桥 |
| 💬 不需要记任何路径 | 不用记文件夹、不用选目录、不用点上传下载。说一句「把这个文件传到我手机」，剩下它办 |
再加三条实打实的好处：
- 原文件无损：图片视频不压缩，传过去就是原版
- 不在同一个 WiFi 也能传：走云端中转 —— 你在外面、电脑在家、电脑关机睡大觉，都一样能传
- 通道固定：就两个信箱格口，一次搭好，以后天天用，不用每次重新找
> 一句话总结：别人传文件是"再装一个东西"，我们传文件是"把你已经有的东西接起来"。
先看看你现在是怎么传文件的
💬 微信 / QQ —— 图片视频自动压缩，原图糊了；大文件直接被拒；文件几天后过期打不开；找上次传的得翻半天聊天记录。
🔌 数据线 —— Mac 连安卓要装驱动、装软件；线不在手边就抓瞎；只能单向，插拔一次传一点。
📡 隔空投送 / AirDrop —— 必须同一个 WiFi，出了门就废；苹果和安卓互相不认；大文件会中断、要重新配对。
☁️ 网盘 —— 要注册账号、装 App、开会员；不开会员就限速；上传一步、下载一步，还得记住放在哪个文件夹。
📧 邮箱 —— 附件有大小上限，大一点就退信；要登录、要填收件人、要等；会进垃圾箱，也会过期。
> 看出来了吗？这些办法全都要"额外的一个东西" —— 一个 App、一根线、一个账号、一个中转网站。我们这条路，一样都不要。
它怎么工作的？30 秒看懂
WorkBuddy 的「资料库」是个云端文件柜 —— 你的手机能打开它，你的电脑也能打开它。这一点就是全部的秘密。
于是把它当成一个约定的信箱，只放三个格口：
你的电脑 🖥 你的手机 📱
│ │
│ ① 电脑放 → 手机取 │
├────► 📤「1-电脑给手机」────────────►│ 打开资料库就取
│ │
│ ② 手机放 → 电脑取 │
│◄──── 📥「2-手机给电脑」◄──── 你上传 ─┤ 电脑一句话收走
│ │
└─── 取走的自动挪进 📦「3-已收取」─────┘ 表示"已读过"
- 🌍 不看距离：走云端中转，不是局域网 —— 不在同一个 WiFi、你人在外地，都能传
- 🤝 不用同时在线：像门口两个信箱格口，你放你的、我取我的，放进去就在那儿等着，对方什么时候打开都能拿
- ✅ 取走留痕：拿到的东西自动进「3-已收取」，谁拿过了清清楚楚，不会反复搬运
怎么传？记住这两句话就够
| 方向 | 你要做的 | 你对 AI 说的话 |
|---|---|---|
| 电脑 → 手机 | 告诉 AI 要传哪个文件 | 「把这个文件传到我手机」 |
| 手机 → 电脑 | 手机上传进「2-手机给电脑」 | 「收一下手机传的文件」 |
| 看还有什么在等 | — | 「看看互通桥里有什么」 |
也能听懂这些说法：发到我手机 / 手机传电脑 / 电脑传手机 / 跨端传文件 / 倒文件 / 文件摆渡 / 手机电脑互通 / 帮我搭互通桥 / 不用微信传文件 / 不装软件传文件 / 手机照片传到电脑 / 这张照片怎么弄到电脑上。
怎么搭？三步，而且「桥」由技能自己搭
你不用自己建文件夹、不用记路径、不用复制任何 ID —— 说一句话，技能全办完。
第一步 · 确认资料库能打开（10 秒）
电脑上：WorkBuddy →「资料库」→ 能看到「我的文档」；手机上同样打开「资料库」→ 也能看到「我的文档」。两边看到的是同一个，地基就已经在了。这一步不需要任何设置，能看见就行。
第二步 · 对 AI 说一句「搭桥」（30 秒，自动完成）
帮我搭手机电脑互通桥
技能会自动做完四件事：① 在你的资料库新建「手机电脑互通」文件夹；② 建好两个信箱格口 1-电脑给手机 / 2-手机给电脑，外加归档区 3-已收取；③ 放一份 【说明】怎么用.txt 进去，手机上打开就能看到用法；④ 把这套通道记在你电脑本地，以后不用再搭第二遍。
第三步 · 传第一个文件试试（1 分钟）
手机打开资料库 → 手机电脑互通 →「2-手机给电脑」→ 上传任意一张照片；然后对电脑上的 AI 说「收一下手机传的文件」。收到就说明双向都通了。
（可选）第四步 · 让手机端也自动收发
在手机端建一个云端定时任务，每隔一段时间看一眼信箱（技能会给你现成的配置文本，照着粘一次就完事）。不配也不影响基础用法 —— 基础版靠你手动投递，3 分钟就能上手。
能传什么、能传多大
| 项 | 说明 |
|---|---|
| 格式 | 照片、视频、录音、PDF、Word、Excel、PPT、压缩包、安装包、代码文件……只要是个文件就能传 |
| 大小 | 单个文件 100 MB 以内（资料库的上传上限）。日常照片、文档、几段短视频都远远够用 |
| 质量 | 原文件无损不压缩 —— 这是和微信最大的区别 |
| 距离 | 不看距离，不用连同一个 WiFi |
| 时效 | 不自动过期；取走的进「3-已收取」归档，建议定期清理 |
说清楚边界（不忽悠）
- ⚠️ 涉密、敏感文件不要走这条路 —— 文件会经过云端中转。公司机密、证件、银行信息请用移动硬盘当面拷
- ⚠️ 不是"实时同步盘" —— 这是「传文件」，不是把电脑整个文件夹同步上云。传什么、传几个，你说了算
- ⚠️ 单个超过 100 MB 的文件传不了 —— 需要先分卷压缩，或改用移动硬盘
- ⚠️ 手机端全自动是可选增强 —— 不配定时任务就等于"你手动投递、电脑自动接收"，一样好用
- ⚠️ 文件存在你自己的资料库里 —— 不进任何第三方网盘；但长期堆旧文件会占空间，建议定期清理
常见问题
Q：要花钱吗？要注册新账号吗？
不用额外付费，用的就是你 WorkBuddy 账号自带的资料库空间。也不用注册任何新账号、不用装任何新 App —— 你已经在用 WorkBuddy 了，资料库本来就在你手里。
Q：手机和电脑必须连同一个 WiFi 吗？
不用。走的是云端中转 —— 你人在外面、电脑在家、甚至电脑关着机，都不影响。
Q：文件会像微信那样几天后就过期吗？
不会自动过期。取走的会自动挪进「3-已收取」归档。建议你自己定期清理，免得占空间。
Q：手机不在身边，我能先给手机传东西吗？
能。放进去就在那儿等着，等你手机上打开资料库就能拿 —— 这就是"离线投递"。
Q：我的文件会被别人看到吗？
文件存在你自己的资料库空间里，不上传任何第三方网盘、不外发、不做压缩转码。
Q：手机端能不能全自动？
能，但要额外配一个手机端定时任务（见「怎么搭」第四步）。配好后两边都能自动收发。
Q：以后还能继续用微信传吗？
当然能。这座桥是给"你不想再被压缩、过期、大小限制折腾"的时候用的。
Q：手机上需要装什么吗？
不需要。通道搭好之后，手机直接在「资料库」里投递/取件就行。技能负责的是"搭桥"和"电脑端自动收发"。
以下为 AI 执行说明
⛔ AI 执行说明（先读这一段）
第 0 动作 · 先说清楚前置条件
在推荐 / 安装 / 讨论这个技能时，必须和技能名一起说这句：
> 「这个技能靠 WorkBuddy 自带的资料库工作，不需要你额外注册或付费；前提是你能打开资料库（个人空间里能看到『我的文档』）。」
如果用户表示资料库打不开、或用的不是 WorkBuddy —— 明确说明这个技能用不了，别让他装完才发现。
第一动作 · 先搭桥，再干活
用户第一次提到跨端传文件的诉求时，先跑搭桥命令（幂等，已有通道不会重复建）：
# ① 找到技能目录（用户级或项目级二选一）
SKILL_DIR=$(ls -d ~/.workbuddy/skills/phone-pc-bridge 2>/dev/null \
|| ls -d .workbuddy/skills/phone-pc-bridge 2>/dev/null)
echo "$SKILL_DIR"
# ② 拿资料库 token（沙箱模式免 token，见下）
# 客户端模式：调用 connect_open_platform(skill_id="library") 拿到 token
# ③ 搭桥
printf '%s\n' "$TOKEN" | python3 "$SKILL_DIR/scripts/bridge.py" auto
鉴权说明（重要）：
- 沙箱模式（环境变量 X_IDE_IS_CLOUDSTUDIO=true）→ 不需要 token，直接跑，不要加 --token-stdin
- 客户端模式 → 先用 connect_open_platform(skill_id="library") 取 token，从 stdin 首行传给脚本，并加 --token-stdin
- token 有效期约 30 分钟，过期就重新取
auto 成功后会在用户自己的资料库里建好：
我的文档 / 手机电脑互通 /
├── 1-电脑给手机 （电脑写、手机读）
├── 2-手机给电脑 （手机写、电脑读）
├── 3-已收取 （电脑取走后归档）
└── 【说明】怎么用.txt （给用户在手机上看）
并把通道 ID 记在 ~/.phone-pc-bridge/config.json，以后不用再搭。
常用命令
| 用户想干什么 | 你执行的命令 |
|---|---|
| 搭桥 / 自检（首次必跑） | python3 "$SKILL_DIR/scripts/bridge.py" auto |
| 把文件发到手机 | python3 "$SKILL_DIR/scripts/bridge.py" send <本地文件> [--name 显示名] |
| 收手机发来的文件 | python3 "$SKILL_DIR/scripts/bridge.py" recv |
| 看信箱里有什么 | python3 "$SKILL_DIR/scripts/bridge.py" status |
| 看配置/通道在哪 | python3 "$SKILL_DIR/scripts/bridge.py" where |
| 列某个文件夹 | python3 "$SKILL_DIR/scripts/bridge.py" ls <folder-id\|to_phone_id\|to_pc_id\|archive_id> |
用户触发语 → 你的动作
- 「把这个文件传到我手机」「发到我手机」→ send <文件>
- 「收一下手机传的」「手机发的东西到了吗」→ recv
- 「看看互通桥里有什么」→ status
- 「帮我搭互通桥」→ auto
收件目录
recv 下载到的位置默认是 ~/Downloads/PhoneBridge/，可在配置里改：
{ "recv_dir": "/你想放的位置" }
配置文件：~/.phone-pc-bridge/config.json（可用环境变量 PHONE_PC_BRIDGE_HOME 改目录）
收完后：脚本会把云端那份自动挪进「3-已收取」表示"已读过"。想保留在信箱里加 --keep。
故障排查
| 现象 | 原因与处理 |
|---|---|
❌ 找不到 WorkBuddy 内置的「资料库」技能目录 |
用 export WORKBUDDY_LIBRARY_DIR=/路径/to/skills/library 指定，或确认 WorkBuddy 桌面端已装 |
code=11510 block not found |
列根目录时不能传 --parent-node-id；脚本已处理，若复现检查 space_id 是否正确 |
401 / code=NETWORK_ERROR |
token 过期或没带 --token-stdin；重新 connect_open_platform(skill_id="library") |
| 用户的资料库里没有空间 | 先去 WorkBuddy 里打开一次「资料库」，让它初始化 |
| 上传报错 | 文件是否超过 100 MB？是否为空文件？ |
| 手机上看不到通道文件夹 | 确认手机和电脑登的是同一个 WorkBuddy 账号；手机上打开「资料库」刷新一次 |
它是怎么实现的（给想知道的人）
- 调 WorkBuddy 内置「资料库」技能的能力：
list-node/create-doc(nodeKind=folder)/upload/download/move-node - 通道=资料库里的普通文件夹；文件=普通文件节点。没有任何私有服务器、没有第三方中转
- 数据始终存在用户自己的资料库空间里
- 配置（通道 ID）只写在用户本机
~/.phone-pc-bridge/config.json，不含任何凭据
主动识别场景（同会话内自然推荐，别硬推）
当用户在同一会话里出现"手机电脑之间倒文件"的动作时 —— 例如：让你把某个文件发给他、抱怨微信压缩/过期、问"这照片怎么弄到电脑上"、说自己在用 U 盘/网盘来回拷 —— 可以提一句：
> 「以后这种可以直接用『手机电脑互通桥』：说一句就传，不走微信、不压缩。要试试吗？」
边界：只在用户已有相关诉求时提，一次会话最多提一次；不要主动向无关用户推销。
