xgj/release-web/action.yml

name: 'Web项目发布构建'
description: '自动化Web项目发布流程，支持版本管理和发布'
author: 'Your Organization'

branding:
  icon: 'tag'
  color: 'green'

inputs:
  release-command:
    description: '发布命令，例如 npm run release -- --release -V'
    required: false
    default: 'npm run release -- --release -V'

  node-debug:
    description: '是否启用Node.js调试模式 (true/false)'
    required: false
    default: 'false'
    
  version-file:
    description: '自定义版本文件路径，默认为 /tmp/last-version'
    required: false
    default: '/tmp/last-version'
    
  fail-on-error:
    description: '发布失败时是否让 action 失败 (true/false)'
    required: false
    default: 'true'

outputs:
  version:
    description: '发布的版本号（带 v 前缀）'
    value: ${{ steps.get_var.outputs.version }}
  
  version-with-dash:
    description: '版本号（带 v 前缀，点号替换为横线）'
    value: ${{ steps.get_var.outputs.version_with_dash }}
  
  release-status:
    description: '发布命令执行状态 (success/failure)'
    value: ${{ steps.release_build.outputs.status }}
  
  exit-code:
    description: '发布命令退出码（仅在失败时有值）'
    value: ${{ steps.release_build.outputs.exit_code }}

runs:
  using: 'composite'
  steps:
    - name: 发布构建
      id: release_build
      shell: bash
      run: |
        echo "🚀 开始发布构建..."
        echo "执行命令: ${{ inputs.release-command }}"
        
        # 设置错误处理，防止命令失败时立即退出
        set +e
        ${{ inputs.release-command }}
        RELEASE_EXIT_CODE=$?
        set -e
        
        # 根据退出码设置状态
        if [ $RELEASE_EXIT_CODE -eq 0 ]; then
          echo "status=success" >> $GITHUB_OUTPUT
          echo "✅ 发布构建完成"
        else
          echo "status=failure" >> $GITHUB_OUTPUT
          echo "❌ 发布构建失败 (退出码: $RELEASE_EXIT_CODE)"
          echo "exit_code=$RELEASE_EXIT_CODE" >> $GITHUB_OUTPUT
        fi
      env:
        NODE_DEBUG: ${{ inputs.node-debug == 'true' && 'release-it:*' || '' }}

    - name: 获取版本信息
      id: get_var
      shell: bash
      if: steps.release_build.outputs.status == 'success'
      run: |
        echo "📝 获取版本信息..."
        VERSION=""
        
        # 方法1: 从指定版本文件读取（优先级最高）
        if [[ -f "${{ inputs.version-file }}" ]]; then
          VERSION=$(cat "${{ inputs.version-file }}" | tr -d ' \n\r')
          echo "✅ 从版本文件获取: $VERSION"
        # 方法2: 从最新的 git tag 获取
        elif git describe --tags --abbrev=0 2>/dev/null; then
          VERSION=$(git describe --tags --abbrev=0 | tr -d ' \n\r')
          echo "✅ 从 git tag 获取: $VERSION"
        # 方法3: 从 package.json 获取
        elif [[ -f "package.json" ]] && command -v node >/dev/null; then
          VERSION=$(node -p "require('./package.json').version" 2>/dev/null | tr -d ' \n\r')
          if [[ -n "$VERSION" && "$VERSION" != "undefined" ]]; then
            echo "✅ 从 package.json 获取: $VERSION"
          else
            VERSION=""
          fi
        fi
        
        # 如果所有方法都失败，尝试解析发布命令输出
        if [[ -z "$VERSION" ]]; then
          echo "⚠️  无法通过常规方法获取版本，尝试解析最近的提交信息..."
          # 尝试从最近的提交消息中解析版本（如 "release: 1.2.3" 或 "release: v1.2.3" 格式）
          COMMIT_VERSION=$(git log -1 --pretty=format:"%s" | grep -oE 'v?[0-9]+\.[0-9]+\.[0-9]+' | head -1)
          if [[ -n "$COMMIT_VERSION" ]]; then
            VERSION="$COMMIT_VERSION"
            echo "✅ 从提交信息获取: $VERSION"
          fi
        fi
        
        # 最终检查和清理版本号
        if [[ -z "$VERSION" ]]; then
          echo "❌ 错误: 无法获取版本信息"
          echo "请确保："
          echo "  1. 发布命令生成版本文件（推荐格式: v1.2.3），或"
          echo "  2. 存在有效的 git tag（格式: v1.2.3），或"
          echo "  3. package.json 包含 version 字段，或"
          echo "  4. 提交信息包含版本号（格式: release: v1.2.3）"
          exit 1
        fi
        
        # 确保版本号格式正确（清理空白字符并确保 v 前缀）
        VERSION=$(echo "$VERSION" | tr -d ' \n\r')
        
        # 确保版本号有 v 前缀
        if [[ ! "$VERSION" =~ ^v ]]; then
          VERSION="v$VERSION"
        fi
        
        # 创建带横线的版本号（保持 v 前缀）
        VERSION_WITH_DASH=$(echo "$VERSION" | sed 's/\./-/g')
        
        # 验证版本号格式（应该以 v 开头）
        if [[ ! "$VERSION" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([.-].*)?$ ]]; then
          echo "⚠️  警告: 版本号格式可能不标准: $VERSION"
        fi
        
        echo "version=$VERSION" >> $GITHUB_OUTPUT
        echo "version_with_dash=$VERSION_WITH_DASH" >> $GITHUB_OUTPUT
        
        echo "📦 发布版本: $VERSION"
        echo "📦 带横线版本: $VERSION_WITH_DASH"

    - name: 发布总结
      shell: bash
      if: always()
      run: |
        echo "📋 发布流程总结"
        echo ""
        echo "📊 发布状态: ${{ steps.release_build.outputs.status }}"
        
        if [[ "${{ steps.release_build.outputs.status }}" == "success" ]]; then
          echo "🎉 发布构建成功完成！"
          echo ""
          echo "📋 发布信息:"
          echo "  - 版本号: ${{ steps.get_var.outputs.version }}"
          echo "  - 带横线版本: ${{ steps.get_var.outputs.version_with_dash }}"
        else
          echo "❌ 发布构建失败"
          echo ""
          echo "📋 错误信息:"
          echo "  - 状态: 失败"
          if [[ -n "${{ steps.release_build.outputs.exit_code }}" ]]; then
            echo "  - 退出码: ${{ steps.release_build.outputs.exit_code }}"
          fi
          echo "  - 建议: 请检查发布命令和项目配置"
        fi

    - name: 检查发布结果
      shell: bash
      if: always()
      run: |
        if [[ "${{ steps.release_build.outputs.status }}" == "failure" ]]; then
          if [[ "${{ inputs.fail-on-error }}" == "true" ]]; then
            echo "❌ 发布失败，根据 fail-on-error=true 设置，终止 action 执行"
            exit 1
          else
            echo "⚠️  发布失败，但根据 fail-on-error=false 设置，action 将继续完成"
            echo "💡 您可以通过 outputs.release-status 检查发布状态"
          fi
        else
          echo "✅ 发布成功，action 正常完成"
        fi