1. 课程导入
Jetson 系列模块（如 AGX Orin、Nano、Xavier NX）在边缘计算、机器人、智能视觉等领域的应用已从原型验证走向规模化落地。然而，许多开发团队在完成算法调试和功能验证后，往往在“项目交付”环节暴露出严重问题：模型文件散落在开发机中、依赖库版本不一致、镜像无法在其他设备上复现、验收时拿不出可量化的性能报告。本课程正是围绕这一痛点，系统讲解 Jetson 项目从开发完成到客户验收的全流程规范化方法。我们将明确交付物清单、镜像制作规范、模型序列化与版本管理、脚本自动化、验收报告编写等核心环节，帮助学员建立一套可复用、可追溯、可审计的交付体系。
1.1 Jetson项目交付的整体流程
Jetson 项目交付并非简单的“把代码拷给客户”，而是一个包含环境固化、产物标准化、验证闭环和文档沉淀的系统工程。一个规范的交付流程通常包含以下五个阶段：
- 交付规划：明确交付范围、目标硬件型号（如 Jetson AGX Orin 64GB）、软件基线（JetPack 版本、CUDA 版本）、客户使用场景（开发调试 or 生产部署）。
- 环境固化：将开发环境中的操作系统、驱动、CUDA/cuDNN/TensorRT、Python 依赖、系统配置等打包为可复现的镜像或容器。
- 产物标准化：将训练好的模型转换为 TensorRT 引擎或 ONNX 格式，并附带版本号、输入输出规格、精度校准信息。
- 验证与调优：在目标设备上执行功能测试、压力测试、性能测试，记录关键指标（如推理延迟、吞吐量、功耗）。
- 文档与签收：编写验收报告、用户手册、FAQ，组织客户现场验收，完成技术培训和签收确认。
整个流程的核心思想是“可复现性”——任何一位新工程师拿到交付物后，都能在 2 小时内搭建出与开发环境一致的运行环境，并复现验收报告中的性能数据。
1.2 交付物清单详解
根据 NVIDIA 官方推荐及行业最佳实践，Jetson 项目的标准交付物清单如下表所示。每项交付物都有明确的格式要求和验收要点。
| 类别 | 交付物 | 格式/规范 | 验收要点 |
|---|---|---|---|
| 系统镜像 | SD 卡镜像 / eMMC 镜像 / 容器镜像 | .img（可烧录）、.tar（Docker）、.sbom（软件物料清单） | 可在同型号设备上直接烧录启动，预装依赖完整 |
| 模型文件 | 推理引擎 / 权重文件 | .engine（TensorRT）、.onnx、.pt、.wts | 附带输入输出张量说明、精度（FP16/INT8）、校准数据集描述 |
| 部署脚本 | 安装脚本、启动脚本、服务配置 | .sh、.service、.yaml | 脚本可重复执行，无交互式输入，日志输出完整 |
| 依赖清单 | Python requirements.txt、apt 包列表、JetPack 版本 | .txt、.csv、.json | 版本号精确到小版本，注明来源和安装方式 |
| 验收报告 | 性能测试报告、功能测试报告 | .pdf / .md / .xlsx | 包含测试环境、测试方法、原始数据、结论分析 |
| 用户手册 | 部署指南、API 文档、常见问题 | .pdf / .md / .rst | 步骤清晰，含截图或命令示例，覆盖典型故障 |
| 源码与配置 | 应用源码、配置文件、Dockerfile | Git 仓库 / 压缩包 | 代码有版本标签，配置文件不含路径 |
| 测试日志 | 系统日志、应用日志、性能监控数据 | .log、.csv、.json | 时间戳完整，关键事件有记录，可追溯异常 |
在实际项目中，交付物清单应在项目启动时与客户共同确认，避免后期因“交付物理解不一致”产生纠纷。例如，某些客户可能要求提供 Dockerfile 而非完整镜像，或者要求附带模型训练代码而非仅推理引擎。
1.3 验收标准与评估维度
验收标准是交付质量的“标尺”。根据 NVIDIA 合作伙伴项目的经验，Jetson 项目验收通常从以下六个维度展开：
- 功能完整性：所有声明的功能特性均已实现，边界条件处理正确（如空输入、异常图像、网络中断）。
- 性能达标：在目标硬件上，推理延迟、FPS、内存占用、功耗等指标满足合同约定。例如，要求 TensorRT FP16 下 YOLOv8s 延迟 ≤ 15ms。
- 稳定性：连续运行 72 小时无崩溃、无内存泄漏、无性能衰减。需提供压力测试日志。
- 可复现性：按照交付文档中的步骤，能在干净环境中复现相同结果。这是最容易出问题的环节。
- 安全合规：无已知高危漏洞，模型文件无恶意代码，数据传输符合客户安全策略。
- 可维护性：代码结构清晰，有注释，日志规范，便于客户团队后续自行维护。
1.4 案例拆解：一个失败的交付与补救
某 AI 公司为一家物流企业开发基于 Jetson AGX Orin 的包裹分拣视觉系统。项目开发耗时 3 个月，算法在开发板上检测准确率达到 98.5%，帧率 30 FPS。然而在交付时，客户现场出现以下问题：
- 客户提供的 5 台设备中，有 2 台无法启动系统——因为交付的镜像是在 64GB 版本上制作的，而客户设备是 32GB 版本，分区表不兼容。
- 模型文件是 .pt 格式，客户现场没有 PyTorch 环境，且无法安装（内网隔离）。
- 启动脚本中硬编码了开发机的 IP 地址和路径，导致客户设备上服务无法启动。
- 验收报告中的性能数据是在实验室 25°C 环境下测得的，而客户仓库温度高达 40°C，实际帧率下降 20%。
补救过程：项目组紧急制作了适配 32GB 版本的镜像，将模型转换为 TensorRT FP16 引擎（精度损失 0.3%，帧率提升至 35 FPS），重写启动脚本支持环境变量配置，并在客户现场重新进行了 48 小时高温测试。最终项目延期 2 周交付，额外成本约 8 万元。
复盘经验：
- 交付前必须确认目标设备的精确型号和配置（内存、存储、散热条件）。
- 模型交付应优先选择 TensorRT 引擎或 ONNX 格式，避免依赖训练框架。
- 所有脚本必须参数化，禁止硬编码路径和 IP。
- 性能测试应在客户实际使用环境下进行，至少覆盖温度、负载的边界条件。
1.5 常见误区与总结
在 Jetson 项目交付中，以下误区最为常见：
- 误区一：镜像越大越好。有些团队把开发环境中的所有包都塞进镜像，导致镜像超过 20GB，烧录时间长且包含大量无用依赖。正确做法是使用
jetson-stats或pipdeptree分析依赖，只保留运行时必需的组件。 - 误区二：忽略 JetPack 版本差异。JetPack 5.x 和 6.x 的 CUDA、TensorRT API 有显著差异，交付时必须锁定 JetPack 版本，并在文档中明确标注。
- 误区三：验收报告只写结论不写过程。合格的验收报告应包含测试命令、原始输出、环境快照（
dpkg -l、pip list）、硬件状态（tegrastats日志），以便问题回溯。 - 误区四：不进行“干净环境”验证。开发机上往往残留大量历史配置，导致“在我这能跑”的假象。交付前必须使用全新设备或虚拟机验证部署流程。