# password_manager

**Repository Path**: java_superb/password_manager

## Basic Information

- **Project Name**: password_manager
- **Description**: 基于electron的桌面端密码管理工具
- **Primary Language**: TypeScript
- **License**: Artistic-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2023-06-01
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 密码管理器

一款基于 Electron + Vue 3 开发的跨平台密码管理软件，帮助用户安全地管理和存储密码。

[![版本](https://img.shields.io/badge/version-1.1.2--beta-blue)](https://github.com/java_superb/password_manager)
[![平台](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-green)]()
[![许可证](https://img.shields.io/badge/license-MIT-orange)]()

## 功能特性

### 🔐 密码管理
- 创建多个密码本进行分类管理
- 添加、编辑、删除密码条目
- 支持密码本重命名
- 删除密码本前验证是否为空
- 密码可见性切换
- 复制密码/用户名到剪贴板

### 👤 用户认证
- 用户注册与登录功能
- 锁屏保护机制
- 可配置自动锁屏时间（1-60分钟）
- 本地数据安全存储

### ⚙️ 首选项设置
- **主题切换**：支持暗色/浅色主题，一键切换
- **锁屏时间**：自定义自动锁屏间隔（1-60分钟）
- **配置路径**：设置配置文件存储位置（默认用户目录）

### 🎨 界面特性
- 现代化 UI 设计，圆角弹窗
- 响应式布局，适配不同屏幕
- 统一的主题色和交互效果
- 流畅的动画和过渡效果
- 悬停、聚焦等丰富的交互反馈

## 技术栈

| 类别 | 技术 |
|------|------|
| 框架 | Electron 28 + Vue 3 |
| 构建工具 | Vite + electron-vite |
| UI组件 | Element Plus |
| 状态管理 | Vuex |
| 样式 | Less (scoped styles) |
| 图标 | Element Plus Icons |
| 类型 | TypeScript |

## 快速开始

### 环境要求
- Node.js >= 18
- npm >= 9

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
npm run dev
```

### 构建生产版本

**Windows 版本：**
```bash
npm run build:win
```

**macOS 版本：**
```bash
npm run build:mac
```

**Linux 版本：**
```bash
npm run build:linux
```

构建完成后，安装包位于 `dist` 目录下。

## 项目结构

```
password_manager/
├── src/
│   ├── main/                  # 主进程代码
│   │   └── index.ts
│   ├── preload/               # Preload脚本
│   │   └── index.ts
│   └── renderer/             # 渲染进程代码
│       └── src/
│           ├── components/    # Vue 组件
│           │   ├── header/       # 顶部导航栏
│           │   ├── content/      # 主内容区
│           │   ├── login/        # 登录弹窗
│           │   ├── register/     # 注册弹窗
│           │   ├── about/        # 关于弹窗
│           │   └── secretForm/   # 密码表单弹窗
│           ├── router/       # 路由配置
│           ├── store/         # Vuex 状态管理
│           ├── assets/        # 静态资源
│           └── setting/       # 设置页面
├── resources/                # 应用资源文件
├── electron-builder.yml       # electron-builder 配置
├── package.json              # 项目配置
└── README.md                  # 项目说明
```

## 使用说明

1. **启动软件**：运行 `npm run dev` 或启动构建后的可执行文件
2. **注册账号**：首次使用需要注册账号
3. **创建密码本**：在左侧面板点击「+」创建新密码本
4. **添加密码**：在密码本中点击「新增密码」按钮添加条目
5. **编辑/删除**：支持对密码条目进行编辑和删除操作
6. **首选项设置**：点击顶部菜单「用户」→「首选项」进行配置

## 安全说明

- 🔒 密码本地存储，数据安全可控
- ⏰ 支持自动锁屏保护
- 💾 建议定期备份配置文件
- 🛡️ 无网络传输，本地数据不外泄

## 更新日志

### v1.1.2-beta
- 优化 UI 样式，统一弹窗圆角和间距
- 增强表单组件的交互效果
- 修复若干 UI 显示问题
- 提升视觉层次和用户体验

### v1.1.0
- 添加主题切换功能
- 实现自动锁屏机制
- 优化密码本管理功能

## 许可证

[MIT License](LICENSE) - 自由使用、修改和分发