release-it-gitea 1.3.3 → 1.4.1

package/README.en.md

@@ -0,0 +1,402 @@
+# Release It! Gitea Plugin
+
+English | [中文](README.md)
+
+A [release-it](https://github.com/release-it/release-it) plugin for Gitea that supports automatic Gitea release creation and asset uploads.
+
+## Features
+
+- ✅ Automatically create and update Gitea releases
+- ✅ Support template variable substitution (version, changelog, etc.)
+- ✅ Support draft and prerelease versions
+- ✅ **Support file and folder asset uploads**
+- ✅ **Support automatic folder packaging to ZIP**
+- ✅ **Support wildcard file matching**
+
+## Quick Start
+
+### 1. Install Plugin
+
+```bash
+npm install --save-dev release-it-gitea
+# or
+pnpm add -D release-it-gitea
+# or
+yarn add -D release-it-gitea
+```
+
+### 2. Set Environment Variables
+
+```bash
+export GITEA_TOKEN="your-gitea-api-token"
+```
+
+### 3. Basic Configuration
+
+Add to `.release-it.json`:
+
+```json
+{
+	"plugins": {
+		"release-it-gitea": {
+			"host": "https://gitea.example.com",
+			"owner": "your-username",
+			"repository": "your-repo"
+		}
+	}
+}
+```
+
+### 4. Run Release
+
+```bash
+npx release-it
+```
+
+## Detailed Configuration
+
+### Basic Configuration Options
+
+| Option         | Type    | Default                     | Description                    |
+| -------------- | ------- | --------------------------- | ------------------------------ |
+| `host`         | string  | Current repository host     | Gitea server URL               |
+| `owner`        | string  | Auto-detect from git remote | Repository owner               |
+| `repository`   | string  | Auto-detect from git remote | Repository name                |
+| `release`      | boolean | `true`                      | Whether to create release      |
+| `releaseTitle` | string  | `"v${version}"`             | Release title template         |
+| `releaseNotes` | string  | `"${changelog}"`            | Release notes template         |
+| `prerelease`   | boolean | `false`                     | Whether it's a prerelease      |
+| `draft`        | boolean | `false`                     | Whether it's a draft           |
+| `tokenRef`     | string  | `"GITEA_TOKEN"`             | API token environment variable |
+| `timeout`      | number  | `30000`                     | Request timeout (milliseconds) |
+| `assets`       | array   | `[]`                        | Additional asset files         |
+
+### Complete Configuration Example
+
+```json
+{
+	"plugins": {
+		"release-it-gitea": {
+			"host": "https://gitea.example.com",
+			"owner": "your-username",
+			"repository": "your-repo",
+			"release": true,
+			"releaseTitle": "Release ${version}",
+			"releaseNotes": "## What's New\n\n${changelog}",
+			"prerelease": false,
+			"draft": false,
+			"tokenRef": "GITEA_TOKEN",
+			"timeout": 30000,
+			"assets": [
+				"dist/app.js",
+				"README.md",
+				{
+					"path": "dist/**/*",
+					"name": "distribution-${version}.zip",
+					"type": "zip",
+					"label": "Distribution Files"
+				}
+			]
+		}
+	}
+}
+```
+
+## Asset Upload Features
+
+### Basic Usage
+
+Supports multiple asset configuration formats:
+
+```json
+{
+	"assets": [
+		"dist/app.js", // Single file
+		"dist/**/*.min.js", // Wildcard matching
+		"*.md" // Multiple matching files
+	]
+}
+```
+
+### Advanced Configuration
+
+Use object format for more detailed configuration:
+
+```json
+{
+	"assets": [
+		{
+			"path": "dist/**/*",
+			"name": "distribution-files.zip",
+			"type": "zip",
+			"label": "Distribution Files"
+		},
+		{
+			"path": "docs/*.md",
+			"type": "file",
+			"label": "Documentation"
+		},
+		{
+			"path": "src",
+			"name": "source-code-${version}.zip",
+			"type": "zip",
+			"label": "Source Code"
+		}
+	]
+}
+```
+
+### Asset Configuration Parameters
+
+| Property | Type            | Required | Description                                              |
+| -------- | --------------- | -------- | -------------------------------------------------------- |
+| `path`   | string          | ✅       | File or folder path, supports wildcards                  |
+| `name`   | string          | ❌       | Upload filename, uses original filename if not specified |
+| `type`   | 'file' \| 'zip' | ❌       | File type, defaults to 'file'                            |
+| `label`  | string          | ❌       | File label for identifying file purpose                  |
+
+### File Type Description
+
+- **`file`**: Directly upload matched files
+- **`zip`**: Package matched files into ZIP before upload
+
+## Usage Examples
+
+### Example 1: Upload Build Artifacts
+
+```json
+{
+	"assets": ["dist/bundle.js", "dist/bundle.css", "dist/assets/**/*"]
+}
+```
+
+### Example 2: Package Source Code Release
+
+```json
+{
+	"assets": [
+		{
+			"path": "src/**/*",
+			"name": "source-v${version}.zip",
+			"type": "zip",
+			"label": "Source Code"
+		}
+	]
+}
+```
+
+### Example 3: Multiple File Type Combination
+
+```json
+{
+	"assets": [
+		"README.md",
+		"CHANGELOG.md",
+		{
+			"path": "dist",
+			"name": "build-output.zip",
+			"type": "zip"
+		},
+		{
+			"path": "docs/**/*.pdf",
+			"type": "file",
+			"label": "Documentation"
+		}
+	]
+}
+```
+
+### Example 4: Different Environment Configurations
+
+```json
+{
+	"assets": [
+		{
+			"path": "dist/prod/**/*",
+			"name": "production-build-${version}.zip",
+			"type": "zip",
+			"label": "Production Build"
+		},
+		{
+			"path": "dist/dev/**/*",
+			"name": "development-build-${version}.zip",
+			"type": "zip",
+			"label": "Development Build"
+		}
+	]
+}
+```
+
+## Environment Variable Configuration
+
+### Default Token Configuration
+
+```bash
+export GITEA_TOKEN=your_gitea_api_token
+```
+
+### Custom Token Configuration
+
+```json
+{
+	"tokenRef": "MY_GITEA_TOKEN"
+}
+```
+
+```bash
+export MY_GITEA_TOKEN=your_gitea_api_token
+```
+
+## Template Variables
+
+The following variables can be used in `releaseTitle`, `releaseNotes`, and asset `name`:
+
+| Variable             | Description      | Example              |
+| -------------------- | ---------------- | -------------------- |
+| `${version}`         | Current version  | `1.2.3`              |
+| `${latestVersion}`   | Previous version | `1.2.2`              |
+| `${changelog}`       | Changelog        | `- Fixed some bug`   |
+| `${name}`            | Project name     | `my-awesome-project` |
+| `${repo.owner}`      | Repository owner | `username`           |
+| `${repo.repository}` | Repository name  | `my-repo`            |
+| `${branchName}`      | Branch name      | `main`               |
+
+### Template Usage Example
+
+```json
+{
+	"releaseTitle": "🚀 ${name} v${version}",
+	"releaseNotes": "## 📋 What's New\n\n${changelog}\n\n## 📦 Download\n\nPlease download the appropriate file for your platform",
+	"assets": [
+		{
+			"path": "dist/**/*",
+			"name": "${name}-${version}-dist.zip",
+			"type": "zip",
+			"label": "${name} v${version} Distribution"
+		}
+	]
+}
+```
+
+## Troubleshooting
+
+### Common Issues and Solutions
+
+#### 1. Asset Upload Failed
+
+**Symptoms:**
+
+- Error occurs during asset upload
+- File not found
+
+**Solutions:**
+
+- Check if file paths are correct
+- Ensure files exist and are readable
+- Check if Gitea API Token has asset upload permissions
+
+#### 2. ZIP File Creation Failed
+
+**Symptoms:**
+
+- Error occurs during ZIP file creation
+- Insufficient disk space error
+
+**Solutions:**
+
+- Ensure sufficient disk space is available
+- Check temporary directory permissions
+- Verify that files to be packaged exist
+
+#### 3. Wildcard Matching No Files
+
+**Symptoms:**
+
+- Wildcard pattern matches no files
+- Asset list is empty
+
+**Solutions:**
+
+- Verify wildcard pattern is correct
+- Check current working directory
+- Test with absolute or relative paths
+
+#### 4. API Request Failed
+
+**Symptoms:**
+
+- 401 Unauthorized error
+- 404 Repository not found error
+- Network timeout
+
+**Solutions:**
+
+- Check if Gitea server address is correct
+- Verify API Token is valid and not expired
+- Confirm repository owner and name are correct
+- Check network connection and firewall settings
+
+### Debugging Tips
+
+#### Enable Verbose Logging
+
+```bash
+npx release-it --verbose
+```
+
+#### Use Dry Run Mode
+
+```bash
+npx release-it --dry-run
+```
+
+#### Check Configuration
+
+```bash
+npx release-it --config --verbose
+```
+
+## Development Guide
+
+### Development Environment Setup
+
+```bash
+# Clone repository
+git clone https://github.com/lib-pack/release-it-gitea.git
+cd release-it-gitea
+
+# Install dependencies
+pnpm install
+
+# Build project
+pnpm build
+
+# Run tests
+pnpm test
+
+# Code linting
+pnpm lint
+
+# Format code
+pnpm format
+```
+
+### Contributing Guide
+
+1. Fork the project
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Create a Pull Request
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE.md](LICENSE.md) file for details.
+
+## Acknowledgments
+
+Thanks to all developers who have contributed to this project!
+
+---
+
+If you find this project helpful, please give us a ⭐️!

package/README.md

@@ -1,18 +1,21 @@
-# release-it-gitea
+# Release It! Gitea Plugin
 
-一个用于 [release-it](https://github.com/release-it/release-it) 的 Gitea 插件，可以在生成版本和 changelog 后自动将它们推送到指定的 Gitea 服务器的仓库发布中。
+[English](README.en.md) | 中文
+
+一个用于 [release-it](https://github.com/release-it/release-it) 的 Gitea 插件，支持自动创建 Gitea 发布并上传附件。
 
 ## 功能特性
 
-- ✅ 自动创建 Gitea 发布
-- ✅ 支持自定义发布标题和说明
-- ✅ 支持预发布和草稿发布
-- ✅ 支持模板变量替换
-- ✅ 自动检测并更新已存在的发布
-- ✅ 完整的错误处理和日志记录
-- ✅ TypeScript 支持
+- ✅ 自动创建和更新 Gitea 发布
+- ✅ 支持模板变量替换（版本号、变更日志等）
+- ✅ 支持草稿和预发布版本
+- ✅ **支持文件和文件夹附件上传**
+- ✅ **支持自动打包文件夹为 ZIP**
+- ✅ **支持通配符文件匹配**
+
+## 快速开始
 
-## 安装
+### 1. 安装插件
 
 ```bash
 npm install --save-dev release-it-gitea
@@ -22,19 +25,53 @@ pnpm add -D release-it-gitea
 yarn add -D release-it-gitea
 ```
 
-## 配置
+### 2. 设置环境变量
+
+```bash
+export GITEA_TOKEN="your-gitea-api-token"
+```
+
+### 3. 基础配置
+
+在 `.release-it.json` 中添加：
 
-### 1. 设置环境变量
+```json
+{
+	"plugins": {
+		"release-it-gitea": {
+			"host": "https://gitea.example.com",
+			"owner": "your-username",
+			"repository": "your-repo"
+		}
+	}
+}
+```
 
-首先，你需要设置 Gitea API token：
+### 4. 运行发布
 
 ```bash
-export GITEA_TOKEN="your-gitea-api-token"
+npx release-it
 ```
 
-### 2. 配置 release-it
+## 详细配置
 
-在你的 `.release-it.json` 文件中添加插件配置：
+### 基本配置选项
+
+| 选项           | 类型    | 默认值                 | 描述                 |
+| -------------- | ------- | ---------------------- | -------------------- |
+| `host`         | string  | 当前仓库的 host        | Gitea 服务器 URL     |
+| `owner`        | string  | 从 git remote 自动检测 | 仓库所有者           |
+| `repository`   | string  | 从 git remote 自动检测 | 仓库名称             |
+| `release`      | boolean | `true`                 | 是否创建发布         |
+| `releaseTitle` | string  | `"v${version}"`        | 发布标题模板         |
+| `releaseNotes` | string  | `"${changelog}"`       | 发布说明模板         |
+| `prerelease`   | boolean | `false`                | 是否为预发布         |
+| `draft`        | boolean | `false`                | 是否为草稿           |
+| `tokenRef`     | string  | `"GITEA_TOKEN"`        | API token 环境变量名 |
+| `timeout`      | number  | `30000`                | 请求超时时间（毫秒） |
+| `assets`       | array   | `[]`                   | 附加的资源文件       |
+
+### 完整配置示例
 
 ```json
 {
@@ -44,125 +81,284 @@ export GITEA_TOKEN="your-gitea-api-token"
 			"owner": "your-username",
 			"repository": "your-repo",
 			"release": true,
-			"releaseTitle": "v${version}",
-			"releaseNotes": "${changelog}",
+			"releaseTitle": "Release ${version}",
+			"releaseNotes": "## 更新内容\n\n${changelog}",
 			"prerelease": false,
-			"draft": false
+			"draft": false,
+			"tokenRef": "GITEA_TOKEN",
+			"timeout": 30000,
+			"assets": [
+				"dist/app.js",
+				"README.md",
+				{
+					"path": "dist/**/*",
+					"name": "distribution-${version}.zip",
+					"type": "zip",
+					"label": "Distribution Files"
+				}
+			]
 		}
 	}
 }
 ```
 
-或者在 `package.json` 中：
+## 附件上传功能
+
+### 基本用法
+
+支持多种格式的附件配置：
 
 ```json
 {
-	"release-it": {
-		"plugins": {
-			"release-it-gitea": {
-				"host": "https://gitea.example.com",
-				"owner": "your-username",
-				"repository": "your-repo",
-				"release": true
-			}
+	"assets": [
+		"dist/app.js", // 单个文件
+		"dist/**/*.min.js", // 通配符匹配
+		"*.md" // 多个匹配文件
+	]
+}
+```
+
+### 高级配置
+
+使用对象格式进行更详细的配置：
+
+```json
+{
+	"assets": [
+		{
+			"path": "dist/**/*",
+			"name": "distribution-files.zip",
+			"type": "zip",
+			"label": "Distribution Files"
+		},
+		{
+			"path": "docs/*.md",
+			"type": "file",
+			"label": "Documentation"
+		},
+		{
+			"path": "src",
+			"name": "source-code-${version}.zip",
+			"type": "zip",
+			"label": "Source Code"
 		}
-	}
+	]
 }
 ```
 
-## 配置选项
+### 附件配置参数
 
-| 选项           | 类型      | 默认值                 | 描述                 |
-| -------------- | --------- | ---------------------- | -------------------- |
-| `host`         | `string`  | 当前仓库的 host        | Gitea 服务器 URL     |
-| `owner`        | `string`  | 从 git remote 自动检测 | 仓库所有者           |
-| `repository`   | `string`  | 从 git remote 自动检测 | 仓库名称             |
-| `release`      | `boolean` | `true`                 | 是否创建发布         |
-| `releaseTitle` | `string`  | `"v${version}"`        | 发布标题模板         |
-| `releaseNotes` | `string`  | `"${changelog}"`       | 发布说明模板         |
-| `prerelease`   | `boolean` | `false`                | 是否为预发布         |
-| `draft`        | `boolean` | `false`                | 是否为草稿           |
-| `tokenRef`     | `string`  | `"GITEA_TOKEN"`        | API token 环境变量名 |
-| `timeout`      | `number`  | `30000`                | 请求超时时间（毫秒） |
+| 属性    | 类型            | 必需 | 描述                                 |
+| ------- | --------------- | ---- | ------------------------------------ |
+| `path`  | string          | ✅   | 文件或文件夹路径，支持通配符         |
+| `name`  | string          | ❌   | 上传后的文件名，不指定则使用原文件名 |
+| `type`  | 'file' \| 'zip' | ❌   | 文件类型，默认为 'file'              |
+| `label` | string          | ❌   | 文件标签，用于标识文件用途           |
 
-## 模板变量
+### 文件类型说明
 
-在 `releaseTitle` 和 `releaseNotes` 中可以使用以下模板变量：
+- **`file`**: 直接上传匹配到的文件
+- **`zip`**: 将匹配到的文件打包成 ZIP 文件后上传
 
-- `${version}` - 当前版本号
-- `${latestVersion}` - 上一个版本号
-- `${changelog}` - 生成的 changelog
-- `${name}` - 项目名称
-- `${repo.owner}` - 仓库所有者
-- `${repo.repository}` - 仓库名称
-- `${branchName}` - 当前分支名
+## 使用场景示例
 
-## 使用示例
+### 场景 1：上传构建产物
 
-### 基础配置
+```json
+{
+	"assets": ["dist/bundle.js", "dist/bundle.css", "dist/assets/**/*"]
+}
+```
+
+### 场景 2：打包源代码发布
 
 ```json
 {
-	"plugins": {
-		"release-it-gitea": {
-			"host": "https://gitea.example.com"
+	"assets": [
+		{
+			"path": "src/**/*",
+			"name": "source-v${version}.zip",
+			"type": "zip",
+			"label": "Source Code"
 		}
-	}
+	]
 }
 ```
 
-### 完整配置
+### 场景 3：多种文件类型组合
 
 ```json
 {
-	"plugins": {
-		"release-it-gitea": {
-			"host": "https://gitea.example.com",
-			"owner": "myorg",
-			"repository": "myproject",
-			"release": true,
-			"releaseTitle": "Release ${version}",
-			"releaseNotes": "## 更新内容\n\n${changelog}\n\n---\n\n完整更新日志请查看 [CHANGELOG.md](./CHANGELOG.md)",
-			"prerelease": false,
-			"draft": false,
-			"tokenRef": "GITEA_TOKEN",
-			"timeout": 30000
+	"assets": [
+		"README.md",
+		"CHANGELOG.md",
+		{
+			"path": "dist",
+			"name": "build-output.zip",
+			"type": "zip"
+		},
+		{
+			"path": "docs/**/*.pdf",
+			"type": "file",
+			"label": "Documentation"
 		}
-	}
+	]
 }
 ```
 
-### 预发布配置
+### 场景 4：不同环境的配置
 
 ```json
 {
-	"plugins": {
-		"release-it-gitea": {
-			"host": "https://gitea.example.com",
-			"releaseTitle": "v${version} (预发布)",
-			"prerelease": true
+	"assets": [
+		{
+			"path": "dist/prod/**/*",
+			"name": "production-build-${version}.zip",
+			"type": "zip",
+			"label": "Production Build"
+		},
+		{
+			"path": "dist/dev/**/*",
+			"name": "development-build-${version}.zip",
+			"type": "zip",
+			"label": "Development Build"
 		}
-	}
+	]
 }
 ```
 
-## 工作流程
+## 环境变量配置
 
-1. **初始化阶段** - 验证配置和 API 连接
-2. **发布阶段** - 创建或更新 Gitea 发布
-3. **发布后阶段** - 显示发布链接
+### 默认 Token 配置
 
-## 错误处理
+```bash
+export GITEA_TOKEN=your_gitea_api_token
+```
 
-插件包含完整的错误处理：
+### 自定义 Token 配置
 
-- 配置验证
-- API token 验证
-- 网络连接检查
-- API 请求错误处理
-- 详细的错误日志
+```json
+{
+	"tokenRef": "MY_GITEA_TOKEN"
+}
+```
+
+```bash
+export MY_GITEA_TOKEN=your_gitea_api_token
+```
+
+## 模板变量
+
+在 `releaseTitle`、`releaseNotes` 和附件 `name` 中可以使用以下变量：
+
+| 变量                 | 描述         | 示例                 |
+| -------------------- | ------------ | -------------------- |
+| `${version}`         | 当前版本号   | `1.2.3`              |
+| `${latestVersion}`   | 上一个版本号 | `1.2.2`              |
+| `${changelog}`       | 变更日志     | `- 修复了某个bug`    |
+| `${name}`            | 项目名称     | `my-awesome-project` |
+| `${repo.owner}`      | 仓库所有者   | `username`           |
+| `${repo.repository}` | 仓库名称     | `my-repo`            |
+| `${branchName}`      | 分支名称     | `main`               |
+
+### 模板使用示例
+
+```json
+{
+	"releaseTitle": "🚀 ${name} v${version}",
+	"releaseNotes": "## 📋 更新内容\n\n${changelog}\n\n## 📦 下载\n\n请下载对应平台的文件",
+	"assets": [
+		{
+			"path": "dist/**/*",
+			"name": "${name}-${version}-dist.zip",
+			"type": "zip",
+			"label": "${name} v${version} Distribution"
+		}
+	]
+}
+```
+
+## 故障排除
+
+### 常见问题及解决方案
+
+#### 1. 附件上传失败
+
+**问题症状：**
+
+- 附件上传时出现错误
+- 文件找不到
+
+**解决方案：**
+
+- 检查文件路径是否正确
+- 确保文件存在且可读
+- 检查 Gitea API Token 权限是否包含附件上传权限
+
+#### 2. ZIP 文件创建失败
+
+**问题症状：**
+
+- ZIP 文件创建时出错
+- 磁盘空间不足错误
+
+**解决方案：**
+
+- 确保有足够的磁盘空间
+- 检查临时目录权限
+- 验证要打包的文件是否存在
 
-## 开发
+#### 3. 通配符匹配无文件
+
+**问题症状：**
+
+- 通配符模式没有匹配到任何文件
+- 附件列表为空
+
+**解决方案：**
+
+- 验证通配符模式是否正确
+- 检查当前工作目录
+- 使用绝对路径或相对路径进行测试
+
+#### 4. API 请求失败
+
+**问题症状：**
+
+- 401 未授权错误
+- 404 仓库不存在错误
+- 网络超时
+
+**解决方案：**
+
+- 检查 Gitea 服务器地址是否正确
+- 验证 API Token 是否有效且未过期
+- 确认仓库所有者和名称正确
+- 检查网络连接和防火墙设置
+
+### 调试技巧
+
+#### 启用详细日志
+
+```bash
+npx release-it --verbose
+```
+
+#### 使用干运行模式
+
+```bash
+npx release-it --dry-run
+```
+
+#### 检查配置
+
+```bash
+npx release-it --config --verbose
+```
+
+## 开发指南
+
+### 开发环境搭建
 
 ```bash
 # 克隆仓库
@@ -172,7 +368,7 @@ cd release-it-gitea
 # 安装依赖
 pnpm install
 
-# 构建
+# 构建项目
 pnpm build
 
 # 运行测试
@@ -180,12 +376,27 @@ pnpm test
 
 # 代码检查
 pnpm lint
+
+# 格式化代码
+pnpm format
 ```
 
+### 贡献指南
+
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
 ## 许可证
 
-MIT
+本项目采用 MIT 许可证。详情请参阅 [LICENSE.md](LICENSE.md) 文件。
+
+## 致谢
+
+感谢所有为这个项目做出贡献的开发者！
 
-## 贡献
+---
 
-欢迎提交 Issue 和 Pull Request！
+如果您觉得这个项目对您有帮助，请给我们一个 ⭐️！

package/lib/global.d.d.ts

@@ -54,6 +54,21 @@ declare module "release-it" {
 	}
 }
 
+/** 附件配置接口 */
+interface GiteaAssetConfig {
+	/** 文件或文件夹路径，支持通配符 */
+	path: string;
+
+	/** 上传后的文件名，如果不指定则使用原文件名 */
+	name?: string;
+
+	/** 文件类型：'file' 表示单个文件，'zip' 表示打包成 zip 文件 */
+	type?: "file" | "zip";
+
+	/** 文件标签，用于标识文件用途 */
+	label?: string;
+}
+
 interface GiteaConfig {
 	/** Gitea 服务器的完整 URL 地址 */
 	host: string;
@@ -84,4 +99,7 @@ interface GiteaConfig {
 
 	/** API 请求的超时时间，单位为毫秒 */
 	timeout?: number;
+
+	/** 要上传的附件列表 */
+	assets?: (GiteaAssetConfig | string)[];
 }

package/lib/index.d.ts

@@ -58,6 +58,46 @@ declare class GiteaPlugin extends Plugin {
      * @returns 替换变量后的字符串
      */
     private interpolate;
+    /**
+     * 解析附件配置，将字符串格式转换为标准配置对象
+     * @param asset 附件配置
+     * @returns 标准化的附件配置对象
+     */
+    private normalizeAssetConfig;
+    /**
+     * 根据路径模式匹配文件
+     * @param pattern 文件路径模式，支持通配符
+     * @returns 匹配到的文件路径数组
+     */
+    private resolveFiles;
+    /**
+     * 创建 ZIP 压缩包
+     * @param files 要压缩的文件列表
+     * @param outputPath 输出的 ZIP 文件路径
+     * @param basePath 基础路径，用于确定文件在压缩包中的相对路径
+     * @returns Promise<void>
+     */
+    private createZipArchive;
+    /**
+     * 上传单个附件到 Gitea 发布
+     * @param releaseId 发布 ID
+     * @param filePath 文件路径
+     * @param fileName 上传后的文件名
+     * @param label 文件标签
+     * @returns 上传结果
+     */
+    private uploadAsset;
+    /**
+     * 处理并上传所有配置的附件
+     * @param releaseId 发布 ID
+     */
+    private uploadAssets;
+    /**
+     * 处理单个附件配置
+     * @param releaseId 发布 ID
+     * @param config 附件配置
+     */
+    private processAsset;
     /**
      * 执行发布操作，创建或更新 Gitea 发布.
      * @throws 当发布创建失败时抛出错误

package/lib/index.js

@@ -1,4 +1,9 @@
+import archiver from "archiver";
+import FormData from "form-data";
+import { createReadStream, createWriteStream, statSync } from "fs";
+import { glob } from "glob";
 import fetch from "node-fetch";
+import { basename, dirname, join } from "path";
 import { Plugin } from "release-it";
 class GiteaPlugin extends Plugin {
   static isEnabled(config) {
@@ -16,6 +21,7 @@ class GiteaPlugin extends Plugin {
     }
     const repo = this.config.getContext("repo");
     const config = {
+      assets: gitea.assets ?? [],
       draft: gitea.draft ?? false,
       host: gitea.host ?? repo.host,
       owner: gitea.owner ?? repo.owner,
@@ -162,6 +168,177 @@ class GiteaPlugin extends Plugin {
     const context = this.config.getContext();
     return template.replace(/\$\{version\}/g, context.version).replace(/\$\{latestVersion\}/g, context.latestVersion).replace(/\$\{changelog\}/g, context.changelog).replace(/\$\{name\}/g, context.name).replace(/\$\{repo\.owner\}/g, context.repo.owner).replace(/\$\{repo\.repository\}/g, context.repo.repository).replace(/\$\{branchName\}/g, context.branchName);
   }
+  /**
+   * 解析附件配置，将字符串格式转换为标准配置对象
+   * @param asset 附件配置
+   * @returns 标准化的附件配置对象
+   */
+  normalizeAssetConfig(asset) {
+    if (typeof asset === "string") {
+      return {
+        path: asset,
+        type: "file"
+      };
+    }
+    return {
+      type: "file",
+      ...asset
+    };
+  }
+  /**
+   * 根据路径模式匹配文件
+   * @param pattern 文件路径模式，支持通配符
+   * @returns 匹配到的文件路径数组
+   */
+  async resolveFiles(pattern) {
+    try {
+      const files = await glob(pattern, {
+        absolute: true,
+        nodir: true
+      });
+      return files;
+    } catch (error) {
+      this.log.warn(`\u6587\u4EF6\u5339\u914D\u5931\u8D25: ${pattern}, \u9519\u8BEF: ${error}`);
+      return [];
+    }
+  }
+  /**
+   * 创建 ZIP 压缩包
+   * @param files 要压缩的文件列表
+   * @param outputPath 输出的 ZIP 文件路径
+   * @param basePath 基础路径，用于确定文件在压缩包中的相对路径
+   * @returns Promise<void>
+   */
+  async createZipArchive(files, outputPath, basePath) {
+    return new Promise((resolve, reject) => {
+      const output = createWriteStream(outputPath);
+      const archive = archiver("zip", {
+        zlib: { level: 9 }
+      });
+      output.on("close", () => {
+        this.log.verbose(
+          `ZIP \u6587\u4EF6\u521B\u5EFA\u5B8C\u6210: ${outputPath} (${archive.pointer()} bytes)`
+        );
+        resolve();
+      });
+      archive.on("error", (err) => {
+        reject(err);
+      });
+      archive.pipe(output);
+      for (const file of files) {
+        const stats = statSync(file);
+        if (stats.isFile()) {
+          const relativePath = basePath ? file.replace(basePath, "").replace(/^\//, "") : basename(file);
+          archive.file(file, { name: relativePath });
+        }
+      }
+      archive.finalize();
+    });
+  }
+  /**
+   * 上传单个附件到 Gitea 发布
+   * @param releaseId 发布 ID
+   * @param filePath 文件路径
+   * @param fileName 上传后的文件名
+   * @param label 文件标签
+   * @returns 上传结果
+   */
+  async uploadAsset(releaseId, filePath, fileName, label) {
+    const url = this.buildApiUrl(
+      `/repos/${this.giteaConfig.owner}/${this.giteaConfig.repository}/releases/${releaseId}/assets`
+    );
+    const token = this.getToken();
+    const form = new FormData();
+    form.append("attachment", createReadStream(filePath), {
+      contentType: "application/octet-stream",
+      filename: fileName
+    });
+    if (label) {
+      form.append("name", label);
+    }
+    const requestOptions = {
+      body: form,
+      headers: {
+        ...form.getHeaders(),
+        Authorization: `token ${token}`
+      },
+      method: "POST",
+      timeout: this.giteaConfig.timeout
+    };
+    this.log.verbose(`\u4E0A\u4F20\u9644\u4EF6: ${fileName} \u5230\u53D1\u5E03 ${releaseId}`);
+    try {
+      const response = await fetch(url, requestOptions);
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`\u9644\u4EF6\u4E0A\u4F20\u5931\u8D25 (${response.status}): ${errorText}`);
+      }
+      const result = await response.json();
+      this.log.info(`\u2705 \u9644\u4EF6\u4E0A\u4F20\u6210\u529F: ${fileName}`);
+      return result;
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`\u9644\u4EF6\u4E0A\u4F20\u5931\u8D25: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+  /**
+   * 处理并上传所有配置的附件
+   * @param releaseId 发布 ID
+   */
+  async uploadAssets(releaseId) {
+    const assets = this.giteaConfig.assets;
+    if (!assets || assets.length === 0) {
+      this.log.verbose("\u6CA1\u6709\u914D\u7F6E\u9644\u4EF6\uFF0C\u8DF3\u8FC7\u4E0A\u4F20");
+      return;
+    }
+    this.log.info(`\u5F00\u59CB\u4E0A\u4F20 ${assets.length} \u4E2A\u9644\u4EF6...`);
+    for (const asset of assets) {
+      try {
+        const config = this.normalizeAssetConfig(asset);
+        await this.processAsset(releaseId, config);
+      } catch (error) {
+        this.log.error(
+          `\u9644\u4EF6\u5904\u7406\u5931\u8D25: ${JSON.stringify(asset)}, \u9519\u8BEF: ${error}`
+        );
+      }
+    }
+    this.log.info("\u2705 \u6240\u6709\u9644\u4EF6\u5904\u7406\u5B8C\u6210");
+  }
+  /**
+   * 处理单个附件配置
+   * @param releaseId 发布 ID
+   * @param config 附件配置
+   */
+  async processAsset(releaseId, config) {
+    const files = await this.resolveFiles(config.path);
+    if (files.length === 0) {
+      this.log.warn(`\u6CA1\u6709\u627E\u5230\u5339\u914D\u7684\u6587\u4EF6: ${config.path}`);
+      return;
+    }
+    if (config.type === "zip") {
+      const zipName = config.name || `${basename(config.path)}.zip`;
+      const tempZipPath = join(process.cwd(), ".temp", zipName);
+      const { mkdirSync } = await import("fs");
+      try {
+        mkdirSync(dirname(tempZipPath), { recursive: true });
+      } catch (error) {
+      }
+      await this.createZipArchive(files, tempZipPath, dirname(config.path));
+      await this.uploadAsset(releaseId, tempZipPath, zipName, config.label);
+      const { unlinkSync } = await import("fs");
+      try {
+        unlinkSync(tempZipPath);
+      } catch (error) {
+        this.log.warn(`\u6E05\u7406\u4E34\u65F6\u6587\u4EF6\u5931\u8D25: ${tempZipPath}`);
+      }
+    } else {
+      for (const file of files) {
+        const fileName = config.name || basename(file);
+        await this.uploadAsset(releaseId, file, fileName, config.label);
+      }
+    }
+  }
   /**
    * 执行发布操作，创建或更新 Gitea 发布.
    * @throws 当发布创建失败时抛出错误
@@ -197,6 +374,9 @@ class GiteaPlugin extends Plugin {
         release = await this.createRelease(releaseData);
       }
       this.log.info(`\u2705 Gitea \u53D1\u5E03\u521B\u5EFA\u6210\u529F: ${release.html_url}`);
+      if (this.giteaConfig.assets && this.giteaConfig.assets.length > 0) {
+        await this.uploadAssets(release.id);
+      }
       this.config.setContext("releaseUrl", release.html_url);
     } catch (error) {
       if (error instanceof Error) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "release-it-gitea",
-	"version": "1.3.3",
+	"version": "1.4.1",
 	"description": "release-it gitea plugin",
 	"keywords": [
 		"gitea",
@@ -44,12 +44,16 @@
 		"*": "prettier --ignore-unknown --write"
 	},
 	"dependencies": {
+		"archiver": "^7.0.1",
+		"form-data": "^4.0.3",
+		"glob": "^11.0.3",
 		"node-fetch": "^3.3.2"
 	},
 	"devDependencies": {
 		"@eslint-community/eslint-plugin-eslint-comments": "4.5.0",
 		"@eslint/js": "9.22.0",
 		"@release-it/conventional-changelog": "10.0.0",
+		"@types/archiver": "^6.0.3",
 		"@types/eslint-plugin-markdown": "2.0.2",
 		"@types/node": "22.13.10",
 		"@types/node-fetch": "^2.6.11",