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