安装说明

版本与支持范围

0.3.0 Stable 使用已发布 0.3.0b2 的功能基线, CPython 支持范围仍为 3.11、3.12、3.13 (Requires-Python >=3.11,<3.14)。维护者在 Ubuntu x86_64 和 macOS Intel x86_64 的三个 Python 版本上,分别从 PyPI 安装 Beta 0.3.0b2 并完成 10 次真实账户登录,六组合计 60/60。 这些实测不能证明 0.3.0 Stable 的交易功能、长期稳定性或 未经验证的其他 Linux/macOS 架构;Apple Silicon、Windows、PyPy 未验证。详见 Beta 实测验收报告。 Stable 的发布决策及例外见 Stable 发布决策。

Stable 0.3.0 与 Beta 0.3.0b2 默认安装 Pillow 13.0.0 与冻结的微型 CNN 模型, 不再强制安装 ddddOCR、NumPy、ONNX Runtime 或 OpenCV。

在 Python 3.11 上需要旧 OCR 时,可以安装额外依赖:

python -m pip install 'emtl[ddddocr]'

并显式选择引擎:

export EMTL_OCR_ENGINE=ddddocr

未设置 EMTL_OCR_ENGINE 时默认使用 lightweight。 未安装的旧引擎或未知引擎会明确失败,不进行静默回退。 OCR 的返回值为四位数字字符串,前导零会原样提交。

体积限制仅适用于目标部署环境。 目标机器源码构建 Pillow 后, 已测量 Pillow + 推理代码 + 模型约 5.72 MB,P95 约 55.76 ms; 官方 Pillow Wheel 安装可以超过 20 MB,不构成普通用户安装失败。 源码构建依赖系统 JPEG/zlib 库,必须在目标环境自行验证。 OCR v1 已随 0.3.0b2 发布;此前的 0.3.0b1 仍使用旧版 ddddOCR。

安装 Stable 版本

0.3.0 正式完成 PyPI 上传后,使用固定版本安装:

python -m pip install emtl==0.3.0

不指定版本时,pip 选择 PyPI 上符合当前环境的可用稳定版本, 不会默认安装 Beta 等预发布版本:

python -m pip install emtl

仅仅合并 Stable 候选或创建 Tag,不等于 ``0.3.0`` 已在 PyPI 发布。 应先查看 https://pypi.org/project/emtl/ 的实际发行记录。 开发中的源码可以从 GitHub 获取,但不代表已完成正式发布验收:

python -m pip install https://github.com/riiy/emtl/archive/master.zip

预发布版本

此前的 Beta 0.3.0b1 可通过显式版本号安装(仍采用旧 OCR, 仅支持 Python 3.11):

python -m pip install --pre emtl==0.3.0b1

0.3.0b2 已在 PyPI 公开发布,使用默认的轻量 OCR 引擎。 在明确接受 Beta 和非官方接口风险后,可显式安装:

python -m pip install --pre emtl==0.3.0b2

Beta 与 Stable 均不代表已验证生产实盘交易安全,也不保证券商协议兼容。 自动安装验收仅允许 import、CLI help、离线合成用例等无交易副作用的检查。 不要在 CI 中使用真实凭证或真实下单/撤单。 维护者的真实账户登录实测不属于自动化 CI 验收。

升级风险、版本回退限制和反馈要求参见 发布与维护。