# 如何修改 CI/CD 工作流

## 1. 关键文件位置
- 工作流定义：`.gitea/workflows/ci.yaml`
- Debian 打包脚本：`debian/build-deb.sh`

## 2. 修改构建作业

### 2.1 添加新构建步骤
在 `build-and-test` 作业中添加步骤：
```yaml
- name: 新构建步骤
  run: |
    # 添加新的构建或测试逻辑
```

### 2.2 调整构建矩阵
修改 `strategy.matrix` 部分：
```yaml
strategy:
  matrix:
    arch: [amd64, arm64, riscv64]  # 添加新架构
    distro: [ubuntu, alpine, fedora]  # 添加新发行版
```

## 3. 修改发布作业

### 3.1 调整上传逻辑
在 `release` 作业中修改上传代码：
```yaml
- name: 上传到新的包管理器
  run: |
    # 添加新的上传目标
```

### 3.2 定制 Release 说明
修改 Python 代码生成 Release 说明：
```python
# 在生成 Release 说明的代码块中添加自定义逻辑
```

## 4. Debian 打包定制

### 4.1 修改打包脚本
编辑 `debian/build-deb.sh`：
- 添加新的架构支持
- 调整文件权限
- 修改 systemd 服务配置

### 4.2 更新控制文件模板
修改 `debian/control.template`：
- 更新依赖关系
- 调整包元数据

## 5. 测试工作流变更

### 5.1 本地测试
```bash
# 使用 act 或 gitea-act 在本地测试工作流
act -j build-and-test
```

### 5.2 分支测试
1. 创建新分支
2. 推送修改
3. 检查 CI 构建结果

## 6. 最佳实践

- 保持向后兼容性
- 详细记录工作流变更
- 增量测试新功能
- 遵循现有的构建和打包模式