日期: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 节单次香港真实提交前证据;跨账号调度、其他地区、最终提交与回执、服务器内部草稿不在本次证明范围。
CS4B 已有 Calendar 之后的生产 Book 能力,但旧 debug_ita_book.py 只到前置表单。
直接给 CS4B 填一个准备标记,不能证明申请人真的完成过当前服务的 OTP/AVANTI。
本次新增一个可独立运行的验收入口,负责补齐这段证明,不改写生产调度器。
工具运行只意味着一次受控实验。passed=true 表示已选好时段且安全停下,不表示预约成功。
VSBookResult.success 必须仍为 false,预约编号等成功字段必须为空。
| 能力 | 复用来源 | 本轮处理 |
|---|---|---|
| 申请人自己的 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 工具不计划修改;若确需改动,先说明具体原因。
--preflight,不读取凭据、不创建浏览器、不发网站请求。--run 才允许登录、一次 OTP、一次 AVANTI 以及日历/时段选择。4937 写进实现分支。香港只用于下方示例。ITA_BOOK_USERNAME / ITA_BOOK_PASSWORD,或者在终端交互输入;不继承通用
ITA_USERNAME / ITA_PASSWORD,也不自动读取 Query 账号。--use-local-query-account 显式选择 config/ita_query_account.local.json。
此时用户名和密码整对从该文件读取,不和环境变量混用,不再要求手工输入账号密码。
文件缺失、权限不安全或字段无效时停止,不静默换账号;--preflight 即使带此开关也不读凭据。--expected-start-date / --expected-end-date 映射到 VFS 原有同名字段,闭区间且严格
YYYY-MM-DD;未指定沿用 2000-01-01 / 2100-01-01。实际扫描仍受 route 月数限制。multipart/form-data,没有文件控件;复用
preflight 操作已配置的可见选项和 Privacy,等待站点正常完成 Turnstile。SENT 响应。
人工输入后复用 DOM 回读验证。不输出输入值;可见输入会保留在终端,用户不要回传它。book() 调用但属于不同阶段。必须分别报告 entryBookCalls=1、calendarBookCalls=1,
不能把两次调用写成“Book 只调用了一次”。Calendar 分支内部仍只执行一次。last_booking_precommit。不能根据一张已存在的 Calendar 页面跳过步骤 2–8。任何身份/路径/结构/预算变化均停止。 已发 OTP、已提交 AVANTI 或结果不明确时,不重试、不自动重新登录再发一次。 失败时只尝试读取脱敏诊断、结束计数和预约数量,不重复写操作。
本轮沿用 Q-CAL 的 DOM 同步、POST 路径与跳转证明;不会新增 multipart 序列化器,也不会 输出/落盘完整 POST、Cookie、Token 或邮件。对完整 payload、服务端内部草稿的推断不在 本轮证明范围内。表单 enctype 或未知字段不同的其他领区应停止发现,不能猜测兼容。
| 假设或风险 | 离线证明 | 现场证明 |
|---|---|---|
| 只在明确选择时复用本地账号 | 默认不加载;开关选中完整凭据;文件错误停止;配置无 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 证据 |
正向 Gate 必须全部满足:
entryBookCalls=1、calendarBookCalls=1。otpRequests=1、avantiPosts=1、finalRequests=0。last_booking_precommit 和偏好日期匹配;bookResultSuccess=false。返回码:0 本地预检通过或正向停点验收通过;1 合同/网站错误;2 本轮无正向号源;
3 清理失败;130 人工中断。只有 --run 的 passed=true 才是现场正向停点证据。
最终按钮保护与被动计数不是服务端写屏障;数量不变也不证明没有不可见草稿或临时状态。 超时仍是各步骤预算,不声称覆盖浏览器底层连接的整体硬墙钟上限。
实施前相关基线测试: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 或部署。
反驳:“这又是一个只测 helper 的调试脚本,不能说明生产 Book 已接通。”
回应:新测试运行真正 Book 的表单分支,再经受控准备登记运行真正 Calendar 分支,而不是
mock 掉 book() 的返回值。现场工具也走相同调用路径。但它仍是人工准备入口,并没有
把 OTP/AVANTI 接进普通订单调度,所以不能宣称生产 Book 已完整实现;这一缺口明确列在下节。
反驳:“都选好时段了,为什么仍返回 Book 失败?”
回应:本轮的 VSBookResult.success=false 是有意的提交前停点。工具独立输出
selectionVerified=true / passed=true,仅代表安全验收通过,不误触发现有 Booker 的
预约成功回写和通知。最终提交能力接入后才允许返回真实成功。
以下是香港示例,命令本身不含密码;申请人账号必须能访问该服务。先用 --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 输入行、密码、完整请求/响应或个人信息截图。失败后先看原因,不直接重复执行。
负责人最新要求:不追求完美,做到与既有 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 离线合同为高;自动接码、最终提交及真实订单上线证据仍未取得。
负责人明确“用一个就行,这个账号可以复用”。将其落实为本地验收的显式开关
--use-local-query-account,不改变生产 Book 从订单取得申请人账号的合同。
本次仅编辑本工具、其专项测试和本文,没有修改 Query、账号文件或生产配置。
实现仍用组合:_book_credentials() 调用现有 load_local_account(),复用路径、权限、
JSON 与必填字段校验。开关选中后,整对凭据来自已保存文件;不带开关仍用原 Book 输入路径。
不复用 Query profile、Cookie、登录状态、Calendar 准备标记或旧时段。
本地文件错误会停止,错误输出不包含加载器原始详情,不回退到另一个账号。
源码指纹新增两个公共加载模块,但不包含账号配置文件或秘密值。
均在本地执行,未启动浏览器、读取邮箱、发送 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 假浏览器链路继续使用独立准备与最终请求为零。
反驳:“用同一个账号,会不会把 Query 的状态直接当成 Book 的准备结果?”
回应:只复用凭据,Book 仍创建临时浏览器并重新登录、完成自己的 OTP/AVANTI、登记自己的 准备记录、重查时段。专项测试验证没有 persistent profile 或 Query 准备标记。 同账号两个会话在服务器上是否互相影响尚未验证,现场请先暂停该账号的 Query; 本次验收不宣称跨账号交接已验证,也不宣称预约已成功。
calendar_preparation,异常类型 BizLogicError。entryBookCalls=1、calendarBookCalls=0,故不能把自动加载的 1 次 Availability 请求说成 Book 扫描。finalRequests=0;预约和候补数量分别前后都是 0。cleanup_listener / AttributeError,最终 passed=false、exit 3。清理问题已用本机安装的 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 验收工具、其测试和本文:
完成标准:专项及显式 Italy 回归 exit 0;重复清理不再覆盖原始业务失败,诊断不泄露值。 真实 Calendar 标识错误仍需新诊断才能定案,本轮不声称其已修复。
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。Ran 350 tests in 3.412s ... OK。未把测试中的 Q-CAL 日志当作网站证据。--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,以及只允许已知固定错误的原因码。
反驳:“之前测试全过,为什么实际还会重复关闭出错?”
回应:此前的 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 和退出码即可,删除验证码输入行。
本节保存负责人回传的脱敏结果,不保存 OTP、账号或运行时标识值。
#idServizio 控件恰好 1 个,值类型为字符串、长度为 0、valueAccepted=false。calendar_service_unidentified,阶段为 calendar_preparation。entryBookCalls=1、calendarBookCalls=0:尚未执行 Book 的日历扫描和时段选择。finalRequests=0。CLEANUP_OK,exit 1。v2 的 listener 清理错误此次没有复现。确信度:上述日志事实为高。快照是 afterFailure 读取,不能证明最初读取时刻的全部状态, 也不能仅凭空字符串确定网站赋值失败或页面加载过慢。
工具在 finally 中调用现有 read_reservation_snapshot(),通过新标签访问 /Reservation
核对预约/候补数量;DrissionPage 的新标签默认在前台打开。因此用户在失败后看到 Reservation
与本工具的对账行为一致,并不说明站点把 Book 的日历步骤替换成了预约列表。
正常路径仍为 OTP/AVANTI→Calendar→重查日期和时段;此次中断在 Calendar 准备登记。
源码 CaricaTimelineVerticale() 已证明 TimeSlots 的 idService 从 #idServizio 读取,
但既有取证没有证明该字段始终非空,也没有保存它的赋值逻辑。
现有 Book 实现和测试把“非空运行时服务标识”设为前置条件;测试成功只能证明检查行为,
不能倒推这个前置条件符合真实网站。
需要区分以下假设,当前不批准其中任何一项作为修复依据:
下一步只读定位 Sources 全局搜索 idServizio 的命中及其调用上下文,必要时核对已发生的
RetrieveTimeSlots 请求中 idService 的存在性、类型和空值状态。不得输出实际标识、
Cookie、OTP 或完整请求;不得为了取证重发请求、调用初始化函数或点击最终预约。
若需要改变运行时绑定合同,应先用网站证据确定替代的服务一致性校验,再调整 Book 和测试。
不能直接删除校验、把配置的 Services ID 填入该字段,或先添加任意 sleep 试运气。
该业务失败已在 v2/v3 两次现场执行中出现,不再要求负责人盲目重跑完整 OTP/AVANTI 流程。
本轮 Chrome 只读标签清单仅取得 /Reservation;尝试在独立标签打开已知 Calendar URL 时
控制调用超时,后续原浏览器句柄报告不可用。未取得 Calendar DOM 或赋值源码,不能把控制
超时说成站点登录失败;也无法断言该次导航未在浏览器端发生。没有主动发送 OTP、提交表单、
选择日期/时段或执行最终预约。
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;
取得字段读取逻辑,未取得字段写入逻辑。反驳:“既然能进入 Calendar,直接允许空字段继续选择不就好了?”
回应:进入 Calendar 证明导航成功,不证明服务绑定正确;但反过来,也不能未经证实就断定 空字段必定错误。应先取得网站的实际初始化和请求证据,再保留必要的账号、路由、页面、 日期及时段一致性检查。这是纠正协议假设,不是无限增加防御或放弃校验。
Phase: DISCOVERY(本地修复已有授权,但根因证据尚不足,未实施猜测性修复) Scope: 空运行时标识的来源;不重复 OTP/AVANTI,不提交或修改现有预约。
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 重查分支。_wait_for_calendar() 只等待 URL 到达 Calendar 和文档加载完成;紧接着 Book 准备登记
调用严格的 read_calendar_service()。该读取要求一个 #idServizio 和非空字符串。
这证明了“当前代码为什么拒绝”,并未证明“网站为什么为空”。
只读等待存在可行的实现位置,但现在不能假定等一段时间就会填值。第 11.3 节中的异步赋值、 交互后赋值、合法空字段三种解释仍未排除。因此本次不添加固定延时或轮询,不放宽读取校验, 也不以配置中的 Services ID 替代 Calendar 运行时标识。此前提出的有界等待方案暂缓。
下一证据入口:在已恢复的 Calendar 中只读检查 idServizio 的赋值源码,以及已经发生的
RetrieveTimeSlots 请求里 idService 的存在性、类型、是否为空;不读取 Cookie/OTP,
不回放请求,不为了取证调用初始化函数或选日期。确认协议事实后再选最小修复及回归用例。
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;本轮只补本文,未修改插件、工具、测试或配置。反驳:“既然控件存在但为空,加等待是否能最快修好?”
回应:只有空值确实是短暂初始化状态时才成立。如果站点允许空参数,等待再久也不能修好。 优先取得一次真实请求和赋值证据,可以避免把同一业务失败再次交给用户用 OTP 试错。
user.openTabs() 与随后 tabs.list() 均返回
Calendar - Prenot@Mi、/BookingCalendar,确认标签已恢复;未输出查询参数。browser-troubleshooting 指引,尝试同一 Chrome 标签的 CDP 能力文档,亦超时。
两次后停止重试;没有切换浏览器、刷新、导航、发送 OTP、选择日期或提交预约。RetrieveTimeSlots
请求,确认载荷 idService 的空值状态;不回放请求、不索要完整请求或实际标识值。来源:负责人从当前网页 Sources 提供 ValorizzaComponentiPagina(JsonServerInfo) 和
CaricaTimelineVerticale(_Giorno, _ContenutiEventi) 函数源码。以下为静态源码证据,
不是已观察到函数执行完成或成功请求的证据。
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 相等,也不允许用配置值替换真实页面值。
JsonServerInfo 本身不能单独证明对应网络请求的响应格式或 callback 接线。_wait_for_calendar() 仅等待 Calendar URL 和 doc_loaded(),并不显式等待该
初始化函数完成。因此存在就绪检查缺口,但不能据此宣称它就是本次空值的原因。最小下一证据:在当前 Calendar 的 Network 中读取一个已经发生的
RetrieveTimeSlots 请求,只确认 Payload 的 idService 是非空、空字符串还是缺失。
不要回放请求、重新发送 OTP、主动触发日期点击或输出字段实际值。
若已有成功时段响应且参数为空,则必须重新评审非空前置约束;若参数非空,再核对 DOM
及初始化就绪时机。当前页面证据不能自动追溯为先前失败 Session 的事实。
rg / sed 核对本地 Calendar 等待、Book 准备登记、字段读取和既有记录:exit 0。反驳:“已经找到赋值函数,为什么还不直接加一个等待?”
回应:可见的同步顺序是先赋值、后请求日期;若源数据就是空的,等待不会改善结果。 一次既有请求的字段形状核对可以区分不同修复方向,避免再次让负责人用 OTP 试错。
负责人回传当前已发生的 RetrieveTimeSlots 请求载荷:
{"selectedDay":"2026-10-13","idService":"4937"}
idService 字段,类型为字符串且非空;值与本次香港配置的
Services 入口 ID 相等。此处保存的是已知业务服务 ID,不保存账号、OTP、Cookie 或 Token。#idServizio 的原生 .value 与 jQuery
.val() 是否都与这条请求一致;检查控件数量,以区别字段就绪变化与读取方式差异。
不刷新、不选日期、不发起新请求。本轮只记录取证进展,未改实现,未运行业务测试;git diff --check 和本文尾随空白检查
作为文档校验。真实 Book 尚未通过。
负责人提供当前页面已发生的 RetrieveTimeSlots 请求载荷:
{"selectedDay":"2026-10-13","idService":"4937"}
这证明该次请求携带非空字符串标识,且恰与当前 Services 入口 ID 数值相同;不证明所有 领区或所有会话都相同,亦不构成“直接使用配置值”的依据。未同时提供该请求的状态码和 响应,不能仅凭载荷宣称有号或预约成功。不得将它追溯为此前失败 Session 的请求。
结合第 13 节赋值源码,可确认现有实现有一个就绪检查缺口:doc_loaded() 后直接严格读
运行时字段,没有专门等待网站填值。补条件等待的设计依据已具备;但“早读就是先前失败的
唯一根因”仍未证实。如果字段持续为空,v4 仍会停止,不把等待当作保证成功的办法。
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。plugins/ita_plugin.py、Query 适配器、Q-CAL 工具、共享类型或生产配置。仅一个结构正确控件的精确空字符串属于可等待状态。缺控件、多控件、非字符串、空白、 过长值、离开 Calendar、tab/申请人/路由变化及已记录服务变化均停止,不当作“尚未加载”。 每轮检查上下文,并保持现有最终按钮 guard;不写服务值、不选日期、不触发网络或提交。 5 秒是轮询预算,不是浏览器底层传输的硬墙钟上限;传输错误不会被循环吞掉或重试。
持续空值在工具准备阶段输出 calendar_service_not_ready,保留现有脱敏快照和事后对账;
不重复发送 OTP/AVANTI。其他字段识别错误仍用 calendar_service_unidentified。
机械完成标准:就绪即返回、延迟就绪可继续、持续空值有界失败、结构/会话/服务漂移失败、 刷新后等待不增加刷新次数、原有严格读取不变;聚焦及显式 Italy 回归 exit 0,预检无外部 请求或凭据读取。该标准不包含真实时段选择或最终预约成功。
第一轮聚焦测试 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 日志来自替身,不是现场请求证据。
--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;
共享依赖变更会改变指纹,不能用这个值替代实际执行版本核对。反驳:“等待会不会把切换到另一个账号/服务当成加载完成?”
回应:等待前后检查申请人、路由、tab 和 Calendar 路径,刷新后还要求服务与准备记录一致; 非空但不匹配不是待重试状态。稳定阶段的严格读取没有改成宽松等待。
反驳:“新增测试是不是又只证明了理想替身?”
回应:是离线行为证据,不能替代现场。因此只宣称就绪检查缺口已修复并通过离线验证,
不宣称历史空值根因已唯一确定。下一次真实验收需核对 v4:若就绪继续,必须观察到
calendarBookCalls=1、新时段响应和提交前选择回读;若仍超时,停止并按持续空值调查,
不通过加长等待或盲目重发 OTP 继续试错。所有情况下 final 必须为 0,预约/候补对账不变。
现场命令沿用第 7.3 节的明确路由配置和 --use-local-query-account --run;本轮没有执行。
{
"path": "/BookingCalendar",
"fieldCount": 1,
"ourRead": [{"empty": false, "matchesRequest": true}],
"websiteReadMatchesRequest": true
}
比较基准为第 14 节已经发生的请求中的业务服务 ID。确信度高:这次恢复后的页面有且只有
一个目标控件,原生 .value 与网站 jQuery .val() 均为非空,且都与请求一致。
没有证据支持更换这两种读取方式或放宽非空约束;仍不能追溯证明旧失败 Session 的根因。
开始本轮代码核对时,工作区已经具有第 15 节的 v4、条件等待及回归测试。本轮直接复用和 审查这些修改,没有重新实现等待,没有改插件、工具、测试、配置或现有用户改动。
已核对以下行为:
4937 或其他配置值兜底;已就绪时立即返回。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-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 增加:
ITA_BOOK_GATE_FAILED.reason:已知日期、时段、上下文和回读错误输出固定原因码。
例如 date_control_timeout、timeslot_service_mismatch、slot_dom_timeout、
precommit_readback_rejected。协议动态错误仅输出固定分类,不输出动态 code;未知错误
仍为 unclassified_book_failure,不直接打印原始异常正文或 traceback。ITA_BOOK_GATE_SELECTION_DIAGNOSTIC:只在生产 Book 失败后、Reservation 对账前,
读取当前 Calendar。输出控件数量、服务值是否存在、选中日期是否一致、首个 selected
是否为日期链接、final guard 状态,以及最多 12 个当前时段的可见性/遮挡/尺寸等布尔值。readSucceeded=false,不部分泄露。快照明确标记 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 个模块,不宣称所有工作区测试都已运行。 期间工作区已有同步补充的错误分类回归被保留;按最终文件重新执行了测试。
--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。反驳:“怀疑时段没滚到屏幕里,为什么不直接加滚动或强制点击?”
回应:当前日志没有证明失败在可见性检查;也可能是日期、服务或响应不匹配。强制点击会 跳过原本有价值的检查。先输出固定原因和只读布局状态,再决定是否需要针对性的滚动修复。 若将来快照显示时段在屏幕外,也必须结合具体原因和响应绑定,不能仅凭一个布尔值改业务。
下一次沿用第 7.3 节完整配置及 --use-local-query-account --run,核对版本为 v5,
只执行一次,不手动点击 AVANTI、重发 OTP 或最终 Prenota。回传:
ITA_BOOK_GATE_TOOL_CONTRACTITA_BOOK_GATE_FAILED(含 reason,若失败)ITA_BOOK_GATE_SELECTION_DIAGNOSTIC(若失败)ITA_BOOK_GATE_RESULT、ITA_BOOK_GATE_CLEANUP_OK、EXIT_CODE删除 OTP 输入行及任何个人资料。若同一阶段再失败,先依据诊断定位,不连续重跑。
用户执行版本 book-prefinal-calendar-ready-v4、指纹 0bdd665ba78c,与第 16 节预检一致。
下列记录已去除账号、OTP、Session/端口等无关值,不保存原始终端输入:
/UserArea;OTP 写入回读成功;OTP=1,AVANTI=1。CALENDAR_READY transition=followed_redirect_200 final_requests=0:本轮已跨过空字段准备失败。FAILED stage=production_book type=BizLogicError;原始原因未被 v4 工具输出。calendarBookCalls=1、entryBookCalls=1;Availability=4,final=0,bookRequestDelta=null。passed=false。确信度高:已进入实际 Book 扫描,不再停在 Calendar 准备登记;14 是候选日期数量,不是
已经拿到的时段数或预约数。结合当前 _capture_month() 的调用顺序,候选日志产生前已
处理该月自动日期的 TimeSlots 并检查日期回读。失败范围为后续候选日的选择、时段响应、
时段 DOM 匹配或提交前回读等;不能仅凭该日志判定按钮不可见、竞争失号或某个断言错误。
本轮读代码时,工作区已有 book-prefinal-selection-diagnostic-v5 及其新增测试,直接
复用审查。v5 在生产 Book 失败时、预约数量对账和清理之前:
timeSlotResourceEntries 是当前页面已有的
performance 资源条目数,不作为精确 HTTP 请求次数或响应成功的证明。afterFailure=true;失败后快照不能冒充错误发生瞬间的状态。
诊断自身失败也不覆盖原业务错误,不点击、滚动、刷新、发码或回放请求。本轮额外修正一处已复现的问题:内部失败映射原先少了生产插件实际消息的 Italy 前缀,
导致该错误仍被输出为 unclassified_book_failure。新增专项测试先失败(exit 1),再仅
修正精确消息映射并通过;未知消息依旧脱敏。更改位于既有 Book 验收工具及对应测试,
不改生产 Book/Query 决策、框架、配置或最终提交边界。
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。
反驳:“为什么测试通过,却仍需要再取一次现场日志?”
回应:测试证明诊断能把已知失败分开、未知敏感信息不会泄露、且不增加预约动作;它无法 从 v4 已丢失的错误详情恢复真实原因。现在先补可观察性,不以“候选日期存在”推断时段一定 可选,也不提前滚动或取消防护来掩盖尚未定位的问题。下轮明确原因后只修对应环节。
用户执行 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、尺寸。
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 条件,不证明有号,也不能追溯失败时状态。
列表还可用于核对目标日期是否缺失或重复;应依据具体阻塞条件选择修复方式。
node -e 隔离 VM 验证:exit 0,
DATE_BLOCKER_PROBE_TESTS_OK cases=12 browser_created=false external_requests=0。
覆盖正常、缺异步启用 class、异步禁用、宽/高为零、隐藏、pointer-events、业务禁用、
aria-disabled、断开连接、透明以及空列表。反驳:“已知日期控件超时,直接删除 enabled 检查能否推进?”
回应:组合条件为 false 不说明每个条件都多余;删掉它可能点击站点明确禁用的日期。 先取得具体阻塞条件,只纠正错误假设,不把诊断测试通过说成 Book 已成功。
Phase: VERIFIED(日期尺寸判断的离线回归);真实 Book 的完整提交前链路仍待验收。 Approval: 沿用 Book 修复授权;不执行真实 OTP/AVANTI/最终预约,不改账号或生产配置。
用户按第 18 节探针读取到 /BookingCalendar 的 22 个日期链接:
blockedBy=noSize。pointerBlocked。noSize,没有结构断开、原生/ARIA/class 禁用、异步禁用、
缺异步启用 class、不可用日期标记、元素自身隐藏、pointer-events 或透明度阻塞。确信度高:当前日期脚本的尺寸门槛会拒绝这些未选中的真实链接。
第 18 节 v5 错误为点击前 date_control_timeout,而既有站点源码的
InizializzaTimelineOrizzontale() 使用日期链接自身的 .click()。
据此确认的是“现有尺寸前置条件与观察到的日期 DOM 不兼容”;恢复页面仍不是旧失败瞬间,
不宣称已经证明历史失败的所有因素,也不宣称真实 Book 已通过。
复用现有组合式 Book 适配器,不新增浏览器层、通用重试框架或地区分支:
plugins/ita_calendar_book.py:仅在 DATE_SELECTION_SCRIPT 中移除
getBoundingClientRect() 及 width/height 正数条件。原本就调用链接 .click(),
不是依赖坐标的鼠标点击,因此日期动作不应以矩形尺寸作为必要条件。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 的全部诊断与一次性动作预算。先增加零尺寸回归,在未改生产代码时运行:
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。
离线替身日志不作为网站请求证据。文档及未跟踪修改另做尾随空白检查。
反驳:“去掉尺寸检查,会不会把业务禁用或没有号的日期也选上?”
回应:尺寸不是号源信号。候选仍来自当前 Book 的正向 Availability 响应,并受用户日期 偏好过滤;目标唯一、业务禁用、会话和服务一致性等约束未删。点击后还必须取得目标日 TimeSlots 并回读当前日期,最终预约始终禁用。此次只纠正原生日期动作对布局尺寸的依赖。
下一次真实验收由负责人在自己的终端执行同配置 --run。该轮只允许一次 OTP/AVANTI,
确认前停止;回传选择/失败诊断、RESULT 与退出码,不回传验证码。若出现新的时段错误,
按新的具体原因处理,不把本次日期修复宣称为整个 Book 已完成。
来源:负责人在自己的终端执行此前提供的香港单人旅游配置
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。
ITA-OTP-01,不随本次通过自动消除。本轮仅更新本文和当前阶段状态;没有修改生产代码、工具、配置或测试。
文档验证使用 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、预约数量不变共同限定了成功的范围。 必须另有最终提交响应及与申请人、服务、日期、时间一致的持久预约记录,才可报告预约成功。
负责人确认原有 1 条预约属于相同香港签证服务,并已自行取消。这是用户报告,尚未读取 取消后的列表;不把原基线直接改为 0,也不推断取消记录一定从表格消失。
负责人随后授权最终阶段开发与离线测试,真实提交仍须确认具体日期/时段后另行执行。 实现、复用依据、469 项 Italy 回归及未完成的生产接线见 CS5。 没有运行最终预约,没有让原 pre-final 工具获得最终提交能力。