添加k线动能理论

datasvc/README.md

@@ -0,0 +1,48 @@
+# Local Data Service (REST + WebSocket)
+
+一键部署、跨平台的本地行情数据服务。默认抓取 Binance 永续合约 `BTC/USDT:USDT, ETH/USDT:USDT` 的 `1m/5m/15m/1h` K 线，增量写入本地 Parquet 并通过 WebSocket 推送。
+
+## 快速开始（方式B：已安装 Docker）
+
+```bash
+cd user_data/Chan/datasvc
+docker compose up -d
+```
+
+- REST: http://localhost:9000/api/candles?symbol=BTC/USDT:USDT&tf=1m
+- WS:   ws://localhost:9000/ws?symbol=BTC/USDT:USDT&tf=1m&since=1690000000000
+- Swagger: http://localhost:9000/docs
+
+## 环境变量（docker-compose.yml）
+- EXCHANGE: 交易所，默认 binance
+- SYMBOLS: 逗号分隔交易对
+- TIMEFRAMES: 逗号分隔周期
+- START_DAYS: 首次启动回补最近 N 天
+- POLL_FACTOR: 轮询因子，间隔=周期毫秒*factor
+- DATA_DIR: 容器内数据目录（已映射到 `./data`）
+
+## 数据位置
+- 本地缓存：`user_data/Chan/datasvc/data/{timeframe}/{symbol}.parquet`
+
+## 常用命令
+```bash
+docker compose logs -f
+
+docker compose down
+```
+
+## 接口说明
+- GET /api/candles
+  - 参数：symbol, tf, start(ms), end(ms)
+  - 返回：[{timestamp, open, high, low, close, volume}]
+- WS /ws
+  - 参数：symbol, tf, since(ms)
+  - 消息：
+    - snapshot: 初始快照数组
+    - upsert: 单根K线增量（尾部修正）
+
+## 注意
+- 默认未带交易所 API Key，仅公共行情。
+- 如需更多交易对/周期，修改 `docker-compose.yml` 后重启。
+
+