From f267141334d62f65a2286b8a285dfa382bd4b3b4 Mon Sep 17 00:00:00 2001
From: Lixi20 <lixi0506cd@gmail.com>
Date: Fri, 4 Sep 2026 18:20:57 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E6=96=B0=E5=A2=9E=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?=20CI=20=E9=97=A8=E7=A6=81=E5=B7=A5=E4=BD=9C=E6=B5=81=E5=B9=B6?=
 =?UTF-8?q?=E5=90=8C=E6=AD=A5=E5=8A=9F=E8=83=BD=E6=B8=85=E5=8D=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- mkdocs build --strict，与本地门禁同一命令，pip 走腾讯云镜像
- 功能清单 CI 项更新为三仓全覆盖
---
 .gitea/workflows/ci.yml               | 31 +++++++++++++++++++++++++++
 docs/development/feature-checklist.md |  2 +-
 2 files changed, 32 insertions(+), 1 deletion(-)
 create mode 100644 .gitea/workflows/ci.yml

diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
new file mode 100644
index 0000000..b004447
--- /dev/null
+++ b/.gitea/workflows/ci.yml
@@ -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
diff --git a/docs/development/feature-checklist.md b/docs/development/feature-checklist.md
index b83917b..4f9b678 100644
--- a/docs/development/feature-checklist.md
+++ b/docs/development/feature-checklist.md
@@ -79,7 +79,7 @@
 | docker compose 最小编排（postgres:18 + 两无状态服务容器） | ✅ | `patbond-api@ab0265c`：`./deploy/init-secrets.sh` → `mvnw -DskipTests package` → `docker compose up -d --build`；完整冒烟实测通过（register→me→refresh→旧 token 重用 40102→internal 401→logout）；用法见 `patbond-api/Readme.md` |
 | 可执行镜像构建（repackage exec jar、非 root 运行） | ✅ | 同上；顺带修复无 starter-parent 时 package 产物不可执行 |
 | 信封严格化（`success` 派生字段不再上线） | ✅ | `patbond-api@8a79971`，信封恰为 `{code, message, data}` |
-| CI 载体（自动执行门禁） | ✅ | Gitea Actions + act_runner 已上线（ci.yml #6 全绿 3m18s：本实例克隆 + apt JDK17 + mvnw 全量 82 测试含 Testcontainers），零 GitHub 依赖 |
+| CI 载体（自动执行门禁） | ✅ | 三仓全覆盖：api（mvnw 82 测试，#6 全绿 3m18s）、flutter（format/analyze/test，SDK 走 flutter-io.cn + toolcache 缓存）、doc（mkdocs --strict）；全部零 GitHub 依赖 |
 
 ## 针对性测试速查