chore: 新增文档 CI 门禁工作流并同步功能清单

- mkdocs build --strict，与本地门禁同一命令，pip 走腾讯云镜像 - 功能清单 CI 项更新为三仓全覆盖
2026-09-04 18:20:57 +08:00
parent 64521bf284
commit f267141334
2 changed files with 32 additions and 1 deletions
@@ -0,0 +1,31 @@
+# Gitea Actions 门禁：与 docs/development/git-workflow.md 的本地门禁同一条命令。
+# 零外部 action / 零 GitHub 依赖；pip 走腾讯云 PyPI 镜像。
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  docs-build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout (manual)
+        run: |
+          git init -q .
+          AUTH_URL=$(echo "${{ github.server_url }}" | sed "s#https://#https://oauth2:${{ github.token }}@#")
+          git remote add origin "$AUTH_URL/${{ github.repository }}.git"
+          git fetch -q --depth 1 origin "+${{ github.ref }}:refs/ci-head"
+          git checkout -q refs/ci-head
+      - name: Install mkdocs
+        run: |
+          command -v pip3 >/dev/null || { apt-get update -qq && apt-get install -y -qq python3-pip; }
+          pip3 install -q -i https://mirrors.cloud.tencent.com/pypi/simple mkdocs
+      # 与本地门禁同一命令；exit 0 且零 warning 方可合入（git-workflow.md）
+      - name: Build docs (strict)
+        run: mkdocs build --strict -d /tmp/site