# 测试方案

开始时间：2026-05-03-22-02-15

## 本次方案路径

`工程分析/测试方案-2026-05-03-22-02-15.md`

## 测试范围

- 快速预览接口 `/api/preview` 在硬边界、高斯平滑、软过渡三种模式下是否正常返回图片。
- 硬边界和高斯平滑预览图中黄色分界线是否为单条线。
- 四状态过程预览图中硬边界、高斯平滑截图是否不再出现 Y 字分界线。
- 前端类型检查和构建是否通过。
- 重新部署后 `http://192.168.3.11:3005/` 是否可访问。

## 测试命令

前端类型检查：

```bash
cd WebSite
npm run lint
```

前端构建：

```bash
cd WebSite
npm run build
```

Python 语法检查：

```bash
python -m py_compile head_extension_app.py web_backend.py
```

预览接口手工验证建议：

```bash
curl -s -X POST http://127.0.0.1:8787/api/preview \
  -H 'Content-Type: application/json' \
  -d '{"inputDir":"<有效DICOM目录>","angleDegrees":20,"showCutoffLine":true,"mode":"hard_boundary"}'
```

```bash
curl -s -X POST http://127.0.0.1:8787/api/preview \
  -H 'Content-Type: application/json' \
  -d '{"inputDir":"<有效DICOM目录>","angleDegrees":20,"showCutoffLine":true,"mode":"gaussian_smooth","gaussianSigma":3}'
```

## 手工验证点

- 在网页“影像变换工作站”打开预览分界线后，切换到“硬边界”，黄色线应为单条线。
- 切换到“高斯平滑”，黄色线应为单条线。
- 切换到“软过渡”，预览应仍自然、无 Y 字撕裂。
- 点击“隐藏预览分界线”后，预览图中不显示黄色线。

## 验收标准

- 硬边界、高斯平滑预览中不再出现 Y 字形黄色分界线。
- 预览接口仍正常返回图片。
- `python -m py_compile head_extension_app.py web_backend.py` 通过。
- `npm run lint` 通过。
- `npm run build` 通过。
- Gitea 文档和代码备份 commit 完成。
- 项目重新部署后 `http://192.168.3.11:3005/` 返回 `200 OK`。

## 无法测试或残余风险

- 如果没有用户指定的实际业务 DICOM 数据，只能使用仓库现有样例目录 `Ori_Head_CT/` 做验证。
- 线条位置是预览标注层，和真实 3D DICOM 形变边界不应被理解为像素级临床标尺。

## 人工审核状态

待用户二次人工审核确认。未经确认不得修改业务代码。