视频加载失败

[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起

1934 字
10 分钟
[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起
[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起

买东西的平台一多,取件这件事就散了。淘宝的件,菜鸟还能看见;京东和拼多多的包裹,菜鸟不展示。丰巢柜、驿站短信、购物订单各看各的,人已经到了门口,才发现还有一件没取。

我想要的不是再装四个官方 App 轮流打开,而是一部手机里的一份待取列表:取件码、到了哪、还在路上没有。ParcelHelper 按这个范围来写。它是原生 SwiftUI 的 iPhone 应用,不是菜鸟、淘宝、京东或任何快递公司的官方客户端。交互和短信解析参考过 Scripting 版「包裹助手」,但不是那个工程的 1<1> 复刻,界面、授权和同步都是按自己的用法重做的。

平台页面和接口会变,不保证每一单都能同步进来。真要靠这一件取快递,仍以官方页面为准。

为什么要自己收#

官方 App 各自都够用,拼在一起就麻烦:

  • 菜鸟擅长淘宝和自己的驿站,京东、拼多多不在里面。
  • 京东、拼多多的待收货,要回各自的订单页才看得到。
  • 丰巢、小米的柜和聚合,又是另一套登录。
  • 取件短信躺在通知里,和验证码混在一起,过一会儿就翻不到。

所以 ParcelHelper 不做「再一个快递查询」,而是把已经授权的会话里能读到的订单、轨迹和取件码,收进同一份本地列表。读不到的,用短信、运单号补上,而不是假装全网都同步了。

它从哪把包裹收回来#

来源怎么读要注意的
淘宝 / 京东已登录的订单和物流页页面一改、弹出验证,这一轮就会少
菜鸟跟着淘宝会话去补轨迹接口和分页会变,单轮补不了太多详情
拼多多驿站包裹,加上购物订单网页默认关闭。网页登录可能把官方 App 挤下线
丰巢 / 小米各自的登录会话掉了就要重新授权
取件短信复制后打开 App 确认,或用快捷指令iOS 不让直接读短信数据库
运单号快递鸟网页登录后尝试导入密钥,也可以手填有的单还要手机号尾号

拼多多的「驿站包裹」和「购物订单」是两套数据。驿站显示 0 件,不代表购物订单里没有待收货。

首页身份码只给现在真能动态出码的淘宝、菜鸟、拼多多。做成等宽卡片,旁边有「管理」。其他平台不会塞一张假二维码冒充官方身份码。

现在长什么样#

下面是我自己在用的界面。号码、地址和运单号都打过码。

取件首页#

待取放在最上面,取件码直接能看见。出门前看这一屏就够,不用先想起这件是在哪个 App 里。

ParcelHelper 取件首页
ParcelHelper 取件首页

包裹列表#

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

ParcelHelper 包裹列表
ParcelHelper 包裹列表

物流详情#

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

ParcelHelper 物流详情
ParcelHelper 物流详情

设置#

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

ParcelHelper 设置
ParcelHelper 设置

账号授权#

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

ParcelHelper 账号授权
ParcelHelper 账号授权

统计和驿站#

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

ParcelHelper 统计
ParcelHelper 统计

提醒停在手机上#

待取的那一件可以上灵动岛、锁屏实时活动,以及主屏幕的小、中、大组件。它们显示的是已经存在手机里的快照,不是云端盯着物流再推一条。

派送、到站、签收这类通知,也是前台同步认出来之后,在本机发出的。没有自己的云账号,也没有远程推送。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,或者在评论里说说还想收哪一家。

相关链接#

O96u
/
ParcelHelper
包裹助手,基于 SwiftUI 的开源 iOS 快递管理工具|订单同步、物流追踪、取件码、灵动岛与智能提醒
—
—
GPL-3.0
Swift

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

[开源] ParcelHelper - 把京东和拼多多的包裹也收在一起
https://muxui.com/posts/parcelhelper-ios-package-aggregator/
作者
Muxui
发布于
2026-11-19
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
Muxui
写代码、记笔记,把折腾过的东西留给未来的自己。
公告
欢迎来到我的博客!这是一则示例公告。
统计
分类
标签
站点统计
文章
24
分类
3
标签
30
总字数
62,435
运行时长
0 天
天气预报
定位中...
----
高温 --°C / 低温 --°C
站点信息
构建平台
GitHub Actions
博客版本
Firefly v6.16.9
文章许可
CC BY-NC-SA 4.0
文章目录