← 返回技术文章

技术文章

科研技术服务通常交付什么?项目验收清单

科研技术服务验收不应只有演示结果。本文列出代码、模型、数据、环境、测试、软件、设备和文档等交付物及验收证据,支持后续复现和维护。

Read the English version

科研技术服务的交付不应只有一个演示结果或报告文件。可维护、可复现的项目通常需要同时交付源代码、模型与配置、数据记录、运行环境、测试证据、软件或设备资料、技术文档和知识转移材料。具体清单应在项目启动时确认,而不是在结束时临时补写。

按成果类型设置交付目录

成果类型建议交付物主要验收证据
源代码目录、依赖、构建脚本、接口和许可证从干净环境构建并运行
算法与模型配置、权重、训练记录、推理代码和版本在约定样本上复现指标
数据数据字典、来源、处理记录、版本和授权边界抽样核对字段、数量和处理链
实验与评测测试集、指标公式、基线、日志和误差分析独立运行评测脚本并核对结果
软件与接口安装包、接口文档、权限、日志和异常处理按用户流程完成测试用例
机器人与设备标定、接线、通信、地图、参数和运行步骤在约定工况执行测试
部署与运维环境清单、部署脚本、备份、监控和恢复说明在目标环境完成部署与恢复演练
项目文档需求、方案、里程碑、变更、测试和验收记录文档与最终代码和配置一致

复现验收比现场演示更重要

现场演示只能证明当时环境中的一次运行。复现验收要求项目单位或双方指定人员按照文档,在约定环境中从输入数据运行到输出结果,并核对版本、参数、日志和指标。对于随机训练或不确定性较高的过程,还应约定重复次数和允许波动范围。

如果某些步骤只能由开发者个人完成,说明知识尚未真正交付。应将隐藏依赖、手工操作、账号权限和外部服务写入环境与操作说明。无法复现的部分应明确列为限制或待办,不能用截图替代。

测试证据需要对应实际使用场景

指标只对文章或报告中记录的样本、环境和版本有效。把受控测试结果直接解释为所有现场表现,会扩大结论边界。验收报告应同时记录通过项、条件通过项、未通过项和未验证项。

  • 记录测试样本的来源、版本、范围和排除条件;
  • 说明指标公式、阈值、基线和统计口径;
  • 保留失败样本、异常日志和原因分类;
  • 区分离线评测、仿真、台架、样机和现场结果;
  • 写明未测试的设备、环境、数据和性能范围。

知识产权和第三方依赖也属于验收内容

项目需要明确自研代码、项目单位原有材料、开源组件、商业软件、预训练模型和数据集的来源与许可。源代码交付不表示第三方资产的权利自动转移;可复制、可修改和可部署的范围应以许可证和合同为准。

账号、密钥、证书和设备授权不应直接写入源代码或公开文档。交付时应通过受控方式移交,并记录更换、吊销和保管责任。对于无法随项目转移的外部服务,应给出替代方案或持续费用说明。

验收后还需要完成知识转移

维护边界需要可执行。应区分原范围缺陷、新需求、环境变化和第三方升级,并为每种情况约定处理方式。这样项目单位才能在人员变化后继续运行,而不是长期依赖某个开发者的个人环境。

  • 项目结构、关键设计决策和已知限制说明;
  • 常用运行、配置、数据更新和故障排查演示;
  • 维护人员权限、备份、监控和日志位置;
  • 缺陷处理、需求变更和支持期限;
  • 最终版本、哈希、交付清单和签收记录。

常见问题

只交付源代码是否足够?

通常不够。还需要依赖、环境、配置、数据说明、测试证据和运行文档,否则项目单位可能无法构建、复现或维护。

验收指标应在什么时候确定?

应在开发前或可行性验证后尽早确定。项目结束时再定义指标容易造成样本、范围和责任争议。

无法公开的数据如何验收?

可以在授权的受控环境内运行评测,保留哈希、统计摘要、脚本、日志和签字记录,不必把原始数据写入公开材料。

下一步

可在项目启动阶段使用本文清单确定交付目录、复现步骤和验收证据;已有项目也可据此开展交付缺口审查。