增加分区快照数据入口

README.md

@@ -103,6 +103,7 @@
 ## Phase 2 新增内容
 
 - `DataSet::bundle_on(date)`：引入按日 snapshot bundle 视图，方便未来直接对接 FiDataCenter / FiDataScraper 预计算快照
+- `DataSet::from_partitioned_dir(path)`：新增按日分区 snapshot 目录读取入口，为真实回测数据源接入打基础
 - 策略诊断输出：equity curve 里新增 `diagnostics` 字段，记录市值带、候选样本、退出原因等信息
 - 候选资格快照扩展：补入 `is_kcb`、`is_one_yuan`
 - 增加策略选择行为测试
@@ -122,10 +123,41 @@
 
 ## 运行方式
 
+默认跑仓库内置 flat demo CSV：
+
 ```bash
 cargo run --bin bt-demo
 ```
 
+如果要接更接近真实数据面的按日分区 snapshot 目录：
+
+```bash
+FIDC_BT_DATA_LAYOUT=partitioned \
+FIDC_BT_DATA_DIR=/path/to/snapshots \
+cargo run --bin bt-demo
+```
+
+约定目录结构：
+
+```text
+snapshots/
+├── instruments.csv
+├── benchmark/
+│   ├── 2024-01-02.csv
+│   └── ...
+├── market/
+├── factors/
+└── candidates/
+```
+
+其中：
+- `market/`：日级行情快照
+- `factors/`：估值/因子快照
+- `candidates/`：候选资格/过滤标记快照
+- `benchmark/`：指数快照
+
+这层接口是为后续对接 `FiDataCenter / FiDataScraper` 的预计算 snapshot 数据准备的。
+
 运行后会生成：
 
 - `output/demo/equity_curve.csv`