一个 Android 上的取件码聚合工具:把散落在菜鸟 / 京东 / 拼多多 / 抖音 / 短信 / 系统通知里的取件码,收拢到一个界面、一张桌面小组件里。
- 完全离线:不联网、不上传、无账号、无常驻服务、无广告
- 数据只在本机:SQLite 存
data/data/com.qjp.pickup,不发往任何服务器 - 不依赖 OCR、不模拟点击、不轮询:读的是各 App 已经写到本地的数据
- 手动标记优先:你点过的状态,任何自动判断都盖不掉
- 界面:黑白极简 + 暖白底,点缀色取自应用图标(黄色小鸭子)
当前为测试版
0.7.0-beta.3:项目刚开源,功能尚未稳定,欢迎反馈。 小米「超级岛」暂缓,详见下方「已知限制」。
| 能力 | 说明 |
|---|---|
| 五通道采集 | 短信、菜鸟、京东、拼多多、抖音(含抖音商城)、系统通知 |
| 打开即同步 | 启动 App 时用 root 直读四个平台的落盘文件,自动补齐所有取件码 |
| 身份码直达 | 一键跳淘宝 / 拼多多的「出示身份码」页 |
| 通知监听 | NotificationListenerService,系统托管、无常驻服务,作为零 root 兜底通道 |
| 桌面小组件 | 与 App 读同一套查询,数量/状态永远一致 |
| 待取 / 已取双 Tab | 已取码可见、可点回待取;手动标记最高优先级 |
| 数据真实性 | 以菜鸟运单的到站时间与签收状态为准,历史陈货不会混进待取 |
| 能耗治理 | mtime:size 指纹跳过:文件没变就完全不读盘;推送唤醒有 15 分钟节流 |
主要有两种用法:
-
完整模式(需 root,如 KernelSU / SukiSU / Magisk) App 启动时通过
su --mount-master直读其他 App 的私有目录,一次同步四个平台。--mount-master是必需的:KernelSU 默认把普通 App 的 root 放进隔离 mount namespace,看不到/data/user/0/<pkg>。 LSPosed 模块通道负责在目标 App 被推送唤醒、写入新数据时即时抓取。 -
零 root 兜底 只开「通知监听」授权。系统会在快递 App 发通知时把内容交给本项目解析。 覆盖面和字段完整度不如直读,但不需要 root,也不耗电(系统托管,无常驻服务)。
非 root 设备上「打开即同步」不可用;这是架构事实,不是 bug。
零 Gradle、纯命令行出包。需要 JDK 17+、Android SDK(build-tools 36.0.0、platform android-36)。
export ANDROID_HOME=/path/to/Android/Sdk
export JAVA_HOME=/path/to/jdk-17
./build.sh # 产出 build/pickup.apk
./install.sh # 装到已 root 的设备(需 adb)签名:默认用 ~/.android/debug.keystore(Android 标准 debug key),方便本地构建。
发布时用自己的密钥,全部通过环境变量提供,仓库里不含任何密钥或口令:
export QJP_KEYSTORE=/path/to/your.keystore
export QJP_KEY_ALIAS=youralias
export QJP_STORE_PASS=...
export QJP_KEY_PASS=...
./build.sh可选覆盖:ANDROID_BUILD_TOOLS、ANDROID_PLATFORM。脚本在 Linux / macOS / Windows(git-bash) 下都能跑(自动处理 .exe / .bat 后缀)。
local.properties.example 是可复制的模板,该文件不要提交。
src/ 同时包含:
ui/— 独立 App 的界面(MainActivity)hook/— LSPosed 模块入口,在目标 App 进程内监听写盘sync/— root 直读同步notify/— 通知监听 / 通知与超级岛widget/— 桌面小组件data/parse/bridge/— 存储、解析、跨进程入口
stub/ 是 Xposed API 的编译期最小接口声明(自写,见 NOTICE),不随 APK 打包。
- 在 LSPosed 里勾选模块作用域(菜鸟 / 京东 / 拼多多 / 抖音 / 抖音商城等),并重启
- 在 SukiSU / KernelSU 里给
com.qjp.pickup授权 root - 系统设置里开启「通知使用权」;HyperOS/MIUI 可能还需:
(
adb shell cmd notification allow_listener \ com.qjp.pickup/com.qjp.pickup.notify.PickupNotificationListener
settings put secure enabled_notification_listeners单独写不够,系统不会绑定。)
手动标记是最高优先级。 parcel.userMark 三态:
| 值 | 含义 | 归属 |
|---|---|---|
NULL |
听数据源 | 走自动判断 |
PENDING |
手动恢复待取 | 无条件进待取,哪怕运单已签收 |
PICKED |
手动标已取 | 无条件进已取,哪怕数据源说在途 |
数据真实性。 菜鸟包裹取走后不再下发该码的 CODE 行,parcel.status 会永远停在 PENDING;因此以 pkg.status(SIGN/SH_SIGNED/PICKED)作为权威已取证据。所有时间戳比较都用 CAST(? AS INTEGER) —— SQLite 里把 long 绑成 TEXT 与表达式比较会恒假。
能耗。 指纹跳过比缩短扫描更彻底:mtime:size 没变就完全不做 stat 之外的读盘,热启同步约 400ms。推送唤醒的 boot scan 有 15 分钟节流,不会一唤醒就读 8MB 文件。
安全边界(重要)。 EventReceiver 的 TOKEN = "qjp-v1" 只是防误投标记,不是安全边界;PickupProvider 与 EventReceiver 均为 exported=true 且不鉴权,本机任意 App 都能往列表里塞假码。这是跨进程通信的设计取舍(模块 App 被 force-stop 后仍需能被拉起),不是漏洞,但公开部署时应知晓。列表里的数据不用于任何支付或身份校验。
- 小米超级岛:焦点通知已被系统识别为
focusType=PARAMS,但未呈现为岛(折叠成状态栏胶囊),暂缓修复。 - 抖音商城(
com.ss.android.ugc.livelite)的取件码落盘位置尚未完成端到端验证(疑似 keva 的ORDER_DETAIL_CACHE_VERSION*.sgv)。 - 京东「站点名 + 准确到站时间」需进过「我的全部订单」才落盘;抖音需进过订单详情页。短信通道无需任何 App 进程。
- 无单元/自动化测试,全部为手工真机验证。
- 需要 Android 12+(minSdk 31)。
- 不申请网络权限,不收集、不上传任何个人信息
- 所有数据仅存于本机 SQLite
- 不分发、不包含任何第三方 App 的代码、资源或用户数据
- 读取的是用户自己设备上、由那些 App 已写入的本地文件
本项目以 MIT License 发布,见 LICENSE。
开发过程中参考了三个开源项目,许可关系与归属详见 NOTICE。特别说明:
badnng/Hyper-pick-up-code 为 AGPL-3.0-only,本项目仅参考其「超级岛」协议字段名与参数结构,SuperIsland.java 为独立重写,未复制其源码,因此整体不受 AGPL 约束。若日后直接引入其代码,需重新评估许可兼容性。
欢迎 Issue / PR。图标(黄色小鸭子叼白色标签)为项目自有素材,随 MIT 一并分发。
- CONTRIBUTING.md — 开发环境、测试要求、代码约定
- CHANGELOG.md — 版本历史
- SECURITY.md — 漏洞报告与已知安全边界
- PRIVACY.md — 隐私说明
- CODE_OF_CONDUCT.md — 行为准则
每个 push / PR 都会跑 tests/run_tests.sh(Java 单元 + SQL 契约 + 静态门禁,
含 LSPosed 模块身份校验)。打 v* tag 时,只有测试全部通过才会自动打包并创建 Release。
bash tests/run_tests.sh # 零外部依赖,提交前必跑