# XPasswd

**Repository Path**: xnors/xpasswd

## Basic Information

- **Project Name**: XPasswd
- **Description**: Xnors密码查询软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-18
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XPasswd - XnorsCodeStudio 密码管理器

XPasswd 是一个基于RSA加密的多级安全密码管理器。

## 功能特性

- 多级安全等级保护
- RSA 2048位加密
- 命令行交互界面
- 支持自定义密钥
- 加密数据存储在本地

## 构建方法

1. 确保已安装Python的uv工具
   ```bash
   pip install uv
   ```
2. 安装依赖：
   ```bash
   uv sync
   ```
3. 构建可执行文件：
   ```bash
   uv run pyinstaller main.spec
   ```
4. 构建完成后，可执行文件将生成在`dist`目录中

## 使用方法

### 1. 初始化加密
> 注意, 此方法仅Xnors工作室的密码管理员可以使用, 添加密码之后要及时上传到git仓库!
1. 准备明文密码文件`plaintext.dangerous.json`
2. 取消注释`main.py`中的`encrypt_and_save()`函数
3. 编译程序
4. push到git仓库

### 2. 查询密码

1. 运行程序：
   ```bash
   uv run main.py
   ```
2. 按照提示输入：
   - 安全等级 (整数)
   - 查询关键词(即密码名,支持简单的模糊匹配,例如: `pythona`可以匹配到 `PythonAnywhere`)
   - 私钥 (可选，如果密钥已保存在keys目录则可不输入)

## 项目结构

```
XPasswd/
├── build.bat            # 构建脚本
├── main.py              # 主程序
├── main.spec            # PyInstaller配置文件
├── pyproject.toml       # 项目配置
├── README.md            # 本文件
├── encrypted.json       # 加密后的密码数据
├── keys/                # 密钥存储目录(可以向室长或管理员申请)
│   ├── public.0.pem     # 0级公钥
│   ├── private.0.pem    # 0级私钥
│   └── ...              # 其他级别密钥
```

## 注意事项

1. 请妥善保管您的私钥，丢失后将无法解密数据(丢失后可以找管理员获取)
2. 加密后的数据存储在`encrypted.json`中
3. 明文密码文件`plaintext.dangerous.json`在使用后应立即删除(非管理员可以忽略这一条)
4. 使用完毕请清除命令行历史中的密码记录

## 开发依赖

见 [`pyproject.toml`](./pyproject.toml) 文件