feat: 自定义数据源扩展 + 限频集中化 (v0.1.80)

2026-09-12 19:04:15 +08:00 · 2026-07-05 22:57:46 +08:00
parent e524ea4893
commit fa08981851
38 changed files with 2819 additions and 123 deletions
@@ -0,0 +1,43 @@
+# 自定义数据源 mock 联调示例
+
+这个目录提供一个本地 mock HTTP 数据源,用于验证项目的自定义数据源接入链路。
+
+## 运行 mock 服务
+
+```bash
+cd docs/examples/custom-data-source
+python mock_server.py
+```
+
+服务默认监听:
+
+```text
+http://127.0.0.1:3021
+```
+
+端点:
+
+| 端点 | 数据 |
+| --- | --- |
+| `/daily` | 日K |
+| `/adj_factor` | 除权因子 |
+| `/realtime` | 全市场实时快照 |
+
+## 接入项目
+
+复制示例 YAML 到运行数据目录:
+
+```bash
+mkdir -p data/data_sources
+cp docs/examples/custom-data-source/mock_source.yaml data/data_sources/mock_source.yaml
+```
+
+然后在项目里打开:
+
+```text
+设置 -> 数据源 -> 重新加载
+```
+
+选择 `mock_source` 后,可用「试拉测试」验证 `daily`、`adj_factor` 和 `realtime`。
+
+完整说明见 [../../custom-data-source.md](../../custom-data-source.md)。