docs: 更新 CI 部署文档 v5.1.0 → v5.2.0

主要更新：
- Runner 镜像：添加 Docker CLI，固定 Bun 版本为 1.3
- systemd 服务：添加 Docker socket 挂载配置
- CI 流程：移除覆盖率相关描述（只运行单元测试）
- 关键设计说明：更新 Runner 镜像和 Docker socket 挂载说明

docs/ci-deployment-guide.md

@@ -287,27 +287,36 @@ cd /opt/gitea && docker compose up -d
 
 #### 安装 Act Runner（CI/CD 执行器）
 
-> **国内网络关键配置**：Gitea Act Runner 使用 Docker 执行器，需要解决三个网络问题：
+> **国内网络关键配置**：Gitea Act Runner 使用 Docker 执行器，需要解决以下问题：
 > 1. Docker Hub 镜像拉取 → 通过 Docker 镜像加速解决（已在服务器初始化配置）
 > 2. GitHub Actions 拉取 → 通过 `github_mirror` 配置从 gitea.com 镜像解决
-> 3. 容器访问 Gitea API → 通过 `--network host` 让容器共享宿主机网络
+> 3. 容器访问 Gitea API → 通过 `network: host` 让容器共享宿主机网络
+> 4. Job 容器执行 docker 命令 → 挂载宿主机 Docker socket，镜像内置 Docker CLI
 
 ##### 1. 构建 Runner 自定义镜像
 
-> `oven/bun:latest` 不包含 git，`actions/checkout` 会回退到 REST API 下载代码，
+> `oven/bun` 不包含 git 和 docker CLI，需要构建自定义镜像：
-> 但 GitHub 风格的 REST API URL（`/tarball/{ref}`）与 Gitea（`/archive/{ref}.tar.gz`）不兼容。
+> - **git**：`actions/checkout` 需要，否则会回退到 REST API（GitHub 与 Gitea URL 格式不兼容）
-> 因此需要构建预装 git 的自定义镜像，避免每次 CI 安装。
+> - **docker CLI**：CI 中执行 `docker build` 等命令需要，通过 socket 连接宿主机 Docker daemon
+> - **固定版本**：使用 Bun 1.3 而非 latest，确保 CI 环境可复现
 
 ```bash
 # 创建 Dockerfile
 cat > /opt/runner-image/Dockerfile << 'EOF'
-FROM oven/bun:latest
+FROM oven/bun:1.3
 RUN sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources \
-    && apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*
+    && apt-get update \
+    && apt-get install -y git docker.io \
+    && rm -rf /var/lib/apt/lists/*
 EOF
 
 # 构建镜像（使用阿里云 Debian 镜像源加速）
 docker build -t duoqi-runner:bun-git /opt/runner-image
+
+# 验证镜像包含所需工具
+docker run --rm duoqi-runner:bun-git bun --version
+docker run --rm duoqi-runner:bun-git git --version
+docker run --rm duoqi-runner:bun-git docker --version
 ```
 
 ##### 2. 安装并注册 Runner
@@ -370,6 +379,9 @@ ExecStart=/usr/local/bin/act_runner daemon --config /opt/act-runner/config.yaml
 Restart=always
 Environment=HOME=/root
 
+# 关键：挂载 Docker socket，让 job 容器能访问宿主机的 Docker daemon
+BindPaths=/var/run/docker.sock:/var/run/docker.sock
+
 [Install]
 WantedBy=multi-user.target
 EOF
@@ -551,7 +563,7 @@ develop 分支（开发测试）              main 分支（生产发布）
 └─────┬─────┘                      └─────┬─────┘
       ▼                                  ▼
 ┌───────────┐                      ┌───────────┐
-│   test    │ ← 单元测试 + 覆盖率   │   test    │ ← 单元测试 + 覆盖率
+│   test    │ ← 单元测试            │   test    │ ← 单元测试
 └─────┬─────┘                      └─────┬─────┘
       ▼                                  ▼
 ┌────────────┐                     ┌────────────┐
@@ -608,9 +620,11 @@ git push origin main
 | 测试环境使用 Docker profiles | 按需启停，节省内存 |
 | 生产部署手动确认 | 防止误操作，确保人工验证后才上线 |
 | 使用 Gitea Actions | 兼容 GitHub Actions 语法，学习成本低 |
-| Runner 使用 `--network host` | 容器共享宿主机网络，解决容器无法访问 Gitea 的问题 |
+| Runner 使用 `network: host` | 容器共享宿主机网络，解决容器无法访问 Gitea 的问题 |
 | Runner 使用 `github_mirror` | 从 gitea.com 镜像拉取 Actions，解决国内无法访问 GitHub 的问题 |
-| 自定义 Runner 镜像（bun + git） | 避免 checkout REST API 与 Gitea 不兼容的问题，跳过每次安装 |
+| 自定义 Runner 镜像（bun + git + docker CLI） | 避免 checkout REST API 不兼容，支持 CI 中执行 docker 命令 |
+| Runner 挂载 Docker socket | Job 容器通过 socket 访问宿主机 Docker daemon，执行构建操作 |
+| 固定 Bun 版本（1.3） | 确保 CI 环境可复现，避免 latest 版本变化导致意外失败 |
 
 ### 部署操作
 
@@ -1099,6 +1113,6 @@ docker compose up -d api-prod
 
 ---
 
-**文档版本**: v5.1.0 (双分支工作流 + 国内网络适配)
+**文档版本**: v5.2.0 (双分支工作流 + 国内网络适配 + Docker 执行器完善)
 **最后更新**: 2026-04-17
 **维护者**: Duoqi Team