Add optional original, annotated and JSON frame outputs

README.md

@@ -92,3 +92,22 @@ pipeline.join();
 - `orin/`：可单独复制的 ELF 程序、模型、驱动、CAN 库和配置。
 
 修改源码后，在 Orin 重新编译并执行 `./scripts/package_orin.sh`，或执行 `make package`。运行、打包均不使用 Python。打包后可在 orin 目录运行 `sha256sum -c SHA256SUMS`。
+
+## 可选保存（默认全部关闭）
+
+三个独立参数可以单独使用，也可以组合：
+
+```bash
+./run_camera.sh --save-original --save-annotated --save-results
+# 独立包：./orin/run.sh --save-original --save-annotated --save-results
+```
+
+开启任一项时，程序自动创建可执行文件所属工程的 `output/` 及三个子目录：
+
+- `original/`：`--save-original` 保存未叠加的原图，JPEG 质量 95。
+- `annotated/`：`--save-annotated` 保存带框、关键点及风险文字的 JPEG，无需开启可视化窗口。
+- `results/`：`--save-results` 每个完成推理的帧保存一个 JSON，包含帧号、检测框、跟踪 ID、关键点及置信度、风险和耗时；有 CAN 的分支还包含相应状态。
+
+同一帧三类文件同名（扩展名不同），文件名包含运行标识和帧号，多次运行不覆盖。JSON 的 `images` 提供相对于 `output/` 的图片路径，未选择保存的图片为 null。源码入口写入工程 `output/`；独立包入口写入 `orin/output/`。默认不创建目录、不保存文件。
+
+保存对象是完成推理的帧；惰性分支暂停时不新增文件。开启保存会增加编码和磁盘 I/O 开销。写入失败时报告错误并停止，不静默丢失文件。