feat: 迁移 GitHub Pages 部署至 kimi-cli 框架

- 重构 workflow 为单 job 结构 (build + deploy 合并)
- 新增 actions/configure-pages@v5 自动配置
- 支持动态 VITEPRESS_BASE 环境变量设置
- 添加 .nojekyll 文件生成
- 优化 VitePress base 配置支持环境变量

遵循 kimi-cli 项目的 Pages 部署最佳实践

Author: LessUp

.github/workflows/deploy.yml

@@ -22,40 +22,55 @@ concurrency:
   group: pages
   cancel-in-progress: false
 
-env:
-  NODE_VERSION: 20
-
 jobs:
-  build:
+  deploy:
     runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ env.NODE_VERSION }}
+          node-version: "20"
           cache: npm
 
+      - name: Configure GitHub Pages
+        id: pages
+        uses: actions/configure-pages@v5
+
+      - name: Set VitePress base
+        shell: bash
+        env:
+          BASE_PATH: ${{ steps.pages.outputs.base_path }}
+        run: |
+          set -euo pipefail
+          if [[ -z "${BASE_PATH}" ]]; then
+            base="/"
+          else
+            base="${BASE_PATH%/}/"
+          fi
+          echo "VITEPRESS_BASE=${base}" >> "$GITHUB_ENV"
+
       - name: Install dependencies
         run: npm ci
 
       - name: Build for deployment
+        env:
+          VITEPRESS_BASE: ${{ env.VITEPRESS_BASE }}
         run: npm run build:ci
 
+      - name: Add .nojekyll
+        run: touch .vitepress/dist/.nojekyll
+
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
           path: .vitepress/dist
 
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

.vitepress/config.mjs

@@ -5,7 +5,7 @@ import { sidebarZh } from './config/sidebar.js';
 export default defineConfig({
   title: 'Awesome Cursor Rules',
   description: '为中文开发者打造的 Cursor AI 编程规则集合',
-  base: '/awesome-cursorrules-zh/',
+  base: process.env.VITEPRESS_BASE || '/awesome-cursorrules-zh/',
   lang: 'zh-CN',
 
   themeConfig: {