From 1e24987e4f2958a8204de19463e96140e2253c6e Mon Sep 17 00:00:00 2001
From: panxiao81 <pan-xiao@live.cn>
Date: Wed, 16 Sep 2026 18:52:03 +0000
Subject: [PATCH] =?UTF-8?q?=E5=9C=A8=E5=8A=A8=E6=80=81=20Pod=20=E5=86=85?=
 =?UTF-8?q?=E7=9B=B4=E6=8E=A5=E8=BF=90=E8=A1=8C=E6=96=87=E6=A1=A3=E6=A3=80?=
 =?UTF-8?q?=E6=9F=A5=EF=BC=8C=E9=81=BF=E5=85=8D=E4=BE=9D=E8=B5=96=20Docker?=
 =?UTF-8?q?=20socket?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitea/workflows/docs.yml | 10 +++++-----
 CONTRIBUTING.md           |  5 +++--
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/.gitea/workflows/docs.yml b/.gitea/workflows/docs.yml
index 5351263..e686c96 100644
--- a/.gitea/workflows/docs.yml
+++ b/.gitea/workflows/docs.yml
@@ -9,18 +9,18 @@ on:
 jobs:
   check:
     runs-on: [self-hosted, pod]
-    container:
-      image: python:3.12-bookworm
     steps:
       - name: Checkout
         uses: actions/checkout@v4
         with:
           persist-credentials: false
       - name: Install checker dependencies
-        run: python3 -m pip install --disable-pip-version-check -r requirements-docs.txt
+        run: |
+          python3 -m venv .venv
+          .venv/bin/python -m pip install --disable-pip-version-check -r requirements-docs.txt
       - name: Test checker
-        run: python3 -m unittest discover -s tests -v
+        run: .venv/bin/python -m unittest discover -s tests -v
       - name: Check documentation
-        run: python3 scripts/check_docs.py
+        run: .venv/bin/python scripts/check_docs.py
       - name: Check whitespace
         run: git show --format= --check HEAD
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8276289..c2d21f6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -86,8 +86,9 @@ git diff --check
 
 依赖版本固定在 [requirements-docs.txt](requirements-docs.txt)。安装依赖需要网络，检查器本身离线运行。
 Gitea 工作流 [.gitea/workflows/docs.yml](.gitea/workflows/docs.yml) 在 main push、PR 和手动触发时运行，
-使用 `[self-hosted, pod]` 与 Python 容器；无需业务秘密或集群权限。
-CI 拉取容器、checkout action 和依赖仍需要对应网络可用。
+使用 `[self-hosted, pod]` 的 Python 虚拟环境；无需业务秘密或集群权限。
+不设置 job `container`：此次 Pod runner 日志确认没有 Docker socket，额外启动 job 容器会在检查前失败。
+CI 获取 checkout action 和依赖仍需要对应网络可用。
 
 检查范围：