# 如何发布 Mond 项目

## 1. 准备工作

### 前提条件
- 已配置 Gitea 仓库
- 具备仓库管理员权限
- 已安装必要的构建工具

## 2. 创建 Release

### 方法一：GitHub/Gitea Web 界面
1. 导航到仓库 Releases 页面
2. 点击 "New Release"
3. 选择目标分支
4. 输入语义化版本标签（例如 `v1.2.3`）
5. 填写发布说明

### 方法二：命令行
```bash
git tag -a v1.2.3 -m "Release version 1.2.3"
git push origin v1.2.3
```

## 3. 配置 Gitea Secrets

### 必需的 Secrets
- `REGISTRY_USERNAME`: 包仓库用户名
- `REGISTRY_PASSWORD`: 包仓库认证令牌
- `GPG_PRIVATE_KEY`: 用于签名的 GPG 私钥
- `GPG_PASSPHRASE`: GPG 私钥密码

### 设置步骤
1. 进入仓库设置
2. 选择 "Secrets"
3. 添加每个必需的 Secret

## 4. 包管理仓库上传

### 自动上传
CI 流水线将自动上传到以下位置：
- **Generic Package Registry**：通用软件包仓库
- **Debian Package Registry**：stable 发行版

触发条件：新的版本标签推送

### 上传目标
所有 Debian 包统一上传到：
- 发行版：stable
- 组件：main
- 路径：`debian/pool/stable/main`

## 5. 发布后验证

1. 检查 GitHub/Gitea Releases
2. 验证包管理仓库的可用性
3. 测试不同平台的安装
4. 确认 systemd 服务正常运行

## 注意事项

- 遵循语义化版本（Semantic Versioning）
- 每次发布前运行完整的测试套件
- 更新 CHANGELOG.md