Files
nanocode/web-opencv/cpp/docs/沟通日志.md
T
Ubuntu 32b43f85bd a
2026-07-03 16:58:28 +08:00

302 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 鸿蒙算法改造 - 需求沟通日志
> 文档创建时间:2026-03-31
> 参与方:用户 & AI助手
---
## 一、项目背景
### 1.1 项目概述
- **项目名称**:鸿蒙尿检试纸识别算法改造
- **改造范围**:仅限于 `E:\Qoder\urologist\entry\src\main\cpp` 目录下的 C++ 代码
- **技术栈**:C++ + OpenCV,通过 N-API 与鸿蒙上层交互
### 1.2 核心功能
1. 从上层 NAPI 接收图片
2. 试纸定位:根据定位块特征找到定位块,匹配 PaperConfig 规格
3. 获取反应色块的中心点位置列表
4. 读取每个化学反应色块的颜色值(HSV、LAB)
---
## 二、第一轮需求澄清(2026-03-31)
### Q1:定位块的识别特征
**问题**:
- 定位块颜色范围(HSV边界值)是什么?
- 定位块形状特征?最小/最大面积限制?
- 如何区分定位块和反应色块?
**用户答复**:
- 定位块颜色使用 RGB 分量比例判断,不用 HSV 边界值(效率考虑)
- 定位块有两种:
- 小定位块:3mm × 5mm(宽×高)
- 大定位块:10mm × 5mm 或 15mm × 5mm
- 定位块是矩形,反应色块是正方形(5mm × 5mm)
- **关键点**:反应色块可能是白色,通过 `findContours` 可能找不到轮廓
- 定位块在试纸两端,中间是反应色块
### Q2:定位失败的处理
**问题**:
- 找不到两个定位块时返回什么错误码?
- 找到多个候选定位块如何选择?
**用户答复**:
- 反应色块和定位块是对齐在一条线上的
- 找不到两个定位块 → 返回错误(参考现有 SayHello 代码)
- 找到多于2个定位块 → 直接返回错误,不做进一步处理
### Q3:试纸角度处理
**问题**:
- 最大倾斜角度?
- 是否需要图像旋转校正?
**用户答复**:
- 不限制倾斜角度
- **不做图像旋转处理**,通过几何公式和斜率计算位置
---
## 三、第二轮需求澄清(2026-03-31)
### Q4:slicesNum 计算方式
**问题**:
- "2毫米"如何转换?是否用定位块高度作为基准?
**用户答复**:
- 这是比例问题,生产单位(毫米)需转换为像素比例
- 例如:10mm×5mm 的定位块在图像中可能是 100px×50px,则放大了10倍
- PaperConfig 中的值需要乘以这个比例因子
### Q5:firstPos 和 step 的单位
**问题**:
- 这两个值是以"2毫米"还是"最小分割单位"为单位?
**用户答复**:
- firstPos = 2.25 表示:(2 + 2.5) / 2 = 2.25
- 2mm = 定位块边缘到第一个反应色块的距离
- 2.5mm = 反应色块中心到边缘的距离(5mm色块的一半)
- 本质上 firstPos 和 step 是倍数关系
- 计算时基于像素,不是毫米
### Q6:白平衡算法
**问题**:
- 使用 `Whitebalance` 还是 `WhitebalancePR`?
- 白平衡参考点如何选取?
**用户答复**:
- 参考 `reference` 目录下的代码
- **白平衡基于整个图片进行**
### Q7:颜色返回顺序
**问题**:
- 小定位块在右边时,是否从右往左编号?
**用户答复**:
- **颜色选取顺序始终从靠近小定位块的反应色块开始**
- 无论试纸怎么摆放
### Q8:采样区域大小
**问题**:
- 5毫米对应多少像素?
- 是否需要动态计算采样半径?
**用户答复**:
- 最少取 25 个像素的均值
- 可以尝试动态计算半径
### Q9:SayHello 返回值格式
**问题**:
- 返回值是否完全保持一致?
- strBuffer 格式?
**用户答复**:
- **完全一致**,上层代码不改
- strBuffer 格式:`{"id":0,"value":"h,s,v,l,a,b"}`
### Q10:测试代码运行环境
**问题**:
- Windows 独立测试程序?
- 是否支持命令行参数?
**用户答复**:
- Windows 独立命令行程序
- 告知如何运行测试程序
### Q11:误差范围参数
**问题**:
- 具体有哪些误差参数?
**用户答复**:
| 参数 | 范围 | 说明 |
|------|------|------|
| 颜色误差 | RGB欧式距离 ≤ 20 | 判断两个定位块颜色是否相同 |
| 面积误差 | 10% | 上下限范围 |
| 距离误差 | 10% | 上下限范围 |
| 角度误差 | 15° | 倾斜判断 |
- 这些参数用全局变量定义,方便调节
### Q12:需要支持的试纸规格
**问题**:
- 支持哪些规格?
**用户答复**:
- **只支持 14联、11联、8联**
- 每种联数支持两种大定位块(10mm 和 15mm)
- 共 6 种 PaperConfig
### Q13:PaperConfig 参数
**问题**:
- 其他规格参数如何计算?
**用户答复**:
- 参考现有 `initPaperConfig` 函数
- 只实现 14、11、8 联的支持代码
---
## 四、第三轮需求澄清(2026-03-31)
### Q14:图片格式和来源
**问题**:
- 是否支持 NV21/YUV 格式?
- 测试程序是否需要支持 NV21?
**用户答复**:
- **不需要支持其他格式**
- 测试只用 PNG/JPG
- 没有 NV21 测试数据
### Q15:ROI 区域
**问题**:
- 是否需要从大图自动搜索试纸位置?
**用户答复**:
- 输入已经是裁剪好的 ROI
- `11green_1.png` 等文件大小与实际传递的图片差不多
- 裁剪来源:`savePaperImg` 函数产生的外包矩形
### Q16:白色反应色块的处理
**问题**:
- 白平衡后白色色块的 RGB 如何解释?
**用户答复**:
- 澄清:反应色块可能颜色很浅,findContours 可能找不到轮廓
- **核心原则**:化学反应色块的位置通过两个定位块**计算得出**,与反应色块本身的位置无关
- 计算的位置可能与实际中心点有偏差
### Q17:定位块的亮度变化
**问题**:
- 深红 vs 浅红如何判断?
**用户答复**:
- 深红、浅红都是红色 → R分量 > G、B分量
- **增加欧式距离判断**:
- 如果两个定位块一个是"深红"、一个是"浅红"
- 欧式距离可能超过20 → 判定为不符合要求
### Q18:颜色输出格式确认
**问题**:
- HSV 和 LAB 精度?
**用户答复**:
- **保留2位小数点**
### Q19:还原图片的格式
**问题**:
- 图片格式?分辨率?
**用户答复**:
- 格式:JPG
- 分辨率示例(14项红色试纸):
- 试纸高度:50像素
- 小定位块:30px宽 × 50px高
- 反应色块:50px × 50px
- 大定位块:100px宽
- 间隔:20像素
- 总图:200px高 × 1000px宽,试纸居中
---
## 五、最终需求确认
### 5.1 核心业务规则
| 规则 | 内容 |
|------|------|
| 定位块识别 | RGB分量比例判断 + 欧式距离验证(≤20)|
| 试纸规格 | 仅支持 14联、11联、8联,各有大小定位块两种 |
| 颜色顺序 | 始终从靠近小定位块的色块开始编号 |
| 采样方式 | 以计算的中心点取至少25像素均值 |
| 白平衡 | 基于整图进行 |
### 5.2 全局误差参数
```cpp
// 颜色误差:RGB欧式距离阈值
const double COLOR_DISTANCE_THRESHOLD = 20.0;
// 面积误差:10%
const double AREA_ERROR_RATIO = 0.10;
// 距离误差:10%
const double DISTANCE_ERROR_RATIO = 0.10;
// 角度误差:15度
const double ANGLE_ERROR_DEGREE = 15.0;
```
### 5.3 返回值格式
- 保持与现有 SayHello 完全一致
- strBuffer JSON格式:`{"id":0,"value":"h,s,v,l,a,b"}`
- 颜色值保留2位小数
### 5.4 测试要求
- Windows 独立命令行程序
- 测试图片:`images/` 目录下的 PNG/JPG 文件
- 输出:
1. 识别成功/失败状态
2. 标注定位块和色块中心的红圈图片
3. 颜色值文本文件(HSV、LAB、RGB)
4. 还原生成的试纸模拟图片(JPG,200×1000像素)
---
## 六、沟通结论
**需求已完全澄清,双方达成一致意见。**
下一步:
1. AI 编写技术方案文档
2. 逐步实现代码
3. 编写测试程序
4. 验证测试结果
---
*文档结束*