From c6937429b8ad6a3462abb6dd51a5d4d1151de8ca Mon Sep 17 00:00:00 2001
From: rbetree <rzlrong@outlook.com>
Date: Sat, 17 Jan 2026 21:10:02 +0800
Subject: [PATCH] =?UTF-8?q?feat(ci):=20=E6=94=AF=E6=8C=81=E7=A6=81?=
 =?UTF-8?q?=E7=94=A8=20GitHub=20Pages=20=E9=83=A8=E7=BD=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

为 GitHub Pages 部署步骤添加条件判断，通过 ENABLE_GITHUB_PAGES 变量控制
---
 .github/workflows/deploy.yml | 10 +++++++++-
 README.md                    | 13 +++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index f1fd3e0..eb03776 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -128,17 +128,25 @@ jobs:
           else
             echo "Warning: favicon.ico not found in dist directory"
             # 暂时改为警告，避免因为图标问题阻止部署
-            # exit 1 
+            # exit 1
           fi
 
+      # GitHub Pages 部署步骤（仅在启用时执行）
+      # 说明：
+      # - 如果你使用 Vercel/Cloudflare Pages 等第三方平台部署，可以跳过这些步骤
+      # - 设置 repository variable ENABLE_GITHUB_PAGES=false 来禁用 GitHub Pages 部署
+      # - 默认启用 GitHub Pages 部署以保持向后兼容
       - name: Setup Pages
+        if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
         uses: actions/configure-pages@v4
 
       - name: Upload artifact
+        if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
         uses: actions/upload-pages-artifact@v3
         with:
           path: 'dist'
 
       - name: Deploy to GitHub Pages
+        if: ${{ vars.ENABLE_GITHUB_PAGES != 'false' }}
         id: deployment
         uses: actions/deploy-pages@v4
diff --git a/README.md b/README.md
index 848eb8c..458f6d9 100644
--- a/README.md
+++ b/README.md
@@ -507,6 +507,19 @@ server {
 - 设置构建命令为`npm run build`
 - 设置输出目录为`dist`
 
+**如果您只使用第三方平台部署（不使用 GitHub Pages）**：
+
+为避免 GitHub Actions 中的 Pages 配置错误，您可以禁用 GitHub Pages 部署步骤：
+
+1. 进入仓库的 Settings -> Secrets and variables -> Actions
+2. 点击 "Variables" 标签页
+3. 点击 "New repository variable"
+4. 名称填写：`ENABLE_GITHUB_PAGES`
+5. 值填写：`false`
+6. 点击 "Add variable"
+
+设置后，GitHub Actions 仍会自动构建网站（包括书签处理、RSS 同步等），但会跳过 GitHub Pages 部署步骤，避免报错。第三方平台（如 Vercel/Cloudflare Pages）会自动检测到代码变化并部署。
+
 > 如果你希望在构建时刷新“时效性数据”（RSS 文章聚合、projects 仓库统计），请将构建命令改为：
 >
 > ```bash