# 构建快速参考

## 常用命令

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

# 构建
npm run build                         # 仅构建前端
npm run tauri:build                   # 构建完整应用

# 清理
npm run clean                         # 清理前端构建
cargo clean                           # 清理 Rust 构建

# 检查
./scripts/check-build.sh              # 检查构建环境
```

## Docker 构建

```bash
./scripts/docker-build.sh             # 使用 Docker 构建
```

## 发布流程

```bash
# 1. 更新版本
vim package.json                      # 更新 version
vim src-tauri/tauri.conf.json         # 更新 version

# 2. 更新 CHANGELOG
vim CHANGELOG.md

# 3. 提交并打标签
git add .
git commit -m "Release v0.1.0"
git tag v0.1.0
git push origin main
git push origin v0.1.0
```

## 构建输出位置

| 平台   | 路径                                      |
|--------|-------------------------------------------|
| Linux  | `src-tauri/target/release/bundle/`       |
| Windows| `src-tauri/target/release/bundle/`       |
| macOS  | `src-tauri/target/release/bundle/`       |

## 常见问题

### Q: Rust 未找到
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
```

### Q: Linux 缺少依赖
```bash
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev \
  libappindicator3-dev librsvg2-dev patchelf
```

### Q: 构建失败
```bash
npm run clean
cargo clean
rm -rf node_modules
npm install
```

## CI/CD 状态

查看构建状态：
- GitHub: https://github.com/your-repo/actions

## 版本号规则

遵循 SemVer: `MAJOR.MINOR.PATCH`
- MAJOR: 不兼容的 API 变更
- MINOR: 向后兼容的新功能
- PATCH: 向后兼容的问题修复

示例:
- 0.1.0 → 0.2.0 (新功能)
- 0.2.0 → 0.2.1 (bug 修复)
- 1.0.0 → 2.0.0 (重大变更)