# SOP · 怎么把剩下的 9 个实训做成 lab01 这样

> lab01 是样板：全英文命名 + 代码 + README + 8 张 PyCharm 操作图 + 4 张页面图 + 自包含 walkthrough。
> 剩下 9 个按下面的流程走，**每个约 5 分钟**，而且第 2–3 步（PyCharm 配置）只需做一次，全项目共用。

## 一、先弄清"哪部分共用、哪部分各做"

| 环节 | 是否每个实训都做 | 说明 |
|---|---|---|
| 配解释器（黄条→设置→添加→选现有→填 .venv） | ❌ **只做一次** | 解释器属于项目，配好后 10 个实训全绿 |
| 装依赖 `pip install -r requirements.txt` | ❌ 只做一次 | 已装在项目 `.venv` |
| 跑起来看 `Running on …` | ✅ 每个都做（截图可复用同一张模板图） | 端口不同 |
| 页面截图 | ✅ 每个都做 | 每个实训 2–5 个页面 |
| 代码注释 / README / 验收点 | ✅ 每个都做 | 模板见 lab01 |
| walkthrough.html | ✅ 每个都做 | 由脚本生成，setup 段只嵌 2 张共用图 |

## 二、剩余 9 个实训的目标命名

| 现目录 | 目标目录 | 端口 |
|---|---|---|
| 实训02_第1章_请求与响应_Cookie与Session | `lab02_request_response` | 5111 |
| 实训03_第2章_Web前端基础 | `lab03_web_frontend` | 5112 |
| 实训04_第3章_Jinja2模板引擎 | `lab04_jinja2_templates` | 5113 |
| 实训05_第4章_表单验证与安全文件上传 | `lab05_forms_and_upload` | 5101 |
| 实训06_第5章_数据库存储_SQLAlchemy | `lab06_sqlalchemy_crud` | 5115 |
| 实训07_第5章_数据库迁移_FlaskMigrate | `lab07_flask_migrate` | 5129 |
| 实训08_第6章_应用工厂与蓝图 | `lab08_app_factory_blueprints` | 5116 |
| 实训09_第6章_用户认证_FlaskLogin | `lab09_flask_login` | 5117 |
| 实训10_第7章_综合项目_简易博客 | `lab10_blog_project` | 5118 |

## 三、每章的具体动作（照抄 lab01）

### 1. 改英文名
文件夹改成上表的名字；文件夹内统一成这几个文件：

```
labNN_xxx/
├─ app.py              代码（英文标识符 + 一行中文短注释）
├─ README.md           三步启动 / 验收 / 报错表
├─ notes.md            知识点对照
├─ run.bat             双击启动（自动用 ..\.venv）
├─ walkthrough.html    图文手册（自包含，图片内嵌）
└─ screenshots/        页面截图 + annotated/ 标注版
```

> 改完目录名，PyCharm 里的运行配置会失效——点一次"重新加载 Gradle/Maven"没用，
> 直接 `File → Reload All from Disk`，或按 `RUN_COMMANDS.md` 里改 `.idea/runConfigurations/*.xml` 的路径。

### 2. 截页面图（自动）
```bat
:: 在项目根执行，参数：实训目录 端口 路由1 路由2 ...
python ..\..\_工具脚本\_复盘脚本\51_capture_pages.py lab02_request_response 5111 / /info /login /status
```
脚本会自动：起服务 → 用 Edge 无头浏览器逐页截图到 `screenshots/page_XX.png` → 停服务。

### 3. 生成带箭头编号的标注图（自动）
```bat
python ..\..\_工具脚本\_复盘脚本\40_标注截图.py --lab lab02_request_response
```
默认在页面左上角画红框 + ①，多标注点可在脚本顶部的 `PLANS` 里加坐标。

### 4. 生成 walkthrough.html（自动）
```bat
python ..\..\_工具脚本\_复盘脚本\52_build_walkthrough.py --lab lab02_request_response --port 5111
```
会输出自包含 HTML：第 1 段是共用配置（黄条 + 已就绪两张图），第 2 段是该实训每个页面一张图，
第 3 段是验收清单 + 报错表 + 运行指令。

### 5. 手工过一遍（5 分钟）
- 打开 `walkthrough.html`，看红框位置对不对、文案是否口语；
- 双击 `run.bat`，浏览器确认页面和截图一致；
- 在 `README.md` 的验收清单里补上本实训特有的一条。

## 四、批量一次做完

```bat
:: 在项目根目录
powershell -File ..\..\_工具脚本\_复盘脚本\53_build_all_labs.ps1
```
它按上表把 9 个目录依次改名 → 截图 → 标注 → 生成 walkthrough，最后打印一份对照表。
（脚本是幂等的：已改过名的目录会跳过改名，只补截图与手册。）

## 五、什么时候需要重拍 PyCharm 那 8 张图

只在下面三种情况需要：换 PyCharm 大版本、换课程模板规范、或者你要求中文界面换成英文界面。
重拍方法是我这次用的那套（本机实测可用）：

| 脚本 | 作用 |
|---|---|
| `_工具脚本\_复盘脚本\Drive.ps1` | 窗口/全屏截图、按窗口相对坐标点击、发按键 |
| `_工具脚本\_复盘脚本\RunShot.ps1` | 焦点切到编辑器 → `Shift+F10` 运行 → 截图运行面板 |
| `_工具脚本\_复盘脚本\40_标注截图.py` | 给截图加红框、箭头、编号、文字标签 |

> 注意：JetBrains 的弹出菜单和对话框是**独立窗口**，必须用全屏截图（`Drive.ps1 -Action screen`），
> 只截 IDE 主窗口会漏掉菜单——这就是我第一次只截到 4 张的原因。
