ita_book_cs4c.md 73 KB

CS4C:Book 专用现场验收入口

日期:2026-08-30。最新状态:v6 香港单人旅游 Book 提交前现场验收通过,详见第 20 节;未提交最终预约。下方各版本记录保留为历史证据。

Phase: VERIFIED(v6 单次真实提交前链路;不等于最终预约或跨地区生产验收) Scope: 独立申请人登录 → 既有表单检查 → 手工 OTP → 一次 AVANTI → 生产 Book 重查/选择 → 最终确认前停止。 Non-goals: 不改 Query、生产配置、共享框架或邮箱服务;不自动接码、不最终预约、不提交代码或部署。 Done: 专项与 Italy 回归返回 0;真实验收 passed=true、selectionVerified=true、exit 0,OTP/AVANTI 各一次、Book 重查不再发码或提交表单、最终请求为 0,预约/候补数量不变。 Approval: 负责人“可以 请你继续”授权本地开发,并明确“用一个就行,这个账号可以复用”;现场命令由负责人自行执行。 Evidence/Risks: CS4B 离线合同及本文第 20 节单次香港真实提交前证据;跨账号调度、其他地区、最终提交与回执、服务器内部草稿不在本次证明范围。

1. 这一步解决什么问题

CS4B 已有 Calendar 之后的生产 Book 能力,但旧 debug_ita_book.py 只到前置表单。 直接给 CS4B 填一个准备标记,不能证明申请人真的完成过当前服务的 OTP/AVANTI。 本次新增一个可独立运行的验收入口,负责补齐这段证明,不改写生产调度器。

工具运行只意味着一次受控实验。passed=true 表示已选好时段且安全停下,不表示预约成功。 VSBookResult.success 必须仍为 false,预约编号等成功字段必须为空。

2. 复用优先与文件归属

能力 复用来源 本轮处理
申请人自己的 Session VFS/BLS、OrderBooker、旧 Book 工具 既有临时浏览器,不复用 Query profile
显式复用本地账号 utils.local_account.load_local_account() 复用已有文件、权限与字段校验;不复制密码,不新建账号配置
route/form/calendar 配置 build_calendar_gate_config() 原样复用;本工具要求四个 route 字段显式提供
可见单人/旅游选择、Privacy、Turnstile 等待 Q-CAL 的 preflight 原样复用;调用前加同源、表单路径/方法/enctype 边界检查
OTP 一次性动作、原生输入与回读 Q-CAL OneShotAction、_enter_otp 原样复用;仍手工输入,不读取邮箱
AVANTI 请求与跳转证明 Q-CAL 监听、validate_avanti_packet() 原样复用;额外绑定当前申请人 page/tab/登录代次
请求计数、预约/候补记录计数 Q-CAL CalendarRequestAudit、read_reservation_snapshot 同一观察器覆盖准备、Book 和结束核对,不另造审计框架
日期偏好、日历重查、选择与回读 VFS 字段、CS4A/CS4B 调用真正 ItaPlugin.book(),不复制 Calendar 算法

只新增三个文件:

  • tools/debug_ita_book_gate.py:验收编排与 CLI。工具可以组合已有工具函数;生产插件不反向导入工具。
  • test/test_debug_ita_book_gate.py:无网络的合同、失败路径、账号隔离和实际 Book 链路测试。
  • 本文:设计、命令、测试证据、准出条件与限制。

使用组合方式接线,不新建通用工作流、账号池、重试引擎或邮件 Provider。 既有 Query 工具、生产插件和旧 Book 工具不计划修改;若确需改动,先说明具体原因。

3. 输入与权限边界

  • 默认只做本地 --preflight,不读取凭据、不创建浏览器、不发网站请求。
  • 只有显式 --run 才允许登录、一次 OTP、一次 AVANTI 以及日历/时段选择。
  • 复用现有 route/form 环境变量,不把香港或 4937 写进实现分支。香港只用于下方示例。
  • 默认仍只接收 ITA_BOOK_USERNAME / ITA_BOOK_PASSWORD,或者在终端交互输入;不继承通用 ITA_USERNAME / ITA_PASSWORD,也不自动读取 Query 账号。
  • 本次授权通过 --use-local-query-account 显式选择 config/ita_query_account.local.json。 此时用户名和密码整对从该文件读取,不和环境变量混用,不再要求手工输入账号密码。 文件缺失、权限不安全或字段无效时停止,不静默换账号;--preflight 即使带此开关也不读凭据。
  • 使用临时浏览器,不接管用户 Chrome 或 Query 的持久化 profile。每轮重新登录。 同账号不等于同会话;本次不证明 Query/Book 跨账号传递,也不改生产订单账号来源。 验收前请暂停使用同一账号的 Query,避免网站侧会话或预约状态相互影响;工具不会代为停止进程。
  • 可选 --expected-start-date / --expected-end-date 映射到 VFS 原有同名字段,闭区间且严格 YYYY-MM-DD;未指定沿用 2000-01-01 / 2100-01-01。实际扫描仍受 route 月数限制。
  • 本工具不等待真实 Query 信号;它构造仅含 route 的本地调试触发,不捏造“发现有号”。 自动跨账号传播仍是另一项验收。

4. 执行合同

  1. 在接触凭据/浏览器前校验 route、表单配置、日期偏好和 Chrome 路径。
  2. 读取申请人凭据,创建临时 Session;绑定插件、page、tab、账号、登录代次和 route。
  3. 启动既有被动请求审计,读取预约/候补数量基线。
  4. 调用一次 Book 的既有“表单前停止”分支。没有入口则返回“本轮无正向验收条件”,不发码。
  5. 确认同源目标表单、POST action、已观察的 multipart/form-data,没有文件控件;复用 preflight 操作已配置的可见选项和 Privacy,等待站点正常完成 Turnstile。
  6. OTP guard 在点击前消耗额度,监听当前 tab 的一次 GET,校验服务及 SENT 响应。 人工输入后复用 DOM 回读验证。不输出输入值;可见输入会保留在终端,用户不要回传它。
  7. 再次检查申请人、route、表单和一次性预算。仅在本次 AVANTI 期间打开原生确认框自动接受; 不论成功失败,立即关闭该设置,不能把自动接受带进 Calendar。
  8. 监听当前 tab 的 POST,复用直接 302/跟随重定向 200 两种证据验证。到达同源 Calendar, 禁用最终按钮,再登记 Book 专属准备记录,不登记 Query 记录。
  9. 调用一次生产 Book 的 Calendar 分支,按用户日期偏好重新扫描、选时段;这是第二次 book() 调用但属于不同阶段。必须分别报告 entryBookCalls=1、calendarBookCalls=1, 不能把两次调用写成“Book 只调用了一次”。Calendar 分支内部仍只执行一次。
  10. 复用选择快照做一次纯读取,确认当前显示日期/时段仍等于 last_booking_precommit。
  11. 读取预约/候补数量并比较,核对 Book 期间 OTP/AVANTI/最终请求增量均为 0。
  12. 停止监听/审计、关闭本工具创建的浏览器并清理临时目录,再发布最终验收结果。

不能根据一张已存在的 Calendar 页面跳过步骤 2–8。任何身份/路径/结构/预算变化均停止。 已发 OTP、已提交 AVANTI 或结果不明确时,不重试、不自动重新登录再发一次。 失败时只尝试读取脱敏诊断、结束计数和预约数量,不重复写操作。

本轮沿用 Q-CAL 的 DOM 同步、POST 路径与跳转证明;不会新增 multipart 序列化器,也不会 输出/落盘完整 POST、Cookie、Token 或邮件。对完整 payload、服务端内部草稿的推断不在 本轮证明范围内。表单 enctype 或未知字段不同的其他领区应停止发现,不能猜测兼容。

5. 假设验证与离线测试计划

假设或风险 离线证明 现场证明
只在明确选择时复用本地账号 默认不加载;开关选中完整凭据;文件错误停止;配置无 persistent profile 用户暂停同账号 Query,在独立浏览器确认账号/领区
Form 准备属于当前申请人 page/tab/账号/登录代次/route mutation 都停止 目标服务、单人/旅游选项与账户一致
OTP/AVANTI 只能一次 故障注入、重复请求、前后计数;中断不再点击 总计各 1 次;错误时不手工重跑
AVANTI 确实进入当前 Calendar 原生 302、跟随 200、错误 tab/目的地/返回表单 fixtures Network 与最终 DOM 一致
不复用 Query 时段 实际 CS4B 在假浏览器中重查并回读;触发没有旧时段 新月份响应与屏幕选中时段一致
选择不等于预约成功 Book 返回 false、无成功字段、final=0 最终按钮保持禁用,预约/候补数量不变
日历无号不假装通过 入口无号/范围内无号返回 2,passed=false 换日期范围须人工决定,不自动扩大
错误不泄密 注入含凭据/OTP/响应的异常,输出仅阶段和安全分类 回传 allowlist 结果行,不回传 OTP、请求正文或截图个人信息
工具没有改变 Query 只新增独立文件;核对共享依赖版本并运行列出的 Italy 回归 旧 Query 现场结果不冒充本轮 Book 证据

6. 现场准出与返回码

正向 Gate 必须全部满足:

  • 申请人会话完成当前服务的一次准备;Book 专属 route 记录有效。
  • entryBookCalls=1、calendarBookCalls=1。
  • 总 otpRequests=1、avantiPosts=1、finalRequests=0。
  • Book 期间 Availability 请求至少 1,OTP/AVANTI/最终请求增量均为 0。
  • 选择快照、last_booking_precommit 和偏好日期匹配;bookResultSuccess=false。
  • 预约与候补数量分别前后相同;监听、审计、浏览器清理无报告错误。

返回码:0 本地预检通过或正向停点验收通过;1 合同/网站错误;2 本轮无正向号源; 3 清理失败;130 人工中断。只有 --run 的 passed=true 才是现场正向停点证据。

最终按钮保护与被动计数不是服务端写屏障;数量不变也不证明没有不可见草稿或临时状态。 超时仍是各步骤预算,不声称覆盖浏览器底层连接的整体硬墙钟上限。

7. 执行与验证记录

7.1 v1 的离线验证记录(v2 见第 9 节)

实施前相关基线测试:144 项通过,exit 0。没有启动真实浏览器或读取真实凭据。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_debug_ita_book_gate

最终专项测试 40 项通过,exit 0,无跳过。运行真正的两段 ItaPlugin.book()、Book 准备登记、 Q-CAL preflight/OTP 输入回读/跳转校验/请求审计和 CS4B 日历编排;仅浏览器、登录和预约列表 读数使用假对象。两个 Node 测试执行实际组合后的 JS,包括阻止错页面修改与正常的原生 hidden 同步。测试输出不是网站验证证据。

首轮 39 项测试通过,但清理故障注入的 mock 在测试对象析构时又抛出一次异常;已在测试清理 阶段撤销故障注入,最终运行不再有这段输出。没有为此修改生产析构或清理逻辑。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest \
  test.test_add_ita_query_account test.test_debug_ita_book \
  test.test_debug_ita_book_gate test.test_debug_ita_calendar_gate \
  test.test_debug_ita_monitor test.test_debug_ita_production_query_gate \
  test.test_debug_ita_query test.test_debug_ita_session test.test_debug_ita_soak \
  test.test_ita_calendar_book test.test_ita_calendar_book_flow \
  test.test_ita_calendar_query test.test_ita_local_handoff test.test_ita_plugin \
  test.test_ita_protocol test.test_ita_route_wiring

上述显式列出的 Italy 回归 336 项通过,exit 0,无失败、无跳过。最后一次运行输出 Ran 336 tests in 3.424s ... OK。其他任务正在增加 Query 恢复能力,因此这里不宣称覆盖 随后新增、未在该命令中列出的测试。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_book_gate.py --help
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -c 'from pathlib import Path; paths = [Path("tools/debug_ita_book_gate.py"), Path("test/test_debug_ita_book_gate.py")]; [compile(path.read_bytes(), str(path), "exec") for path in paths]; print("COMPILE_OK files=2")'
git diff --check

均返回 0;帮助只显示 CLI,编译输出 COMPILE_OK files=2,没有差异空白错误。 新增文件另作尾随空白检查,因为 git diff --check 不覆盖 untracked 文件。

shasum -a 256 返回 0。本轮只新增前述三个文件,没有编辑任何生产插件或 Query 工具。 第一次回归后,工作区出现并行 Query 恢复改动(同时新增 docs/ita_query_recovery.md); 后续 336 项回归仍通过。记录该次检查的共同依赖版本:

  • plugins/ita_plugin.py:开始为 9fd72adedd9c67e4ba847311a634567d61a5b52e5c7230ba86ef55e0866653e1, 后续为 f56b0f4fa5b74633dc6b671673231ff654d21cbe1ec63951abec1090859b59ea。
  • plugins/ita_calendar_query.py:开始为 e78e19d0f39a6a71e6dcd0474e7353ade63a0f79fb91f5e0ef2b0676616c4802, 后续为 508dd8435515d7ed8bc75ff5a5cc0bd40e2aa94136b3086764b98d8c8aabdb83。
  • tools/debug_ita_calendar_gate.py:开始为 98021ab36ba8342210cc4deb6da1180328f85a9ef27c351f14ff77a472dda145, 收尾回归时为 85df8a093fdf3b796716eebb224d69e6e5b4dbc39cf3adcc1bf022f236621335。

其余已核对文件 ita_calendar_book.py、ita_protocol.py、debug_ita_book.py、 config_sentinel.json / config_booker.json 保持本轮开始时的哈希。 工具打印的组合 source_sha256 包含共享依赖,后续修改会使它变化;不能把本次日志当作 未来版本的验证。全部并行/既有修改保留,没有 commit 或部署。

7.2 初见审查

反驳:“这又是一个只测 helper 的调试脚本,不能说明生产 Book 已接通。”

回应:新测试运行真正 Book 的表单分支,再经受控准备登记运行真正 Calendar 分支,而不是 mock 掉 book() 的返回值。现场工具也走相同调用路径。但它仍是人工准备入口,并没有 把 OTP/AVANTI 接进普通订单调度,所以不能宣称生产 Book 已完整实现;这一缺口明确列在下节。

反驳:“都选好时段了,为什么仍返回 Book 失败?”

回应:本轮的 VSBookResult.success=false 是有意的提交前停点。工具独立输出 selectionVerified=true / passed=true,仅代表安全验收通过,不误触发现有 Booker 的 预约成功回写和通知。最终提交能力接入后才允许返回真实成功。

7.3 负责人现场命令

以下是香港示例,命令本身不含密码;申请人账号必须能访问该服务。先用 --preflight 做 本地校验;准备好后将最后的 --preflight 改为 --run,只执行一次。 以下命令使用已授权复用的本地账号。不要在命令中重新填写或清空 ITA_BOOK_USERNAME/PASSWORD。

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' \
PYTHONDONTWRITEBYTECODE=1 \
python -B tools/debug_ita_book_gate.py --use-local-query-account --preflight
echo "EXIT_CODE=$?"

--use-local-query-account --run 会读取已有本地账号、打开全新浏览器;无需再次输入账号密码, 只需在收到邮件后输入可见 OTP。不带账号复用开关时,保留原有 Book 环境变量/交互输入行为。 脚本自行选择已配置的单人/旅游、勾选 Privacy、发送一次 OTP、点击一次 AVANTI、选择时段。 如出现人工验证,在该浏览器中自行处理;不要手工重发 OTP、点击 AVANTI 或最终 Prenota。 本工具不会上传文件或最终预约。结束自动清理本工具浏览器,不保留现场用于之后提交。

需要限制日期时,在末尾增加例如 --expected-start-date 2026-10-01 --expected-end-date 2026-12-31。 日期不是预约承诺;工具只在当前返回、配置月数及你的偏好交集中查询。

只回传 ITA_BOOK_GATE_TOOL_CONTRACT、ITA_BOOK_GATE_SELECTION、ITA_BOOK_GATE_RESULT、 ITA_BOOK_GATE_CLEANUP_OK 和 EXIT_CODE。若失败再附 ITA_BOOK_GATE_FAILED / 脱敏诊断; 不要回传 OTP 输入行、密码、完整请求/响应或个人信息截图。失败后先看原因,不直接重复执行。

8. 与 VFS/BLS 同等级质量对齐的最短上线路线

负责人最新要求:不追求完美,做到与既有 VFS/BLS 相同的交付质量。 本轮只收敛后续计划,没有因此扩大当前实现或解除最终提交授权。

源码参照:VFS book() 使用用户 Session、_read_otp_email() / fetch_mail_content()、重新查 Calendar/TimeSlots,最终依据 IsAppointmentBooked 生成 VSBookResult;BLS 同样复用云端 取信、重新取时段并返回统一结果。OrderBookerGCO 已从订单读取用户账号并创建独立实例。 Italy 应复用这些现成层次,不另建邮件平台或任务系统。

节点 剩余交付 通过标准
1. 提交前完整验收 本文新工具已离线验证,待现场 申请人登录→手工 OTP→AVANTI→真实时段→安全停止;final=0
2. 接成普通生产 Book 将准备编排接入生产,复用现有云端取信 API 普通订单调用无需调试工具或人工输 OTP;账号、收件人和发送时间匹配
3. 最终提交与成功结果 基于当前页面原生提交,识别真实响应和预约记录 真正预约后返回编号/日期/时间;无号、已预约和结果不明确分开处理;不盲目重提
4. 一个真实订单闭环并小范围开启 复用现有信号、Booker、回写和通知 Query→用户 Book→本站确认→订单成功回写/通知;关键异常测试通过,可关闭 Italy 配置回退

1 是当前最短路径;2 与 3 可以在证据齐备后分别实现,最后合并做 4。不再把额外通用工作流 重构、完整新邮件管理平台、所有领区现场验证作为首个领区上线前提。

首发范围:通用单人短期申根旅游的已验收领区配置,先用香港完成真实闭环;核心实现不 写香港分支。其他领区按同一配置/协议验证后启用,不能从香港一例宣称全球已验证。

最低保留项是正确使用申请人账号、不误报成功、敏感值不进日志、结果不明不盲目重复提交。 优先使用现有订单领取、任务状态和异常处理;若现有能力不足,只补 Italy 必需的小范围保护, 不默认把跨进程写屏障平台化改造列为本轮前置。这里是规模收敛,不是已经证明现有任务机制 具备跨进程 exactly-once,也不是放弃重复预约风险的验收。

确信度:CS4C 离线合同为高;自动接码、最终提交及真实订单上线证据仍未取得。

9. v2:按负责人授权复用已保存账号

负责人明确“用一个就行,这个账号可以复用”。将其落实为本地验收的显式开关 --use-local-query-account,不改变生产 Book 从订单取得申请人账号的合同。 本次仅编辑本工具、其专项测试和本文,没有修改 Query、账号文件或生产配置。

实现仍用组合:_book_credentials() 调用现有 load_local_account(),复用路径、权限、 JSON 与必填字段校验。开关选中后,整对凭据来自已保存文件;不带开关仍用原 Book 输入路径。 不复用 Query profile、Cookie、登录状态、Calendar 准备标记或旧时段。 本地文件错误会停止,错误输出不包含加载器原始详情,不回退到另一个账号。 源码指纹新增两个公共加载模块,但不包含账号配置文件或秘密值。

9.1 验证记录

均在本地执行,未启动浏览器、读取邮箱、发送 OTP、提交 AVANTI 或最终预约。

命令 返回值与结果
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_debug_ita_book_gate exit 0;46 项通过,无跳过
第 7.1 节显式列出的 16 个 Italy 测试模块命令 exit 0;342 项通过,Ran 342 tests in 3.135s ... OK
第 7.3 节配置搭配 --use-local-query-account --preflight exit 0;external_requests=0 credentials_read=false browser_created=false
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_book_gate.py --help exit 0;显示新开关
git diff --check exit 0

另用真实加载器校验已有文件,命令不包含实际账号密码,输出仅为来源与存在性:

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -c 'from tools.debug_ita_book_gate import _book_credentials; ita_book_username, ita_book_password = _book_credentials({}, use_local_query_account=True); assert ita_book_username and ita_book_password; print("ITA_BOOK_LOCAL_CREDENTIALS_OK username_present=true password_present=true external_requests=0 browser_created=false"); del ita_book_username, ita_book_password'

exit 0,输出 source=local_query_file 与 ITA_BOOK_LOCAL_CREDENTIALS_OK。 这证明本地文件能被当前加载器接受,不证明网站登录有效。 本次 CLI 预检标识为 book-prefinal-manual-v2,组合源码指纹为 ab74bc1f9753; 共享依赖后续修改时指纹可能变化,不能据此复用旧的真实网站验收结果。

新增测试覆盖:显式来源优先级、凭据不混用、默认不读本地文件、预检不读凭据、 文件错误不回退且不泄密、完整 Book 假浏览器链路继续使用独立准备与最终请求为零。

9.2 初见审查

反驳:“用同一个账号,会不会把 Query 的状态直接当成 Book 的准备结果?”

回应:只复用凭据,Book 仍创建临时浏览器并重新登录、完成自己的 OTP/AVANTI、登记自己的 准备记录、重查时段。专项测试验证没有 persistent profile 或 Query 准备标记。 同账号两个会话在服务器上是否互相影响尚未验证,现场请先暂停该账号的 Query; 本次验收不宣称跨账号交接已验证,也不宣称预约已成功。

10. v2 现场失败与 v3 最小修复

10.1 用户回传事实(不保存 OTP 输入行)

  • OTP 发送 1 次,DOM 回读匹配;发送后前置检查为 ready。
  • AVANTI POST 1 次;失败阶段为 calendar_preparation,异常类型 BizLogicError。
  • entryBookCalls=1、calendarBookCalls=0,故不能把自动加载的 1 次 Availability 请求说成 Book 扫描。
  • finalRequests=0;预约和候补数量分别前后都是 0。
  • 清理阶段另报 cleanup_listener / AttributeError,最终 passed=false、exit 3。

10.2 定位与实施边界

清理问题已用本机安装的 DrissionPage Listener.stop() 离线复现:第一次 stop 后将 _driver 设为 None,第二次仍执行 _driver.stop(),会抛 AttributeError。 共享 listen_once() 已在 finally 停止监听,本工具末尾再停一次是错误的生命周期调用。 测试假对象此前支持重复 stop,没有覆盖真实 SDK 行为。

业务失败已缩小到 Book 准备登记,尤其是 read_calendar_service();但原始异常被脱敏为 通用消息,不能证明真实原因是缺控件、空值、长度、页面加载时序或其他情况。 不得据此放宽标识长度限制、用 Services ID 替换 Calendar ID,或自动重复 OTP/AVANTI。

v3 只改 Book 验收工具、其测试和本文:

  1. 清理时只关闭仍在监听的 listener;真正的活动监听清理异常仍报错。
  2. Calendar 准备失败时输出只读诊断:路径是否匹配、控件数量、值类型/长度等,不输出值。
  3. 对准备登记的四条已知固定错误映射稳定原因码;其他异常仍不输出原始详情。
  4. 用安装 SDK 的实际停止行为和非幂等测试 listener 覆盖回归;保持 final=0 与一次准备预算。

完成标准:专项及显式 Italy 回归 exit 0;重复清理不再覆盖原始业务失败,诊断不泄露值。 真实 Calendar 标识错误仍需新诊断才能定案,本轮不声称其已修复。

10.3 v3 验证记录

  • 安装 SDK 的 Listener.stop() 离线重复调用实验:exit 0,输出 LISTENER_DOUBLE_STOP_REPRODUCED external_requests=0。使用 mock driver,没有创建浏览器。
  • PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_debug_ita_book_gate: exit 0,54 项通过,Ran 54 tests in 0.184s ... OK。
  • 第 7.1 节显式列出的 16 个 Italy 测试模块命令:exit 0,350 项通过, Ran 350 tests in 3.412s ... OK。未把测试中的 Q-CAL 日志当作网站证据。
  • 第 7.3 节配置及 --use-local-query-account --preflight:exit 0, external_requests=0 credentials_read=false browser_created=false。
  • git diff --check:exit 0。新增文件另作尾随空白检查。

版本为 book-prefinal-manual-v3,本次组合源码指纹 0c11e4d186d8。 只修改工具、对应测试和本文,没有修改生产插件、Query、配置文件或安装的浏览器库。

新增 8 项测试覆盖安装 SDK 的真实重复 stop 失败、活动监听正常清理与真实清理故障、 非幂等 listener 下的完整流程、控件缺失/值类型/空值/空白/超长值拒绝、诊断自身失败不覆盖 原业务错误、诊断不输出 runtime ID,以及只允许已知固定错误的原因码。

10.4 初见审查与下一次现场取证

反驳:“之前测试全过,为什么实际还会重复关闭出错?”

回应:此前的 FakeListener.stop 支持重复调用,与当前 SDK 不符。现在 Book Gate 使用 非幂等假对象,并有直接调用已安装 SDK 方法的回归;不能再用宽松替身掩盖这个差异。 这只关闭已复现的清理错误,不证明其余真实浏览器行为都已覆盖。

反驳:“后补诊断若显示控件正常,是否证明原异常是误报?”

回应:不是。诊断明确标记 afterFailure=true,是失败后的额外只读快照。页面可能在两次 读取之间变化,需结合 reason、readSucceeded、snapshotKeysMatch、tabIdPresent、 控件数量以及值形状判断;不以此自动刷新、换标识或重复提交。

以下为 v3 发布时的历史操作指引,现已由第 11 节取证结果取代,不应再次直接执行:

下一次使用第 7.3 节相同配置,带 --use-local-query-account --run,只执行一次,先确认 输出版本为 v3。该执行会重新登录并再次发送一次 OTP;不要连续重跑或手工重复点击 AVANTI。 回传 ITA_BOOK_GATE_TOOL_CONTRACT、ITA_BOOK_GATE_CALENDAR_DIAGNOSTIC(若有)、 ITA_BOOK_GATE_FAILED、ITA_BOOK_GATE_RESULT 和退出码即可,删除验证码输入行。

11. v3 现场回传:Calendar 已到达,运行时字段为空(2026-08-30)

11.1 已观察事实与边界

本节保存负责人回传的脱敏结果,不保存 OTP、账号或运行时标识值。

  • OTP DOM 回读匹配,发送后 preflight 为 ready;OTP=1、AVANTI POST=1。
  • 失败后的 Calendar 诊断为:路径匹配、tab ID 存在、快照键集合正确、 #idServizio 控件恰好 1 个,值类型为字符串、长度为 0、valueAccepted=false。
  • 明确错误码为 calendar_service_unidentified,阶段为 calendar_preparation。
  • entryBookCalls=1、calendarBookCalls=0:尚未执行 Book 的日历扫描和时段选择。
  • Availability 请求 1 次不能归因为 Book 扫描;finalRequests=0。
  • 预约和候补均为 0→0;CLEANUP_OK,exit 1。v2 的 listener 清理错误此次没有复现。

确信度:上述日志事实为高。快照是 afterFailure 读取,不能证明最初读取时刻的全部状态, 也不能仅凭空字符串确定网站赋值失败或页面加载过慢。

11.2 为什么看到了 Reservation

工具在 finally 中调用现有 read_reservation_snapshot(),通过新标签访问 /Reservation 核对预约/候补数量;DrissionPage 的新标签默认在前台打开。因此用户在失败后看到 Reservation 与本工具的对账行为一致,并不说明站点把 Book 的日历步骤替换成了预约列表。 正常路径仍为 OTP/AVANTI→Calendar→重查日期和时段;此次中断在 Calendar 准备登记。

11.3 尚缺的证据与下一步

源码 CaricaTimelineVerticale() 已证明 TimeSlots 的 idService 从 #idServizio 读取, 但既有取证没有证明该字段始终非空,也没有保存它的赋值逻辑。 现有 Book 实现和测试把“非空运行时服务标识”设为前置条件;测试成功只能证明检查行为, 不能倒推这个前置条件符合真实网站。

需要区分以下假设,当前不批准其中任何一项作为修复依据:

  1. 字段由异步初始化填入,Book 读取过早。
  2. 字段只在日期/日历交互后填入,当前准备顺序不符合网站生命周期。
  3. 字段为空是该页面允许的请求形态,服务实际由其他上下文绑定;当前非空约束过强。

下一步只读定位 Sources 全局搜索 idServizio 的命中及其调用上下文,必要时核对已发生的 RetrieveTimeSlots 请求中 idService 的存在性、类型和空值状态。不得输出实际标识、 Cookie、OTP 或完整请求;不得为了取证重发请求、调用初始化函数或点击最终预约。 若需要改变运行时绑定合同,应先用网站证据确定替代的服务一致性校验,再调整 Book 和测试。 不能直接删除校验、把配置的 Services ID 填入该字段,或先添加任意 sleep 试运气。

该业务失败已在 v2/v3 两次现场执行中出现,不再要求负责人盲目重跑完整 OTP/AVANTI 流程。 本轮 Chrome 只读标签清单仅取得 /Reservation;尝试在独立标签打开已知 Calendar URL 时 控制调用超时,后续原浏览器句柄报告不可用。未取得 Calendar DOM 或赋值源码,不能把控制 超时说成站点登录失败;也无法断言该次导航未在浏览器端发生。没有主动发送 OTP、提交表单、 选择日期/时段或执行最终预约。

11.4 本轮验证与初见审查

  • PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_debug_ita_book_gate: exit 0,54 项通过(0.179s);不包含真实登录或真实时段选择。
  • rg / sed / jq 只读核对 Book、Query 共用工具、已存文档和指定附件:exit 0; 取得字段读取逻辑,未取得字段写入逻辑。
  • 本轮只更新本文;没有修改 Book、Query、配置或测试实现。

反驳:“既然能进入 Calendar,直接允许空字段继续选择不就好了?”

回应:进入 Calendar 证明导航成功,不证明服务绑定正确;但反过来,也不能未经证实就断定 空字段必定错误。应先取得网站的实际初始化和请求证据,再保留必要的账号、路由、页面、 日期及时段一致性检查。这是纠正协议假设,不是无限增加防御或放弃校验。

12. 后续 v3 回传:预约基线为 1,仍停在 Calendar 准备(2026-08-30)

Phase: DISCOVERY(本地修复已有授权,但根因证据尚不足,未实施猜测性修复) Scope: 空运行时标识的来源;不重复 OTP/AVANTI,不提交或修改现有预约。

12.1 本次日志,不与第 11 节历史基线混合

  • contract=book-prefinal-manual-v3;Calendar 路径、快照键集合、tab 均通过形状检查。
  • controlCount=1、valueType=str、valueLength=0、valueAccepted=false。
  • stage=calendar_preparation、reason=calendar_service_unidentified。
  • entryBookCalls=1、calendarBookCalls=0;尚未调用生产 Book 的 Calendar 重查分支。
  • 请求计数:OTP 1、AVANTI 1、Availability 1、最终提交 0。
  • 预约 1→1,候补 0→0;清理成功,exit 1。本轮开始前即有 1 条预约,不能称为本轮创建, 也不能仅凭数量判断其服务、日期、来源或是否导致本次错误。不删除、不取消这条预约。
  • 不保存用户日志中的 OTP 值或输入行。

12.2 代码事实、未证实假设和执行决定

_wait_for_calendar() 只等待 URL 到达 Calendar 和文档加载完成;紧接着 Book 准备登记 调用严格的 read_calendar_service()。该读取要求一个 #idServizio 和非空字符串。 这证明了“当前代码为什么拒绝”,并未证明“网站为什么为空”。

只读等待存在可行的实现位置,但现在不能假定等一段时间就会填值。第 11.3 节中的异步赋值、 交互后赋值、合法空字段三种解释仍未排除。因此本次不添加固定延时或轮询,不放宽读取校验, 也不以配置中的 Services ID 替代 Calendar 运行时标识。此前提出的有界等待方案暂缓。

下一证据入口:在已恢复的 Calendar 中只读检查 idServizio 的赋值源码,以及已经发生的 RetrieveTimeSlots 请求里 idService 的存在性、类型、是否为空;不读取 Cookie/OTP, 不回放请求,不为了取证调用初始化函数或选日期。确认协议事实后再选最小修复及回归用例。

12.3 本轮验证与初见审查

  • Chrome 技能连接成功;user.openTabs() 只读列出 1 个 Prenot@Mi 标签,路径为 /Reservation。没有 Calendar 标签;未接管、导航、刷新、点击或提交任何页面。 这不是登录失效证据,也不是“Calendar 永久不存在”的结论。
  • PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_plugin: exit 0,167 项通过,2.300 秒。只证明当前离线合同,不证明真实 Book 成功。
  • git diff --check:exit 0;本轮只补本文,未修改插件、工具、测试或配置。
  • 真实 Book 仍未通过;未重跑真实登录、OTP、AVANTI 或任何最终提交。

反驳:“既然控件存在但为空,加等待是否能最快修好?”

回应:只有空值确实是短暂初始化状态时才成立。如果站点允许空参数,等待再久也不能修好。 优先取得一次真实请求和赋值证据,可以避免把同一业务失败再次交给用户用 OTP 试错。

12.4 用户恢复 Calendar 后的只读取证尝试

  • 用户回复“已经恢复了”。Chrome user.openTabs() 与随后 tabs.list() 均返回 Calendar - Prenot@Mi、/BookingCalendar,确认标签已恢复;未输出查询参数。
  • 第一次接管/DOM 读取组合调用超时,未返回字段快照。随后按 Chrome 技能的 browser-troubleshooting 指引,尝试同一 Chrome 标签的 CDP 能力文档,亦超时。 两次后停止重试;没有切换浏览器、刷新、导航、发送 OTP、选择日期或提交预约。
  • 这些超时不能证明字段是否为空、账号是否过期或网站初始化是否失败。技能的连接边界 使本次直接取证暂停,改由用户读取 Network 中已经发生的 RetrieveTimeSlots 请求,确认载荷 idService 的空值状态;不回放请求、不索要完整请求或实际标识值。
  • 本轮仅补证据记录,未修改实现;未重跑业务测试,因为没有业务代码变更。

13. 字段赋值来源已取得,实际空值语义仍待验证(2026-08-30)

来源:负责人从当前网页 Sources 提供 ValorizzaComponentiPagina(JsonServerInfo) 和 CaricaTimelineVerticale(_Giorno, _ContenutiEventi) 函数源码。以下为静态源码证据, 不是已观察到函数执行完成或成功请求的证据。

13.1 已确认的生产者与消费者

ValorizzaComponentiPagina() 先从 JsonServerInfo.substring(0, 10) 取得日期字符串, 初始化年/月控件,随后依次执行:

_Servizio = JsonServerInfo.split(',')[1];
$("#idServizio").val(_Servizio);
CaricaTimelineOrizzontale(Mese, Anno, Oggi, _Servizio);

CaricaTimelineVerticale() 则读取这个字段,并使用既有 EseguiAsync() 发起时段查询:

_idService = $("#idServizio").val();
// RetrieveTimeSlots 的请求对象:
{ selectedDay: _Giorno, idService: _idService }

确信度高:在这条初始化路径中,写字段发生在调用月份日期加载之前,不是必须选中时段后 才写入。该函数将拆分得到的同一变量传给横向日期加载,并将其写入纵向时段加载要读的控件。 这不证明它与配置中的 Services 入口 ID 相等,也不允许用配置值替换真实页面值。

13.2 不把静态顺序当成现场根因

  • 所提供代码没有校验逗号第二段存在或非空;赋值语句存在不等于填入了有效非空标识。
  • 尚未取得此函数的调用点、实际参数、其他字段写入点或失败现场的请求载荷。 名称 JsonServerInfo 本身不能单独证明对应网络请求的响应格式或 callback 接线。
  • 本地 _wait_for_calendar() 仅等待 Calendar URL 和 doc_loaded(),并不显式等待该 初始化函数完成。因此存在就绪检查缺口,但不能据此宣称它就是本次空值的原因。
  • 之前现场已累计 1 次 Availability 请求。若该请求确实来自上述初始化调用,则发起前已 执行字段赋值;仍需区分赋空值、另一路初始化、后续改写或读取时序,不能只加延时结案。
  • 此前“必须交互后才赋值”的说法不适用于这段初始化路径;未证明其他路径不存在。

最小下一证据:在当前 Calendar 的 Network 中读取一个已经发生的 RetrieveTimeSlots 请求,只确认 Payload 的 idService 是非空、空字符串还是缺失。 不要回放请求、重新发送 OTP、主动触发日期点击或输出字段实际值。 若已有成功时段响应且参数为空,则必须重新评审非空前置约束;若参数非空,再核对 DOM 及初始化就绪时机。当前页面证据不能自动追溯为先前失败 Session 的事实。

13.3 验证及初见审查

  • rg / sed 核对本地 Calendar 等待、Book 准备登记、字段读取和既有记录:exit 0。
  • 本轮只追加本文;未改 Book、Query、工具、测试或配置。业务测试未运行,理由是没有 实现变更,离线测试无法补出网站真实参数。

反驳:“已经找到赋值函数,为什么还不直接加一个等待?”

回应:可见的同步顺序是先赋值、后请求日期;若源数据就是空的,等待不会改善结果。 一次既有请求的字段形状核对可以区分不同修复方向,避免再次让负责人用 OTP 试错。

14. 恢复现场的 TimeSlots 请求使用非空服务标识(2026-08-30)

负责人回传当前已发生的 RetrieveTimeSlots 请求载荷:

{"selectedDay":"2026-10-13","idService":"4937"}
  • 确信度高:所提供载荷有 idService 字段,类型为字符串且非空;值与本次香港配置的 Services 入口 ID 相等。此处保存的是已知业务服务 ID,不保存账号、OTP、Cookie 或 Token。
  • 本次未提供对应 HTTP 状态码或响应体;不能仅凭请求载荷宣布该请求成功、当天有号, 或认为已证明服务器拒绝/接受空参数。
  • 当前恢复后的请求不能追溯为前一次失败 Session 的字段状态,也不能证明所有领区都使用 相同 ID 关系。继续保留从当前页面读取标识的合同,不改为配置值兜底。
  • 结合第 13 节归档源码,下一步只读比较当前 #idServizio 的原生 .value 与 jQuery .val() 是否都与这条请求一致;检查控件数量,以区别字段就绪变化与读取方式差异。 不刷新、不选日期、不发起新请求。

本轮只记录取证进展,未改实现,未运行业务测试;git diff --check 和本文尾随空白检查 作为文档校验。真实 Book 尚未通过。

15. 非空 TimeSlots 请求证据与 v4 就绪等待(2026-08-30)

15.1 事实与修复置信边界

负责人提供当前页面已发生的 RetrieveTimeSlots 请求载荷:

{"selectedDay":"2026-10-13","idService":"4937"}

这证明该次请求携带非空字符串标识,且恰与当前 Services 入口 ID 数值相同;不证明所有 领区或所有会话都相同,亦不构成“直接使用配置值”的依据。未同时提供该请求的状态码和 响应,不能仅凭载荷宣称有号或预约成功。不得将它追溯为此前失败 Session 的请求。

结合第 13 节赋值源码,可确认现有实现有一个就绪检查缺口:doc_loaded() 后直接严格读 运行时字段,没有专门等待网站填值。补条件等待的设计依据已具备;但“早读就是先前失败的 唯一根因”仍未证实。如果字段持续为空,v4 仍会停止,不把等待当作保证成功的办法。

15.2 文件归属、复用和完成标准

Phase: IMPLEMENTING→离线 VERIFIED;真实 Book 验收未通过。 Approval: 延续负责人已授权的 Book 本地修复;无真实 OTP、AVANTI、最终预约、部署或提交。

采用现有 Italy Book 的组合式浏览器适配器和 monotonic 条件轮询模式,不另建工作流或 通用等待框架。严格字段读取、会话判断、日历 final guard、请求监听和协议解析继续复用。

  • plugins/ita_calendar_book.py:增加 wait_for_calendar_service(),复用结构化字段读取; read_calendar_service() 在稳定阶段仍严格拒绝空值。在 Book 原生日历加载动作后等待 同一个已记录服务重新就绪,再处理已被 listener 捕获的响应;不为等待重复刷新或发请求。
  • tools/debug_ita_book_gate.py:AVANTI 后、登记准备状态前等待,默认最多 5 秒轮询; 成功即返回,不固定睡满 5 秒。等待后重新采样请求预算,不把这段时间的请求计入 Book 扫描增量。版本改为 book-prefinal-calendar-ready-v4。
  • 对应三个 Book 测试文件:补就绪、超时、漂移和刷新后的回归;本文保存来源和验收边界。
  • 未改 plugins/ita_plugin.py、Query 适配器、Q-CAL 工具、共享类型或生产配置。

仅一个结构正确控件的精确空字符串属于可等待状态。缺控件、多控件、非字符串、空白、 过长值、离开 Calendar、tab/申请人/路由变化及已记录服务变化均停止,不当作“尚未加载”。 每轮检查上下文,并保持现有最终按钮 guard;不写服务值、不选日期、不触发网络或提交。 5 秒是轮询预算,不是浏览器底层传输的硬墙钟上限;传输错误不会被循环吞掉或重试。

持续空值在工具准备阶段输出 calendar_service_not_ready,保留现有脱敏快照和事后对账; 不重复发送 OTP/AVANTI。其他字段识别错误仍用 calendar_service_unidentified。

机械完成标准:就绪即返回、延迟就绪可继续、持续空值有界失败、结构/会话/服务漂移失败、 刷新后等待不增加刷新次数、原有严格读取不变;聚焦及显式 Italy 回归 exit 0,预检无外部 请求或凭据读取。该标准不包含真实时段选择或最终预约成功。

15.3 验证记录

第一轮聚焦测试 144 项中 1 项失败,原因是将字段读取移到等待函数后,底层传输异常未再 经过工具原有的固定错误分类。已在工具边界恢复脱敏分类;等待函数仍不重试传输异常, 申请人绑定错误继续原样传播。没有放宽测试或字段校验来消除失败。

以下为修正后的实际结果,均不访问真实网站:

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate test.test_ita_calendar_book test.test_ita_calendar_book_flow

exit 0,144 项通过,1.215 秒(新增 14 项)。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_add_ita_query_account test.test_debug_ita_book test.test_debug_ita_book_gate test.test_debug_ita_calendar_gate test.test_debug_ita_monitor test.test_debug_ita_production_query_gate test.test_debug_ita_query test.test_debug_ita_session test.test_debug_ita_soak test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_calendar_query test.test_ita_local_handoff test.test_ita_plugin test.test_ita_protocol test.test_ita_route_wiring

exit 0,364 项通过,3.456 秒;这是显式列出的 16 个模块,不是对工作区所有测试的声明。 测试产生的 Q-CAL 日志来自替身,不是现场请求证据。

  • 第 7.3 节香港配置搭配 --use-local-query-account --preflight:exit 0; external_requests=0 credentials_read=false browser_created=false。
  • git diff --check:exit 0;新增/未跟踪文件另作尾随空白检查。
  • 本次预检版本 book-prefinal-calendar-ready-v4,源码指纹 0bdd665ba78c; 共享依赖变更会改变指纹,不能用这个值替代实际执行版本核对。

15.4 初见审查与现场准出

反驳:“等待会不会把切换到另一个账号/服务当成加载完成?”

回应:等待前后检查申请人、路由、tab 和 Calendar 路径,刷新后还要求服务与准备记录一致; 非空但不匹配不是待重试状态。稳定阶段的严格读取没有改成宽松等待。

反驳:“新增测试是不是又只证明了理想替身?”

回应:是离线行为证据,不能替代现场。因此只宣称就绪检查缺口已修复并通过离线验证, 不宣称历史空值根因已唯一确定。下一次真实验收需核对 v4:若就绪继续,必须观察到 calendarBookCalls=1、新时段响应和提交前选择回读;若仍超时,停止并按持续空值调查, 不通过加长等待或盲目重发 OTP 继续试错。所有情况下 final 必须为 0,预约/候补对账不变。 现场命令沿用第 7.3 节的明确路由配置和 --use-local-query-account --run;本轮没有执行。

16. 恢复页面的 DOM/网站读法一致,复核已有 v4(2026-08-30)

16.1 用户回传的当前页面证据

{
  "path": "/BookingCalendar",
  "fieldCount": 1,
  "ourRead": [{"empty": false, "matchesRequest": true}],
  "websiteReadMatchesRequest": true
}

比较基准为第 14 节已经发生的请求中的业务服务 ID。确信度高:这次恢复后的页面有且只有 一个目标控件,原生 .value 与网站 jQuery .val() 均为非空,且都与请求一致。 没有证据支持更换这两种读取方式或放宽非空约束;仍不能追溯证明旧失败 Session 的根因。

16.2 不重复开发,验证工作区已有实现

开始本轮代码核对时,工作区已经具有第 15 节的 v4、条件等待及回归测试。本轮直接复用和 审查这些修改,没有重新实现等待,没有改插件、工具、测试、配置或现有用户改动。

已核对以下行为:

  • 准备阶段使用网站当前字段值,不用 4937 或其他配置值兜底;已就绪时立即返回。
  • 精确空字符串只在初始化边界内等待;最多 5 秒的轮询预算,不重复 OTP/AVANTI。
  • 稳定阶段仍严格读取;Book 刷新后要求服务与准备记录一致。页面、tab、会话变化立即失败。
  • 等待结束后重新核算准备请求,不能把等待期间的请求冒充后续 Book 的新扫描。
  • 新的真实验收仍应停在最终确认前,final=0;已有预约基线可以为 1,但必须前后不变。

16.3 新执行的验证,而非沿用旧测试结论

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_add_ita_query_account test.test_debug_ita_book test.test_debug_ita_book_gate test.test_debug_ita_calendar_gate test.test_debug_ita_monitor test.test_debug_ita_production_query_gate test.test_debug_ita_query test.test_debug_ita_session test.test_debug_ita_soak test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_calendar_query test.test_ita_calendar_soak test.test_ita_local_handoff test.test_ita_plugin test.test_ita_protocol test.test_ita_query_recovery test.test_ita_route_wiring

exit 0,415 项通过,3.433 秒。显式覆盖 18 个 Italy 模块,包括 Calendar soak 和 Query 恢复回归;不是工作区全部测试,也不是 415 次网站请求。

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' PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_book_gate.py --preflight

exit 0;book-prefinal-calendar-ready-v4,组合源码指纹 0bdd665ba78c; external_requests=0 credentials_read=false browser_created=false。

本轮真实 Book 未执行,仍为待验收,不声称已经选中时段或预约成功。下一次只需负责人在 自己的终端执行同配置 --run;默认交互输入 Book 账号,只有明确需要复用已存账号时才加 既有 --use-local-query-account。不得在终端输出回传中包含 OTP 或密码。

初见审查反驳:“当前页面读到了非空值,是否证明 v4 必然修好旧失败?”

回应:不能。当前恢复页面与旧 Session 是两份证据。v4 已离线证明能够等待延迟赋值且 持续空值仍会明确失败;能否跨过旧现场失败点,必须看下一次实际执行,不能许诺 100%。

Book v4 现场验收与 v5 选择阶段诊断(2026-08-30)

本次现场事实,不与其他会话的基线混合

负责人运行 book-prefinal-calendar-ready-v4,组合指纹 0bdd665ba78c。 只保存下列业务和结构证据,不保存回传日志中的 OTP、账号或浏览器指纹值。

阶段 已观察结果
申请人登录 新临时浏览器,凭据来自已授权的本地账号文件;到达 /UserArea
准备 OTP 1 次、DOM 写入匹配、AVANTI POST 1 次;进入 Calendar,准备登记通过
Book 日历分支 calendarBookCalls=1,8 月候选日期 0、9 月 0、10 月 14
失败 stage=production_book、type=BizLogicError;v4 未输出具体原因
全程请求统计 Availability 4、OTP 1、AVANTI 1、final 0
对账与退出 预约 0→0、候补 0→0,CLEANUP_OK,passed=false,exit 1

这次真实执行越过了先前的 Calendar 准备登记失败,并执行了 Book 日历扫描;但不能据此 证明过去空值的唯一原因。十月的 14 是正向日期候选数,不是已选定时段、已锁定名额或 预约成功数。bookRequestDelta=null 表示未完成最终回读统计,不能解释为没有请求。

根据日志位置和源码,失败范围在正向日期后的检查、日期/时段处理或其错误清理中;仍不能 判断是否已经点击日期、是否收到目标日的时段响应、是否因控件被遮挡而停下。 v4 的总计不包含 TimeSlots 次数,不能从 Availability=4 反推出这些动作。

诊断缺口与本轮实施范围

_book_prepared_calendar() 将适配器固定错误传为 BizLogicError,但验收工具 _failure() 只对白名单内的 calendar_preparation 错误输出原因。production_book 下日期控件、 时段响应和选择回读的不同错误都变成同一句通用输出。这是目前可确定的可诊断性缺口, 不能拿任意一个候选业务原因直接实施点击或重试修复。

Phase: IMPLEMENTING→离线 VERIFIED(仅诊断);Approval: 延续 Book 调试授权。 本轮只改验收工具、其专项测试和本文;不改生产 Book 适配器、Query、配置、选择条件、 等待时长、请求重试或最终提交规则。不新建日志框架,复用现有固定错误白名单模式。

v5 book-prefinal-selection-diagnostic-v5 增加:

  1. ITA_BOOK_GATE_FAILED.reason:已知日期、时段、上下文和回读错误输出固定原因码。 例如 date_control_timeout、timeslot_service_mismatch、slot_dom_timeout、 precommit_readback_rejected。协议动态错误仅输出固定分类,不输出动态 code;未知错误 仍为 unclassified_book_failure,不直接打印原始异常正文或 traceback。
  2. ITA_BOOK_GATE_SELECTION_DIAGNOSTIC:只在生产 Book 失败后、Reservation 对账前, 读取当前 Calendar。输出控件数量、服务值是否存在、选中日期是否一致、首个 selected 是否为日期链接、final guard 状态,以及最多 12 个当前时段的可见性/遮挡/尺寸等布尔值。
  3. 不输出日期字段值、时间文本、运行时 ID、请求/响应正文、凭据或验证码。Python 接收端 限定键集合、类型、计数范围及列表长度;不符时只报 readSucceeded=false,不部分泄露。
  4. 诊断本身不点击、不滚动、不刷新、不写字段、不发请求;失败不覆盖原始错误。仍按原流程 对账并清理,不留下浏览器或自动开始第二次预约准备。

快照明确标记 afterFailure=true,不能当作异常瞬间状态。timeSlotResourceEntries 是当前 页面 Resource Timing 中可见的资源条目数,可能受保留范围影响,不是新增的网络审计总数。 未被标红的时段也不自动等于有库存;可见性状态不能替代响应和日期/服务绑定检查。

本轮验证

机械完成标准:已知失败分类可区分、未知消息不泄漏;只读诊断能区分视口外与遮挡,格式 异常/自身失败不破坏原错误;完整失败流程仍只准备一次、final=0、完成对账与清理。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate

exit 0,66 项通过,0.260 秒。测试包含静态原因文案与真实生产源码一致性、原始异常脱敏、 诊断早于对账、未知字段/错误类型、传输失败保持原错误,以及 Node 合成 DOM 的视口外/ 被遮挡/超过 12 项情形。Node fixture 禁止点击和读取时段文本或隐藏 ID;它是离线脚本测试, 不是网站截图或真实页面布局证据。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_add_ita_query_account test.test_debug_ita_book test.test_debug_ita_book_gate test.test_debug_ita_calendar_gate test.test_debug_ita_monitor test.test_debug_ita_production_query_gate test.test_debug_ita_query test.test_debug_ita_session test.test_debug_ita_soak test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_calendar_query test.test_ita_local_handoff test.test_ita_plugin test.test_ita_protocol test.test_ita_route_wiring

exit 0,375 项通过,3.562 秒。覆盖的是以上 16 个模块,不宣称所有工作区测试都已运行。 期间工作区已有同步补充的错误分类回归被保留;按最终文件重新执行了测试。

  • 第 7.3 节香港配置加 --use-local-query-account --preflight:exit 0; external_requests=0 credentials_read=false browser_created=false。
  • 最终预检版本 book-prefinal-selection-diagnostic-v5,组合指纹 b95134494446。
  • git diff --check 及本轮未跟踪文件的尾随空白检查:exit 0。
  • 未运行真实登录、取信、OTP、AVANTI 或最终预约;本轮修复的是诊断,不是选时段故障本身。

初见审查与下一次现场回传

反驳:“怀疑时段没滚到屏幕里,为什么不直接加滚动或强制点击?”

回应:当前日志没有证明失败在可见性检查;也可能是日期、服务或响应不匹配。强制点击会 跳过原本有价值的检查。先输出固定原因和只读布局状态,再决定是否需要针对性的滚动修复。 若将来快照显示时段在屏幕外,也必须结合具体原因和响应绑定,不能仅凭一个布尔值改业务。

下一次沿用第 7.3 节完整配置及 --use-local-query-account --run,核对版本为 v5, 只执行一次,不手动点击 AVANTI、重发 OTP 或最终 Prenota。回传:

  • ITA_BOOK_GATE_TOOL_CONTRACT
  • ITA_BOOK_GATE_FAILED(含 reason,若失败)
  • ITA_BOOK_GATE_SELECTION_DIAGNOSTIC(若失败)
  • ITA_BOOK_GATE_RESULT、ITA_BOOK_GATE_CLEANUP_OK、EXIT_CODE

删除 OTP 输入行及任何个人资料。若同一阶段再失败,先依据诊断定位,不连续重跑。

17. v4 已跨过准备阶段,候选日期后的失败与 v5 诊断复核

17.1 本次现场事实(2026-08-30)

用户执行版本 book-prefinal-calendar-ready-v4、指纹 0bdd665ba78c,与第 16 节预检一致。 下列记录已去除账号、OTP、Session/端口等无关值,不保存原始终端输入:

  • 真实登录到 /UserArea;OTP 写入回读成功;OTP=1,AVANTI=1。
  • CALENDAR_READY transition=followed_redirect_200 final_requests=0:本轮已跨过空字段准备失败。
  • 生产 Book 月份日志:2026-08 candidates=0、2026-09 candidates=0、2026-10 candidates=14。
  • FAILED stage=production_book type=BizLogicError;原始原因未被 v4 工具输出。
  • calendarBookCalls=1、entryBookCalls=1;Availability=4,final=0,bookRequestDelta=null。
  • 预约 1→1、候补 0→0,清理成功,exit 1,passed=false。

确信度高:已进入实际 Book 扫描,不再停在 Calendar 准备登记;14 是候选日期数量,不是 已经拿到的时段数或预约数。结合当前 _capture_month() 的调用顺序,候选日志产生前已 处理该月自动日期的 TimeSlots 并检查日期回读。失败范围为后续候选日的选择、时段响应、 时段 DOM 匹配或提交前回读等;不能仅凭该日志判定按钮不可见、竞争失号或某个断言错误。

17.2 当前 v5:仅改诊断,不猜测性放宽业务条件

本轮读代码时,工作区已有 book-prefinal-selection-diagnostic-v5 及其新增测试,直接 复用审查。v5 在生产 Book 失败时、预约数量对账和清理之前:

  1. 将已知固定错误映射为具体原因码;未知字符串不原样输出,协议错误只输出固定类别。
  2. 只读读取 Calendar 页面状态,输出字段/选中日期/时段的数量、布尔值,以及时段是否 有尺寸、在视口内、中心是否被遮挡。每次最多输出 12 个时段的形状,不读取日期、时间、 runtime ID、Cookie、OTP 或用户文本。timeSlotResourceEntries 是当前页面已有的 performance 资源条目数,不作为精确 HTTP 请求次数或响应成功的证明。
  3. 诊断标记 afterFailure=true;失败后快照不能冒充错误发生瞬间的状态。 诊断自身失败也不覆盖原业务错误,不点击、滚动、刷新、发码或回放请求。

本轮额外修正一处已复现的问题:内部失败映射原先少了生产插件实际消息的 Italy 前缀, 导致该错误仍被输出为 unclassified_book_failure。新增专项测试先失败(exit 1),再仅 修正精确消息映射并通过;未知消息依旧脱敏。更改位于既有 Book 验收工具及对应测试, 不改生产 Book/Query 决策、框架、配置或最终提交边界。

17.3 新执行的验证

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_plugin

exit 0,191 项通过,2.332 秒。

第 16.3 节列出的相同 18 个模块命令重新执行:exit 0,425 项通过,3.595 秒。 这包括新增诊断、账号/请求预算边界、真实诊断 JS 的离线执行、Book/Query 与恢复回归。 这些是离线测试,不把日志中的替身请求计为网站证据。

第 16.3 节相同香港环境变量配置及 --preflight:exit 0, book-prefinal-selection-diagnostic-v5、指纹 b95134494446; external_requests=0 credentials_read=false browser_created=false。

真实 v5 运行未执行,业务失败原因仍待具体 reason 与 ITA_BOOK_GATE_SELECTION_DIAGNOSTIC;不可声明“选择失败已修复”。负责人下一次执行相同 配置 --run 仅为一次带诊断的定位;若失败,回传原因/诊断/汇总及退出码,不回传 OTP。

17.4 初见审查

反驳:“为什么测试通过,却仍需要再取一次现场日志?”

回应:测试证明诊断能把已知失败分开、未知敏感信息不会泄露、且不增加预约动作;它无法 从 v4 已丢失的错误详情恢复真实原因。现在先补可观察性,不以“候选日期存在”推断时段一定 可选,也不提前滚动或取消防护来掩盖尚未定位的问题。下轮明确原因后只修对应环节。

18. v5 明确为日期控件超时,尚缺目标日期的阻塞条件(2026-08-30)

18.1 现场证据与定位

用户执行 book-prefinal-selection-diagnostic-v5、指纹 b95134494446,已通过 Calendar 准备,扫描 8、9 月无候选,10 月 14 个候选;随后为 date_control_timeout,阶段 production_book,exit 1。OTP=1、AVANTI=1、Availability=4、final=0; 预约 1→1,候补 0→0,清理正常。未保存账号、验证码或完整终端输入。

事后状态:服务控件 1 个且非空;timeline/content 各选中 1 个、日期互相一致,第一个 selected 是 timeline 日期;3 个时段均无 unavailable/redDot 标志、activeSlotCount=0。 前两个时段在视口内且中心命中,第三个不在视口内;final guard 有效。 TimeSlots 资源条目为 3,但此数不是精确网络请求次数或响应成功的证明。

错误唯一对应 _click_date() 点击前的等待超时:目标日期链接数量不为 1,或 candidateEnabled=false。已选中目标日、点击未确认、点击后回读不一致都有别的错误。 因此不能用第三个时段在视口外解释该错误,更不能据此修改时段点击。 已有日期脚本允许 timeline 链接处于视口外;其 enabled 条件检查结构、class、CSS、尺寸。

18.2 下一步只读探针,不再让用户完整重跑试错

v5 诊断没有记录目标日期链接的阻塞条件;selected 日期互相相等不代表等于目标日期。 目前不能断言是缺节点、异步禁用 class、CSS 隐藏或尺寸为零。

在用户此前手动恢复的十月份 Calendar 中执行以下探针。仅拆开当前日期脚本的 enabled 条件,不请求、点击、滚动或写字段,也不读取隐藏服务/时段 ID、账号或 OTP。 若已没有这张页面,先告知,不要求为探针反复发送 OTP。

(() => {
  const links = [...document.querySelectorAll('.events a[data-date]')];
  return JSON.stringify({
    path: location.pathname,
    linkCount: links.length,
    dates: links.map(e => {
      const c = e.classList, s = getComputedStyle(e), r = e.getBoundingClientRect();
      const blocked = {
        detached: !e.isConnected,
        disabled: e.hasAttribute('disabled') || e.getAttribute('aria-disabled') === 'true' || c.contains('disabled'),
        unavailable: c.contains('notAvailableDay'),
        asyncDisabled: c.contains('input-async-disabilitato'),
        asyncEnabledMissing: !c.contains('input-async-abilitato'),
        hidden: s.display === 'none' || s.visibility === 'hidden',
        pointerBlocked: s.pointerEvents === 'none',
        transparent: !(parseFloat(s.opacity || '1') > 0),
        noSize: !(r.width > 0 && r.height > 0)
      };
      return {
        date: e.dataset.date,
        selected: c.contains('selected'),
        blockedBy: Object.keys(blocked).filter(k => blocked[k])
      };
    })
  }, null, 2);
})()

blockedBy=[] 只表示当前链接通过 enabled 条件,不证明有号,也不能追溯失败时状态。 列表还可用于核对目标日期是否缺失或重复;应依据具体阻塞条件选择修复方式。

18.3 验证与初见审查

  • node -e 隔离 VM 验证:exit 0, DATE_BLOCKER_PROBE_TESTS_OK cases=12 browser_created=false external_requests=0。 覆盖正常、缺异步启用 class、异步禁用、宽/高为零、隐藏、pointer-events、业务禁用、 aria-disabled、断开连接、透明以及空列表。
  • 本轮只补文档及其中的诊断片段,没有修改 Book/Query/工具/配置,未运行真实预约。
  • 未凭猜测延长等待、强制点击或移除校验;真实故障尚未修复。

反驳:“已知日期控件超时,直接删除 enabled 检查能否推进?”

回应:组合条件为 false 不说明每个条件都多余;删掉它可能点击站点明确禁用的日期。 先取得具体阻塞条件,只纠正错误假设,不把诊断测试通过说成 Book 已成功。

19. 日期链接零尺寸的真实证据与 v6 最小修复(2026-08-30)

Phase: VERIFIED(日期尺寸判断的离线回归);真实 Book 的完整提交前链路仍待验收。 Approval: 沿用 Book 修复授权;不执行真实 OTP/AVANTI/最终预约,不改账号或生产配置。

19.1 证据与根因边界

用户按第 18 节探针读取到 /BookingCalendar 的 22 个日期链接:

  • 日期为 2026-10 的 01、02、05、06、07、08、09、12、13、14、15、16、19、20、21、22、 23、26、27、28、29、30 日;22 个全部包含 blockedBy=noSize。
  • 其中 10 月 13 日已选中,并额外包含 pointerBlocked。
  • 其余 21 个未选中日期仅有 noSize,没有结构断开、原生/ARIA/class 禁用、异步禁用、 缺异步启用 class、不可用日期标记、元素自身隐藏、pointer-events 或透明度阻塞。

确信度高:当前日期脚本的尺寸门槛会拒绝这些未选中的真实链接。 第 18 节 v5 错误为点击前 date_control_timeout,而既有站点源码的 InizializzaTimelineOrizzontale() 使用日期链接自身的 .click()。 据此确认的是“现有尺寸前置条件与观察到的日期 DOM 不兼容”;恢复页面仍不是旧失败瞬间, 不宣称已经证明历史失败的所有因素,也不宣称真实 Book 已通过。

19.2 改在哪里、为什么只改这一处

复用现有组合式 Book 适配器,不新增浏览器层、通用重试框架或地区分支:

  • plugins/ita_calendar_book.py:仅在 DATE_SELECTION_SCRIPT 中移除 getBoundingClientRect() 及 width/height 正数条件。原本就调用链接 .click(), 不是依赖坐标的鼠标点击,因此日期动作不应以矩形尺寸作为必要条件。
  • 服务/页面一致性、单一目标日期、DOM 连接、原生/ARIA/class 禁用、异步启用、 不可用标记,以及元素自身 display/visibility/pointer-events/opacity 检查均保留。
  • 已选中的日期不重复点击。站点日期响应、所选日期回读和当前申请人绑定仍必须通过。
  • 时段选择的尺寸、视口和遮挡检查完全不变;没有强制点击时段或最终按钮,也没有取消 Calendar final guard。Query、OTP、预约状态及生产配置均未修改。
  • test/test_ita_calendar_book_flow.py:复用 Node 执行实际日期 JS 的既有测试架; 增加零宽、零高、零尺寸的正向回读,以及已选中且 pointer-blocked 的不重复点击用例。 旧 fixture 把“宽度为零”命名为 hidden,此次分离为真实 display:none 与零尺寸状态, 保留真正隐藏元素拒绝的断言,并补零尺寸同时禁用/隐藏/pointer-blocked 的拒绝用例。
  • tools/debug_ita_book_gate.py:仅将执行合同标识更新为 book-prefinal-native-date-v6,沿用 v5 的全部诊断与一次性动作预算。

19.3 先复现,再修正,最后回归

先增加零尺寸回归,在未改生产代码时运行:

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_calendar_book_flow.BookDateJavaScriptTests.test_zero_size_enabled_dates_follow_native_click_and_readback

exit 1;1 项测试中的 zero_width、zero_height、zero_size 三个子用例均失败, 均为 candidateEnabled=false。不是凭测试通过反推根因。

修正后:

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_calendar_book_flow.BookDateJavaScriptTests

exit 0,5 项通过,0.546 秒;覆盖原生日期动作及选择回读,最终点击次数为 0。

PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_plugin

exit 0,194 项通过,2.568 秒。

第 16.3 节相同 18 模块 Italy 回归命令:exit 0,428 项通过,3.835 秒。 该节相同香港环境变量与 --preflight:exit 0; version=book-prefinal-native-date-v6 source_sha256=37ece5fab296; external_requests=0 credentials_read=false browser_created=false。 离线替身日志不作为网站请求证据。文档及未跟踪修改另做尾随空白检查。

19.4 初见审查与下一步

反驳:“去掉尺寸检查,会不会把业务禁用或没有号的日期也选上?”

回应:尺寸不是号源信号。候选仍来自当前 Book 的正向 Availability 响应,并受用户日期 偏好过滤;目标唯一、业务禁用、会话和服务一致性等约束未删。点击后还必须取得目标日 TimeSlots 并回读当前日期,最终预约始终禁用。此次只纠正原生日期动作对布局尺寸的依赖。

下一次真实验收由负责人在自己的终端执行同配置 --run。该轮只允许一次 OTP/AVANTI, 确认前停止;回传选择/失败诊断、RESULT 与退出码,不回传验证码。若出现新的时段错误, 按新的具体原因处理,不把本次日期修复宣称为整个 Book 已完成。

20. v6 真实提交前验收通过(2026-08-30)

20.1 来源与脱敏记录

来源:负责人在自己的终端执行此前提供的香港单人旅游配置 python -B tools/debug_ita_book_gate.py --run,回传结果及 EXIT_CODE=0。 此处是用户执行的真实现场证据,不是助手在本轮新执行的网络测试。 结果合同为 book-prefinal-native-date-v6;准备阶段指纹为 1bf9f2b4783f。 该次回传未包含 Book 工具开头的 source_sha256,不补写为已观察到。 不记录账号、OTP 输入、Cookie、Token、申请人资料或运行时隐藏标识。

已观察:OTP 写入回读匹配、Calendar 通过 followed_redirect_200 到达; Book 重新扫描 2026-08、09、10 月,候选日期数分别为 0、0、14, 选中当前申请人会话内的 2026-10-13 09:15 - 10:00,选择时余量 3。 余量是该次现场快照,不保证随后仍有号,也不等于持有名额。

{
  "contract": "book-prefinal-native-date-v6",
  "exitCode": 0,
  "outcome": "pre_final",
  "passed": true,
  "selectionVerified": true,
  "bookResultSuccess": false,
  "entryBookCalls": 1,
  "calendarBookCalls": 1,
  "selectedDate": "2026-10-13",
  "selectedTime": "09:15 - 10:00",
  "remaining": 3,
  "requests": {
    "availabilityRequests": 4,
    "avantiPosts": 1,
    "finalRequests": 0,
    "otpRequests": 1
  },
  "bookRequestDelta": {
    "availabilityRequests": 3,
    "avantiPosts": 0,
    "finalRequests": 0,
    "otpRequests": 0
  },
  "reservationCountBefore": 1,
  "reservationCountAfter": 1,
  "waitlistCountBefore": 0,
  "waitlistCountAfter": 0
}

另有 ITA_BOOK_GATE_CLEANUP_OK。bookResultSuccess=false 是本阶段正确合同: 选中并回读不等于服务器确认预约,不应为了测试成功把业务成功字段改为 true。

20.2 验收结论与剩余边界

  • 确信度高:本次真实登录、表单准备、手工 OTP、一次 AVANTI、生产 Book 重查与日期/时段 选择回读均完成;之前的日期控件超时在本轮未再出现,提交前 gate 通过。
  • 最终预约请求为 0;预约 1→1、候补 0→0。本次没有创建已确认的预约记录, 但数量一致并不能证明服务器内部没有草稿或其他未公开状态。
  • 不能据此宣布完整 Book 成功、所有地区通用性已现场验证或生产上线就绪。 自动接码/重新需要 OTP 仍是 ITA-OTP-01,不随本次通过自动消除。
  • 下一阶段应定义并验证最终提交与回执/预约列表的一致性合同,优先复用现有框架和 VFS/BLS。 请求结果不明时先核验服务器状态,不能盲目重发最终提交。
  • 已有 1 条预约的服务和状态未知;真实最终提交前必须确认不造成重复预约。 不取消现有预约、不自动再运行、不因本次成功自动扩大最终提交权限。

20.3 本轮记录与初见审查

本轮仅更新本文和当前阶段状态;没有修改生产代码、工具、配置或测试。 文档验证使用 git diff --check 及针对未跟踪本文的显式尾随空白检查, 同时解析本节 JSON 并断言 gate、选择、请求预算和预约前后计数一致。 实际返回:git diff --check exit 0;awk 尾随空白检查 exit 0、 CS4C whitespace: OK;.venv/bin/python -B -c JSON 合同断言 exit 0、 CS4C_V6_EVIDENCE_OK external_requests=0。 本轮不重跑应用测试:仅有文档变更,上轮离线验证保留在第 19 节,不冒充新执行结果。

反驳:“passed=true,为什么还不能说预约成功?”

回应:passed 指验收工具完成了它的合同,而本工具的合同恰好是最终提交前停止。 finalRequests=0、bookResultSuccess=false、预约数量不变共同限定了成功的范围。 必须另有最终提交响应及与申请人、服务、日期、时间一致的持久预约记录,才可报告预约成功。

21. 旧预约已由用户取消;进入 CS5 离线开发(2026-08-30)

负责人确认原有 1 条预约属于相同香港签证服务,并已自行取消。这是用户报告,尚未读取 取消后的列表;不把原基线直接改为 0,也不推断取消记录一定从表格消失。

负责人随后授权最终阶段开发与离线测试,真实提交仍须确认具体日期/时段后另行执行。 实现、复用依据、469 项 Italy 回归及未完成的生产接线见 CS5。 没有运行最终预约,没有让原 pre-final 工具获得最终提交能力。