# ParqForge 开发与发布

## Workspace 结构

- `parqforge-core`：跨平台数据源发现、Parquet metadata、schema 和行数据读取的内部库。
- `parqforge-cli`：构建 `pqx` 命令行工具，面向 Windows、Linux 和 macOS。
- `parqforge-desktop`：构建 Windows 优先的 ParqForge Desktop GUI。

## 本地构建

```sh
cargo build --release                       # core + CLI（默认，轻量、跨平台）
cargo build --release -p parqforge-desktop  # GUI（显式，拉取 gpui，Windows 优先）
```

## Release 流程

推送一个 `vX.Y.Z` Git tag 会触发 CI，并将以下产物汇总到同一个 GitHub Release：

- CLI 裸二进制：macOS × x86_64/aarch64，以及 Linux × x86_64/aarch64 的 musl/GNU 双版本（`parqforge-cli-*.tar.gz`）。Linux 产物均由 `cross` 构建：musl 版静态链接；GNU 版通过 `Cross.toml` 的 CentOS 7 镜像固定为 glibc 2.17 基线。
- Windows GUI：MSI 安装器和便携 bundle zip（均含 GUI 与 `pqx`）
- `SHA256SUMS.txt` 校验清单

Windows MSI 由 [`cargo-wix`](https://github.com/volks73/cargo-wix) 根据
`crates/parqforge-desktop/wix/main.wxs` 构建。

## 发布前检查

```sh
cargo check -p parqforge-cli
cargo test -p parqforge-cli
git diff --check
```