217 lines
6.6 KiB
Markdown
217 lines
6.6 KiB
Markdown
# BandTOTP 身份验证器
|
||
|
||
<div align="center">
|
||
|
||
|
||
|
||
|
||
|
||
|
||
**一款现代化的TOTP身份验证器应用，支持小米手环同步**
|
||
|
||
*安全 • 美观 • 高效 • 现代化*
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 🌟 项目概述
|
||
|
||
BandTOTP 是一款基于 Google Authenticator 设计风格的现代化双因子身份验证器应用，采用 Material Design 3 设计语言，不仅支持传统的TOTP验证码生成，更具备与小米手环的无缝同步功能，让您的验证码随时随地触手可及。
|
||
|
||
### ✨ 核心特性
|
||
|
||
- **🎨 现代化UI**: 基于 Jetpack Compose + Material Design 3
|
||
- **📱 多种添加方式**: 二维码扫描、文件导入、手动添加
|
||
- **⌚ 手环同步**: 完整的小米手环双向同步功能
|
||
- **🔒 安全可靠**: 本地存储，支持多种TOTP算法
|
||
- **🎯 用户友好**: 直观的界面设计和流畅的动画效果
|
||
|
||
---
|
||
|
||
## 📸 应用截图
|
||
|
||
> 注：可在此处添加应用的实际截图展示主要功能界面
|
||
|
||
---
|
||
|
||
## 🚀 功能特色
|
||
|
||
### 🔐 验证码管理
|
||
- **实时生成**: 支持标准TOTP和Steam格式验证码
|
||
- **智能识别**: 自动识别服务类型并显示对应图标
|
||
- **倒计时显示**: 圆形进度条，剩余时间直观可见
|
||
- **拖拽排序**: 长按拖拽自定义账户顺序
|
||
|
||
### 📲 多样化添加方式
|
||
- **📷 相机扫码**: 集成 CameraX + ML Kit 专业扫码体验
|
||
- **📁 文件导入**: 支持标准格式和Steam JSON导入
|
||
- **✏️ 手动添加**: 完整参数配置，支持自定义算法
|
||
|
||
### ⌚ 智能手环同步
|
||
- **双向同步**: 手机与手环账户互相同步
|
||
- **状态可视化**: 实时显示同步状态（仅手机/仅手环/已同步）
|
||
- **批量操作**: 一键同步所有账户到指定设备
|
||
- **冲突处理**: 智能合并去重，避免数据冲突
|
||
|
||
### 🎨 用户体验
|
||
- **Material You**: 动态主题色彩系统
|
||
- **流畅动画**: 精心设计的页面转场和交互动画
|
||
- **手势操作**: 支持左滑删除、双指缩放等直观操作
|
||
- **无障碍支持**: 完整的无障碍功能支持
|
||
|
||
---
|
||
|
||
## 🛠 技术架构
|
||
|
||
### 核心技术栈
|
||
- **开发语言**: Kotlin 2.0.21
|
||
- **UI框架**: Jetpack Compose + Material Design 3
|
||
- **架构模式**: MVVM + Repository
|
||
- **异步处理**: Kotlin Coroutines
|
||
- **相机扫码**: CameraX + ML Kit Barcode Scanning
|
||
- **数据存储**: SharedPreferences + JSON序列化
|
||
- **小米手环**: XMS Wearable SDK
|
||
|
||
### 项目结构
|
||
```
|
||
app/src/main/java/cn/deepfal/band/TOTPauthenticator/
|
||
├── MainActivity.kt # 主Activity - 现代化设计
|
||
├── data/
|
||
│ └── TOTPInfo.kt # TOTP数据模型
|
||
├── components/
|
||
│ ├── ModernTOTPCard.kt # 现代化验证码卡片
|
||
│ ├── AddComponents.kt # 添加相关组件
|
||
│ ├── ReorderableBandAccountsList.kt # 可重排序手环账户列表
|
||
│ └── SyncScreen.kt # 同步管理界面
|
||
├── scanner/
|
||
│ └── QRCodeScanner.kt # 专业二维码扫描器
|
||
├── sync/
|
||
│ └── SyncManager.kt # 同步逻辑管理
|
||
├── ui/theme/ # Material Design主题配置
|
||
└── utils/
|
||
├── LocalAccountManager.kt # 本地存储管理
|
||
└── TOTPGenerator.kt # TOTP算法实现
|
||
```
|
||
|
||
### 关键依赖
|
||
```kotlin
|
||
// Jetpack Compose 生态
|
||
implementation(platform("androidx.compose:compose-bom:2024.12.01"))
|
||
implementation("androidx.compose.material3:material3")
|
||
implementation("androidx.compose.material:material-icons-extended")
|
||
|
||
// 相机与扫码
|
||
implementation("androidx.camera:camera-camera2:1.3.1")
|
||
implementation("com.google.mlkit:barcode-scanning:17.2.0")
|
||
|
||
// 小米可穿戴SDK
|
||
implementation(files("libs/xms-wearable-lib_1.4_release.aar"))
|
||
|
||
// 拖拽排序
|
||
implementation("org.burnoutcrew.composereorderable:reorderable:0.9.6")
|
||
```
|
||
|
||
---
|
||
|
||
## 📦 构建与运行
|
||
|
||
### 环境要求
|
||
- **Android Studio**: Hedgehog | 2023.1.1 或更高版本
|
||
- **Gradle**: 8.12.0
|
||
- **Kotlin**: 2.0.21
|
||
- **目标SDK**: 36 (Android 14)
|
||
- **最低SDK**: 28 (Android 9.0)
|
||
|
||
### 快速开始
|
||
|
||
1. **克隆项目**
|
||
```bash
|
||
git clone https://github.com/your-username/BandTOTP-APP.git
|
||
cd BandTOTP-APP
|
||
```
|
||
|
||
2. **配置签名** (可选)
|
||
|
||
创建 `keystore.properties` 文件：
|
||
```properties
|
||
debug.store.file=keystore/keystore.jks
|
||
debug.store.password=your_password
|
||
debug.key.alias=your_alias
|
||
debug.key.password=your_password
|
||
|
||
release.store.file=keystore/keystore.jks
|
||
release.store.password=your_password
|
||
release.key.alias=your_alias
|
||
release.key.password=your_password
|
||
```
|
||
|
||
3. **构建运行**
|
||
```bash
|
||
./gradlew assembleDebug
|
||
./gradlew installDebug
|
||
```
|
||
|
||
### 小米手环配置
|
||
|
||
要使用手环同步功能，需要：
|
||
|
||
1. **安装手环应用**: 在小米手环上安装对应的TOTP应用
|
||
2. **权限配置**: 应用会自动申请必要的蓝牙和设备管理权限
|
||
3. **设备配对**: 确保手环已通过小米穿戴应用正确配对
|
||
|
||
---
|
||
|
||
## 🔧 配置说明
|
||
|
||
### 权限说明
|
||
```xml
|
||
<!-- 蓝牙通信 -->
|
||
<uses-permission android:name="android.permission.BLUETOOTH" />
|
||
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
|
||
|
||
<!-- 相机扫码 -->
|
||
<uses-permission android:name="android.permission.CAMERA" />
|
||
|
||
<!-- 文件读取 -->
|
||
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
|
||
```
|
||
|
||
### 支持的导入格式
|
||
|
||
- **标准TOTP URL**: `otpauth://totp/Service:user@example.com?secret=...`
|
||
- **Steam JSON**: Steam Guard导出的JSON格式
|
||
- **文本文件**: 包含上述格式的纯文本文件
|
||
|
||
---
|
||
|
||
## 📱 使用说明
|
||
|
||
### 基本操作
|
||
|
||
1. **添加账户**
|
||
- 点击右下角"+"按钮
|
||
- 选择扫码、导入文件或手动添加
|
||
- 按照提示完成添加流程
|
||
|
||
2. **管理账户**
|
||
- 左滑账户卡片查看编辑/删除选项
|
||
- 长按进入排序模式，拖拽调整顺序
|
||
- 点击验证码自动复制到剪贴板
|
||
|
||
3. **手环同步**
|
||
- 点击同步按钮进入同步界面
|
||
- 查看手机和手环的账户状态
|
||
- 使用批量同步功能管理设备间数据
|
||
|
||
### 高级功能
|
||
|
||
- **Steam账户**: 自动识别Steam格式，生成5位验证码
|
||
- **自定义参数**: 手动添加时可配置算法、位数、周期等
|
||
- **重复检测**: 导入时自动去重，避免重复账户
|
||
|
||
---
|
||
|
||
## 🤝 贡献指南
|
||
|
||
我们欢迎所有形式的贡献！无论是bug报告、功能建议、代码提交还是文档改进。 |