Authenticator/README.md

MFA Authenticator

一个基于 HarmonyOS 的多因素身份验证器应用,使用 Apple Design 风格设计。

功能特性

• ✅ TOTP 验证码生成: 基于 RFC 6238 标准的时间一次性密码算法
• ✅ 30秒自动刷新: 实时显示剩余时间和进度
• ✅ 账户管理: 添加、编辑、删除账户
• ✅ 搜索功能: 快速查找账户
• ✅ 一键复制: 点击卡片即可复制验证码
• ✅ 本地存储: 使用 Preferences API 安全存储
• ✅ 暗色模式: 自动适配系统主题
• ✅ 简洁 UI: Apple Design 风格,清爽高效

技术栈

• 开发框架: ArkTS + ArkUI
• 平台: HarmonyOS 6.0.0
• 架构模式: MVVM
• 加密算法: HMAC-SHA1/SHA256
• 存储方案: Preferences API

项目结构

entry/src/main/ets/
├── common/
│   ├── constants/      # 常量定义
│   └── utils/          # 工具类(TOTP、Base32、存储)
├── model/              # 数据模型
├── viewmodel/          # 业务逻辑
├── view/
│   └── components/     # 可复用组件
└── pages/              # 页面
    ├── AccountListPage.ets      # 主页面
    ├── AddAccountPage.ets       # 添加账户
    └── AccountDetailPage.ets    # 账户详情

快速开始

环境要求

• DevEco Studio 5.0+
• HarmonyOS SDK 6.0.0+

安装步骤

1. 使用 DevEco Studio 打开项目
2. 等待依赖安装完成
3. 连接 HarmonyOS 设备或启动模拟器
4. 点击运行按钮

使用说明

1. 添加账户

   • 点击右上角 "+" 按钮
   • 选择"手动输入"标签
   • 填写发行者、账户名和密钥(Base32 格式)
   • 点击"保存"

2. 查看验证码

   • 主页面显示所有账户和对应的验证码
   • 验证码每 30 秒自动刷新
   • 右侧圆环显示倒计时进度

3. 复制验证码

   • 点击账户卡片即可复制验证码到剪贴板

4. 管理账户

   • 长按账户卡片显示操作菜单
   • 可选择"编辑"或"删除"

测试账户

可以使用以下测试密钥进行测试:

发行者: Test
账户: test@example.com
密钥: JBSWY3DPEHPK3PXP

设计规范

配色方案

• 主色: SF Blue (#007AFF)
• 背景: 浅灰 (#F2F2F7) / 深色 (#000000)
• 卡片: 白色 (#FFFFFF) / 深色卡片 (#1C1C1E)

UI 元素

• 圆角: 12-16vp
• 验证码字体: 36fp 等宽字体
• 间距系统: 8/12/16/24vp

安全说明

• 所有账户数据仅存储在本地设备
• 使用 Preferences API 进行持久化存储
• 密钥采用 Base32 编码存储
• 不会上传任何数据到云端

后续计划

• 扫码功能实现
• 数据加密存储
• 应用锁功能
• 备份与恢复
• 更多算法支持(SHA256, SHA512)
• 批量导入导出

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request!