# password-management

**Repository Path**: zychhf/password-management

## Basic Information

- **Project Name**: password-management
- **Description**: 一款账号密码管理工具，数据本地存储
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 密码管理系统

一个功能强大、界面美观的密码管理应用，使用 Flutter 开发。

## ✨ 功能特性

- 🔐 **密码管理**：添加、编辑、删除密码信息
- 📁 **多级分组**：支持无限层级的分组管理
- 🔍 **智能搜索**：快速搜索账号名称和备注
- 💾 **数据持久化**：使用 SQLite 本地存储
- 📤 **导入导出**：支持 JSON 格式的数据备份和恢复
- 🎨 **美观界面**：Material Design 3 设计风格
- 🌓 **主题切换**：自动适配系统深色/浅色模式
- 📱 **跨平台支持**：支持 Android 和 iOS 平台

## 🚀 快速开始

### 环境要求

- Flutter SDK >= 3.0.0
- Dart SDK >= 3.0.0
- Android SDK (用于 Android 开发)
- Xcode (用于 iOS 开发，仅 macOS)

### 安装步骤

1. 克隆或下载项目到本地

2. 安装依赖：
```bash
flutter pub get
```

3. 运行应用：

**Android:**
```bash
flutter run -d android
```

**iOS:**
```bash
flutter run -d ios
```

**选择设备运行:**
```bash
flutter devices  # 查看可用设备
flutter run      # 选择设备运行
```

## 📦 依赖包

- `sqflite`: SQLite 数据库支持
- `path_provider`: 文件路径管理
- `provider`: 状态管理
- `google_fonts`: 字体支持
- `file_picker`: 文件选择器

## 🗂️ 项目结构

```
lib/
├── main.dart                 # 应用入口
├── models/                   # 数据模型
│   ├── password_item.dart    # 密码项模型
│   └── password_group.dart   # 分组模型
├── database/                 # 数据库层
│   └── database_helper.dart  # 数据库操作
├── providers/                # 状态管理
│   └── password_provider.dart
├── screens/                  # 页面
│   └── home_screen.dart      # 主页面
├── widgets/                  # 组件
│   ├── group_tree_view.dart      # 分组树视图
│   ├── password_list_view.dart   # 密码列表
│   ├── add_password_dialog.dart  # 添加密码对话框
│   ├── add_group_dialog.dart     # 添加分组对话框
│   └── search_bar_widget.dart    # 搜索栏
└── utils/                    # 工具类
    ├── file_helper.dart      # 文件操作
    └── json_helper.dart      # JSON 处理
```

## 📝 数据格式

导出的 JSON 文件格式示例：

```json
[
  {
    "groupName": "工作相关",
    "children": [
      {
        "accountName": "掘金密码",
        "password": "123456",
        "remark": "用于登录掘金"
      },
      {
        "groupName": "开发工具",
        "children": [
          {
            "accountName": "GitHub",
            "password": "github123",
            "remark": "GitHub 账号"
          }
        ]
      }
    ]
  }
]
```

## 🎯 使用说明

### 添加分组
1. 点击左侧边栏的 "+" 按钮添加根分组
2. 点击分组右侧的菜单按钮，选择"添加子分组"创建子分组

### 添加密码
1. 点击右下角的"添加密码"按钮
2. 填写账号名称、密码、选择分组和备注
3. 点击"添加"保存

### 搜索密码
在顶部搜索栏输入关键词，系统会自动搜索匹配的账号名称和备注

### 导出数据
点击顶部工具栏的导出按钮，选择保存位置即可导出 JSON 文件

### 导入数据
点击顶部工具栏的导入按钮，选择之前导出的 JSON 文件即可恢复数据

## 📱 平台支持

### Android
- 最低支持版本：Android 5.0 (API 21)
- 已配置存储权限用于导入导出功能
- 应用名称：密码管理系统

### iOS
- 最低支持版本：iOS 12.0
- 已配置文档访问权限
- 应用名称：密码管理系统

## 🔨 构建发布版本

### Android APK
```bash
flutter build apk --release
```
生成的 APK 文件位于：`build/app/outputs/flutter-apk/app-release.apk`

### Android App Bundle (推荐用于 Google Play)
```bash
flutter build appbundle --release
```

### iOS
```bash
flutter build ios --release
```
然后在 Xcode 中打开项目进行签名和发布

## ⚠️ 安全提示

- 本应用将密码以明文形式存储在本地数据库中
- 请妥善保管导出的 JSON 文件
- 建议在安全的设备上使用本应用
- 定期备份数据以防丢失

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📧 联系方式

如有问题或建议，欢迎反馈。