name: 🚀 自动部署 Hexo 博客

on:
  # 🌿 推送到 main 分支时自动触发
  push:
    branches:
      - main

  # 🎉 发布新版本时触发（可用于强制重建）
  release:
    types:
      - published

  # ⏯️ 支持在 GitHub Actions 页面手动点击运行
  workflow_dispatch:

# 🕎 设置系统时区为中国标准时间（UTC+8）
env:
  TZ: Asia/Shanghai

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      # 🔍 检出源码（使用最新 v4，支持更好的性能和安全）
      - name: 🔎 检出源码
        uses: actions/checkout@v4
        with:
          ref: main  # ✅ 明确指定分支，避免意外

      # 🧠 缓存 node_modules 以大幅提升安装速度
      - name: 🧠 缓存项目依赖
        id: cache-node-modules
        uses: actions/cache@v4
        with:
          path: node_modules
          # 🔑 基于 lock 文件生成缓存键，确保一致性
          key: ${{ runner.os }}-nodeModules-${{ hashFiles('package-lock.json') }}
          # 🔁 缓存未命中时尝试恢复旧缓存（提高命中率）
          restore-keys: |
            ${{ runner.os }}-nodeModules-

      # 🛠️ 安装指定版本的 Node.js 环境
      - name: 🛠️ 安装 Node.js 环境
        uses: actions/setup-node@v4
        with:
          node-version: "22.x"           # ✅ 匹配你本地的 v22.17.1
          cache: "npm"                   # 💡 自动缓存 npm 全局包（如 hexo-cli），加速后续步骤

      # 📦 全局安装 Hexo CLI（锁定版本，避免意外升级）
      - name: 📦 安装 Hexo CLI
        run: |
          npm install -g hexo-cli@4.3.2  # ✅ 推荐生产环境锁定版本（你当前也是 4.3.2）

      # ⚙️ 安装项目依赖（仅当缓存未命中时执行）
      - name: ⚙️ 安装项目依赖
        if: steps.cache-node-modules.outputs.cache-hit != 'true'
        run: |
          npm ci  # ✅ CI/CD 最佳实践：快速、一致、可重现

      # 🧹 清理上一次构建的残留文件
      - name: 🧹 清理旧构建文件
        run: |
          npm run clean  # 👉 确保 package.json 中有 "clean": "hexo clean"

      # 🏗️ 生成静态站点（含压缩）
      - name: 🏗️ 构建静态站点
        run: |
          npm run build  # 👉 确保 package.json 中有 "build": "hexo generate"

      # 🚀 部署到 GitHub Pages（推送到 page 分支）
      - name: 🚀 部署到 GitHub Pages
        run: |
          # 检查 public 目录是否存在
          cd public || { echo "❌ public 目录不存在，请检查构建是否成功"; exit 1; }

          # 初始化 Git 仓库
          git init
          git config user.name "${{ github.actor }}"
          git config user.email "${{ github.actor }}@users.noreply.github.com"

          # 🔍 检查是否有变更，避免空提交
          if git diff --cached --quiet; then
            echo "➡️ 无文件变更，跳过部署"
            exit 0
          fi

          # 📝 生成提交信息（原始 commit + 时间戳）
          local_time=$(date +"%Z %Y-%m-%d %A %H:%M:%S")
          commit_msg="${{ github.event.head_commit.message }} ·· [$local_time]"
          git add .
          git commit -m "$commit_msg"

          # 🌐 推送到远程仓库的 page 分支
          git remote add origin "https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git"
          git push --force --quiet origin HEAD:page  # ✅ 使用 HEAD 而非 master/main

        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}