# LocalPassword 

**Repository Path**: ruxi/local-password

## Basic Information

- **Project Name**: LocalPassword 
- **Description**: 一个基于浏览器的本地密码管理系统，使用 AES-256 加密算法保护您的密码数据。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-23
- **Last Updated**: 2025-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本地密码管理系统

一个基于浏览器的本地密码管理系统，使用 AES-256 加密算法保护您的密码数据。

## 效果展示

![输入图片说明](images1.png)
![输入图片说明](images2.png)
![输入图片说明](images3.png)
![输入图片说明](images4.png)
![输入图片说明](images5.png)
![输入图片说明](images6.png)
![输入图片说明](images7.png)

## 功能特点

- 🔒 使用 AES-256-CBC 加密算法保护密码数据
- 🔑 支持主密码管理
- 📝 支持添加、编辑、删除密码记录
- 🔍 支持按类别筛选和搜索密码
- 🎲 内置密码生成器
- 📱 响应式设计，支持移动端访问
- 🔄 支持数据导入导出
- ⚠️ 密码过期提醒
- 🔐 自动登出功能

## 安全特性

- 使用 PBKDF2 进行密钥派生，增加破解难度
- 每次加密使用随机盐值和初始化向量
- 密码数据使用 AES-256-CBC 加密
- 主密码使用 SHA-256 哈希存储
- 支持自动登出功能
- 支持密码过期提醒

## 重要说明

### 主密码修改说明

1. 系统会自动处理数据迁移：

   - 验证当前主密码
   - 自动解密所有现有数据
   - 使用新主密码重新加密所有数据
   - 更新安全设置
2. 修改主密码时：

   - 无需手动导出数据
   - 所有现有密码会自动迁移到新主密码
   - 修改后可以继续使用所有功能
3. 注意事项：

   - 请确保新主密码足够安全
   - 修改过程中请勿关闭浏览器
   - 建议定期修改主密码以提高安全性
4. 数据备份建议：

   - 虽然系统会自动处理数据迁移
   - 但建议定期导出数据作为备份
   - 以防意外情况发生

## 使用方法

1. 首次使用：

   - 设置主密码（请务必记住）
   - 开始添加密码记录
2. 日常使用：

   - 输入主密码登录
   - 管理您的密码记录
   - 使用密码生成器生成新密码
3. 数据备份：

   - 定期导出数据作为备份
   - 保存导出的数据文件
   - 导出数据时使用当前主密码加密

## 技术栈

- HTML5
- CSS3
- JavaScript (ES6+)
- Bootstrap 5
- CryptoJS
- Font Awesome

## 本地运行

1. 克隆仓库：

   ```bash
   git clone [repository-url]
   ```
2. 使用本地服务器运行项目：

   - 可以使用 Visual Studio Code 的 Live Server 插件
   - 或使用 Python 的简单 HTTP 服务器：
     ```bash
     python -m http.server 8000
     ```
3. 在浏览器中访问：

   ```
   http://localhost:8000
   ```

## 注意事项

1. 数据安全：

   - 所有数据存储在浏览器的 localStorage 中
   - 请定期导出数据作为备份
   - 清除浏览器数据会导致密码数据丢失
2. 主密码：

   - 请务必记住您的主密码
   - 主密码丢失将无法恢复数据
   - 修改主密码时系统会自动处理数据迁移，无需手动导入
3. 浏览器兼容性：

   - 推荐使用最新版本的 Chrome、Firefox、Edge 等现代浏览器
   - 确保浏览器启用了 JavaScript

## 开发计划

- [ ] 添加密码历史记录
- [ ] 支持密码分享功能
- [ ] 添加双因素认证
- [ ] 支持密码自动填充

## 贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目。

## 许可证

MIT License

## 版本历史

- v1.0.0 (2024-03-xx)
  - 初始版本发布
  - 实现基本密码管理功能
  - 支持数据加密存储
  - 添加密码生成器

## 联系方式

如有问题或建议，请提交Issue或联系开发者。

## 致谢

- Bootstrap 5
- Font Awesome
- CryptoJS
- Element UI (设计参考)