# Italy 自动 OTP:接入说明与验收 更新:2026-08-31。范围:ITA-OTP-01,Book 自动接码及现有最终提交链路接线;Query 首次日历准备的自动 OTP 扩展见第 10 节。 **最新状态(2026-08-31):用户现场已通过自动 OTP → Calendar → 选择时段的 预确认验收,最终提交请求为 0(第 7 节)。第 8 节完成自动 OTP 复用现有最终提交的 代码接线及 508 项离线回归;第 9 节用户现场通过空回执基线核对与选位保持验收。 默认开关、现场命令仍不提交预约,自动完整最终提交及新回执归属尚待现场验收。 第 1–6 节的“待现场验收/自动模式不可启用最终提交”是历史阶段合同,以第 8 节为最新代码边界。** ## 1. 结论与边界 本轮仅改 Italy 代码、对应测试和文档,复用现有 `VSCloudApi.fetch_mail_content()`。 不改共享 SDK、邮件后台、nginx、其他插件、Booker 调度或生产配置;不改 Query 扫描。 没有执行真实登录、邮箱读取、OTP 发送、表单提交或预约确认。 已完成自动模式接线及离线验证。**真实自动接码仍待验收,不等于整个 Book 已可以上线。** 此前用户已经验证人工 OTP → Calendar → 选择日期时间;那不是自动接码验收。 `fetch-top` 找到测试邮件只能证明部分邮箱读取能力,不能证明本次 OTP 的时间筛选有效。 此前 `/fetch` 的 504 保留为外部依赖风险,按用户要求不继续调查或修改。 本次机械准出:人工模式回归通过;自动模式只调用一次现有取信接口;固定筛选参数; 账号/会话变化、过期、歧义码、读取失败时不继续 AVANTI;没有自动重发或 top 回退; 自动模式不可启用最终提交。现场验收是下一道门槛。 ## 2. 复用与文件归属 | 文件 | 本轮职责 | 复用内容 | |---|---|---| | `plugins/ita_protocol.py` | 邮箱配置、确定性 OTP 解析 | 现有 route 配置与纯解析模块 | | `plugins/ita_otp.py` | Italy 的薄适配器、固定诊断 | 现有 `VSCloudApi.fetch_mail_content`,不再写 IMAP/HTTP 客户端 | | `plugins/ita_workflow.py` | 选择人工/云端取码、关联一次发送与读取 | 现有 preflight、原生按钮、OTP DOM 回读、AVANTI、Calendar 准备 | | `plugins/ita_plugin.py` | 显式 `otp_mode=cloud` 分流 | 现有公开 `book()`、申请人重查、时段选择 | | `tools/debug_ita_book.py` | `--production-workflow --auto-otp` 验收入口 | 单次调用生产 `plugin.book()`,不是另一套模拟 Book | 设计采用组合:只替换“从哪里取验证码”,不重写登录、浏览器、表单、日历、选时段和调度。 通用 route 中配置服务、预约类型、旅游目的、邮箱;Hong Kong 仅是命令示例。 已有人工最终提交路径保留,本轮不扩大其授权。 ## 3. 自动模式如何工作 1. 申请人账户独立登录并重新检查目标服务;不相信 Query 的旧日期时间。 2. 进入真实表单,在发送前检查单人旅游 route、邮箱配置、会话和日志前提。 3. 复用已有 preflight,记录 UTC 发送时间和单调时钟,然后原生点击一次发送 OTP。 4. 确认本站返回 `SENT` 后,仅调用一次已有 `/fetch` 客户端方法。 5. 提取验证码;重新检查账号、Session、tab、页面路径及本地时间窗口。 6. 复用原有 OTP 输入与 DOM 一致性验证,再做 after-OTP preflight。 7. 尚未过期才点击一次 AVANTI,进入 Calendar,复用 Book 重查和选择逻辑。 8. 停在最终确认前:`final_submit_enabled=false`,不点击最终 Prenota。 同一进程复用原有准备阶段锁,串行准备;不新建队列或跨服务锁。 失败的准备保留同一 Session/标签/route 的尝试标记,重复信号不能自动重发。 这不是跨进程或跨重新登录的去重;现场请仅开一个 Book 进程,不要同时手工发码。 ### 邮件合同 | 参数 | 来源或规则 | |---|---| | `email` | route 的 `mail.authorization_email`,后台已登记的授权邮箱 | | `recipient` | 当前申请人站点 username,不取 Query 的账号 | | `sender` | 固定 `noreply-prenotami@esteri.it` | | `subjectKeywords` | 固定 `OTP Code`,不允许 CSV 扩大筛选 | | `bodyKeywords` | 固定 `OTP Code:` | | `sentDate` | 点击发送前记录的 UTC,`YYYY-MM-DD HH:MM:SS` | | `expiry` | 默认 300 秒;route 可设 1–300 的整数 | | `onlyText` | `true` | 解析仅接受 `OTP Code:` 上下文后六位 ASCII 数字,保留前导零。 HTML 只做非执行的文本投影;重复的同一码(plain + HTML)合并;不同码并存、 模板未知、超长或格式异常则拒绝。邮件不进入 LLM,不执行其中任何指令。 重要限制:后端只返回正文。客户端无法独立检查原始发件人、收件人或消息时间。 固定完整 sender 参数不等于后端精确地址匹配,更不等于发件人认证。 新旧邮件筛选依赖当前后台合同,现场尚未证明;不宣称“绝不会读到旧码”。 本地窗口只能拒绝迟到的返回,不能中断阻塞的 SDK 调用,也不是网站 OTP 有效期的证明。 UTC 时间只精确到秒,同一邮箱不要并行触发多个流程。 ### 失败行为 - `/fetch` 504、授权/权限错误、限流或异常:固定的 Italy 错误,不输出正文或原始异常。 - 邮箱 API 的 401 不伪装成预约网站 Session 失效,避免误导重登。 - 无邮件或多个不同码:停止,不提交,不改用 `fetch-top`,不自动改成人工读码。 - 取信后账号/Session/页面变了:丢弃码;窗口超时:不写入或不继续 AVANTI。 - DOM 写入失败:不继续 AVANTI;自动模式屏蔽可能包含输入值的浏览器异常。 - 人工模式保持原来行为,手工 OTP 输入可能保留在终端滚动记录。 Italy 不改公共日志配置。共享 SDK 在 DEBUG 下会记录正文,因此自动模式在发送前、 取信前检查其活动 logger;DEBUG 开启时拒绝自动运行。 需要整个取信期间保持 INFO 或更高等级,不能中途改 logger;这不是对后台日志、 第三方追踪系统或运行时日志热切换的全面脱敏保证。 ## 4. 本地操作:只做一次自动接码验收 ### 准备 确认后台已经登记将接收 OTP 的邮箱;站点登录账户也应能收到该邮箱中的验证码。 如果刚更换站点账号,确认它在香港且可以进入目标旅游服务。 本次不要同时运行另一个 Query/Book 准备过程,不要手动点击发码或最终确认。 不要把 Gmail 应用密码、邮箱后台 Bearer、网站密码放入这份文档或聊天。 Gmail 应用密码仍由已有后台管理,Coordinate 这里只需要授权邮箱地址。 ### 执行 在自己的终端执行下面命令。把 `已在后台登记的邮箱地址` 替换成真实登记地址; 例如本人刚换过账号,不能沿用旧邮箱。其余香港字段来自此前现场协议,不是通用默认值。 ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate ITA_ROUTING_KEY=slot.hkg.it.tourist \ ITA_SERVICE_ID=4937 \ ITA_CITY='Hong Kong' \ ITA_VISA_TYPE='Tourist' \ ITA_CALENDAR_LOOKAHEAD_MONTHS=12 \ ITA_BOOKING_TYPE_CONTROL_ID=typeofbookingddl \ ITA_BOOKING_TYPE_VALUE=1 \ ITA_BOOKING_TYPE_LABELS='Prenotazione Singola|Single booking' \ ITA_PURPOSE_CONTROL_ID=ddls_0 \ ITA_PURPOSE_VALUE=42 \ ITA_PURPOSE_LABELS='Turismo|Tourism' \ ITA_OTP_AUTHORIZATION_EMAIL='已在后台登记的邮箱地址' \ PYTHONDONTWRITEBYTECODE=1 \ python -B tools/debug_ita_book.py --production-workflow --auto-otp echo "EXIT_CODE=$?" ``` 1. 按提示在终端输入**申请人的 Prenot@Mi 登录账号和密码**,不是后台管理账号。 此模式只读取 `ITA_BOOK_USERNAME`/`ITA_BOOK_PASSWORD` 或提示输入,不静默借用 Query 账号。 2. 浏览器如需本人处理验证,正常处理;脚本不替你绕过验证。 3. 正常自动模式不再询问 `Italy booking OTP`:由后台查询新邮件、输入和回读。 4. 等待脚本结束,不另外点击 AVANTI 或 Prenota,也不要连续重跑。 ### 看什么结果 正常进入流程应看到 `ITA_BOOK_WORKFLOW_OTP mode=cloud final_submit_enabled=false`。 正向验收需要同时满足: - 取信成功后出现 `Italy automatic OTP DOM write verified`;没有人工 OTP 提示。 - `ITA_BOOK_WORKFLOW_RESULT` 中 `selectionVerified=true`、`finalSubmissionEnabled=false`。 - 请求统计 `otpRequests=1`、`avantiPosts=1`、`finalRequests=0`。 - 正常清理、`EXIT_CODE=0`。`bookResultSuccess=false` 是预期:本次并未最终预约。 如果没有号,不能据此判定整条选时段链路通过。如果是 mailbox read failed/504, 则自动接码这一环未通过,禁止以 `fetch-top` 成功代替;本轮先保留人工方式,不修后台。 回到人工方式只需在**下一次人工决定的独立尝试**中去掉 `--auto-otp`,不是失败后自动回退。 不要提供完整邮件、验证码或请求头;只回传上述状态与脱敏错误即可。 ## 5. 测试、准出与后续 离线测试覆盖:固定 API 参数、前导零/HTML 重复、歧义/异常格式、无 top 回退、 DEBUG 时零取信和零发码、SDK 200/401/403/429/504 的假传输、异常脱敏、 发送时间顺序、当前申请人绑定、迟到返回/提交前过期、DOM 失败、同 Session 防重发、 人工兼容、公开 Book 路由及自动模式最终提交禁用。 执行命令: ```bash PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q \ test.test_ita_otp test.test_ita_workflow test.test_debug_ita_book \ test.test_ita_protocol test.test_ita_plugin test.test_ita_calendar_book \ test.test_ita_calendar_book_flow test.test_ita_calendar_query \ test.test_ita_booker_integration test.test_ita_booking_final \ test.test_ita_final_attribution test.test_ita_final_read_port \ test.test_debug_ita_calendar_gate test.test_debug_ita_production_query_gate ``` 2026-08-31 最终验证记录: | 检查 | 结果 | |---|---| | 上述 14 个模块的离线回归 | 387 tests,OK,退出码 0 | | `python -B tools/debug_ita_book.py --help` | 可见 `--auto-otp`,退出码 0;未登录或联网 | | `git diff --check` | 无输出,退出码 0 | | 共享 SDK、日志宏、Booker、两个生产配置的 SHA-256 前后比对 | 全部相同,未改动 | | 真实自动取信及站点验收 | 未执行,待用户终端操作 | 测试全部是假邮箱/假浏览器或本地 JS fixture,不依赖真实账号。 离线通过不能证明部署的邮箱权限、过滤语义、延迟、网络和真实邮件模板均满足要求。 进入自动完整 Book 的下一道门槛:先真实通过上述预确认验收,再单独评估最终提交开关, 沿用现有 final attribution/去重/结果不明处理,不另造最终预约实现。 审查反驳:“top 已找到邮件,为什么不直接用 top 自动接码?” 答:top 没有本次发送时间的过滤,正文又没有可核对的消息时间;读到旧码会白白消耗 预约窗口。本轮复用带时间参数的现成接口,并把未通过的现场依赖明示,不扩大到后台改造。 ## 6. 2026-08-31:表单验证等待修复 ### 新现场证据及结论 用户自动 Book 验收停在 `/Services/Booking/4937`,标题 `Booking - Prenot@Mi`, 错误为 `Turnstile did not become ready before timeout`。审计中 OTP、AVANTI、Calendar、 最终提交请求均为 0;退出码 1,清理成功。**本次根本没有调用自动取信接口。** 已确认的两个代码缺陷: 1. `wait_for_booking_preflight` 将“缺少 Turnstile 结果”和“AVANTI 禁用”合并成同一错误。 离线分别输入 token=false/button=false、token=true/button=true,旧代码均返回同一句错误。 2. Italy Book 没有接入 VFS 已用的共享验证交互,而且生产调用没有传诊断函数,超时也 不输出最后状态,导致无法知道上述哪个条件失败。 这不证明用户当时一定需要点击验证框,也不能证明网络、控件加载或网站回调没有问题。 修复已确认缺陷后,仍需一次真实现场验收;不宣称唯一根因或 100% 实站成功。 ### 实现和复用边界 - 等待、严格结构校验、状态分类仍在 `plugins/ita_calendar_session.py`,不建第二套表单流程。 - 新增 `plugins/ita_turnstile.py` 的小型组合适配器,直接复用 VFS 的 `CloudflareBypasser.click_verification_button(is_dfs=False)`,共享工具未改动。 - 不调用该工具的通用 `bypass()`:它基于页面标题判断成功,会把正常 Booking 标题当作 已离开挑战页,不能证明表单里的 Turnstile 已准备好。 - 只在单一验证字段存在、表单与当前申请人 Session/标签仍匹配、结果缺失时尝试交互。 第一次等待至少 5 秒,随后间隔至少 10 秒;每次 Book 准备最多 3 次尝试,前后 OTP 两个阶段共享预算。交互返回成功也必须下一轮重新读取并验证网页状态。 - 如果 token 已存在而只是 AVANTI 禁用,不触碰验证组件,不强制启用按钮。 - 不自动刷新整页、不重置组件、不伪造/注入 token、不做广泛 DFS、不改变业务请求次数。 超过交互预算仍允许用户在剩余等待窗口内正常处理验证;轮询期限仍为原来的 120 秒。 浏览器调用自身的阻塞不受硬墙钟中断,不承诺整个操作精确在 120 秒内结束。 - 仅正常 Book workflow 启用主动交互;Query 准备和旧诊断 Gate 默认仍是被动等待。 Query 扫描、其他插件、共享 SDK、生产配置未更改。 ### 新日志如何判读 默认诊断会在首次等待、状态变化、每约 15 秒、就绪/拒绝/超时时输出: ```text ITA_BOOK_PREFLIGHT_DIAGNOSTIC={...} ITA_BOOK_TURNSTILE_INTERACTION={...} ``` `contract` 为 `ita-book-preflight-v2`,状态含义: | state | 确定的观察 | 不能据此断言 | |---|---|---| | `turnstile_token_pending` | 未读到验证结果,AVANTI 未禁用 | 一定是验证码失败或需要点击 | | `avanti_disabled` | 验证结果存在,AVANTI 仍禁用 | 再做一次验证就能解决 | | `turnstile_and_avanti_pending` | 两个条件都未满足 | 哪个条件先导致问题 | | `ready` | 严格 preflight 已通过 | 最终预约成功 | 诊断只输出白名单布尔值和计数,包括 `turnstileApiPresent`、`turnstileScriptPresent`、 `documentVisible`;脚本标签存在不等于加载成功,API 存在不等于验证通过。 不读取/输出 token 值、完整 HTML、申请人资料或任意错误正文。 `clicked=true` 只代表交互工具报告点击成功,不是验证完成;`clicked=false` 也不证明被封禁。 ### 验证和现场下一步 新增 `test.test_ita_preflight`,并扩展 `test.test_ita_workflow`,覆盖三种超时分类、 默认诊断脱敏、交互间隔和上限、跨阶段预算、Session 变化、异常收敛、 有 token 时不重复操作、点击后必须重新验证、Book 未就绪时零 OTP/零取信、Query 不启用交互。 最终离线回归:本文件第 5 节的 14 个模块,加 `test.test_ita_preflight` 和 `test.test_debug_ita_book_gate`,共 **484 tests,OK,退出码 0**。 未执行真实网站验证;未发送 OTP 或预约。 现场继续使用第 4 节完全相同的命令,无需新增配置。观察自动打开的浏览器, 如果页面要求本人验证则正常处理,不额外点击 OTP/AVANTI/Prenota。 成功时应经过 `state=ready` 再出现发码/自动取信日志。 失败时回传上述两个新前缀、`ITA_BOOK_FAILED` 和 `ITA_BOOK_WORKFLOW_AUDIT`; 如果仍卡住,新日志至少可以分清验证结果缺失和按钮未恢复,而不是重复猜测。 审查反驳:“既然调用了 VFS 工具,就已经证明这次故障被根治了?” 答:没有。复用解决的是 Italy 缺少现成验证交互的代码缺口;网站当时的真实失败原因 没有被保存。必须以本次网页重新读回的状态和后续零/单次请求审计验收,不能以工具 返回 true、旧测试通过或正常页面标题作为实站成功证据。 ## 7. 用户现场验收通过:自动 OTP 到预确认 记录日期:2026-08-31。来源:用户在自己的终端执行本线程前述香港单人旅游 Book 命令后回传的日志,非本助手直接操作或独立 Network 抓取。诊断合同为 `ita-book-preflight-v2`;本段日志未包含启动时的 service_id,香港 4937 来自前置命令上下文。 本轮只记录验收结果,没有修改代码、重新运行脚本、发 OTP 或提交预约。 ### 观察到的顺序 1. before-OTP 状态为 `turnstile_token_pending`:AVANTI 未禁用、页面可见、表单与 PrivacyCheck 就绪、API/脚本存在、单一验证字段存在,但验证结果缺失。 2. 共享交互第 1 次尝试报告 `clicked=true`、`helperFailed=false`。 3. 下一次真实页面回读变为 `state=ready`、`turnstileTokenPresent=true`,不是仅凭点击返回值放行。 4. 发送一次 OTP,自动查询授权邮箱,OTP DOM 写入回读 `matched=true`。 5. after-OTP 状态 `ready`;`otpDisabled=true` 是发码后的按钮冷却,不阻断后续提交。 6. 进入申请人的 Calendar,重新查询;2026-08 候选日期为 0,2026-09 为 1。 7. 选择 `2026-09-23`、`09:15 - 10:00`,余量快照为 1;选择回读成功后停在最终确认前。 8. 清理成功,退出码 0。 脱敏结果快照: ```json { "bookResultSuccess": false, "finalSubmissionEnabled": false, "selectionVerified": true, "selectedDate": "2026-09-23", "selectedTime": "09:15 - 10:00", "remaining": 1, "requests": { "availabilityRequests": 3, "avantiPosts": 1, "finalRequests": 0, "otpRequests": 1, "timeSlotRequests": 2 }, "cleanup": "ok", "exitCode": 0 } ``` 最终 `ITA_BOOK_WORKFLOW_AUDIT` 与结果内请求统计一致。 未保存邮箱地址、密码、OTP、Token、完整邮件或请求头。 ### 可以确认与不能扩大解释的部分 - 本次预确认流程通过:网页验证交互、自动取信与填码、前置表单提交、日历重查、时段选择。 - 本次卡点确实是验证结果缺失,而非 AVANTI 禁用;交互后网页回读满足条件,支持本次修复有效。 旧失败轮次没有这些状态证据,不能据此追溯性证明所有超时只有同一个根因。 - `bookResultSuccess=false` 符合预确认合同;`finalRequests=0`,本次没有发出最终预约请求, 不能称为预约成功。余量 1 只是当时快照,不代表保留、锁定或现在仍有号。 - 本次证明云端取信链路成功了一次,不证明此前 504 的原因已被修复、永不超时, 也不扩大为所有邮箱/机构/模板或并发场景都已现场验证。 - 本段日志没有预约列表前后快照,不声称已独立证明服务器无草稿、无其他隐藏状态变化。 下一道门槛是最终提交及回执归属验收。执行前必须明确申请人和可接受日期范围, 在新的会话里重新读取号源并取得明确最终提交授权;不能重放本次日期、时段或旧上下文。 继续复用现有最终提交、去重和结果不明处理,不在本次记录操作中改变开关。 ## 8. 自动 OTP 与现有最终提交接线、无提交回执验收入口 日期:2026-08-31。用户“OK 继续推进”授权本地实现与离线验证;不等于授权这轮创建真实预约。 本轮未执行真实浏览器、取信、OTP、AVANTI 或最终提交,未改生产配置、共享 SDK、邮件后端、 VFS/BLS/TLS、Query 算法或 Booker。未读取、创建、删除本地真实 final claim。 ### 8.1 最小复用方案与实际改动 - `plugins/ita_plugin.py`:复用 `_book_final_configuration_valid()` 统一配置检查,允许申请人 `services_probe` 模式在 `otp_mode=manual/cloud` 且显式布尔 `final_submit_enabled=true` 时接入已有最终提交。默认仍为 false;字符串 `"true"`、数字 `1` 不合法,Query 不可启用。 - `plugins/ita_workflow.py`:去掉自动 OTP 的阶段性 pre-final 限制,改为复用同一申请人配置检查。 OTP 准备本身不执行最终提交;新鲜日历和时段选择仍由既有 Book 完成。显式开启后原样调用 `submit_final()` → `FinalBookingAttempt` → `NativeFinalSubmitter` → `FinalReceiptReadPort`。 未复制最终 POST、回执解析、成功上报、锁或调度器。 - `tools/debug_ita_book.py`:增加 `--verify-receipts`,仅允许与 `--production-workflow` 一起使用。 在公开 `plugin.book()` 完成预确认选择后,直接复用既有 Book gate 的 `_verify_receipt_baseline()`: 同浏览器同会话后台标签读取列表及详情、检查身份和状态、核对读取前后列表、关闭自建标签、 重验原 Calendar 选位。复用其后台标签请求审计,并额外确认主标签业务计数没有变化。 普通 CLI 仍固定 `final_submit_enabled=false`,没有新增最终提交 CLI 开关。 设计仍是组合:验证码来源与最终提交是两个独立开关。允许自动取码不等于允许创建预约, 邮件正文不决定申请人、日期、路线或开关。固定筛选、六位 ASCII 解析、过期/会话检查、 日志保护均未放宽;body-only 后端的发件人认证和时间证据限制仍保留,不增加邮件服务。 ### 8.2 本轮验证与准出 离线测试新增/扩展于 `test/test_ita_workflow.py`、`test/test_debug_ita_book.py`: - 自动模式显式 final 开启时,重跑同一组 OTP 过期、账号变化、读取失败、DOM 写入验证、 禁止 Query 接码、禁止重复发送、日志保护用例;准备阶段不调用 final。 - 自动模式仍默认停在 pre-final;显式开启后先重查选位再调用已有 submitter;无号不提交。 - 已知 unknown 不再扫描/提交,confirmed 结果可重报而不再次预约;Query Session 和其他申请人被拒绝。 - 自动模式复用真实本地回执解析器和最终核心:匹配请求加确认回执成功;缺请求证明保持 unknown; 清理审计失败不抹去已确认结果(全部是离线替身,不是真实提交)。 - 新 CLI 标志默认关闭、必须显式工作流、与 auto-OTP 共存、仅调用一次公开 Book;回执失败 或读取中业务请求变化不报通过;无候选时不读取回执也不报正向验收成功。 2026-08-31 执行以下 16 个模块,**508 tests,OK,退出码 0**: ```text test.test_ita_preflight test.test_ita_otp test.test_ita_workflow test.test_debug_ita_book test.test_ita_protocol test.test_ita_plugin test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_calendar_query test.test_ita_booker_integration test.test_ita_booking_final test.test_ita_final_attribution test.test_ita_final_read_port test.test_debug_ita_calendar_gate test.test_debug_ita_production_query_gate test.test_debug_ita_book_gate ``` `PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_book.py --help`:退出码 0,新标志可见。 `git diff --check`:退出码 0。其他插件、共享验证码工具、邮件 SDK 和两份生产配置 SHA-256 与本轮前记录一致。以上是本地研发验收,不代表已部署或自动最终预约现场通过。 ### 8.3 下一道现场门槛(不创建预约) 沿用第 4 节路由和已授权邮箱,只将命令结尾改为: ```bash .venv/bin/python -B tools/debug_ita_book.py --production-workflow --auto-otp --verify-receipts ``` 申请人独立登录 → 一次 OTP/一次 AVANTI → 重查选位 → 读取已有预约 → 校验选位不变 → 清理退出。 应回传 `ITA_BOOK_WORKFLOW_RECEIPT_BASELINE`、`ITA_BOOK_WORKFLOW_RESULT`、 `ITA_BOOK_WORKFLOW_AUDIT` 和退出码。要求 baseline `verified=true`、 `calendarSelectionPreserved=true`、后台业务请求全 0、最终请求为 0、退出码 0。 基线读取沿用已有约束:仅接受空预约列表或可完整核对的已取消历史。存在有效预约/候补、 未知状态、覆盖不完整或同会话校验失败就停止,不会自动取消或修改旧预约。回传失败信息即可, 不要为让测试通过而删记录/取消预约。新检查对该账号尚待现场验证。 通过后再确定真实申请人、可接受日期范围及最终提交授权;实际日期必须重新查询,不重放第 7 节快照。 最终动作后必须以匹配请求及新确认回执归属判断成功;结果不明保持暂停,不自动重试。 既有进程内防重、Booker 暂停和本地受控 gate 的 claim 不等同跨进程 exactly-once; 本轮没有增加分布式保证,也没有开启生产 final 或删除既有最终尝试记录。 ## 9. 用户现场验收通过:自动 OTP、选位与空回执基线 记录日期:2026-08-31。来源:用户在自己的终端执行第 8 节新增的 `--production-workflow --auto-otp --verify-receipts` 命令后回传的末段日志。 本助手未独立控制浏览器或抓取 Network;香港 4937 路由来自前置命令上下文, 本次日志片段未包含完整启动配置或代码指纹,不额外推定账号身份。 ### 9.1 观察到的结果 - before-OTP 验证结果最初缺失,共享交互第 1 次报告 clicked=true,后续页面回读 ready。 - 一次 OTP 发送后,自动取信与写入回读通过;after-OTP preflight 为 ready。 - 申请人 Calendar 重查:2026-08 candidates=0,2026-09 candidates=10。 - 当次选位:2026-09-01、10:05 - 11:05,余量快照为 1,selectionVerified=true。 - 回执基线 verified=true、recordCount=0;calendarSelectionPreserved=true。 - 回执读取后台标签的五类受审计业务请求均为 0。 - 总计:availabilityRequests=3、avantiPosts=1、finalRequests=0、otpRequests=1、timeSlotRequests=2。 结果内计数与最后 WORKFLOW_AUDIT 一致;cleanup=ok,EXIT_CODE=0。 脱敏核心证据: ```json { "receiptBaseline": { "verified": true, "recordCount": 0, "calendarSelectionPreserved": true, "finalSubmissionEnabled": false, "businessRequests": { "availabilityRequests": 0, "avantiPosts": 0, "finalRequests": 0, "otpRequests": 0, "timeSlotRequests": 0 } }, "selectionVerified": true, "selectedDate": "2026-09-01", "selectedTime": "10:05 - 11:05", "remaining": 1, "bookResultSuccess": false, "finalSubmissionEnabled": false, "finalRequests": 0, "cleanup": "ok", "exitCode": 0 } ``` ### 9.2 准出与后续边界 本次通过第 8.3 节的现场门槛:自动 OTP 至预确认选择、空预约列表的同会话基线读取, 以及读取后选位保持。`bookResultSuccess=false` 是预确认模式的预期结果,不是流程失败。 空基线只证明本次完整读取到 0 条记录,**没有现场覆盖非空预约详情、已取消历史、 新确认回执解析或提交后的归属核对**。不能将“列表可读”当作“最终预约已成功”。 受审计业务请求为 0 不等于所有 HTTP 请求为 0,也不证明不存在服务器内部草稿/会话状态变化。 日期和余量是当时快照,未锁定或保留;下一次可能变化,不直接重放。 下一步只需先明确真实预约可接受的日期范围,再落实申请人、单次最终提交授权及受控执行入口。 实际提交前重新读取当前号源;提交后要求匹配请求与新确认回执,结果不明则停止、不重提。 不为重复验证空基线而再次发 OTP;不取消、删除既有预约来制造验收条件。 本轮只更新本文件,没有修改代码、生产配置、运行测试或请求真实网站/邮箱。 第 8 节 508 项测试仍是上轮离线证据,不声称本轮重新执行。 ## 10. Query 首次日历准备复用自动 OTP(代码已验证,现场待配置) 2026-08-31,用户授权把 Book 已有自动接码接入 Query。此前公共测试器在人工 OTP 模式已通过:一次验证框操作后 token 就绪,人工验证码 DOM 回读通过,扫描首个正向月份返回 `2026-09-01`,清理成功、exit 0。这个现场记录不是 Query 自动接码证据。 ### 10.1 最小改动与复用边界 - `plugins/ita_plugin.py`:允许 `query_mode=calendar` 搭配 `otp_mode=cloud`,公开 Query 与人工模式一样进入现有准备函数;Query 开启最终提交仍被拒绝。 - `plugins/ita_workflow.py`:Query/Book 根据显式角色与配置复用同一自动 OTP 分支。Query 必须是 Calendar 配置,Book 必须是申请人配置;账号身份、当前 tab/session、验证码有效窗口和最终开关检查继续有效。 - 沿用原来的 `ita_otp.fetch_otp_from_cloud()` → `VSCloudApi.fetch_mail_content()`,未新增 API、IMAP、邮箱监听或自动化调度器。共享 SDK、VFS/BLS/TLS、邮件后端均未修改。 - 发送 OTP 前记录 UTC 时间和单调时钟;以当前插件账号为收件人、配置的授权邮箱为读取目标。发送一次、读取一次,读取失败不回退人工、不改用 fetch-top、不在同一准备会话重复发码。 - 已准备 Calendar 的查询跳过 OTP/AVANTI,照原算法逐月扫描。会话失效后的已有恢复策略未修改,不宣称池账号的所有恢复情况已无人值守。 ### 10.2 邮箱绑定与信任边界 沿用 `apt_configs[routing_key].mail.authorization_email` 配置。它可以是账号自身邮箱,也可以是确实接收该账号转发邮件的已授权收件箱;程序不猜测转发关系、不把 Book 的邮箱自动借给 Query。 固定发件人筛选 `noreply-prenotami@esteri.it`、主题 `OTP Code`、正文标记 `OTP Code:`、当前账号 recipient、发送时间窗口,以及带标记的六位 ASCII 数字解析均保持不变。不记录正文/验证码,不把邮件当指令、不送入大模型。这延续 `agent-email-inbox` 技能的固定来源与不可信输入处理原则,不引入 Resend 或其他新服务。 共享接口仍只返回正文,From/To 子串匹配和邮件接收时间筛选依赖既有后端,不能据此宣称已独立验证发件人认证或邮件归属。既有 HTTP/IMAP 超时和可能置已读的行为也未在本轮修改。 ### 10.3 当前配置状态及复测方法 只读检查发现:本地测试/调度配置无 `mail.authorization_email`,当前进程及 `.env` 也没有 `ITA_OTP_AUTHORIZATION_EMAIL`。因此暂未把公共测试配置从 manual 改成一个缺邮箱地址的 cloud 配置。已向用户询问本次 Query 应读取的后台授权邮箱;本轮没有真实发码、取信或登录。 确认地址后可继续使用公共测试器,在上一条命令中、`run_pipeline()` 之前设置: ```python import os from plugins.ita_protocol import OtpMailConfig, resolve_route_config from plugins.ita_otp import validate_cloud_otp_environment mail = OtpMailConfig(os.environ["ITA_OTP_AUTHORIZATION_EMAIL"]) validate_cloud_otp_environment(mail, account.username) config = tester.config.free_config config.update(query_mode="calendar", otp_mode="cloud", final_submit_enabled=False) for appointment in tester.appointment_types: config["apt_configs"][appointment.routing_key]["mail"] = { "authorization_email": mail.authorization_email, } resolve_route_config(config["apt_configs"], appointment.routing_key) ``` 此单邮箱示例只用于确认过邮箱映射的本次单账号测试,不是自动建立账号池邮箱绑定。DEBUG 邮件正文日志必须保持关闭;缺邮箱或日志不符合要求时在发送 OTP 前终止。网站仍可能要求人工完成人机验证,但不再应出现终端 OTP 输入提示。 ### 10.4 新鲜验证与准出 - 定向 workflow / OTP / preflight:95 项通过,exit 0。 - Italy 19 模块回归:561 项通过,exit 0。 - 新增 8 项 Query 自动接码测试,复用 Book 表单 fixture 与真实 OTP 解析适配器:公开 Query 连续两次只准备一次、固定 SDK 筛选和收件人、无号不发码、失败不重发/不人工回退、过期拒绝、账号变更拒绝、歧义正文拒绝、缺邮箱拒绝、Query 与 Book 角色/最终开关隔离。其中角色与开关分支在同一测试中覆盖。 - 所有网站/邮件返回为合成数据;未运行真实取信或预约。Query 自动 OTP 的现场准出仍是:自动取得并回读验证码 → Calendar 查询结果 → 清理成功,且没有最终预约请求。 ### 10.5 单账号池配置已确认(2026-08-31) 用户确认 `hkg.it.sentinel` 已录入测试账号,且同名 Gmail `chatgptshareplus@gmail.com` 已登记邮箱授权。香港 Sentinel 新配置及公共测试配置现使用 `otp_mode=cloud`,路由 `mail.authorization_email` 指向该邮箱。此前 10.3 的“等待确认邮箱”已解除;本轮不再次登记账号/邮箱,不读取或保存应用专用密码。 只复用现有账号池 SDK、Book/Query 共享 OTP 适配器和公共测试器。收件人动态取自所选池账号,固定发件人、主题、时间窗口与验证码解析不变;不新增邮箱服务、不把邮件交给大模型。香港组保持禁用,真实取池账号和接码尚需用户执行 [一次性验收命令](ita_query_book_acceptance.md#121-一次性池账号-query-验收)。一个池中扩容多个独立收件邮箱时,必须先补齐相应映射/转发验证,不能只添加账号就假定当前单邮箱配置适用于所有账号。 ### 10.6 用户现场回传:Query 自动接码已通过 2026-08-31 用户回传:自动邮箱读取分支执行,`OTP_DOM_WRITE_VERIFIED matched=true`,后续 `otpValuePresent=true`,成功进入 Calendar;逐月查询从首个无号月份推进至首个正向月份,返回当时最早日期 `2026-09-01`、Available,cleanup 成功,公共测试器全部 PASS,`EXIT_CODE=0`(总耗时 98.49 秒)。本次没有记录任何 OTP 值或邮件正文。 这补齐了当前测试账号 Query 自动接码的真实证据,不代表常驻恢复、多邮箱池或 Book 最终提交已通过。所贴日志缺少开头池来源标记,来源边界及下一节点见 [现场验收记录 12.3](ita_query_book_acceptance.md#123-用户现场回传自动-otp--query-通过)。不为补来源日志重新发送验证码。本轮只更新文档,未运行网站/邮箱请求或更改配置。 ### 10.7 多账号直接收件:不再固定测试邮箱 用户授权解除单账号限制后,香港 Query 两份配置改为: ```json "mail": {"authorization_source": "account"} ``` 领取 A 账号就从 A 的后台授权邮箱读取;领取 B 账号就读取 B。既有生产 OTP 适配器按调用解析,不修改共享配置,所以后续新账号无需再修改固定邮箱地址。每个自己的收件邮箱仍须已登记授权;缺授权时不会借用旧账号邮箱或回退 fetch-top。 原来 `"mail": {"authorization_email": "authorized-inbox@example.test"}` 默认仍为 `configured` 模式,兼容已有统一/转发收件箱与 Book 配置。两种模式显式选择,`account` 模式不能同时填固定 `authorization_email`。协议中的固定发件人/主题/正文标记、时间窗口、OTP 格式和当前账号身份检查保留,邮件仍作为不可信数据处理,不引入新的邮件服务或大模型。 完整替代命令与验证记录见 [验收记录第 13 节](ita_query_book_acceptance.md#13-解除单账号邮箱限制使用实际池账号的授权邮箱)。不要只在旧命令中删掉相等检查后继续使用旧固定邮箱配置;请使用已更新的完整命令。