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

doc/gps-marker-style-system-proposal.md

@@ -0,0 +1,113 @@
+# GPS 点样式系统方案
+
+## 目标
+
+把当前“粗糙蓝点”升级成正式的 GPS 点样式系统，满足：
+
+- 默认样式更精致
+- 显示/隐藏可控
+- 大小可调
+- 颜色可调
+- 带跟随朝向旋转的小三角
+- 后续可承接品牌 logo 定制
+
+## 分层
+
+### 1. 显示策略
+
+- `visible`
+- `size`
+- `colorPreset`
+
+### 2. 基础样式
+
+第一阶段支持：
+
+- `dot`
+- `beacon`
+- `disc`
+- `badge`
+
+默认：
+
+- `beacon`
+
+### 3. 朝向指示
+
+GPS 点上方增加一个小三角：
+
+- 跟随朝向旋转
+- 朝向可信度高时更明显
+- 朝向可信度低时自动降低透明度
+
+### 4. 品牌化扩展
+
+后续通过：
+
+- `logoUrl`
+- `logoMode`
+
+把商家 logo 作为中心贴片嵌入 GPS 点，不直接替代定位点本体。
+
+## 第一阶段默认值
+
+```json
+{
+  "visible": true,
+  "style": "beacon",
+  "size": "medium",
+  "colorPreset": "cyan",
+  "showHeadingIndicator": true,
+  "logoUrl": "",
+  "logoMode": "center-badge"
+}
+```
+
+## 用户设置建议
+
+系统设置先开放：
+
+- GPS 点显示：`显示 / 隐藏`
+- GPS 点大小：`小 / 中 / 大`
+- GPS 点颜色：8 种亮色
+
+品牌 logo 先不进用户设置，只保留给活动配置。
+
+## 配置入口
+
+建议统一放在：
+
+```json
+"game": {
+  "presentation": {
+    "gpsMarker": {}
+  }
+}
+```
+
+## 长期演进
+
+### 第二阶段
+
+- logo 中心贴片
+- 不同玩法默认 GPS 点 profile
+- 更强的脉冲/光晕动画
+
+### 第三阶段
+
+- GPS 点与心率/危险状态联动
+- 客户品牌化主题包
+- 特殊活动皮肤
+
+## 结论
+
+GPS 点应被视为独立样式系统，而不是固定蓝点。
+
+第一阶段先把：
+
+- 显示
+- 大小
+- 颜色
+- 朝向三角
+
+做稳定，再逐步承接商业品牌化定制。