Skip to content

About

取件码 — 离线聚合菜鸟/京东/拼多多/抖音/短信/通知里的取件码,一个界面 + 桌面小组件。完全离线、不联网、不上传。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

取件码 (qjp)

一个 Android 上的取件码聚合工具:把散落在菜鸟 / 京东 / 拼多多 / 抖音 / 短信 / 系统通知里的取件码,收拢到一个界面、一张桌面小组件里。

  • 完全离线:不联网、不上传、无账号、无常驻服务、无广告
  • 数据只在本机:SQLite 存 data/data/com.qjp.pickup,不发往任何服务器
  • 不依赖 OCR、不模拟点击、不轮询:读的是各 App 已经写到本地的数据
  • 手动标记优先:你点过的状态,任何自动判断都盖不掉
  • 界面:黑白极简 + 暖白底,点缀色取自应用图标(黄色小鸭子)

当前为测试版 0.7.0-beta.3:项目刚开源,功能尚未稳定,欢迎反馈。 小米「超级岛」暂缓,详见下方「已知限制」。


它能做什么

能力 说明
五通道采集 短信、菜鸟、京东、拼多多、抖音(含抖音商城)、系统通知
打开即同步 启动 App 时用 root 直读四个平台的落盘文件,自动补齐所有取件码
身份码直达 一键跳淘宝 / 拼多多的「出示身份码」页
通知监听 NotificationListenerService,系统托管、无常驻服务,作为零 root 兜底通道
桌面小组件 与 App 读同一套查询,数量/状态永远一致
待取 / 已取双 Tab 已取码可见、可点回待取;手动标记最高优先级
数据真实性 以菜鸟运单的到站时间与签收状态为准,历史陈货不会混进待取
能耗治理 mtime:size 指纹跳过:文件没变就完全不读盘;推送唤醒有 15 分钟节流

为什么需要 root

主要有两种用法:

  1. 完整模式(需 root,如 KernelSU / SukiSU / Magisk) App 启动时通过 su --mount-master 直读其他 App 的私有目录,一次同步四个平台。 --mount-master 是必需的:KernelSU 默认把普通 App 的 root 放进隔离 mount namespace,看不到 /data/user/0/<pkg>。 LSPosed 模块通道负责在目标 App 被推送唤醒、写入新数据时即时抓取。

  2. 零 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 是可复制的模板,该文件不要提交。

模块与 App 的关系

src/ 同时包含:

  • ui/ — 独立 App 的界面(MainActivity)
  • hook/ — LSPosed 模块入口,在目标 App 进程内监听写盘
  • sync/ — root 直读同步
  • notify/ — 通知监听 / 通知与超级岛
  • widget/ — 桌面小组件
  • data/ parse/ bridge/ — 存储、解析、跨进程入口

stub/ 是 Xposed API 的编译期最小接口声明(自写,见 NOTICE),不随 APK 打包。

安装后需要做的

  1. 在 LSPosed 里勾选模块作用域(菜鸟 / 京东 / 拼多多 / 抖音 / 抖音商城等),并重启
  2. 在 SukiSU / KernelSU 里给 com.qjp.pickup 授权 root
  3. 系统设置里开启「通知使用权」;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 一并分发。

参与贡献

每个 push / PR 都会跑 tests/run_tests.sh(Java 单元 + SQL 契约 + 静态门禁, 含 LSPosed 模块身份校验)。打 v* tag 时,只有测试全部通过才会自动打包并创建 Release。

bash tests/run_tests.sh   # 零外部依赖,提交前必跑

About

取件码 — 离线聚合菜鸟/京东/拼多多/抖音/短信/通知里的取件码,一个界面 + 桌面小组件。完全离线、不联网、不上传。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages