# password-manager

**Repository Path**: caihonghai/password-manager

## Basic Information

- **Project Name**: password-manager
- **Description**: 基于uniapp开发的密码本app，只在安卓设备上测试过，IOS的尚未调试适配
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 密码管理器 (Password Manager)

这是一个基于 UniApp 开发的跨平台密码管理器应用，支持 Android、iOS 和 Web 平台。该应用采用国密算法(SM2/SM3/SM4)进行数据加密，保障用户密码安全。
[本地打包基座](https://gitee.com/caihonghai/HBuilder-Integrate-AS.git)

## 功能特性

### 🔒 安全特性
- 无联网权限，app零权限
- 主密码加密所有数据
- 国密算法加密(SM2/SM3/SM4)
- 指纹/面容ID快速登录
- 数据备份与还原
- 密码提示功能

### 📱 核心功能
- 密码条目管理(增删改查)
- 分类管理
- 密码生成器
- 搜索功能
- 左滑删除
- 自动备份

### 🎨 用户体验
- 简洁直观的界面设计
- 流畅的动画交互
- 响应式布局适配多种设备

## 技术架构

### 前端框架
- UniApp (Vue.js)
- 支持编译到多个平台

### 加密算法
- SM2: 非对称加密算法
- SM3: 哈希算法
- SM4: 对称加密算法

### 数据存储
- 本地加密存储
- 文件备份导出

## 使用指南

### 1. 注册账户
首次使用需要创建主密码:
1. 进入注册页面
2. 设置高强度主密码(至少8位)
3. 可选择启用指纹/面容ID登录
4. 完成注册后自动跳转登录

### 2. 登录系统
- 输入主密码解锁
- 支持指纹/面容ID快速登录
- 忘记密码可通过密码提示回忆

### 3. 管理密码条目
#### 添加密码
1. 点击"+"按钮
2. 填写网站/应用名称、网址、账号等信息
3. 可使用内置密码生成器创建强密码
4. 保存条目

#### 查看/编辑密码
1. 点击任意条目查看详情
2. 点击"✏️"图标编辑条目
3. 可复制任意字段内容

#### 删除密码
1. 在主页面左滑条目
2. 点击"删除"按钮
3. 或在详情页面长按条目删除

### 4. 分类管理
- 可创建自定义分类
- 为密码条目分配分类
- 支持分类颜色标识

### 5. 数据备份
#### 自动备份
- 默认开启自动备份
- 数据变更时自动保存

#### 手动导出
1. 进入"备份"页面
2. 选择导出类型:
    - 明文导出(高风险)
    - 加密导出(推荐)
3. 点击"导出到公共目录"

### 6. 数据还原
1. 进入"还原"页面
2. 选择还原方式:
    - 密文还原(推荐)
    - 明文还原
3. 选择备份文件
4. 设置冲突处理策略

### 7. 设置功能
- 指纹/面容ID登录开关
- 密码提示设置
- 退出登录

## 安全建议

1. **主密码安全**
    - 设置高强度主密码
    - 不要使用容易猜测的密码
    - 定期更换主密码

2. **备份安全**
    - 定期备份重要数据
    - 备份文件妥善保管
    - 敏感环境下谨慎使用明文导出

3. **设备安全**
    - 启用设备锁屏密码
    - 及时更新操作系统
    - 避免在公共设备上使用

## 注意事项

1. **数据不可恢复**: 忘记主密码将无法恢复数据，请务必牢记
2. **卸载风险**: 卸载应用会导致数据丢失，请提前备份
3. **平台差异**: 不同平台功能可能略有差异

## 文件结构

```
/pages
  /auth
    login.vue         # 登录页面
    register.vue      # 注册页面
  /main
    index.vue         # 主页面
    category.vue      # 分类管理
    entry-edit.vue    # 条目编辑
    entry-detail.vue  # 条目详情
    backup.vue        # 数据备份
    restore.vue       # 数据还原
    settings.vue      # 设置页面
    guide.vue         # 使用指南
/utils
  sm-crypto-util.js  # 国密算法工具
  common.js          # 通用工具函数
```


## 开发说明

### 环境要求
- HBuilderX 或其他支持 UniApp 的开发工具
- Node.js 环境
- 各平台开发环境(Android/iOS)

### 编译运行
```bash
# 运行到浏览器
npm run dev:h5

# 运行到Android
npm run dev:app-plus

# 编译发布
npm run build:app-plus
```


## 常见问题

### Q: 忘记主密码怎么办？
A: 主密码一旦遗忘无法找回，请务必设置密码提示或妥善保管。

### Q: 如何迁移数据到新设备？
A: 使用备份功能导出数据，在新设备上通过还原功能导入。

### Q: 指纹登录不工作怎么办？
A: 确认设备支持指纹功能且已录入指纹，在设置中重新启用指纹登录。

## 联系我们

如在使用过程中遇到问题或有任何建议，欢迎通过以下方式联系我们：

1. 提交 GitHub Issues