当前版本说明 / 2026-10-23
当前主板：54e14f5cf8418cd61265d4d93b6738dc6233a286f1bdb13755e28bc5ba94d473
当前MCU重建：1005858a9f870bac5032b86474e8fb0223ff361a40dc9c483f5f325c5ad0b0be
当前诊断source：99d4cdf37a4275eafc345671ba836f133ce7e6e984264ce9593514606e03fcfc
当前V4操作页/type-B触摸桥接源码已纳入，未完成目标BSP/真实硬件联调。当前测试以Evidence/Current-PCB-Revision/SOFTWARE-CHECKS.json为准。
下文是此前集成阶段的累计记录，所列旧测试数量、旧版本身份及当时待办不能覆盖本说明。旧字节保持用于追溯。本轮运行控制逻辑和AI模型未改；仅同步PCB/合同/编译身份并修正清单绑定与校验。

--- 历史集成记录 ---
摄像头/AI/显示传输集成候选

接口：preview_service_startup.build_preview_session 显式组合显示进程、背光、采集、推理和UART。沿用原始V4L2曝光时间、颜色格式及40ms处理期限检查。只有校验通过的帧才进入预览。run_service.main与start_target现已支持成对传入display_factory和backlight_factory，进入相同配置校验、目标资源创建及服务生命周期；缺少任意一项会提前拒绝。BSP的启动程序必须提供已验证的真实后端，直接CLI仍保留原有路径。没有猜测设备节点、PWM路径或引脚，BSP生产启动程序尚未冻结。

内存/实时性：采集线程非阻塞投递不可变bytes引用，最多一个待消费帧，忙时丢帧，不复制大帧或等待显示。显示线程持有进程、复制帧并发送；已开始的帧必须完成协议包或失败关闭。100ms半包超时及40ms旧帧消隐保留。Python线程、GIL、内存释放和Linux调度没有硬实时上界证明；目标峰值内存、CPU及延迟仍需测量。

修复：固定每次泵送后休眠1ms时，实际5MP帧可能无法在100ms接收期限内送达。改为尚有未发送字节时等待socket可写，随后继续有界泵送；空闲时休眠。等待只在显示线程。

验证：BUILD-HOST-WORKER.py 从所附C源码重建假fbdev后端进程；RUN-HOST-TESTS.py 共110项主机测试。包括完整2592x1944 NV12（7558272字节）在真实子进程接收后的回读、原曝光戳、像素引用、填充尾部、锁竞争丢帧、完整组装关机确认、背光启动失败、显示清理失败和线程关闭超时。假fbdev trace仅用于测试，不证明实际屏幕显示。

关机：背光关闭、显示资源释放、相机/推理释放及只读存储检查均需成功。线程超时或清理失败锁存错误，拒绝关机就绪ACK。照射选择算法、MCU及充电资格锁未放宽。

复现：python3 -B BUILD-HOST-WORKER.py；python3 -B RUN-HOST-TESTS.py。libnail_inference.so已按Native-inference内可编辑C源码和固定版本配方重新编译；libnail_select.so沿用前序输入。主机检查不执行真实RKNN/NPU。

待完成：RV1106启动配置、实际相机ISP与时间戳、真实模型推理、真实fbdev/VT、PWM后端和背光时序、目标内存/调度/性能、光学校准及整机验证。不放行打样或量产，不安装、不烧录、不启动设备。

启动故障注入：单侧接口缺失、不可调用接口、灯板版本过期、目标NativeSession初始化失败均拒绝启动；失败时释放已创建的显示和背光，不打开UART。完整目标构造适配路径使用主机替身验证了采集、预览、清理与关机ACK。

2026-10-22：CaptureInference原有Python逐像素any循环替换为bytes.strip二值完整性检查；长度/类型、颜色、原曝光和40ms逻辑期限检查全部保留。新增5项真实回调主机测试含1016组异常字节位置、16种合法4像素掩膜、类型/长度、5MP前中后坏像素和期限越界。主机回调对比使用合成图像/推理输出和固定逻辑时钟，不能代替目标采集/NPU或实时期限验证。

本轮标定准备优化：精确frozenset数据使用紧凑uint32数组和from_buffer共享存储；密集坐标用图像范围临时索引，稀疏坐标用二分查找，保留原C接口及子类兼容路径。新增8项主机测试实际编译并执行原C选择函数，对比独立Python参考，验证密集/稀疏/重叠、存储生命周期、参数及缓存。该标定存储优化未改动选择器原生C源码和二进制；本轮另行更新的是推理预处理库。内存对比仅计Prepared构造的增量tracemalloc，不证明完整128MB目标预算。

2026-10-23 预处理一致性与版本校验审查
此前主交付仍带旧整数中心采样库，已替换为与训练时Pillow13 RGB NEAREST有序binary64采样一致的实现。BT601 limited RGB与保守掩膜回映射策略保留。模型合同升级v2，绑定预处理源码和实际ARM库哈希；配置与NativeSession在设备初始化前拒绝旧合同或不匹配运行库。实际RKNN V4模型收录于models，只作开发候选，不提供已批准的109路标定、自动运行配置或照射许可。
Native-inference提供C源码、原厂SDK参考、固定版本编译配方和主机回放。当前增补候选已使用固定厂商GCC8.3.0和其sysroot构建ARM32显示程序及原生推理库，严格链接RKNN并核查依赖闭合；旧Zig配方仅保留作参考，仍未实机运行。实际SDK/BSP接口、原生张量NHWC布局/量化参数/归一化、加载、速度、内存及准确率仍需目标验证；不根据桌面ONNX布局推断实际native布局。SDK参考文件的量产再分发许可未确认。
Pillow13 RGB参考图索引覆盖2..4096全部偶数边长；4100组NV12字节对比含填充stride、分辨率变化及真实尺寸合成帧。两项C程序在ASan/UBSan下验证像素与SDK故障替身；禁止fast-math。冻结采样图便于新版Python回放，不得悄悄按其他Pillow版本重生。

2026-10-23触摸输入后端
新增touch_input.py及显式run_touch_probe.py，55项新主机测试；尚未接入产品操作页面、显示预览进程或MCU按钮命令。实际BSP/input_event ABI、GT911驱动、真实坐标校准和延迟未验证。原推理/permit/关机与显示后端字节不变，不能把触摸模块测试当作全功能HMI或实机完成。详见触摸输入与上板验证.txt。

2026-10-23 运行异常与触摸边界复核

本轮确认并修复两处软件缺陷：
1. 预览线程出错后停止mailbox，原推理回调把停止与锁竞争都当作普通丢帧，仍能返回分割结果。现在采集前及返回前检查停止锁存；发生此故障时，回调失败，SerialLink.transact清除pending并关闭UART，不发送本次许可。正常锁竞争仍允许丢弃预览，不阻塞40ms路径。
2. 同一SYN_REPORT事件批次中，手指滑出再返回原位置时，原识别只检查最终位置，可能生成点击。现在保留此前已报告触点的批次内中间坐标；任何位置超出12像素容差即取消本次手势。新触点仍等完整X/Y报告后开始，事件数量保留256项上限。

12项新增故障/边界测试在原版复现8项失败，修正版全部通过；当前完整视觉软件177项主机测试通过。归档后另行独立解包重测。测试使用主机替身和合成事件，没有实际GT911、屏幕、相机或NPU运行证据。

显示失败到最终发送仍存在并发观察窗口；已发送许可由MCU独立50ms期限撤销，不能宣称立即物理关灯。本轮未修改选择算法、串口协议、MCU、原生库、模型、八板CAD/CAM、采购表、机械源和UV/充电资格锁。

仍未完成：完整操作界面与MCU按钮连接；实际BSP和相机/GT911/显示/NPU联调；产品相机数据、109路光学校准与移动关灯实测；当前八板整机结构及屏幕固定/FPC；工厂DFM、供料和实际报价。保留所有实机、打样及量产放行状态为未通过。

2026-10-23 MCU相机帧到照射状态机连接修正

确认的缺陷：原主循环将V3租约掩膜和年龄复制到permit，但没有复制calibration_id与已接受帧序号。真实UART中断/主循环故障回放中，V3报文成功接受后，状态机仍读到标定ID=0、sequence=0；这会妨碍后续有资格配置下的曲线身份核对和至少3个不同帧确认。

修正：租约记录真正已接受的64位nonce，nail_wire_snapshot集中导出有效标定ID、已接受帧标记、原始挑战剩余期限与掩膜。16位sequence只用于相邻帧去重，认证继续使用完整64位epoch/nonce；没有用新的挑战编号替代已接受帧，也没有因轮询重置期限。主循环使用同一单调时刻生成快照和检查年龄，覆盖SysTick低32位回绕。拒绝/过期/空掩膜不会提供有效许可。

检查：原版新增frame_binding_first故障回放失败，修正版7项新主循环场景通过，主循环共65项；20项新增C解析/适配/状态机测试在ASan/UBSan下通过，覆盖重复帧、新挑战未回包、真正新帧、身份/CRC/回放/超时、序号和低32位回绕，以及未配置时拒绝运行。17项诊断工具、177项视觉主机测试、4100组预处理回放、两项原生C故障/内存检查及诊断队列检查通过。独立解包后重建及重复检查另见归档回读收据。

20项C测试中的健康温度/配置/曲线是仅存在于主机测试程序的合成输入，不是产品实测资格，不进入目标程序。真实board.c仍保持configuration_verified=false、无合格曲线、热/电源资格缺失和UV/充电锁定；未在硬件运行、未烧录、未照射、未下单。

当前MCU构建校验SHA256：b2221b77d29dce248d837081a4afcde89e07e5064499195c13d98275d7ce292d
当前诊断source SHA256：e2686565e7de1e7ce45bb769b14c7c9fb88785d30224a05a013e958115cb9129
这两项身份已经同步到MCU构建记录、Tools诊断身份和Vision配套字段；归档只提供工程源码，不附烧录放行镜像。原八板CAD/CAM、BOM及配件表、结构源、模型和原生库字节不变。

仍需完成：完整HMI与MCU启停/模式协议连接；实际目标BSP、相机/GT911/屏幕/NPU联调；受控配置与实测曲线、109路光学及移动关灯验证；屏幕固定/FPC和当前八板整机装配；工厂DFM、供料、报价及1000台成本/良率确认。不能把主机检查或构建成功视为实机、打样或量产放行。

2026-10-23 V4操作请求协议与MCU连接

已实现并接入两端源码：MCU自动调度V4挑战，回传真实状态、错误、模式、资格观察位及剩余时间；Python有界请求槽通过同一挑战的epoch/nonce发送B/F/T、开始或停止请求。请求经真实MCU UART解析后交给实体按键处理和原照射状态机。当前start_target默认创建V4 Producer和session.operator，关机及服务退出会清除请求槽。

模式请求不会启动照射；运行期间不切模式；实体按键优先；停止请求不采集图像且照射掩膜为全0；开始必须随本次正常图像结果发送并通过MCU独立健康检查。重复/错误版本/错误CRC/过期包不能产生新动作。UI不写配置、曲线或光学资格，不把排队/写串口成功当作照射已开始。原50ms租约保持，不宣称已证明物理即时关灯。

检查：81项MCU主循环场景（本轮新增16项），28项C解析/状态机ASan/UBSan测试（新增8项），209项视觉主机测试（新增32项），17项诊断工具、4100组原生预处理回放及原有内存/故障检查通过。Python/C互相收发实际编译解析器的二进制报文，另含真实主机PTY测试；这些都不等于产品UART或目标硬件联调。独立解包再构建及复测见回读收据。

构建静态资源：相对前版text增加624字节、data增加0、bss增加24字节；当前text/data/bss为31932/20/6432字节。仍使用原MCU和原八板BOM，没有为本接口增加元件。这是链接统计，实际栈高水位、Linux内存和目标实时性未测，不能据此给出已确认的量产单价。

当前MCU构建校验SHA256：ffbf77ec7406ef55d7255b59770c45e468b76f86fdcc8ddf87dbb3224f969196
当前诊断source SHA256：96198714f72be82e6bd808ce5947f5933d3d3334c090c4c7d4db7e3ff3d58ce9
MCU、Tools、Vision和交付元数据已配对。必须成套使用当前V4软件；V3视觉端不自动降级兼容当前V4自动调度固件。V3关机28/43字节握手保留。归档提供工程源码，不附烧录放行镜像。

尚未完成：真实触摸手势到请求槽的自动接入、屏幕操作页面绘制及交互验收；实际BSP/相机/屏幕/GT911/NPU/UART联调；受控配置和实测曲线、109路光学/动态关灯；当前八板整机结构、屏幕固定/FPC；工厂DFM、供料、报价、1000台工艺与成本/良率。当前工程固件的配置/曲线/温度/电源资格锁仍未放开，未安装、烧录、启用UV或下单，不作Apple认可或量产放行声明。

接口与线格式详见Vision/操作请求接口与V4协议.txt。

2026-10-23 原生操作页、触摸与V4请求链交付

新增1024x600原生C操作页及完整软件接入路径：连接/模式/MCU倒计时、相机缩略图、B/F/T、独立START/STOP；真实TouchReader解码与抬手命中经OperatorBridge进入前轮V4请求链。只有显式提供真实BSP触摸工厂时启用HMI，不猜设备节点、ABI或方向。配置/曲线资格未满足仍禁用开始，所有MCU资格锁保持。

按下/抬手跨按钮、拖动、多指、丢事件、页面模式变化不产生请求；状态过期/VT丢失/显示退出时禁用输入；恢复后重新查询内核all-fingers-up，不把旧按住动作当作新点击。C工作进程反馈已呈现的状态与可见性；模式/倒计时取MCU，不因请求排队而提前改变。触摸关闭失败不能得到干净关机ACK。

主机检查：232项视觉软件测试（新增23项），6项原生C绘制ASan/UBSan检查，4个ARM32 Linux参考对象编译。主机端F/STOP触摸事件经实际TouchReader和原生显示工作进程到请求槽；完整start_target构造/关闭/ACK成功与失败路径使用相机、背光、UART和触摸替身。macOS host-mock改用与CPython相同的mach_absolute_time，Linux仍用CLOCK_MONOTONIC，没有放宽年龄门槛。

目标接口/资源：C绘制复用原framebuffer scratch，另有408x160x4缩略图缓存（261120字节）及107083字节冻结字模alpha。目标不需浏览器/Pillow/字体运行库；Inter源字体、OFL、固定输入哈希和生成配方随包。显示/触摸在独立所有者线程，UI状态最多20fps、预览最多10fps；没有目标CPU/内存峰值、栈或实时性能证明，仍需实测。

本轮原八板CAD/CAM、BOM/配件表、机械、MCU源/BIN、Tools、模型及原生推理库字节不变。81项MCU主循环、28项C协议/控制器、17项诊断工具和4100组预处理回放的当前配套复核见软件收据。MCU BIN保持ffbf77ec7406ef55d7255b59770c45e468b76f86fdcc8ddf87dbb3224f969196；未烧录、未照射、未下单。

图像为同一原生C渲染器生成的主机预览，使用模拟MCU状态、无真实手部图像，不是目标屏幕拍摄。参考对象编译不是实际BSP链接/运行。源码路径完成不代表实机HMI合格。

仍需：真实BSP/GT911方向/屏幕色彩与VT/相机/NPU/UART/ADIM/存储掉电、触摸与可读性交互验收；真实产品相机、合格曲线与109路光学/动态关灯；当前八板整机/屏幕固定/FPC；工厂DFM、供料、报价及1000台工艺/良率/成本确认。所有物理、打样及量产放行标志保持false。
入口：Vision/操作页与触摸集成.txt；BUILD-TARGET-WORKER.py要求明确的ARM32 Linux BSP编译器，当前没有执行该实际BSP构建。
