65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
|
# Task P01-005: Image 模块（图像预处理管线）
|
|||
|
|
|
|||
|
|
## 元信息
|
|||
|
|
|
|||
|
|
| 字段 | 值 |
|
|||
|
|
|------|-----|
|
|||
|
|
| 状态 | `todo` |
|
|||
|
|
| 优先级 | P0 |
|
|||
|
|
| 依赖 | P01-004（Upload 模块，需要图片 URL 做输入） |
|
|||
|
|
| 分配给 | Coder AI (Trae CN + GLM-4.6) |
|
|||
|
|
|
|||
|
|
## 输入
|
|||
|
|
|
|||
|
|
**要读的文件**:
|
|||
|
|
- `docs/02_系统架构/模块设计.md` — 3.6 Image 模块（图像预处理），含 CLAHE 参数和降级策略
|
|||
|
|
- `docs/02_系统架构/总体架构.md` — 3.1 数据流中的图像预处理位置（OCR 之前）
|
|||
|
|
- `projects/app/src/modules/upload/` — P01-004 产出的 Upload 模块（获取图片 URL）
|
|||
|
|
|
|||
|
|
**参考的 ADR**:
|
|||
|
|
- 无特殊 ADR（图像预处理管线来自旧架构已验证方案）
|
|||
|
|
|
|||
|
|
**上游依赖产出**:
|
|||
|
|
- P01-004: Upload 模块（图片 URL 来源）
|
|||
|
|
|
|||
|
|
## 输出
|
|||
|
|
|
|||
|
|
**要生成/修改的文件**:
|
|||
|
|
- `projects/app/src/modules/image/image.module.ts`
|
|||
|
|
- `projects/app/src/modules/image/image.service.ts` — 图像预处理管线
|
|||
|
|
|
|||
|
|
**处理管线（按顺序）**:
|
|||
|
|
1. 透视校正（检测文档边缘 → 透视变换拉正）
|
|||
|
|
2. CLAHE 增强（对比度受限的自适应直方图均衡化）
|
|||
|
|
3. 笔迹去除（红色笔迹 HSV 自动去除，蓝色同，黑色手动标记）
|
|||
|
|
|
|||
|
|
**关键参数**:
|
|||
|
|
- CLAHE: clipLimit=2.0, tileGridSize=(8,8)
|
|||
|
|
- 输出格式: PNG（保留质量）
|
|||
|
|
- 降级策略: 任一步骤失败 → 跳过该步骤 → 用原图继续。不阻塞整体流程
|
|||
|
|
|
|||
|
|
## 验收方法
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 编译检查
|
|||
|
|
npx tsc --noEmit
|
|||
|
|
|
|||
|
|
# 功能测试（用一张含红笔批改的错题照片）
|
|||
|
|
# 预期: 输出图中红色笔迹明显减弱，对比度提升
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 约束
|
|||
|
|
|
|||
|
|
- 不碰: `projects/app/tests/`、OCR 相关模块（不属于当前 scope）
|
|||
|
|
- 技术栈: NestJS + Sharp
|
|||
|
|
- 遵循: 降级策略——不因预处理失败而阻塞
|
|||
|
|
|
|||
|
|
## 完成报告
|
|||
|
|
|
|||
|
|
> Coder 完成后填写。Commit message 以 `[READY_FOR_TEST]` 结尾。
|
|||
|
|
|
|||
|
|
- [ ] 输出文件已生成
|
|||
|
|
- [ ] 验收命令通过
|
|||
|
|
- [ ] Commit: `{hash}`
|
|||
|
|
- [ ] Commit message: `feat(P01-005): Image 模块（图像预处理管线） [READY_FOR_TEST]`
|