# 测试方案 — 2026-04-16-17-40-20

## 测试环境准备
1. 项目依赖已安装，构建通过。
2. 使用测试账号 `admin / 123456`（超级管理员）登录系统。
3. 确保系统设置中已配置默认模板，且已存在至少一个报告模板。

---

## 测试项清单

### 测试项 A：自动抽帧图片在切换页面后不丢失
**测试步骤**：
1. 进入 **图文报告生成** 页面，上传一个手术视频。
2. 等待系统自动抽帧完成（关键帧列表中出现多个自动帧）。
3. 切换到 **报告管理**（`/report-manage`）页面。
4. 通过左侧菜单再次进入 **图文报告生成** 页面。

**预期结果**：
- 视频分析面板中，刚才自动抽取的所有关键帧图片**全部保留**，没有丢失。
- 手动截取的帧（如果有）也一并保留。

---

### 测试项 B：手动抽帧图片在切换页面后保留
**测试步骤**：
1. 在视频分析面板中点击 **"截取当前帧"** 按钮，手动截取一帧。
2. 切换到其他页面（如 `/dashboard`）。
3. 返回 **图文报告生成** 页面。

**预期结果**：
- 手动截取的帧**仍然存在于关键帧列表中**。

---

### 测试项 C：编辑报告后切换界面，模板选择器不显示"无"
**测试步骤**：
1. 进入 **图文报告生成** 页面（新建报告）。
2. 确认顶部模板选择器显示了默认模板名称（如 "腹腔镜胆囊切除术报告"）。
3. 在编辑器中随意输入几个字或修改基本信息。
4. 切换到 **报告管理** 页面。
5. 再次进入 **图文报告生成** 页面。

**预期结果**：
- 模板选择器**仍然显示默认模板名称**，**不显示"无"**。
- 编辑器内容恢复为刚才编辑的状态。

---

### 测试项 D：编辑已有报告后切换界面，模板选择器状态正确
**测试步骤**：
1. 在 **报告管理** 中打开一份已有报告进行编辑。
2. 在编辑器中修改内容。
3. 切换到其他页面后再返回该报告编辑页。

**预期结果**：
- 报告内容正确恢复。
- 若该报告是从模板创建的，"当前模板"应显示对应模板名称；若不是从模板创建，显示"无"也属正常。

---

### 测试项 E：system-settings 新增"开启自动帧插入"开关
**测试步骤**：
1. 进入 **系统设置** 页面。
2. 观察 **视频抽帧配置** 区域。

**预期结果**：
- 存在一个 **"开启自动帧插入"** 的复选框开关，默认未勾选。
- 勾选后，每个 **抽帧位置百分比** 输入框的右下角（或旁边）显示一个 **绿色对勾（✓）** 标记。
- 取消勾选后，绿色对勾标记消失。
- 点击 **保存全局配置** 后刷新页面，开关状态正确保持。

---

### 测试项 F：开启自动帧插入后，自动抽帧会按顺序填充占位符
**测试步骤**：
1. 在 **系统设置** 中勾选 **"开启自动帧插入"**，保存。
2. 进入 **图文报告生成** 页面（新建报告），确认编辑器中有多个空置 `image-placeholder`。
3. 在视频分析面板中上传一个手术视频，等待自动抽帧完成。

**预期结果**：
- 自动抽取的每一帧会**按从前到后的顺序**，依次填充到编辑器中的空置占位符里。
- 如果占位符数量多于自动帧数量，剩余占位符保持空置。
- 自动插入过程中**没有任何弹窗提示**。

---

### 测试项 G：自动帧插入满后静默处理（无弹窗）
**测试步骤**：
1. 确保 **开启自动帧插入** 已打开。
2. 新建报告，编辑器中只有 1 个或少量空置占位符。
3. 上传视频，等待自动抽帧（通常会产生 12 帧或更多）。

**预期结果**：
- 前几个空置占位符被自动填充。
- 当所有占位符都填满后，剩余的自动帧**仅在关键帧列表中显示**，不再尝试插入。
- **全程不出现** "没有可插入图片的空位" 的 alert 提示。

---

### 测试项 H：关闭自动帧插入后行为回退
**测试步骤**：
1. 在 **系统设置** 中**取消勾选** "开启自动帧插入"，保存。
2. 进入 **图文报告生成** 页面，上传视频等待自动抽帧。

**预期结果**：
- 自动抽帧完成后，编辑器中的占位符**全部保持空置**。
- 用户需要通过手动拖拽或点击 "插入" 按钮来填充占位符。

---

### 测试项 I：构建与类型检查回归
**测试步骤**：
1. 在项目根目录执行：
   ```bash
   npm run lint
   npm run build
   ```

**预期结果**：
- `npm run lint` 无 TypeScript 编译错误。
- `npm run build` 构建成功。

---

## 回归验证范围
- [ ] 拖拽插入、手动截取、删除关键帧功能正常。
- [ ] 报告保存（草稿/完成）功能正常。
- [ ] 编辑器打印、模板加载功能正常。
- [ ] 其他系统设置项（API 地址、默认模板等）保存和读取正常。