修复GitHub Pages部署配置，降级Actions版本以兼容

Author: cgbin24

.github/workflows/build-and-release.yml

@@ -13,14 +13,8 @@ on:
 # 添加权限配置
 permissions:
   contents: write
-  packages: write
-  pages: write      # 添加Pages权限
-  id-token: write   # 用于Pages部署验证
-
-# 环境变量设置
-env:
-  # 指定GitHub Pages的部署环境
-  GITHUB_PAGES_ENV: github-pages
+  pages: write
+  id-token: write
 
 jobs:
   build:
@@ -85,7 +79,6 @@ jobs:
         uses: actions/checkout@v3
         with:
           fetch-depth: 0  # 获取完整的历史记录以支持提交
-          token: ${{ secrets.GITHUB_TOKEN }} # 确保有推送权限
 
       - name: 下载构建产物
         uses: actions/download-artifact@v4
@@ -109,25 +102,24 @@ jobs:
           
           # 复制版本信息
           cp temp-artifacts/release/version-info.json docs/website/version.json
-          
-          # 提交更改到仓库
-          git config --global user.name "GitHub Actions Bot"
-          git config --global user.email "actions@github.com"
-          git add docs/website/
-          git commit -m "更新GitHub Pages演示站点内容" || echo "没有需要提交的更改"
-          git push origin ${GITHUB_REF_NAME} || echo "推送失败，可能是权限问题"
       
+      # 配置GitHub Pages
       - name: 设置Pages
-        uses: actions/configure-pages@v4
+        id: pages
+        uses: actions/configure-pages@v3
 
+      # 打包页面内容
       - name: 打包页面内容
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v2
         with:
-          path: 'docs/website'
+          path: docs/website
 
+      # 部署到GitHub Pages
       - name: 部署到GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v3
+        uses: actions/deploy-pages@v2
+        with:
+          token: ${{ github.token }}
 
   # 只在标签推送时进行发布
   release:

docs/github-pages.md

@@ -24,26 +24,37 @@ docs/
 └── github-pages.md      # 本文档（部署说明）
 ```
 
+## 重要配置（必读）
+
+为了正确部署GitHub Pages，您必须在仓库设置中启用GitHub Pages功能：
+
+1. 访问 https://github.com/cgbin24/pro_color/settings/pages
+2. 在 **Source** 部分，选择 **GitHub Actions**
+3. 点击 **Save** 按钮保存设置
+
+![GitHub Pages设置示意图](https://docs.github.com/assets/cb-32892/mw-1440/images/help/pages/pages-source-dropdown.webp)
+
+如果不完成此设置，GitHub Actions 将无法部署页面，会出现404错误。
+
 ## 自动部署流程
 
 每当代码推送到 `main` 或 `master` 分支时，GitHub Actions 工作流程会自动执行以下步骤：
 
 1. 构建浏览器扩展
 2. 更新 `docs/website` 目录中的演示站点内容
-3. 将更改提交到仓库
-4. 部署到 GitHub Pages
+3. 部署到 GitHub Pages
 
-## 访问演示网站
+## 访问演示站点
 
-演示网站可通过以下地址访问：
+演示站点可通过以下地址访问：
 
 ```
 https://cgbin24.github.io/pro_color/
 ```
 
 ## 网站内容
 
-演示网站包含以下内容：
+演示站点包含以下内容：
 
 - 扩展功能简介
 - 使用说明
@@ -99,16 +110,18 @@ npx http-server
 如需修改演示网站的内容或样式：
 
 1. 直接编辑 `docs/website/` 目录中的文件
-2. 或修改 `.github/workflows/build-and-release.yml` 文件中的 `更新docs目录中的演示站点内容` 步骤
+2. 或修改 `.github/workflows/build-and-release.yml` 文件中的 `更新演示站点内容` 步骤
 
-## 重要配置
+## 常见问题排查
 
-为了正确部署GitHub Pages，您需要在仓库设置中进行以下配置：
+如果GitHub Pages部署失败，请检查以下几点：
 
-1. 在GitHub仓库页面，点击 `Settings` 标签
-2. 在左侧导航栏中，点击 `Pages`
-3. 在 `Build and deployment` 部分，配置如下：
-   - Source: 选择 `GitHub Actions`
-   - 不要选择任何分支，因为我们使用Actions来部署
+1. **确保已启用GitHub Pages**：在仓库设置中，必须将GitHub Pages的源设置为"GitHub Actions"
+2. **检查工作流权限**：确保工作流有正确的权限（contents、pages、id-token）
+3. **查看错误日志**：在Actions运行日志中查找具体的错误信息
+4. **验证文件结构**：确保docs/website目录存在且包含index.html文件
+5. **检查分支设置**：确保在正确的分支上操作（一般是main或master）
 
-如果您的GitHub Pages部署失败，请检查以上配置是否正确。 
+常见错误：
+- `Failed to create deployment (status: 404)`：表示GitHub Pages尚未启用或配置错误
+- `Getting signed artifact URL failed`：通常与权限或工作流配置有关