简化 Debian 发布流程并添加项目文档系统
All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in -13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in -6s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in -7s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 7s
Build and Release / release (push) Successful in 21s

- 将 Debian 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库
- 新增完整的 llmdoc 文档系统,包含架构、指南和参考文档
- 更新 README.md 和部署指南以反映新的仓库配置
- 添加 .gitignore 文件
This commit is contained in:
2025-12-25 10:18:07 +08:00
parent 76aac67b71
commit 9afe4a8649
28 changed files with 1297 additions and 31 deletions

View File

@@ -0,0 +1,66 @@
# 发布流程架构
## 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 发行版