From b7adf0f6f8b1e4ba0da349110224fd7628685d95 Mon Sep 17 00:00:00 2001
From: AskaEth <aska@yeij.top>
Date: Sat, 17 Oct 2026 08:17:55 +0800
Subject: [PATCH] =?UTF-8?q?feat(telemetry):=20TelemetryData=20=E6=96=B0?=
 =?UTF-8?q?=E5=A2=9E=E9=80=9A=E7=94=A8=E6=89=A9=E5=B1=95=E5=91=BD=E5=90=8D?=
 =?UTF-8?q?=E7=A9=BA=E9=97=B4=20extra?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

供非游戏类数据源（车辆诊断、工业设备等）携带自定义字段，
避免把领域专属字段塞进核心模型。

- 新增 extra: dict[str, Any]，to_dict() 同步输出
- 向后兼容：其它解析器（forza/ac/acc/f1/iracing）不受影响
---
 server/telemetry/data.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/server/telemetry/data.py b/server/telemetry/data.py
index 874dcc2..0578696 100644
--- a/server/telemetry/data.py
+++ b/server/telemetry/data.py
@@ -48,6 +48,11 @@ class TelemetryData:
     car_name: str = ""
     car_class: str = ""
 
+    # --- 通用扩展命名空间 ---
+    # 供非游戏类数据源（车辆诊断、工业设备等）携带自定义字段，避免污染核心模型。
+    # 例: {"battery_voltage": 13.9, "dtcs": ["P0043"], "bus_stats": {...}}
+    extra: dict[str, Any] = field(default_factory=dict)
+
     raw: dict[str, Any] = field(default_factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -82,4 +87,5 @@ class TelemetryData:
             "torque": self.torque,
             "car_name": self.car_name,
             "car_class": self.car_class,
+            "extra": self.extra,
         }