# 鸿蒙算法改造 - 需求沟通日志 > 文档创建时间: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. 验证测试结果 --- *文档结束*