refactor: 优化部署文档工作流 (#410)

.github/workflows/deploy-docs.yml

@@ -1,34 +1,42 @@
-name: 部署文档
+name: 部署到 Cloudflare Pages
 
 on:
   push:
     branches:
-      - 'main'
+      - 'main' # 当推送到 main 分支时触发
 
 jobs:
-  build:
+  deploy:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v4
+      # 第一步：检出代码
-        with:
+      - name: 检出代码
-          fetch-depth: 0
+        uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v3
+
+      # 第二步：安装 pnpm
+      - name: 安装 pnpm
+        uses: pnpm/action-setup@v3
         with:
           version: latest
-      - uses: actions/setup-node@v4
+
-        with:
+      # 第三步：安装依赖
-          cache: pnpm
+      - name: 安装依赖
-      - name: Install
         run: pnpm install
-      - name: Build
+        
-        run: pnpm build
+      # 第四步：构建项目
-        env:
+      - name: 构建项目
-          NODE_OPTIONS: --max_old_space_size=4096
+        run: pnpm build # 构建 VitePress 项目
-      - name: Publish to Cloudflare Pages
+
+      # 第五步：安装 Wrangler
+      - name: 安装 Wrangler
+        run: pnpm add -g wrangler@3 # 安装 Wrangler v3
+
+      # 第六步：发布到 Cloudflare Pages
+      - name: 发布到 Cloudflare Pages
         uses: cloudflare/pages-action@v1
         with:
-          apiToken: ${{ secrets.CLOUDFLARE_PAGES_TOKEN }}
+          apiToken: ${{ secrets.CLOUDFLARE_PAGES_TOKEN }} # Cloudflare Pages API Token
-          accountId: ${{ secrets.CLOUDFLARE_PAGES_ACCOUNT }}
+          accountId: ${{ secrets.CLOUDFLARE_PAGES_ACCOUNT }} # Cloudflare 账户 ID
-          projectName: rle-wiki
+          projectName: rle-wiki # Cloudflare Pages 项目名称
-          directory: docs/.vitepress/dist
+          directory: docs/.vitepress/dist # 构建输出目录
-          wranglerVersion: '3'

package.json

@@ -33,8 +33,7 @@
     "vite": "^5.3.1",
     "vitepress": "^1.2.3",
     "vitepress-sidebar": "^1.23.2",
-    "vue": "^3.4.30",
+    "vue": "^3.4.30"
-    "wrangler": "^3.61.0"
   },
   "pnpm": {
     "overrides": {

pnpm-lock.yaml

@@ -71,9 +71,6 @@ importers:
       vue:
         specifier: ^3.4.30
         version: 3.4.30(typescript@5.5.2)
-      wrangler:
-        specifier: ^3.61.0
-        version: 3.61.0(@cloudflare/workers-types@4.20240620.0)
 
   functions:
     dependencies: