# passwordbox

**Repository Path**: zhulei-private/passwordbox

## Basic Information

- **Project Name**: passwordbox
- **Description**: 密码管理工具，存储加密存储在本地sqlite3数据库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🔐 Password Box (本地密码保险箱)

基于 Python 和 CustomTkinter 开发的现代化本地密码管理工具。数据采用 AES 加密存储在本地 SQLite 数据库中，安全、轻量且完全由您掌控。

## ✨ 主要功能

*   **🛡️ 强加密**: 使用 `AES-128-CBC` (Fernet) 加密密码，配合 `PBKDF2HMAC` 密钥派生，确保数据安全。
*   **🗂️ 分组管理**: 支持二级分类（如：工作 > 邮箱），高效管理大量账号。
*   **📋 智能剪贴板**: 一键复制密码，**30秒后自动清除**剪贴板，防止隐私泄露。
*   **🎲 密码生成器**: 内置强密码生成工具。
*   **🔍 快速搜索**: 实时筛选服务名称或用户名。
*   **🌑 深色模式**: 适配 Windows 11 风格的现代化 UI。

## 🚀 快速开始

### 1. 环境要求
*   Windows 10/11
*   Python 3.10 或更高版本

### 2. 安装依赖
在项目根目录下打开终端，运行：
```bash
pip install -r requirements.txt
```

### 3. 运行软件
```bash
python main.py
```

## 📖 使用指南

### 🟢 首次初始化
1.  首次运行程序时，界面会提示您设置 **主密码 (Master Password)**。
2.  **⚠️ 请务必牢记此密码！** 它是解密数据库的唯一凭证。为了安全起见，程序**不会**在任何地方明文存储此密码，一旦丢失将无法找回数据。

### 📂 管理分类
*   在左侧导航栏点击 `+ Add Category` 按钮。
*   输入分类名称（如 "Social", "Work"）。
*   可选：选择一个父分类以创建子分类。

### 🔑 添加密码
1.  点击右上角的 `+ Add Password` 按钮。
2.  填写账号详情：
    *   **Service Name**: 服务名称（如 Google, Netflix）。
    *   **Username**: 用户名/邮箱。
    *   **Password**: 手动输入或点击 `🎲` 图标自动生成强密码。
    *   **Category**: 选择所属分类。
3.  点击 `Save` 保存。

### 📋 查看与使用
*   **搜索**: 在顶部搜索框输入关键词，按回车或点击 Search 按钮。
*   **复制密码**: 点击卡片上的 `Copy Pass` 按钮。密码将复制到剪贴板，并在 **30秒后自动清除**。
*   **复制用户名**: 点击 `Copy User` 按钮。

## 🛠️ 技术栈
*   **UI**: [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter)
*   **Database**: SQLite3
*   **Security**: [Cryptography](https://cryptography.io/en/latest/) (Fernet)
*   **Clipboard**: Pyperclip