# 克隆仓库
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# 安装依赖（colorama、cryptography、pyperclip 等）
pip install -r requirements.txt

# 生成一个20字符的随机密码
python main.py random -l 20

# 生成一个4单词的口令短语
python main.py phrase -w 4 --capitalize

# 生成一个Leetspeak口令短语
python main.py leet -w 3 -s _

# 生成并显示熵分析
python main.py --show-entropy random -l 16

# 启动交互模式
python main.py --interactive

# 使用预设配置文件（强密码）
python main.py --preset strong --show-entropy

# 基础16字符密码
python main.py random

# 24字符，仅字母
python main.py random -l 24 --no-symbols --no-digits

# 易于阅读（无0/O、1/l/I）
python main.py --easy-read random -l 20

# 带最低要求
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# 均衡模式（字母为主，符号较少）
python main.py random -l 24 --balanced

# 标准4单词口令短语
python main.py phrase -w 4

# 带大写和下划线分隔符
python main.py phrase -w 5 -s _ --capitalize

# 交替大小写（高熵）
python main.py phrase -w 4 -s . --alternate
# 输出：aPpLe.bAnAnA.cHeRrY.dAtE

# 全大写加连字符分隔符（高熵）
python main.py phrase -w 4 -s . --uppercase
# 输出：APPLE-BANANA-CHERRY-DATE

# Leetspeak版本（智能50%替换）
python main.py leet -w 4 -s -
# 输出：4PPl3.8@N@[email protected]

# 主题口令短语（使用'animals.txt'）
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# 输出：Tiger-Falcon-Shark-Wolf

# 5个段，每段5个字符
python main.py license --segments 5 --segment-length 5

# 4个段，每段8个字符
python main.py license --segments 4 --segment-length 8

# HS256 的 JWT 密钥
python main.py jwt --bits 256

# Base64 API 密钥
python main.py base64 -b 32 --url-safe

# UUID 令牌（v4 随机）
python main.py uuid --upper

# UUID v7（基于时间，可排序）
python main.py uuid --ver 7
# 或使用快捷方式
python main.py uuid --v7

# 短 UUID（Base58 编码，约22字符）
python main.py uuid --short

# 使用快捷方式生成 v7 UUID
python main.py u --v7

# 生成10个短 v4 UUID
python main.py uuid --v4 --short -n 10

# 北约音标转换
python main.py phonetic --text "PassForge"
# 输出：Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

# 分析现有密码
python main.py analyze "p@ssword123"

# 记录到历史
python main.py --log random -l 16

# 查看最近10条历史记录（默认）
python main.py history

# 查看所有历史记录（实时解密）
python main.py history --all

# 查看历史记录，密码脱敏
python main.py history --redact

# 导出历史记录（默认脱敏）
python main.py history --export backup.json

# 导出历史记录（明文 - 需谨慎）
python main.py history --export secrets.csv --no-redact

# JSON 输出供脚本使用
python main.py --json jwt --bits 256

password_generator/
├── main.py                 # 入口点
├── requirements.txt        # 依赖列表
├── src/
│   ├── __init__.py
│   ├── cli.py                # 参数解析器与横幅
│   ├── command_handler.py    # 命令路由
│   ├── interactive.py        # 交互菜单
│   ├── generators/           # 所有密码生成器
│   │   ├── base.py           # 抽象基类
│   │   ├── random_password.py # 随机密码生成器
│   │   ├── passphrase.py     # 口令短语生成器
│   │   ├── leetspeak.py      # Leetspeak生成器
│   │   ├── pin.py            # PIN码生成器
│   │   ├── pronounceable.py  # 可读音密码生成器
│   │   ├── uuid_token.py     # UUID令牌生成器
│   │   ├── base64_secret.py  # Base64密钥生成器
│   │   ├── jwt_secret.py     # JWT密钥生成器
│   │   ├── wifi_key.py       # WiFi密钥生成器
│   │   ├── license_key.py    # 许可证密钥生成器
│   │   ├── recovery_codes.py # 恢复码生成器
│   │   ├── otp.py            # OTP生成器
│   │   ├── pattern.py        # 模式密码生成器
│   │   └── phonetic.py       # 北约音标生成器
│   ├── security/
│   │   ├── entropy.py        # 熵计算器
│   │   ├── strength_checker.py # zxcvbn集成
│   │   └── vault.py          # 安全历史加密
│   ├── output/
│   │   ├── formatter.py      # 彩色输出
│   │   ├── logger.py         # 历史记录日志
│   │   ├── clipboard.py      # 安全剪贴板处理
│   │   └── qrcode_gen.py     # OTP二维码生成
│   ├── config/
│   │   ├── loader.py         # YAML/JSON配置加载器
│   │   └── presets.py        # 预定义安全配置文件
├── data/
│   └── wordlists/            # 主题词表（animals.txt、biology.txt等）
└── tests/

# 运行所有测试
python -m pytest tests/ -v

# 运行特定测试类
python -m pytest tests/test_generators.py::TestRandomPasswordGenerator -v

# 运行覆盖率测试
python -m pytest tests/ --cov=src --cov-report=html

{
  "random": {
    "length": 20,
    "easy_read": true
  },
  "passphrase": {
    "words": 5,
    "capitalize": true
  },
  "output": {
    "show_entropy": true
  }
}

# 使用构建脚本
passforge_build.bat

# 或手动
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py

# 使用构建脚本
chmod +x passforge_build.sh
./passforge_build.sh

# 或手动
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py