feat: 修复报错

shared/protocol.md

@@ -0,0 +1,44 @@
+# Kline JSON Protocol (Go <-> Python)
+
+用于 Go 行情采集端与 Python 展示/回测端的数据交换。
+
+## 标准消息格式
+
+```json
+{
+  "type": "kline",
+  "source": "binance_ws",
+  "symbol": "btcusdt",
+  "interval": "1m",
+  "event_time": 1711430400000,
+  "open_time": 1711430400000,
+  "close_time": 1711430459999,
+  "open": "68000.00",
+  "high": "68025.00",
+  "low": "67990.00",
+  "close": "68010.00",
+  "volume": "12.40",
+  "trade_num": 102,
+  "final": true
+}
+```
+
+## 字段说明
+
+- `type`: 消息类型，固定 `kline`
+- `source`: 数据来源，默认 `binance_ws`
+- `symbol`: 交易对（小写，如 `btcusdt`）
+- `interval`: K 线周期（如 `1m`、`5m`、`1h`）
+- `event_time`: 事件时间（毫秒时间戳）
+- `open_time`: K 线起始时间（毫秒时间戳）
+- `close_time`: K 线结束时间（毫秒时间戳）
+- `open/high/low/close`: 价格字段，使用字符串保证精度
+- `volume`: 成交量，字符串
+- `trade_num`: 成交笔数，整数
+- `final`: 是否为收盘完成 K 线（`true` 表示该根 K 线已闭合）
+
+## 约束约定
+
+- 时间戳统一为 UTC 毫秒
+- 数值字段在传输层统一为字符串（trade_num 除外），消费端按需转换
+- 数据可通过 Redis Pub/Sub、文件流（jsonl）或消息队列进行传输