# 短信取件码

**Repository Path**: echooooooo/qujianma

## Basic Information

- **Project Name**: 短信取件码
- **Description**: 基于UniApp编写的获取手机短信中的取件码，整理成列表，方便取件，可以标记为已取，纯本地
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 取件通 - 快递取件码管理工具

<div align="center">

📦 **智能管理您的快递取件码**

基于 uniapp 开发的 Android 应用  
自动读取快递短信 | 智能解析取件码 | 便捷状态管理

[快速开始](快速开始.md) · [使用指南](使用指南.md) · [开发文档](开发者文档.md) · [部署说明](部署说明.md)

</div>

---

## ✨ 功能特点

- 📱 **自动读取手机短信** - 无需手动查找，应用自动获取
- 🔍 **智能解析取件码** - 支持多种快递商，精准识别
- 📋 **清晰的列表展示** - 卡片式设计，信息一目了然
- ✅ **状态管理** - 标记已取/待取，井井有条
- 🔄 **一键刷新** - 快速同步最新短信数据
- 🔐 **安全可靠** - 本地处理，保护隐私安全
- 💾 **数据持久化** - 本地存储，状态永久保存

## 🚀 快速开始

### 方式一：使用 HBuilderX（推荐）

```bash
1. 下载并安装 HBuilderX
2. 打开项目文件夹
3. 连接 Android 手机（开启 USB 调试）
4. 点击运行 → 运行到 Android App 基座
5. 在手机上授予短信读取权限
```

### 方式二：直接安装 APK

```bash
1. 云打包生成 APK 文件
2. 传输到 Android 手机
3. 安装并运行
4. 授予必要权限
```

📖 **详细步骤**: 查看 [快速开始.md](快速开始.md) - 5分钟快速上手

## 📱 支持的快递服务商

| 快递商 | 支持状态 | 示例格式 |
|--------|---------|---------|
| 🐰 兔喜生活 | ✅ 完全支持 | 【兔喜生活】您有包裹已到达...取件码为23167 |
| 📦 菜鸟驿站 | ✅ 完全支持 | 【菜鸟驿站】您的快递已到达...取件码为45678 |
| 🦅 丰巢 | ✅ 完全支持 | 【丰巢】您的包裹已存入...取件码为89012 |
| 🔧 其他快递 | ⚠️ 部分支持 | 包含"取件码"关键字的通用格式 |

💡 **提示**: 如您使用的快递商不在列表中，可提交 Issue 或查看[开发者文档](开发者文档.md)自行添加。

## 🛠️ 开发环境

### 必需工具
- **HBuilderX** 3.0+ - [下载地址](https://www.dcloud.io/hbuilderx.html)
- **Android 手机** 或模拟器（Android 7.0+）

### 可选工具
- Android Studio (用于查看日志)
- Node.js (用于依赖管理)

## 📦 安装部署

### 开发环境运行

```bash
# 1. 使用 HBuilderX 打开项目
文件 → 打开目录 → 选择 qujianma 文件夹

# 2. 连接 Android 设备
开启 USB 调试模式，连接电脑

# 3. 运行项目
运行 → 运行到手机或模拟器 → 运行到 Android App 基座
```

### 生产环境打包

```bash
# 云打包（推荐）
发行 → 原生 App-云打包 → 选择 Android → 打包

# 本地打包
发行 → 原生 App-本地打包 → 配置签名 → 打包
```

📖 **详细步骤**: 查看 [部署说明.md](部署说明.md)

## 权限说明

应用需要以下权限：

- `READ_SMS` - 读取短信内容，用于解析快递信息
- `RECEIVE_SMS` - 接收短信（预留功能）
- `READ_PHONE_STATE` - 读取手机状态

## 使用说明

1. 首次打开应用会请求短信读取权限
2. 授权后会自动读取最近 30 天的快递短信
3. 点击列表项可查看取件详情
4. 点击底部刷新按钮重新读取短信
5. 在详情页可标记取件状态

## 短信格式示例

```
【兔喜生活】您有包裹已到达金宸店，取件码为23167，地址:金宸公馆西门
【菜鸟驿站】您的快递已到达，取件码为45678，地址:万达广场菜鸟驿站
【丰巢】您的包裹已存入丰巢柜，取件码为89012
```

## 项目结构

```
qujianma/
├── pages/              # 页面目录
│   └── index/         # 首页
├── static/            # 静态资源
│   ├── css/          # 样式文件
│   └── images/       # 图片资源
├── utils/             # 工具类
│   ├── smsReader.js  # 短信读取工具
│   └── smsParser.js  # 短信解析工具
├── App.vue            # 应用配置
├── main.js            # 入口文件
├── manifest.json      # 应用清单
├── pages.json         # 页面配置
└── package.json       # 依赖配置
```

## 💻 技术栈

```
Frontend         Backend          Platform
  Vue.js    →    5+ Runtime   →   Android
  uniapp    →    Native API   →   APK
```

- **框架**: uniapp (Vue.js 2.x)
- **开发工具**: HBuilderX
- **原生能力**: 5+ Runtime (HTML5+)
- **目标平台**: Android 7.0+

## 📐 项目架构

```
┌─────────────────────────────────────┐
│         index.vue (主页面)           │
│  ┌─────────────────────────────┐   │
│  │ 标签栏 | 列表 | 详情 | 刷新  │   │
│  └─────────────────────────────┘   │
└──────────┬──────────────────────────┘
           │
    ┌──────┴──────┐
    ↓             ↓
┌─────────┐  ┌──────────┐
│smsReader│  │smsParser │
│ (读取)  │  │  (解析)  │
└────┬────┘  └────┬─────┘
     │            │
     ↓            ↓
┌────────────────────┐
│  Android Native    │
│  ContentProvider   │
└────────────────────┘
```

## 📚 文档导航

| 文档 | 说明 | 适合人群 |
|------|------|---------|
| [快速开始.md](快速开始.md) | 5分钟快速上手指南 | 🔰 新手用户 |
| [使用指南.md](使用指南.md) | 详细的使用说明 | 👤 普通用户 |
| [开发者文档.md](开发者文档.md) | 技术实现详解 | 👨‍💻 开发者 |
| [部署说明.md](部署说明.md) | 完整的部署流程 | 🚀 运维人员 |
| [项目总览.md](项目总览.md) | 项目整体介绍 | 📋 项目管理 |
| [log.md](log.md) | 开发日志记录 | 📝 开发团队 |

## 🎯 使用场景

- ✅ 经常收快递，取件码难找
- ✅ 短信太多，快递信息被淹没
- ✅ 多个快递码容易混淆
- ✅ 需要管理取件状态
- ✅ 希望保护隐私（本地处理）

## 🔐 隐私安全

- ✅ **本地处理**: 所有数据仅在手机本地处理
- ✅ **无需网络**: 不上传任何数据到服务器
- ✅ **开源透明**: 代码完全开源，可审计
- ✅ **权限最小化**: 仅申请必需的短信读取权限
- ✅ **用户可控**: 可随时撤销权限或卸载应用

## 🐛 已知问题

- Android 11+ 部分机型可能需要手动授权短信权限
- MIUI/EMUI 等定制系统可能需要额外设置
- 部分不规范的快递短信可能无法识别

## 🔮 路线图

### v1.0.0 ✅ (当前版本)
- [x] 基础短信读取功能
- [x] 多快递商解析支持
- [x] 取件状态管理
- [x] 本地数据存储

### v1.1.0 (计划中)
- [ ] 取件码复制功能
- [ ] 暗黑模式支持
- [ ] 更多快递商支持
- [ ] 界面动画优化

### v1.5.0 (规划中)
- [ ] 实时短信监听
- [ ] 通知提醒功能
- [ ] 数据统计图表
- [ ] 取件地图导航

### v2.0.0 (远期规划)
- [ ] 云端同步
- [ ] iOS 版本
- [ ] 小程序版本
- [ ] 多语言支持

## 🤝 贡献指南

欢迎贡献代码、报告问题或提出建议！

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m '添加某个功能'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 📄 开源协议

本项目采用 [MIT License](LICENSE) 开源协议。

## 👨‍💻 作者

**开发团队**

- 项目创建: 2026-01-22
- 当前版本: v1.0.0

## 📞 联系方式

- 🐛 **问题反馈**: 提交 Issue
- 💡 **功能建议**: 提交 Issue
- 📧 **邮件联系**: [待补充]

## ⭐ Star History

如果这个项目对您有帮助，请给我们一个 Star ⭐

---

<div align="center">

**使用愉快！** 📦✨

Made with ❤️ by 开发团队

</div>