# 发布流程架构

## 1. 身份与目的
- **名称：** xxxigcc-proxy 发布流程
- **目的：** 定义软件包分发和版本管理的标准流程

## 2. 包管理注册表

### 2.1 Generic Package Registry
`架构路径：.gitea/workflows/ci.yaml:125-135`

#### 特点
- 存储 tar.gz 二进制包
- 直接可下载链接
- 版本化管理

#### 上传逻辑
- 基于 curl 的 PUT 请求
- 使用 Build Token 认证
- 上传路径：`/api/packages/{owner}/generic/{product_name}/{version}/{filename}`

### 2.2 Debian Package Registry
`架构路径：.gitea/workflows/ci.yaml:137-152`

#### 特点
- 通用稳定版仓库
- 支持所有 Debian/Ubuntu 发行版
- 单一 `stable` 发行版代号

#### 上传逻辑
- 使用 curl 的 PUT 请求
- 上传到通用稳定版仓库
- 上传路径：`/api/packages/{owner}/debian/pool/stable/main/upload`

## 3. Release 生成策略

### 3.1 Release 内容
`架构路径：.gitea/workflows/ci.yaml:154-159`

#### 发布说明生成
- 使用 Python 动态生成 Markdown 格式
- 包含多种下载方式说明
- 提供仓库和直接下载链接

### 3.2 Release 创建
`架构路径：.gitea/workflows/ci.yaml:161-188`

#### 创建流程
- 使用 Gitea API 创建 Release
- 处理重复 Release 的情况
- 生成 Release JSON payload

### 3.3 附件上传
`架构路径：.gitea/workflows/ci.yaml:190-204`

#### 上传策略
- 上传 tar.gz 和 .deb 文件
- 作为 Release 附件
- 使用 multipart/form-data

## 4. 安装指南生成
生成通用 Debian 仓库的安装说明，包括：
- GPG 密钥下载
- 仓库添加（使用 `stable` 发行版代号）
- 包安装命令
- 支持所有 Debian/Ubuntu 发行版