From 41bd03123c40744f76ca4c5fbf9ac05b98b98606 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=88=E8=B5=A3?= <gavin@gavinm2.local>
Date: Wed, 3 Jun 2026 11:04:16 +0800
Subject: [PATCH] update at 2026-06-03 11:04:16

---
 README.md             | 3 +++
 app/capacity_api.py   | 2 ++
 app/config.py         | 2 ++
 app/detector.py       | 2 ++
 app/device_manager.py | 2 ++
 app/main.py           | 2 ++
 app/stream_worker.py  | 2 ++
 7 files changed, 15 insertions(+)

diff --git a/README.md b/README.md
index f819d9f..7a968f4 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,9 @@ flowchart TD
     I --> J[浏览器动态打标画面]
 ```
 
+---
+
+
 ```mermaid
 flowchart TD
     A[读取一帧 BGR 图像] --> B{是否达到 FRAME_SKIP}
diff --git a/app/capacity_api.py b/app/capacity_api.py
index 997acd2..d40f1ed 100644
--- a/app/capacity_api.py
+++ b/app/capacity_api.py
@@ -1,3 +1,5 @@
+"""能力开放接口客户端：获取 accessToken、签名并请求摄像头 RTSP 地址。"""
+
 from __future__ import annotations
 
 import hashlib
diff --git a/app/config.py b/app/config.py
index 9bc62cf..937dd96 100644
--- a/app/config.py
+++ b/app/config.py
@@ -1,3 +1,5 @@
+"""配置模块：从环境变量读取服务、模型、视频源和检测参数。"""
+
 from __future__ import annotations
 
 import os
diff --git a/app/detector.py b/app/detector.py
index 07caf9d..b56ef48 100644
--- a/app/detector.py
+++ b/app/detector.py
@@ -1,3 +1,5 @@
+"""DETR 车辆检测模块：加载模型并输出车辆类别、置信度和检测框。"""
+
 from __future__ import annotations
 
 from typing import Any
diff --git a/app/device_manager.py b/app/device_manager.py
index 10868fa..63227d5 100644
--- a/app/device_manager.py
+++ b/app/device_manager.py
@@ -1,3 +1,5 @@
+"""摄像头管理模块：加载设备列表、切换当前设备并解析播放地址。"""
+
 from __future__ import annotations
 
 import threading
diff --git a/app/main.py b/app/main.py
index 1b4d571..f4ee4ce 100644
--- a/app/main.py
+++ b/app/main.py
@@ -1,3 +1,5 @@
+"""FastAPI 入口模块：提供页面、视频流、状态、设备切换和 WebSocket 接口。"""
+
 from __future__ import annotations
 
 import asyncio
diff --git a/app/stream_worker.py b/app/stream_worker.py
index 7733690..1e83401 100644
--- a/app/stream_worker.py
+++ b/app/stream_worker.py
@@ -1,3 +1,5 @@
+"""视频流工作线程：读取视频帧、调用检测器、绘制 OSD 并缓存 JPEG。"""
+
 from __future__ import annotations
 
 import threading