From e1f3dd5fdb33110874f84a9b628b974f8d147bf4 Mon Sep 17 00:00:00 2001
From: BruceChen <hi@brucec.cn>
Date: Mon, 6 Apr 2026 01:33:34 +0800
Subject: [PATCH] feat: Enhance GitHub Actions workflow with secret checks for
 deployment

- Added a job to check for the presence of required secrets (GH_PAGES_TOKEN, Crowdin secrets) before proceeding with documentation deployment and translation downloads.
- Updated the deployment job to conditionally run based on the results of the secret checks.
- Upgraded the Crowdin GitHub Action to version 2.4.0 for improved functionality.
---
 .github/workflows/deploy-doc-only.yml | 35 ++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/deploy-doc-only.yml b/.github/workflows/deploy-doc-only.yml
index 5777fce3..b68a858c 100644
--- a/.github/workflows/deploy-doc-only.yml
+++ b/.github/workflows/deploy-doc-only.yml
@@ -6,8 +6,27 @@ on:
   workflow_dispatch:
 
 jobs:
+  check-secrets:
+    runs-on: ubuntu-latest
+    outputs:
+      has-deploy-token: ${{ steps.check.outputs.has-deploy-token }}
+    steps:
+      - name: Check required secrets
+        id: check
+        run: |
+          if [ -z "$GH_PAGES_TOKEN" ]; then
+            echo "has-deploy-token=false" >> $GITHUB_OUTPUT
+            echo "::warning::GH_PAGES_TOKEN is not set, skipping documentation deployment."
+          else
+            echo "has-deploy-token=true" >> $GITHUB_OUTPUT
+          fi
+        env:
+          GH_PAGES_TOKEN: ${{ secrets.GH_PAGES_TOKEN }}
+
   Build:
     runs-on: ubuntu-latest
+    needs: check-secrets
+    if: ${{ needs.check-secrets.outputs.has-deploy-token == 'true' }}
 
     steps:
 
@@ -17,8 +36,22 @@ jobs:
         fetch-depth: 0
         submodules: 'true'
 
+    - name: Check Crowdin secrets
+      id: crowdin-check
+      run: |
+        if [ -z "$CROWDIN_PROJECT_ID" ] || [ -z "$CROWDIN_PERSONAL_TOKEN" ]; then
+          echo "available=false" >> $GITHUB_OUTPUT
+          echo "::warning::Crowdin secrets not set, skipping translation download."
+        else
+          echo "available=true" >> $GITHUB_OUTPUT
+        fi
+      env:
+        CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+        CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_TOKEN }}
+
     - name: Download translations from crowdin
-      uses: crowdin/github-action@v1.6.0
+      if: ${{ steps.crowdin-check.outputs.available == 'true' }}
+      uses: crowdin/github-action@v2.4.0
       with:
         upload_sources: false
         upload_translations: false