完善样式系统与调试链路底座

doc/track-visualization-proposal.md

@@ -0,0 +1,85 @@
+# 轨迹可视化方案
+
+本文档定义用户轨迹的显示模式、默认策略与配置结构。
+
+目标：
+
+- 支持 `none / full / tail` 三种轨迹模式
+- `tail` 模式有更强的实时感和游戏感
+- 兼顾低端机性能
+
+## 模式定义
+
+### `none`
+
+- 不显示轨迹
+- 只显示当前 GPS 点
+
+### `full`
+
+- 显示从开始到当前的完整轨迹
+
+### `tail`
+
+- 只显示最近一小段拖尾轨迹
+- 头部更亮、更粗
+- 尾部逐步变淡、变细
+- 用户停止移动后，轨迹会逐步缩短到消失
+
+## 推荐默认值
+
+### 顺序赛
+
+- `mode = full`
+- `style = classic`
+
+### 积分赛
+
+- `mode = tail`
+- `style = neon`
+
+## 推荐配置
+
+```json
+"game": {
+  "presentation": {
+    "track": {
+      "mode": "tail",
+      "style": "neon",
+      "tailMeters": 60,
+      "tailMaxSeconds": 30,
+      "fadeOutWhenStill": true,
+      "stillSpeedKmh": 0.6,
+      "fadeOutDurationMs": 3000,
+      "colorHex": "#176d5d",
+      "headColorHex": "#54f3d8",
+      "widthPx": 5,
+      "headWidthPx": 10,
+      "glowStrength": 0.42
+    }
+  }
+}
+```
+
+## 当前实现约定
+
+当前第一版实现支持：
+
+- `mode`
+- `style`
+- `tailMeters`
+- `tailMaxSeconds`
+- `fadeOutWhenStill`
+- `stillSpeedKmh`
+- `fadeOutDurationMs`
+- `colorHex`
+- `headColorHex`
+- `widthPx`
+- `headWidthPx`
+- `glowStrength`
+
+## 后续扩展
+
+- 轨迹颜色按心率区间变化
+- 轨迹颜色按速度变化
+- `standard / lite` 下自动降级 glow