diff --git a/docs/development/ci-runner-setup.md b/docs/development/ci-runner-setup.md
index 3729034..7c948d5 100644
--- a/docs/development/ci-runner-setup.md
+++ b/docs/development/ci-runner-setup.md
@@ -71,9 +71,13 @@ docker restart act_runner
 
 | 现象 | 处理 |
 | --- | --- |
-| job 卡在 `actions/checkout` 或 `setup-java` 拉不下来 | runner 访问不了 github.com。两种解法：a) `app.ini` 的 `[actions]` 加 `DEFAULT_ACTIONS_URL = https://gitea.com`（用 gitea.com 上的 Action 镜像仓）；b) 把工作流的 setup-java 步骤删掉，改用自带 JDK17 的 job 镜像（ci.yml 头部注释已写明） |
+| `docker run` 报 `permission denied ... docker.sock` | 当前用户不在 docker 组：`sudo usermod -aG docker $USER`，退出 SSH 重登生效 |
+| 拉镜像 `dial tcp ...443: i/o timeout` | 服务器直连 Docker Hub 不通。配镜像加速后 `sudo systemctl restart docker`：腾讯云机器优先内网源 `https://mirror.ccs.tencentyun.com`，公共源如 `https://docker.1ms.run`（可用性随时间变化，失效就换）。写入 `/etc/docker/daemon.json` 的 `registry-mirrors` 数组 |
+| job 卡在 `actions/checkout` 或 `setup-java` 拉不下来 | runner 访问不了 github.com（与上一条通常同时出现）。两种解法：a) `app.ini` 的 `[actions]` 加 `DEFAULT_ACTIONS_URL = https://gitea.com`（用 gitea.com 上的 Action 镜像仓）后重启 Gitea；b) 把工作流的 setup-java 步骤删掉，改用自带 JDK17 的 job 镜像（ci.yml 头部注释已写明） |
 | Testcontainers 报 `Could not find a valid Docker environment` | 第 3 步的 container.options 没生效，job 容器内没有 docker.sock |
-| runner 显示 offline | `docker logs act_runner` 看注册错误；令牌只能用一次，重新注册需删 `/data/.runner` |
+| runner 显示 offline | `docker logs act_runner` 看注册错误；令牌只能用一次，重新注册需删 `/data/.runner`；重试 `docker run` 前先 `docker rm -f act_runner` 清残留容器 |
 | Maven 每次全量下载依赖很慢 | 在 config.yaml 的 container.options 追加 `-v act_m2:/root/.m2` 做持久缓存 |
 
+安全习惯：runner 注册成功后，到管理后台 → Actions → Runners 重置注册令牌（不影响已注册的 runner）。
+
 启用完成后，把 `docs/development/feature-checklist.md` 第 6 节「CI 载体」从 🟡 改为 ✅。
diff --git a/docs/development/feature-checklist.md b/docs/development/feature-checklist.md
index ca26c9f..6c6c5f6 100644
--- a/docs/development/feature-checklist.md
+++ b/docs/development/feature-checklist.md
@@ -62,7 +62,7 @@
 | dio API client + 信封解包 + 错误码映射（含 42300） | ✅ | 第三波并行交付（`patbond-flutter@8d890c0`+`da25804`，报告 17），基于 mock 验证 |
 | Splash/登录/注册页 + secure storage + 登录态恢复 + 真实退出 | ✅ | 同上，登录页四态/注册校验 widget 测试锁定 |
 | 401 单飞刷新拦截器 | ✅ | `TokenRefresher` 单元测试（刷新单飞、40102 清会话） |
-| 与真实后端联调（烟囱测试） | ⬜ | 第四波；前置的 compose 编排已就绪（见第 6 节） |
+| 与真实后端联调（烟囱测试） | 🟡 | 2026-09-04 手动联调通过（compose 后端 + 本地 Flutter，注册/登录链路无报错）；自动化 `integration_test` 留第四波 |
 
 **跨端核对发现（前端线跟进，后端已按 openapi.yaml 核对全部通过）**：