# CS5:最终提交与预约结果核验 最新状态(2026-08-31,第 30 节):最终核心和本地 Book 验收入口已接通本次提交归属与 VSBookResult.success 回传,book-final-attribution-v9 / 1949de666430;626 项 Italy 离线回归及无网络预检通过。新增请求证据与真实回执字段分开保存;响应格式未知时, 仍可凭已匹配的单次请求、唯一新增确认回执和未变历史核验成功,并保留网站分配时刻。 第 29 节真实只读验收仍有效,但不能倒推旧 v8 已具备本次新增的请求匹配证据。 本轮未访问真实网站、重新预约、取消或清除 claim;生产 final 仍关闭, 生产任务状态/持久未知结果阻断、自动 OTP 与原 v8 响应 unknown 的具体根因仍待完成。 第 31 节新增生产链路审查:已离线复现未知结果被再次调用,以及后端回收覆盖 pause/grabbed; 仅在插件内部补暂停不足以解决,需要明确共享任务后端的最小改动范围后继续实现。 下文初始合同及早期“待采集”描述保留为历史记录,以后续证据节为准。 日期:2026-08-30。Phase: VERIFIED(仅最终阶段核心的离线合同;生产接线仍未开放)。 Scope: 复用既有 Book 的选择结果,补一次性原生提交、结果分类与只读对账。 Non-goals: 不运行真实预约,不接自动 OTP,不开启生产 final,不改共享调度器。 Done: 默认关闭;提交最多一次;有效旧预约阻止提交;取消记录不冒充有效预约; 仅唯一匹配的新有效预约可返回成功;结果不明不重提;Italy 回归通过。 Approval: 负责人“没问题,开始吧”承接“开发与离线测试,真实提交另行确认”的授权。 Evidence/Risks: v6 提交前真实链路已通过;最终响应只有站点源码证据,预约列表的字段、 状态和分页语义尚未采集,禁止凭空写真实 HTML 解析器。 ## 1. 可复用能力与代码归属 - VFS `book()`:依据站点结果填充 `VSBookResult` 的 account、urn、book_date、book_time。 - BLS `book()`:沿用同一结果类型,但其业务成功阶段不同,不能复制其网页字段到 Italy。 - `ita_protocol.py`:复用 `PrecommitApproval`、日期/时段及正向库存合同。 - `ita_calendar_book.py`:复用原有时段 DOM 回读和校验;仅提取公共的只读复核入口。 - `ita_calendar_query.py`:复用同源 URL 检查、`listen_once` 的监听生命周期。 - 新 `plugins/ita_booking_final.py`:单一最终阶段模块,组合上述能力;内部预约记录是 规范化领域对象,不声称是网站实际 JSON/HTML schema。 - 新 `test/test_ita_booking_final.py`:纯数据、替身浏览器和实际 JavaScript 的离线验证。 不新增调度/邮件/浏览器框架,不复制 Query 的状态。生产 `ItaPlugin.book()` 和原验收工具 保持 pre-final;本阶段新增模块不被它们自动调用,也不新增可执行真实最终提交的 CLI。 ## 2. 已知事实与未验证假设 已知源码:`#btnPrenotaNoOtp` 原生 handler 使用当前 `.fascia.act` 的隐藏 ID、 完整 innerText 与 `.selected` 日期,POST `/BookingCalendar/InsertNewBooking`; 回调读取 `errorMessage`、`url`。因此调用原生按钮,不手写最终 POST。 未验证:真正成功/失败返回体、成功跳转页面、预约编号与服务标识所在列、取消/有效/候补 状态、列表分页与加载完成标志。只实现独立的规范化读取接口;没有受验证的生产读取实现 时不能接生产 final。非空 errorMessage 只是拒绝线索,不擅自解释为“失号”。 用户确认旧的同服务预约已取消;这是用户报告,尚未取得取消后的列表证据。 列表总数量不等于有效预约数,不能假定取消后总数量必须为 0。 ## 3. 技术合同 1. 目标绑定申请人、route、服务和本次 Book 的 PrecommitApproval;最终调用须再次显式启用。 2. 提交前读取当前申请人的完整预约快照。未知状态、未完成加载、分页不完整、上下文变化 均停止;同服务有效预约或候补阻止新增,取消记录保留在基线但不算有效预约。 3. 复核选中状态,监听器先启动,再在同一同步 JS 中复核并仅临时启用原生最终按钮点击一次, 随即恢复禁用。不点击日期、时段或发 OTP,不跟随猜测的成功 URL 主动导航。 4. 请求方法、同源路径、当前 tab、提交字段与当前选中值必须一致;响应只有 schema 合格 才分类为接受/拒绝线索。HTTP 200 或 errorMessage 为空都不能单独证明预约成功。 5. 无论超时还是收到响应,只做只读对账。完整快照中出现唯一匹配申请人、服务、日期、时间 的新有效预约编号,且无冲突时才返回 `VSBookResult(success=True)`。 6. 拒绝线索与完整快照无新增记录一致时返回明确失败;接受线索但没有记录、响应与记录冲突、 读取失败、错账号/服务或多条记录均为结果不明。结果不明抛固定安全错误,不伪装为可重试无号。 7. 一次性对象进入执行即消耗;重复调用不能重发。结果不明只允许再次读取预约列表。 一次性对象和 DOM 标记仅提供进程/页面内保护,不宣称跨进程 exactly-once。 这里的一次指最多一次原生按钮动作;`listen_once` 取得一个 packet 不能单独证明整轮 只发生一个 HTTP 请求。未来真实验收须继续复用 Q-CAL 的 `CalendarRequestAudit` 统计, 不能把资源计数或单个响应当成完整网络审计。 当前 OrderBooker 的失败分支会在下一信号重试,现有 tracker 不是提交结果账本。 生产接线前必须落实既有任务状态的暂停/人工对账路径;如果现有机制不足,需要另行确认 最小持久保护改动,不在本阶段暗中新增 Redis/数据库平台。 ## 4. 开发与测试计划 先补只读选择复核并跑既有 Book 回归;再补最终模块及以下用例: - 默认关闭、未授权、错页面/tab/service/账号、选择失效均无提交。 - 正向与已取消历史、已有有效预约、候补、未知状态、不完整快照、重复编号。 - 原生点击、字段绑定、最终按钮重新禁用、重复调用不点击。 - 合格响应+新记录成功;拒绝+无记录失败;超时+新记录只读恢复成功。 - 接受但无记录、矛盾响应、错日期/时间/服务、多记录、读取异常均不误报成功。 - 固定错误不泄露响应正文、Token、runtime ID 或申请人数据。 - Query/原提交前入口不导入最终模块,final 配置仍拒绝开启。 JS 用合成 DOM 执行真实脚本;预约快照明确是合成领域数据,不能用测试通过证明真实 HTML 解析能力。源码与测试通过后再请负责人提供只读的预约列表表头/状态结构;不要求再发 OTP。 ## 5. 准出边界 本地阶段:上述离线合同通过、现有 Italy 回归通过、默认入口仍不最终提交。 真实阶段另行批准:先完成列表和成功回执证据接线,再由负责人确认具体日期/时间及执行 一次真实预约。尚无真实回执时不宣称完整 Book 已修好或已可上线。 ## 6. 初见审查 反驳:“为什么不直接沿用预约数量 0→1 就判成功?” 回应:列表可能包含取消记录,且另一服务的预约也会增加数量;必须核对申请人、服务、 日期、时间、状态和新编号。当前证据只支持数量检查,因此生产读取接线应等真实字段证据, 不能靠扩大 success 判据跨过缺口。 ## 7. 实现与实际验证结果 已实现: - `verify_precommit_selection()` 提取同一套只读日期/时段批准逻辑,原有选择路径调用同一 helper;不添加刷新、点击或请求。库存仍是选择时的快照,不能宣称锁号。 - `FinalTarget` 明确绑定账号、登录代次、tab、route、服务、运行时服务及选中结果。 - `NativeFinalSubmitter` 先复核选中,再通过既有 listener 包住一次原生按钮动作。 点击所在同步 JS 复用真实 `SLOT_SELECTION_SCRIPT`,检查后仅暂时启用按钮,finally 恢复。 - `classify_final_packet()` 检查同源、POST、tab、HTTP 类型、实际提交字段和值形状, 拒绝重复表单/JSON 字段、跨源跳转、未知 schema。原始错误文案不会成为异常消息。 - `FinalBookingAttempt` 单次执行;完整的规范化预约基线、取消/有效/候补区分、唯一新记录 核对、既有 `VSBookResult` 输出。超时可由只读新记录核实;矛盾或缺失证据维持 unknown。 Ctrl-C 在可能提交后也保留 unknown,之后只能只读核验,不能再执行提交。 - 原生产 flag 仍拒绝开启,原工具不导入最终模块。未新增真实 final CLI、真实预约列表 解析器、自动 OTP、跨进程提交屏障或调度器改动;这些不被离线测试“替身实现”冒充完成。 ### 7.1 最终执行的命令与结果 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_booking_final ``` exit 0,**41 项通过,0.553 秒,无跳过**。包含 Node 执行实际组合原生提交 JS;测试的 click 仅发生在合成 DOM,不是网页操作。 ```sh 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 test.test_ita_booking_final ``` exit 0,**469 项通过,4.157 秒,无跳过**。这些是显式列出的 Italy 模块,不是全仓库 测试,也不把替身日志中的请求或 OTP 等待当成真实网站行为。 ```sh 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-native-date-v6` 指纹 `bcc2da96cd22`; `external_requests=0 credentials_read=false browser_created=false`。 指纹因共享 Book 只读逻辑提取改变;原 v6 真实结果仍只证明其当时的源码版本,新版本 本轮只有离线回归。该 pre-final 指纹不包含未接入的新 final 模块,不作为 final 实测版本证据。 ```sh git diff --check awk '/[ \t]+$/ { print FILENAME ":" FNR; bad=1 } END { if (bad) exit 1; print "CS5 whitespace: OK" }' plugins/ita_calendar_book.py plugins/ita_booking_final.py test/test_ita_booking_final.py docs/ita_book_cs5.md ``` 两项均 exit 0。显式 awk 覆盖未跟踪文件,不能只依赖 git diff 检查新增文件。 中途一次新增“只读复核时状态改变”测试失败:测试使用了仅点击之后才生效的 `after_overrides`,但此测试有意不点击;纠正为已有替身的当前状态 `overrides` 后通过。 没有为让测试通过而放宽生产状态校验。 ### 7.2 剩余工作,不当成已完成 1. 只读采集 `/Reservation` 的表头、有效/取消状态、服务/日期/时间/编号的结构,以及 DataTables 的数据和分页语义;不发 OTP、不点击预约或取消。 2. 根据实际字段实现生产只读适配器;现有计数工具不能直接转换成完整预约快照。 3. 核对真实 final 响应/成功回执,明确失败与结果不明的处理;运行前另行确认具体日期、 时间和一次真实预约权限。 4. 在订单接线前落实持久的未知结果阻断/人工核验,不能让 `VSBookResult(false)` 触发盲重试。 确信度:已执行的离线合同为高;真实预约列表协议、最终成功响应及生产闭环未验证。 不宣称“完整 Book 已修好”“可直接生产开启”或跨地区全覆盖。 ## 8. 预约列表截图:取消记录保留,列表时间为单个时刻(2026-08-31) ### 8.1 直接观察到的内容 来源:负责人提供的“我的预约”列表截图。标题为 `Elenco Appuntamenti`,当前画面 显示一条数据行和页码 1。截图没有地址栏、DOM 或 Network,因此不把 URL、全部分页、 表格已完整加载等作为本轮新增已验证事实。不复制截图文件、姓名或完整预约编号。 | 表头 | 含义 | 该行的非敏感证据 | |---|---|---| | Codice Prenotazione | 预约编号 | 非空、蓝色链接;具体值不记录 | | Ufficio | 办公室/部门 | Visti | | Servizio | 服务 | Visti Nazionali e Schengen | | Data | 日期 | 13 ottobre 2026,即 2026-10-13 | | Ora | 时间 | 10:25,单个 HH:mm 时刻 | | Stato | 状态 | Annullata,即已取消 | | Dati Richiedente | 申请人信息 | 存在姓名文本,具体值不记录 | 确信度高:当前截图中的记录已取消,但仍展示在列表中。因此“预约列表行数大于 0” 不能推出“有有效预约”,“取消后行数必须变为 0”也不成立。 当前服务列只有显示名称,没有观察到稳定 service_id;申请人姓名不是登录账号身份的 替代凭据。单张截图不能证明其他分页没有有效记录,不能据此标记规范化快照 complete。 ### 8.2 新发现的合同缺口:时间点不能直接当时间段 当前 CS5 离线领域对象 `ReservationRecord.time_label` 要求 `HH:mm - HH:mm`, 并与当前选中 `SlotCandidate.time_label` 精确相等。截图中 `Ora=10:25` 不满足这一格式。 这是实际列表适配之前必须解决的合同缺口,不是将字符串解析一下就能自动接生产。 不能擅自把 10:25 改成某个时间段、仅凭“落在区间内”认定属于目标时段,或删除时间核对。 该取消记录也不是 v6 提交前测试产生的新预约;v6 的 finalRequests=0。 目前不知道它当初选择的时间段,不能拿截图反推服务器的具体分配算法。 下一项只读取证:查看该预约编号链接对应的详情,观察是否同时提供预约日期、具体时间、 时间段、服务及状态,以及是否有可用于关联的结构。记录详情前仍遮住编号、姓名、条码等。 若详情仍仅有单个时刻,则继续采集该显示值的来源与可关联字段,不猜区间映射。 本轮没有点击该链接,没有读取其 href,链接是否打开详情仍待负责人观察。 ### 8.3 实施边界与验证 - 本轮仅更新本文,没有修改业务代码、测试、配置,也没有操作网站或发送 OTP。 - 不把取消状态的真实样本等同于有效/成功/候补等其他状态已验证。 - CS5 的 41 项测试和 469 项 Italy 回归是第 7 节的历史离线结果;本轮未重跑。 合成数据通过不能证明当前时间字段合同适合真实预约列表。 - 本轮验证:`git diff --check` exit 0;本文显式 `awk` 尾随空白检查 exit 0, 输出 `CS5 evidence whitespace: OK`。 初见审查:既然已看到 `Annullata`,能否直接完成预约列表适配? 回应:它关闭了“该状态如何表示取消”的可见文本证据,但没有关闭 DOM 读取、分页完整性、 服务 ID 映射或具体时刻与所选时间段之间的关联。先把这些事实分开,避免取消判断正确、 却在真正预约成功时因时间格式错误而持续报 unknown。 ## 9. 预约详情截图:类型、用途与状态分区(2026-08-31) ### 9.1 直接观察 来源:负责人随后提供预约详情截图。仅摘录以下业务信息,不复制图片、不记录完整预约 编号、姓名、出生日期、邮箱、电话、地址或邮编。没有地址栏或 DOM/Network 证据。 - `Dati Prenotazione` 区域显示意大利驻香港总领事馆; `Servizio Consolare: Visti`、`Servizio Erogato: Visti Nazionali e Schengen`。 - `Tipo Prenotazione: Prenotazione Singola`,支持该样本是单人预约。 - `Data: 13 ottobre 2026`、`Ora: 10:25`、`* Stato: Annullata`。 - 详情中的编号与前一列表截图相同,仅记录一致性,不保存实际编号值。 - `Dati Richiedente` 区域另有一个 `Stato`,表示申请人国家,不是预约状态; 该区域还显示 `Motivo soggiorno: Turismo`,支持该样本的旅游用途。 确信度高:该已取消样本的列表与详情显示同一天、同一具体时刻和取消状态。 截图显示的详情区域仍没有所选时间段、时段 ID 或服务 ID,不能据此声称底层完全没有这些 字段,也不能推断服务器如何从所选时间段分配具体时刻。它不是有效/成功预约状态的样本。 ### 9.2 对实现的约束 1. 状态读取必须限于预约信息区域,不能在全文搜索第一个/任意 `Stato`,更不能把申请人 国家文本送入预约状态分类。详情区边界和实际 DOM 仍待验证。 2. “选择的时间段”与“回执里的具体时刻”是两个不同格式;当前离线对象要求两者字符串 相等的假设尚不适用于这张真实截图。先取字段来源或关联证据,不直接改成区间包含。 3. 旅游用途、单人类型和机构名称是本样本的业务证据,不把显示文本当稳定 service_id。 4. 下一步读取实际 DOM 的节点/字段名称和区域结构,不再索取完整个人信息截图;不执行 点击、刷新、请求、发码或写入表单。 ### 9.3 只读结构探针 在同一详情页 Console 执行。同步返回 JSON 字符串,不返回 Promise;只输出节点元数据、 固定字段标签和区域归属,不输出字段值、正文、查询参数值或完整预约路径标识。 它不是生产解析器;找不到区域、结果截断或 wrong_origin 时不能据此判定解析成功。 ```javascript (() => { if (location.origin !== 'https://prenotami.esteri.it') { return JSON.stringify({probe: 'ITA-RESERVATION-DETAIL-SHAPE-v1', error: 'wrong_origin'}); } const clean = s => String(s || '').replace(/\s+/g, ' ').trim(); const key = s => /^[A-Za-z_][A-Za-z0-9_.:-]{0,79}$/.test(s || '') && !/\d{6,}/.test(s) ? s : (s ? '' : ''); const meta = e => e ? { tag: e.tagName.toLowerCase(), id: key(e.id), classes: [...e.classList].map(key), childTags: [...e.children].map(c => c.tagName.toLowerCase()) } : null; const headings = [...document.querySelectorAll('h1,h2,h3,h4,h5,h6,strong,b')]; const booking = headings.find(e => clean(e.textContent) === 'Dati Prenotazione'); const applicant = headings.find(e => clean(e.textContent) === 'Dati Richiedente'); const labelOf = e => { const m = clean(e.textContent).match(/^\*?\s*(Servizio Consolare|Servizio Erogato|Codice Prenotazione|Tipo Prenotazione|Data|Ora|Stato)\s*:/); return m ? m[1] : ''; }; const scope = e => { if (!booking || !applicant) return 'unknown'; if (applicant.contains(e) || (applicant.compareDocumentPosition(e) & 4)) return 'applicant'; return (booking.compareDocumentPosition(e) & 4) ? 'booking' : 'unknown'; }; const labels = [...document.querySelectorAll('p,li,div,span,strong,b,td,th')] .filter(e => labelOf(e) && ![...e.children].some(c => labelOf(c) === labelOf(e))); const controls = [...document.querySelectorAll('input,select,textarea')]; return JSON.stringify({ probe: 'ITA-RESERVATION-DETAIL-SHAPE-v1', onPrenotami: location.origin === 'https://prenotami.esteri.it', pathShape: location.pathname.split('/').map(s => /^[A-Za-z]+$/.test(s) ? s : (s ? '' : '')).join('/'), bookingSection: {found: Boolean(booking), element: meta(booking), parent: meta(booking?.parentElement)}, applicantSectionFound: Boolean(applicant), fields: labels.slice(0, 20).map(e => ({ label: labelOf(e), scope: scope(e), element: meta(e), parent: meta(e.parentElement) })), fieldsTruncated: labels.length > 20, controls: controls.slice(0, 30).map(e => ({ tag: e.tagName.toLowerCase(), type: e.getAttribute('type') || '', id: key(e.id), name: key(e.getAttribute('name')) })), controlsTruncated: controls.length > 30 }, null, 2); })() ``` ### 9.4 验证与初见审查 - `node -e` 合成 DOM 测试 exit 0:`RESERVATION_DETAIL_SHAPE_PROBE_OK cases=2 external_requests=0`, 覆盖预约/申请人区域两个同名状态字段、动态 ID 脱敏、无区域/无控件;断言输出不含 合成预约号、Token、具体时间或状态值。 - 增加域名前置检查后,`node -e` 异域拒绝测试 exit 0: `RESERVATION_DETAIL_WRONG_ORIGIN_OK external_requests=0`;异域不读取 DOM。 - 本轮只更新本文及提供只读探针,没有改生产代码或运行网站操作。未重跑业务测试, 因为没有业务代码改动;`git diff --check` 和显式 `awk` 尾随空白检查均 exit 0。 初见审查:截图已显示取消状态,为什么还读 DOM? 回应:人眼可根据区域理解两个 `Stato`,自动程序需要真实节点边界;截图也没有稳定服务 标识及时间关联字段。探针用于把这些位置查清,不把业务字段缺失误解释为没有预约。 ## 10. 详情 DOM v1 实测与字段补采(2026-08-31) ### 10.1 负责人返回的只读证据 来源:负责人运行第 9 节探针后返回的 JSON,不是本线程直接控制浏览器取得。 - 页面在 Prenotami;路径形状为 `/ReservationDetail/Index/`。 - `Dati Prenotazione` 标题为 `h4.font-weight-normal`;其父节点为 `div.my-col-6`,直接子节点标签为 `h4`、`div`。 - 找到了申请人区域标题。 - 仅匹配到预约区域内的 `Stato`:节点为 `b`,父节点为 `label.align-form`。 - 存在隐藏控件 `isDetail` 与 `IDTipoStatoPrenotazione`,各自 id/name 同名; 还存在打印按钮 `btnStampa` 与隐藏控件 `DetailToPrint`。 - 本次输出没有读取这些控件的值,也没有得到状态码或完整字段布局。 v1 的候选选择器遗漏了 `label`。已观察到状态字段使用此标签,但尚不能证明其他全部 字段也使用它;“只匹配一个字段”不能当成“页面只提供一个字段”。 ### 10.2 补采范围与仍未关闭的缺口 v2 加入 label,严格限制在已观察的预约区域,若区域不唯一或包含申请人标题即停止。 只输出字段标签、节点结构、值是否存在及与已知取消样本是否相符,不输出编号及申请人值。 唯一允许返回的隐藏值是精确控件 `IDTipoStatoPrenotazione` 的短数字候选;不读取 `DetailToPrint.value`,不打印,不点击、不请求、不赋值页面。 状态码需与同页 `Annullata` 交叉验证,不能凭字段名推定含义; 一个取消样本不能建立成功、有效、候补或其他状态的完整映射。 本探针中的日期/时间/文案仅为比对本次已知样本的诊断值,不是生产硬编码配置。 具体时刻与选中时间段的关联、分页完整性与有效回执样本仍未验证。 ### 10.3 待负责人运行的 v2 探针 ```javascript (() => { const probe = 'ITA-RESERVATION-DETAIL-SHAPE-v2'; const fail = error => JSON.stringify({probe, error}); if (location.origin !== 'https://prenotami.esteri.it' || !location.pathname.startsWith('/ReservationDetail/Index/')) return fail('wrong_page'); const clean = s => String(s || '').replace(/\s+/g, ' ').trim(); const headings = [...document.querySelectorAll('h4')]; const booking = headings.filter(e => clean(e.textContent) === 'Dati Prenotazione'); const applicant = headings.filter(e => clean(e.textContent) === 'Dati Richiedente'); if (booking.length !== 1 || applicant.length !== 1) return fail('section_ambiguous'); const root = booking[0].parentElement; if (!root || !root.classList.contains('my-col-6') || root.contains(applicant[0])) return fail('unsafe_scope'); const parse = e => clean(e.textContent).match( /^\*?\s*(Servizio Consolare|Servizio Erogato|Codice Prenotazione|Tipo Prenotazione|Data|Ora|Stato)\s*:\s*(.*)$/); const candidates = [...root.querySelectorAll('label,p,span,b,strong')].filter(parse); const fields = candidates.filter(e => !candidates.some( other => other !== e && other.contains(e) && parse(other)[1] === parse(e)[1])); if (fields.length > 20) return fail('too_many_fields'); const expected = { 'Servizio Consolare': 'Visti', 'Servizio Erogato': 'Visti Nazionali e Schengen', 'Tipo Prenotazione': 'Prenotazione Singola', 'Data': '13 ottobre 2026', 'Ora': '10:25', 'Stato': 'Annullata' }; const codes = [...document.querySelectorAll('input#IDTipoStatoPrenotazione')]; let statusCode = null; if (codes.length === 1 && codes[0].type === 'hidden' && codes[0].name === 'IDTipoStatoPrenotazione') { const value = String(codes[0].value || '').trim(); if (/^\d{1,4}$/.test(value)) statusCode = value; } return JSON.stringify({ probe, pathShape: '/ReservationDetail/Index/', scopeVerified: true, fields: fields.map(e => { const [, label, value] = parse(e); return { label, tag: e.tagName.toLowerCase(), parentTag: e.parentElement.tagName.toLowerCase(), childTags: [...e.children].map(c => c.tagName.toLowerCase()), valuePresent: Boolean(value), matchesKnownCancelledSample: label in expected ? value === expected[label] : null }; }), bookingStatusCount: fields.filter(e => parse(e)[1] === 'Stato').length, cancelledTextMatched: fields.some(e => parse(e)[1] === 'Stato' && parse(e)[2] === 'Annullata'), statusCodeControlCount: codes.length, statusCode, sensitivePayloadRead: false }, null, 2); })() ``` ### 10.4 离线验证与边界 - 合成 DOM `node -e` 验证 exit 0: `DETAIL_SHAPE_V2_OK cases=7 external_requests=0`。 覆盖 label/b 去重、七类字段、安全区域、错误页面、缺少区域、重复及非数字状态码; 输出不含合成编号、申请人国家或非法状态码文本。 - 仅补充本证据文档;没有修改生产代码、测试模块或配置,没有真实页面操作。 - v2 网站执行结果待负责人提供;离线测试不是网站结构已完整验证。 - 初见审查:隐藏状态码存在是否就能判成功?不能。还需实测值、状态语义和目标预约关联; 此轮仅缩小解析位置的不确定性,不放宽最终成功标准。 ## 11. 详情 DOM v2 实测:标签与字段值分离(2026-08-31) ### 11.1 本轮事实 来源:负责人返回 `ITA-RESERVATION-DETAIL-SHAPE-v2` 的 JSON。 - `scopeVerified=true`,预约区域内匹配到七个不同字段标签: Servizio Consolare、Servizio Erogato、Codice Prenotazione、Tipo Prenotazione、 Data、Ora、Stato。 - 七个字段均为 `label`、父节点为 `div`;前六项无子元素, Stato 的子元素为 `b`。预约状态标签数量为 1。 - 七项 `valuePresent=false`,即探针从标签自身冒号后提取的文本均为空; 这不证明整行或整页实际值为空。字段值的位置仍待补采。 - `statusCodeControlCount=1`、`statusCode="3"`: 依 v2 控件检查,该单一隐藏控件的 id/name 为 IDTipoStatoPrenotazione。 - `cancelledTextMatched=false` 不能解释为“预约未取消”: 本次没有读到状态值,也没有证据证明用户此前截图里的取消状态发生变化。 此前截图显示 Annullata,本轮看到隐藏码 3;暂记录为“取消样本中的状态码候选”, 同页文字与码尚未在同一次读取中交叉确认,不据此上线全站状态映射。 v2 离线测试覆盖值内嵌标签的合成布局,没有覆盖这次发现的标签/值分离布局。 因此离线通过未能证明真实解析完整;本轮不放宽成功条件、不修改生产解析器。 ### 11.2 下一步只读 v3 复用已验证的区域和七字段标签定位,检查每个字段标签父节点中的相邻元素/文本节点。 每行只允许包含一个已识别的字段标签;多字段共用容器时仅返回数量,不混读字段值。 只输出节点类型、值非空与已知样本匹配的布尔值;不输出实际预约号、字段正文、链接、 申请人资料或打印载荷。不操作控件、不调用接口;状态码仍限精确隐藏控件及短数字值。 诊断中的样本日期、时间、文案不是生产配置,也不是未知成功状态的推断依据。 ```javascript (() => { const probe = 'ITA-RESERVATION-DETAIL-VALUES-v3'; const fail = error => JSON.stringify({probe, error}); if (location.origin !== 'https://prenotami.esteri.it' || !location.pathname.startsWith('/ReservationDetail/Index/')) return fail('wrong_page'); const clean = s => String(s || '').replace(/\s+/g, ' ').trim(); const headings = [...document.querySelectorAll('h4')]; const booking = headings.filter(e => clean(e.textContent) === 'Dati Prenotazione'); const applicant = headings.filter(e => clean(e.textContent) === 'Dati Richiedente'); if (booking.length !== 1 || applicant.length !== 1) return fail('section_ambiguous'); const root = booking[0].parentElement; if (!root?.classList.contains('my-col-6') || root.contains(applicant[0])) return fail('unsafe_scope'); const nameOf = e => clean(e.textContent).match( /^\*?\s*(Servizio Consolare|Servizio Erogato|Codice Prenotazione|Tipo Prenotazione|Data|Ora|Stato)\s*:/)?.[1]; const labels = [...root.querySelectorAll('label')].filter(nameOf); if (labels.length !== 7 || new Set(labels.map(nameOf)).size !== 7) return fail('fields_ambiguous'); const expected = { 'Servizio Consolare': 'Visti', 'Servizio Erogato': 'Visti Nazionali e Schengen', 'Tipo Prenotazione': 'Prenotazione Singola', 'Data': '13 ottobre 2026', 'Ora': '10:25', 'Stato': 'Annullata' }; const fields = labels.map(e => { const label = nameOf(e), row = e.parentElement; const rowFieldCount = labels.filter(x => row.contains(x)).length; const nodes = rowFieldCount === 1 ? [...row.childNodes] : []; return { label, rowFieldCount, siblings: nodes.flatMap((n, index) => { if (n === e || ![1, 3].includes(n.nodeType) || (n.nodeType === 1 && !['LABEL', 'SPAN', 'B', 'STRONG', 'DIV', 'P', 'A'].includes(n.tagName))) return []; const text = clean(n.textContent); return [{ index, tag: n.nodeType === 3 ? '#text' : n.tagName.toLowerCase(), childTags: [...(n.children || [])].map(c => c.tagName.toLowerCase()), nonEmpty: Boolean(text), matchesExpected: label in expected ? text === expected[label] : null }]; }) }; }); const codes = [...document.querySelectorAll('input#IDTipoStatoPrenotazione')]; const value = codes.length === 1 && codes[0].type === 'hidden' && codes[0].name === 'IDTipoStatoPrenotazione' ? String(codes[0].value || '').trim() : ''; return JSON.stringify({ probe, fields, statusCode: /^\d{1,4}$/.test(value) ? value : null, cancelledTextMatched: fields.find(f => f.label === 'Stato').siblings.some(n => n.matchesExpected === true) }, null, 2); })() ``` ### 11.3 验证与未完成项 - `node -e` 合成 DOM 测试 exit 0: `DETAIL_VALUES_V3_OK cases=8 external_requests=0`。 覆盖值在相邻 label/b、相邻文本、未知状态不匹配、区域重叠拒绝、异域拒绝、 多字段共用父容器不读取、重复状态控件及非法状态值;输出不含合成编号或未知原文。 - v3 在真实页面的执行仍待负责人返回结果。未运行网站操作或重跑预约流程; 仅更新证据文档,没有改生产代码、测试模块或配置。 - 仍未完成:有效预约的回执样本、所选时间段与最终分配时刻的关联、预约列表完整性。 本次补采不会解除最终提交边界,也不构成生产 Book 成功验收。 ## 12. 详情 DOM v3 实测:取消样本字段定位完成(2026-08-31) ### 12.1 直接证据与结论 来源:负责人返回 `ITA-RESERVATION-DETAIL-VALUES-v3` 的执行结果;本线程没有直接 操作网站。七个字段均 `rowFieldCount=1`,说明各父容器只包含一个已识别的字段标签。 | 字段 | 同行值节点(本样本) | 已核实内容 | | --- | --- | --- | | Servizio Consolare | childNodes[2],文本节点 | 与 Visti 精确匹配 | | Servizio Erogato | childNodes[2],文本节点 | 与 Visti Nazionali e Schengen 精确匹配 | | Codice Prenotazione | childNodes[2],文本节点 | 非空;未返回实际编号,未做编号匹配 | | Tipo Prenotazione | childNodes[2],文本节点 | 与 Prenotazione Singola 精确匹配 | | Data | childNodes[2],文本节点 | 与 13 ottobre 2026 精确匹配 | | Ora | childNodes[2],文本节点 | 与 10:25 精确匹配 | | Stato | childNodes[3],同级 b 元素 | 与 Annullata 精确匹配 | 同一次执行返回 `statusCode="3"`、`cancelledTextMatched=true`。 至此已验证本详情页样本中“3 ↔ Annullata(已取消)”,不再仅凭截图与另一次隐藏码 读数推测。未验证其他状态码,不使用“不是 3 就是有效预约”的规则。 v1/v2 未取得值的原因现已定位:前六项值是 label 之后的普通文本节点,状态值在 label 之后的另一个 b 元素中;不是标签缺失,也不是这些业务值为空。 本样本的详情字段定位问题关闭,不再重复要求负责人运行同类详情探针。 ### 12.2 对后续实现的约束与优先顺序 1. 下一项开发应为既有最终阶段读取接口的只读适配:按预约区域和字段标签定位行, 读取标签之外的文本节点/元素,再做字段解析;不硬编码 childNodes 的数字下标, 因为空白节点数量随 HTML 排版变化。申请人区域另一个 Stato 不能参与状态分类。 2. 保留取消记录作为预约基线历史,但不能用它证明有有效预约;未知状态或文字/代码 矛盾必须明确报告,不能当成功或自动当取消。完整预约列表与分页仍需独立确认。 3. 本轮只证明编号值存在,没有证明编号格式、详情路径标识与编号相等,或服务显示名 等价于稳定 service_id。生产适配不可凭字段名称补造这些关系。 4. 代码核查仍发现 `plugins/ita_booking_final.py` 的 `ReservationRecord.time_label` 和 `_read()` 只接受时间段,而真实详情是具体时刻 10:25;`_reconcile()` 还要求它 与所选时段字符串相等。此不匹配未修复,不能直接接通生产 final,也不能把区间包含 猜测替换为成功依据。下一开发合同须区分“所选时段”与“回执时刻”,明确关联证据。 5. 继续复用第 1 节的最终阶段模块、现有 Book 选择结果和 VSBookResult;不另建调度、 浏览器或邮件平台。本轮没有新增模块或改变接口。 建议下一项离线测试覆盖本次真实布局(普通文本兄弟节点和独立 b 状态),以及空白变化、 申请人同名字段隔离、重复/缺失字段、取消码与文字冲突、未知状态、单时刻与时段分离。 有了取消样本并不等于已取得有效预约样本;真实最终提交仍需另行确认,自动 OTP 仍为 TODO。 ### 12.3 本轮验证范围 - 只更新本证据文档;未修改生产代码、测试或配置,工作区其他修改保留。 - 未执行登录、OTP、Calendar 操作或预约提交;不把负责人提供的只读探针执行算成 自动 Book 成功,未声称已验证有效回执或其他地区。 - 本轮无需重跑业务测试(无业务改动);历史离线测试结果见原节,不能代替本轮实测。 - 准出结论仅为:本取消样本的字段定位与状态文字/码对应关系已验证。完整回执适配与 最终成功核验尚未完成。 ## 13. 下一项配合:预约列表覆盖范围(2026-08-31,待实测) 负责人表示可配合。下一步只打开“我的预约” `/Reservation`,读取已加载表格的元数据, 不点预约/取消,不发 OTP,不调用重新加载、分页切换或清除筛选的 API。 ### 13.1 复用现状及缺口 已核查 `tools/debug_ita_calendar_gate.py:RESERVATION_SNAPSHOT_SCRIPT`: 它针对 `dataTableReservations` 和 `dataTableReservationsWL` 使用 `isDataTable(table)` 后的 `DataTable().rows().count()` 统计条数。 现有计数合同没有记录服务端分页、总记录数或筛选状态,不能直接作为最终阶段“完整快照”。 以下探针沿用这两个表的定位和初始化检查;仅在已初始化时读取实例。 输出白名单表头、计数、分页与筛选是否存在;不输出搜索词、行数据、编号或申请人信息。 未知 API/字段返回固定错误或 null,不猜测为空表,也不自动初始化缺失的 DataTable。 ### 13.2 只读探针 ```javascript (() => { const probe = 'ITA-RESERVATION-LIST-COVERAGE-v1'; if (location.origin !== 'https://prenotami.esteri.it' || location.pathname !== '/Reservation') return JSON.stringify({probe, error: 'wrong_page'}); const $ = window.jQuery; const clean = s => String(s || '').replace(/\s+/g, ' ').trim(); const knownHeaders = new Set([ 'Codice Prenotazione', 'Ufficio', 'Servizio', 'Data', 'Ora', 'Stato', 'Dati Richiedente' ]); const integer = n => Number.isInteger(n) && n >= 0 ? n : null; const tables = ['dataTableReservations', 'dataTableReservationsWL'].map(id => { const matches = document.querySelectorAll('#' + id); if (matches.length !== 1) return {id, count: matches.length}; const table = matches[0]; const headers = [...table.querySelectorAll('thead th')].map(e => { const text = clean(e.textContent); return knownHeaders.has(text) ? text : ''; }); const base = {id, count: 1, headers, domRowCount: table.querySelectorAll('tbody tr').length}; if (!$?.fn?.dataTable?.isDataTable(table)) return {...base, initialized: false}; try { const api = $(table).DataTable(); const info = api.page.info(); return { ...base, initialized: true, loadedRows: integer(api.rows().count()), filteredRows: integer(api.rows({search: 'applied'}).count()), currentPageRows: integer(api.rows({page: 'current'}).count()), page: integer(info.page), pages: integer(info.pages), recordsTotal: integer(info.recordsTotal), recordsDisplay: integer(info.recordsDisplay), serverSide: typeof info.serverSide === 'boolean' ? info.serverSide : null, globalSearchActive: Boolean(api.search()), columnSearchActive: api.columns().search().toArray().some(v => Boolean(v)) }; } catch { return {...base, initialized: true, error: 'metadata_unavailable'}; } }); return JSON.stringify({ probe, readyState: document.readyState, authenticatedMenuPresent: Boolean(document.querySelector('.app-menu')), tables }, null, 2); })() ``` ### 13.3 验证与判读边界 - `node -e` 合成表格/API 测试 exit 0: `RESERVATION_LIST_COVERAGE_PROBE_OK cases=7 external_requests=0`。 覆盖正常计数、错误页面、未初始化、缺表、重复表、API 失败与有筛选; 验证未初始化时不取得/创建实例,输出不含合成搜索词、未知表头或异常原文。 - 等待负责人运行后再判断实际表格模式。服务端分页为 true、缺表、未知元数据等均不能 冒充完整结果;客户端已加载条数与总数相等也只是本次加载覆盖证据,不证明数据最新、 状态语义已全覆盖或身份已正确绑定。 - 本轮仅补充文档和提供只读探针;不改生产模块或现有计数工具,不改变最终提交边界。 ## 14. 列表覆盖 v1 实测:主表当前页覆盖全部已报告记录(2026-08-31) ### 14.1 已取得的证据 负责人返回 `ITA-RESERVATION-LIST-COVERAGE-v1`: - 页面 `readyState=complete`,存在认证菜单。 - 主表 `dataTableReservations` 唯一且已初始化; DOM 行数、已加载行数、筛选后行数、当前页行数、recordsTotal、recordsDisplay 均为 1。 page=0(第一页)、pages=1、serverSide=false,全局和列筛选均未启用。 - 本次主表不存在“还有下一页未读”或“筛选隐藏了其他已报告记录”的缺口。 这是本次已加载数据的覆盖证据,不自动等同服务端最新状态或最终完整快照。 - 主表实际返回八个 th:前七项与截图表头匹配,第八项为探针白名单外的 ``。此标记既可能是空表头,也可能是其他文字;不得直接猜测为操作列。 - 候补表 `dataTableReservationsWL` 唯一,表头数 0、DOM 行数 0,未初始化。 不能仅凭未初始化直接判断候补数量为 0。 本次探针没有返回预约行内容;之前的已取消样本不能替代对当前唯一行的状态复核。 主表能完整读取也不意味着已核实该账号没有其他有效预约或候补。 ### 14.2 复用已有空表判断,补两个缺失标志 再次核对 `tools/debug_ita_calendar_gate.py:RESERVATION_SNAPSHOT_SCRIPT`: 未初始化分支要求无行、无表头、无 dataTable 类、无 dataTables_wrapper 祖先四项同时成立。 前两项已观察到,后两项尚缺。后续生产适配还应沿用已有 bounded wait/稳定采样思路; 单张 DOM 快照不能证明服务端不存在延迟加载的候补信息,不扩张现有判据的证明范围。 下面短探针补查这两个标志,并仅观察额外表头是否为空;不初始化 DataTables、不读行值、 不输出未知表头文字,不请求、不点击。若缺表或重复,结果为 null,不伪装为空表。 ```javascript (() => { const probe = 'ITA-RESERVATION-EMPTY-SHAPE-v1'; if (location.origin !== 'https://prenotami.esteri.it' || location.pathname !== '/Reservation') return JSON.stringify({probe, error: 'wrong_page'}); const matches = document.querySelectorAll('#dataTableReservationsWL'); const t = matches.length === 1 ? matches[0] : null; const main = document.getElementById('dataTableReservations'); return JSON.stringify({ probe, readyState: document.readyState, waitlist: { tableCount: matches.length, rowCount: t ? t.querySelectorAll('tbody tr').length : null, headerCount: t ? t.querySelectorAll('thead th').length : null, hasDataTableClass: t ? t.classList.contains('dataTable') : null, hasWrapper: t ? Boolean(t.closest('.dataTables_wrapper')) : null }, extraHeaders: main ? [...main.querySelectorAll('thead th')].slice(7).map((e, i) => ({ columnIndex: i + 7, textEmpty: !String(e.textContent || '').trim(), childTags: [...e.children].map(c => c.tagName.toLowerCase()) })) : null }, null, 2); })() ``` ### 14.3 本轮验证 - `node -e` 合成 DOM 测试 exit 0: `RESERVATION_EMPTY_SHAPE_OK cases=7 external_requests=0`; 覆盖空表、wrapper、dataTable 类、有行、缺表、非空未知表头和错误页面, 输出不含合成未知表头正文。 - 上述短探针尚待负责人实测;本轮仅记录证据、提供只读脚本,没有修改生产代码、 测试文件或配置,也没有运行预约、OTP 或外部网络操作。 - 当前准出仅主表本次记录的加载覆盖,不把候补表、身份绑定、有效回执、 时间段/具体时刻关联或完整 Book 宣告完成。 ## 15. 空候补表实测与本组结构取证结束(2026-08-31) ### 15.1 新证据 负责人返回 `ITA-RESERVATION-EMPTY-SHAPE-v1`,页面 readyState=complete: - 候补表唯一,rowCount=0、headerCount=0;hasDataTableClass=false、hasWrapper=false。 结合上一轮 initialized=false,本次符合现有 `RESERVATION_SNAPSHOT_SCRIPT` 的四项 structurallyEmpty 判据,可以按该工具的结构规则记作空候补表,而不是把未初始化 一概解释为 0。此结论仅限当前页面样本;运行时仍需重新读取并保留原有稳定等待。 - 主表第八个表头(零基 columnIndex=7)textEmpty=true,且无子元素。 它是空表头,不是未知业务字段文字;未取得该列单元格内容,不推断它一定是操作列。 至此第 12–15 节这组结构问题已闭合:详情值读取位置、取消文本/状态码、主表计数 与分页覆盖、空候补表形状和额外空表头。无需重复请负责人运行这些同类探针。 这并不补足真实成功回执、多页实测或其他状态码,也不能凭不同时间的样本宣布当前账号 一定没有有效预约;后续最终提交前仍必须用同一账号的新鲜完整读取核验。 ### 15.2 下一阶段边界 下一项应是只读回执适配及离线测试,沿用既有最终阶段读取接口、表格定位、有限等待 与稳定采样,不新增通用调度/浏览器平台。详情解析依据字段标签与相邻节点,不依赖 数字节点下标;候补表缺失、出现初始化痕迹但无可验证结果时不能默认为空。 真实回执的 HH:mm 时刻与已选 HH:mm - HH:mm 时段需要分别建模,关联规则尚缺证据, 不能通过删掉时间核验或随意做区间包含来接通 final。未知状态仍不能变成 ACTIVE。 本轮只接受取证结果与记录,不将其视为已完成生产适配或新增一次真实预约的授权。 ### 15.3 本轮实际动作 - 重新读取现有空表判断并核对本次返回的所有条件,只更新本文;没有业务代码、测试、 配置修改,没有网站操作,工作区原有修改保留。 - 当前取证准出范围如 15.1;最终成功判定与生产 final 尚未准出。 ## 16. 只读回执适配开发合同(2026-08-31) Approval:负责人明确“开始开发吧”;本地开发与离线测试,不授权真实最终提交。 - 代码归属:新 `plugins/ita_reservation.py` 为 Italy 站点只读适配器,组合当前 `page.run_js` 和 `same_origin_path`,沿用既有 DataTables 定位与空表判据。 独立于最终提交模块的写操作,不引入浏览器/调度/OTP 框架或新的第三方依赖。 - 解析器输出站点事实(显示服务、编号、日期、具体时刻、已知/未知状态),不推断服务 ID、 账号身份或原始所选时段;因此不把读取事实直接冒充 FinalBookingAttempt 的完整领域快照。 身份/服务映射和真实成功关联接线仍为后续明确边界。 - 列表只有同源、认证菜单、完成加载、无过滤、客户端已加载记录齐全、候补表可验证为空 时才返回本页覆盖结果;多页客户端数据须全部有可解析行节点,否则明确报错。 未证实的非空候补表 schema 不猜测解析,服务端分页不自动翻页。 - 详情按预约标题与独立区域定位,每个标签只能对应一个字段,读取同一行的标签外值。 不读申请人正文、隐藏打印载荷或全页 HTML;不依赖节点数字下标。 - 仅已观察 Annullata 及详情码 3 可识别为取消;未知/冲突状态不能推导 ACTIVE。 - `ReservationRecord` 增加独立 appointment_time,原 time_label 表示有独立证据的时段, 可缺省。允许历史取消记录只有具体时刻;正向成功仍须验证所选时段关联。 不增加自动区间包含推断;仅有时刻的新记录保持结果不明,不能触发重复提交。 - 测试归属:新 `test/test_ita_reservation.py` 验证纯解析、替身浏览器和实际只读 JavaScript; 扩展 `test/test_ita_booking_final.py` 验证取消基线与时间分离,不放宽既有默认关闭测试。 - 准出:本轮新测试与既有 Italy 回归全部通过;无真实网站调用;日志/异常不泄露原文, 生产插件及原 pre-final 工具仍不导入最终提交模块。 基线:`PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_booking_final` exit 0,41 tests,0.594 秒。不是本轮变更后的验证。 ## 17. 只读适配器实现与离线准出(2026-08-31) Phase: VERIFIED(仅第 16 节本地开发范围)。Approval: 本地开发和测试;无真实最终提交。 ### 17.1 实现与复用 - 新 `plugins/ita_reservation.py`:`read_reservation_detail(page)` 读取当前详情, `read_reservation_listing(page)` 在同一页面进行两次稳定读取;不自行导航、创建浏览器、 发请求、改变筛选或初始化 DataTables。重用 `same_origin_path`、既有表格 ID、空表条件、 有限等待/稳定采样模式及 `ReservationState`,没有新增第三方依赖。 - 纯解析函数 `parse_reservation_detail()`、`parse_reservation_listing()` 接收读取投影, 返回冻结数据对象。采用“小型站点适配器 + 纯解析”,而非新框架/继承体系。 事实对象故意不等同 `ReservationSnapshot`:显示服务名称不是 service_id,认证菜单 也不是账号身份绑定;没有自动转换来伪造这些尚未验证的关联。 - 详情按已知标题及区域定位,要求七个唯一字段标签与独立行,读取标签外的文本节点 或叶子 b;不硬编码第几个子节点。未知布局停止,而不是读取整页正文作为兜底。 只读已知隐藏状态控件,不读 DetailToPrint;返回对象 repr 不包含预约号或业务原文。 - 列表读取全部已加载客户端行节点(包括非当前页的已加载行),校验总数、分页边界、 筛选与节点数量;服务端分页、延迟渲染缺节点或非空未验证候补结构明确停止。 第七列申请人和第八列内容均不读取;详情链接只接受同源详情路径,不跟随链接。 - 仅意大利语已观察字段布局/日期格式与 Annullata 取消状态有支持;其他语言/状态不猜测。 逻辑不含香港名称、4937 服务 ID 或固定预约日期,其他地区仍需实际验证。 - `plugins/ita_booking_final.py` 的 `ReservationRecord` 增加 `appointment_time`, 原 `time_label` 可为空但仍只表示有独立证据的所选时段。取消历史可只有实际 HH:mm; 新记录只有 HH:mm 即使落在所选区间内也不能判成功,结果不明只允许只读对账。 两字段都有时做矛盾检查;该负向检查不产生绑定证据。已有可靠时段绑定时才保留 回执具体时刻到原 `VSBookResult.book_time`,继续复用框架结果类型。 - 原 `ItaPlugin`、Query、pre-final 验收工具和调度器未改动,final 开关仍拒绝开启; 新适配器未接为可执行最终提交的真实读取端口,不新增真实 final CLI。 ### 17.2 新测试与失败修正 - 新 `test/test_ita_reservation.py`:32 项测试,覆盖纯字段/日期/时刻解析、取消和未知/冲突 状态、完整与不完整列表、空候补、链接校验、重复记录、稳定读取与页面变化、异常脱敏。 - 实际只读 JS 在由合成 HTML 建成的 DOM 中执行,包含已观察的“标签 + 文本兄弟节点”和 “标签 + 独立 b 状态”布局;测试插入空白/注释、重复字段、私密单元格读取陷阱、 全部 11 行分两页、未初始化、筛选、服务端分页及延迟节点等情况。不是网站调用。 - 扩展 `test/test_ita_booking_final.py` 至 47 项:增加仅有具体时刻的取消基线、有效旧记录 拦截、新记录不因时刻落在区间而确认、独立绑定后的时刻保留、矛盾时间和非法值等验证。 - 首轮新测试因环境没有 BLS 源码引用的 bs4 库而导入失败(exit 1);没有安装或新增依赖。 改用 Python 标准库 HTMLParser 构建测试 DOM 后通过。生产适配器本来不依赖 bs4。 ### 17.3 实际执行结果 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_reservation test.test_ita_booking_final ``` 最终 exit 0,79 项通过,1.529 秒,无跳过。 ```sh 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 test.test_ita_booking_final test.test_ita_reservation ``` exit 0,507 项通过,5.141 秒,无跳过。这是显式列出的 Italy 回归,不是全仓库测试。 替身日志中的 Turnstile/日历等内容不是实际网站操作。 ```sh 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;既有 pre-final 工具仍为 `book-prefinal-native-date-v6`、指纹 `bcc2da96cd22`, `external_requests=0 credentials_read=false browser_created=false`。该指纹不覆盖未接入的新 读取器或最终模块,不能作为新读取器真实验收的证据。 ```sh git diff --check awk '/[ \t]+$/ { print FILENAME ":" FNR; bad=1 } END { if (bad) exit 1; print "Receipt adapter whitespace: OK" }' plugins/ita_reservation.py plugins/ita_booking_final.py test/test_ita_reservation.py test/test_ita_booking_final.py docs/ita_book_cs5.md ``` 两项 exit 0;显式 awk 覆盖未跟踪的新文件。其他工作区修改保留,没有 commit/push。 ### 17.4 后续与初见审查 下一项真实验收应只调用新读取器检查当前列表/取消详情,并只返回脱敏结果,不再反复 手写采集已知结构的 Console 探针;本轮尚未运行该真实验收或增加登录/导航工具。 之后才落实完整读取的账号/服务绑定,以及新增成功回执与本次选择的关联。 实际最终提交、非空候补状态、多语言页面和其他地区未验证;自动 OTP 仍为 ITA-OTP-01。 反驳:“507 项通过,是不是 Book 就可以上线了?” 回应:不能。新模块可读取并校验已知页面事实,但没有把未证实的服务 ID、账号和时间段 关联塞进最终领域快照,也没有拿取消样本冒充成功样本。准出的是解析和离线保护,不是 真实最终预约或无人值守全链路。这样的分层能让后续补证接线,不必重写 Query/Book。 ## 18. 真实只读验收入口开发合同(2026-08-31) 负责人授权“可以,继续吧”。目标是交付一条本地执行命令调用第 17 节读取器, 不是本线程代替负责人进行真实登录/预约,也不是继续手写 Console 结构探针。 - 新 `tools/debug_ita_reservation.py`:复用 `debug_ita_session` 的浏览器路径解析、 临时登录配置、账号密码交互;复用 `ItaPlugin.create_session()` / `cleanup()`。 现有代码没有通用接管普通 Chrome 的入口,故使用独立临时浏览器,不碰用户原窗口。 - 默认/preflight 只做本地检查,不取凭据、不建浏览器;负责人执行 `--run` 才登录。 不要求地区/service_id;忽略继承的 Query/Calendar/debug 配置,不读取保存的团队账号。 用户凭据仅取 `ITA_BOOK_USERNAME/ITA_BOOK_PASSWORD` 或终端交互,不收命令行密码参数。 - 登录停在 UserArea 后启动既有 `CalendarRequestAudit`,随后只导航到固定 Reservation、 列表中一条已取消记录的已校验详情链接,再回列表。最多读取一条取消详情,不制造样本。 只按已读取的链接导航,不手工拼接编号;不调用 Query/Book、GenerateOTP、AVANTI 或 final。 - 比较列表与详情的编号、部门/服务、日期、具体时刻和取消状态,结果只打印布尔值与计数。 比较前后完整已加载列表未变化;审计期间预约 OTP/AVANTI/Calendar/final 请求均须为 0。 登录本身和普通页面 GET 有网络请求,不能宣称整个 --run 无请求。 - 缺取消样本、状态矛盾、列表变化、上下文变化、审计断开或清理失败都不能 reported passed。 失败不截图、不输出页面 URL/正文/原异常或申请人资料;错误类别固定白名单。 - 新 `test/test_debug_ita_reservation.py` 离线替身测试验收流程;复用真实读取函数, 不以替身输出替代实际网站验收。最终会交付负责人运行命令及需回传的脱敏结果行。 ## 19. 真实只读验收入口实现与本地验收(2026-08-31) Phase: VERIFIED(实现、离线回归、本地预检);真实页面验收待执行。 本轮只新增工具/测试并更新本文件,没有修改生产 Query/Book 或开启 final。 ### 19.1 已实现与复用 - `tools/debug_ita_reservation.py` 为组合式 CLI,复用既有登录配置、`ItaPlugin` 的 临时会话及清理、`CalendarRequestAudit`、第 17 节真实读取函数;不建新浏览器/调度框架。 - 默认及 `--preflight` 不读申请人凭据、不构造插件实例、不访问网站;只有 `--run` 才使用申请人环境变量或用户名/隐藏密码交互。忽略 Query 账号文件、地区路由、debug 和持久 profile 配置,代理仍可复用原有配置。不需填写香港或任何 service_id。 - 同一个新临时会话登录后,仅进行三次无重试导航:列表、已校验实际链接的一条取消详情、 列表。校验账号配置/session generation/tab/page 实例未被换掉。 - 编号、部门、服务、日期、具体时刻、取消文案与状态码比对;详情须为单人预约。 列表前后按编号映射比对全部已加载记录,不把排序变化当成预约变化。 - 仅输出固定阶段/原因、数量/布尔值、指纹;不输出编号、详情 URL、申请人信息、原始异常, 不截图。`auditVerified` 区分审计有效与断线后的旧计数;审计、清理失败均不可通过。 审计只覆盖登录后的已知预约业务路径,不声称整个登录零网络请求或所有 POST 均为零。 普通 GET 和站点遥测不是最终提交。生产 final、自动 OTP 和成功回执绑定均没有接入。 ### 19.2 本地验证证据 新增 `test/test_debug_ita_reservation.py` 27 项离线测试。使用真实解析函数与实际 `CalendarRequestAudit` 分类器,只替换浏览器和缩短审计等待;覆盖成功链路、空/缺取消 样本、逐字段矛盾、多条记录及排序、会话/账号/tab 更换、越域链接、跳回登录、每类 不应发生的业务请求、末次审计迟到请求、断线、清理失败、中断、脱敏和默认不执行。 首次测试暴露替身重复登录未恢复 Dashboard,已修正替身的登录行为后重跑通过。 最终执行: ```sh 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 test.test_ita_booking_final test.test_ita_reservation test.test_debug_ita_reservation ``` exit 0,534 项,5.053 秒,无跳过;是列明范围的 Italy 回归,不是全仓库测试。 输出中的 Calendar/Turnstile 等日志来自替身,不是本轮真实请求。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_reservation.py --preflight ``` exit 0;`receipt-readonly-gate-v1`,`source_sha256=1563bf14cae7`; `external_requests=0 credentials_read=false browser_created=false`。 指纹覆盖本工具、读取器及相关 Italy/登录/审计源文件,不哈希或暴露账号配置。 ### 19.3 交给负责人执行 ```sh cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_reservation.py --run echo "EXIT_CODE=$?" ``` 在本地终端输入已有取消预约的申请人账号和密码;不需要预约 OTP。 回传 `ITA_RECEIPT_GATE_RESULT=...` 和 `EXIT_CODE`,不需发送凭据、截图或完整页面内容。 验收通过须 `passed=true`、`cancelledDetailMatched=true`、`listUnchanged=true`、 `auditVerified=true`、`cleanupOk=true`、全部五项审计计数为 0、exit 0。 若无取消样本或页面不符,只报当前固定阶段和原因,不自动制造预约或猜测新结构。 即使通过,也仅验证取消回执读取;不能据此宣称成功预约已跑通。 下一步再将完整读取结果与申请人/服务绑定,并验证新增有效回执与本次选择的关系。 ## 20. 首次真实读取失败:日期格式待定位(2026-08-31) ### 20.1 负责人回传及本地核对 负责人运行第 19 节命令,版本 `receipt-readonly-gate-v1`、指纹 `1563bf14cae7`。 实际结果:登录成功;`stage=list_before`、`reason=date_unrecognized`、exit 1; `listReady=false`、`cancelledDetailMatched=false`、`listUnchanged=false`。 审计有效,五项业务计数均为 0,临时浏览器清理成功。没有据此宣称列表为空、取消 记录丢失或预约有变化;这些步骤都尚未读完。 本地确认失败版本指纹一致,`_day("13 ottobre 2026")` 正常返回 `2026-10-13`。 因此旧截图已知的意大利语日期可解析;程序实际获得的单元格内容尚未知。 隐藏排序文本、不同显示格式或其他内容差异均为假设,不能选一个当成根因。 ### 20.2 最小续修范围 Phase: VERIFIED(仅脱敏诊断和离线测试);实际日期故障未解决。 Approval: 延续当前只读验收入口的开发/排查;不操作真实登录、不提交预约。 - `plugins/ita_reservation.py` 增加只读日期诊断:核对同源 Reservation、认证菜单、 七个已知表头及可选第八空表头,且 DataTables 已初始化;只读已校验 Data 列。 最多三行、每行六个子节点。比较 textContent 与 innerText,以及子元素的隐藏状态。 - 原始日期字符串仅在本地内存处理,输出数字替换为 D、字母替换为 L 的形状、长度、 截断标志、已知意大利月份序号、是否能被现有解析器接受;不输出原始日期、任意 属性/HTML、申请人列、编号或账号。输出 schema 不合格仅返回 available=false。 - `tools/debug_ita_reservation.py` 在 list_before/list_after 的 date_unrecognized 时读取一次诊断,仍由原会话/账号/tab 校验、业务请求审计和 cleanup 包围。 原错误和 exit 1 保留,不能因诊断成功而把验收改成 passed。成功路径和详情错误 不触发该列表诊断,也没有添加新导航、OTP、表单动作或读取器宽松兜底。 - 升级合同至 `receipt-readonly-date-diagnostic-v2`。没有改 Query/Book、日期规则或 最终提交权限。不是“日期 bug 已修复”的版本。 ### 20.3 测试与下一步 新增 7 项测试,覆盖真实诊断 JS 的隐藏排序文本**假设样例**、原解析仍拒绝、错误表头、 未初始化、未知字符串脱敏、输出边界、失败不中断清理、正常路径不额外读取。 隐藏排序文本合成用例不是当前网站实际采用该结构的证据。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_reservation test.test_debug_ita_reservation ``` exit 0,66 项,1.024 秒。随后执行第 19.2 节同一完整 Italy 回归命令: exit 0,541 项,4.864 秒,无跳过;未真实访问网站。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_reservation.py --preflight ``` exit 0,指纹 `960ff39dcf3b`;external_requests=0、credentials_read=false、browser_created=false。 负责人重跑原 `--run` 命令并回传 `ITA_RECEIPT_GATE_RESULT` 的 dateDiagnostic 即可。 预计旧问题仍会导致 exit 1;先根据真实诊断决定修正方式,不让用户反复搜索整页 DOM, 也不猜测日期格式或从混合文本随意截取一个日期。 ## 21. 根因确认与日期节点读取修正(2026-08-31) ### 21.1 同版本真实证据 负责人回传 `receipt-readonly-date-diagnostic-v2` / `960ff39dcf3b`: 登录成功、失败仍在 list_before / date_unrecognized;审计有效、五项业务请求均为 0、 cleanup 成功、exit 1。dateDiagnostic 可用且无行/节点截断,样本明确显示: | 部分 | 证据 | |---|---| | 第一个子节点 | kind=other、hidden=true,形状 DDDDDDDD DD:DD,长度 14,日期解析不接受 | | 第二个子节点 | kind=text、hidden=false,形状 DD LLLLLLL DDDD,长度 15,月份序号 10,解析接受 | | innerText | 与显示日期的形状/长度相同,解析接受 | | textContent | 两段文本被拼接,长度 29,解析不接受 | 根因:原读取器对整个 Data 单元格调用 textContent,把隐藏元素的内容也拼入日期。 不是意大利语月份不支持,也不是登录失败。隐藏值具体用于排序或其他功能尚未验证, 修复不依赖猜测其用途、真实标签或值。不记录凭据/原始日期/隐藏值。 ### 21.2 代码归属与实施 Phase: VERIFIED(本地修正与回归);真实回执验收仍待用户执行。 Approval: 延续当前只读回执修复;无真实登录/预约动作、无提交/推送权限扩张。 - 修改归属现有 `plugins/ita_reservation.py` 的 LIST_READ_SCRIPT。VFS/BLS 中未找到 可直接复用的 Prenot@Mi 日期格读取器;保留既有读取适配器、DataTables 获取方式、 数据合同、测试工具及被动审计,不新增框架或通用日期推断层。 - 只读取 Data 格中唯一非空直接文本节点;跳过注释和空白;元素只有被明确证明隐藏 才排除。隐藏判断复用诊断使用的 computed display/visibility,并支持节点自身的 inline/hidden 标记;visibility:hidden 只允许叶节点,防止子节点覆盖成可见。 - 不读、不解析、不记录隐藏元数据的值。可见包装元素、多段有歧义文本、只有隐藏值、 超出 16 子节点界限等仍拒绝,不从混合内容中用正则截取看似日期的子串。 - 不直接切换成整个格的 innerText:未渲染或未附着在当前页面的 DataTables 行不能 依赖布局取值。继续读取所有已加载行,保留行数、分页、筛选、表头等完整性检查。 未显示页有明确 inline/hidden 标记的节点仍可校验;无法确认隐藏的结构不会猜测放行。 - Python 日期解析规则、详情读取、Query/Book、最终提交开关均不变。 工具版本提升到 `receipt-readonly-date-node-v3`,保留原脱敏诊断以支持后续异常定位。 ### 21.3 验证 更新已有隐藏内容测试,新增 6 项回归:与实际诊断相同的隐藏 other + 直接文本形状; 隐藏值完全不读取;不访问日期格完整 textContent/innerText;有歧义可见节点拒绝; 非法日期和可见混合元数据仍拒绝;11 条记录跨两页的隐藏文本均正确排除。 标签与值使用合成数据,不把 synthetic label 或示例数字误记为网站实际值。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_reservation test.test_debug_ita_reservation ``` exit 0,72 项,1.469 秒。随后执行第 19.2 节同一 Italy 回归命令: exit 0,547 项,5.334 秒,无跳过。这是列明范围的离线测试,不是全仓库或真实网站验收。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_reservation.py --preflight ``` exit 0,版本 `receipt-readonly-date-node-v3`、指纹 `5793dc6a2eb6`; external_requests=0、credentials_read=false、browser_created=false。 下一步:负责人在自己的终端执行同一 `--run` 命令,回传 ITA_RECEIPT_GATE_RESULT 与 EXIT_CODE。即使日期读取通过,也继续要求详情匹配、列表不变、业务请求全零、清理成功; 不能因这次故障修复就认定最终 Book 已验收。 ## 22. v3 真实只读验收通过(2026-08-31) Phase: VERIFIED(用户执行的列表/一条取消详情只读验收)。 Scope: 核对并记录版本及验收结果;Non-goals: 不新增功能、不提交预约、不开启 final。 Approval: 延续当前验收记录范围;无需负责人重复运行同一只读验收。 Evidence/Risks: 下述为用户终端回传,不伪称由本线程发起或直接观察网站; 已覆盖该取消样本,不能代替有效新预约、其他语言/地区或真实多页样本验收。 ### 22.1 版本与结果 负责人在同一条消息中贴出两次运行:前段 v2 / `960ff39dcf3b` 仍因 date_unrecognized 失败,是旧版本记录;后段 v3 / `5793dc6a2eb6` 为修正后的成功结果,两者分开判读。 不能把前段失败继续当成 v3 阻塞。 | v3 验收项 | 回传结果 | |---|---| | 合同 | receipt-readonly-date-node-v3 | | 源码指纹 | 5793dc6a2eb6 | | 登录 | ITA_RECEIPT_LOGIN_OK | | 阶段 / 整体结果 | completed / passed=true / exitCode=0 / EXIT_CODE=0 | | 列表读取 | listReady=true | | 取消详情比对 | cancelledDetailMatched=true | | 列表前后 | listUnchanged=true;记录数 1 → 1 | | 日期诊断 | dateDiagnostic=null,未触发失败诊断 | | 审计 / 清理 | auditVerified=true / cleanupOk=true | | 业务请求 | availabilityRequests、avantiPosts、finalRequests、otpRequests、timeSlotRequests 均为 0 | | 最终提交开关 | finalSubmissionEnabled=false | | 错误原因 | 空 | 意义:新读取器已在该真实页面读取预约列表和既有取消详情,并核对前后列表不变。 记录数为 1 是取消历史仍保留,不代表存在 1 个有效预约。正常登录和页面 GET 有网络 请求;“零请求”仅指表中的五项被审计预约业务路径,不是全程无网络。 ### 22.2 本地核对与后续边界 本轮本地执行: ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B tools/debug_ita_reservation.py --preflight ``` exit 0,合同及指纹与用户 v3 成功日志一致;external_requests=0、credentials_read=false、 browser_created=false。本轮只更新本文件,没有改代码、运行真实登录或重复执行离线 回归;第 21 节的 547 项测试属于此前同版本代码验证,不改写其执行时间。 下一关键工作是把读取事实接入最终阶段的提交前检查和提交后对账:明确申请人/目标服务 绑定、新有效状态、所选时段与站点分配时刻的关联,以及结果不明时禁止盲目重复提交。 只读取消样本通过不会自动开启这些功能,也不能用已有取消记录充当新增成功回执。 实际最终提交仍未执行,自动 OTP 仍是 ITA-OTP-01;不要求负责人重复本轮已通过的测试。 ## 23. 同会话回执读端接线合同(2026-08-31) 负责人授权“可以的,开始吧”。Phase: APPROVED;本轮本地开发与离线验收, 不进行真实提交、不启用生产 final、不修改共享 Booker 或云端任务状态。 - 新 `plugins/ita_final_read_port.py` 组合 `ita_reservation` 的已验证读取器与 `ita_booking_final` 的现有 FinalTarget / ReservationSnapshot / FinalBookingAttempt 合同,复用 plugin 的申请人、route、Calendar preparation 和 precommit 上下文校验。 捕获之后换账号/实例/tab/浏览器/session generation/route/selection 都不能继续。 - 为避免基线读取导航离开 Calendar 丢失选择,使用当前浏览器新建的背景标签 (new_context=false),检查浏览器对象及标签身份,读取列表、取消详情、返回列表, 前后快照一致后关闭自己创建的标签。不读/复制 Cookie/Token、不新建浏览器上下文。 单次最多校验 20 条详情,超出明确阻断;不冒充无限规模完整读取。 - 回执仅有显示服务名称,不能推导 service_id;取消历史允许 service_id=None, 同时携带完整业务事实的 SHA-256 指纹以保留变化检测。None 仅适用于已取消历史, 不能用于 ACTIVE/WAITLIST 或归属判断,不构造假的服务 ID/时段。 - 当前读端只接受已验证 Annullata/3 详情;未知/新增有效状态保持阻断。未来补有效 状态及服务/时段关联证据后再扩充适配,不用名称相同或时间落在区间内猜测成功。 - 复用 FinalBookingAttempt 的一次执行、读后对账、FinalOutcomeUnknown 和 VSBookResult;新读端不调用 NativeFinalSubmitter、不提供自动提交入口。 用真实读端 + 替身浏览器证明基线可以进入现有核心,提交后出现未知记录只能对账、 不能返回成功或由同一 attempt 重提。 - VFS 的 IsAppointmentBooked 与 BLS 的 model.Id/Liveness 是各自协议证据,复用 它们的统一结果类型而不移植成功条件。OrderBooker 对 success=false 下轮信号重试, 普通异常也不暂停;已有 pause 状态可阻止任务,但当前未形成提交前持久写屏障。 本轮不扩大为云端协议/调度器改造,生产 final 继续关闭。 准出:同会话隔离读端、取消历史保留、上下文变化/列表变化/未知状态/清理失败阻断, 提交后未知只读重查不重提;Italy 回归通过。真实背景标签读取及成功回执仍分别待验收。 ## 24. 同会话读端接线完成与可选验收入口(2026-08-31) Phase: VERIFIED(本地实现和离线合同);背景标签实测、最终成功实测待完成。 沿用第 23 节授权;没有真实登录、OTP、预约提交、云端任务更新或 git commit/push。 ### 24.1 实现边界 - `plugins/ita_final_read_port.py`:新增 FinalReceiptReadPort,构造时捕获当前 Book precommit,复用 `_calendar_book_context_matches` 及实际列表/详情读取函数。 绑定申请人配置、session generation、route、Calendar page/tab、browser 和原 approval。 这是既有登录会话连续性校验,不宣称新增了服务端身份声明或从姓名推断账号。 - 同浏览器背景标签只做 Reservation → 已校验实际详情链接 → Reservation 的 GET, 不调用 Book/Query,不操作 Cookie、OTP、最终按钮或主标签导航。读取上下文变化、 20 条详情上限超出、未知状态、列表变化、关闭标签失败均不返回有效快照。 仅清理自己创建并核对归属的标签,异常和中断仍释放锁并尝试清理。 - 当前读端只接受空列表或全部为已验证取消历史的列表。取消记录保留 assigned HH:mm, service_id 和 time_label 均留空,不复制本次目标值给历史记录。完整业务事实指纹 保留原领域模型中未表示的显示服务、部门、预约类型变化;指纹不是身份/服务绑定证据。 - `plugins/ita_booking_final.py` 仅扩大取消历史的表达:无服务 ID 时必须为 CANCELLED 并携带合格指纹,ACTIVE/WAITLIST/UNKNOWN 不能使用该例外。原一次提交、未知只读 reconcile、统一 VSBookResult 均复用;新增未知记录仍报 FinalOutcomeUnknown。 同一 attempt 不能重提不等于跨进程写屏障,不能据此开放生产重试。 - `tools/debug_ita_book_gate.py` 新增 `--verify-receipts` 可选参数,默认不改变原 pre-final 路径。选中日期/时段后调用上述读端,背景标签独立使用现有 CalendarRequestAudit, 审计完成和关闭后,再用原 verify_precommit_selection 复核主 Calendar 的选择。 历史数量还须与运行前计数一致。不会调用 FinalBookingAttempt.execute 或原生 final。 - 新合同 `book-prefinal-receipt-baseline-v7`,指纹纳入新读端、回执读取器及 final 模块。 复用现有 --run 的临时申请人登录、手动 OTP、单次 AVANTI、全程预算与清理,不新建工具。 因为共享 final 模块文件变化,原 receipt v3 指纹也会变化;旧实测不冒充新依赖集实测。 ### 24.2 离线验证 新增 `test/test_ita_final_read_port.py` 22 项,包含真实解析器/真实会话匹配方法与浏览器 替身的接线测试;新增 final 取消历史校验 2 项、Book 工具 opt-in 接线测试 4 项,共新增 28 项。场景包括:同会话标签归属、不碰 Calendar、所有主要上下文变化、空/取消/未知 历史、详情字段变化保留、数量上限、标签/观察器清理失败、中断、未知仅对账不重提。 工具测试使用真实 Book 与新读端,验证只读标签审计为零且原选择保留。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_final_read_port test.test_debug_ita_book_gate test.test_ita_booking_final ``` exit 0,141 项,0.739 秒。完整 Italy 回归: ```sh 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 test.test_ita_booking_final test.test_ita_reservation test.test_debug_ita_reservation test.test_ita_final_read_port ``` exit 0,575 项,6.070 秒,无跳过。测试的提交回调全部是离线替身,不是实际预约。 ```sh 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 --verify-receipts ``` exit 0,`book-prefinal-receipt-baseline-v7` / `0e8ec52fa61e`;external_requests=0、 credentials_read=false、browser_created=false。这里香港只是参数样例,无地区硬编码。 ### 24.3 真实验收与未完成事项 负责人可将上述命令中 --preflight 改为 --run,在自己的终端执行。会进入已验证的 申请人登录与手动 OTP/AVANTI/选时段流程,然后增加只读核验;不会最终提交。 成功须同时出现 ITA_BOOK_GATE_RECEIPT_BASELINE 的 verified=true、calendarSelectionPreserved=true、 背景标签五项业务计数全零,以及最终 ITA_BOOK_GATE_RESULT.passed=true / EXIT_CODE=0。 整轮准备允许 1 次 OTP 和 1 次 AVANTI;不可把这两个准备动作和背景只读审计混淆。 若没有候选日期,沿用现有 exit 2,不算新读端通过;如果有未知/有效记录,当前读端会 阻断而不是将其误判已取消或无预约。不要为测试清空/取消用户正常预约。 下一阶段仍需:真实新有效回执状态及目标服务关联证据、所选时间段与站点分配具体时刻 的关联;生产上线前还需复用现有任务 pause 机制落实可持久的未知结果阻断。 本轮没有把暂停状态本身当作已实现的写屏障,没有增加新 Redis/数据库平台,也没有 开启生产 final。新同会话读端解决的是读取接线和安全基线,不是宣称完整 Book 已成功。 ## 25. v7 提交前选择与回执基线组合实测通过(2026-08-31) Phase: VERIFIED(负责人回传的 pre-final + 同会话只读基线实测)。 本节只记录验收,不改代码、不执行真实登录/OTP/预约,也不开放最终提交。 ### 25.1 来源与版本边界 来源为负责人在自己的终端执行后回传的日志,不是代理直接观察浏览器所得。 `ITA_BOOK_GATE_RESULT.contract=book-prefinal-receipt-baseline-v7`,`EXIT_CODE=0`。 本次片段未包含 `ITA_BOOK_GATE_TOOL_CONTRACT` 的 source_sha256;其中 QCAL preparation 指纹不能当作 Book 指纹,第 24 节本地预检指纹也不能反向证明用户此次运行的完整依赖集。 不为补日志头要求重跑真实 OTP/选时段流程。原日志中的验证码、账号等敏感内容不落盘。 ### 25.2 观测结果 - 登录后的准备链路:OTP 发送 1 次,写入回读匹配;AVANTI 1 次,进入 Calendar。 - 生产 Book 扫描:2026-08 候选 0;2026-09 候选 1,在首个正向月份停止。 - 选中日期 `2026-09-03`,时间段 `09:15 - 10:00`,当时余量 3,`selectionVerified=true`。 这些是当次观测,不保证现在仍有号;选中不表示已锁位或预约成功。 - `receiptBaseline.verified=true`,`recordCount=1`,`calendarSelectionPreserved=true`。 只读基线审计的 availability、AVANTI、final、OTP、time-slot 五项业务请求均为 0。 零业务请求不表示未发生读取列表/详情所需的 GET。 - 整轮 availability 请求 3、AVANTI 1、OTP 1、final 0;其中生产 Book 增量为 availability 2、AVANTI 0、OTP 0、final 0。不能把准备动作与背景只读审计混在一起。 - 前后预约列表记录数均为 1,waitlist 均为 0;这是保留的历史记录,不等于 1 个有效预约。 - `finalSubmissionEnabled=false`,`bookResultSuccess=false`,`outcome=pre_final`, `passed=true`、`exitCode=0`,清理成功。`bookResultSuccess=false` 是未最终提交的 预期业务结果,不是本次组合验收失败。 ### 25.3 结论与下一阶段 已验证第 24.3 节的组合准出条件:当前 Book 会话能选时段,读取取消历史,并保留原选择; 该链路无需重复验收。香港依然是本次样例,不能把单地区实测等同于所有地区实测。 尚未证明最终 Book 成功。下一阶段聚焦受控最终提交与真实成功回执闭环:补齐有效状态、 目标服务及所选时间段与分配时刻的关联证据;最终结果不明时只能只读核对,不能盲目重提。 生产 final 开放前还须落实可持久的未知结果阻断,自动 OTP 继续保留为 ITA-OTP-01。 本次结果回传本身不扩大为真实最终提交或生产启用授权。 ## 26. 受控最终提交证据入口 v8(2026-08-31) Phase: VERIFIED(本地实现、离线合同与无网络预检);真实最终结果仍待负责人执行。 Approval: 负责人“没问题,我可以配合你,继续吧”承接第 25 节之后的受控单次提交建议。 本轮代理仅本地开发/测试,没有真实登录、OTP、提交、取消、云端变更或 git commit/push。 ### 26.1 设计、复用与边界 目标:使负责人能够在自己终端用现有申请人 Book 链路完成一次真实提交,收集新回执的 状态/日期/分配时间,为下一轮正式成功判定提供证据。不是提前宣布生产 Book 可用。 - 保留 `tools/debug_ita_book_gate.py`,新增 opt-in `--submit-once`,必须同时指定 `--verify-receipts`;不另建登录、OTP、Calendar 扫描、选时段或 HTTP 重放实现。 默认/--preflight 无凭证读取、无浏览器创建、无网络动作;默认 --run 仍为 pre-final。 - `tools/ita_final_evidence.py` 仅负责本地验收编排:复用 `FinalBookingAttempt`、 `NativeFinalSubmitter`、`FinalReceiptReadPort` 和原 `verify_precommit_selection`。 先显示 route/service/date/time,再要求完整输入 `BOOK YYYY-MM-DD HH:mm - HH:mm`。 任何其他输入取消。确认之后重新核验当前会话、取消历史和选择,不能拿旧选择直接提交。 - 本地防重沿用 `tools/ita_local_handoff.py` 的私有目录和一次消费文件模式:复用 `_ensure_private_directory`,在已忽略的 `data/ita_local_handoff/` 内用 O_EXCL / 0600 创建 `final-evidence-once.claim`,flush/fsync 文件及目录完成后才进入原生提交。 文件只有版本和 possibly_submitted / automaticRetry=false,不保存账号、日期、编号或 OTP。 空/部分文件、符号链接或并发占用均阻止再次提交;异常、拒绝、清理、重启后不自动删除。 本地检查提前到凭证/OTP 之前;并发争用在真正提交之前再次原子判定。 当前是本 checkout 的保守全局一次闩锁,跨账号也阻断;不是分布式/生产订单写屏障。 - 原生 final 仍由站点按钮处理器构造请求,本地工具不自造预约 POST、令牌或服务端状态。 原领域核心的“只执行一次、未知只读对账”照用,未改 `ItaPlugin.final_submit_enabled`。 - `FinalReceiptReadPort.observe_receipts()` 共用现有背景标签归属、上下文、分页覆盖、 数量上限、列表/详情字段一致性、前后列表一致性及清理规则,只返回观测事实。 原 `__call__()` 仍只接受空/已取消基线;新 UNKNOWN 状态不能绕过该限制。 不把显示服务名变成 service_id,也不把具体时间落在区间内当作预约归属证明。 - 采集日志只输出新记录的服务/部门/预约类型文本、状态文本和代码、日期、分配时间, 以及数量和布尔比对。最多输出 3 条新记录,超出标记截断,不输出 reference、详情 URL、 申请人资料、凭证或响应正文。这里的状态文本是站点数据,不是执行指令或已验证状态映射。 - 主标签全程审计:最终请求至多 1 次,准备仍至多 1 OTP / 1 AVANTI;只读背景标签 五项业务请求必须为 0。新增 `requestAuditVerified` 区分审计通过与仅采集到结果。 结果不明、捕获中断、重复请求或其他异常均不解除本地防重,不指示自动重试。 - 提交后输出 `ITA_BOOK_GATE_FINAL_EVIDENCE` 并停在终端,保留临时浏览器供人工只读查看。 用户按 Enter(或中断)后清理。不要为验收取消正常预约,也不要在保留页面再次提交。 ### 26.2 可证伪假设与验证 | 假设 | 离线验证 | 真实验证状态 | | --- | --- | --- | | 默认为零 final,缺少显式标记/时段确认不能提交 | 默认、缺少 receipts、拒绝确认、无网络预检测试 | 旧 v7 已验证,v8 待回传 | | 复用的单次提交核心可接入原 Book 选时段结果 | 真实 Book + 真实 final core + 原生提交替身的组合测试 | 待 v8 实测 | | 进程重启/并发/写入失败不能触发第二次本地提交 | O_EXCL、并发唯一赢家、已有/部分 claim、fsync 失败、符号链接测试 | 本地合同已验;不是分布式保证 | | 新回执可用旧结构读取而状态保持未知 | 原真实解析器 + 合成新状态,严格读端仍拒绝 UNKNOWN | 实际新回执结构及状态待采集 | | 超时/异常/中断后不会误报成功、不会重提 | UNKNOWN、异常、中断、重复网络计数、保留标记测试 | 实际网络错误仍依现场;不强制制造失败 | 新增 23 个测试:`test/test_ita_final_evidence.py` 18 个,既有 Book gate 测试新增 5 个。 包括保留主 Calendar、背景标签清理、只读观察不放宽严格成功合同、日志不输出 reference、 默认不调用提交端、拒绝/未知/中断/重复请求的组合接线。原 NativeFinalSubmitter 的 JS/请求匹配测试继续复用;此处请求均为离线替身,没有实际预约。 ```sh 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 test.test_ita_booking_final test.test_ita_reservation test.test_debug_ita_reservation test.test_ita_final_read_port test.test_ita_final_evidence ``` 结果:exit 0,598 项,5.853 秒,无跳过;范围是列出的 Italy 测试,不是整个仓库。 同路由参数运行下节命令将 --run 替换为 --preflight:exit 0, `book-final-evidence-once-v8` / `b929de85613e`;external_requests=0、credentials_read=false、 browser_created=false。源码指纹含 final evidence 和本地 handoff 依赖,不含本地 claim。 ### 26.3 用户终端命令与准出 ```sh 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 --run --verify-receipts --submit-once echo "EXIT_CODE=$?" ``` 输入申请人凭证及一次 OTP;选好时段后只在该日期/时间适合真实预约时输入工具显示的 完整确认短语。不是把本文件示例日期当作授权目标,实际目标以当次终端展示为准。 出现 `ITA_BOOK_GATE_FINAL_EVIDENCE` 后回传该行及最终请求计数,不回传 OTP/个人资料。 页面保留时可以查看新回执;如需截图,遮住姓名、编号、联系方式等,只保留业务状态。 exit 4 = 已可能提交、需要人工核对、禁止重跑;不是普通可重试失败。 `bookingConfirmed=false` / `passed=false` 保持诚实:当前还不能自动认定有效回执。 exit 2 = 无候选或未确认(该工具未最终提交);exit 1 = 提交前阻断/检查失败; exit 3 = 清理失败。任何情况下只要最终请求可能发出,claim 均保留,不手动盲删。 本轮真实准出是获取一次 final 网络证据和完整新回执事实、历史不受损、审计符合预算, 不是要求未知解析器强行 success=true。如果响应/读取失败,保持只读人工核对,不再写。 后续根据实测补齐状态与归属合同,另行实现生产持久阻断;自动 OTP 仍为 ITA-OTP-01。 ## 27. v8 真实单次提交与新增确认回执(2026-08-31) Phase: VERIFIED(用户回传的单次提交及只读回执证据;不代表程序成功判定或生产准出)。 本节只记录结果并核对现有判定代码,不修改代码,不执行真实网站动作,不清除本地防重。 ### 27.1 版本与来源 负责人在自己的终端运行第 26 节入口,并输入实际展示的日期/时段确认短语后回传日志。 合同 `book-final-evidence-once-v8`;最终 `EXIT_CODE=4`,临时浏览器清理成功。 片段未包含 Book TOOL_CONTRACT 的 source_sha256,不能用先前本地指纹补成实测指纹。 未保存账号、验证码、预约编号、详情链接或个人资料;本节是回传证据,不是代理直接观测。 ### 27.2 实测事实 - route `slot.hkg.it.tourist`,service_id `4937`。Book 选中 `2026-09-03`, `09:15 - 10:00`,当时余量 3,选择复核通过;负责人确认该实际目标。 - 提交前取消历史基线 1 条、verified=true,原 Calendar 选择保留;背景标签五项业务请求 0。 - 最终请求 1 次;整轮 availability 3、AVANTI 1、OTP 1,`requestAuditVerified=true`。 `bookRequestDelta.finalRequests=0` 只描述前面的选时段步骤,不是整轮最终请求数。 - `attempted=true`、`automaticRetry=false`。未触发重复最终提交。 - 回执读取成功:`readVerified=true`、`historicalRecordsUnchanged=true`, `recordCount=2`、`newRecordCount=1`、`newRecordsTruncated=false`。 - 唯一新增记录:部门 `Visti`、服务 `Visti Nazionali e Schengen`, 类型 `Prenotazione Singola`;日期 `2026-09-03`,站点分配时刻 `09:26`; 状态文本 `Confermata`,状态代码 `2`。这是新增“已确认”回执的正向样本。 - 日期与选择一致,09:26 在所选 09:15–10:00 内。区间内的具体时刻与区间本身不同, 不能要求 receipt 的 `09:26` 文本等于 Calendar 的 `09:15 - 10:00`。 时间包含关系本身仍不是可推广的服务/时段唯一归属证明,不反推隐藏 runtime ID。 - 运行前后列表总数 1→2,waitlist 0→0。结合完整回执比较,原历史保留并新增确认记录; 不单凭数量增一判成功,也不把全部 2 条都当有效预约。 ### 27.3 为什么网站已确认而程序仍为 unknown 本地只读检查 `plugins/ita_reservation.py::_state`,当前只编码了 Annullata / 3 → CANCELLED, 其他状态返回 UNKNOWN。因此新观察到的 Confermata / 2 尚未被当前版本认定 ACTIVE。 严格最终读端也尚未接受新有效状态的归属,`bookingConfirmed=false` / `passed=false` / `outcome=unknown_do_not_retry` / exit 4 是当前合同输出,不是网站拒绝预约的证据。 `submissionSignal=unknown` 是另一个独立缺口:当前日志没有请求/响应结构诊断,无法判断 究竟是监听/读取时序、请求字段、响应类型/字段还是其他校验未通过。不得仅凭此日志声称 是某个字段为 null 或 HTTP 状态异常;也不为了重抓包再创建一条预约。 结论:本次香港样例的真实动作链路已产生站点确认回执;程序到统一成功结果的闭环尚未完成。 保留本地 claim,不重跑 --submit-once,不取消已有预约来重测;其他地区未因此自动实测通过。 ### 27.4 下一步最小工作 1. 将本次状态文本/代码、列表与详情一致性、新旧记录差异及分配时刻形状作为脱敏回归样本。 2. 完善有效状态与本次尝试归属判定,用现有预约做只读回查;不把目标 service_id/时段硬塞 给新记录,不把任意非取消状态都当成功,不要求再次最终提交。 3. 给提交响应的未知原因提供不含正文/令牌的结构化诊断;没有证据的原因仍保持待确认。 4. 保持生产 final 关闭,生产持久未知结果阻断和 ITA-OTP-01 仍待完成。 本轮仅更新验收文档;第 26 节 598 项离线结果为先前代码证据,本轮没有重跑或冒称新测试。 ## 28. 确认状态映射与已有回执只读验收 v4(2026-08-31) Phase: VERIFIED(本地实现与离线测试);已有有效回执的新版本只读验收待负责人执行。 Approval: 负责人“可以,继续吧,快速推进,我可以配合你”。本轮没有访问真实网站、 发送 OTP、再次提交、取消预约或操作本地 claim,也未改生产 final / 共享调度器。 ### 28.1 改动与复用 - `plugins/ita_reservation.py::_state` 增加已观察到的 Confermata / 2 → ACTIVE。 列表没有数字状态码,文本仅用来找候选;详情必须同时匹配确认文本和代码 2。 Annullata / 3 保留,文本代码矛盾、未知文本、仅代码 2 或未观察英文等仍 UNKNOWN。 - `tools/debug_ita_reservation.py` 复用原临时申请人登录、列表/详情读取、全量覆盖检查、 前后列表一致性、被动审计和清理;新增 `--expect-confirmed`,要求明确日期、站点分配 HH:mm 和显示服务名称。匹配 0 条或多条都不选第一条冒充唯一目标。 - 只跟随已解析的实际详情链接,核对编号(仅内存)、部门、服务、日期、分配时间、状态, 必须是 Prenotazione Singola。列表回查与审计/清理全部通过后才输出 `existingReservationConfirmed=true`。不输出预约编号、申请人字段或凭证。 - 不引入新文件/框架或站点调用;只读工具不调用 query/book/final,不读写本地防重复 claim。 显示服务名匹配不是 service_id 绑定;`bookingAttemptAttributed=false` 始终明确区分 “现有确认预约核验”与“历史提交的唯一归属”。最终读端的空/取消基线限制未放宽。 - 不为未知提交响应猜造成功 JSON、HTTP 状态或网络字段,不要求再提交一次重抓包。 自动 OTP、生产持久未知结果阻断、最终归属与统一成功结果仍是独立待完成项。 ### 28.2 测试与准出 新增 13 个测试:解析器 4 项(确认样本、矛盾状态、取消/确认并存、非香港/不同日期), 只读工具 9 项(唯一匹配、无网络预检、错误参数、歧义、详情不一致、历史变化、意外业务 请求、CLI 接线等)。合成编号/链接,业务状态及分配时刻形状来自第 27 节证据。 ```sh PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_ita_reservation test.test_debug_ita_reservation test.test_ita_final_read_port test.test_ita_final_evidence ``` exit 0,125 项,1.754 秒。按第 26.2 节列出的 23 个 Italy 测试模块再次完整回归: exit 0,611 项,6.049 秒,无跳过;这是 Italy 范围,不是整个仓库测试。 下节命令把 --run 替换为 --preflight 的本地结果:exit 0, `receipt-readonly-confirmed-v4` / `a4840ececb10`;external_requests=0、credentials_read=false、 browser_created=false。原 Book v8 将因共享解析器变化产生新指纹,不重跑真实提交。 ### 28.3 负责人只读验证命令 ```sh cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_reservation.py --run \ --expect-confirmed \ --expected-date 2026-09-03 \ --expected-time 09:26 \ --expected-service 'Visti Nazionali e Schengen' echo "EXIT_CODE=$?" ``` 只输入申请人登录凭证,不需要预约 OTP;读取 Reservation → 匹配详情 → Reservation。 准出:`passed=true`、`confirmedDetailMatched=true`、`existingReservationConfirmed=true`、 `listUnchanged=true`、`auditVerified=true`、五项业务请求全部 0、清理成功、EXIT_CODE=0。 默认模式的 cancelledDetailMatched 在本确认模式为 false 是正常,不是失败。 回传 ITA_RECEIPT_GATE_RESULT 即可。不能因只读测试失败就取消或重新创建已有预约。 ## 29. v4 已有确认回执只读实测通过(2026-08-31) Phase: VERIFIED(用户回传的现有确认预约只读验收)。本轮只更新证据文档,不修改代码, 不运行真实登录/预约、不删除本地 claim,也不将历史离线测试冒充本轮重新运行。 ### 29.1 来源与验收结果 负责人在自己终端执行第 28.3 节命令,回传合同 `receipt-readonly-confirmed-v4`, 源码指纹 `a4840ececb10`,与第 28 节本地已测指纹一致。只记录脱敏结果,不保存凭证。 - `passed=true`、`exitCode=0`、`stage=completed`、shell `EXIT_CODE=0`。 - `confirmedDetailMatched=true`、`existingReservationConfirmed=true`,回执日期 `2026-09-03`、分配时刻 `09:26`;状态 `active`,站点文本/代码 `Confermata / 2`。 - `serviceDisplayMatches=true`、`singleBooking=true`。这是显示服务匹配及单人类型核验, 不是读取到了 service_id 或 Calendar 的隐藏时段 ID。 - `listReady=true`、`listUnchanged=true`,列表记录数前后均为 2。 - `auditVerified=true`;availability、AVANTI、final、OTP、time-slot 五项业务请求均为 0。 - `cleanupOk=true`、`finalSubmissionEnabled=false`,无日期诊断错误。 - `cancelledDetailMatched=false` 为本次确认模式的预期;并非取消历史核验失败。 - `bookingAttemptAttributed=false` 保持边界:已确认该登录账号存在目标显示服务/日期/时刻的 有效预约,但本只读工具没有绑定过去提交的 attempt 或向生产返回 Book 成功。 ### 29.2 当前结论与下一阶段 第 28 节全部真实只读准出条件已满足,不需重复运行该验收或重新创建预约。 结合第 27 节,香港样例已取得“单次真实提交产生新确认回执”及“新版本程序只读识别该 有效回执”的分阶段证据;不能把两次不同会话的验证说成一个生产 Book 调用已经返回成功。 接下来优先完善最终结果接线:把当前尝试与匹配回执的关联证据接入现有最终核验核心, 向统一 VSBookResult 回传正确结果,避免真实预约成功后调度器仍按普通失败处理。 现有确认回执用于只读/离线验证;不重跑 --submit-once,不清除防重复标记,不取消预约。 原提交响应 unknown 的具体原因、生产持久未知结果阻断、自动 OTP 仍为未完成项。 ## 30. 本次提交归属与统一成功结果接线(2026-08-31) 负责人“没问题,继续推进”授权下的本地实现与验证。本轮没有登录真实网站、发送 OTP、 最终提交或取消预约,没有读取/删除真实 claim,没有开启生产 final 或修改共享调度器。 用户已有的 2026-09-03 09:26 确认预约不需要重建,也不要求重复执行只读验收。 ### 30.1 复用与代码归属 继续使用现有最终核心和读取端的组合/端口适配方式,不新增第二套预约流程或结果模型: | 现有文件 | 本次职责 | | --- | --- | | `plugins/ita_booking_final.py` | 原生单次提交;分别判定请求是否匹配、响应为何未知;最终核心输出原有 `VSBookResult` | | `plugins/ita_final_read_port.py` | 同一申请人会话读取完整基线/新回执;验证显示服务、状态、单人类型、日期和分配时刻 | | `tools/ita_final_evidence.py` | 复用核心、原生提交器和本地持久 claim;接通请求证据与回执、保留成功结果 | | `tools/debug_ita_book_gate.py` | 原请求审计证实最终请求恰好一次;汇总结果、后续审计、清理均通过才输出成功验收 | VFS/BLS 的统一 `VSBookResult`(account / urn / book_date / book_time)继续复用, 不复制它们不同站点的成功字段。生产 `ItaPlugin.book()` 的 pre-final 边界保持不变。 本轮唯一新增文件为离线测试 `test/test_ita_final_attribution.py`。 ### 30.2 成功判定合同 1. 仍要求申请人、浏览器/标签、会话代次、route、准备上下文和 PrecommitApproval 连续一致。 提交前完整基线只允许空列表或已核实的取消历史;有效/未知记录不能直接跳过后重约。 2. 从当前已到达的 Calendar URL 唯一 `selectedService` 参数捕获显示服务名称,不由 Hong Kong、4937、route 文案或配置猜造;缺失/重复名称不能建立新回执归属。 3. 监听器观察到的原生 `POST /BookingCalendar/InsertNewBooking` 必须属于当前标签, 三个字段分别匹配已选隐藏 ID、日期、完整时段/库存文本。保留已验证请求的独立 `VerifiedSubmission`;未知响应不抹掉已经取得的请求证据。 4. 验收入口须另证最终请求计数 0→1,其他业务请求无新增,再向读取端交付该证据。 单个 packet 不是“全程只有一次请求”的证明。未观察到匹配请求则不能建立归属。 5. 同一申请人会话中,新旧列表完整且详情一致、历史业务字段指纹不变,只能新增一条回执。 新回执必须为 `Confermata / 2`、`Prenotazione Singola`、同一显示服务与日期, 网站分配 HH:mm 位于原选时段内。明确拒绝响应与新增确认回执矛盾时仍返回 unknown。 6. 回执不包含 service_id 或所选时间区间,因此对应字段保持 None;关联来自单独的 已验证提交证据,不能把目标值硬塞进回执假装网站返回了这些字段。 7. 核心确认后返回 `VSBookResult(success=True)`,预约编号仅保留在内存返回值, book_time 使用网站实际分配时刻,例如 09:26,不替换成 09:15–10:00。 额外只读观察的 bookingConfirmed 仅在核心已确认且新读结果一致时才为 true。 8. 最终入口完成后续请求审计、记录数检查和清理才 `passed=true / exit 0`; 后续重复请求、对账失败或清理失败不能报告验收通过。核心先前取得的确认事实保留, 失败不意味着可再次提交;本地 claim 无论成功/失败/未知都保留。 这套归属依赖同一申请人工作流串行、验证期间没有另一客户端同时为其提交的运行前提。 它是本次工作流证据关联,不是服务器回传的请求唯一 ID,也不是跨节点 exactly-once。 正式接入生产前仍需用既有账号/订单协调和任务状态机制落实这一前提。 ### 30.3 诊断及收尾修正 - 新 `submissionDiagnostic` 只返回 requestMatched 与固定原因:请求元数据、字段或 选中目标不匹配;响应元数据、正文、字段、目标地址不识别;原生动作/监听异常。 不输出原始请求、响应、令牌、账号、预约编号或服务器错误正文。 - `submissionSignal=unknown` 不是一律失败:请求证据完整、唯一匹配回执确认且无矛盾时 可以成功;没有匹配请求或对账证据则仍 unknown,不自动重试。 - 修复整链路测试发现的收尾错误:已授权提交后若尚停留 Calendar,不能再调用要求 历史 final 请求为 0 的 pre-final guard。原生提交器仍重新禁用按钮,提交后走最多一次 final 的审计;Query / pre-final 的零提交约束没有放宽。 - 旧 v8 没有记录上述细分诊断,不能根据新代码猜测当时 unknown 的真实原因,也不能 将已有回执只读结果倒填为该历史 attempt 的完整请求归属证据。 ### 30.4 离线验证与准出 新增 15 项测试:14 项归属/核心/读端/原生诊断测试,1 项真实入口组合测试含四个子场景。 使用已观察业务形状及合成账号/编号/链接,不含真实凭证或网络操作。覆盖: - 唯一新确认回执返回成功与正确分配时刻;未知响应但请求匹配时仍可核验。 - 请求证据缺失、审计未通过、会话/目标变化、服务/日期/时刻/单人类型/状态不符。 - 已有有效基线阻止提交、历史变化、多个新增、明确拒绝与回执矛盾。 - 核心→本地控制器→验收入口成功接线,及后续重复请求、清理失败、对账失败不误报通过。 - claim 保留,未伪造回执字段,输出不泄露预约编号或账号。 完整 Italy 回归:第 26.2 节原 23 个模块加 `test.test_ita_final_attribution`, `PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q ...`, **626 项,5.751 秒,OK / exit 0**;仅表示 Italy 测试范围,不是全仓库测试。 香港样例配置下运行 `tools/debug_ita_book_gate.py --preflight --verify-receipts`, **book-final-attribution-v9 / 1949de666430,exit 0**; external_requests=0、credentials_read=false、browser_created=false。 没有传入 --run 或 --submit-once。`git diff --check` 通过;未跟踪改动文件另做空白检查。 本阶段已满足本地实现/离线整链路准出,不声称新版真实最终提交已验收,也不需要为开发 重复创建预约。下一优先级:在最大化复用现有 Booker/订单状态的前提下,接生产任务成功 回传与持久未知结果暂停/恢复;落实跨进程防重后再开放生产 final。ITA-OTP-01 保持待办。 ## 31. 生产上线缺口与任务后端竞争复现(2026-08-31) > 后续范围决定:本节保留为历史调查证据。§31.4 的共享后端改造不是当前实现前置条件;负责人要求按 VFS/BLS 现有链路先接通,见 §32。已知共享层风险并未因此被修复,也不宣称跨节点/崩溃场景严格一次性提交。 负责人要求继续推进到 Query/Book 可上线,OTP 自动化放到最后。本轮核对 Coordinate 实际代码,并只读检查已定位的 `/Users/zhangwei/JSWorkSpace/personal/webapp` 后端。 没有修改后端或生产业务代码、调用真实任务 API、连接数据库/Redis、重新预约或删除 claim。 发现原有任务接口不足以承载提交前原子认领,实施跨仓库共享接口修改前需要范围确认。 ### 31.1 可复用事实与已确认缺口 | 部位 | 已有能力 | 上线缺口 | | --- | --- | --- | | Query 核心 | 逐月首个正向月份、最早日期、现有快照 | Sentinel 创建会话后没有完成 Calendar 准备/恢复接线;不能把调试工具准备态当生产能力 | | 会话恢复 | 同账号 checkpoint 恢复、15 分钟受控恢复证据 | 生产实例生命周期接入;需要 OTP 时保留人工接续,不要求本轮自动取码 | | Book 核心 | 独立申请人重查、选择、单次原生提交、回执归属 | 生产 `ItaPlugin.book()` 仍停在 pre-final,未连任务上下文与持久认领 | | OrderBooker | 原 `pause/grabbed` 状态、成功上报 | 普通异常含最终结果不明仍可被下一信号再次调用;任务缓存刷新间隔 15 分钟 | | 成功上报 | 原 `grabbed_history` 与通知格式 | 云端更新放在线程队列,而 tracker 先移除;进程退出可丢失尚未上报的成功结果 | | Sweeper / 后端 | 按状态排除暂停/成功;任务 pop 已用 MySQL 行锁 | 前端检查与后端重新入队不在一个原子操作内;回收接口无条件覆盖状态 | | 发布 | 现有容器与依赖清单 | Italy 已拆多模块,不能只热更单个 ita_plugin.py;应验证整包一致性与真实运行依赖 | 本地 `.venv` 直接 import Booker 缺少 redis;requirements.txt 已声明该依赖。既有 Italy 离线测试使用导入替身,因此 626 项通过不能被解释为真实 Sentinel/Booker 运行环境已验收。 本轮未安装依赖或运行生产服务。此前 626 项结果为第 30 节证据,本轮没有声称重新运行。 ### 31.2 后端原代码证据 - `webapp/app/services/vas_task_service.py::pop_vas_task`:只选 pending, `with_for_update(skip_locked=True)`,提交 running 并递增 attempt_count;复用现成事务/锁模式。 - `update`:读取一行后直接写 status / grabbed_history / meta;无期望状态或工作代次条件。 - `pause`:直接设置 pause,不能证明两个请求中只有一个取得提交资格。 - `return_to_queue`:读取当前行后直接设 pending;即使当前已 pause/grabbed 仍覆盖。 - schema 与模型已有 `pending/running/pause/grabbed/cancelled/completed`;不要另造未支持的 `processing/outcome_unknown` 状态字符串。`meta` 可承载扩展事实,但普通 JSON 更新不是原子锁。 - Coordinate Sweeper 先 detail、再 return_to_queue,这两个 HTTP 调用之间存在竞争窗口。 仅在 Sweeper 增加一次客户端状态检查仍不能关闭窗口,必须由后端原子条件保证。 ### 31.3 离线复现结果 执行方式:用 AST 提取后端实际 update/pause/return_to_queue 方法,仅移除 staticmethod 装饰器、延迟求值注解,使用内存会话替身执行原方法体;不 import 后端应用或数据库配置。 客户端使用实际 OrderBooker `_execute_book_job` 与 BaseBooker `_push_success_notification`, 云端 API、线程队列与 Redis 均为替身。它验证调用和状态转换缺口,不冒称真实数据库并发压测。 复现最终 exit 0,后端服务源文件 SHA-256 前缀 `eae2f1408502`,externalRequests=0: ```json { "pause": {"beforeStaleRequeue": "pause", "afterStaleRequeue": "pending"}, "grabbed": {"beforeStaleRequeue": "grabbed", "afterStaleRequeue": "pending"}, "repeatedPauseRejected": false, "clientUnknown": {"bookCallsOnTwoSignals": 2, "cloudPauseCalls": 0}, "clientSuccess": {"queuedAsyncWork": 1, "cloudWritesBeforeTrackerRemoval": 0, "trackerRemoved": true} } ``` 注意 exit 0 表示复现断言成立,即确认当前缺口存在,不是修复测试通过。前两次复现脚本 因本地缺 redis / 临时替身作用域导致导入失败,未执行任何外部调用;最终调整离线导入 替身后得到以上结果,不将导入失败当作业务竞争证据。 ### 31.4 最小修正方向及待确认范围 优先复用既有 MySQL 事务、任务行、attempt_count、pause/grabbed 和 meta,不另建调度器, 不以本地 claim 或 Redis TTL 冒充持久提交账本。需要在以下范围关闭合同: 1. Webapp 的 VAS 任务 service/schema/endpoint:提交前原子认领和持久记录;核对工作代次, 阻止失效 Worker;重新入队和一般状态更新不得覆盖已认领/结果未知/已成功任务。 2. 同申请人多订单也需互斥,不能把“同 task_id 只能一个”误称为“同账号只能一个”; 复用现有账号/订单关系是否足够需进一步确认,若确需新增表/迁移另列范围,不先实施。 3. Coordinate 的云任务客户端、Booker、Sweeper:传递受信任务上下文,结果未知暂停并 仅对账;确认成功先可靠保存,再结束任务,通知失败不触发再预约。 4. 接完生产层后,复用现有 Calendar 准备/查询/Book/回执核心;自动 OTP 暂缓但保留人工 接续。不得把需要人工 OTP 错写成无人值守完成。 5. 回归至少覆盖:两个 Worker 同时认领、旧 Worker 恢复、认领前后崩溃、暂停与回收竞争、 成功上报丢响应、重复信号、同账号不同订单、既有 VFS/BLS 行为兼容,以及整包发布预检。 这不是必须重写 VFS/BLS 的结论,而是它们所在共享任务层尚缺本项目已经明确要求的 持久一次性提交合同。下一步先确认允许进入 webapp 共享任务接口及 Coordinate 调度层, 然后实现、离线并发/故障测试,必要时再请负责人执行受控真实验收;不擅自部署或改线上数据。 ## 32. 按 VFS/BLS 现有链路的最小生产接线(2026-08-31) ### 32.1 范围与复用 负责人明确授权:不扩展共享后端,按 VFS/BLS 的现有方式推进。现有链路仍为 `Sentinel → VSQueryResult/Redis → OrderBooker → plugin.book → VSBookResult → grabbed_history`。 不新增服务、表、队列、分布式锁、调度器或生产本地 claim;不修改 VFS/BLS 的站点代码。 | 位置 | 职责 / 复用来源 | | --- | --- | | `plugins/ita_plugin.py` | 保留统一 query/book 接口及原默认行为;显式人工 OTP 工作模式进入完整流程 | | `plugins/ita_calendar_session.py` | 从已实测的 Calendar gate 提取表单检查、OTP 写入/读回、AVANTI 跳转验证和被动请求计数;调试工具改为引用同一份实现 | | `plugins/ita_workflow.py` | 轻量流程编排:准备 → 调用现有查询/选位模块 → 调用现有最终提交/回执模块;不 import tools | | `plugins/ita_calendar_query.py` / `ita_calendar_book.py` | 原逐月扫描、首个正向月份停止、最早日期、用户会话选位逻辑不重写 | | `ita_booking_final.py` / `ita_final_read_port.py` | 原生提交一次、请求归属、列表/详情回读、Confermata/2、网站分配时刻;复用而非重建 | | `booker.py` / `vs_types.py` | 成功仍走原上报;增加通用未知结果异常分支,禁止下一信号重提,复用现有 pause API | Query 使用团队账号,Book 使用订单申请人账号,禁止复用 Query 准备态。地区差异仍由 `apt_configs[routing_key]` 的 service_id、表单控件和值/多语言标签配置;香港不是算法常量。 ### 32.2 可启用配置(本轮没有改动运行配置) 沿用已有完整 single_schengen_tourism 路由配置,仅增加/设置下列 free_config 字段: | 用途 | query_mode | otp_mode | final_submit_enabled | | --- | --- | --- | --- | | 团队 Query | calendar | manual | false | | 申请人 Book,仅选位验收 | services_probe | manual | false | | 申请人 Book,真实提交 | services_probe | manual | true | 不设置 otp_mode 时仍保持旧调试/准备边界,避免旧命令突然创建预约。Query 配置不得启用 final。Book 的 services_probe 只用于进入该申请人的表单,不将入口存在当成有号结果。 Book 单次公共调用现在可以从 Dashboard 一直走到选位/最终回执,不需要外部脚本分两次 book。 OTP 暂时由操作者在同一终端输入;无 TTY 在发送 OTP 之前停止。多工作线程共享的锁仅用于 避免终端输入串码,不锁账号/库存。准备中失败不会在每次查询时反复发送 OTP;重新登录后 允许再次人工准备。已有准备会话继续扫描,不重新发送 OTP。自动取码/重取码仍是 ITA-OTP-01。 这是可人工值守的接入版本,不是无人值守部署完成。 ### 32.3 最小结果处理 - 成功:新增唯一匹配确认回执 + 原生请求归属,返回原 VSBookResult;book_time 使用网站 分配时刻,而不是所选时段。仍由现有 Booker 上报,不增加 Italy 专用上报器。 - 明确无号/明确拒绝:返回原失败结果,按原调度策略等待下一信号。 - 可能已提交但证据不足:抛通用 BookingOutcomeUnknownError(Italy 为 FinalOutcomeUnknown), 当前任务 book_allowed=false,调用现有任务 pause。只人工核查后恢复,不自动重提。 - 暂停接口失败:保留当前进程禁用标记并提示人工暂停;不声称进程退出后仍能靠内存标记 阻断重入。§31 的后端重入队竞争、异步上报掉电窗口仍为共享层现状,不在本轮扩围。 - CLI 的旧最终验收 claim 与既有真实确认预约没有修改、删除或重跑。 ### 32.4 离线验证与准出边界 原 626 项 Italy 测试及新增 `test.test_ita_workflow` 24 项通过。新增覆盖: 原接口从 Dashboard 准备并选位、Query 准备一次/不发布弱正向、默认不最终提交、显式 申请人开关、Query/Book 身份隔离、OTP 冷却/写入验证、无终端发送前停止、错 tab、部分 准备失败不重复发码、真实回执解析器与最终核心组合、缺单次请求证据保持未知、重复 信号不重提、成功走原上报、暂停接口失败保留本地阻断、旧 Query CLI 的显式工作模式。 测试均使用合成数据/浏览器与网络替身;没有登录、请求 OTP、预约、Redis 或云任务写入。 `git diff --check`、Query CLI `--help` 通过。本地 `.venv` 缺 redis,Booker 测试沿用已有 导入替身;真实部署环境仍须安装 requirements 依赖,不能把此结果等同于服务启动验收。 研发接线准出:上述离线回归通过,旧默认行为保持、生产不依赖 tools、未改其他插件。 上线准出尚待:新公共 Query 入口真实验证、申请人 Book 的新入口验证、部署依赖及整包 发布检查。Italy 多模块必须随同发布,不能只更新 ita_plugin.py;当前没有执行部署。 ### 32.5 下一次真实验证命令(只 Query,不预约) 沿用香港示例,路由全部显式传入。该命令调用生产 Query 入口;人工输入一次 OTP 后查 最早日期并退出,不调用 book、不点击最终确认。使用已授权且确实归属香港机构的 Query 账号;凭证留在本地,不粘贴密码/OTP。 ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate ITA_ROUTING_KEY=slot.hkg.it.tourist \ ITA_SERVICE_ID=4937 \ ITA_CITY='Hong Kong' \ ITA_VISA_TYPE='Tourist' \ ITA_CALENDAR_LOOKAHEAD_MONTHS=12 \ ITA_BOOKING_TYPE_CONTROL_ID=typeofbookingddl \ ITA_BOOKING_TYPE_VALUE=1 \ ITA_BOOKING_TYPE_LABELS='Prenotazione Singola|Single booking' \ ITA_PURPOSE_CONTROL_ID=ddls_0 \ ITA_PURPOSE_VALUE=42 \ ITA_PURPOSE_LABELS='Turismo|Tourism' \ PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_query.py --production-workflow echo "EXIT_CODE=$?" ``` 正向期望:ITA_QUERY_WORKFLOW_RESULT 中 earliestDate 有值、finalSubmissionEnabled=false, 清理成功、exit 0。自然无号可以 exit 0,但不能据此证明正向查询。真实 Book 使用已有 订单模式和申请人账号;现有确认预约未处理前不要为了验证再创建一笔。 ## 33. 新 Query 公共入口真实验证通过(用户终端回传) 用户执行 §32.5 命令后回传: ```text Italy Calendar probe index=0 available=0 Italy Calendar probe index=1 available=1 Italy Calendar found the first positive month; earliest_date=2026-09-03. ITA_QUERY_WORKFLOW_RESULT={"availabilityStatus":"Available","earliestDate":"2026-09-03","finalSubmissionEnabled":false,"success":true} ITA_QUERY_CLEANUP_OK EXIT_CODE=0 ``` 结论:新公共 Query 入口单次正向实测通过;扫描至首个正向月份后返回最早日期,清理成功。 `2026-09-03` 是本次观察结果,不是未来仍可预约的保证。回传为末段日志,不含本次 OTP/ AVANTI 数量或源码指纹,因此不补写未知计数,不声称独立 Network 审计或无人值守验收完成。 工具输出 finalSubmissionEnabled=false;本轮未调用 Book、创建或取消预约,也未部署。 下一步:验证新 Book 公共入口从申请人登录到选位的完整调用,保持最终提交关闭。 ## 34. 新 Book 公共入口选位验收命令 在原 `tools/debug_ita_book.py` 增加 `--production-workflow`,复用原路由配置构建器、 生产 `book()`、既有 precommit 读回验证和被动请求计数器;不新增生产预约流程。 默认旧模式不变,新模式固定 `otp_mode=manual / final_submit_enabled=false`,不提供 最终提交开关。单次公共 book 调用自行完成表单准备与选位;不会调用旧 gate 分两次 book。 凭证只取 `ITA_BOOK_USERNAME/ITA_BOOK_PASSWORD` 或人工输入,不回落到通用 Query 环境 凭证/Query 账号文件;申请人使用独立临时浏览器会话。该选位测试不要求取消已有确认预约。 新增 9 项 CLI 测试,含身份传递/环境隔离、旧默认保留、无号不算选位通过、读回失败、 意外最终请求、末尾审计失败、清理失败与参数冲突。659 项 Italy 离线回归通过(5.534 秒, exit 0);Book CLI `--help` 和 `git diff --check` 通过。本轮只有文档/本地 CLI/测试变更, 未改变 Query/Book 生产算法,未操作真实浏览器、账号、OTP、预约或部署。 下一次由用户在自己的终端执行(香港仅为配置样例): ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate ITA_ROUTING_KEY=slot.hkg.it.tourist \ ITA_SERVICE_ID=4937 \ ITA_CITY='Hong Kong' \ ITA_VISA_TYPE='Tourist' \ ITA_CALENDAR_LOOKAHEAD_MONTHS=12 \ ITA_BOOKING_TYPE_CONTROL_ID=typeofbookingddl \ ITA_BOOKING_TYPE_VALUE=1 \ ITA_BOOKING_TYPE_LABELS='Prenotazione Singola|Single booking' \ ITA_PURPOSE_CONTROL_ID=ddls_0 \ ITA_PURPOSE_VALUE=42 \ ITA_PURPOSE_LABELS='Turismo|Tourism' \ PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_book.py --production-workflow echo "EXIT_CODE=$?" ``` 验收看 `ITA_BOOK_WORKFLOW_RESULT.selectionVerified=true`、选中日期/时段存在、 `finalSubmissionEnabled=false`;末尾 `ITA_BOOK_WORKFLOW_AUDIT.finalRequests=0`,清理成功、 EXIT_CODE=0。`bookResultSuccess=false` 是预期,因为测试停在最终提交之前。无号 exit 2 表示本次缺选位正向证据,不表示发生预约。不要分享密码/OTP。新入口真实 Book 最终成功 上报及部署环境验证仍未完成,不能把选位验收或既有 v8 预约回执当作这一环已经通过。 ## 35. 新 Book 入口被已有预约挡住:Services 现场证据与诊断补充 2026-08-31,用户回传 §34 新公共入口失败:目标 `/Services/Booking/4937` 不存在, Services 表 1 个、行 9 个、其他 booking 链接 8 个、目标链接 0 个;五类业务请求均 0, 清理成功、exit 1。不是 OTP、月份扫描或选位失败,尚未进入这些阶段。 随后用户截图确认机构为香港总领馆,目标服务行 `Visti Nazionali e Schengen` 的预约 单元格显示 `Prenotazione già effettuata per questo servizio`(该服务已经预约过), 而不是 PRENOTA。相邻商务签证 EXTRA SLOTS 行仍有按钮,不能拿它替代旅游目标服务。 本证据与此前已确认的现有预约一致;不需修改 4937,不将此情况当作库存为空, 不取消已有预约、不直接拼接目标 URL 继续提交,也不将历史预约算作本次 Book 成功。 ### 35.1 最小实现与已知边界 代码继续放在 `plugins/ita_plugin.py` 既有 Services 诊断函数中;复用原 `ItaTargetServiceLinkMissingError`、调用链和清理逻辑,不新增工作流、路由字段、 平台状态或 VFS/BLS 改动。新增 `already_booked_notice_row_count`:只统计单元格中 完整匹配已观察意大利语提示的可见行,允许大小写/空白/末尾标点差异,返回计数而非 服务行内容、邮箱或预约编号。其他文案仍不猜测。 目标链接缺失且存在该提示时,异常补充“页面包含已预约提示,请核对目标行和现有预约”。 **这是页面级诊断,不是自动完成的目标服务归属判断**:当前路由只有 service_id, 无链接的行尚无已验证 ID 绑定;不能因另一个服务已预约就认定目标也已预约。截图中 的目标归属由用户提供,生产代码不会硬编码香港或服务名。目标链接仍在时按原流程走, 无关行不会阻止它;未知提示/无提示仍保留原缺链接错误。现有错误类型及调度重试语义 未改变,本次不宣称实现“已有预约自动暂停订单”。 ### 35.2 验证与下一步 新增 6 项离线测试:真实生产 JS 在合成 DOM 下的提示匹配/隐藏与否定文字排除、 按行计数且不导出文本、缺链接提示不越权归属、其他服务已有预约不阻止目标、异常 计数处理、Book 传播诊断而不制造成功。665 项 Italy 离线回归通过(6.419 秒、exit 0)。 没有登录网站、发 OTP、提交/取消预约、修改账号或部署;现场新诊断尚未实测。 新 Book 公共入口选位验收仍待完成:需要一名已授权、归属目标机构且该服务尚未预约的 申请人账号,沿用 §34 最终提交关闭的命令。先前真实预约和 Query 正向证据继续有效, 但不替代该新入口验收。OTP 自动化仍为 ITA-OTP-01,留到最后。 ## 36. 新 Book 公共入口选位真实验收通过(用户终端回传) 用户先告知已自行取消该账号的预约,随后执行 §34 的 `--production-workflow` 命令, 回传如下末段日志。取消操作由用户自行完成,本轮助手没有执行取消,也未独立读取 取消回执;本次能继续至 Calendar 选位,说明此前的服务入口阻点在本次运行中已解除。 ```text Italy Book Calendar month=2026-08 candidates=0 Italy Book Calendar month=2026-09 candidates=1 Italy Book selected current user Calendar slot date=2026-09-03 time=09:15 - 10:00; stopped before final confirmation. ITA_BOOK_WORKFLOW_RESULT={"bookResultSuccess":false,"finalSubmissionEnabled":false,"remaining":2,"requests":{"availabilityRequests":3,"avantiPosts":1,"finalRequests":0,"otpRequests":1,"timeSlotRequests":2},"selectedDate":"2026-09-03","selectedTime":"09:15 - 10:00","selectionVerified":true} ITA_BOOK_WORKFLOW_AUDIT={"availabilityRequests":3,"avantiPosts":1,"finalRequests":0,"otpRequests":1,"timeSlotRequests":2} ITA_BOOK_CLEANUP_OK EXIT_CODE=0 ``` 结论:新公共 Book 入口到选位的真实验收通过,不再列为待办。报告与末尾请求审计一致: OTP 1 次、AVANTI 1 次、日历查询 3 次、时段查询 2 次、最终提交 0 次。选位读回验证 通过、清理成功;`bookResultSuccess=false` 是停在最终提交前的预期结果,不是失败。 `remaining=2` 是选位时观察到的余量,不是锁定名额或未来库存承诺。日志中的月份扫描 与返回日期符合首个正向月份停止的合同。请求计数是本次完整准备/扫描流程的总计, 不能把 3 次 availabilityRequests 都解释成扫描了 3 个月。 证据范围:用户回传末段日志,未附本次源码指纹、完整登录日志、前后预约列表或 独立网络导出,因此不补写这些缺失证据;此前 665 项离线测试仍是 §35 的历史结果, 不是本轮重新执行的结果。本轮仅核对本地 CLI 合同并更新文档,无生产代码改动、 真实浏览器操作、预约提交、云端写入或部署。 下一阶段是上线收尾,而不是重复 Query/Book 选位测试:沿用 VFS/BLS 的现有 OrderBooker/标准 VSBookResult 成功上报链路,完成新公共 Book 最终结果与订单状态的 端到端验收,并检查部署依赖、Italy 多模块整包发布与运行配置。先前 gate 的真实预约 证明站点最终提交可行,但不等于这条新生产链路已真实验收;本次选位通过也不等于 已上线或无人值守可用。OTP 自动化继续留到 ITA-OTP-01,按用户要求最后完成。 ## 37. 原 Booker 成功上报链路贯通回归与发布检查 ### 37.1 实现决策:复用原流程,不新增 Italy 上报器 用户授权继续推进 §36 后,本轮检查 `ItaPlugin.book` → `ita_workflow.book/submit_final` → `NativeFinalSubmitter` → `FinalReceiptReadPort` → `VSBookResult` → `OrderBookerGCO._execute_book_job` → 原 `_push_success_notification`。 现有接线已具备该路径,不需要增加生产分支、订单状态、队列或新上报接口。 此前测试分别验证了 Book 最终核心与 Booker 调用上报入口,但 Booker 测试替换了 `_push_success_notification`,没有证明实际组装的云端更新字段。为此新增 `test/test_ita_booker_integration.py`,职责仅为这条跨模块连接的离线验收:复用现有 Calendar 浏览器替身及回执样本,实际执行公共 Book、扫描/选位、NativeFinalSubmitter、 最终核心、回执解析、原 Booker 任务移除及原异步上报回调。浏览器/数据包、被动 CDP 计数、Redis、云接口和执行队列均为替身;测试从已准备的 Calendar 开始,不宣称独立 验证了真实登录/OTP,也没有调用真实网络。生产代码仅修正两处过时的模块/类说明, 不改变算法、配置开关或其他插件行为。 新增 8 项验收覆盖: 1. 正向结果交给原异步回调,订单 ID 正确,status=grabbed;grabbed_history 含正确 account/urn/slot_date,以及回执实际分配时刻而非所选时间区间;密码不进入上报。 2. 最终提交关闭时,只选位,不更新订单、不通知。 3. 原订单 expected_start_date / expected_end_date 传至生产选位逻辑。 4. 服务器明确拒绝且回执没有新增时,保留原失败等待下一信号分支,不报告成功。 5. 可能提交但未确认时走原 pause 接口,下一信号不重复提交。 6. 有新增确认回执但请求归属不匹配时,不报告当前任务成功。 7. 上报回调入队失败后,下一信号复用本次已确认结果,不再创建预约。 8. 云接口失败时不发成功通知,记录原有失败日志;不把“已入队”当作“云端已更新”。 第 8 项也保留了原 VFS/BLS 共享链路的已知限制:异步回调内部云端失败不会新增自动 重投队列;本轮遵循用户要求不改平台语义,实际验收必须查云端订单结果。跨进程可靠性 不是这组测试证明的内容。 ### 37.2 真实本地验证结果 - 新增集成测试 8 项通过(0.026 秒)。 - 完整 Italy 回归 673 项通过(6.459 秒,exit 0),包含新增模块。 - 首次无替身导入发现 `.venv` 缺 redis;已补齐 requirements.txt 中原本声明的该依赖, 安装版本 redis 8.1.0。未新增依赖条目、未升级其他包。 - 新进程真实导入 `booker`、`redis`、`plugins.ita_plugin`、`plugins.ita_workflow` 通过(exit 0),没有启动工作线程、Redis 连接、浏览器或云请求。 - `python -m pip check` 通过;仅证明已安装包依赖一致,不等于全部部署组件已验收。 - `git diff --check` 通过。未执行 commit/push、云写入、真实预约或部署。 可在用户终端复核(全部离线、不预约): ```bash cd /Users/zhangwei/JSWorkSpace/open_source/coordinate source .venv/bin/activate PYTHONDONTWRITEBYTECODE=1 python -B -m unittest -v test.test_ita_booker_integration PYTHONDONTWRITEBYTECODE=1 python -B -c 'import booker, redis, plugins.ita_plugin, plugins.ita_workflow; print("ITA_BOOKER_IMPORT_OK")' python -m pip check ``` ### 37.3 发布边界与下一次真实验收 只读确认:本地 config_booker/config_sentinel 的 Italy 组仍 enable=false,旧 Dublin 1321 / services_probe_only 路由、未配置人工 OTP、final_submit_enabled=false;未自动 改成香港或启用。当前 CLI 的香港配置不等于已部署生产配置,云配置优先级也不能忽略。 现有 `utils/plugin_updater.py` 一次只替换一个插件文件;Italy 此版本有 9 个生产模块: ita_plugin、ita_workflow、ita_calendar_session、ita_calendar_query、ita_calendar_book、 ita_protocol、ita_booking_final、ita_final_read_port、ita_reservation,并依赖本次已有的 booker.py/vs_types.py 共享改动。不能只发布 ita_plugin.py 后声称更新完整;沿用项目 整仓/镜像发布方式,不建设新的热更新协议。Dockerfile 的 COPY . . 可包含整包,但 实际镜像未构建/部署,代码暂未提交的事实也不能略过。 人工 OTP 模式仍需可交互终端。默认 docker-compose 未配置 stdin_open/tty,不能将 后台容器直接当作人工 OTP 已可运行;真实验收先在用户可输入 OTP 的终端进行。 不将这一阶段命名为无人值守上线,自动接码仍归 ITA-OTP-01。 下一项需要用户提供明确的云端任务 ID(task id),用于核对申请人、路由、允许日期、 任务状态及最终结果归属,再给出针对该任务的真实验收命令。没有 ID 时不猜测任务、 不让生产 Booker 任意领取队列任务、不伪造历史预约上报。到目前为止,真实预约核心 与新入口选位已分别有现场证据,但新公共 Book → 原 Booker → 实际云端订单更新的 端到端真实验收仍待完成;本节为离线接线及本地依赖检查通过,不是已部署。 用户后续确认:目前没有用于验收的云端任务。该端到端真实订单验收保留为待办,不再 要求现在提供 task id,不据此新建或任意领取订单。Redis 依赖已再次在项目 `.venv` 核实:Python 客户端 redis 8.1.0 存在,Booker 无替身导入通过、pip check 通过。 这是客户端依赖补齐,不是安装/启动 Redis 服务端,也未验证实际 Redis 连接或读写。