feat: 注册 aiot 路由并更新主程序配置

- main.py：注册 aiot_alarm 和 aiot_edge 路由，保留旧路由兼容
- config.py/alert_service.py/mqtt_service.py：同步更新配置和服务
- 添加 CLAUDE.md 项目说明文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/services/mqtt_service.py

@@ -20,6 +20,7 @@ class MQTTService:
         self._client: Optional[mqtt.Client] = None
         self._connected = False
         self._running = False
+        self._use_v2_callback = False  # paho-mqtt 版本标记
         self._lock = threading.Lock()
 
         # 回调函数
@@ -58,11 +59,23 @@ class MQTTService:
             return
 
         try:
-            self._client = mqtt.Client(
-                client_id=settings.mqtt.client_id,
-                protocol=mqtt.MQTTv5,
-                callback_api_version=mqtt.CallbackAPIVersion.VERSION2
-            )
+            # 兼容 paho-mqtt 1.x 和 2.x 版本
+            try:
+                # paho-mqtt 2.0+ 新 API
+                self._client = mqtt.Client(
+                    client_id=settings.mqtt.client_id,
+                    protocol=mqtt.MQTTv5,
+                    callback_api_version=mqtt.CallbackAPIVersion.VERSION2
+                )
+                self._use_v2_callback = True
+            except AttributeError:
+                # paho-mqtt 1.x 旧 API
+                self._client = mqtt.Client(
+                    client_id=settings.mqtt.client_id,
+                    protocol=mqtt.MQTTv5
+                )
+                self._use_v2_callback = False
+                logger.info("使用 paho-mqtt 1.x 兼容模式")
 
             # 设置回调
             self._client.on_connect = self._on_connect
@@ -107,9 +120,17 @@ class MQTTService:
             self._client.disconnect()
             logger.info("MQTT 服务已停止")
 
-    def _on_connect(self, client, userdata, flags, reason_code, properties):
-        """连接回调"""
-        if reason_code == 0:
+    def _on_connect(self, client, userdata, *args):
+        """连接回调 (兼容 1.x 和 2.x)"""
+        # 1.x: (client, userdata, flags, rc)
+        # 2.x: (client, userdata, connect_flags, reason_code, properties)
+        if args:
+            reason_code = args[-2] if len(args) >= 2 else args[-1]
+            rc = reason_code if isinstance(reason_code, int) else getattr(reason_code, 'value', reason_code)
+        else:
+            rc = -1
+
+        if rc == 0:
             self._connected = True
             logger.info("MQTT 连接成功")
 
@@ -123,10 +144,17 @@ class MQTTService:
             self._connected = False
             logger.error(f"MQTT 连接失败: {reason_code}")
 
-    def _on_disconnect(self, client, userdata, reason_code, properties):
-        """断开连接回调"""
+    def _on_disconnect(self, client, userdata, *args):
+        """断开连接回调 (兼容 1.x 和 2.x)"""
+        # 1.x: (client, userdata, rc)
+        # 2.x: (client, userdata, disconnect_flags, reason_code, properties)
         self._connected = False
-        logger.warning(f"MQTT 连接断开: {reason_code}")
+        if args:
+            reason_code = args[-2] if len(args) >= 2 else args[0]
+            rc = reason_code if isinstance(reason_code, int) else getattr(reason_code, 'value', reason_code)
+            logger.warning(f"MQTT 连接断开: {rc}")
+        else:
+            logger.warning("MQTT 连接断开")
 
     def _on_message(self, client, userdata, msg: mqtt.MQTTMessage):
         """消息回调"""