ci: 收敛主线CI至CPU安全的格式与文档检查

移除无法在GitHub Hosted Runner上有效执行的CUDA构建矩阵和pre-commit检查，将CI聚焦于稳定且有价值的质量门。
具体包括：
- 移除build-cuda和pre-commit作业
- 更新format-check作业以检查C/C++/CUDA格式
- 更新docs作业的依赖项
- 使ci-success作业同时依赖format-check和docs的结果
- 简化触发分支和工作流命名

调整依据在于，原GPU作业在托管Runner上无实际验收意义，而代码格式与文档构建是当前最稳定、最核心的主线质量保障。

Author: shijiashuai

.github/workflows/ci.yml

@@ -1,29 +1,28 @@
-# HPC-AI-Optimization-Lab CI Pipeline
 name: CI
 
 on:
   push:
-    branches: [main, develop]
+    branches: [main, master]
   pull_request:
-    branches: [main]
+    branches: [main, master]
+  workflow_dispatch:
 
 permissions:
   contents: read
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
+  group: ci-${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
-  # Code formatting check
   format-check:
     name: Format Check
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - name: Check C++ formatting
-        uses: jidicula/clang-format-action@v4.11.0
+      - name: Check C/C++/CUDA formatting
+        uses: jidicula/clang-format-action@v4.13.0
         with:
           clang-format-version: '17'
           check-path: 'src'
@@ -41,52 +40,6 @@ jobs:
           ruff check python/
           ruff format --check python/
 
-  # Build and test with CUDA
-  build-cuda:
-    name: Build & Test (CUDA ${{ matrix.cuda }})
-    if: false  # Disabled: requires GPU runner not available on GitHub-hosted runners
-    runs-on: ubuntu-latest
-    container:
-      image: nvidia/cuda:${{ matrix.cuda }}-devel-ubuntu22.04
-    strategy:
-      fail-fast: false
-      matrix:
-        cuda: ['12.2.0', '12.4.1']
-        include:
-          - cuda: '12.4.1'
-            primary: true
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install dependencies
-        run: |
-          apt-get update
-          apt-get install -y \
-            cmake \
-            ninja-build \
-            git \
-            python3-dev \
-            python3-pip \
-            wget
-          pip3 install pytest numpy
-
-      - name: Configure CMake
-        run: |
-          cmake -B build \
-            -G Ninja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DCMAKE_CUDA_ARCHITECTURES=80
-
-      - name: Build
-        run: cmake --build build --parallel
-
-      - name: Run tests
-        run: |
-          cd build
-          ctest --output-on-failure --timeout 300
-
-  # Build documentation
   docs:
     name: Build Documentation
     runs-on: ubuntu-latest
@@ -104,9 +57,9 @@ jobs:
           python-version: '3.11'
           cache: pip
 
-      - name: Install Sphinx
+      - name: Install doc dependencies
         run: |
-          pip install sphinx sphinx-rtd-theme breathe
+          pip install sphinx sphinx-rtd-theme breathe myst-parser sphinx-copybutton
 
       - name: Build Doxygen docs
         run: |
@@ -124,36 +77,16 @@ jobs:
             echo "Sphinx config not found, skipping"
           fi
 
-  # Pre-commit hooks
-  pre-commit:
-    name: Pre-commit Checks
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-          cache: pip
-
-      - name: Run pre-commit
-        uses: pre-commit/action@v3.0.0
-        with:
-          extra_args: --all-files --show-diff-on-failure
-        continue-on-error: true
-
-  # Summary job
   ci-success:
     name: CI Success
-    needs: [format-check]
     runs-on: ubuntu-latest
+    needs: [format-check, docs]
     if: always()
     steps:
       - name: Check all jobs
         run: |
-          if [[ "${{ needs.format-check.result }}" == "failure" ]]; then
-            echo "One or more jobs failed"
+          if [[ "${{ needs.format-check.result }}" != "success" || "${{ needs.docs.result }}" != "success" ]]; then
+            echo "One or more required jobs failed"
             exit 1
           fi
           echo "All required jobs passed!"

changelog/2026-03-13_workflow-cpu-safe-ci.md

@@ -0,0 +1,13 @@
+# Workflow CPU-safe CI 调整
+
+日期：2026-03-13
+
+## 变更内容
+
+- 移除主线 CI 中无效的 CUDA 构建矩阵与 `continue-on-error` 掩盖逻辑，保留 `Format Check`、`Build Documentation`、`CI Success`
+- 让 `CI Success` 同时依赖格式与文档构建结果，避免只看单个 job 造成误判
+- 保留 C++/Python 格式检查与 Sphinx/Doxygen 文档构建，维持 Hosted Runner 上可执行的验收范围
+
+## 背景
+
+该仓库原先的 GPU job 在 GitHub Hosted Runner 上没有真实验收意义，而文档与格式检查才是当前最稳定、最有价值的主线质量门。本次调整将 CI 收敛到这些 CPU-safe 检查。