# Italy Query → Book:复用现有框架的验收 更新日期:2026-08-31。合同:`existing-framework-offline-v2`。 **本轮完成的是“真实框架代码 + 模拟外部依赖”的离线协同验收,不是真实网站、真实 Redis 或上线验收。** ## 1. 用户要求与这次纠偏 - Query 使用团队已授权的池账号。 - Book 使用目标申请人的订单账号。 - 从大到小尽最大努力复用 VFS/BLS/TLS 现有实现,不再开发 Italy 专用调度、信号或接码基础设施。 - 通用短期申根旅游签证、单人预约;香港只是现场案例,不在联调代码中硬编码地区或真实日期。 - 不操作正式订单,不执行真实最终预约。 上一版 `tools/debug_ita_query_book.py` 虽然复用了生产插件和 SDK,却自己维护了内存信号、TTL 和单次消费,又编排了一套账号与浏览器生命周期。这不符合“最大化复用”。 本轮移除这些实现,包括 `LocalQuerySignal`、独立池账号适配、JSON 拼装/消费、手工 Book 派发和独立 session 管理。**旧 `--run` 参数已经失效,不能再照上一版命令执行。** 文件保留为薄薄的离线测试入口,不是另一套协调器。 ## 2. 实际使用哪些现成代码 | 环节 | 本轮实际执行的方法 | 未再实现的能力 | |---|---|---| | 池账号领取、Query 配置及 Task 创建 | `SentinelGCO._spawn_sentinel_worker()` | 账号选择、冷却参数、配置绑定、失败清理 | | 实际查询、快照生成和发布 | `SentinelGCO._monitor_loop()` → `ItaPlugin.query()` → `redis_client.setex()` | 查询调度、JSON envelope、TTL 发布 | | 订单领取、申请人凭据绑定 | `OrderBookerGCO._spawn_worker()` | 订单队列名、账号映射、任务身份和可接受路由 | | 读取快照并触发订单 | `BaseBookerGCO._booking_trigger_loop()` | JSON 解码、路由筛选、订单日期筛选、冷却、线程创建和 join | | 实际执行预约逻辑 | `OrderBookerGCO._execute_book_job()` → `ItaPlugin.book()` | 订单有效性检查、用户输入传递、成功/失败处理 | | 重新查日期/时段 | 现有 `ita_workflow`、`ita_calendar_book` | 不使用 Query 的旧库存直接选中时段 | | 停止与清理 | 两个现有 GCO 的 `stop()` | 不新建生命周期管理器 | | 其他既有契约 | 原有信号保留、订单结果和 Sentinel 恢复测试 | 不复制已有测试场景的业务实现 | 本地配置中 BLS/TLS 使用 `account_source=order`,VFS 使用 `built-in`;`main.get_gco_class()` 按这个配置选择共同框架。你的需求对应 BLS/TLS 的 **OrderBookerGCO**,不是把所有插件都强行改成同一种账号模式。 既有自动 OTP 继续使用 `VSCloudApi.fetch_mail_content()`;邮件只通过原有筛选与确定性验证码解析,不当作指令、不送给大模型。本轮没有修改邮箱服务,也没有新增邮件组件。 ## 3. 哪些是真实代码,哪些是模拟 **真实执行:** 上表的 GCO 构造、池/订单创建方法、两个循环、Task 数据结构、快照序列化/反序列化、订单条件判断、Book 线程、Italy 的日期扫描与库存重查、框架停止逻辑。 **仅模拟外部边界:** - 账号池/订单 API 返回合成账号和合成订单;不上云领取真实资源。 - Redis 使用已有 `FakeRetainedSignalRedis` fixture 和 Mock 命令边界;不建立真实 Redis 连接。 - 插件工厂的创建返回既有合成浏览器 fixture;未测试动态模块加载。 - 浏览器已经处于模拟的准备好 Calendar 状态;本轮不把实际登录、OTP、AVANTI 当成协同实测证据。 - 浏览器清理是 Mock;测试验证的是 GCO 确实调用清理,不是 OS 上真实浏览器进程已退出。 - 云端报告/通知/执行器使用 Mock。 - 为有限次测试,只控制现有循环的退出事件和时钟;不复制循环内部业务代码。 新增测试会阻止真实 socket 连接、HTTP 请求和子进程启动;真实框架的 Book 线程仍照常创建并 join。 所以,“框架方法被验证”不等于“真实 Redis 时效、真实池冷却、真实邮箱和网站都通过了”。 ## 4. 保留现有规则,不另立 Italy 规则 1. **信号不是全局消费一次。** 同一条有效信号可以触发多个符合路由和日期条件的订单,每个订单使用各自的账号。 2. **同一订单不是永远只能触发一次。** 当前框架按 `booking_cooldown` 与订单状态判断;信号仍有效、冷却结束时,可能再次调用 Book。不能拿上一版单次消费语义替换它。 3. **TTL 交给 Redis。** Sentinel 传递配置的 TTL;Booker 从 Redis 取不到数据就不触发。不另写 Italy 单调时钟或过期解码器。 4. **新的无号查询不会主动删除此前的有效信号。** 这是现有 Sentinel 行为;旧信号保留到过期,Book 必须重新查当前库存。本轮记录并验证,不擅自修改公共策略。 5. **查询结果不等于预订结果。** Query 可以报告有日期,Book 在申请人会话中发现该日期已经无号,再按订单条件回退寻找可用日期。 6. 快照原本不包含 `success`,Booker 解码后它默认是 false;保持这个现成合同,不补造 true。 7. 订单的 `expected_end_date` 先由 Booker 筛选;起止日期仍传给真实 Book 做选择。不能在测试入口丢掉订单条件。 8. 当前公共框架没有我们上一版额外添加的“两端账号必须不同”全局校验。本轮使用两个不同合成账号验证来源和隔离,不新加公共政策。 9. 新协同用例均保持最终提交关闭,pre-final 不更新订单成功、不通知。复用的旧 Book 集成套件还会模拟最终成功与未知结果,用于覆盖原有分支;所有网络与回执均为合成数据,不会创建真实预约。 这些是复用边界,不是宣称现有公共框架具备完美的分布式幂等或无限自动恢复能力。 ## 5. 文件与开发范围 仅修改此前本任务新增的三个文件: - `tools/debug_ita_query_book.py`:离线测试入口,原 341 行缩减为 55 行;没有自建信号、调度、账号领取或浏览器流程。 - `test/test_debug_ita_query_book.py`:真实框架协同测试与 CLI 边界测试,复用既有 Query、Book、Redis fixtures。 - 本文:替换旧方案及过时现场命令,保留纠偏原因和证据。 未修改 Sentinel、Booker、共享类型、Italy 生产插件、VFS/BLS/TLS、共享 SDK、正式配置。工作区原有修改全部保留,没有提交或部署。 设计方式:组合既有实现,并在测试中替换外部依赖;没有新增公共框架、调度模式或运行时抽象。 ## 6. 离线验证证据 新增/替换文件中的 18 项测试覆盖: - 池账号 Query、订单账号 Book、真实 JSON 传递、用户会话重新查号。 - 池/订单缺失、登录失败后的现有清理与退避。 - 无号、协议错误不发布正向信号。 - 过期信号不触发;有效信号遵循现有订单冷却。 - 路由不匹配、日期不匹配、暂停订单。 - 无效 JSON 进入原有删除分支。 - 同一信号触发两个分别绑定的订单。 - 后续无号查询保留此前尚未过期的信号。 - 旧 `--run` 拒绝;空、跳过或失败套件不得报告通过。 2026-08-31 当前代码实测: | 命令/范围 | 结果 | |---|---| | `python -B -m unittest -q test.test_debug_ita_query_book` | 18 tests,OK,exit 0 | | `python -B tools/debug_ita_query_book.py --offline` | 新框架用例 + 既有复用用例,共 26 tests,OK,exit 0 | | Italy 相关 18 个模块回归 | 546 tests,OK,exit 0 | 18 个回归模块是:`test_ita_preflight`、`test_ita_otp`、`test_ita_workflow`、`test_debug_ita_book`、`test_ita_protocol`、`test_ita_plugin`、`test_ita_calendar_book`、`test_ita_calendar_book_flow`、`test_ita_calendar_query`、`test_ita_booker_integration`、`test_ita_booking_final`、`test_ita_final_attribution`、`test_ita_final_read_port`、`test_debug_ita_calendar_gate`、`test_debug_ita_production_query_gate`、`test_debug_ita_book_gate`、`test_debug_ita_query_book`、`test_ita_query_recovery`,均位于 `test` 包中。 首次运行新用例时,Query fixture 的准备标记被真实 `set_config()` 清除,导致无法发布。这是测试装配问题:修正为在模拟登录/准备完成后记录标记;没有删除生产检查,也没有改 Query 算法。正向用例同时断言真实发布确实发生,避免“没有执行任何逻辑也通过”的假阳性。 ## 7. 你现在可以执行的命令 在自己的终端: ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_query_book.py --offline echo "EXIT_CODE=$?" ``` 不需要填写任何账号、密码、池名或邮箱;不会打开浏览器。预期: ```text ITA_QUERY_BOOK_TOOL=existing-framework-offline-v2 Ran 26 tests ... OK ITA_QUERY_BOOK_FRAMEWORK_RESULT=... "passed": true, "liveAcceptance": false ... EXIT_CODE=0 ``` 不要再使用旧 `--run` 命令,也不要为了现场验收直接启动现有生产配置。 ## 8. 下一阶段准入条件 离线框架复用验证已完成;真实协同还需要独立验收: 1. 确认隔离测试环境:测试 API/订单和 Redis,不连接正式订单。当前尚未确认环境是否存在。 2. 确认香港 Query 池名及账号机构/服务适用性;本地的 `ie.it.sentinel` 是 Dublin 配置,不能直接推定可用。 3. 使用现有 GroupConfig / 启动方式,单 Query 实例、单订单 Book 实例,最终开关关闭。 4. 先验证 Query 池账号如何完成/恢复 Calendar 准备:当前 Query 初次准备仍需人工 OTP,不把已准备的合成 fixture 当成池账号无人值守能力已完成。 5. 现场观察真实框架发布/消费、订单账号绑定、库存重查与选中、零最终请求及清理。 6. 最终提交、新预约回执归属与上线另行验收;本轮不扩大到这些动作。 如果没有隔离环境,先解决测试依赖隔离,继续使用原框架;不要退回独立 Italy 信号机制,也不要冒险拿正式队列做试验。不能给网站预约成功率作 100% 保证;可以要求每个准出节点都有对应证据。 ## 9. 公共 PluginTester 的 Italy 查询配置 `config/test_conf.json` 的 `ita_plugin` 已补齐香港现场样例:`slot.hkg.it.tourist`、服务 `4937`、单人旅游表单和最多 12 个月扫描;由现有 Query 逐月扫描,在首个正向月份停止并返回其中最早日期。地区与服务仍通过配置映射,不修改公共测试器或 Italy 算法。 原有账号、密码、代理、个人资料及其他插件配置保留。账号必须已在网站绑定香港;本地修改路由不会替账号切换机构。 ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B tools/plugin_tester.py --plugin ita_plugin -c config/test_conf.json echo "EXIT_CODE=$?" ``` 这是实际网站查询命令,本次配置修改只做离线检查,未替用户执行。首次进入 Calendar 的准备阶段使用人工 OTP,可能发送一次验证码并提交 AVANTI;已准备好的 Calendar 查询不会每次发 OTP。最终提交开关为 `false`,不要手动点击最终 Prenota。 此配置先不追加 `--book`:公共测试器的该参数继续使用同一个插件实例,不代表“池账号 Query → 申请人账号 Book”;当前 Calendar Query 配置也不允许作为申请人 Book 会话。真正双账号协同仍使用上文的既有 Sentinel/OrderBooker 框架。 离线配置回归入口:`python -B -m unittest -q test.test_plugin_tester_ita_config`。使用真实 JSON 加载器与生产路由解析器,账号在测试加载时用合成值覆盖,不创建插件或浏览器。 本次验证:配置与协议/查询定向回归 59 项通过;加入新配置测试后的 Italy 19 模块回归共 549 项通过(exit 0)。与修改前逐项比较确认:其他插件、原账号密码、代理、个人资料和原有私有配置均未变。公共测试器、生产插件和正式调度配置未修改;真实账号当前机构与现场查询仍待用户运行上述命令确认。 ## 10. Query 首次 Calendar 准备的 Turnstile 接入修复 2026-08-31 用户提供的公共测试器日志确认:替换为私有 Query 账号并覆盖实际代理后,`create_session()` 已成功进入 `/UserArea`;服务 `4937` 的表单可打开。失败发生在发送 OTP 前,组件/API/脚本存在,但 `turnstileTokenPresent=false` 持续到超时,最终状态为 `turnstile_and_avanti_pending`。没有进入 Calendar,不能将本轮故障归因于登录或无号。 代码原因:`ita_workflow.prepare_calendar()` 只在 `role == "book"` 时传入 `ItalyTurnstileRecovery`;Query 准备未接入同一处理。此证据说明程序的处理缺口,不足以单独证明网站未生成 token 的全部原因。 授权修复:Query 与 Book 的首次 Calendar 准备共用现有恢复实例,继续复用 VFS 的 `CloudflareBypasser.click_verification_button(is_dfs=False)`;不新增验证码算法,不修改公共 helper、登录逻辑或日期扫描。保持初始等待 5 秒、间隔 10 秒、跨 OTP 前后合计最多 3 次操作,且只有真实 token 与可用 AVANTI 同时就绪才允许继续。正常已准备 Calendar 的查询不进入该处理,Query OTP 仍为人工输入,最终提交仍关闭。 新增角色提示为 `Italy query Calendar preparation: reusing bounded Turnstile recovery.`;共用诊断沿用 `ITA_BOOK_*` 前缀以保持兼容,该前缀不代表调用了 Book。 验证:定向准备/验证框测试 25 项通过;Italy 19 模块回归共 553 项通过,均 exit 0。覆盖 Query 成功后只记录 Query 准备、点击成功但无 token 时三次后仍不发送 OTP、OTP 前后共享预算、已成功的验证框不重复操作、已准备 Query 跳过整个准备路径,以及既有 Book 回归。所有外部网站/邮件交互均为模拟;真实通过情况待复测。 以下命令替代第 9 节在本机直接使用默认账号/代理的启动命令。仍执行公共 `PluginTester`,只在内存覆盖账号与代理,不将私有密码写入被 Git 跟踪的配置或命令行参数。代理端口 `6268` 是本次本机诊断结果,不是其他机器的通用默认值。 ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B -c ' from utils.local_account import load_local_account from tools.plugin_tester import PluginTester account = load_local_account("config/ita_query_account.local.json") tester = PluginTester.from_json_config( "ita_plugin", "config/test_conf.json", user_override=account.username, password_override=account.password, proxy_override="http://127.0.0.1:6268", ) raise SystemExit(0 if tester.run_pipeline(test_book=False) else 1) ' echo "EXIT_CODE=$?" ``` 现场只需配合页面要求的人机验证,并在终端提示后输入 OTP;不手动点击 OTP、AVANTI 或最终 Prenota。成功标准为验证通过、进入 Calendar 并获得 Query 结果,不能仅以 `clicked=true` 判定通过。如仍失败,收集固定诊断与页面错误文字,不记录账号、密码、验证码或验证 token。 ## 11. Query 自动 OTP 接入进展 用户已实测第 10 节修复:验证框操作一次后 token 就绪,人工 OTP 写入回读通过,Query 返回最早日期 `2026-09-01`,公共测试器全部通过、exit 0。 随后用户授权 Query 自动接码。现已复用 Book 的同一 OTP 分支及共享 SDK;95 项定向测试、561 项回归测试通过。Query 首次准备支持 `otp_mode=cloud`,已准备的扫描不再发码;最终提交仍关闭。 本地尚缺确认过的 `mail.authorization_email`,因此保留当前可用的 manual 测试配置,没有擅自猜测授权邮箱或转发关系。自动接码的配置、测试、信任边界与现场准出见 [自动 OTP 文档第 10 节](ita_otp_auto.md#10-query-首次日历准备复用自动-otp代码已验证现场待配置)。本轮未运行真实网站/邮箱。 ## 12. 香港单账号池与自动 OTP 配置(2026-08-31) 用户确认已在后台把测试账号加入 `hkg.it.sentinel`,并为同名 Gmail 登记了邮箱授权。以下配置取代第 11 节“缺邮箱配置”的现状,不把用户确认当成一次实际 API/邮箱连通性测试。 - 在 `config/config_sentinel.json` 新增 `ita.hong_kong`,保留 Dublin 与其他组;账号来源仍是原来的 Sentinel → `VSCloudApi.get_next_account()`,没有本地账号回退。一个实例,账号冷却与会话寿命均 1800 秒,参考 TLS 的对齐配置;查询间隔沿用现有 Random 策略(60–300 秒)。这不是网站限流安全性的证明。 - `enable=false`:仅完成本地配置,未发布云端配置、启动常驻 Sentinel 或连接 Redis/订单消费。`main.py` 仍沿用云端/缓存加载机制,不能把修改本地 JSON 当作已部署。 - 香港服务 `4937`、单人旅游表单、最多 12 个月扫描、首个正向月份即停止保持不变。`otp_mode=cloud`,`mail.authorization_email=chatgptshareplus@gmail.com`;密码/邮箱授权码仍只在既有后台,不写入新配置。 - `config/test_conf.json` 的香港 Query 同步自动 OTP 与邮箱配置;其中旧固定测试账号不作为本节验收来源。Book、公共测试器、共享 SDK、生产调度代码均不修改。 - 此邮箱映射只验证当前一个账号。后续新增独立邮箱账号时,必须补齐接码映射或验证统一收件箱转发;“账号已经入池”不自动等于新邮箱可接码。发送时的 recipient 仍来自实际池账号,不能写死成测试邮箱。 ### 12.1 一次性池账号 Query 验收 本节命令已更新为 `account-mailbox-v2`(见第 13 节):允许池中不同账号,邮箱来源由当前账号决定,不再检查其是否等于最初的固定邮箱。 复用公共 `PluginTester` 和与 Sentinel 相同的 SDK 取号方法,不增加 Italy 专用运行器。仅运行一次 Query,不启动调度线程、Redis 或 Book;**不等同于真实 Query → 订单 Book 联调通过**。 下面命令由用户在自己的终端执行。本轮助手未执行:取账号会立即把该账号置于 **30 分钟冷却**,即使后续浏览器失败也不会自动解除;不要反复领取/重置冷却。若后台已有冷却记录,需要等待其到期。代理 `6268` 是此前本机已验证端口,若本机端口变化须先调整;只覆盖本次浏览器代理,不改系统或其他插件配置。 ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B -c ' import json from pathlib import Path import configure from plugins.ita_protocol import resolve_route_config from plugins.ita_otp import validate_cloud_otp_environment, validate_cloud_otp_logging from toolkit.vs_cloud_api import VSCloudApi from tools.plugin_tester import PluginTester from vs_types import GroupConfig, VSAccount, VSPlgConfig groups = json.loads(Path("config/config_sentinel.json").read_text()) group = GroupConfig.from_json(next(g for g in groups if g["identifier"] == "ita.hong_kong")) route = resolve_route_config(group.free_config["apt_configs"], group.appointment_types[0].routing_key) if configure.TEST_ACCOUNT: raise SystemExit("Stop: TEST_ACCOUNT overrides the real pool; disable it first.") validate_cloud_otp_logging() print("ITA_POOL_QUERY_CONTRACT=account-mailbox-v2") try: raw = VSCloudApi.Instance().get_next_account(group.sentinel.account_pool_id, group.sentinel.account_cd) except Exception as exc: print("ITA_POOL_QUERY_ACCOUNT_FAILED type=" + type(exc).__name__) raise SystemExit(1) from None if not isinstance(raw, dict) or raw.get("pool_name") != group.sentinel.account_pool_id or raw.get("status") != "active": raise SystemExit("Stop: backend did not return an active account from the expected pool.") account = VSAccount.model_validate(raw) if not account.password: raise SystemExit("Stop: the pooled account is missing its Prenot@Mi website password.") try: validate_cloud_otp_environment(route.mail, account.username) except Exception as exc: print("ITA_POOL_QUERY_MAIL_CONFIG_FAILED type=" + type(exc).__name__) raise SystemExit(1) from None config = VSPlgConfig(account=account, debug=False, session_max_life=group.session_max_life, free_config=group.free_config, proxy=PluginTester.parse_proxy_url("http://127.0.0.1:6268")) tester = PluginTester(group.plugin_config.plugin_name, group_id=group.identifier, config=config, appointment_types=group.appointment_types) print("ITA_POOL_QUERY_SOURCE=cloud_pool pool=" + group.sentinel.account_pool_id + " book=false") raise SystemExit(0 if tester.run_pipeline(test_book=False) else 1) ' echo "EXIT_CODE=$?" ``` 准出观察:出现 `ITA_POOL_QUERY_SOURCE=cloud_pool`;成功登录,自动 OTP 邮件读取和 DOM 回读通过;进入 Calendar 获得 Available+最早日期或有效 NoAvailable 结果;cleanup 成功、exit 0。不应出现人工输入 OTP 提示,也不要手动点击 OTP、AVANTI 或最终 Prenota;网站若要求人机验证,按页面完成。仅公共测试器显示“全部通过”不能单独证明当前有号,仍需看 Query 返回状态。 失败时只反馈错误阶段和脱敏日志;不贴后台账号响应、验证码、Cookie 或完整邮件正文。本节命令在取号前检查 DEBUG 邮件日志与 TEST_ACCOUNT 覆盖,避免把测试常量误认为真实池取号。 ### 12.2 本轮离线证据 - `python -B -m unittest -q test.test_plugin_tester_ita_config test.test_ita_route_wiring`:21 tests,OK,exit 0。 - 20 个 Italy 模块联合回归:579 tests,OK,exit 0;在第 11 节 19 模块基础上纳入 `test_ita_route_wiring`。 - 配置测试增加 8 项:公共测试配置与 Sentinel 路由/OTP 一致;禁用态/单实例/无明文凭据;真实 Sentinel spawner 绑定 SDK 返回账号;池不可用不回退;本文完整命令在模拟 SDK 下执行公共测试器且 Book 关闭;TEST_ACCOUNT 覆盖拒绝;后端错误脱敏;错误池/状态/邮箱映射/空密码拒绝。 - 回归发现原路由测试还匹配旧的“所有 final 都禁用”错误文案;现有生产实现已区分显式申请人 Book 授权。本轮只同步该错误消息断言,仍要求裸 `final_submit_enabled=true` 被拒绝,不修改生产验证逻辑。 - `git diff --check`:exit 0。未创建真实浏览器、领取后台账号、读取邮箱、发布 Redis 信号或提交预约;自动接码现场结果待用户回传。 ### 12.3 用户现场回传:自动 OTP + Query 通过 2026-08-31,用户在收到第 12.1 节命令后回传公共测试器日志(本节证据来自用户终端,不是助手重新运行): - 表单验证先处于 `turnstile_token_pending`;一次 helper 操作后实际 `turnstileTokenPresent=true`、`outcome=ready`。 - 日志明确进入 `Italy query OTP sent; waiting for the authorized mailbox (one read attempt).` 自动读取分支。 - `ITA_QCAL_OTP_DOM_WRITE_VERIFIED matched=true`;后续检查 `otpValuePresent=true`,进入 Calendar。所贴日志中没有人工 OTP 输入提示。 - Calendar `probe index=0 available=0`、`index=1 available=11`;首个正向月份即停止,返回 `success=True`、`AvailabilityStatus.Available`、`earliest_date=2026-09-01`。这是当时快照,不表示号源现在仍在或已被预留。 - 公共测试器各阶段 PASS,cleanup 成功,总耗时 98.49 秒、`EXIT_CODE=0`。 结论:**该测试账号的自动 OTP → Calendar → 逐月最早日期 Query 单次真实链路已通过。** 不再把该链路列为仅离线验证。 证据边界:本次截取从表单阶段开始,没有包含 `ITA_POOL_QUERY_SOURCE=cloud_pool pool=hkg.it.sentinel book=false` 或执行命令。若按第 12.1 节原命令执行,账号必经既有 SDK 池领取与返回池名检查,且无本地回退;仅凭这段后半程日志不能独立确认取号来源。需要补证时只补原运行的来源标记/确认命令,不为补日志重新登录、取号或发送 OTP。 第 12.1 节入口明确 `test_book=False`、配置最终提交关闭;本次回传未包含网络审计计数或预约前后基线,因此不将“零最终请求”记为本次独立 Network 实测。共享诊断沿用 `ITA_BOOK_*` 前缀不代表执行了 Book。 下一节点是原有 Sentinel → Redis 信号 → OrderBooker 的受控现场联调,Query 用池账号、Book 用目标用户账号,并在最终提交前停止。先落实隔离的信号/订单测试环境,避免误触正式订单;本次通过不等于常驻恢复、多人账号池、跨邮箱映射、真实 Book 或正式上线已验收。本轮只归档证据,不改变 `enable=false`,不启动任何外部流程。 ## 13. 解除单账号邮箱限制:使用实际池账号的授权邮箱 用户新增池账号后,旧命令在 `account.username != route.mail.authorization_email` 或网站密码为空时退出。此检查是单账号验收命令的限制,不是 Prenot@Mi、SDK 或账号池要求。此前“加第二个账号就可直接重试”的说明遗漏了当前固定邮箱映射的前提;本节修正该限制。单独的 `ITA_POOL_QUERY_ACCOUNT_FAILED type=BizLogicError` 则只能证明后台取号失败,不能仅凭异常类型断言一定是冷却,需结合后台账号状态与 `next_use_time`。 ### 13.1 设计与复用 - `plugins/ita_protocol.py` 的既有 `OtpMailConfig` 增加显式 `authorization_source`,默认 `configured` 保留原有固定/转发邮箱行为;`account` 通过 `mailbox_for(account_email)` 按本次账号解析收件邮箱,不修改共享 route、不缓存上一个账号的地址。配置同时提供 `account` 与固定地址会被拒绝,避免静默读错邮箱。 - `plugins/ita_otp.py` 仍只调用既有 `VSCloudApi.fetch_mail_content`:账号来源模式将 `email` 和 `recipient` 都绑定本次账号邮箱;固定来源模式仍允许两者不同。固定 Prenot@Mi 发件人、主题、发送时间窗口、六位数字解析、失败不回退另一个邮箱/旧邮件、禁止 DEBUG 正文输出均保留。日志检查提取成共享 helper,供命令在领取账号前复用。 - 香港 Sentinel 和公共测试配置改为 `mail: {"authorization_source": "account"}`,删除这两处固定邮箱地址;不改账号池调度、冷却、实例数、Book 配置或 SDK。`enable=false` 与最终提交关闭保持不变。 - 第 12.1 节完整命令删除固定邮箱相等检查,保留网站密码必填与实际邮箱格式/日志检查。新增两个明确结果:`ITA_POOL_QUERY_CONTRACT=account-mailbox-v2` 和 `ITA_POOL_QUERY_MAIL_CONFIG_FAILED`。命令与正式 Sentinel 都使用生产 OTP 适配器,不只在测试命令里替换地址。 ### 13.2 使用前提及现场准出 池中每个账号需在 Prenot@Mi 绑定目标机构、可登录,且其自己接收 OTP 的邮箱已经通过 `/api/email-authorizations` 登记;应用专用密码仍由现有后台保管。此模式不自动创建邮箱授权、不猜转发、不把缺授权伪装成可用。若账号的 OTP 实际转发至统一收件箱,应明确使用原 `configured` 模式,而不是对所有池账号反复改一个固定地址。 多账号现场验收:等待已领取账号正常冷却到期,用第 12.1 节完整命令领取可用池账号,确认新命令版本、自动 OTP 写入验证、Query 结果及 cleanup/exit 0。助手本轮不领取账号、不发 OTP、不修改后台冷却。前一次单账号通过仍有效,但不能据此宣布本次新账号现场已通过。 ### 13.3 离线验证 - OTP/工作流/公共配置/协议定向回归:126 tests,OK,exit 0。 - 第 12.2 节同一组 20 模块完整回归:588 tests,OK,exit 0。 - 最终 OTP 与公共配置/命令复核:28 tests,OK,exit 0;`git diff --check` exit 0。 - 新增 9 项测试,覆盖 A→B→A 的不可变邮箱解析、旧固定邮箱兼容、来源歧义/错误配置拒绝、原发送人/模板/窗口约束、实际 SDK 参数跟随账号、授权失败不借别的邮箱、新账号公开 Query 连续两次只准备一次、完整命令接受第二个账号、DEBUG 在取号前拒绝以及无效邮箱在浏览器前拒绝(部分分支合并在同一用例)。 - 更新原命令的单账号拒绝断言:不同的合法邮箱现为正向情况;缺网站密码、错误池/状态及无效邮箱仍拒绝。并未删除这些检查来制造通过。 - 无浏览器/真实邮箱/账号后台操作,无部署、提交或冷却重置;正式 Sentinel/Booker 与共享 SDK、VFS/BLS/TLS 实现未修改。 ### 13.4 后续用户授权:解除失败测试造成的新账号冷却 2026-08-31,用户明确要求更新新账号冷却。旧命令在领取账号后才执行单邮箱限制检查,因此即使未启动浏览器,后台领取动作也已推进 `next_use_time`。本次只补偿这次失败测试,不永久缩短池的默认冷却。 - 后台只读查询确认 `hkg.it.sentinel` 中新账号为 `717`、状态 `active`,原 `next_use_time=2026-08-31T11:01:35` UTC(北京时间 19:01:35)。原账号 `716` 未修改。 - 更新前再次核对目标账号身份和原时间;复用既有 `VSCloudApi.lock_account(717, lock_duration=0)`,仅发出一次 `/api/account/update` 请求。 - 后台读回确认新时间为 `2026-08-31T10:46:24` UTC(北京时间 18:46:24),账号仍为 `active`,已满足时间上的领取条件。 - 校验其他账号未变、目标账号其他业务字段未变;池默认 `account_cd=1800` 保持不变。没有领取账号、登录网站、读取 OTP 或运行 Query/Book,站点请求数为 0。 此次更新只恢复可领取资格,不强制下一次领取账号 `717`;池仍按既有最早可用时间顺序分配。第 13.2、13.3 节“无后台操作”描述的是上一轮代码修改和离线验证,不包含此次单独授权的补偿操作。新账号自动 OTP + Query 现场结果仍待验证。 ## 14. 无需云端订单的本机真实联调入口 2026-08-31,用户要求复刻正常 Query 发布、Book 感知并执行的行为,不将云端测试订单和上线配置作为前提;随后明确授权实现。合同:`existing-framework-local-prefinal-v1`。 用户本轮另一次 Query 回传全部通过(94.66 秒),自动 OTP、两个月扫描、当时最早日期 `2026-09-01`。状态日志仍为原测试账号,不能作为新账号验收;该输出也不是 Redis → Booker 现场证据。 ### 14.1 复用方式与范围 - 原 `tools/debug_ita_query_book.py` 默认仍离线;新增显式 `--local-preflight`、`--local-run`。旧 `--run` 继续拒绝,避免旧独立协调器命令误运行。 - 现场装配放在 `tools/ita_query_book_local.py`,不改变生产 Sentinel、Booker、Italy 插件、SDK 或任何线上配置。模式采用“现有对象组合 + 测试边界替代”,不是另写 Query/Book 调度器。 - 通过原插件工厂加载 Italy;执行真实 `OrderBookerGCO._spawn_worker`、`SentinelGCO._spawn_sentinel_worker`、`SentinelGCO._monitor_loop`、`BaseBookerGCO._booking_trigger_loop`、`OrderBookerGCO._execute_book_job` 和两者 `stop()`。 - Query 仍由原 SDK 从配置的真实池领取一次,保留既有池名/冷却;两角色自动 OTP 仍用原生产适配器和真实邮箱授权。账号必须不同,分别使用临时浏览器会话;不共享 Cookie、验证码或库存 id。 - 只替代云端订单的来源及上报:本地构造原有 `user_inputs` 数据结构,供原 OrderBooker 读取;不领取、创建、更新正式订单,不发通知。任何未明确支持的云端操作拒绝执行;成功上报在进入异步执行器前阻断。 - 信号仍使用原 `setex`、原 JSON envelope、原 key 和原 TTL,Booker 仍通过原 `get`/解析/路由/日期/冷却逻辑判断;工具仅记录发布内容摘要并核对接收内容一致,不复制信号解析或有效期逻辑。 - v1 使用本次进程独占的 `redis-server`,只开放临时 Unix socket,不监听 TCP、不写 RDB/AOF、不使用共享 Redis、不执行 FLUSHDB/FLUSHALL。临时 Redis、连接和目录在退出时清理;不是常驻服务,也未调用 `brew services start`。 - 当前本机 Redis 依赖已安装(Homebrew Redis 8.10.1),并完成真实 Unix-socket 发布/读取/过期测试;不是启动整个 Coordinate 的 Docker 容器。 ### 14.2 有限执行顺序与边界 先检查配置、Chrome、Redis 程序和本机代理端口,再获取 Book 用户资料;这些检查失败不领取池账号。先建立 Book 用户登录会话,再领取 Query 池账号并登录,最后执行一次原查询循环和一次原触发循环。这样不让信号在 Book 首次登录期间等待过期;Book 的 OTP/日历准备仍在原 Book 调用中执行。 循环仅通过测试中的退出事件限定一次迭代,不改循环内部业务。没有启动 creator/maintain/cache-refresh 常驻线程、云端配置热更新或订单回写;因此此入口验证的是**真实单轮数据链路**,不是常驻生命周期/云端订单链路验收。信号过期或日期不匹配时本轮不补发、不重试。 最终提交始终关闭,另对生产最终提交入口加测试拦截。复用 `CalendarRequestAudit` 和 `verify_precommit_selection`:两端最终请求必须为 0,单角色 OTP/AVANTI 不得超过一次;必须真实读回选中的日期、时段才可通过。pre-final 返回 `bookResult.success=False` 是既有合同,不能据此上报预约成功。 Ctrl+C 后停止并清理原 GCO、审计和浏览器;若已有 Book 线程正在等待 SDK 调用,保留云端/最终提交保护直到它退出,不提前恢复依赖、不重试。该等待遵循既有 SDK/浏览器超时,不承诺任意阻塞都能立刻退出。 池领取会按原规则更新冷却。若领取后才发现账号与 Book 用户相同,本轮拒绝继续且不自动解锁;选择一个不在 Query 池中的授权 Book 用户可避免这种情况。OTP 邮箱注册和网站账号所属机构是否正确,仍需事先满足,不能仅靠本地格式校验证明。 ### 14.3 完整现场命令 无需修改 `config_booker.json`,也不需要后台测试订单。保持本机代理 `127.0.0.1:6268` 可用;Book 用户接收 OTP 的邮箱须已登记。执行: ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B tools/debug_ita_query_book.py \ --local-run \ --group ita.hong_kong \ --proxy http://127.0.0.1:6268 echo "EXIT_CODE=$?" ``` 随后在本地终端输入 **Book 目标用户** 的网站邮箱和网站密码(密码隐藏输入;不写入文件,不在聊天发送)。Query 账号自动从池中取得,不手填。也可显式使用既有私有 `--book-account-file` 或 `ITA_BOOK_USERNAME`/`ITA_BOOK_PASSWORD`;不会自动借用 Query 本地账号文件。 默认使用生产 Book 的无额外日期限制行为,只做 pre-final 选中验收;需要测试用户日期限制时,入口接受 `--expected-start-date` / `--expected-end-date` 并原样进入现有订单过滤与 Book 日期选择。地区、service id、表单和邮箱策略均从所选 Query group 复制,不在装配模块硬编码香港服务号。 只做环境检查、不开浏览器不取号: ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B tools/debug_ita_query_book.py \ --local-preflight \ --group ita.hong_kong \ --proxy http://127.0.0.1:6268 echo "EXIT_CODE=$?" ``` 其他机器若提示 `redis_server_missing_run_brew_install_redis`,需安装 Redis 可执行程序;不要因此启动共享 Redis 或手工改信号 key。两窗口若出现人机验证,按页面要求处理;不要手动点击 OTP、AVANTI 或最终 Prenota。 成功摘要 `ITA_QUERY_BOOK_LOCAL_RESULT` 应同时满足:`passed=true`、`outcome=pre_final`、`queryCalls=1`、`bookCalls=1`、`signalPublished=true`、`signalReadByBooker=true`、`selectionVerified=true`、`cleanupVerified=true`;两端审计 `finalRequests=0`,`EXIT_CODE=0`。 有效无号、日期过滤/过期不触发、Book 重查后无号均不伪装成完整联调通过,返回 exit 2;异常/清理失败返回非零。只有真正提交并核验新增回执的后续阶段才能宣称预约成功。 ### 14.4 本轮验证与未完成项 - 20 模块 Italy 回归:**615 tests,OK,exit 0**,包括新装配测试与两个真实本机 Redis 集成用例;网站、账号池、邮件与云端订单在这些测试中均为合成依赖。 - 真实临时 Redis 集成单独执行:2 tests,OK,exit 0;第一项验证原框架真实 setex/get 后触发,第二项使用真实服务器 TTL 到期后验证不触发 Book。网站和浏览器仍为 fixtures,禁止访问其他 socket。 - 完整 CLI `--local-preflight`:exit 0,`ready=true`;未创建浏览器、领取账号、读取邮件或访问 Prenot@Mi。 - 新用例覆盖不同账号/地区、原配置不变、动态邮箱、无号、写 Redis 失败、信号过期、日期过滤、池错误脱敏、同账号拒绝、异常返回成功、最终请求异常、重复 OTP、清理失败和中断;默认 `--offline` 仍不启动 Redis 子进程。 - 首次 Redis 过期测试发现既有浏览器 fixture 将 `time.sleep` 替换为 Mock,导致测试未真实等待到期;修正测试为使用替换前的真实 sleep 后通过,未改生产 TTL。 - 真实双账号登录 → 自动 OTP → Redis → Book 选中仍需用户运行 `--local-run` 回传;本轮不把历史单端成功拼成新的现场联调通过。未提交、部署或启用常驻分组,最终预约仍关闭。 ### 14.5 用户现场回传:真实单轮 Query → Redis → Book pre-final 通过 2026-08-31,用户回传 `existing-framework-local-prefinal-v1` 摘要与 `EXIT_CODE=0`。 这是用户自己终端的真实验收证据,不是助手重跑,也不延续第 14.4 节的“尚待现场验证”状态: - `liveAcceptance=true`、`passed=true`、`outcome=pre_final`;`queryCalls=1`、`bookCalls=1`。 - `signalPublished=true`、`signalReadByBooker=true`;原框架真实 Redis 发布/读取已在本轮贯通。 - 当时 Query 最早日期 `2026-09-01`;Book 重查后选中同日 `10:05 - 11:05`,`selectionVerified=true`。 - Query 请求:availability=3、AVANTI=1、OTP=1、timeSlots=1、final=0。 - Book 请求:availability=3、AVANTI=1、OTP=1、timeSlots=2、final=0。 - `cleanupVerified=true`、`cloudOrders=false`、`finalSubmissionEnabled=false`。 v1 入口强制不同账号、真实池领取及各自会话;该摘要不包含账号身份,不据此断言具体领取哪个邮箱。 本轮只证明实时单轮协同到提交前;未创建预约、不验证云端订单回写/通知或常驻恢复。日期时段是当时快照,没有锁位。 ## 15. 显式真实单次提交模式 2026-08-31,用户明确表示“我现在要的就是真实提交”。在原本机联调工具内增加 `--local-run --submit-once`,最初合同为 `existing-framework-local-submit-once-v2`;用户随后明确要求无需确认输入, 现行合同为 **`existing-framework-local-auto-submit-once-v3`**(见 15.5)。 默认 `--local-run` 仍是 v1 pre-final;离线/预检不能携带 `--submit-once`。 ### 15.1 复用与文件归属 - `tools/debug_ita_query_book.py`:只增加显式 CLI 开关/互斥校验和离线用例入口。 - `tools/ita_query_book_local.py`:原组合装配增加独占防重复记录以及真实结果观察; Query 的配置副本仍 final=false,只有本次 Book 内存副本设为 true,原配置文件完全不变。 - 继续执行真实 `ItaPlugin.book` → `ita_workflow.book` → **原生产 `submit_final`** → `FinalBookingAttempt` / `NativeFinalSubmitter` / `FinalReceiptReadPort`,没有重写提交接口、回执匹配器或轮询器。 - 自动 OTP 原封不动。邮件仅按原发件人/模板/账号/窗口提取验证码;不新增邮件服务或 LLM 判断,不记录验证码/正文。 - Book 返回原 `VSBookResult(success=True)` 后走原 Booker 成功分支;本地仅在原通知入口之前截获, 不进入异步云端订单更新/通知。unknown 保留原异常类型,走原暂停分支,仅将本地合成任务标记 pause。 ### 15.2 真实提交顺序与准出条件 1. 显式使用 `--local-run --submit-once` 即启用自动真实提交,不要求交互终端。读取 Book 凭证后,先检查该申请人/服务的本地防重复记录,再创建浏览器或领取 Query 池账号。 2. 原双会话 Query → Redis → Book 自动 OTP、日期/时段重查仍不变。无号或日期不匹配则不进入最终提交。 3. 真正选中后,输出服务、日期、时段及 `automaticSubmission=true`,直接进入原生产最终流程,不等待确认句或按键。 4. **仍由原生产最终核心读取新鲜预约基线**。已有有效预约、候补、无法核实的记录或上下文变化会阻断,不取消旧记录。 5. 原生提交之前再次核对选位与零最终请求,复用 `tools.ita_final_evidence.claim_once` 的 O_EXCL + fsync 独占写入;然后只调用一次原生提交器。 6. 只有原核心证实当前请求归属及唯一新增 `Confermata` 回执,才返回 Book 成功。页面跳转、HTTP 200 或按钮点击都不能单独算成功。 7. 最终本机验收要求 `bookingConfirmed=true`、`bookResultSuccess=true`、`successHandledLocally=true`、 `passed=true`、`outcome=confirmed`、Query final=0、Book final=1、清理通过、EXIT_CODE=0。 `selectedTime` 是选择的时段,`confirmedTime` 是网站实际分配的时刻,二者不必是同一字符串。 防重复文件位于既有私有目录的 `query-book-final/.claim`;hash 绑定站点、规范化账号及 service_id, 不绑定本轮 run id/日期/routing alias,重启或换路由别名不能自动再提交。文件内容只有已尝试状态,无密码、邮箱、验证码或预约编号。 独占记录不自动清除;不同申请人的记录彼此隔离。这只是本 checkout 的验收防重复措施,不是分布式生产锁。 旧 `final-evidence-once.claim` 不删除、不重置、不复用为新账号身份依据;`docs/ita_book_cs5.md` 第 29 节已有确认预约仍受网站基线检查保护,不重建或取消它。 提交后无法核验返回 `outcome=unknown_do_not_retry`、EXIT_CODE=4;即使响应丢失也不二次提交。 已经核实成功但诊断清理失败,同样保留 `bookingConfirmed=true` 并返回非零/4,不能为了修复清理而再预约。 无号或信号/日期过滤未触发返回 2;预提交配置/基线失败返回 1。本工具不恢复云端订单写入,不宣称全生产常驻链路已经上线验收。 ### 15.3 完整真实执行命令 保持本机代理可用,在用户自己的终端执行(**这次会真实占用预约名额**): ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate python -B tools/debug_ita_query_book.py \ --local-run \ --submit-once \ --group ita.hong_kong \ --proxy http://127.0.0.1:6268 echo "EXIT_CODE=$?" ``` 输入目标 Book 用户的网站账号/密码;Query 自动从池中领取,双方自动 OTP。 选位后自动提交一次并核验回执,不要求输入 BOOK 确认句。运行前用可选日期范围参数表达真实可接受范围;未指定则沿用生产 Book 的无额外日期限制行为。 除按网站要求完成真人验证外,不手动点击 OTP、AVANTI 或最终 Prenota。 如果配置过 `ITA_BOOK_USERNAME`/`ITA_BOOK_PASSWORD` 或通过 `--book-account-file` 指定私有账号文件,沿用原凭证读取规则,无需再手填网站账号密码。未配置凭证时仍在启动阶段询问账号密码,这与最终提交确认无关。 可选日期范围参数继续复用原订单过滤,不在本工具硬编码香港日期或时段。 反馈 `ITA_QUERY_BOOK_LOCAL_RESULT` 和退出码即可,不贴密码/OTP/邮件正文。EXIT_CODE=4 时不要重跑,先核对预约回执。 ### 15.4 v2 历史验证 - 新增 15 个离线用例:显式开关只影响 Book、终端前置、原 GCO + 原生产最终核心 + 原真实回执解析器贯通、 标准成功回调本地截获、实际分配时刻、拒绝确认、已有预约、响应未知但有匹配回执、缺回执暂停、 原生调用异常、无号、清理失败保留成功、重启/路由别名/残缺记录/符号链接阻断及 exit 4(部分分支合并在单例)。 - 20 个相关 Italy 模块回归:**597 tests,OK,exit 0**,8.276 秒。包含真实私有 Redis 的两个本机集成用例;站点/邮箱/账号 API 仍为合成依赖。 - 首轮扩展回归揭示测试边界的 `patch.dict(cloud.__dict__)` 会在退出时恢复运行前计数;改为仅添加/移除本地暂停方法,累计状态不再被恢复,重启断言及回归通过。 - 默认离线 CLI:66 tests,OK,exit 0;CLI help 与 `git diff --check` 均通过。未登录网站、读取真实邮箱、领取真实池账号或提交预约。 - 本轮真正创建预约的现场结果**待用户执行本节命令回传**。不能把第 14.5 节 pre-final 成功当作本次最终提交已通过。 ### 15.5 v3 修正:移除人工确认,按既有订单条件自动提交 用户指出完整确认句不符合自动 Book 的预期。该额外步骤由验收工具引入,并非生产插件要求;现已移除。 删除 `confirm` 回调、确认句输入、拒绝确认分支及最终提交对 TTY 的额外要求;不自动输入确认句来绕过旧逻辑。 CLI `--submit-once` 是显式开关:启动后按原订单日期条件完成选位、原生产最终提交及回执核验。 Query/默认 pre-final 仍关闭最终提交;已有预约检查、申请人绑定、独占防重复记录、未知结果暂停和退出码 4 均保留。 未改生产插件、共享调度器、OTP、账号池或线上配置;未读取/清除已有 claim,也没有运行真实提交。 更新离线用例:最终链路在 `builtins.input` 被设为一调用即失败时仍通过;配置了 Book 凭证的非交互启动无需 stdin; 原有无号、日期过滤、身份不符、已有预约、重复提交及未知回执用例继续保留。默认离线 CLI 66 项通过(exit 0); 与 15.4 相同的 20 个 Italy 模块回归 597 项通过(8.442 秒,exit 0)。CLI help 和 `git diff --check` 通过;真实提交尚待现场回传。 ### 15.6 用户授权解除两个测试账号的当前冷却 用户回传 v3:Book 已到达认证 `/UserArea`,随后 `pool_allocation_failed`;Query/Book 调用均为 0、 `possiblySubmitted=false`。后台只读查询(北京时间 2026-08-31 20:18:38)确认池内 716/717 均 active, 可用时间分别为 20:27:14 / 20:35:37,当时均不可领取;这次失败不等于 Book 登录失败或已经提交。 随后用户明确授权“都放开吧,我们要测试啊”。重新核对 `hkg.it.sentinel` 仅包含这两个 active 账号, 逐项更新前再次比较账号业务身份和原 next_use_time,然后各调用一次既有 `VSCloudApi.lock_account(id, lock_duration=0)`,不重复重试写入。 - 北京时间 2026-08-31 **20:28:12** 读回:716、717 的 next_use_time 均为该时刻,均满足状态/时间领取条件。 - 两次更新均成功;账号其他业务字段保持不变;仅更新这两个账号的当前冷却时间。 - 未改池默认冷却、配置或其他池账号;没有领取账号、登录网站、发送 OTP、提交或取消预约。 - 下次领取仍会按原 account_cd 更新冷却;本次不是永久取消账号池冷却。真实最终提交仍待用户现场结果。 ### 15.7 v4 修复:外层审计与生产最终提交共用一个监听器 **现场证据**:用户回传 v3 已完成 Query、信号发布/读取、Book 自动 OTP 和选位, `selectionVerified=true`、`selectedDate=2026-09-01`、`selectedTime=10:05 - 11:05`; 随后 `bookErrorType=CalendarGateError`、`finalRequests=0`、`possiblySubmitted=false`。 这不是这次预约已成功或名额已保留的证据;失败发生在最终请求之前。 **确定根因**:`ObservedPlugin.create_session()` 已在 Book page 的 CDP driver 注册 `CalendarRequestAudit`。随后原生产 `ita_workflow.submit_final()` 又创建并启动第二个 audit, 触发原有保护 `Passive request audit cannot replace an existing callback`, 尚未创建 `FinalBookingAttempt`,也尚未执行 native submit 或写入本轮 claim。 此前最终链路测试将内外两个 audit 都 Mock 掉,掩盖了这个真实组合冲突。 **本次最小修复**: - `plugins/ita_workflow.py`:增加可选 keyword-only `request_audit`,借用调用方已启动的审计。 未传入时,普通生产调用仍自行创建、启动、停止;借用时不注册、不停止,不产生监听空窗。 - `tools/ita_query_book_local.py`:将现有 Book observer 的 audit 显式传给原生产最终流程, 不新增事件分发器、不复制提交或回执核验逻辑。真实模式合同升为 `existing-framework-local-auto-submit-once-v4`,命令/自动 OTP/自动提交行为不变。 - `plugins/ita_calendar_session.py`:核对借用方页面、driver、连接状态和原回调所有权; 每次实时 snapshot 同样核对所有权。最终审计必须包括时段请求;不覆盖其他回调、 不将断连后的 retained counters 当作最终请求证据。 - 外层仍在停止 audit **之前**保存已连接且稳定的请求计数。若随后浏览器清理失败, 报告使用这份已保存快照,避免重新读取已停止的 audit 并把 confirmed 错改为 unknown。 清理失败仍不算验收通过,也不允许为了清理重新预约。 **新鲜验证(2026-08-31,本地离线)**: 1. 先将 `LocalFinalTests` 的两个 Mock audit 换为真实 audit,保留合成浏览器/CDP 传输和时钟: 原成功用例立即失败(exit 1),与现场同样为选位成功、`CalendarGateError`、最终请求 0。 2. 修复后,现有最终链路测试使用真实 callback 注册/计数/settle/清理机制通过; 验证 Query/Book 各一个 audit、各 start/stop 一次,Book 最终请求只出现一次。 3. 新增 `RealFinalAuditTests` 9 项,覆盖借用/独立所有权、原拒绝覆盖保护、已有预约、 错误页面/driver/断连/停止、回调被替换(含提交过程中)、缺时段覆盖,以及缺失/重复/混入其他请求不能归为成功。 4. 扩大到 24 个 Italy 测试模块:**773 tests,OK,0 skipped,exit 0,9.480 秒**; 包含原 20 模块及 `test_debug_ita_production_query_gate`、`test_ita_calendar_soak`、 `test_debug_ita_book_gate`、`test_debug_ita_reservation` 的真实审计生命周期回归。 5. `python -B tools/debug_ita_query_book.py --offline`:**75 tests,OK,0 skipped,exit 0**; `--help` 与 `git diff --check` 通过。 未登录网站、分配/解锁账号、发送 OTP、读取真实邮箱、重置 claim 或提交预约;未提交/推送代码、未部署。 本轮按 phase-gated-delivery 限定为监听组合修复和离线验证。真实 Query → Book 最终成功仍需用户按 15.3 命令现场验收; 本次离线成功不替代新增预约回执。遇到 `possiblySubmitted=true` 且结果未知/exit 4 时,仍先核验回执而非重跑。 ### 15.8 再次解除当前冷却:后台连接超时,未执行更新 2026-08-31 20:51:36 +08,用户再次授权解除 `hkg.it.sentinel` 的当前冷却。 先通过现有 SDK session 对 `/api/account/list_all` 做只读查询:默认连接两次分别在 15/20 秒超时; 确认本机 6268 代理端口可连接后,经该代理只读查询同样在 15 秒超时(均 `ReadTimeout`)。 未取得新鲜账号状态,因此本轮 **没有发出任何账号更新/领取请求**,没有改默认冷却、领取账号或预约。 当前冷却是否已自然到期也未核实;不能沿用 15.6 的旧读回结果宣称本轮已解除。待后台连接恢复后再核对并更新。