feat: add github variables

Author: ceynri

.github/DEPLOYMENT_SETUP.md

@@ -6,18 +6,29 @@
 
 ## 需要配置的环境变量
 
+### GitHub Secrets（必需）
+
 在 GitHub 仓库的 Settings > Secrets and variables > Actions 中配置以下密钥：
 
-### 必需的 Secrets
+| 变量名               | 说明                         | 示例                        | 必需 |
+| -------------------- | ---------------------------- | --------------------------- | ---- |
+| `TENCENT_SECRET_ID`  | 腾讯云 API 密钥 ID           | `AKIDxxxxxxxxxxxxxxxxxxxxx` | ✅   |
+| `TENCENT_SECRET_KEY` | 腾讯云 API 密钥 Key          | `xxxxxxxxxxxxxxxxxxxxxxxx`  | ✅   |
+| `TENCENT_COS_BUCKET` | COS 存储桶名称               | `my-website-1234567890`     | ✅   |
+| `TENCENT_COS_REGION` | COS 存储桶区域               | `ap-shanghai`               | ✅   |
+| `TENCENT_CDN_PREFIX` | CDN 域名前缀（可选）         | `https://cdn.example.com/`  | ❌   |
+| `GH_PAT`             | GitHub Personal Access Token | `ghp_xxxxxxxxxxxxxxxxxxxx`  | ❌   |
+
+### GitHub Variables（可选功能控制）
+
+在 GitHub 仓库的 Settings > Secrets and variables > Actions > Variables 中配置：
 
-| 变量名               | 说明                         | 示例                        |
-| -------------------- | ---------------------------- | --------------------------- |
-| `TENCENT_SECRET_ID`  | 腾讯云 API 密钥 ID           | `AKIDxxxxxxxxxxxxxxxxxxxxx` |
-| `TENCENT_SECRET_KEY` | 腾讯云 API 密钥 Key          | `xxxxxxxxxxxxxxxxxxxxxxxx`  |
-| `TENCENT_COS_BUCKET` | COS 存储桶名称               | `my-website-1234567890`     |
-| `TENCENT_COS_REGION` | COS 存储桶区域               | `ap-shanghai`               |
-| `TENCENT_CDN_PREFIX` | CDN 域名前缀（可选）         | `https://cdn.example.com/`  |
-| `GH_PAT`             | GitHub Personal Access Token | `ghp_xxxxxxxxxxxxxxxxxxxx`  |
+| 变量名                    | 说明                    | 默认值  | 可选值          |
+| ------------------------- | ----------------------- | ------- | --------------- |
+| `ENABLE_SUBMODULE_UPDATE` | 是否启用子模块自动更新  | `false` | `true`, `false` |
+| `ENABLE_TYPE_CHECK`       | 是否启用类型检查和 lint | `true`  | `true`, `false` |
+
+## 腾讯云配置
 
 ### 腾讯云密钥获取方法
 
@@ -66,15 +77,20 @@
 - **CDN 刷新**：自动刷新 CDN 缓存，确保用户看到最新内容
 - **原子性部署**：构建成功后才进行部署
 
+### 可选功能控制
+
+- **子模块更新**：通过 `ENABLE_SUBMODULE_UPDATE` 控制是否自动更新子模块
+- **类型检查**：通过 `ENABLE_TYPE_CHECK` 控制是否进行类型检查和 lint
+
 ### 触发条件
 
-- 推送到 `main` 分支时自动触发
+- 推送到 `main` 或 `deploy` 分支时自动触发
 - 支持手动触发（workflow_dispatch）
 - 支持通过 repository_dispatch 触发（用于子模块更新）
 
 ## 监控和通知
 
-部署完成后，可以在 GitHub Actions 页面查看详细的构建和部署日志。每个步骤都有清晰的名称和状态指示。
+部署完成后，可以在 GitHub Actions 页面查看详细的构建和部署日志。每个步骤都有清晰的名称和状态指示。健康检查失败时会正确设置失败状态。
 
 ## 故障排除
 
@@ -84,6 +100,7 @@
 2. **存储桶不存在**：确认存储桶名称和区域是否正确
 3. **CDN 刷新失败**：检查 CDN 域名配置是否正确
 4. **构建失败**：检查代码是否有语法错误，依赖是否正确
+5. **健康检查失败**：健康检查失败会导致工作流失败状态
 
 ### 调试方法
 

.github/workflows/deploy-tencent-cos.yml

@@ -19,6 +19,9 @@ env:
   # 使用项目要求的 Node.js 版本
   NODE_VERSION: '20'
   PNPM_VERSION: '10.7.0'
+  # 添加环境变量控制可选功能
+  ENABLE_SUBMODULE_UPDATE: ${{ vars.ENABLE_SUBMODULE_UPDATE || 'false' }}
+  ENABLE_TYPE_CHECK: ${{ vars.ENABLE_TYPE_CHECK || 'true' }}
 
 jobs:
   build-and-deploy:
@@ -34,11 +37,12 @@ jobs:
         uses: actions/checkout@v4
         with:
           token: ${{ secrets.GH_PAT }}
-          submodules: true
+          submodules: ${{ env.ENABLE_SUBMODULE_UPDATE == 'true' }}
           fetch-depth: 0
 
       # 2. 更新子模块（如果需要）
       - name: Update submodules
+        if: env.ENABLE_SUBMODULE_UPDATE == 'true'
         run: |
           git submodule update --remote
           git config --global user.name "github-actions[bot]"
@@ -94,6 +98,7 @@ jobs:
 
       # 9. 运行类型检查和代码质量检查
       - name: Type check and lint
+        if: env.ENABLE_TYPE_CHECK == 'true'
         run: |
           pnpm astro check
           pnpm lint
@@ -184,6 +189,7 @@ jobs:
             else
               echo "⚠️ 网站健康检查失败 (HTTP $HTTP_STATUS)"
               echo "这可能是 CDN 缓存还未刷新完成，请稍后再试"
+              exit 1
             fi
           else
             echo "ℹ️ 跳过健康检查：未配置 CDN 域名"