From 3b2f271c8f8a2cbde69678a2819c0696fb67a008 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 15 Sep 2025 11:11:04 +0000
Subject: [PATCH 1/3] Initial plan


From 30d8fde324bf60225781567874fce388f047053c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 15 Sep 2025 11:14:47 +0000
Subject: [PATCH 2/3] Add GitHub Actions CI/CD pipeline for automated releases

Co-authored-by: cmcxn <84500762+cmcxn@users.noreply.github.com>
---
 .github/workflows/build.yml   | 30 ++++++++++++++++
 .github/workflows/release.yml | 68 +++++++++++++++++++++++++++++++++++
 Build.ps1                     | 50 ++++++++++++++++++++++++++
 README.md                     |  6 ++--
 RELEASE.md                    | 55 ++++++++++++++++++++++++++++
 5 files changed, 207 insertions(+), 2 deletions(-)
 create mode 100644 .github/workflows/build.yml
 create mode 100644 .github/workflows/release.yml
 create mode 100644 Build.ps1
 create mode 100644 RELEASE.md

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
new file mode 100644
index 0000000..339f300
--- /dev/null
+++ b/.github/workflows/build.yml
@@ -0,0 +1,30 @@
+name: Build and Test
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build:
+    runs-on: windows-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '8.0.x'
+        
+    - name: Restore dependencies
+      run: dotnet restore AutoDeployTool.csproj
+      
+    - name: Build application
+      run: dotnet build AutoDeployTool.csproj --configuration Release --no-restore
+      
+    - name: Run tests (if any)
+      run: dotnet test AutoDeployTool.csproj --configuration Release --no-build --verbosity normal || echo "No tests found, skipping test execution"
+      continue-on-error: true
\ No newline at end of file
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..dd643fc
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,68 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag version (e.g., v1.0.0)'
+        required: true
+        type: string
+
+jobs:
+  build:
+    runs-on: windows-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '8.0.x'
+        
+    - name: Restore dependencies
+      run: dotnet restore AutoDeployTool.csproj
+      
+    - name: Build application
+      run: dotnet build AutoDeployTool.csproj --configuration Release --no-restore
+      
+    - name: Publish application
+      run: dotnet publish AutoDeployTool.csproj --configuration Release --no-build --output ./publish
+      
+    - name: Create release package
+      run: |
+        Compress-Archive -Path ./publish/* -DestinationPath AutoDeployTool-${{ github.ref_name }}.zip
+      shell: pwsh
+      
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref_name }}
+        name: AutoDeployTool ${{ github.ref_name }}
+        body: |
+          ## AutoDeployTool ${{ github.ref_name }}
+          
+          ### 下载和安装
+          1. 从下方下载 `AutoDeployTool-${{ github.ref_name }}.zip`
+          2. 解压到任意目录
+          3. 运行 `AutoDeployTool.exe`
+          
+          ### 系统要求
+          - Windows 10/Windows Server 2016 或更高版本
+          - .NET 8.0 Runtime
+          
+          ### 更新内容
+          请查看 [README.md](https://github.com/cmcxn/auto-deploy-tool/blob/main/README.md) 了解完整功能说明。
+          
+          ---
+          
+          **完整版本历史和功能说明请参考项目 README**
+        files: ./AutoDeployTool-${{ github.ref_name }}.zip
+        draft: false
+        prerelease: false
\ No newline at end of file
diff --git a/Build.ps1 b/Build.ps1
new file mode 100644
index 0000000..151e3d6
--- /dev/null
+++ b/Build.ps1
@@ -0,0 +1,50 @@
+# 本地构建和打包脚本
+# Build and Package Script for AutoDeployTool
+
+param(
+    [string]$Version = "local",
+    [switch]$Clean = $false
+)
+
+Write-Host "AutoDeployTool 本地构建脚本" -ForegroundColor Green
+Write-Host "版本: $Version" -ForegroundColor Yellow
+
+# 清理构建目录
+if ($Clean) {
+    Write-Host "清理构建目录..." -ForegroundColor Yellow
+    if (Test-Path "bin") { Remove-Item "bin" -Recurse -Force }
+    if (Test-Path "obj") { Remove-Item "obj" -Recurse -Force }
+    if (Test-Path "publish") { Remove-Item "publish" -Recurse -Force }
+}
+
+try {
+    # 恢复依赖项
+    Write-Host "恢复 NuGet 包..." -ForegroundColor Yellow
+    dotnet restore AutoDeployTool.csproj
+    if ($LASTEXITCODE -ne 0) { throw "依赖项恢复失败" }
+
+    # 构建项目
+    Write-Host "构建项目..." -ForegroundColor Yellow
+    dotnet build AutoDeployTool.csproj --configuration Release --no-restore
+    if ($LASTEXITCODE -ne 0) { throw "构建失败" }
+
+    # 发布项目
+    Write-Host "发布项目..." -ForegroundColor Yellow
+    dotnet publish AutoDeployTool.csproj --configuration Release --no-build --output ./publish
+    if ($LASTEXITCODE -ne 0) { throw "发布失败" }
+
+    # 创建发布包
+    $zipName = "AutoDeployTool-$Version.zip"
+    Write-Host "创建发布包: $zipName" -ForegroundColor Yellow
+    
+    if (Test-Path $zipName) { Remove-Item $zipName -Force }
+    Compress-Archive -Path ./publish/* -DestinationPath $zipName
+
+    Write-Host "构建完成！" -ForegroundColor Green
+    Write-Host "发布包位置: $zipName" -ForegroundColor Green
+    Write-Host "发布目录: ./publish" -ForegroundColor Green
+
+} catch {
+    Write-Host "构建失败: $_" -ForegroundColor Red
+    exit 1
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index 744b419..5c482f0 100644
--- a/README.md
+++ b/README.md
@@ -62,9 +62,11 @@
 
 ## 安装
 
-1. 从Releases页面下载最新版本
+1. 从 [Releases 页面](https://github.com/cmcxn/auto-deploy-tool/releases) 下载最新版本
 2. 解压到任意目录
-3. 运行`AutoDeployTool.exe`
+3. 运行 `AutoDeployTool.exe`
+
+> 📦 **自动化发布**: 每次创建新的 Git 标签时，都会自动构建并发布新版本到 GitHub Releases。详情请参考 [发布指南](RELEASE.md)。
 
 ## 快速开始
 
diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 0000000..db45265
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,55 @@
+# 发布指南
+
+## 自动发布流程
+
+这个项目配置了 GitHub Actions 来自动构建和发布 AutoDeployTool。
+
+### 创建新版本发布
+
+1. **创建新的版本标签**：
+   ```bash
+   git tag v2.1.0
+   git push origin v2.1.0
+   ```
+
+2. **或者通过 GitHub 网页界面**：
+   - 转到 GitHub 仓库页面
+   - 点击 "Releases" 标签
+   - 点击 "Create a new release"
+   - 输入标签版本（如 `v2.1.0`）
+   - 添加发布说明
+   - 点击 "Publish release"
+
+### 手动触发构建
+
+你也可以通过 GitHub Actions 页面手动触发构建：
+
+1. 转到 Actions 标签
+2. 选择 "Build and Release" 工作流
+3. 点击 "Run workflow"
+4. 输入要发布的标签版本
+
+### 构建产物
+
+每次发布都会自动生成：
+- `AutoDeployTool-{version}.zip` - 包含完整的可执行文件和依赖项
+- 自动创建的 GitHub Release 页面
+- 中文发布说明和下载指南
+
+### 版本命名规范
+
+建议使用语义化版本控制：
+- `v1.0.0` - 主要版本更新
+- `v1.1.0` - 功能更新
+- `v1.0.1` - 错误修复
+
+### 系统要求
+
+构建需要：
+- Windows 运行器（Windows Server 2022）
+- .NET 8.0 SDK
+- GitHub Actions 权限
+
+发布的应用程序需要：
+- Windows 10 或更高版本
+- .NET 8.0 Runtime（如果未包含在发布包中）
\ No newline at end of file

From e825bf16a091631f00033e34a5f4bde8827e222f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 15 Sep 2025 11:16:55 +0000
Subject: [PATCH 3/3] Complete CI/CD pipeline setup with comprehensive
 documentation and templates

Co-authored-by: cmcxn <84500762+cmcxn@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/release_request.md |  56 ++++++++++
 README.md                                 |  12 +-
 docs/PIPELINE_GUIDE.md                    | 129 ++++++++++++++++++++++
 3 files changed, 196 insertions(+), 1 deletion(-)
 create mode 100644 .github/ISSUE_TEMPLATE/release_request.md
 create mode 100644 docs/PIPELINE_GUIDE.md

diff --git a/.github/ISSUE_TEMPLATE/release_request.md b/.github/ISSUE_TEMPLATE/release_request.md
new file mode 100644
index 0000000..d49c898
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/release_request.md
@@ -0,0 +1,56 @@
+---
+name: 发布请求
+about: 请求创建新版本发布
+title: '🚀 Release v[版本号]'
+labels: ['release', 'enhancement']
+assignees: ''
+
+---
+
+## 发布信息
+
+**版本号**: (例如: v2.1.0)
+
+**发布类型**:
+- [ ] 主要版本 (Major) - 包含不兼容的 API 更改
+- [ ] 次要版本 (Minor) - 向下兼容的新功能
+- [ ] 修补版本 (Patch) - 向下兼容的错误修复
+
+## 更新内容
+
+### 新功能
+- [ ] 功能1
+- [ ] 功能2
+
+### 改进
+- [ ] 改进1
+- [ ] 改进2
+
+### 错误修复
+- [ ] 修复1
+- [ ] 修复2
+
+### 破坏性更改 (仅限主要版本)
+- [ ] 更改1
+- [ ] 更改2
+
+## 发布检查清单
+
+- [ ] 代码已合并到主分支
+- [ ] 所有测试通过
+- [ ] 文档已更新
+- [ ] 版本号已确定
+- [ ] 发布说明已准备
+
+## 其他说明
+
+[其他需要说明的内容]
+
+---
+
+**发布流程提醒**:
+1. 创建 Git 标签: `git tag v[版本号] && git push origin v[版本号]`
+2. 或使用 GitHub Releases 界面创建发布
+3. GitHub Actions 将自动构建并发布
+
+详细说明请参考 [流水线使用指南](https://github.com/cmcxn/auto-deploy-tool/blob/main/docs/PIPELINE_GUIDE.md)。
\ No newline at end of file
diff --git a/README.md b/README.md
index 5c482f0..d87bbcb 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@
 2. 解压到任意目录
 3. 运行 `AutoDeployTool.exe`
 
-> 📦 **自动化发布**: 每次创建新的 Git 标签时，都会自动构建并发布新版本到 GitHub Releases。详情请参考 [发布指南](RELEASE.md)。
+> 📦 **自动化发布**: 每次创建新的 Git 标签时，都会自动构建并发布新版本到 GitHub Releases。详情请参考 [发布指南](RELEASE.md) 和 [流水线使用指南](docs/PIPELINE_GUIDE.md)。
 
 ## 快速开始
 
@@ -124,6 +124,16 @@
 
 欢迎提交Issue和Pull Request来改进这个工具。
 
+## CI/CD 流水线
+
+本项目配置了完整的 GitHub Actions CI/CD 流水线：
+
+- **持续集成**: 每次 PR 和推送到主分支时自动构建验证
+- **自动发布**: 创建 Git 标签时自动构建并发布到 GitHub Releases
+- **多种触发方式**: 支持标签推送、GitHub 界面和手动触发
+
+详细使用说明请参考 [流水线使用指南](docs/PIPELINE_GUIDE.md)。
+
 ## 许可证
 
 此项目使用MIT许可证。
diff --git a/docs/PIPELINE_GUIDE.md b/docs/PIPELINE_GUIDE.md
new file mode 100644
index 0000000..ba692f7
--- /dev/null
+++ b/docs/PIPELINE_GUIDE.md
@@ -0,0 +1,129 @@
+# 使用发布流水线指南
+
+## 概述
+
+本项目现已配置了自动化的 GitHub Actions CI/CD 流水线，可以自动构建和发布 AutoDeployTool 到 GitHub Releases。
+
+## 自动发布流程
+
+### 1. 通过 Git 标签触发发布
+
+```bash
+# 创建新版本标签
+git tag v2.1.0
+
+# 推送标签到远程仓库
+git push origin v2.1.0
+```
+
+### 2. 通过 GitHub 界面创建发布
+
+1. 访问仓库的 GitHub 页面
+2. 点击 "Releases" 选项卡
+3. 点击 "Create a new release"
+4. 输入标签版本（例如：`v2.1.0`）
+5. 填写发布标题和说明
+6. 点击 "Publish release"
+
+### 3. 手动触发工作流
+
+1. 转到 GitHub 仓库的 "Actions" 选项卡
+2. 选择 "Build and Release" 工作流
+3. 点击 "Run workflow" 按钮
+4. 输入要创建的标签版本
+5. 点击 "Run workflow"
+
+## 发布内容
+
+每次发布将自动生成：
+
+- **构建产物**: `AutoDeployTool-{version}.zip`
+  - 包含编译后的可执行文件
+  - 包含所有必要的依赖项
+  - 可直接在 Windows 系统上运行
+
+- **GitHub Release**:
+  - 自动生成的发布页面
+  - 中文发布说明
+  - 下载链接和安装指南
+
+## 持续集成
+
+除了发布流水线，还配置了持续集成工作流：
+
+- **触发条件**: 
+  - 推送到 `main` 或 `master` 分支
+  - 针对 `main` 或 `master` 分支的 Pull Request
+
+- **执行内容**:
+  - 构建验证
+  - 依赖项检查
+  - 基本测试运行
+
+## 技术细节
+
+### 构建环境
+- **运行器**: Windows Server 2022 (windows-latest)
+- **SDK**: .NET 8.0
+- **构建配置**: Release
+
+### 发布包结构
+```
+AutoDeployTool-v2.1.0.zip
+├── AutoDeployTool.exe          # 主程序
+├── AutoDeployTool.dll          # 应用程序库
+├── *.dll                       # 依赖库文件
+├── AutoDeployTool.runtimeconfig.json
+└── AutoDeployTool.deps.json
+```
+
+### 版本命名规范
+
+建议使用 [语义化版本控制](https://semver.org/lang/zh-CN/)：
+
+- `v1.0.0` - 主版本号：不兼容的 API 修改
+- `v1.1.0` - 次版本号：向下兼容的功能性新增
+- `v1.0.1` - 修订号：向下兼容的问题修正
+
+## 故障排除
+
+### 常见问题
+
+1. **构建失败**
+   - 检查 .NET 项目文件是否有效
+   - 验证依赖项是否可用
+   - 查看 Actions 日志获取详细错误信息
+
+2. **发布失败**
+   - 确认 GitHub Token 权限正确
+   - 检查标签名称格式（建议以 `v` 开头）
+   - 验证仓库设置允许创建发布
+
+3. **下载问题**
+   - 确认发布不是草稿状态
+   - 检查文件是否成功上传到 Release
+
+### 查看日志
+
+1. 转到 GitHub 仓库的 "Actions" 选项卡
+2. 找到相应的工作流运行
+3. 点击查看详细的构建和发布日志
+
+## 本地构建
+
+也可以使用提供的 PowerShell 脚本进行本地构建：
+
+```powershell
+# 基本构建
+.\Build.ps1
+
+# 指定版本号
+.\Build.ps1 -Version "v2.1.0"
+
+# 清理后构建
+.\Build.ps1 -Version "v2.1.0" -Clean
+```
+
+---
+
+有关更多技术细节，请参考项目的 [README.md](README.md) 和 [RELEASE.md](RELEASE.md) 文件。
\ No newline at end of file