变更记录(Changelog)

0.3.0 (Stable)

  • 基于已发布的 0.3.0b2 功能基线晋级 Stable; 保留交易 API、CLI、账户隔离、Unknown 不自动重发和默认轻量 OCR 行为, 无新增功能或运行时依赖升级。

  • 发行元数据与版本配置统一为 0.3.0; CPython 3.11–3.13、Requires-Python >=3.11,<3.14 不变。

  • Beta 在 Ubuntu x86_64 和 macOS Intel x86_64 的真实登录实测为 60/60;这是维护者报告的 Beta 测试,不是 Stable 包的独立实测、 长期稳定性证明或真实交易安全验证。

  • 2026-11-14 维护者明确决定不等待原建议的约十个工作日观察期; 此例外不会降低独立 Review、精确 SHA CI、产物审计和 PyPI 审批要求。 正式发行是否完成,以 GitHub Release 和 PyPI 的可核实记录为准。

  • 未验证真实下单、撤单、成交、极端网络故障后的委托状态及长期运行; Apple Silicon、Windows、PyPy 仍未验证。保留非官方接口、投资、 凭证与生产部署免责声明。

0.3.0b2 (2026-11-14 已发布的 PyPI OCR Beta)

  • 将已合并的 PR #32 的冻结微型 CNN + Pillow 设为默认 OCR; 旧 ddddocr==1.4.11 调整为仅 Python 3.11 可用的可选 extra, 引擎选择错误不静默回退。

  • 保留四位数字验证码字符串及前导零;Python 支持范围扩至 Linux CPython 3.11、3.12、3.13,不变更旧版交易接口签名。

  • 冻结模型的一次性独立准确率验收为 96/100,前导零 10/10; 目标 CPU P95 低于 1000 ms。参见 docs/refactor/reports/OCR-v1-acceptance.md。

  • 20 MB 安装体积门槛仅适用于目标机器源码编译 Pillow 的部署; 普通用户安装官方 Wheel 允许超过该值。

  • 2026-11-14 已创建 Tag、GitHub Pre-release 并通过 PyPI Trusted Publishing 上传;发行产物、CI 与真实登录验收参见 Beta 验收报告。

0.3.0b1 (2026-11-10 已发布的 PyPI Beta)

  • 2026-11-10 已完成受控 Beta 发布;当时仅覆盖 P0–P3 及 Linux CPython 3.11,不包含后续 OCR v1 改动。

  • 首轮仅验证 Linux / CPython 3.11 (Requires-Python >=3.11,<3.12); Windows、macOS、PyPy 和 Python 3.12+ 不在验证/支持范围内。

  • 包含 P0–P3 的安全加固、兼容保留、TradingClient 多账户隔离以及 TradeOutcomeUnknown / BrokerHTTPError 异常契约。

  • 固定依赖仍为 rsa==4.9、requests==2.33.1、 ddddocr==1.4.11、cryptography==50.0.2; Requests/cryptography 已进行定向安全修复和无网络兼容性验证。

  • CLI emt 及 python -m emtl 仍只解析参数,不执行交易。 不保证真实券商协议或实际成交;遇到交易结果不确定时不得自动重发订单。

  • 仅提供中文 RST + Sphinx + HTML 文档;PyPI Beta 采用显式预发布安装。 旧版 0.2.6 不具备本轮 P0–P3 保护,不能当作默认安全回退版本。

0.3.0a1 (未发布的内部 Alpha;目标正式版 0.3.0)

  • 保留旧版包级函数、CLI 签名、参数、退出码及成功响应结构; P0 已取消 CLI 凭证回显。

  • 移除 SDK 中的敏感日志和 root logger 重配置, 使用合成替身及系统级禁网隔离自动测试和 CI。

  • P2 新增独立账户 TradingClient,独立管理 HTTP/认证状态, 同一账户在单进程内串行,不同账户允许并发。

  • P3 为显式客户端增加 emtl.errors.TradeOutcomeUnknown 与 BrokerHTTPError。Unknown 不代表成交或拒绝,不得自动重发; 旧模块级接口异常行为保持不变。

  • 已批准的支持目标缩小为 Linux / CPython 3.11 (Requires-Python >=3.11,<3.12); 保留 ddddocr==1.4.11 及已批准的运行时依赖固定版本。

  • 增加发布产物安装验证与受人工审批保护的发布流程。 自动化测试未验证真实券商协议或实际交易。

  • 计划 PyPI Beta 0.3.0b1,必须另行批准上传; 正式版 0.3.0 需 Beta 后单独决策。 尚未承诺发布日期或生产可用性。

0.1.0 (2024-04-14)

  • 首次发布至 PyPI。

0.1.1 (2024-04-16)

  • 移除 Python 3.8、3.9 和 PyPy 的旧支持声明。

0.1.2 (2024-04-18)

  • 新增登录、资产和持仓查询。

0.1.3 (2024-04-19)

  • 更新文档主题。

0.1.5 (2024-04-24)

  • 更新登录参考说明。

0.1.7 (2024-04-27)

  • 新增下单接口(当时名称为 insert_order)。

0.1.8 (2024-04-30)

  • 删除 macOS Actions。

0.2.0 (2024-05-21)

  • 补齐当时的全部方法。

0.2.1 (2024-05-29)

  • 增加向 PyPI 的自动部署功能(历史记录)。

0.2.2 (2024-07-11)

  • 将 insert_order 替换为 create_order。

P0 安全基线(历史记录,已纳入 0.3.0b1)

  • 删除敏感日志输出,不再重新配置宿主应用的 root logger。

  • 用隔离的离线测试替代真实交易测试,移除 CI 账户凭证注入。

  • 经明确批准,CLI 不再回显凭证,参数与退出码不变。

  • 将离线测试迁移到仓库根目录的 tests/; 淘汰不安全的 pytest --pyargs emtl 测试入口。