first commit

dist/README.md

@@ -0,0 +1,29 @@
+# dist/
+本目录存放**离线安装用**的 Python wheel 包。
+配合 `offline_install.bat` 在没有 PyPI 网络的机器上安装依赖。
+
+## 用法
+1. 把整个 `dist/` 目录拷到目标机器（与 `offline_install.bat` 同级）
+2. 目标机器上需先安装 **Python 3.12.x**（wheel 是 cp312 编译的，其它版本不通用）
+3. 双击运行 `offline_install.bat`
+
+## 包含的包（仅本项目实际用到）
+
+| 包               | 用途                              |
+| ---------------- | --------------------------------- |
+| MetaTrader5      | MT5 官方 Python 绑定              |
+| pandas           | 回测报告数据处理                  |
+| pyyaml           | `config/ea_configs.yaml` 解析     |
+| openpyxl         | 导出 Excel 报告                    |
+| beautifulsoup4   | 解析 MT5 HTML 报告                |
+| numpy            | pandas/MetaTrader5 依赖           |
+| python-dateutil  | pandas 依赖                       |
+| six              | python-dateutil 依赖              |
+| soupsieve        | beautifulsoup4 依赖               |
+| typing-extensions| beautifulsoup4 依赖               |
+| et-xmlfile       | openpyxl 依赖                     |
+| tzdata           | pandas 时区数据                   |
+
+> 共 12 个 wheel，本机 `pip download -d dist` 打包约 23 MB。
+> 如果 `dist/` 体积过大，需要按需精简可只保留：
+> `metatrader5 / pandas / pyyaml / openpyxl / beautifulsoup4 / numpy / python-dateutil / soupsieve / typing-extensions / et-xmlfile / tzdata`（去掉 `six`，新版已可选）。