# 如何触发 Release

## 1. 发布前提条件
- 代码已提交并合并到 `main` 分支
- 确定新版本号（如 `3.4.8-xg1`）

## 2. 发布方式

### 方式一：创建 Git Tag（推荐）
1. 本地创建 tag
```bash
git tag 3.4.8-xg1
git push origin 3.4.8-xg1
```

### 方式二：Gitea Web 界面
1. 在 Gitea 仓库页面
2. 点击 "发布"
3. 创建新 Tag

## 3. 构建和发布流程

### 自动触发条件
- 推送到 `main`/`develop` 分支
- 推送新的 Tag

### 构建矩阵
- 架构：amd64、arm64
- 发行版：Ubuntu、Alpine

## 4. 验证发布

### 检查构建产物
- Generic Package Registry
- Debian Package Registry
- GitHub/Gitea Release 页面

### 下载和测试
1. 直接从 Release 下载
2. 通过 Debian 仓库安装
```bash
sudo apt-get update
sudo apt-get install xxxigcc-proxy
```

## 5. 常见问题

### 构建失败
- 检查 CI 日志
- 验证代码是否通过所有测试
- 确认依赖项是否正确

### 包上传失败
- 检查 Build Token 权限
- 验证网络连接
- 确认包管理器配置