手机直取
现在
在用 · 上次更新 11 月 7 日 20:36
截至 11 月 12 日 · 技能和电脑配置的提交记录

技能名 phone-direct · 电脑配置与恢复里手机桥的取用入口

它做什么

电脑上的 AI 干活时,常常要用到我手机里的东西:刚在手机上导出的账单、短信里的解压码、一条通知、手机屏幕现在的样子。以前得我自己传到电脑上;现在 AI 需要时直接经无线调试去手机上取,不先问我。在家走家里 Wi-Fi;不在同一个 Wi-Fi 时,手机在电脑旁边就走蓝牙(不花手机流量),离得远走手机上的 TailSocks(经 Tailscale 连回电脑,用手机流量)。手机不用切 VPN,代理可以一直开着。

连不上,AI 先自己重连;还不行,就用一句话告诉我该在手机上做什么。取回的文件两头核对过才算数;默认只读,不动手机的设置。只有我开口要在手机上看电脑里的某个文件,或要在手机上打开自己网站的某一页时,它才往手机放文件、开网页。

10 月 21 日晚在真手机上各试过一次:在家打开调试端口后,常驻的手机桥约 25 秒自动连回;关掉 Wi-Fi、切到 Tailscale 后远程取回一个测试文件,两头指纹一致;模拟后台任务连不上时在驾驶舱登记了“手机连一下”,连上后由 AI 核实关掉。11 月 5 日 14:01 蓝牙和 Tailscale 两条线也都实连通过(Tailscale 约 900KB/秒)。这些都是当时的记录,现在能不能取到要实际连一次才知道。

怎么跟 AI 说

“把我刚在手机上下载的微信支付账单拿过来。”

“滴滴的个人信息导出好了,取到电脑上,核对完把手机上那份删了。”

“看看短信里有没有那个压缩包的解压码。”

“手机上现在有什么通知?”

“截一张手机屏幕给我看看。”

“把剪好的成片放到我手机上,我路上看。”

“在手机上打开驾驶舱的配对链接。”

“我在外面,把手机下载目录里最新的文件取过来。”

手机直取
现在
在用 · 上次更新 11 月 7 日 20:36
截至 11 月 12 日 · 技能和电脑配置的提交记录

技能名 phone-direct · 电脑配置与恢复里手机桥的取用入口

它做什么

电脑上的 AI 干活时,常常要用到我手机里的东西:刚在手机上导出的账单、短信里的解压码、一条通知、手机屏幕现在的样子。以前得我自己传到电脑上;现在 AI 需要时直接经无线调试去手机上取,不先问我。在家走家里 Wi-Fi;不在同一个 Wi-Fi 时,手机在电脑旁边就走蓝牙(不花手机流量),离得远走手机上的 TailSocks(经 Tailscale 连回电脑,用手机流量)。手机不用切 VPN,代理可以一直开着。

连不上,AI 先自己重连;还不行,就用一句话告诉我该在手机上做什么。取回的文件两头核对过才算数;默认只读,不动手机的设置。只有我开口要在手机上看电脑里的某个文件,或要在手机上打开自己网站的某一页时,它才往手机放文件、开网页。

怎么跟 AI 说

“把我刚在手机上下载的微信支付账单拿过来。”

“滴滴的个人信息导出好了,取到电脑上,核对完把手机上那份删了。”

“看看短信里有没有那个压缩包的解压码。”

“手机上现在有什么通知?”

“截一张手机屏幕给我看看。”

“把剪好的成片放到我手机上,我路上看。”

“在手机上打开驾驶舱的配对链接。”

“我在外面,把手机下载目录里最新的文件取过来。”

10 月 21 日晚在真手机上各试过一次:在家打开调试端口后,常驻的手机桥约 25 秒自动连回;关掉 Wi-Fi、切到 Tailscale 后远程取回一个测试文件,两头指纹一致;模拟后台任务连不上时在驾驶舱登记了“手机连一下”,连上后由 AI 核实关掉。11 月 5 日 14:01 蓝牙和 Tailscale 两条线也都实连通过(Tailscale 约 900KB/秒)。这些都是当时的记录,现在能不能取到要实际连一次才知道。

一个完整例子
示例:照这个技能的做法写的,不是某一次的记录

我:“把我刚在手机上导出的微信支付账单拿到电脑上,拿完手机上那份可以删了。”

AI 做了什么
1
先确认连着手机:手机在家里 Wi-Fi 上、开着无线调试,直接连上,并核对连上的确实是我这台手机。
2
再过资料锁:账单是我的私人资料,锁着就停下,请我在电脑上验证解锁后再取。
3
看手机的下载目录,按修改时间从新到旧列出来,找到刚导出的那份账单。
4
先拉到电脑上一个英文名的暂存处,手机那头和电脑这头各算一遍指纹、比大小,一致才挪到我要的文件夹,原来的中文名和修改时间都保留;那里已有同名但内容不同的文件,就另起一个名字,不覆盖。
5
微信支付账单在我同意过“取回核对后可以删”的名单里:删之前再核一次手机上那份没变,删完确认手机上已经没有了。
AI 交回

“账单已经放进你要的文件夹,两头核对一致;手机上那份已经删掉。”

连不上时

我:“手机上现在有什么通知?”

AI:“电脑在家里的网络上找不到手机,Tailscale 上也不在线。你在外面的话,打开手机上的 TailSocks,我就能远程取,不用切 VPN;你在家的话,确认手机连着家里 Wi-Fi、开着无线调试。”

电脑看到的情况AI 请你做的事
手机上要确认一次调试授权屏幕上有“允许无线调试”提示就点“允许”(勾上始终允许);没有提示就进无线调试里“使用配对码配对设备”,把屏幕上的地址和六位配对码发给 AI
无线调试开着,电脑却连不上重新配对一次,做法同上
手机在家里 Wi-Fi 上,但无线调试没开设置 → 开发者选项 → 打开“无线调试”
家里网络上找不到手机,Tailscale 上也不在线在外面就打开手机上的 TailSocks;在家就连上家里 Wi-Fi、开着无线调试(只开数据网络时,手机在电脑旁边、蓝牙连得上也能取)
TailSocks 在线,但远程端口关着手机重启过就会这样,这次蓝牙和远程都取不到;回到家连上家里 Wi-Fi,等电脑下一次收取时自动重新打开端口,再取
手机电量到 20%,自动开了省电模式TailSocks 和采集 App 被系统冻结,蓝牙和 Tailscale 一起断,只有同一个 Wi-Fi 还能连;关掉省电模式,两条线会自己恢复
一个完整例子
示例:照这个技能的做法写的,不是某一次的记录

我:“把我刚在手机上导出的微信支付账单拿到电脑上,拿完手机上那份可以删了。”

AI 做了什么
1
先确认连着手机:手机在家里 Wi-Fi 上、开着无线调试,直接连上,并核对连上的确实是我这台手机。
2
再过资料锁:账单是我的私人资料,锁着就停下,请我在电脑上验证解锁后再取。
3
看手机的下载目录,按修改时间从新到旧列出来,找到刚导出的那份账单。
4
先拉到电脑上一个英文名的暂存处,手机那头和电脑这头各算一遍指纹、比大小,一致才挪到我要的文件夹,原来的中文名和修改时间都保留;那里已有同名但内容不同的文件,就另起一个名字,不覆盖。
5
微信支付账单在我同意过“取回核对后可以删”的名单里:删之前再核一次手机上那份没变,删完确认手机上已经没有了。
AI 交回

“账单已经放进你要的文件夹,两头核对一致;手机上那份已经删掉。”

连不上时

我:“手机上现在有什么通知?”

AI:“电脑在家里的网络上找不到手机,Tailscale 上也不在线。你在外面的话,打开手机上的 TailSocks,我就能远程取,不用切 VPN;你在家的话,确认手机连着家里 Wi-Fi、开着无线调试。”

电脑看到的情况AI 请你做的事
手机上要确认一次调试授权
AI 请你做的事:
屏幕上有“允许无线调试”提示就点“允许”(勾上始终允许);没有提示就进无线调试里“使用配对码配对设备”,把屏幕上的地址和六位配对码发给 AI
无线调试开着,电脑却连不上
AI 请你做的事:
重新配对一次,做法同上
手机在家里 Wi-Fi 上,但无线调试没开
AI 请你做的事:
设置 → 开发者选项 → 打开“无线调试”
家里网络上找不到手机,Tailscale 上也不在线
AI 请你做的事:
在外面就打开手机上的 TailSocks;在家就连上家里 Wi-Fi、开着无线调试(只开数据网络时,手机在电脑旁边、蓝牙连得上也能取)
TailSocks 在线,但远程端口关着
AI 请你做的事:
手机重启过就会这样,这次蓝牙和远程都取不到;回到家连上家里 Wi-Fi,等电脑下一次收取时自动重新打开端口,再取
手机电量到 20%,自动开了省电模式
AI 请你做的事:
TailSocks 和采集 App 被系统冻结,蓝牙和 Tailscale 一起断,只有同一个 Wi-Fi 还能连;关掉省电模式,两条线会自己恢复
能做的事
三条线,AI 自己挑
我在哪怎么连要知道的
家里手机连着家里 Wi-Fi、开着无线调试,电脑直接连上;同一个 Wi-Fi 上总是先走这条手机回到家里 Wi-Fi 后,常驻的手机桥会自己试着连回(10 月 21 日实测一次,约 25 秒连回);没连回时按上一屏的表在手机上操作
电脑旁边,不在同一个 Wi-Fi走蓝牙:手机和电脑配对过,手机上的采集 App 负责转发不花手机流量,连得上就走它,不测速,也不去试远程。约 110KB/秒,10MB 要 1 分半、100MB 要 15 分钟;文件大、我又在等时,AI 先告诉我要多久,我决定催不催
外面手机上开着 TailSocks,任何网络都行;它不占 VPN 位,代理照常开着蓝牙连不上才走这条,用手机流量;新建的连接用完就断,常驻的连接留着;手机重启后要先回家连一次 Wi-Fi 才能再远程取
我催的时候AI 加 --fast:蓝牙和 Tailscale 都试,测一小段(256KiB)挑快的,结果留 30 分钟可能花手机流量;我不催就不测速,默认省流量,不追求最快
用这个技能时,AI 守的规矩
要用就去取:AI 需要手机上的东西时直接去拿,不先问我(10 月 21 日我定的);没连上才请我。
连不上先自己修:先把能试的路一条条试过(已连着的、家里网络里找到的、上次记下的家里地址、蓝牙、Tailscale),每条都核对连上的是不是我这台手机;仍不行才用一句话请我,写清是点“允许”、重新配对、打开无线调试还是打开 TailSocks。
不假设我在家或在电脑前:我在家却连不上,算故障;我人在外面,就把“在外面怎么做”“在家怎么做”都说清。
后台任务不干等:没人看着时连不上,就在驾驶舱登记一条“手机连一下”,写明要取什么,先做不依赖手机的部分,回执里写明手机那部分还没做;已有没关的同类条目不重复登记;手机连上后核实了就关掉。
取回的文件两头核对:手机和电脑两头的指纹和大小一致才算取到;保留中文名和修改时间;同名不同内容另起名,不覆盖。往手机放文件也一样:先放临时名,手机上核对指纹再改正式名,同名不同内容另起名;放好告诉我在手机哪个文件夹、叫什么。
只删说好的:只删我同意过的两类导出(微信支付账单、滴滴个人信息导出),而且要取回核对成功、删前手机上那份没变、删后确认没了;名单外的一律不删,要加新类型先问我。
私人资料先过锁:文件、短信、通知、截图都是我的私人资料,锁着就停下请我验证;短信和通知的正文按这次任务需要原样用,需要时也可以存进本机或我的私有仓库,其中的密码、令牌这类秘密照秘密规则处理;配对码不显示、不留存。
只走这一个入口:不用电脑上另装的 adb,也不重启 adb 服务,免得打断常驻的手机桥。
能做的事
三条线,AI 自己挑
我在哪怎么连要知道的
家里
怎么连:
手机连着家里 Wi-Fi、开着无线调试,电脑直接连上;同一个 Wi-Fi 上总是先走这条
要知道的:
手机回到家里 Wi-Fi 后,常驻的手机桥会自己试着连回(10 月 21 日实测一次,约 25 秒连回);没连回时按上一屏的表在手机上操作
电脑旁边,不在同一个 Wi-Fi
怎么连:
走蓝牙:手机和电脑配对过,手机上的采集 App 负责转发
要知道的:
不花手机流量,连得上就走它,不测速,也不去试远程。约 110KB/秒,10MB 要 1 分半、100MB 要 15 分钟;文件大、我又在等时,AI 先告诉我要多久,我决定催不催
外面
怎么连:
手机上开着 TailSocks,任何网络都行;它不占 VPN 位,代理照常开着
要知道的:
蓝牙连不上才走这条,用手机流量;新建的连接用完就断,常驻的连接留着;手机重启后要先回家连一次 Wi-Fi 才能再远程取
我催的时候
怎么连:
AI 加 --fast:蓝牙和 Tailscale 都试,测一小段(256KiB)挑快的,结果留 30 分钟
要知道的:
可能花手机流量;我不催就不测速,默认省流量,不追求最快
用这个技能时,AI 守的规矩
要用就去取:AI 需要手机上的东西时直接去拿,不先问我(10 月 21 日我定的);没连上才请我。
连不上先自己修:先把能试的路一条条试过(已连着的、家里网络里找到的、上次记下的家里地址、蓝牙、Tailscale),每条都核对连上的是不是我这台手机;仍不行才用一句话请我,写清是点“允许”、重新配对、打开无线调试还是打开 TailSocks。
不假设我在家或在电脑前:我在家却连不上,算故障;我人在外面,就把“在外面怎么做”“在家怎么做”都说清。
后台任务不干等:没人看着时连不上,就在驾驶舱登记一条“手机连一下”,写明要取什么,先做不依赖手机的部分,回执里写明手机那部分还没做;已有没关的同类条目不重复登记;手机连上后核实了就关掉。
取回的文件两头核对:手机和电脑两头的指纹和大小一致才算取到;保留中文名和修改时间;同名不同内容另起名,不覆盖。往手机放文件也一样:先放临时名,手机上核对指纹再改正式名,同名不同内容另起名;放好告诉我在手机哪个文件夹、叫什么。
只删说好的:只删我同意过的两类导出(微信支付账单、滴滴个人信息导出),而且要取回核对成功、删前手机上那份没变、删后确认没了;名单外的一律不删,要加新类型先问我。
私人资料先过锁:文件、短信、通知、截图都是我的私人资料,锁着就停下请我验证;短信和通知的正文按这次任务需要原样用,需要时也可以存进本机或我的私有仓库,其中的密码、令牌这类秘密照秘密规则处理;配对码不显示、不留存。
只走这一个入口:不用电脑上另装的 adb,也不重启 adb 服务,免得打断常驻的手机桥。
边界
管

从我现在的手机(vivo X500 Pro Max)取文件、短信、当前通知和截图;确认连接、自动重连,连不上时请我连一下;取回的文件核对一致,名单内的导出核对后删手机副本;我要时把电脑上的文件放到手机下载目录、在手机上打开本人网站的某一页。

不管,交给谁
这些事找谁
手机照片视频的保全、清空和回写找照片和录音
我跟 AI 要验证码邮件和云盘的合并取码:短信和邮箱一起等,哪边先来给哪边
网站登录流程里要填的短信验证码电脑配置与恢复的按需取码,见取短信验证码
微信聊天记录看微信聊天
手机通知转到电脑、三端剪贴板常驻的手机桥,见电脑配置与恢复
驾驶舱上“手机连一下”那条在驾驶舱看;手机连上后 AI 核实关闭
不做
  • 不改手机系统设置,不装卸应用,不动账号。
  • 不持续拉取,也不远程操作手机;每次只取这一次要的。没有我开口,不往手机写文件;打开网页只放行本人网站。
  • 名单外的文件不删;照片视频的清空归照片视频那边。
  • 不另开服务:复用现有的手机桥,没有为它新装后台服务或定时任务。
边界
管

从我现在的手机(vivo X500 Pro Max)取文件、短信、当前通知和截图;确认连接、自动重连,连不上时请我连一下;取回的文件核对一致,名单内的导出核对后删手机副本;我要时把电脑上的文件放到手机下载目录、在手机上打开本人网站的某一页。

不管,交给谁
这些事找谁
我跟 AI 要验证码
找谁:
邮件和云盘的合并取码:短信和邮箱一起等,哪边先来给哪边
网站登录流程里要填的短信验证码
找谁:
电脑配置与恢复的按需取码,见取短信验证码
驾驶舱上“手机连一下”那条
找谁:
在驾驶舱看;手机连上后 AI 核实关闭
不做
  • 不改手机系统设置,不装卸应用,不动账号。
  • 不持续拉取,也不远程操作手机;每次只取这一次要的。没有我开口,不往手机写文件;打开网页只放行本人网站。
  • 名单外的文件不删;照片视频的清空归照片视频那边。
  • 不另开服务:复用现有的手机桥,没有为它新装后台服务或定时任务。
技术实现与依据(一)

这里保留入口、子命令、输出、退出码、连接和核对的实现。

10 月 22 日核对
技能 E:\.agents\skills\phone-direct\SKILL.md(.agents 0348800d,北京时间 10 月 21 日 21:13);入口脚本 E:\PCConfig\tools\phone_direct.py(PCConfig 7df54f9b,同日 21:13),运行说明 docs/runtime/phone-direct.md,配置 registries/phone_direct.json;合成测试 tools/test_phone_direct.py 共 46 个测试函数,这次没有重跑。复用常驻无线 ADB 手机桥(tools/phone_bridge.py,计划任务 PCConfig Phone Bridge)的共用连接,没有为它新增服务、MCP 或计划任务。
11 月 6 日核对
三条线的选路在共用的 tools/phone_connection.py,蓝牙转发在 tools/phone_bluetooth.py(提交见“依据与来源”)。05:14 只读跑过入口的 --help 和 ensure --help,都退出 0,帮助里列着 --fast;没有跑 ensure(它会动驾驶舱事项),没有取文件,也没有重连手机。
入口和子命令

python -B E:\PCConfig\tools\phone_direct.py 子命令;--unattended --purpose "要从手机取什么" 放在子命令前后都可以;--fast 也一样,只在本人催的时候加:蓝牙和 Tailscale 都试,按 256KiB 测速选快的,结果缓存 30 分钟,可能花手机流量;不加时蓝牙连得上就走蓝牙;--help 输出帮助文字,是唯一不出 JSON 的情况。

子命令做什么主要参数
ensure确认连接;已连上时关闭驾驶舱里未结的“手机连一下”无
ls 手机目录列一层目录,按修改时间从新到旧只收绝对路径
pull 手机路径… --dest 电脑目录取回并核对,可一次多个--delete-after-verify:核对后删手机副本,只限白名单
sms按条件读短信--since-minutes(默认 1440)、--address、--contains、--limit(默认 20)、--box inbox 或 all
notifications读取并筛选当前通知--package、--contains、--limit(默认 30)
screenshot --dest 电脑目录存一张 PNG,文件名 phone-年月日-时分秒.png无
push 电脑文件把我要在手机上看的文件放到手机,核对后改正式名--dest(默认 /sdcard/Download)、--name 手机上的文件名
open-url 网址在手机浏览器打开本人网站的一页(例如驾驶舱设备配对链接)--package 可指定 Chrome 或 Chrome Beta;只放行 wly0829.cn 及其子域名
pair 地址 六位配对码配对后再走一遍 ensure配对码不输出、不落盘

push 和 open-url 是核对之后补的(PCConfig 047be48d,北京时间 10 月 23 日;c778f4cd、643a5bb9,10 月 26 日),按当前运行说明写,还没在真手机上验证。

除 pair 外,每条子命令都先跑 ensure;ls、pull、push、sms、notifications、screenshot 连上后再经密码中心查个人资料锁(Invoke-SecretBroker.ps1 CheckPersonalDataAccess),锁着就不读。

技术实现与依据(一)

这里保留入口、子命令、输出、退出码、连接和核对的实现。

10 月 22 日核对
技能 E:\.agents\skills\phone-direct\SKILL.md(.agents 0348800d,北京时间 10 月 21 日 21:13);入口脚本 E:\PCConfig\tools\phone_direct.py(PCConfig 7df54f9b,同日 21:13),运行说明 docs/runtime/phone-direct.md,配置 registries/phone_direct.json;合成测试 tools/test_phone_direct.py 共 46 个测试函数,这次没有重跑。复用常驻无线 ADB 手机桥(tools/phone_bridge.py,计划任务 PCConfig Phone Bridge)的共用连接,没有为它新增服务、MCP 或计划任务。
11 月 6 日核对
三条线的选路在共用的 tools/phone_connection.py,蓝牙转发在 tools/phone_bluetooth.py(提交见“依据与来源”)。05:14 只读跑过入口的 --help 和 ensure --help,都退出 0,帮助里列着 --fast;没有跑 ensure(它会动驾驶舱事项),没有取文件,也没有重连手机。
入口和子命令

python -B E:\PCConfig\tools\phone_direct.py 子命令;--unattended --purpose "要从手机取什么" 放在子命令前后都可以;--fast 也一样,只在本人催的时候加:蓝牙和 Tailscale 都试,按 256KiB 测速选快的,结果缓存 30 分钟,可能花手机流量;不加时蓝牙连得上就走蓝牙;--help 输出帮助文字,是唯一不出 JSON 的情况。

子命令做什么主要参数
ensure
做什么:
确认连接;已连上时关闭驾驶舱里未结的“手机连一下”
主要参数:
无
ls 手机目录
做什么:
列一层目录,按修改时间从新到旧
主要参数:
只收绝对路径
pull 手机路径… --dest 电脑目录
做什么:
取回并核对,可一次多个
主要参数:
--delete-after-verify:核对后删手机副本,只限白名单
sms
做什么:
按条件读短信
主要参数:
--since-minutes(默认 1440)、--address、--contains、--limit(默认 20)、--box inbox 或 all
notifications
做什么:
读取并筛选当前通知
主要参数:
--package、--contains、--limit(默认 30)
screenshot --dest 电脑目录
做什么:
存一张 PNG,文件名 phone-年月日-时分秒.png
主要参数:
无
push 电脑文件
做什么:
把我要在手机上看的文件放到手机,核对后改正式名
主要参数:
--dest(默认 /sdcard/Download)、--name 手机上的文件名
open-url 网址
做什么:
在手机浏览器打开本人网站的一页(例如驾驶舱设备配对链接)
主要参数:
--package 可指定 Chrome 或 Chrome Beta;只放行 wly0829.cn 及其子域名
pair 地址 六位配对码
做什么:
配对后再走一遍 ensure
主要参数:
配对码不输出、不落盘

push 和 open-url 是核对之后补的(PCConfig 047be48d,北京时间 10 月 23 日;c778f4cd、643a5bb9,10 月 26 日),按当前运行说明写,还没在真手机上验证。

除 pair 外,每条子命令都先跑 ensure;ls、pull、push、sms、notifications、screenshot 连上后再经密码中心查个人资料锁(Invoke-SecretBroker.ps1 CheckPersonalDataAccess),锁着就不读。

数字截至 2026 年 11 月 12 日

技术实现与依据(二)
输出

每条命令在标准输出打印一份 UTF-8 JSON,schema 为 pcconfig.phone-direct.v1,都带 status,时间用北京时间。短信、通知正文只出现在这次输出里,工具自己不写日志或状态文件;要不要另存由 AI 按任务需要决定。

ensure:
连上是 status=connected,带 device(连上的设备地址,页上不写值)和 route(lan 家里 / bluetooth 蓝牙 / tailscale 远程;本次新建的落选远程连接立刻断开,选中的在本次结束时断开,已有连接保持);没连上是 status=not_connected,带 kind(下一屏五种之一)和 owner_message(给本人的一句话);驾驶舱登记失败另带 owner_item_error。
ls:
entries,每项 name、path、size、mtime、type(file / dir / other)。
pull:
status 为 ok、partial 或 delete_not_allowed;files 每项 remote、local、size、sha256、result(pulled / already_present / verification_failed)、deleted。
sms:
messages,每条 id、address、date、body。
notifications:
notifications,每条 package、app、title、text、posted_at。
push:
remote、size、sha256,result 为 pushed 或 already_present(同名同内容)。
open-url:
result=opened;不读手机资料,不过资料锁。
screenshot:
local、size、sha256。
出错:
status=error,reason 是一个英文短词(如 invalid_arguments、invalid_remote_path、source_changed、remote_disconnect_failed),认不出的一律 operation_failed。
退出码
退出码含义
0成功:status 为 ok 或 connected
2手机没连上(not_connected),看 kind 和 owner_message;驾驶舱登记失败也仍是 2
3个人资料锁着(personal_data_locked):根会话请本人验证解锁后再取;子代理不自己验证,写“需要本人资料:……”交回
1其他:有文件没核对通过(partial)、要删的不在白名单(delete_not_allowed,整条拒绝,不拉也不删)、参数或执行错误(error)
技术实现与依据(二)
输出

每条命令在标准输出打印一份 UTF-8 JSON,schema 为 pcconfig.phone-direct.v1,都带 status,时间用北京时间。短信、通知正文只出现在这次输出里,工具自己不写日志或状态文件;要不要另存由 AI 按任务需要决定。

ensure:
连上是 status=connected,带 device(连上的设备地址,页上不写值)和 route(lan 家里 / bluetooth 蓝牙 / tailscale 远程;本次新建的落选远程连接立刻断开,选中的在本次结束时断开,已有连接保持);没连上是 status=not_connected,带 kind(下一屏五种之一)和 owner_message(给本人的一句话);驾驶舱登记失败另带 owner_item_error。
ls:
entries,每项 name、path、size、mtime、type(file / dir / other)。
pull:
status 为 ok、partial 或 delete_not_allowed;files 每项 remote、local、size、sha256、result(pulled / already_present / verification_failed)、deleted。
sms:
messages,每条 id、address、date、body。
notifications:
notifications,每条 package、app、title、text、posted_at。
push:
remote、size、sha256,result 为 pushed 或 already_present(同名同内容)。
open-url:
result=opened;不读手机资料,不过资料锁。
screenshot:
local、size、sha256。
出错:
status=error,reason 是一个英文短词(如 invalid_arguments、invalid_remote_path、source_changed、remote_disconnect_failed),认不出的一律 operation_failed。
退出码
退出码含义
0
含义:
成功:status 为 ok 或 connected
2
含义:
手机没连上(not_connected),看 kind 和 owner_message;驾驶舱登记失败也仍是 2
3
含义:
个人资料锁着(personal_data_locked):根会话请本人验证解锁后再取;子代理不自己验证,写“需要本人资料:……”交回
1
含义:
其他:有文件没核对通过(partial)、要删的不在白名单(delete_not_allowed,整条拒绝,不拉也不删)、参数或执行错误(error)
连接与核对
连接顺序
1
adb 已列为在线的设备里先找这台手机;每个候选都读 ro.serialno,和手机桥配置里登记的本机手机对上才算。
2
mDNS 广播里本机手机的无线调试服务,连上再核对。
3
手机桥 E:\Data\PCConfig\PhoneBridge\peer.json 记下的上次家里端点,和家里地址上的传统调试端口(peer.json 里的手机须是本机手机);先探 TCP 再连,不通或不是本机的端点从 adb 断开,不让 adb 一直重拨死端点。前三步是收取任务、手机桥和本入口共用的 connect()。
4
局域网都不行,就走共用的 tools/phone_connection.py:先核实已有的共享远程连接,再试蓝牙(要手机桥配置里有已配对地址;手机采集 App 收到电脑的蓝牙链路后短时开加密 RFCOMM 服务,把数据转到手机本机的传统调试端口),已有共享连接直接复用,不随一次按需调用关闭。蓝牙连得上就记 route=bluetooth,不测速、也不探 Tailscale。
5
蓝牙连不上或带了 --fast,才取 Tailscale 里的 Android 设备,连它的传统调试端口并核对,记 route=tailscale。安卓节点全显示不在线时还会试最后见过的那一台:手机熄屏后可能只是和协调服务器断开,adb 还能连,所以通不通以实际连接为准,不看在线标记或 ping。带 --fast 且两条都通时,按 256KiB 测速选快的。
6
本次新建的落选线路立刻断开,选中的在命令结束时(finally)断开;原有的共享连接和家里连接保持。

传统调试端口由每半小时一次的收取在手机在家时自动打开;手机重启后会关,回家连上 Wi-Fi 才恢复,这期间蓝牙和 Tailscale 都用不了。

连不上时的判定顺序
1
手机桥判定为 pairing_required → authorize:点“允许”或用配对码配对。
2
判定为 lan_unreachable:mDNS 里有本机手机的无线调试连接记录 → repair(重新配对);没有 → enable_debugging(打开无线调试)。
3
其他情况:Tailscale 里有在线的 Android 设备 → remote_port_closed(远程端口关着);没有 → not_home_network(在外面打开手机上的 TailSocks,在家连上 Wi-Fi、开着无线调试)。

带 --unattended 时,驾驶舱里没有来源为“手机桥连接恢复”的 pending、on_hold 或 failed 条目,才经 tools/Set-OwnerItem.ps1 登记一条“手机连一下:……”,写明 --purpose;已有就不重复。之后 ensure 连上会把这些条目以“AI机核:phone_direct ensure 已连上手机”关闭,手机桥重连成功也会关。

取回怎么核对
1
手机路径只收绝对文件路径,拒绝 ..、控制字符和通配符;/storage/emulated/0/ 先规范成 /sdcard/。
2
先在手机上读指纹:类型、大小、修改时间和 SHA-256,前后两次 stat 一致才算没在变;不是普通文件或是链接就拒绝。
3
拉到纯英文的暂存根 E:\Cache\PhoneDirect\staging 下一个随机名的 .part 文件;它的大小和 SHA-256 都要等于手机指纹,再读一次手机指纹也没变,才往下走。
4
挪到目标目录:已有同名且内容相同记 already_present;同名不同内容改名为“原名 (phone-哈希前 8 位)”,绝不覆盖;挪完再核一次大小和 SHA-256,修改时间设成手机上的。截图走同一套挪放和核对。
5
要删时:路径先对白名单(registries/phone_direct.json 里微信支付账单、滴滴个人信息导出两类),有一个不在就整条拒绝;删前再核一次手机指纹和电脑上的文件,删后确认手机上不存在。暂存文件不论成败最后都清掉。
连接与核对
连接顺序
1
adb 已列为在线的设备里先找这台手机;每个候选都读 ro.serialno,和手机桥配置里登记的本机手机对上才算。
2
mDNS 广播里本机手机的无线调试服务,连上再核对。
3
手机桥 E:\Data\PCConfig\PhoneBridge\peer.json 记下的上次家里端点,和家里地址上的传统调试端口(peer.json 里的手机须是本机手机);先探 TCP 再连,不通或不是本机的端点从 adb 断开,不让 adb 一直重拨死端点。前三步是收取任务、手机桥和本入口共用的 connect()。
4
局域网都不行,就走共用的 tools/phone_connection.py:先核实已有的共享远程连接,再试蓝牙(要手机桥配置里有已配对地址;手机采集 App 收到电脑的蓝牙链路后短时开加密 RFCOMM 服务,把数据转到手机本机的传统调试端口),已有共享连接直接复用,不随一次按需调用关闭。蓝牙连得上就记 route=bluetooth,不测速、也不探 Tailscale。
5
蓝牙连不上或带了 --fast,才取 Tailscale 里的 Android 设备,连它的传统调试端口并核对,记 route=tailscale。安卓节点全显示不在线时还会试最后见过的那一台:手机熄屏后可能只是和协调服务器断开,adb 还能连,所以通不通以实际连接为准,不看在线标记或 ping。带 --fast 且两条都通时,按 256KiB 测速选快的。
6
本次新建的落选线路立刻断开,选中的在命令结束时(finally)断开;原有的共享连接和家里连接保持。

传统调试端口由每半小时一次的收取在手机在家时自动打开;手机重启后会关,回家连上 Wi-Fi 才恢复,这期间蓝牙和 Tailscale 都用不了。

连不上时的判定顺序
1
手机桥判定为 pairing_required → authorize:点“允许”或用配对码配对。
2
判定为 lan_unreachable:mDNS 里有本机手机的无线调试连接记录 → repair(重新配对);没有 → enable_debugging(打开无线调试)。
3
其他情况:Tailscale 里有在线的 Android 设备 → remote_port_closed(远程端口关着);没有 → not_home_network(在外面打开手机上的 TailSocks,在家连上 Wi-Fi、开着无线调试)。

带 --unattended 时,驾驶舱里没有来源为“手机桥连接恢复”的 pending、on_hold 或 failed 条目,才经 tools/Set-OwnerItem.ps1 登记一条“手机连一下:……”,写明 --purpose;已有就不重复。之后 ensure 连上会把这些条目以“AI机核:phone_direct ensure 已连上手机”关闭,手机桥重连成功也会关。

取回怎么核对
1
手机路径只收绝对文件路径,拒绝 ..、控制字符和通配符;/storage/emulated/0/ 先规范成 /sdcard/。
2
先在手机上读指纹:类型、大小、修改时间和 SHA-256,前后两次 stat 一致才算没在变;不是普通文件或是链接就拒绝。
3
拉到纯英文的暂存根 E:\Cache\PhoneDirect\staging 下一个随机名的 .part 文件;它的大小和 SHA-256 都要等于手机指纹,再读一次手机指纹也没变,才往下走。
4
挪到目标目录:已有同名且内容相同记 already_present;同名不同内容改名为“原名 (phone-哈希前 8 位)”,绝不覆盖;挪完再核一次大小和 SHA-256,修改时间设成手机上的。截图走同一套挪放和核对。
5
要删时:路径先对白名单(registries/phone_direct.json 里微信支付账单、滴滴个人信息导出两类),有一个不在就整条拒绝;删前再核一次手机指纹和电脑上的文件,删后确认手机上不存在。暂存文件不论成败最后都清掉。
出问题时
自动连不回:
按产品层“连不上时”的表在手机上操作;电脑这边不保证多久能连回。
远程端口关着
(手机重启过):这次蓝牙和远程都取不到;回家连上家里 Wi-Fi,等下一次收取把端口打开后再取。
手机省电模式
(电量到 20% 自动开):TailSocks 和采集 App 被冻结,蓝牙和 Tailscale 同时断,只有同一个 Wi-Fi 还能连;和手机重启关端口是两回事。关掉省电模式后两条线自己恢复。
取回对不上:
那一项记 verification_failed,整条 status=partial、退出码 1;暂存文件删掉,目标目录不留半个文件,手机副本不删。
要删的不在白名单:
整条 delete_not_allowed,不拉取也不删除;加新类型要本人同意后再改 registries/phone_direct.json。
资料锁着:
退出码 3,什么都不读。
驾驶舱登记失败:
只在 JSON 里带 owner_item_error,退出码仍是 2。
远程断开失败:
status=error,reason=remote_disconnect_failed。
别碰的:
不用 Scoop 装的另一个 adb,也不 adb kill-server,那会打断常驻的手机桥。
实测和缺口
  • 10 月 21 日 19:05—19:10 各一次:在家打开传统调试端口后,手机桥约 25 秒自动连回;手机关 Wi-Fi、VPN 切到 Tailscale 后,电脑经 Tailscale 取回测试文件,两端 SHA-256 一致。
  • 同日 19:23、19:24 模拟离线各登记一条“手机连一下”,约 12 秒后由 ensure 核实关闭。
  • 之后(20:49 的 PCConfig aec9b3f9)手机桥改为没连上时每 3 秒探一次上次的家里端点、一通就重连;这一改动只有合成测试,还没有真机实测,所以页上不写重连要多久。
  • 11 月 5 日(运行说明的记录,没有重测):10:10:18 手机电量到 20% 自动开了省电模式,同一分钟蓝牙和 Tailscale 都断;13:48:34 关掉省电模式后两条线自己恢复,14:01 实连 Tailscale(约 900KB/秒)和蓝牙都通。
  • 短信、通知、截图三项,这页没查到单独的真机验收记录,算不知道。
  • 现在能不能端到端取回:不知道。11 月 6 日只跑了帮助命令,没有一个不动连接和驾驶舱事项的只读验收入口。
出问题时
自动连不回:
按产品层“连不上时”的表在手机上操作;电脑这边不保证多久能连回。
远程端口关着
(手机重启过):这次蓝牙和远程都取不到;回家连上家里 Wi-Fi,等下一次收取把端口打开后再取。
手机省电模式
(电量到 20% 自动开):TailSocks 和采集 App 被冻结,蓝牙和 Tailscale 同时断,只有同一个 Wi-Fi 还能连;和手机重启关端口是两回事。关掉省电模式后两条线自己恢复。
取回对不上:
那一项记 verification_failed,整条 status=partial、退出码 1;暂存文件删掉,目标目录不留半个文件,手机副本不删。
要删的不在白名单:
整条 delete_not_allowed,不拉取也不删除;加新类型要本人同意后再改 registries/phone_direct.json。
资料锁着:
退出码 3,什么都不读。
驾驶舱登记失败:
只在 JSON 里带 owner_item_error,退出码仍是 2。
远程断开失败:
status=error,reason=remote_disconnect_failed。
别碰的:
不用 Scoop 装的另一个 adb,也不 adb kill-server,那会打断常驻的手机桥。
实测和缺口
  • 10 月 21 日 19:05—19:10 各一次:在家打开传统调试端口后,手机桥约 25 秒自动连回;手机关 Wi-Fi、VPN 切到 Tailscale 后,电脑经 Tailscale 取回测试文件,两端 SHA-256 一致。
  • 同日 19:23、19:24 模拟离线各登记一条“手机连一下”,约 12 秒后由 ensure 核实关闭。
  • 之后(20:49 的 PCConfig aec9b3f9)手机桥改为没连上时每 3 秒探一次上次的家里端点、一通就重连;这一改动只有合成测试,还没有真机实测,所以页上不写重连要多久。
  • 11 月 5 日(运行说明的记录,没有重测):10:10:18 手机电量到 20% 自动开了省电模式,同一分钟蓝牙和 Tailscale 都断;13:48:34 关掉省电模式后两条线自己恢复,14:01 实连 Tailscale(约 900KB/秒)和蓝牙都通。
  • 短信、通知、截图三项,这页没查到单独的真机验收记录,算不知道。
  • 现在能不能端到端取回:不知道。11 月 6 日只跑了帮助命令,没有一个不动连接和驾驶舱事项的只读验收入口。
依据与来源
  • E:\.agents\skills\phone-direct\SKILL.md(.agents 0348800d) 什么时候用、连接步骤、取用规矩
  • E:\PCConfig\tools\phone_direct.py(PCConfig 7df54f9b) 子命令、输出、退出码、判定顺序、核对与删除
  • E:\PCConfig\tools\phone_personalos_pull.py 的 connect()(PCConfig aec9b3f9) 家里连接顺序
  • E:\PCConfig\tools\phone_connection.py、tools\phone_bluetooth.py(PCConfig 42c7a6e5、3928cf67、9960c93d、bc06e900) 三条线的选路、蓝牙转发和连接回收
  • 手机采集 App 的 BluetoothBridge.kt 和 README 手机端的蓝牙转发、省电模式下的表现
  • E:\PCConfig\docs\runtime\phone-direct.md 运行事实和给本人的五句话
  • E:\PCConfig\registries\phone_direct.json 暂存根和删除白名单
  • E:\PCConfig\docs\recovery\phone-link.md 常驻手机桥
  • E:\PCConfig\registries\pending_acceptance.json phone-direct-1792581836、phone-direct-1792581894 两条登记和关闭
  • E:\.agents\docs\owner-decisions\2026-10.md 10 月 21 日 18:41 的授权、19:04—19:12 的远程线决定和实测记录
依据与来源
  • E:\.agents\skills\phone-direct\SKILL.md(.agents 0348800d) 什么时候用、连接步骤、取用规矩
  • E:\PCConfig\tools\phone_direct.py(PCConfig 7df54f9b) 子命令、输出、退出码、判定顺序、核对与删除
  • E:\PCConfig\tools\phone_personalos_pull.py 的 connect()(PCConfig aec9b3f9) 家里连接顺序
  • E:\PCConfig\tools\phone_connection.py、tools\phone_bluetooth.py(PCConfig 42c7a6e5、3928cf67、9960c93d、bc06e900) 三条线的选路、蓝牙转发和连接回收
  • 手机采集 App 的 BluetoothBridge.kt 和 README 手机端的蓝牙转发、省电模式下的表现
  • E:\PCConfig\docs\runtime\phone-direct.md 运行事实和给本人的五句话
  • E:\PCConfig\registries\phone_direct.json 暂存根和删除白名单
  • E:\PCConfig\docs\recovery\phone-link.md 常驻手机桥
  • E:\PCConfig\registries\pending_acceptance.json phone-direct-1792581836、phone-direct-1792581894 两条登记和关闭
  • E:\.agents\docs\owner-decisions\2026-10.md 10 月 21 日 18:41 的授权、19:04—19:12 的远程线决定和实测记录