Skip to content

Latest commit

 

History

History
220 lines (158 loc) · 6.58 KB

README.md

File metadata and controls

220 lines (158 loc) · 6.58 KB

微信PGP加密辅助应用

一个Android Flutter应用，实现微信消息的点对点PGP加密通信，保护您的隐私安全。

功能特性

  • 🔐 PGP加密/解密支持：使用BouncyCastle库实现标准PGP加密
  • 🔑 密钥管理：导入、存储和管理PGP私钥和公钥
  • 🔒 私钥密码保护：支持密码保护的私钥解密
  • 📋 一键复制：加密完成后一键复制，方便粘贴到微信发送
  • 📱 友好的Material Design 3界面：简洁美观的用户体验
  • 🛡️ 点对点加密通信：弥补微信端到端加密的不足

技术栈

  • Flutter 3.0+：跨平台UI框架
  • Android原生代码（Kotlin）：PGP加密实现
  • BouncyCastle PGP库：bcpg-jdk15on, bcprov-jdk15on
  • AndroidOpenSSL：Android P+兼容性支持

系统要求

  • Android 6.0+ (API 23+)
  • 支持Android P (API 28+) 及以上版本

项目结构

lib/
├── main.dart                      # 应用入口
├── screens/                       # 界面
│   ├── home_screen.dart          # 主界面（密钥管理和使用说明）
│   ├── encrypt_screen.dart       # 加密界面
│   └── decrypt_screen.dart       # 解密界面
├── services/                      # 服务层
│   ├── floating_window_service.dart  # PGP加密服务（Platform Channel）
│   ├── key_storage_service.dart     # 密钥存储服务
│   └── permission_service.dart      # 权限管理服务
├── models/                        # 数据模型
│   └── pgp_key.dart              # PGP密钥模型
├── utils/                         # 工具类
│   └── constants.dart            # 常量定义
└── widgets/                      # 组件
    ├── permission_checker.dart   # 权限检查组件
    └── permission_dialog.dart    # 权限对话框

android/app/src/main/kotlin/com/wxcrypt/app/
├── MainActivity.kt               # 主Activity（Platform Channel处理）
├── FloatingWindowService.kt      # 悬浮窗服务（已移除，保留代码）
└── PGPEncryptionHelper.kt        # PGP加密/解密核心实现

使用说明

1. 导入密钥

  1. 打开应用，点击"导入密钥"按钮
  2. 选择PGP密钥文件（支持 .asc, .pem, .pgp, .key, .gpg 格式）
  3. 应用会自动识别密钥类型（私钥或公钥）
  4. 密钥会保存在应用本地存储中

支持的密钥格式：

  • PGP公钥：-----BEGIN PGP PUBLIC KEY BLOCK-----
  • PGP私钥：-----BEGIN PGP PRIVATE KEY BLOCK-----
  • RSA公钥/私钥：-----BEGIN RSA PUBLIC KEY----- / -----BEGIN RSA PRIVATE KEY-----
  • 支持包含元数据的密钥（如 Version:, Comment:, Charset: 等）

2. 加密消息

  1. 在主界面点击"加密消息"按钮
  2. 选择接收方的公钥（从下拉列表中选择）
  3. 在输入框中输入要加密的消息
  4. 点击"加密"按钮
  5. 加密完成后，点击"一键复制"按钮
  6. 将加密后的消息粘贴到微信发送给接收方

提示：

  • 加密后的消息是ASCII-armored格式，可以直接在微信中发送
  • 加密结果会自动复制到剪贴板，方便粘贴

3. 解密消息

  1. 收到加密消息后，复制加密内容
  2. 在主界面点击"解密消息"按钮
  3. 选择您的私钥（从下拉列表中选择）
  4. 如果私钥有密码保护，输入私钥密码
  5. 粘贴加密消息到输入框（或点击"粘贴"按钮）
  6. 点击"解密"按钮查看明文

提示：

  • 如果私钥有密码保护，必须输入正确的密码才能解密
  • 密码输入框支持显示/隐藏密码功能

4. 管理密钥

  • 查看密钥：在主界面查看所有已导入的密钥列表
  • 删除密钥：点击密钥右侧的删除按钮可以删除密钥
  • 密钥类型标识：私钥显示橙色图标，公钥显示蓝色图标

权限说明

应用需要以下权限：

  • 存储权限（可选）：

    • Android 12及以下：READ_EXTERNAL_STORAGE
    • Android 13+：READ_MEDIA_IMAGES, READ_MEDIA_VIDEO, READ_MEDIA_AUDIO
    • 注意：Android 10+ 使用Storage Access Framework，通常不需要存储权限即可选择文件

  • 前台服务权限：

    • Android 14+：FOREGROUND_SERVICE_DATA_SYNC

开发环境

  • Flutter SDK: 3.0+
  • Android SDK: 23+ (Android 6.0+)
  • Kotlin: 2.1.0+
  • Gradle: 8.11.1+
  • Android Gradle Plugin: 8.9.1+
  • Java: 11+

构建说明

开发构建

# 安装依赖
flutter pub get

# 运行应用（调试模式）
flutter run

# 构建APK（调试版）
flutter build apk

发布构建

# 清理构建缓存
flutter clean

# 获取依赖
flutter pub get

# 构建发布版APK
flutter build apk --release

构建完成后，APK文件位于：build/app/outputs/flutter-apk/app-release.apk

技术实现细节

PGP加密实现

  • 使用BouncyCastle库进行PGP加密/解密
  • 支持AES-256加密算法和完整性检查
  • Android P+兼容性支持（自动选择最佳加密提供者）

密钥管理

  • 自动解析和清理ASCII-armored格式的密钥
  • 支持包含元数据的密钥格式
  • 使用本地存储保存密钥数据

已知问题和限制

  1. 仅支持文本消息：当前版本仅支持文本消息的加密/解密，不支持文件加密
  2. 密钥格式：需要标准的PGP格式密钥，某些特殊格式可能无法识别
  3. Android版本兼容性：建议使用Android 6.0及以上版本，Android P+已完全支持

安全注意事项

  1. 私钥安全：

    • 私钥存储在应用本地，请妥善保管设备
    • 建议为私钥设置密码保护
    • 不要将私钥分享给他人

  2. 密钥管理：

    • 定期备份您的密钥
    • 如果设备丢失，及时撤销相关密钥

  3. 加密通信：

    • 确保接收方也使用此应用或兼容的PGP工具
    • 验证接收方的公钥指纹，防止中间人攻击

故障排除

常见问题

  • 加密失败：无法解析公钥

    • 检查公钥格式是否正确
    • 确保公钥包含完整的开始和结束标记

  • 解密失败：私钥密码错误

    • 确认输入的密码正确
    • 如果私钥未加密，可以留空密码

  • 未找到匹配的私钥

    • 确保使用的私钥与加密时使用的公钥对应

更新日志

v1.0.0

  • ✅ 实现PGP加密/解密功能
  • ✅ 密钥管理（导入、存储、删除）
  • ✅ 私钥密码保护支持
  • ✅ 一键复制加密结果
  • ✅ Android P+兼容性支持

许可证

本项目仅供学习和研究使用。

贡献

欢迎提交Issue和Pull Request！

联系方式

如有问题或建议，请通过GitHub Issues反馈。