[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起
![[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起](https://s.muxui.com:8015/6krDUUgMXeBT.webp)
买东西的平台一多,取件这件事就散了。淘宝的件,菜鸟还能看见;京东和拼多多的包裹,菜鸟不展示。丰巢柜、驿站短信、购物订单各看各的,人已经到了门口,才发现还有一件没取。
我想要的不是再装四个官方 App 轮流打开,而是一部手机里的一份待取列表:取件码、到了哪、还在路上没有。家里不止一个号,也要能分开授权、合在同一份列表里看。ParcelHelper 按这个范围来写。它是原生 SwiftUI 的 iPhone 应用,不是菜鸟、淘宝、京东或任何快递公司的官方客户端。交互和短信解析参考过 Scripting 版「包裹助手」,但不是那个工程的 1<1>1> 复刻,界面、授权和同步都是按自己的用法重做的。
平台页面和接口会变,不保证每一单都能同步进来。真要靠这一件取快递,仍以官方页面为准。
为什么要自己收
官方 App 各自都够用,拼在一起就麻烦:
- 菜鸟擅长淘宝和自己的驿站,京东、拼多多不在里面。
- 京东、拼多多的待收货,要回各自的订单页才看得到。
- 丰巢、小米的柜和聚合,又是另一套登录。
- 家里有两个淘宝或两个京东,官方 App 通常一次只方便登一个。
- 取件短信躺在通知里,和验证码混在一起,过一会儿就翻不到。
所以 ParcelHelper 不做「再一个快递查询」,而是把已经授权的会话里能读到的订单、轨迹和取件码,收进同一份本地列表。读不到的,用短信、运单号补上,而不是假装全网都同步了。
它从哪把包裹收回来
| 来源 | 怎么读 | 要注意的 |
|---|---|---|
| 淘宝 / 京东 | 每个账号各自登录的订单和物流页 | 页面一改、弹出验证,这一轮就会少 |
| 菜鸟 | 跟着对应的淘宝账号去补轨迹 | 接口和分页会变,单轮补不了太多详情 |
| 拼多多 | 驿站包裹,加上购物订单网页 | 默认关闭。小号可以去官方页关联大号收件手机号 |
| 丰巢 / 小米 | 丰巢按手机号分别验证;小米是一个号绑多个取件号 | 会话掉了就要重新授权 |
| 抖音 | 手动导入物流单号 | 不是再登录一个抖音账号 |
| 取件短信 | 复制后打开 App 确认,或用快捷指令 | iOS 不让直接读短信数据库 |
| 运单号 | 快递鸟网页登录后尝试导入密钥,也可以手填 | 有的单还要手机号尾号 |
拼多多的「驿站包裹」和「购物订单」是两套数据。驿站显示 0 件,不代表购物订单里没有待收货。
首页身份码给现在真能动态出码的淘宝、菜鸟、拼多多和京东,而且只显示各平台的默认账号。京东走官方身份页上的条形码,可以刷新、到点换码,点一下放大。没拿到有效码、账号过期或这次加载失败,就不拿一张旧码充数,也不会做一张假二维码冒充官方身份码。
一个平台可以有多个号
「设置 → 账号授权」里,淘宝 / 菜鸟、京东、拼多多、丰巢都可以再加一个号:改备注、设成默认、单独同步,或者解除授权。首页和包裹列表仍是一份,同一个运单号按现有规则去重,并记下这件属于哪个账号。手动同步和前台自动刷新会把已授权的号逐个看一遍。
- 淘宝和菜鸟共用一份账号列表。每个号单独存网页登录数据,身份码用当前默认的那个。
- 京东每个号分开登录、分开读订单页,避免 Cookie 互相盖掉。身份条形码只读默认账号自己的会话。
- 丰巢不同手机号各自收短信验证,Token 按账号放进钥匙串。
- 小米还是一个小米账号绑定多个取件手机号,不是同时登好几个小米网页。
隔开的是 ParcelHelper 里面的登录数据。平台自己的登录互斥、安全校验和服务器权限,不会因为本机分成了几个格子就消失。
现在长什么样
下面是现在的宣传图。号码、地址和运单号都打过码。
取件首页
待取放在最上面。淘宝、菜鸟、拼多多、京东四张身份码并排,驿站取件码归在下面。出门前看这一屏就够,不用先想起这件是在哪个 App 里。

包裹列表
在途、待取、已完成分开,数量写在顶上。可以搜,也可以把短信或运单号手动导进来;人已经把东西拿回来了,也可以标成已取,不必干等平台状态。

统计和驿站
待取、运输、签收和已取件是分开数的。取件趋势按月看已取的件数;常用驿站按取件数量排。轨迹里带了到站时间的,下面还有平均到站时间。驿站可以改名,用关键词对上自动识别到的写法,避免同一个柜子出现三个名字。

设置
账号授权、快捷指令、驿站、身份码、取件提醒、灵动岛、小组件和刷新频率都从这里进。「刷新频率」管的是前台自动检查的最短间隔,默认 15 分钟。

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

主屏幕小组件
小、中、大三种。待取优先,空下来的位置可以带上在途。它们画的是已经在手机里的快照,不是云端盯着物流再推一条。设置里能看到当前签名能不能访问 App Group;签丢了,组件就读不到这份快照。

提醒停在手机上
待取的那一件可以上灵动岛、锁屏实时活动,以及主屏幕的小组件。派送、到站、签收这类通知,也是同步认出来之后在本机发出的。没有自己的云账号,也没有远程推送。
锁屏或切到后台之后,系统可以再找机会跑一轮更省电的刷新,但只走小米、丰巢这种原生接口,不会在后台打开淘宝、京东、拼多多的网页。建议间隔会按包裹紧不紧急拉开:有待取时不少于 30 分钟,只有在途时不少于 3 小时,没有活跃包裹时不少于 12 小时,而且还要再和你设的刷新频率取更长的那个。iOS 经常把这个时间再往后推,App 被划掉之后也不保证还会跑。想马上对上,在 App 里下拉。
小组件只读这份本地快照。画面没变的时候,不会为了一个新的同步时间戳把时间线重画一遍;灵动岛状态没变,也不会重复刷一次。
小组件和主 App 靠同一个 App Group 共享快照。自己签名安装时,主 App 和小组件扩展都要带上这个组;重签名签丢了,实时活动、小组件或快捷指令可能一起失效。
拼多多默认是关的
同一拼多多账号,官方 App 和网页经常只能活一个。ParcelHelper 如果去打开购物订单网页,官方 App 可能被服务端踢下线。换 UA、拦跳转、隔离 Cookie,都没法保证两个一起在线。
所以新安装默认关掉拼多多的网页授权和自动同步,包括后台那次静默读页面。要开,得到「账号授权 → 拼多多」里自己打开;点网页授权时会先警告。每新加一个拼多多账号,都会再确认一次这个风险。登录完成之后,也不会立刻再拉一次订单。
关掉开关,只是 ParcelHelper 以后不再去访问。已经被挤掉的官方登录,不会因为关了开关就自己回来。官方 App 更重要的话,保持关闭,用复制短信或运单号把那几件导进来。仍可以手动点「读取拼多多购物订单」。
若只是想看见大号手机号收到的驿站件,可以用一个拼多多小号在 ParcelHelper 里登录,再打开网页授权,走到拼多多官方的号码管理页,把大号的收件手机号验证进去。回来同步这个小号,就会尝试读取平台允许这个号码看到的驿站包裹。不用在这里登录大号,也不是把两个购物账号并成一个。购物订单能不能读到,仍看你实际登录的那个号。
短信和运单号是兜底
iOS 不让 App 去翻短信数据库,所以做不到后台把取件短信扫干净。能做的是:复制那条短信,打开 ParcelHelper 确认导入;或者用快捷指令把文字、剪贴板送进来。
平台同步漏了的单,用运单号走快递鸟。抖音也是这条路:账号页里它不是再授权一个 App,而是把物流单号手动导进来,列表里能看出来源。密钥可以是网页登录后自动读到的,也可以手填。部分单号还要手机号后四位,这是快递公司那边的校验,不是 App 多要一次隐私。
数据和安装
包裹写在 App 沙盒的 Documents 里。卸载,或者换了 Bundle Identifier,列表就没了,换机前先备份。
安装包是未签名的 IPA,需要自己的证书签完再装。前台会看仓库的 Releases,弹出更新说明,下载之后交给签名工具。第三方重签名可能影响实时活动、小组件、通知和快捷指令,这点装之前就得有数。
订单和物流只在你授权的会话里读。淘宝、京东、菜鸟、拼多多、丰巢、小米、抖音和各快递公司的名字、标识都属于对方。这个 App 不代表它们。
版本轨迹
- 2026-11-20v1.2.1
淘宝、京东、拼多多、丰巢可以各管多个账号。拼多多小号可以走官方页面关联大号收件手机号。京东默认账号显示官方身份条形码。后台按包裹紧不紧急做一轮更省电的接口刷新,小组件和灵动岛只在画面真有变化时更新。
- 2026-11-19v1.2.0
主屏幕小、中、大组件,灵动岛和锁屏实时活动。App 内查看更新说明。拼多多网页授权默认关闭。
写在最后
我想收的就是菜鸟盖不住的那一部分:京东、拼多多,再加上家里多出来的那几个号、取件码、驿站和还在路上的件,放进同一个列表。同步会漏,页面会改版,后台也不会准点叫醒你,拼多多还得自己决定要不要冒着挤掉官方 App 的风险打开。这些限制都留在面上。若你也是一个平台一个 App 地查件,欢迎 Star、Issue,或者在评论里说说还想收哪一家。
相关链接
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!












