[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起
![[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起](https://s.muxui.com:8015/6krDUUgMXeBT.webp)
买东西的平台一多,取件这件事就散了。淘宝的件,菜鸟还能看见;京东和拼多多的包裹,菜鸟不展示。丰巢柜、驿站短信、购物订单各看各的,人已经到了门口,才发现还有一件没取。
我想要的不是再装四个官方 App 轮流打开,而是一部手机里的一份待取列表:取件码、到了哪、还在路上没有。ParcelHelper 按这个范围来写。它是原生 SwiftUI 的 iPhone 应用,不是菜鸟、淘宝、京东或任何快递公司的官方客户端。交互和短信解析参考过 Scripting 版「包裹助手」,但不是那个工程的 1<1>1> 复刻,界面、授权和同步都是按自己的用法重做的。
平台页面和接口会变,不保证每一单都能同步进来。真要靠这一件取快递,仍以官方页面为准。
为什么要自己收
官方 App 各自都够用,拼在一起就麻烦:
- 菜鸟擅长淘宝和自己的驿站,京东、拼多多不在里面。
- 京东、拼多多的待收货,要回各自的订单页才看得到。
- 丰巢、小米的柜和聚合,又是另一套登录。
- 取件短信躺在通知里,和验证码混在一起,过一会儿就翻不到。
所以 ParcelHelper 不做「再一个快递查询」,而是把已经授权的会话里能读到的订单、轨迹和取件码,收进同一份本地列表。读不到的,用短信、运单号补上,而不是假装全网都同步了。
它从哪把包裹收回来
| 来源 | 怎么读 | 要注意的 |
|---|---|---|
| 淘宝 / 京东 | 已登录的订单和物流页 | 页面一改、弹出验证,这一轮就会少 |
| 菜鸟 | 跟着淘宝会话去补轨迹 | 接口和分页会变,单轮补不了太多详情 |
| 拼多多 | 驿站包裹,加上购物订单网页 | 默认关闭。网页登录可能把官方 App 挤下线 |
| 丰巢 / 小米 | 各自的登录 | 会话掉了就要重新授权 |
| 取件短信 | 复制后打开 App 确认,或用快捷指令 | iOS 不让直接读短信数据库 |
| 运单号 | 快递鸟网页登录后尝试导入密钥,也可以手填 | 有的单还要手机号尾号 |
拼多多的「驿站包裹」和「购物订单」是两套数据。驿站显示 0 件,不代表购物订单里没有待收货。
首页身份码只给现在真能动态出码的淘宝、菜鸟、拼多多。做成等宽卡片,旁边有「管理」。其他平台不会塞一张假二维码冒充官方身份码。
现在长什么样
下面是我自己在用的界面。号码、地址和运单号都打过码。
取件首页
待取放在最上面,取件码直接能看见。出门前看这一屏就够,不用先想起这件是在哪个 App 里。

包裹列表
待取、在途、签收、已取件分开。可以搜、改备注;人已经把东西拿回来了,也可以手动标成已取,不必干等平台状态。

物流详情
一条包裹里看运单、驿站和轨迹。到站、派送、签收这些字,后面的提醒和小组件也是从这里来的。

设置
「刷新频率」管的是前台自动检查的最短间隔,默认 15 分钟。切到后台或锁屏之后,iOS 不会保证照这个间隔继续跑。想马上看,在 App 里下拉。

账号授权
淘宝、京东、菜鸟、丰巢、小米和快递鸟都在这一页。快递鸟可以打开官方网页登录,成功之后尝试从该账号已有的密钥列表里读取 EBusinessID / API Key,写进本机钥匙串。密码和验证码不留。 账号还没有密钥,或者网页协议变了,就用手填。

统计和驿站
取件趋势、常用驿站;轨迹里带了到站时间的,也可以看。驿站是展开卡片,可以改名,用关键词对上自动识别到的驿站,避免同一个柜子出现三个写法。

提醒停在手机上
待取的那一件可以上灵动岛、锁屏实时活动,以及主屏幕的小、中、大组件。它们显示的是已经存在手机里的快照,不是云端盯着物流再推一条。
派送、到站、签收这类通知,也是前台同步认出来之后,在本机发出的。没有自己的云账号,也没有远程推送。App 不在前台的那几个小时,不要把它当成 24 小时值班的物流机器人。
小组件和主 App 靠同一个 App Group 共享这份快照。自己签名安装时,主 App 和小组件扩展都要带上这个组;重签名签丢了,实时活动、小组件或快捷指令可能一起失效。
拼多多默认是关的
同一拼多多账号,官方 App 和网页经常只能活一个。ParcelHelper 如果去打开购物订单网页,官方 App 可能被服务端踢下线。换 UA、拦跳转、隔离 Cookie,都没法保证两个一起在线。
所以新安装默认关掉拼多多的网页授权和自动同步,包括后台那次静默读页面。要开,得到「账号授权 → 拼多多」里自己打开;点网页授权时会先警告。登录完成之后,也不会立刻再拉一次订单。
关掉开关,只是 ParcelHelper 以后不再去访问。已经被挤掉的官方登录,不会因为关了开关就自己回来。官方 App 更重要的话,保持关闭,用复制短信或运单号把那几件导进来。仍可以手动点「读取拼多多购物订单」。
短信和运单号是兜底
iOS 不让 App 去翻短信数据库,所以做不到后台把取件短信扫干净。能做的是:复制那条短信,打开 ParcelHelper 确认导入;或者用快捷指令把文字、剪贴板送进来。
平台同步漏了的单,用运单号走快递鸟。密钥可以是网页登录后自动读到的,也可以手填。部分单号还要手机号后四位,这是快递公司那边的校验,不是 App 多要一次隐私。
数据和安装
包裹写在 App 沙盒的 Documents 里。卸载,或者换了 Bundle Identifier,列表就没了,换机前先备份。
安装包是未签名的 IPA,需要自己的证书签完再装。前台会看仓库的 Releases,弹出更新说明,下载之后交给签名工具。第三方重签名可能影响实时活动、小组件、通知和快捷指令,这点装之前就得有数。
订单和物流只在你授权的会话里读。淘宝、京东、菜鸟、拼多多、丰巢、小米和各快递公司的名字、标识都属于对方。这个 App 不代表它们。
写在最后
我想收的就是菜鸟盖不住的那一部分:京东、拼多多,再加上取件码、驿站和还在路上的件,放进同一个列表。同步会漏,页面会改版,拼多多还得自己决定要不要冒着挤掉官方 App 的风险打开。这些限制都留在面上。若你也是一个平台一个 App 地查件,欢迎 Star、Issue,或者在评论里说说还想收哪一家。
相关链接
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!












