云雀 · 快递助手

●云雀快递助手 一个本地优先的 Android 快递聚合应用：把不同平台的快递统一收进一个列表，支持 AI 日报、定时提醒和快递跟踪通知。

●功能 ・多源绑定：小米 / 京东 / 淘宝（菜鸟）/ 拼多多，每个平台可绑定一个或多个账号 在途优先首页：主页只展示在途（派送中 / 已发货 / 未发货）；已完成与异常包裹进入二级面板（右下角「已完成」胶囊）

・二级面板：搜索 / 日历 / 异常包裹（与首页在途域隔离）、真月历、悬浮分页 + 页码跳页、单页件数自适应屏幕（本机 8 卡/屏）

・流式渐进同步：每批新单立即出现；在途先加载、完成/异常一轮收尾后入库；首批到达即停转圈

・完整物流轨迹、预计送达时间、运输进度、取件码

・快递跟踪：被跟踪的快递有新动态时发本地通知

・后台轮询可配置（设置 → 快递轮询）：默认关闭；开启跟踪自动默认 15 分钟；只轮询「有在途跟踪件」的平台；日报生成前先等同步完成

・京东 / 淘宝 / 拼多多 / 小米轨迹缓存（详情首次加载后秒开）

・AI 问询：读取本地快递数据，接入任意 OpenAI 兼容接口（默认 DeepSeek） 定时日报：多个定时、仅一次 / 每天 / 工作日 / 周末 / 自定义星期重复规则 快递100 兜底查询（可选）

・无障碍导入：从菜鸟裹裹 / 淘宝页面读取快递（可选下策）

・AI 助手“云雀”：工具调用（改名 / 改状态 / 移分区 / 开关跟踪 / 同步）、回答内贴快递卡片、预制问题 快递日历：月历视图，标记今天与预计到达日期

・AI 运输进度与预计送达时间（结合你保存的地址）

・设置里的“我的地址”：自动定位或手动填写

・本地 CLI 与 MCP 风格 JSON-RPC 接口，方便外部集成

・无广告、无统计、数据只存在本地

●环境要求： JDK 17 Android SDK（compileSdk 36） Android Studio 或命令行 Gradle

./gradlew :app:assembleDebug

●使用 1.在设置里按平台登录（H5 登录）：小米（需 Shizuku 授权）、京东、淘宝、拼多多。 2.首页下拉同步：在途立即出现；完成/异常随后进入二级面板。 3.可选：在“更多连接方式”里填快递100 key 作为兜底。 4.可选：在“设置 → 快递日报”里填 AI 接口地址和 API Key（默认 DeepSeek），然后配置定时日报。 5.长按任意快递卡片即可开启跟踪（自动开启 15 分钟后台轮询）、改名或移除。

*淘宝件同步不上时，请在淘宝的隐私设置里关闭“订单号码保护”后再下单。

●隐私 ・所有快递数据、登录令牌、AI Key 都只保存在手机本地（SharedPreferences），不上传任何服务器。 ・项目本身不包含任何后端，网络请求只发给你自己配置的服务（小米、京东、淘宝、拼多多、快递100、菜鸟等）。 ・代码中不含任何真实手机号、快递单号或密钥。

⚠️免责声明： 本项目与小米、菜鸟、淘宝、京东、拼多多、快递100 等公司均无任何隶属或合作关系，不保证接口稳定性。 请勿用于商业用途。

🎯 Project author:github@Halo0sama