服务边界说明书

适用范围与阅读方式

本说明书适用于敏洽承接的非标工控软件定制、机器视觉检测软件、SCADA 数采与监控软件、 工业物联网平台类项目，作为技术协议或合同的附件使用。 具体项目如与本说明书条款不一致，以双方签署的技术协议为准。

三块内容的含义：「敏洽负责」是敏洽承担人力与责任、包含在报价内的工作； 「客户负责」是需要客户或其指定施工方完成的前置条件与配套工作， 未完成会直接阻塞软件调试；「共同确认」是必须在开发启动前由双方书面确认的参数与口径， 确认结果一旦冻结，任何一方变更都走书面流程。

交付物可白标（不出现敏洽标识），也可按客户模板输出文档，这一点不影响本说明书的责任划分。

三、共同确认

以下事项无法由单方决定，必须在开发启动前书面确认并冻结。确认文件作为技术协议附件， 也是验收判定的唯一依据。

1. 功能清单与点表

共同确认软件功能清单（界面、报表、权限、接口逐项列出）与点表版本。 清单之外的功能不在报价范围内；点表冻结后新增点位或改地址走书面变更， 并同步评估工时影响。变更记录需注明日期、变更人、原因与受影响的画面与报表。

2. 协议适配的可行性

协议适配的前提是设备侧开放且可用的通信通道。开发前需共同确认： 设备是否具备通信接口与相应授权（部分进口设备需厂商开通选件或提供动态库）、 协议文档是否可获得、是否需要设备厂配合改程序。

若设备完全封闭、厂商拒绝提供协议且无授权途径，属于客观不可实现， 双方需另行商定替代方案（如加装传感器、读取信号灯、离线导出文件解析）， 替代方案的硬件与安装仍属客户范围。相关判断可参考 进口设备协议不开放怎么办。

3. 算法效果指标

视觉与算法类项目须在样品测试阶段共同确认可达成的指标，包括：判定标准（什么算不良、 临界样品如何判）、漏检率与过杀率的目标值及计算方式、 节拍要求、以及测试所用样品集的构成与数量。

指标以经双方确认的样品集与工况下的测试结果为准。 敏洽不对未参与测试的样品类型、变更后的工艺或超出确认工况的条件承诺同等指标。 工件材质、表面处理、光照环境、来料状态发生变化时，需重新取样评估并另行商定整定工作量。 成像方案本身的物理可行性（分辨率、景深、对比度是否足以分辨缺陷）在样品测试阶段判定， 判定为不可行时不进入开发阶段。

4. 数据准确性的责任分界

敏洽负责从采集点到数据库与报表的传输、解析与计算过程正确： 即按确认的点表与口径，采到的原始值不失真、缩放与聚合运算无误、断网期间可缓存补传。

以下情形不属软件责任：仪表或传感器本身精度与校准问题、PLC 内数据本身错误、 接线松动或干扰导致的数值跳变、客户单方面改动地址或程序、 以及因口径理解差异导致的「数字对不上」（口径以共同确认文件为准， 参见 OEE 计算口径）。 出现数据争议时，以数据库中的原始值与采集日志作为核对起点，先定位失真发生在哪一段链路。

5. 写入类操作的授权

软件向设备写入参数或指令（配方下发、启停控制、阈值修改）涉及实际动作， 需共同确认写入点清单、触发条件、允许范围、握手方式与失败处理， 并由设备方书面同意。设备侧的安全连锁与极限保护由设备方保证， 软件不作为安全功能的实现载体。

6. 验收判定标准

验收前共同确认验收清单：测试项、测试方法、判定标准、测试样本量、测试时长与执行人。 判定原则是逐项对照已确认的功能清单与指标， 清单内全部通过即视为验收合格；清单外的期望不作为不合格依据。

若因客户侧前置条件未就绪（设备未到位、产线无法停机、样品不足、上层系统未开放接口） 导致部分项目无法测试，可就已具备条件的部分先行验收，其余项目约定补验时间并记录原因。 验收记录由双方签字，作为质保期起算依据。