安装与环境

发行包

本指南对应 localquant 1.0.0，使用 Python 3.10 及以上版本。wheel 与 SHA-256 文件随发行目录的 packages/ 提供。使用这个定制发行包，不用同名上游包替代；同一 Python 环境只安装一个 localquant 版本。

在包含 packages/ 的发行目录执行：

python -m pip install seeddata-quant ./packages/localquant-*.whl
python -m pip show localquant seeddata-quant

本文的 python 均指安装该 wheel 的解释器。核对安装位置和版本：

python -c "import localquant; print(localquant.__version__); print(localquant.__file__)"

校验发行文件时，在 packages/ 内执行 sha256sum -c localquant-wheel.sha256。数据 SDK 的包名为 seeddata-quant，导入名为 seeddata；交易日历通过其依赖 seeddata_calendars 使用。

数据连接

行情从可访问的 seeddata 网关加载。每次 load_framework_data 必须显式传入 base_url。示例地址 http://127.0.0.1:28637 表示运行 Python 的本机网关；在其他机器运行时，应在 Python 配置中填写实际地址。

完成取数后，回测使用内存数据，不在交易回调中持续请求网关。加载和回测必须在同一个 Python 进程内完成；数据注册键不能交给另一个 localquant run 进程。

首次运行

按资产选择完整示例：A 股、场内基金、期货。它们只依赖已安装的发行包、SDK 和可用数据，不依赖策略模板。

成功时生成 result.pkl 和可离线打开的 full_report.html。报告导出与本地服务的依赖随 wheel 安装；另外使用策略模板时，其额外依赖以该模板 README 为准。并行参数优化使用 Linux fork，约束见参数优化。