# pass-tool

**Repository Path**: ml_6666/pass-tool

## Basic Information

- **Project Name**: pass-tool
- **Description**: 离线密码本，本地国密存储
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 密码本, 加密, 本地存储, 国密

## README

# passNote

一款本地密码管理工具，基于 Tauri + Vue 3 + Rust 构建，所有数据使用国密 SM4-GCM 加密存储，界面采用毛玻璃风格，支持深色/浅色主题。

![passNote 主界面预览](./image/2.png)

## 核心特性

### 安全加密
- **SM4-GCM 国密算法**：所有字段（名称、账号、密码、网址、备注）单独加密存储
- **主密码保护**：密钥由主密码通过 PBKDF2 派生，盐值随机生成，主密码本身不存储
- **本地优先**：数据完全存储在本地，不上传任何服务器，无云端泄露风险

### 高效管理
- **分类管理**：支持将密码条目按社交、工作、金融、购物、娱乐、开发等分类组织
- **全文搜索**：支持在名称、账号、网址、备注中模糊搜索，大小写不敏感，毫秒级响应
- **一键复制**：每个条目提供复制账号、复制密码快捷按钮，点击即复制

### 便捷导入导出
- 支持 **Excel（.xlsx）** 和 **CSV** 格式批量导入已有密码
- 支持将全部条目导出为 Excel 或 CSV 格式，便于备份和迁移

### 桌面集成
- **全局快捷键**：`Ctrl+Shift+P` 快速呼出主窗口（可自定义）
- **系统托盘**：关闭主窗口后最小化至托盘，后台静默运行
- **原生体验**：基于 Tauri 构建，运行速度快、资源占用低

## 界面预览

### 登录界面
![登录界面](./image/1.png)

首次使用或每次启动时输入主密码解锁保险箱。

### 主界面
![主界面预览](./image/2.png)

左侧分类栏快速筛选，右侧卡片列表展示所有密码条目，每张卡片显示名称、账号、网址、所属分类，并提供复制和操作按钮。顶部搜索框支持实时过滤。

### 设置面板
![设置面板](./image/3.png)

- 语言切换（简体中文 / English）
- 主题模式（跟随系统 / 深色 / 浅色）
- 全局快捷键自定义
- 自动锁定超时时间
- 启动最小化和托盘化

## 技术架构

| 层级 | 技术选型 |
|------|----------|
| 前端框架 | Vue 3 + TypeScript + Vite + Pinia |
| 桌面运行时 | Tauri 2 + Rust |
| 数据存储 | SQLite（FTS5 全文索引） |
| 加密算法 | SM4-GCM（国密认证算法） |

## 数据存储

- **数据库**：`%LOCALAPPDATA%/passNote/vault.db`
- **配置文件**：`%LOCALAPPDATA%/passNote/settings.json`

> **重要提示**：删除 `vault.db` 将永久丢失所有密码数据，请定期使用导出功能备份。

## 安装使用

### 环境要求
- Windows 10 及以上
- Node.js >= 18
- Rust >= 1.70

### 开发模式
```bash
npm install
npm run tauri:dev
```

### 生产构建
```bash
npm run tauri:build
```
构建产物位于 `src-tauri/target/release/` 目录。

## 安全说明

1. 加密密钥由主密码通过 PBKDF2 派生，每次创建主密码时随机生成盐值
2. 所有敏感字段单独加密，无法通过 SQLite 直接读取明文
3. 主密码不存储，仅存储其 PBKDF2 哈希用于验证
4. 导入 Excel/CSV 时，源文件不会被自动删除，请妥善处理

## 打赏支持

如果您觉得 passNote 对您有帮助，欢迎扫码打赏，支持开源项目持续迭代。

| 微信 | 支付宝 |
|:---:|:---:|
| ![微信打赏](./image/donate-wechat.png) | ![支付宝打赏](./image/donate-alipay.png) |

---

passNote — 你的本地密码保险箱。