安装

支持 Linux x86_64、CPython 3.10–3.14，从 PyPI 安装：

python -m pip install localquant

使用文档

• 回测框架用户指南：../各类skills/localquant-backtest/references （策略编写、API、配置与报告）

• 源码仓库约束与内部设计：AGENTS.md 与 开发日志/

环境与构建

发行物仅为 Cython 编译的二进制 wheel，Python 明文仅保留 examples/ 与 _version.py；保留 docstring，不携带 DWARF 调试段。安全边界为无法一键还原源码。

Linux x86_64 构建入口为 scripts/build_local_wheel.sh，需要 Python 3.11+、docker 和宿主测试依赖。每个 ABI 使用新 manylinux 容器，依次完成构建、内容校验、安装导入与全量单测，再执行宿主中立目录单测和网关冒烟。全部门禁通过后，dist/ 只保存本次验收的二进制 wheel。标准 python -m build 入口拒绝构建 wheel 和 sdist。设计契约与 Windows 命令见 开发日志/2026-10-27_发行包Cython编译加密分发管线.md；安装环境见 ../VENV.md。

版本与发布

版本的唯一事实来源为 localquant/_version.py 中的 __version__；运行时、包元数据和构建脚本均读取该值。 版本采用 主版本.次版本.补丁：兼容的错误修复与性能优化递增补丁，兼容的功能扩展递增次版本，公开接口、配置或结果结构的不兼容变更递增主版本。 验收版使用 1.0.0rc1 等编号；同一已发布版本不得替换代码或 wheel。撮合、费用和绩效算法修复即使属于补丁，也应在对应功能文档说明生效口径及可能影响的结果。

在本目录执行，脚本的可选参数是 Python 解释器路径与 cp 版本列表；指定矩阵须包含宿主 Python 版本：

/data/workspace/.venv/bin/python -m pytest tests/unittest -q
bash scripts/build_local_wheel.sh /data/workspace/.venv/bin/python              # cp310–cp314 全矩阵
bash scripts/build_local_wheel.sh /data/workspace/.venv/bin/python cp313       # 指定版本

发布顺序：

1. 修改唯一版本文件并维护受影响的公开契约，运行相关测试和完整框架单测。

2. 运行完整矩阵构建入口，验收容器逐版本全量单测、内容门禁、宿主中立目录全量单测与网关冒烟（smoke_cn_etf.py）。

3. 将验收后的各平台 wheel 放入 ../各类skills/localquant-backtest/packages/，目录只保留当前发行版本的全部平台 wheel；更新 localquant-wheel.sha256、框架 skill 的安装说明和 VENV.md，本机环境显式安装目标 wheel。策略构建 skill 与框架 skill 同级分发，引用这份文档和发行包。

4. 核对 localquant.__version__、安装元数据、wheel 版本与校验值一致后提交，给发布提交打 localquant/v<版本> 标签，如 localquant/v1.0.0。日常提交不要求发布 wheel。

5. 使用 PyPI 上传凭据校验并上传 dist/ 中的二进制 wheel，随后从公网 PyPI 安装核对版本：

python -m twine check --strict dist/*.whl
python -m twine upload --repository pypi dist/*.whl

回测结果在 backtest_settings.framework_version 保存运行时版本，供结果核对与复现使用。