ci: fix deploy workflow and add Docker support

- replace pnpm with bun (oven-sh/setup-bun@v2) in build-pages and docker jobs
- fix cache/artifact paths from .vitepress/* to docs/.vitepress/*
- update cache keys from pnpm-lock.yaml to bun.lock
- fix build commands from pnpm build to bun run docs:build
- add Dockerfile (multi-stage: bun builder + nginx:alpine runner)
- add .dockerignore to exclude src, test, node_modules from image

Author: fishxcode

.dockerignore

@@ -0,0 +1,27 @@
+# 依赖与构建产物
+node_modules
+dist
+docs/.vitepress/dist
+docs/.vitepress/cache
+
+# 源码（CLI，不进镜像）
+src
+test
+.github
+
+# 配置与工具文件
+.claude
+.env*
+*.local
+biome.json
+tsconfig.json
+tsconfig*.json
+vercel.json
+
+# 系统文件
+.DS_Store
+*.log
+
+# README（可选保留，这里排除节省镜像体积）
+README*.md
+LICENSE

.github/workflows/deploy.yml

@@ -33,33 +33,28 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: pnpm/action-setup@v4
+      - uses: oven-sh/setup-bun@v2
         with:
-          version: 9
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
+          bun-version: latest
 
       - uses: actions/cache@v4
         with:
-          path: .vitepress/cache
-          key: vitepress-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-${{ hashFiles('**/*.md', '.vitepress/config.mts') }}
+          path: docs/.vitepress/cache
+          key: vitepress-${{ runner.os }}-${{ hashFiles('bun.lock') }}-${{ hashFiles('docs/**/*.md', 'docs/.vitepress/config.mts') }}
           restore-keys: |
-            vitepress-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-
+            vitepress-${{ runner.os }}-${{ hashFiles('bun.lock') }}-
             vitepress-${{ runner.os }}-
 
-      - run: pnpm install --frozen-lockfile
+      - run: bun install --frozen-lockfile
 
       - name: Build (GitHub Pages)
-        run: pnpm build
+        run: bun run docs:build
         env:
           VITEPRESS_BASE: ${{ vars.VITEPRESS_BASE || format('/{0}/', github.event.repository.name) }}
 
       - uses: actions/upload-pages-artifact@v3
         with:
-          path: .vitepress/dist
+          path: docs/.vitepress/dist
 
   # ──────────────────────────────────────────────────────────────────────────
   # 2. 部署到 GitHub Pages
@@ -78,7 +73,7 @@ jobs:
   # 3. 构建并推送 Docker 镜像
   #
   # Docker 始终以 VITEPRESS_BASE=/ 构建，因为 nginx 从根路径服务。
-  # 借助 pnpm + VitePress + Docker 层三重缓存，二次构建极快。
+  # 借助 bun + VitePress + Docker 层三重缓存，二次构建极快。
   # ──────────────────────────────────────────────────────────────────────────
   docker:
     runs-on: ubuntu-latest
@@ -90,28 +85,23 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - uses: actions/setup-node@v4
+      - uses: oven-sh/setup-bun@v2
         with:
-          node-version: 22
-          cache: pnpm
+          bun-version: latest
 
       # 复用与 build-pages 相同的 VitePress 缓存 key
       - uses: actions/cache@v4
         with:
-          path: .vitepress/cache
-          key: vitepress-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-${{ hashFiles('**/*.md', '.vitepress/config.mts') }}
+          path: docs/.vitepress/cache
+          key: vitepress-${{ runner.os }}-${{ hashFiles('bun.lock') }}-${{ hashFiles('docs/**/*.md', 'docs/.vitepress/config.mts') }}
           restore-keys: |
-            vitepress-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-
+            vitepress-${{ runner.os }}-${{ hashFiles('bun.lock') }}-
             vitepress-${{ runner.os }}-
 
-      - run: pnpm install --frozen-lockfile
+      - run: bun install --frozen-lockfile
 
       - name: Build (Docker, base=/)
-        run: pnpm build
+        run: bun run docs:build
         env:
           VITEPRESS_BASE: /
 

Dockerfile

@@ -0,0 +1,33 @@
+# ── Stage 1: Build ──────────────────────────────────────────────────────────
+FROM oven/bun:1 AS builder
+
+WORKDIR /app
+
+COPY package.json bun.lock* ./
+RUN bun install --frozen-lockfile
+
+COPY docs/ docs/
+
+ARG VITEPRESS_BASE=/
+ENV VITEPRESS_BASE=${VITEPRESS_BASE}
+
+RUN bun run docs:build
+
+# ── Stage 2: Serve ───────────────────────────────────────────────────────────
+FROM nginx:alpine AS runner
+
+COPY --from=builder /app/docs/.vitepress/dist /usr/share/nginx/html
+
+# SPA / cleanUrls: try file, then .html, then 404
+RUN printf 'server {\n\
+    listen 80;\n\
+    root /usr/share/nginx/html;\n\
+    index index.html;\n\
+    location / {\n\
+        try_files $uri $uri.html $uri/ /404.html;\n\
+    }\n\
+}\n' > /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]