流式细胞仪软件测试问题反馈（2016.12.11）
来源：CyteCluster 流式细胞仪用户软件测试阶段问题反馈表（问题反馈12.11.xlsx，1.8MB，主表 239 行含 13 张内嵌截图）。这是 2016 年 12 月调试软件测试期间的现场反馈记录，与 流式细胞仪通讯协议说明书-V1.0-含工作模式、流式细胞仪通信协议-20171124版 同属液相芯片（流式细胞仪）项目 09 测试与改进阶段材料。
反馈的 5 个问题
- 开始/停止按钮语义问题：点”开始/停止”按钮时只运行了泵阀，但没有启动数据采集。即按钮只联动了液路控制单元，未联动采集链路——按钮行为与用户预期的”开始采集”不一致。
- 圈门（门）无法改动 + 页面不刷新导致图形重叠：门（gate）无法修改；用”项目采集区”采集到的数据在图形页面不会自动刷新，导致新旧图形重叠显示。
- 所出模板正确性问题：软件输出的分析模板是否与标准模板一致，待核对。
- 项目登记与模板联动疑问：检测项目选择登记后，“项目模板采集”页面是否应同步显示相应的项目模板图（产品逻辑确认项）。
- 流量传感器读数 BUG（本轮重点，有完整复现记录，见下）。
流量传感器 BUG 复现记录
复现条件结论：操作顺序决定是否出错。
- 正常操作（先点”开始”，再点”结束”）：测试正常，流量传感器读数正确。
- 非正常操作（不点”开始”，直接点”结束”）：流量传感器读数不正确，出现文字 BUG（读数显示为文字而非数值），且软件异常，需要重启仪器才能恢复。
对照实验数据（同一状态下 5s 记录 vs 30s 记录的传感器原始数值）：
| 序号 | 5s记录值 | 30s记录值 |
|---|---|---|
| 1 | 1191 | 7209 |
| 2 | 1339 | 7338 |
| 3 | 882 | 7059 |
| 4 | 1478 | 7436 |
| 5 | 886 | 7357 |
| 6 | 1469 | 7261 |
| 7 | 951 | 7385 |
| 8 | 1359 | 7078 |
| 9 | 1165 | 7494 |
| 10 | 1333 | 7310 |
另有验证：连续测量 20 组数据，没有较大偏差，也没有出现读数为文字的 BUG——说明传感器本身采样稳定，BUG 出在软件对”未经开始流程直接结束”这一状态机的处理上。
工程推断：软件在”结束”处理中读取流量统计（对应通信协议中的”结束统计流量”帧），若从未收到”开始”指令，统计变量未初始化，解析出的字节被当作文本渲染。修复方向：结束指令前应校验会话状态/初始化统计缓存。（推断，待确认）
图形界面问题（截图标注文字）
表格内嵌 13 张截图，形状标注文字包括：
- “同样的细胞改增益前后图。“（增益调整前后的散点图对比，约第 48-51 行）
- “门消失了，但实际操作是对门内的细胞再进行细分。“（门消失 bug 的实际语义说明，约第 73 行）
- “连续测量20组数据，数据没有较大偏差。也没有出现读数为文字的BUG”
- “按正常操作，先点开始，再点结束，测试正常，流量传感器读数正确。”
- “按非正常操作，不点开始，直接点结束，流量传感器读数不正确，出现BUG。需要重启仪器才能使软件正常。”
截图分布锚点：image1→row3（模板问题）、image2→row10（流量表）、image10-13→row48-73（门/增益问题）、image6→row112、image7→row168、image8-9→row240-253。
可行动点（历史视角，供后续版本参考）
- 状态机健壮性：任何”结束/统计”类指令必须能在”未开始”状态下安全失败，不得读到未初始化数据。
- 圈门对象生命周期：切换采集页面时 gate 不应丢失；项目采集区数据推送后图形页需订阅刷新事件。
- 开始/停止按钮应同时驱动液路与采集，或在 UI 上明确区分”液路运行”与”数据采集”两个动作。
关联
- 流式细胞仪通讯协议说明书-V1.0-含工作模式 —— 本文 BUG 涉及的开始/结束/统计流量指令定义
- 微流控化学发光中位机通信协议-20190903机械臂速度版 —— 同团队后续项目的同类协议
- CyteCluster流式细胞仪用户软件用户手册 —— 被测软件的正式发布文档