进度:记录 FillLaserPoint 修正与管道重定向下收尾段错误的已知怪癖

docs/PROGRESS.md

@@ -1,5 +1,26 @@
 # VizumCameraKit 进度
 
+### 2026-07-05 点云栅格化修正:启用 SDK 激光点填充
+
+Scope:
+- CapturePointCloudWithAutoDetect 在 BeginDetectLaser 后新增
+  `VzNL_EnableFillLaserPoint(handle, VzTrue)`(VZNL_DetectLaser.h:307,SDK 默认不填充)。
+- 根因:默认模式下每条激光线只回传检出点、长度不一,软件侧左对齐拼 W×H 网格时
+  列向错位(同列不代表同横向位置)。启用填充后 SDK 输出定长线(无测量处填占位点),
+  回调侧 scanLine 本就保留全部点,网格自然列对齐,MatchVerify 的 cloud.txt 栅格随之正确。
+
+Verification:
+```
+kit 与 MatchVerify 重编译通过;kit_smoke 终端运行退出码 0 全流程正常。
+待实机:采一次点云,确认日志"收到扫描线 N 个点"各线等长、cloud.txt 网格列对齐。
+```
+
+Known quirk(与本次改动无关,业务无影响):
+- kit_smoke 在 stdout 重定向到管道(>/dev/null 或 >file)时,业务流程完整跑完
+  ("SDK destroyed"已打印、main 已返回)后进程收尾阶段段错误(139);
+  终端直跑恒为退出码 0。疑为 VzNL DLL 卸载时其日志组件写已关闭管道所致。
+  GUI 程序不受影响;自动化脚本调用 kit_smoke 时以日志内容而非退出码判断成败。
+
 ### 2026-07-05 模块建立(从 Mark3DCalibration 毕业)
 
 Scope: