# emtl 0.3.0b2：Beta 发行与真实登录实测验收（2026-11-14）

## 结论与适用范围

**Beta 发行流程：PASS；PyPI 安装、OCR 与真实账户登录实测：PASS（六组环境，共 60/60）。**
本结论仅适用于下表中的操作系统架构、Python 版本和 `emtl==0.3.0b2`。
它不等于软件获得生产环境交易认证，也不代表长期登录或 OCR 成功率为 100%。

## 维护者实测记录

- **日期**：2026-11-14（维护者在本项目会话中报告的结果）。
- **安装来源**：PyPI 发行版 `emtl==0.3.0b2`；不是 GitHub 源码安装。
- **方式**：通过真实东方财富账户完成登录，覆盖验证码获取、OCR 识别、提交及登录集成流程；不是仅对离线验证码图片运行识别器。
- **次数**：每组环境 10 次真实登录；维护者确认每次登录及 OCR 均成功。
- **证据级别**：维护者口述实测结果；未收到可独立复算的原始登录日志、独立审计记录或每张验证码的匿名样本。为保护凭证与交易隐私，不要求提供真实账户资料。

| 平台与架构 | CPython 3.11 | CPython 3.12 | CPython 3.13 | 合计 |
| --- | ---: | ---: | ---: | ---: |
| Ubuntu x86_64 | 10/10 PASS | 10/10 PASS | 10/10 PASS | 30/30 |
| macOS Intel x86_64 | 10/10 PASS | 10/10 PASS | 10/10 PASS | 30/30 |
| **合计** | **20/20** | **20/20** | **20/20** | **60/60** |

**结果解释**：观察成功率 60/60 = 100%，是这些测试的描述统计，不是置信度充分的长期成功率估计。每组仅 10 次，无法覆盖券商升级、验证码分布变化、网络异常、长时间运行或不同设备差异。

## 可独立核实的发布证据（与上方真实登录反馈分开）

- [GitHub Tag 与 Pre-release `v0.3.0b2`](https://github.com/riiy/emtl/releases/tag/v0.3.0b2)，对应发行 Commit `a19140361bc2f7ba1b0cc3385d0e9ab87721ab79`。
- [PyPI `emtl==0.3.0b2`](https://pypi.org/project/emtl/0.3.0b2/)。
- [发布工作流 Run #43541956056](https://github.com/riiy/emtl/actions/runs/43541956056)：`validate-build`、`smoke`、`publish` 全部 PASS；两份发行文件上传均获得 HTTP 200。
- [发布 Artifact #14091713007](https://github.com/riiy/emtl/actions/runs/43541956056/artifacts/14091713007)：使用与 PyPI Publish Job 相同的构建产物；GitHub Pre-release 附件已同步为这批字节。
- Wheel `emtl-0.3.0b2-py3-none-any.whl` SHA-256：`70ae86a4fe742551fa6944a77aab57637b58d389acbae0966e83eb40f4ac954b`。
- sdist `emtl-0.3.0b2.tar.gz` SHA-256：`08b72f95367445860f368f41299d9f2713ee8d005d0ff3968e610bdb04189472`。

发布工作流的禁网包安装和合成测试不涉及真实账户；它们不能替代维护者的真实登录实测，反之亦然。前述发行文件 SHA-256 为经过发布日志与 GitHub Release API 核对的证据，不声称已单独审计券商服务端行为。

## 兼容声明和未验证范围

- **本次 Beta 实测通过**：Ubuntu x86_64、macOS Intel x86_64，CPython 3.11–3.13 的 PyPI 包安装、OCR 集成及真实登录链路。
- **尚未实测**：macOS Apple Silicon (arm64)、Windows、PyPy、其他操作系统架构及其他发行版；不将 Ubuntu x86_64 的结论直接推广到全部 Linux。
- **尚未验证的真实交易风险**：订单创建与撤销、真实成交、网络超时后的委托状态、账户隔离在真实券商服务下的表现、长期稳定运行及接口变更后的兼容性。
- **元数据边界**：本次为文档验收更新，不调整发行版 `Requires-Python >=3.11,<3.14`、平台 Classifier、代码或已上传的 PyPI 文件。

## Beta 观察与退出条件

当前结论为 **Beta 实测 PASS / Stable 尚未批准**。观察期内重点关注安装失败、验证码变化、登录协议变化和安全报告。发生账户混用、未知成交、重复委托或凭证泄漏风险时，应暂停相关自动化并依据 [SECURITY.md](../../../SECURITY.md) 私密反馈；不得自动重发结果未知的订单。

本报告不包含任何账户凭证、验证码或交易记录。模型原始验收证据参见 [OCR v1 验收](OCR-v1-acceptance.md)；Beta 观察结束和 Stable 发布仍须另外决策。
