# LeonKey

**Repository Path**: C_9527/LeonKey

## Basic Information

- **Project Name**: LeonKey
- **Description**: 一款完全离线、零知识的个人密码管理器。所有数据加密存储在单个 .leonkey 文件中，使用 Argon2id 密钥派生，支持 AES-256-GCM / XChaCha20-Poly1305 加密算法。无云端、无遥测、数据完全由用户掌控。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README




# LeonKey

LeonKey 是一款安全的本地端密码管理器，采用 Tauri + React + Rust 技术栈构建，支持 AES-256-GCM 和 XChaCha20-Poly1305 两种加密算法，确保您的密码数据安全存储在本地设备上。

## 特性

- **本地加密存储**: 所有数据均加密存储在本地，不依赖云服务
- **双重加密算法**: 支持 AES-256-GCM 和 XChaCha20-Poly1305
- **主密钥保护**: 使用 Argon2id 密钥派生函数保护主密钥
- **助记词支持**: 支持通过助记词或随机字符串格式导出/导入主密钥
- **自动锁定**: 闲置自动锁定，支持自定义超时时间
- **防爆破保护**: PIN 输入错误次数过多时自动锁定
- **密码生成器**: 支持自定义长度、字符集生成强密码
- **保险库对比**: 支持对比两个保险库的数据差异
- **CSV 导出**: 支持导出为 CSV 格式
- **多主题**: 支持明暗主题切换

## 技术栈

- **前端**: React + TypeScript + Zustand + Ant Design
- **后端**: Rust + Tauri
- **加密**: AES-256-GCM, XChaCha20-Poly1305, Argon2id

## 项目结构

```
src/                          # 前端源代码
├── lib/                      # 类型定义与 API 封装
├── stores/                   # Zustand 状态管理
├── hooks/                    # 自定义 React Hooks
├── views/                    # 顶层视图组件
├── components/               # UI 组件库
│   ├── layout/               # 布局组件
│   ├── categories/           # 分类管理
│   ├── entries/              # 密码条目
│   ├── password/             # 密码生成器
│   ├── search/               # 搜索组件
│   ├── vault/                # 保险库操作
│   └── common/               # 通用组件
└── styles/                   # 样式文件

src-tauri/                    # Rust 后端源代码
├── src/
│   ├── commands/             # Tauri 命令
│   ├── crypto/               # 加密模块
│   ├── models/               # 数据模型
│   ├── storage/              # 文件存储
│   └── state/                # 应用状态
└── Cargo.toml
```

## 安装

### 环境要求

- Node.js 18+
- Rust 1.70+
- pnpm (推荐)

### 开发环境

```bash
# 安装依赖
pnpm install

# 安装 Rust 依赖
cd src-tauri
cargo build

# 启动开发服务器
cd ..
pnpm tauri dev
```

### 生产构建

```bash
pnpm tauri build
```

## 使用指南

### 首次使用

1. 运行应用后进入向导界面
2. 设置 PIN 码
3. 选择加密算法（AES-256-GCM 或 XChaCha20-Poly1305）
4. 选择主密钥格式（助记词或随机字符串）
5. 备份生成的主密钥（助记词/密钥字符串）

### 主界面

- **左侧边栏**: 分类树状结构，支持拖拽排序和右键菜单
- **右侧内容区**: 显示选中分类下的密码条目
- **顶部搜索**: 支持全局搜索密码条目

### 密码操作

- 点击眼睛图标查看密码
- 点击复制图标复制密码到剪贴板
- 支持行内编辑和新增密码

### 设置

- 修改 PIN 码
- 切换加密算法
- 更改主题（明/暗）
- 设置自动锁定时间

## 安全特性

- 主密钥使用 Argon2id 派生
- 内存中的密钥在 Drop 时自动清零
- 闲置超时自动锁定
- PIN 错误次数过多时锁定

## 许可证

MIT License