ci(pages): 介绍站的 GitHub Pages 镜像

主站仍自托管在 NAS（192.168.2.106），国内内网直连毫秒级；GitHub Pages 提供
海外可达性与灾备。两边同源（同一个 site/ 目录），不存在谁是「真身」。

发布前的完整性检查是必要的：Pages 是静态托管的，**缺文件不会让部署失败**
（照样 200 + 404 页），所以「引用存在但文件没提交」这类问题必须在这里拦住 ——
检查 index.html 引用的每个 assets/ 资源都实际存在。

三个 action 版本已逐个查 GitHub API 确认真实存在（checkout@v7 与仓库其余
workflow 保持一致；configure-pages@v5 / upload-pages-artifact@v4 / deploy-pages@v4）。
workflow 已过 actionlint，检查逻辑已在本机原样跑通（3 个文件、165778 字节、
引用清单 assets/logo.svg）。

注：Pages 需在仓库设置里把 Source 选为「GitHub Actions」后本流水线才会真正发布。

.github/workflows/pages.yml

@@ -0,0 +1,85 @@
+name: Pages Mirror
+
+# 介绍站（site/）的 GitHub Pages 镜像。
+#
+# 为什么是「镜像」而不是主站：主站自托管在 NAS（192.168.2.106），
+# 国内访问是内网直连（毫秒级）；GitHub Pages 负责海外可达性与灾备。
+# 两边内容同源（同一个 site/ 目录），不存在谁是「真身」的问题。
+#
+# 手动触发也留着：改完 site/ 想立刻发布、或主站回滚后要重新对齐时用。
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'site/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# 同一时刻只跑一个 Pages 部署；排队中的旧任务直接取消
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    name: Build site artifact
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      # 静态站：没有构建步骤，site/ 就是要发布的内容。
+      # 这里只做**完整性检查**——少一个文件会让线上 404，而 404 不会让
+      # 部署失败（Pages 照样返回 200 + 404 页），所以必须在发布前拦住。
+      - name: Verify site completeness
+        run: |
+          set -euo pipefail
+          test -f site/index.html || { echo "缺少 site/index.html"; exit 1; }
+          test -f site/assets/logo.svg || {
+            echo "缺少 site/assets/logo.svg"; exit 1
+          }
+
+          # index.html 引用的本地资源必须都在（防「改了引用忘了加文件」）
+          missing=0
+          grep -oE '(src|href)="(assets|\./assets)/[^"]+"' site/index.html \
+            | sed -E 's/.*="(\.\/)?([^"]*)"/\2/' > /tmp/refs.txt
+          while read -r ref; do
+            [ -z "$ref" ] && continue
+            if [ ! -e "site/$ref" ]; then
+              echo "引用缺失: site/$ref"
+              missing=1
+            fi
+          done < /tmp/refs.txt
+          [ "$missing" -eq 0 ] || exit 1
+
+          echo "site/ 文件数: $(find site -type f | wc -l)"
+          echo "index.html 字节: $(wc -c < site/index.html)"
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+          # Pages 产物必须保留；不设 retention 会被仓库默认值（30 天）回收——
+          # 与部署无关，但重跑 build 时会少掉旧产物对比。
+          retention-days: 7
+
+  deploy:
+    name: Deploy to Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4