Files
ai_soc_sw/.ai/tasks/active/P01-005.md
T
tupingr 6992f59cd2 refactor(arch): 信息架构升级 — 三层四角色控制面板 + 跨平台 task 交接协议
核心变化:
- dashboard.md 替代 DASHBOARD + ROADMAP,人类+Arch AI 唯一入口
- DECISIONS.md 人类决策入口,≤3 条待决策
- .ai/tasks/ 14 个独立 task 文件(Coder 8 + Tester 6),弱模型自包含可独立执行
- 旧 today/queue 归档,每个角色启动 ≤2 个文件
- ADR-012 跨平台「高模型指挥小模型」协作架构落地
- 知识库补全:L-002~005、P-004~005、ADR-011~012
- Arch AI 上下文资源管理硬约束写入 principles.md

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 15:17:06 +08:00

2.0 KiB
Raw Blame History

Task P01-005: Image 模块(图像预处理管线)

元信息

字段
状态 todo
优先级 P0
依赖 P01-004Upload 模块,需要图片 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(保留质量)
  • 降级策略: 任一步骤失败 → 跳过该步骤 → 用原图继续。不阻塞整体流程

验收方法

# 编译检查
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]