diff --git a/docs/上线清单-S1-S7部署.md b/docs/上线清单-S1-S7部署.md
index fbf59ba..0dc75ac 100644
--- a/docs/上线清单-S1-S7部署.md
+++ b/docs/上线清单-S1-S7部署.md
@@ -199,3 +199,53 @@ docker compose up -d douyu-login      # 用旧 tag
 | **回滚** | 6 个迁移降级，**2 秒**，`bind_status` 原值完好、两列回到 `varchar(32)` |
 | **回滚前置脚本** | 模拟「部署期间新拿到的 CK」→ 回填 → 降级 → **该 CK 完整幸存** ✓ |
 | **生产 CK 解密** | 抽样 5 条，**5/5 正常**（长度 1613–1660）✓ |
+
+---
+
+## 附：把生产库同步到本地（测试用）
+
+生产已于 2026-10-04 部署完成（`main@2f610a5`，迁移 `20261004_0046`）。
+本地已建立一份**与生产逐项一致**的镜像库，方便后续测试在本地跑。
+
+```bash
+# 重新同步（默认全量，含 douyu_tasks 的 837MB）
+scripts/refresh_local_prod_mirror.sh
+# 精简版（跳过 douyu_tasks 行，43MB，够绝大多数测试）
+scripts/refresh_local_prod_mirror.sh --no-tasks
+```
+
+然后用镜像库跑应用 / 脚本：
+
+```bash
+DB_NAME=douyu_login_prod ./dev.sh
+# 或
+DATABASE_URL="mysql+pymysql://douyu_login:<pw>@127.0.0.1:3307/douyu_login_prod?charset=utf8mb4" ...
+```
+
+### 当前本地镜像的内容（2026-10-04 建立）
+
+| | 本地 `douyu_login_prod` |
+|---|---|
+| 迁移版本 | `20261004_0046`（与生产一致） |
+| 账号 / 持有 CK | 15,182 / 14,323 |
+| 登录记录 | 15,169 |
+| `douyu_tasks` | **253,424**（含 837MB JSON —— 可用来实测保留策略） |
+| `account_events` | 34（部署后产生的真实事件） |
+| 库大小 | 907 MB |
+
+### 两个关键前提
+
+1. **`APP_ENCRYPTION_KEY` 必须与生产一致**，否则镜像里的 CK 解不开、CK 相关测试全废。
+   已验证：当前本地 `.env` 的密钥**与生产一致**（抽样解密正常，CK 前缀 `dy_accounts_main`，长度 1659–1702）。
+2. **不要在镜像库上跑测试套件**。测试用的是独立库 `douyu_login_test`
+   （由 `TEST_MYSQL_DATABASE` 指定，`init_test_schema` 会 `create_all`）。
+   镜像库只用于手工/联调。
+
+### 踩过的坑（脚本里已规避）
+
+- **不要把 `mysqldump` 串进 SSH 管道**：实测只有 ~49KB/s（MySQL 读 + gzip + 网络互相拖）；
+  改成"服务器本地 dump 成文件 + rsync"后 ~8MB/s，快两个数量级。
+- 用 **rsync 而非 scp**：可断点续传。
+- **`docker compose run` 默认读 stdin** —— 脚本如果通过 `ssh 'bash -s' < 脚本` 喂进去，
+  它会把**脚本剩下的行**当 stdin 吃掉（这就是本次部署 90 秒停机的根因）。
+  正确写法：`docker compose run -T --rm ... </dev/null`。