# encryptionWidget

**Repository Path**: smartwsg/encryption-widget

## Basic Information

- **Project Name**: encryptionWidget
- **Description**: 基于 Tauri 的跨平台源代码加密工具，专为保护开发者核心知识产权而设计。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SourceCrypt

基于 Tauri 的跨平台源代码加密工具，专为保护开发者核心知识产权而设计。

## 功能特性

- **高强度加密**：采用 AES-256-GCM 加密算法，确保源代码安全
- **跨平台支持**：完美运行于 Windows、macOS 和 Linux
- **极简界面**：Vue3 + Element Plus 打造的现代化用户界面
- **拖拽操作**：支持直接拖拽项目文件夹进行加密/解密
- **目录结构保持**：加密后完美还原原有文件目录树结构
- **完全离线**：100% 本地处理，无任何网络请求
- **内存安全**：Rust 后端确保内存中的明文和密钥被安全擦除

## 技术栈

- **前端**：Vue 3 + TypeScript + Vite + Element Plus
- **后端**：Rust + Tauri + AES-256-GCM + Argon2
- **构建工具**：Tauri CLI

## 目录简介

```text
encryptionWidget/
├─ src/                # 前端页面与样式，Vue 应用入口
├─ src-tauri/          # Tauri Rust 后端、桌面端配置与加解密实现
│  ├─ src/             # Rust 核心代码，包含命令注册、文件处理、加解密逻辑与测试
│  ├─ icons/           # 应用图标资源
│  ├─ capabilities/    # Tauri 权限能力配置
│  └─ target/          # Rust 编译产物
├─ public/             # 静态资源
├─ AI/                 # 项目需求与产品文档
├─ demo_third_party*.mjs
│                     # 第三方代码混淆/加密相关示例脚本
├─ index.html          # Vite 页面模板
├─ package.json        # 前端依赖与脚本配置
└─ README.md           # 项目说明文档
```

- `src/App.vue`：前端主界面，负责目录选择、密码输入与操作交互
- `src/main.ts`：前端应用启动入口
- `src-tauri/src/crypto.rs`：核心加解密逻辑实现
- `src-tauri/src/file_ops.rs`：文件扫描、读写与路径处理
- `src-tauri/src/commands.rs`：前端调用的 Tauri 命令入口
- `src-tauri/tauri.conf.json`：桌面应用打包与窗口配置
- `AI/PRD.md`：产品需求说明

## 快速开始

### 开发环境

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run tauri dev
```

### 构建发布

```bash
# 构建生产版本
npm run tauri build
```

## 使用说明

1. **加密源代码**：
   - 拖拽项目文件夹到应用窗口
   - 或点击"选择目录"按钮
   - 输入加密密码
   - 点击"开始加密"

2. **解密源代码**：
   - 拖拽加密后的文件夹到应用窗口
   - 输入解密密码
   - 点击"开始解密"

## 安全特性

- **密钥派生**：使用 Argon2 算法将用户密码安全派生为加密密钥
- **随机盐值**：每次加密都生成随机盐值，确保相同密码产生不同密钥
- **随机 IV**：每个文件使用独立的随机初始化向量
- **原子化写入**：加密过程采用临时文件+重命名策略，防止数据损坏
- **路径校验**：严格防止输出目录与输入目录冲突，避免递归死循环

## 开发计划

- [x] MVP 基础版：核心加解密功能
- [ ] 体验进阶版：`.gitignore` 规则解析、进度条反馈
- [ ] 高级特性版：密钥文件导出/导入、多线程优化、系统密钥串集成

## 注意事项

- 请妥善保管加密密码，忘记密码将导致数据无法恢复
- 建议在加密前备份重要源代码
- 加密过程会忽略以点开头的隐藏文件和目录

## 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件