08-architecture

项目结构

Submodules（独立仓库）

AuroraView 将部分功能模块拆分为独立的 Git submodules，便于独立维护、版本控制和复用：

submodules/
├── auroraview-pack/        # 应用打包系统
│   └── https://github.com/loonghao/auroraview-pack.git
├── auroraview-protect/     # Python 代码保护（字节码加密）
│   └── https://github.com/loonghao/auroraview-protect.git
├── auroraview-signals/     # 信号/槽系统（类 Qt Signals）
│   └── https://github.com/loonghao/auroraview-signals.git
└── auroraview-extensions/  # 扩展系统（Chrome 风格扩展）
    └── https://github.com/loonghao/auroraview-extensions.git

各 Submodule 职责

Submodule	描述	主要功能
auroraview-pack	应用打包系统	将前端 + Python 后端打包为单一 .exe，支持 overlay 模式、资源压缩、图标设置、Python 依赖收集
auroraview-protect	代码保护	Python 字节码编译 + X25519/AES-256-GCM 加密，保护源代码不被反编译
auroraview-signals	信号系统	信号/槽机制，支持异步事件分发和跨组件通信
auroraview-extensions	扩展系统	Chrome 风格扩展架构，manifest.json 定义、权限管理、扩展生命周期

Submodule 使用规范

1. 克隆项目：使用 --recurse-submodules 确保 submodules 被正确初始化

   git clone --recurse-submodules https://github.com/loonghao/auroraview.git
   

2. 更新 Submodules：

   git submodule update --init --recursive
   

3. 在 Cargo.toml 中引用：

   [dependencies]
   auroraview-pack = { path = "submodules/auroraview-pack" }
   auroraview-protect = { path = "submodules/auroraview-protect" }
   

4. 独立开发：每个 submodule 可以独立开发、测试和发布，修改后需要在主仓库提交 submodule 引用更新

主仓库结构

auroraview/
├── crates/                 # Rust crates（本地）
│   ├── auroraview-core/    # 核心功能
│   ├── auroraview-cli/     # CLI 工具
│   ├── auroraview-plugins/ # 插件系统
│   └── ...
├── python/                 # Python 包
│   └── auroraview/
├── packages/               # TypeScript/JavaScript 包
│   └── auroraview-sdk/     # 前端 SDK (@auroraview/sdk)
├── gallery/                # Gallery 演示应用
├── examples/               # 示例代码
├── submodules/             # Git submodules（见上文）
└── docs/                   # 文档

auroraview-pack 打包系统

架构概览

┌─────────────────────────────────────────────────────────────┐
│                      PackManager                            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Plugins   │  │   Packers   │  │   Targets   │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────────────────────────────────────────┘
                             │
          ┌──────────────────┼──────────────────┐
          ▼                  ▼                  ▼
   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
   │   Desktop   │    │   Mobile    │    │ MiniProgram │
   │ Win/Mac/Lin │    │  iOS/And    │    │ WX/Ali/Byte │
   └─────────────┘    └─────────────┘    └─────────────┘