#构建指南

%%{init: {'themeVariables': {'fontSize': '9px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '8px'}}}%%
graph TB
    subgraph root["仓库根目录"]
        A["package.json<br/>workspace 根脚本"]
        B["pnpm-workspace.yaml<br/>apps/* + packages/*"]
        C["Cargo.toml<br/>Cargo workspace + 统一 Lint"]
        D["rust-toolchain.toml<br/>固定 Rust 1.96.0"]
    end

    subgraph desktop["apps/desktop/ - 桌面应用 (@zephyr/desktop)"]
        E["src/<br/>原生 JS 前端 / 样式 / UI 模块"]
        F["src-tauri/<br/>Rust 后端 (crate: Zephyr)"]
        G["src-tauri/tauri.conf.json<br/>Tauri 与打包配置"]
        H["src-tauri/bundled/<br/>Full 版内置资源目录"]
        I["uno.config.js / eslint.config.mjs<br/>vitest.config.js"]
    end

    subgraph crates["crates/ - 共享 Rust 库"]
        J["core/<br/>zephyr-core 跨平台业务逻辑"]
        K["core-ffi/<br/>zephyr-core-ffi UniFFI 移动端绑定"]
    end

    subgraph packages["packages/ - 共享包"]
        L["shared/<br/>IPC 命令名常量 (COMMANDS)"]
        M["tokens/<br/>Design Token (Style Dictionary)"]
        N["scripts/<br/>i18n 完整性检查"]
    end

    A --> desktop
    B --> packages
    C --> F
    C --> crates
    F --> J
    L --> E
    M --> E

%%{init: {'themeVariables': {'fontSize': '9px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '8px'}, 'flowchart': {'curve': 'basis', 'nodeSpacing': 12, 'rankSpacing': 15}}}%%
flowchart TD
    A["pnpm build"] --> B["build:css<br/>copy-shared → build:tokens → UnoCSS<br/>(src/uno-generated.css)"]
    B --> C["tauri build<br/>(beforeBuildCommand 再次执行 build:css)"]
    C --> D["Cargo 编译 Rust 后端<br/>(release: lto + codegen-units=1)"]
    D --> E{"平台?"}

    E -- "Windows" --> F1["NSIS .exe"]
    E -- "Windows" --> F2["WiX .msi"]
    E -- "macOS" --> G1[".app + .dmg"]
    E -- "Linux" --> H1[".deb"]
    E -- "Linux" --> H2[".rpm"]
    E -- "Linux" --> H3[".AppImage<br/>(自定义 GTK 插件)"]

    F1 --> I["target/[triple/]release/bundle/"]
    F2 --> I
    G1 --> I
    H1 --> I
    H2 --> I
    H3 --> I

    style A fill:#3498db,stroke:#2980b9,color:#fff
    style I fill:#2ecc71,stroke:#27ae60,color:#fff

%%{init: {'themeVariables': {'fontSize': '10px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '10px'}, 'flowchart': {'curve': 'basis', 'nodeSpacing': 15, 'rankSpacing': 25}}}%%
flowchart LR
    A["查询 mihomo<br/>最新正式版 tag"] --> B["下载对应平台内核"]
    B --> C["与 GitHub API 返回的<br/>资产 SHA256 digest 比对"]
    C --> D["解压并重命名为<br/>zephyr-mihomo(.exe)"]
    A2["下载 geoip.dat / geosite.dat /<br/>Country.mmdb + .sha256sum"] --> E["SHA256 校验"]
    D --> F["apps/desktop/src-tauri/bundled/"]
    E --> F
    F --> G["打包 Full 版"]

    style C fill:#e74c3c,stroke:#c0392b,color:#fff
    style E fill:#e74c3c,stroke:#c0392b,color:#fff
    style G fill:#2ecc71,stroke:#27ae60,color:#fff

%%{init: {'themeVariables': {'fontSize': '9px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '8px'}, 'flowchart': {'curve': 'basis', 'nodeSpacing': 12, 'rankSpacing': 15}}}%%
flowchart TD
    A[克隆仓库] --> B[pnpm install<br/>同时安装 husky 钩子]
    B --> C[pnpm dev<br/>开发调试]
    C --> D[git commit]
    D --> E["pre-commit 钩子<br/>cargo fmt --check · pnpm lint · pnpm typecheck"]
    E --> F[git push]
    F --> G["pre-push 钩子<br/>cargo clippy · cargo test · pnpm test"]
    G --> H[提交 PR]
    H --> I["CI 工作流<br/>前端 / 许可证 / Rust 三平台"]
    H --> J["安全扫描<br/>Security Scan · CodeQL · GitGuardian 等"]
    H --> K["pre-commit.ci<br/>文件卫生检查"]
    I --> L[审查与合并]
    J --> L
    K --> L

%%{init: {'themeVariables': {'fontSize': '9px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '8px'}}}%%
graph TB
    BUILD["release.yml<br/>推送 v* tag"] --> MA["macOS arm64<br/>aarch64-apple-darwin<br/>macos-latest"]
    BUILD --> MX["macOS x64<br/>x86_64-apple-darwin<br/>macos-latest"]
    BUILD --> LX["Linux x64<br/>ubuntu-22.04"]
    BUILD --> LA["Linux arm64<br/>ubuntu-22.04-arm"]
    BUILD --> WX["Windows x64<br/>windows-latest"]
    BUILD --> WA["Windows arm64<br/>aarch64-pc-windows-msvc<br/>windows-latest"]

    MA --> DMG[".dmg（Full / Lite）"]
    MX --> DMG
    LX --> LIN[".deb / .rpm / .AppImage（Full / Lite）<br/>+ 便携版 tar.gz"]
    LA --> LIN
    WX --> WIN["NSIS .exe / .msi（Full / Lite）<br/>+ 便携版 zip"]
    WA --> WIN

    style BUILD fill:#3498db,stroke:#2980b9,color:#fff

%%{init: {'themeVariables': {'fontSize': '9px', 'nodeBorder': '1px', 'clusterBorder': '1px', 'edgeLabelHeight': '8px'}, 'flowchart': {'curve': 'basis', 'nodeSpacing': 12, 'rankSpacing': 15}}}%%
flowchart TD
    A["从 tag 解析版本号<br/>写入 tauri.conf.json / Cargo.toml / package.json"] --> B["安装 pnpm、Node LTS、Rust<br/>pnpm install --ignore-scripts"]
    B --> C["cargo-about 重新生成<br/>THIRD-PARTY-LICENSES.txt"]
    C --> D["下载并校验 mihomo + Geo 数据<br/>→ bundled/"]
    D --> E["构建 Full 版"]
    E --> F["清空 bundled/<br/>构建 Lite 版"]
    F --> G{"平台"}
    G -- "Linux" --> H["Full AppImage + core/ + .portable<br/>→ 便携版 tar.gz"]
    G -- "Windows" --> I["SignPath 签名 NSIS / MSI / 便携版 exe<br/>校验签名者为 SignPath Foundation"]
    I --> J["签名后的 exe + core/ + .portable<br/>→ 便携版 zip"]
    H --> K["Minisign 为全部产物生成 .minisig"]
    J --> K
    G -- "macOS" --> K
    K --> L["上传到草稿 Release"]
    L --> M["SBOM 任务：cargo-cyclonedx + cdxgen<br/>合并为 v&lt;版本&gt;.cdx.json 附加到 Release"]
    M --> N["人工发布 Release"]
    N --> O["自动更新 AUR / Scoop / Winget"]