AI 优化打出的包

walterlv · walterlv · commit b388260238e0 · 2025-07-10T11:36:49.000+08:00
diff --git a/.github/knowledge/AI协作经验/角色经验总结/DevOps自动化专家-核心经验总结.md b/.github/knowledge/AI协作经验/角色经验总结/DevOps自动化专家-核心经验总结.md
@@ -23,6 +23,11 @@
 - ✅ 支持预发布版本识别 (alpha/beta/rc)
 - ✅ 自动创建 GitHub Releases 并上传构建产物
 - ✅ **优化发布页面**: 统一英文描述，提升国际化标准
+- ✅ **修复发布产物命名问题**: 
+  - 产物文件夹内保持原始 exe 文件名 (DotNetCampus.Terminal.exe)
+  - 仅 zip 包使用规范化命名 (DotNetCampus.Terminal.win-x64.1.0.0.zip)
+  - 过滤 .pdb/.dbg/.dsym 调试文件以减小包体积
+  - zip 包命名规范：使用 `.` 分割，版本号不带 `v` 前缀
 
 ### 4. 代码质量检查和自动化测试集成
 - ✅ 创建了代码质量检查流水线 (`.github/workflows/code-quality.yml`)
@@ -195,6 +200,39 @@ cd temp-release && zip -r ../${{ matrix.artifact-name }}.zip * && cd ..
 
 **经验教训**: 开源项目的发布页面应该保持国际化标准，使用英文可以让更多开发者理解和使用
 
+### 8. 发布产物命名规范优化 ⭐⭐
+**问题**: 初期的命名规范存在以下问题：
+1. **exe 文件重命名**: 擅自修改产物文件夹内的 exe 文件名，造成混乱
+2. **调试文件冗余**: .pdb/.dbg/.dsym 文件大幅增加包体积
+3. **命名格式不统一**: 使用连字符分割，版本号带 `v` 前缀
+
+**最终解决方案**:
+```yaml
+# 1. 保持产物文件夹内原始文件名
+# 删除所有重命名 exe 文件的步骤
+
+# 2. 过滤调试文件
+# Windows: 排除 .pdb, .dbg 文件
+Get-ChildItem -Path ".\publish\${{ matrix.runtime }}" -Recurse | 
+  Where-Object { $_.Extension -notin @('.pdb', '.dbg') }
+
+# Unix: 排除 .pdb, .dbg, .dsym 文件
+find ./publish/${{ matrix.runtime }} -type f ! -name "*.pdb" ! -name "*.dbg" ! -path "*.dsym*"
+
+# 3. 统一命名规范：使用 . 分割，版本号不带 v
+$zipName = "DotNetCampus.Terminal.${{ matrix.runtime }}.${{ steps.get_version.outputs.version }}.zip"
+```
+
+**最终命名格式**:
+- `DotNetCampus.Terminal.win-x64.1.0.0.zip`
+- `DotNetCampus.Terminal.linux-x64.1.0.0.zip`  
+- `DotNetCampus.Terminal.osx-x64.1.0.0.zip`
+
+**经验教训**: 
+- **产物内容不变原则**: 发布产物文件夹内的文件应保持原始名称，只有打包文件名需要规范化
+- **体积优化**: 生产环境不需要调试符号文件，过滤可显著减小包体积
+- **命名一致性**: 统一的命名规范有助于用户识别和自动化脚本处理
+
 ## 📋 待实现功能
 
 ### 高级特性 (未来考虑)
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -14,17 +14,14 @@ jobs:
           - os: windows-latest
             runtime: win-x64
             artifact-name: DotNetCampus.Terminal-win-x64
-            executable-name: DotNetCampus.Terminal-win-x64.exe
             path-separator: '\'
           - os: ubuntu-latest
             runtime: linux-x64
             artifact-name: DotNetCampus.Terminal-linux-x64
-            executable-name: DotNetCampus.Terminal-linux-x64
             path-separator: '/'
           - os: macos-latest
             runtime: osx-x64
             artifact-name: DotNetCampus.Terminal-osx-x64
-            executable-name: DotNetCampus.Terminal-osx-x64
             path-separator: '/'
     
     steps:
@@ -42,6 +39,16 @@ jobs:
     - name: Set tag to version
       run: dotnet TagToVersion -t ${{ github.ref }}
       
+    - name: Extract version from tag
+      id: get_version
+      run: |
+        # Extract version from tag (remove 'v' prefix if present)
+        VERSION="${{ github.ref_name }}"
+        VERSION=${VERSION#v}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "Extracted version: $VERSION"
+      shell: bash
+      
     - name: Restore dependencies
       run: dotnet restore
       
@@ -53,45 +60,40 @@ jobs:
       if: matrix.os != 'windows-latest'
       run: dotnet publish ./src/DotNetCampus.Terminal/ -p:PublishAot=true -r ${{ matrix.runtime }} --configuration Release --output ./publish/${{ matrix.runtime }}
       
-    - name: Rename executable (Windows)
+    - name: Clean debug files and create release package (Windows)
       if: matrix.os == 'windows-latest'
       run: |
-        if (Test-Path ".\publish\${{ matrix.runtime }}\DotNetCampus.Terminal.exe") {
-          Rename-Item ".\publish\${{ matrix.runtime }}\DotNetCampus.Terminal.exe" "${{ matrix.executable-name }}"
-        }
-      shell: pwsh
-      
-    - name: Rename executable (Unix)
-      if: matrix.os != 'windows-latest'
-      run: |
-        if [ -f "./publish/${{ matrix.runtime }}/DotNetCampus.Terminal" ]; then
-          mv "./publish/${{ matrix.runtime }}/DotNetCampus.Terminal" "./publish/${{ matrix.runtime }}/${{ matrix.executable-name }}"
-        fi
-      
-    - name: Create release package (Windows)
-      if: matrix.os == 'windows-latest'
-      run: |
-        # 创建临时文件夹，复制所有发布文件
+        # 创建临时文件夹
         New-Item -ItemType Directory -Path ".\temp-release" -Force
-        Copy-Item -Path ".\publish\${{ matrix.runtime }}\*" -Destination ".\temp-release\" -Recurse
-        # 创建 zip 包，不包含外层文件夹
-        Compress-Archive -Path ".\temp-release\*" -DestinationPath ".\${{ matrix.artifact-name }}.zip"
+        # 复制所有发布文件，排除调试文件
+        Get-ChildItem -Path ".\publish\${{ matrix.runtime }}" -Recurse | 
+          Where-Object { $_.Extension -notin @('.pdb', '.dbg') } |
+          Copy-Item -Destination { Join-Path ".\temp-release" $_.FullName.Substring("$((Get-Location).Path)\publish\${{ matrix.runtime }}".Length) } -Force
+        # 创建带版本号的 zip 包 (使用 . 分割)
+        $zipName = "DotNetCampus.Terminal.${{ matrix.runtime }}.${{ steps.get_version.outputs.version }}.zip"
+        Compress-Archive -Path ".\temp-release\*" -DestinationPath ".\$zipName"
+        echo "zip_name=$zipName" >> $env:GITHUB_OUTPUT
       shell: pwsh
+      id: package_windows
       
-    - name: Create release package (Unix)
+    - name: Clean debug files and create release package (Unix)
       if: matrix.os != 'windows-latest'
       run: |
-        # 创建临时文件夹，复制所有发布文件
+        # 创建临时文件夹
         mkdir -p ./temp-release
-        cp -r ./publish/${{ matrix.runtime }}/* ./temp-release/
-        # 创建 zip 包，不包含外层文件夹
-        cd temp-release && zip -r ../${{ matrix.artifact-name }}.zip * && cd ..
+        # 复制所有发布文件，排除调试文件（macOS 的 .dsym 文件夹也排除）
+        find ./publish/${{ matrix.runtime }} -type f ! -name "*.pdb" ! -name "*.dbg" ! -path "*.dsym*" -exec cp {} ./temp-release/ \;
+        # 创建带版本号的 zip 包 (使用 . 分割)
+        zip_name="DotNetCampus.Terminal.${{ matrix.runtime }}.${{ steps.get_version.outputs.version }}.zip"
+        cd temp-release && zip -r ../$zip_name * && cd ..
+        echo "zip_name=$zip_name" >> $GITHUB_OUTPUT
+      id: package_unix
       
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:
         name: ${{ matrix.artifact-name }}
-        path: ${{ matrix.artifact-name }}.zip
+        path: ${{ steps.package_windows.outputs.zip_name || steps.package_unix.outputs.zip_name }}
         if-no-files-found: error
         retention-days: 7
         
@@ -110,6 +112,16 @@ jobs:
         ls -la ./artifacts/
         find ./artifacts -type f -name "*.zip" | head -10
         
+    - name: Extract version from tag
+      id: get_version
+      run: |
+        # Extract version from tag (remove 'v' prefix if present)
+        VERSION="${{ github.ref_name }}"
+        VERSION=${VERSION#v}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "Extracted version: $VERSION"
+      shell: bash
+        
     - name: Create GitHub Release
       uses: softprops/action-gh-release@v1
       with:
@@ -123,35 +135,35 @@ jobs:
           
           | Platform | File | Description |
           |----------|------|-------------|
-          | Windows (x64) | `DotNetCampus.Terminal-win-x64.zip` | Windows 64-bit version |
-          | Linux (x64) | `DotNetCampus.Terminal-linux-x64.zip` | Linux 64-bit version |
-          | macOS (x64) | `DotNetCampus.Terminal-osx-x64.zip` | macOS 64-bit version |
+          | Windows (x64) | `DotNetCampus.Terminal.win-x64.${{ steps.get_version.outputs.version }}.zip` | Windows 64-bit version |
+          | Linux (x64) | `DotNetCampus.Terminal.linux-x64.${{ steps.get_version.outputs.version }}.zip` | Linux 64-bit version |
+          | macOS (x64) | `DotNetCampus.Terminal.osx-x64.${{ steps.get_version.outputs.version }}.zip` | macOS 64-bit version |
           
           ### 🔧 Installation
           
           **Windows:**
           ```bash
           # Extract the zip file
-          # Double-click to run DotNetCampus.Terminal-win-x64.exe
+          # Double-click to run DotNetCampus.Terminal.exe
           ```
           
           **Linux/macOS:**
           ```bash
           # Extract the zip file
           unzip DotNetCampus.Terminal-*.zip
           # Make executable and run
-          chmod +x DotNetCampus.Terminal-*
-          ./DotNetCampus.Terminal-*
+          chmod +x DotNetCampus.Terminal
+          ./DotNetCampus.Terminal
           ```
           
           ### 📝 What's Changed
           
           See [CHANGELOG.md](https://github.com/dotnet-campus/DotNetCampus.Terminal/blob/main/CHANGELOG.md) for detailed changes.
           
         files: |
-          ./artifacts/DotNetCampus.Terminal-win-x64/DotNetCampus.Terminal-win-x64.zip
-          ./artifacts/DotNetCampus.Terminal-linux-x64/DotNetCampus.Terminal-linux-x64.zip
-          ./artifacts/DotNetCampus.Terminal-osx-x64/DotNetCampus.Terminal-osx-x64.zip
+          ./artifacts/DotNetCampus.Terminal-win-x64/DotNetCampus.Terminal.win-x64.${{ steps.get_version.outputs.version }}.zip
+          ./artifacts/DotNetCampus.Terminal-linux-x64/DotNetCampus.Terminal.linux-x64.${{ steps.get_version.outputs.version }}.zip
+          ./artifacts/DotNetCampus.Terminal-osx-x64/DotNetCampus.Terminal.osx-x64.${{ steps.get_version.outputs.version }}.zip
         draft: false
         prerelease: ${{ contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') || contains(github.ref_name, 'rc') }}
       env:
