| 位置 | 是什么 | 是否第三方源码 |
|---|---|---|
collected_projects/*/upstream/ |
公开项目留下的 Python 源码子集 | 是 |
appendix/generated_prototype/src/ |
统一检测、规则、告警和流水线原型 | 否，整理者编写 |
docs/、SOURCE_INFO.yaml、COLLECTION_NOTE.md |
中文说明、来源和校验信息 | 否，整理文件 |
进入任意项目的 upstream/ 后，优先打开 .py 文件：
| 场景 | 目录 | 常见入口 |
|---|---|---|
| YOLO 框架 | collected_projects/ultralytics/upstream/ |
ultralytics/、examples/ |
| 明火 | collected_projects/fire_detection_pedbrgs/upstream/ |
detect.py、temporal/ |
| 明火和烟雾 | collected_projects/fire_smoke_detection_talha/upstream/ |
Python 推理脚本 |
| 吸烟/香烟 | collected_projects/aow_yolo_smoking/upstream/ |
detect.py、自定义模块和训练代码 |
| 动火作业 | collected_projects/hotwork_monitor_yolov8/upstream/backend/ |
app.py、engine.py、config.py |
| 灭火器 | collected_projects/industrial_extinguisher_yolov8/upstream/ |
HACKFEST.ipynb |
| 跨帧跟踪 | collected_projects/bytetrack/upstream/ |
yolox/、tools/ |
| 工厂区域规则 | collected_projects/industrial_safety_vision/upstream/ |
src/、tests/ |
| 物料/托盘近似识别 | collected_projects/inventory_verification/upstream/ |
verify_and_train.py、backend/ |
.py：真正的 Python 源码、训练脚本、推理脚本、测试和工具。.ipynb：可阅读的 Python Notebook，通常用于训练实验。.yaml、.yml、.json、.toml、.cfg：类别、数据集、模型或项目配置，不是主要算法源码。.md：说明文件，不是源码。SOURCE_INFO.yaml、COLLECTION_NOTE.md、FILES_SHA256.txt：本次整理附加的来源和校验文件。
- 先看本文件和
python-source-index.md。 - 再打开 Ultralytics 的 Python 源码，理解 YOLO 基本接口。
- 按场景阅读明火、烟雾、吸烟和动火项目。
- 用 ByteTrack 和 Industrial Safety Vision 对照跟踪、区域和时序逻辑。
- 最后阅读
appendix/generated_prototype/，区分第三方代码与整理者编写的集成示例。