# 牛马的密码

**Repository Path**: xxclhh/VaultManager

## Basic Information

- **Project Name**: 牛马的密码
- **Description**: 牛马的密码 是一款运行在 Windows 10/11 平台上的本地密码管理软件。采用军事级加密标准（AES-256-GCM + Argon2id），所有数据存储在本地，无需联网，保护您的隐私安全。
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# VaultManager 密码管理器

一个安全、功能完善的 Windows 桌面密码管理器，采用 WPF 开发，支持本地加密存储、密码生成、SSH工具集成等功能。

## 功能特性

### 🔐 安全保护
- **Argon2 加密**：使用 Argon2id 算法 derivekey，确保密码安全
- **本地加密存储**：所有数据本地 SQLite 数据库存储，敏感信息加密保存
- **双盐机制**：密码 Salt + 数据库 Salt 双重保护
- **登录失败保护**：连续5次登录失败自动锁定
- **空闲自动锁定**：可配置空闲时间自动锁定应用
- **剪贴板自动清空**：复制密码后自动清除剪贴板（默认30秒）

### 📂 数据管理
- **分类管理**：支持自定义分类（网站、SSH、RDP、Telnet等）
- **条目管理**：增删改查密码条目
- **密码生成**：自定义长度和字符集生成强密码
- **搜索过滤**：快速搜索和过滤条目

### 🔧 工具集成
- **SSH/Telnet 连接**：支持 SecureCRT、Kitty 等 SSH 客户端
- **批量操作**：一键复制用户名、密码、打开连接

### 💾 备份恢复
- **导出备份**：加密导出数据库备份文件
- **导入恢复**：支持合并或覆盖导入备份
- **自动管理**：自动管理备份文件列表

## 技术栈

- **.NET 8.0** - 运行时框架
- **WPF** - Windows 桌面 UI 框架
- **SQLite** - 本地数据库
- **Microsoft.Data.Sqlite** - SQLite 连接
- **Konscious.Security.Cryptography.Argon2** - Argon2 加密
- **CommunityToolkit.Mvvm** - MVVM 框架

## 项目结构

```
VaultManager/
├── Controls/              # 自定义控件
│   ├── PasswordStrengthBar.xaml    # 密码强度条
│   └── TogglePasswordBox.xaml      # 密码显隐切换
├── Converters/            # 值转换器
│   └── Converters.cs       # 各种UI转换器
├── Models/                # 数据模型
│   ├── Category.cs       # 分类模型
│   ├── Entry.cs          # 条目模型
│   └── VaultFileInfo.cs   # 保险库文件信息
├── Services/             # 核心服务
│   ├── AuthService.cs           # 认证服务
│   ├── BackupService.cs         # 备份服务
│   ├── ClipboardService.cs      # 剪贴板服务
│   ├── CryptoService.cs         # 加密服务
│   ├── DatabaseService.cs      # 数据库服务
│   ├── PasswordGeneratorService.cs # 密码生成服务
│   ├── SshToolService.cs      # SSH工具服务
│   └── VaultScanService.cs    # 保险库扫描服务
├── ViewModels/           # 视图模型
│   ├── MainViewModel.cs        # 主窗口视图模型
│   ├── LoginViewModel.cs     # 登录视图模型
│   ├── EntryEditViewModel.cs  # 条目编辑视图模型
│   └── ...
├── Views/                # 窗口视图
│   ├── MainView.xaml         # 主窗口
│   ├── LoginView.xaml        # 登录窗口
│   └── ...
└── App.xaml              # 应用程序入口
```

## 构建要求

- .NET 8.0 SDK
- Windows 10/11

## 构建步骤

### 使用脚本构建

```bash
# PowerShell 方式（推荐）
.\build.ps1

# 或者批处理方式
.\build.bat
```

### 手动构建

```bash
cd VaultManager
dotnet build -c Release
```

构建完成后，可执行文件位于 `VaultManager\bin\Release\net8.0-windows\publish\` 目录。

## 使用说明

### 首次运行

1. 启动应用后，创建新的保险库
2. 设置主密码（建议使用强密码，包含大小写字母、数字和特殊字符）
3. 初始密码将用于加密您的所有数据，请妥善保管

### 日常使用

1. **解锁保险库**：输入主密码解锁
2. **添加条目**：点击"添加"按钮新建密码条目
3. **查看条目**：双击列表项查看详情
4. **编辑条目**：选择条目后点击编辑或右键菜单
5. **复制密码**：点击复制按钮或使用快捷键
6. **生成密码**：使用内置密码生成器

### 设置功能

- **修改主密码**：设置 → 修改主密码
- **空闲锁定**：设置 → 空闲超时
- **SSH工具**：设置 → SSH工具配置 SecureCRT/Kitty 路径
- **备份管理**：设置 → 备份管理 导出/导入备份

## 配置文件位置

默认数据目录：`%APPDATA%\VaultManager\`

- 保险库文件：`.db` 扩展名
- 备份文件：`.vaultbak` 扩展名

## 注意事项

- **主密码丢失无法恢复**：请务必牢记主密码，忘记将无法访问数据
- **定期备份**：建议定期导出备份以防数据丢失
- **安全环境**：请在安全的计算机上使用，避免恶意软件监

## 许可证

MIT License