文档状态:
SUPERSEDED / HISTORICAL IMPLEMENTATION LOG当前规范:
docs/ita_plugin_generic_schengen_design.md(R3)。本文保留早期调查、决策演进和实现审计用途,不再作为下一阶段研发依据。重要警告:本文形成于香港 E43 正向证据闭环之前。凡是将
bookingForm弱信号用于生产触发、假定 OTP 位于 Calendar 之后、把默认月份无号外推成整个 Calendar 无号、或禁止进入 Calendar 的旧结论,均已被 R3 取代。版本决策:以现有 VFS/BLS 技术方案为默认基线。能直接复用就不抽象,能通过现有配置解决就不新增框架能力,只有 Prenot@Mi 的网站差异留在 Italy 插件内。
本文主体是设计基线;实施进度见 §17。设计阶段及 2026-08-27 的 Change Set 1/2 离线实现均未登录网站、发送 OTP 或执行真实预约。
本文满足以下条件才算完成:
本版明确撤回上一版的以下首发设计:
plugins/ita/ 子包;VSQueryResult、AvailabilityStatus、Sentinel、Booker、Standalone 或 Redis 客户端;这些能力未来只有在现有 VFS/BLS 机制被真实证据证明不够用时,才作为独立改进提案讨论。
首版 Italy 应完整复用现有闭环:Sentinel + 内置 Query 账号池 → VSQueryResult → Redis 30 秒信号 → OrderBooker 用户热 Session → plugin.book();Query 用 BLS 已存在的“成功触发但没有具体日期”表达法发弱信号,Book 用 VFS 的“在自己 Session 中重新加载、重新查 Calendar/TimeSlot、再提交”的方法完成预约,Italy 只实现 Prenot@Mi 特有的页面选择器、表单、Calendar、PRENOTA 和 OTP 顺序。
用人话说:
vs:signal:{routing_key};VSQueryResult、DateAvailability、TimeSlot、VSBookResult;VSCloudApi.fetch_mail_content();项目方已经确认:
本文把这三点作为业务前提,不再重新设计另一套账号或合规体系。
Italy 仍要保持与现有方案一致的身份边界:Query 账号只发现机会,用户账号完成属于自己的预约;不跨账号复制 Cookie、Session、CSRF 或页面状态。
| 事实 | 证据 | 确信度 |
|---|---|---|
IAM 登录字段为 callback_1、callback_2 |
真实 DOM + 自动登录 | 高 |
自动登录可以到 /UserArea |
ITA_SESSION_OK、exit 0 |
高 |
Dublin 通用签证服务候选为 service_id=1321 |
Services DOM/href | 中高 |
无号请求为 GET /Services/Booking/1321 |
Network | 高 |
无号时 302 回到 /Services |
Network Location: /Services |
高 |
无号页面有非空 #WNotAvailable 和已知弹窗 |
DOM | 高 |
| 无号探测没有 Calendar、OTP 或预约业务 POST | Network | 高 |
自动 Query 已正确返回 NoAvailable |
真实执行 exit 0 | 高 |
官方 Prenot@Mi 用户手册描述的顺序是:
填写服务表单并接受隐私条款
→ AVANTI
→ Calendar
→ 选择日期与时间
→ PRENOTA
→ 注册邮箱收到 OTP
→ 输入 OTP 并点击 OK
→ 显示预约摘要、预约编号和二维码
手册同时说明,不同领馆和不同服务的字段会变化。因此我们复用 VFS/BLS 的流程骨架,但不能复制它们的网站字段。
来源:
bookingForm 当前 action、method、字段、Tourism 选项和文件要求;AVANTI 的真实请求及副作用;PRENOTA 是否正好触发一次预约 OTP;/Reservation 读取预约编号;keep_alive()。| 能力 | 现有实现 | Italy 决策 | 是否新增 |
|---|---|---|---|
| Query 角色 | SentinelGCO |
原样使用 | 否 |
| Book 角色 | OrderBookerGCO |
原样使用 | 否 |
| 插件加载 | VSPlgFactory |
原样使用 ita_plugin.py |
否 |
| 生命周期 | IVSPlg |
原样实现 create_session/query/book/keep_alive/... |
否 |
| 配置加载 | GroupConfig |
原样使用 free_config 与现有字段 |
否 |
Italy 不新建 daemon、scheduler、queue、worker 或 service。
BLS 已经提供目标形态:
Sentinel.account_source = built-in
Booker.account_source = order
Italy 当前配置本来就是:
ie.it.sentinel 账号池取 Query 账号;user_inputs.username/password 创建用户 Session;target_instances=1 表示同一 routing key 只维持一个用户热实例。因此不新增 AccountProvider,不新增账号对象,也不把邮箱加进 VSAccount。Prenot@Mi 登录名本身就是注册邮箱,OTP 查询沿用 VFS/BLS 的 self.config.account.username。
现有链路:
plugin.query()
→ result.success=True
→ Sentinel 写 vs:signal:{routing_key}
→ TTL 30 秒
→ OrderBooker 读取并反序列化 VSQueryResult
→ task.instance.book(query_result, user_inputs)
Italy 原样使用:
BLS 已存在以下结果:
result.success = True
result.availability_status = AvailabilityStatus.NoneAvailable
result.availability = []
它表达的是:Query 成功到达值得 Booker 继续处理的阶段,但当前没有具体日期可以传递。
Italy 的 ENTRY_ACCEPTED 完全复用这一表达:
| 网站结果 | success |
availability_status |
earliest_date |
Sentinel 行为 |
|---|---|---|---|---|
| 明确无号 | False |
NoneAvailable |
None |
不发信号 |
进入 bookingForm |
True |
NoneAvailable |
None |
发 30 秒弱信号 |
| 将来若 Query 能只读取到日期 | True |
Available |
真实日期 | 发强信号 |
这样无需新增 EntryAvailable、SignalIntent 或 Signal v2。
Booker 的 _is_date_of_interest() 对 NoneAvailable 原本就返回 True,因此弱信号不会因为没有 earliest_date 而报错;用户日期偏好在 Book 读取 Calendar 后再判断。
现有 Booker 在触发任务时设置:
task.next_run = now + booking_cooldown
Italy 当前 signal_ttl=30s,但 booking_cooldown=10s,同一个信号理论上可能被重复消费。首版不新造原子 claim,只使用现有配置能力:
signal_ttl = 30s
booking_cooldown = 45s
target_instances = 1
query_wait.random_min = 60s
机械约束:
booking_cooldown > signal_ttl
AND query_wait.random_min > booking_cooldown
AND target_instances == 1
AND 同一 Italy group 同时只有一个有效 OrderBooker 部署
在这个约束下,同一个 30 秒信号对当前 Italy 任务最多触发一次。若未来确实需要多节点或多 Booker,再用真实并发需求推动框架级 claim 设计,而不是现在预设。
VFS 的核心纪律是:Query 的日期只是起点;Book 在自己的 Session 中重新加载配置、查询 Calendar、查询 TimeSlot,最后提交当下仍存在的 slot。
Italy 直接复用这条顺序:
收到弱信号
→ 用户 Session 中重新 GET service 1321
→ 重新读取 bookingForm
→ 提交 AVANTI
→ 重新读取 Calendar
→ 重新读取当日 TimeSlot
→ 应用用户日期偏好
→ 使用当前 slot 继续 PRENOTA
Italy 不读取 Query 账号的 Cookie、页面对象或临时参数,也不依赖 Query 的日期。
VFS/BLS 都使用:
VSCloudApi.Instance().fetch_mail_content(...)
Italy 也使用该 API,并复用这些行为:
sent_at;self.config.account.username;NotFoundError/BizLogicError。Italy 只需真实验证自己的 sender、subject、验证码位数和有效期。不新增 OtpProvider、邮箱服务或消息队列。
安全修正仍属于 Italy 必需实现:不打印 OTP,不把邮件正文写入日志。
VSBookResult继续填充现有字段:
success
account
urn ← Prenot@Mi 预约编号
book_date
book_time
label
不新增新的通用结果类。Italy 成功条件为:预约成功摘要或 /Reservation 中能读取到预约编号、日期和时间;不能只看 HTTP 200。
最大化复用不等于复制网站私有细节:
| 内容 | 为什么不能复用 | Italy 如何处理 |
|---|---|---|
| URL/endpoint | 三个网站不同 | 以 Prenot@Mi Network 证据实现 |
| JWT/Turnstile/加密算法 | Prenot@Mi 使用 IAM 浏览器 Session | 保留当前 Italy 登录方式 |
| VFS applicant/URN payload | Prenot@Mi 表单模型不同 | 解析真实 bookingForm |
| BLS hidden fields/query params | BLS 页面私有 | Italy Book 在用户 Session 中实时读取 |
| 服务 ID、字段 ID、Tourism option | 领馆和服务可变 | 真实 Dublin 1321 Gate 验证 |
| OTP sender/subject | 每个站点不同 | 只复用邮件读取 API |
| 成功响应字段 | 每个站点不同 | 解析 Prenot@Mi 摘要/Reservation |
原则:复用控制结构、基础设施和类型;网站协议只认真实证据。
SentinelGCO(原样复用)
built-in Query 账号池,target_instances=1
│ ItaPlugin.query()
▼
GET /Services/Booking/1321
│
├─ 302 + WNotAvailable
│ success=False,不写信号
│
└─ 进入 #bookingForm
success=True + NoneAvailable
│
▼
vs:signal:slot.dub.it.tourist,TTL=30s(原样复用)
│
▼
OrderBookerGCO(原样复用)
order 用户账号,热 Session,target=1,cooldown=45s
│ ItaPlugin.book()
▼
用户账号重查 → Form → AVANTI → Calendar → TimeSlot
│
PRENOTA → OTP → OK
│
摘要/Reservation → VSBookResult
/Services,清除旧弹窗状态;/Services/Booking/{service_id} 找入口;/Services 且 marker/已知 notice 非空,返回无号;当前代码在出现 #bookingForm 时抛安全异常。Gate 通过后只改成:
result.success = True
result.availability_status = AvailabilityStatus.NoneAvailable
result.earliest_date = None
result.availability = []
return result
Query 到此结束,仍然禁止填表、AVANTI、Calendar、日期/时间、PRENOTA 和 OTP。
直接使用现有 Sentinel pool:
target_instances=1;query_wait;首版不做 release-time 预测。判断“什么时候可能有号”的方式,是观察门禁从无号回退变成允许进入表单。
Book 保持和 VFS/BLS 一样:一个 book() 主流程 + 若干站点 helper,仍位于 plugins/ita_plugin.py。
1. 检查用户 Session
2. 用户账号重新进入 /Services/Booking/1321
3. 若已无号:返回 VSBookResult(success=False)
4. 读取当前 bookingForm、hidden fields 和动态字段
5. 用 user_inputs 填写真实必填项并校验
6. 接受 privacy,单次提交 AVANTI
7. 读取当前 Calendar 日期
8. 应用 expected_start_date / expected_end_date
9. 查询候选日当前 TimeSlot
10. 选择当前仍可用 slot
11. 点击/提交 PRENOTA 一次
12. 使用 VSCloudApi.fetch_mail_content() 读取 OTP
13. 输入 OTP 并点击 OK 一次
14. 解析成功摘要或 /Reservation
15. 返回现有 VSBookResult
沿用 VFS/BLS 的方法拆分风格,在同一类中新增或重写:
_enter_target_service()
_extract_booking_form()
_fill_booking_form(user_inputs)
_submit_avanti_once()
_query_calendar_dates()
_query_time_slots(date)
_select_slot(user_inputs)
_submit_prenota_once(slot)
_read_otp_email(sent_at)
_submit_otp_once(otp)
_extract_booking_result()
不引入工作流引擎。book() 只维护一个本地 stage 字符串用于脱敏诊断。
复用 VFS/BLS 的实时读取原则:
user_inputs 只映射到已验证字段;复用 VFS Book 模式:
复用 VFS/BLS:PRENOTA 前记录 UTC 时间;PRENOTA 一次;用 Cloud API 查 sent_at 之后的匹配邮件;OTP 一次提交;全程不输出 OTP。
首个真实 Canary 可以先由用户手工输入 OTP;自动读取只在 Italy sender/subject/格式验证后打开。
成功必须取得预约编号、日期和时间。HTTP 200、收到 OTP、看到 Calendar 或发出 PRENOTA 都不算成功。
| 操作 | 自动重试 |
|---|---|
| Session/Services 只读 GET | 最多再试 1 次 |
| Calendar/TimeSlot 只读查询 | 最多再试 1 次 |
| 表单填写但未提交 | 可重建 1 次 |
| AVANTI | 不盲重试 |
| PRENOTA/发送 OTP | 不重试 |
| OTP 提交 | 不重试 |
写操作结果不明时检查当前页面和 /Reservation;仍不明就返回失败并人工处理。首版不新增 Redis 状态机。
create_session() 继续使用已真实验证的 Italy 登录,不复制 VFS JWT/BLS 登录。
keep_alive() 复用 Booker 的现有定时调用,只寻找一个 Prenot@Mi 只读实现。候选依次为 /UserArea、/Services、已观察到的轻量认证请求。
通过标准:连续覆盖两个 session_max_life 周期,Session 有效,Network 无预约业务写请求,429/challenge=0。
| ID | 假设 | 验证动作 | 机械通过标准 | 停止条件 |
|---|---|---|---|---|
| P0-01 | Query pool 账号可用于 Dublin 1321 | 每个候选账号只读登录 Services | 每个启用账号均显示 Dublin 与 /Services/Booking/1321 |
不匹配即移出池 |
| P0-02 | Query 弱信号对用户账号有意义 | Query A 进入 form 后,用户 B 30 秒内重查一次 | 至少 3 个独立机会中 3/3 用户账号也进入 form | 429/挑战停止当轮 |
| P0-03 | Query 没有预约副作用 | 探测前后对比预约列表和 Network | 预约业务 POST=0,预约/Waiting List 无变化 | 有变化即禁用 Query |
| P0-04 | bookingForm 可安全识别 |
EntryAccepted 时只读采集 metadata | path、form、service ref 同时匹配;submit/OTP=0 | 不一致 fail-closed |
| P0-05 | 表单字段完整可映射 | 采集 action/method/names/types/required/options | 所有必填字段有明确来源 | 未知必填禁止 AVANTI |
| P0-06 | AVANTI 成功进入 Calendar | 单用户、单次授权提交 | 观察真实请求并进入 Calendar;调用次数=1 | 结果不明不重发 |
| P0-07 | Calendar/TimeSlot 可读取 | AVANTI 后只读 Network/DOM | 取得 date、time、slot ref,可按用户范围过滤 | 未知写请求停止 |
| P0-08 | PRENOTA 是 OTP 边界 | 选真实 slot 后单次点击 | PRENOTA=1、OTP 邮件=1、请求语义明确 | 不重复发送 |
| P0-09 | OTP 后能确认真实预约 | 一次明确授权的 Canary | OTP submit=1,摘要/Reservation 有同一编号、日期、时间 | 不明时禁止二次提交 |
| P0-10 | cooldown 防同信号重复 Book | 伪信号保持 30 秒,并按当前最短 60 秒 Query 间隔模拟 | target=1,cooldown=45,min_query=60 时同一信号 book() 总数=1 |
调用>1才重评 claim |
| P0-11 | Cloud API 能读取 Italy OTP | 授权邮箱沙箱/首次 Canary | 只取 sent_at 后正确邮件,旧码不匹配,日志无 OTP | 错取或泄漏即禁用 |
| P0-12 | Italy keep_alive 只读 | 运行两个 Session 周期 | 写请求=0,Session 有效,429/challenge=0 | 有副作用即废弃 |
| ID | 假设 | 机械验证 |
|---|---|---|
| P1-01 | ITA/ENG 不改变控制逻辑 | 两种 locale fixture 的 path/form 分类一致 |
| P1-02 | 弱信号无日期时不提前过滤 | _is_date_of_interest() 返回 True,日期在 Book 内判断 |
| P1-03 | 新必填字段安全停止 | mutation fixture 下 AVANTI=0 |
| P1-04 | 文件错误在提交前发现 | 错误 fixture 下网络写请求=0 |
| P1-05 | 取消订单阻止 Book | 取消状态下 book()=0 |
| P1-06 | 无号回归不退化 | 输出 NoAvailable、cleanup OK、exit 0 |
| P1-07 | 账号池不放大频率 | 增加账号后单位时间 Query 总数不增加 |
| P1-08 | 未知页面不伪装 | 未知 fixture 均异常且 signal=0 |
首版只允许修改:
| 文件 | 修改内容 |
|---|---|
plugins/ita_plugin.py |
弱信号、Book、keep_alive 与 Italy helper |
config/config_booker.json |
Italy booking_cooldown: 45,保持 target=1 |
config/config_sentinel.json |
原则上不改,保留 pool/TTL/query_wait |
test/test_ita_plugin.py |
Query/Book/OTP fixture |
test/test_debug_ita_query.py |
单次 Query 安全合同 |
tools/debug_ita_query.py |
弱信号只报告,不 Book |
tools/debug_ita_book.py |
新增按 Gate 停止的单次 Book 调试器 |
首版禁止修改 sentinel.py、booker.py、standalone.py、vs_types.py、vs_plg.py、utils/safe_redis_cli.py 和 VFS/BLS 插件。
如果研发发现必须修改这些文件,先停止,提交“现有能力无法复用”的复现测试,再申请扩大范围。
bookingForm 返回 BLS 式弱信号;完成标准:
Italy focused tests exit 0
existing regression tests exit 0
NoAvailable fixture: signal=0
EntryAccepted fixture: signal=1
30s retained signal: book_call_count=1
debug query: book_call_count=0
用户 Session 重进 1321,动态读取表单,默认停在 AVANTI 前;未知字段 fail-closed。
P0-05/06/07 通过后实现;默认停在 PRENOTA 前。
P0-08/11 通过后实现;默认停在 OTP submit 前。
用户明确授权后,OTP submit 一次,解析摘要/Reservation,返回 VSBookResult。
| 场景 | 期望结果 | 写调用约束 |
|---|---|---|
302 + WNotAvailable |
success=False |
0 |
| 已知无号弹窗 | success=False |
0 |
bookingForm |
success=True + NoneAvailable |
0 |
| 未知弹窗/path | 明确异常 | 0 |
| 同一信号保留 30 秒 | Book 触发一次 | book=1 |
| 用户重查已无号 | Book 失败 | AVANTI/OTP=0 |
| 新增未知必填字段 | 结构异常 | AVANTI=0 |
| 日期不在用户范围 | Book 失败 | PRENOTA/OTP=0 |
| Calendar 有日期无 TimeSlot | Book 失败 | PRENOTA/OTP=0 |
| PRENOTA 后邮件延迟 | 等待至 timeout | PRENOTA=1 |
| 读到旧 OTP | 忽略 | OTP submit=0 |
| OTP 成功响应但无摘要 | 检查 Reservation | OTP submit=1 |
| OTP 结果不明且无记录 | 人工处理 | OTP submit=1 |
敏感信息扫描覆盖日志、异常和调试输出:密码、Cookie、Authorization、CSRF、OAuth 动态值、OTP、邮件正文和个人资料命中必须为 0。
接受现有 Sentinel/BLS/OrderBooker 信号语义;接受首版单 Booker + cooldown;接受 Italy 单文件结构;后续每个副作用单独授权。
Change Set 1 全部通过,不访问网站。
Booker 禁用;无号分支稳定;首次 EntryAccepted 只输出弱信号与脱敏 metadata;表单提交=0、OTP=0。
完成 P0-02/03/04/05;用户账号只进入表单,不提交。
逐次授权,停在 PRENOTA 前,完成 P0-06/07。
授权发送一次 OTP,停在 OTP submit 前,完成 P0-08/11。
用户明确授权;OTP submit=1;摘要或 Reservation 取得编号、日期、时间;Cleanup OK;日志敏感值=0。
Sentinel target_instances = 1
Booker target_instances = 1
booking_cooldown = 45
signal_ttl = 30
query_wait.random_min = 60
有效 Italy OrderBooker 部署数 = 1
kill switch 已验证
| 能力 | 可行性 | 确信度 |
|---|---|---|
| 登录 | 已实现并真实验证 | 高 |
| 无号识别 | 已实现并真实验证 | 高 |
| EntryAccepted 弱信号 | 直接复用 BLS 表达 | 中;缺真实有号样本 |
| Query/用户账号接力 | 直接复用 BLS 架构 | 中;缺同窗验证 |
| 用户热 Session | OrderBooker 已提供 | 中高 |
| Calendar/TimeSlot | 复用 VFS Book 模式 | 低;缺 Italy 协议 |
| OTP | 复用 VFS/BLS 基建 | 中;缺 Italy 邮件证据 |
| 最终预约 | 流程清晰 | 低;缺真实 Canary |
当前可以高信心进入 Change Set 1 的离线实现;不能编写 Calendar、OTP 和最终提交,因为对应 Italy 网站证据尚不存在。
回应:首版不修改 Sentinel、Booker、Redis、通用类型、接口或插件工厂;直接使用 BLS 的账号拆分与弱信号语义、VFS 的 Book 内重查、两者共有的 OTP Cloud API。运行代码只改 Italy 插件和 Italy cooldown 配置。不能复用的只剩 Prenot@Mi 自己的网页协议。
success=True + NoneAvailable 不直观,为什么仍采用?”回应:这是 BLS 已有且能被当前 Sentinel/Booker消费的表达:success 控制触发,NoneAvailable 表示没有具体日期。Italy 的 EntryAccepted 恰好也是“值得重查但没有日期”。为了复用现有协议,首版接受这个约定,用测试固定语义,不在 Italy 修复中重构通用模型。
回应:首版部署约束是单 Italy OrderBooker、target_instances=1,并让 booking_cooldown=45s 大于 signal_ttl=30s。离线测试必须证明同一信号 book_call_count=1。只有未来需要多节点并发且该约束失效时,才讨论原子 claim。
回应:Sentinel 与 OrderBooker 本来就是不同插件实例、账号和 Session。VFS 已给出正确做法:Book 在自己的 Session 中重新查询当前 Calendar/TimeSlot。
回应:复用的是框架和控制结构,不是第三方网站私有协议。复制别的网站 payload 不是复用,而是制造不可验证的硬编码。
bookingForm 返回 BLS 式弱信号:success=True + NoneAvailable;booking_cooldown 从 10 秒调整为 45 秒;OrderBookerGCO;query(),调用 book() 次数为 0;book() 中未经网站证据支持的 OTP、硬编码表单、文件上传和最终确认实现;book() 在用户自己的 Session 中复用 query(),重新进入 1321;VSBookResult(success=False);bookingForm 时,只读取不含字段值的结构 metadata,并停在 AVANTI 前;tools/debug_ita_book.py:单次 Book 重查,book_attempt=1,submit_attempts=0;--arm 可先登录停在 /UserArea,收到 Query 弱信号后再按 Enter;等待期间按 Ctrl+C 会以 book_attempts=0 清理退出,不打印 traceback;bookingForm 状态重新加载 /Services,避免下一轮卡死。验证记录:
.venv/bin/python -m unittest \
test.test_add_ita_query_account \
test.test_ita_plugin \
test.test_debug_ita_query \
test.test_debug_ita_book \
test.test_debug_ita_session
Ran 56 tests
OK
ITALY_ACCOUNT_TOOL_TEST_EXIT=0
external_request=not-performed
静态验证:8 个相关 Python 文件编译 exit 0;Italy 配置合同 exit 0;
旧危险路径(OTP、BookingCalendar、InsertNewBooking、FormData 等)在
plugins/ita_plugin.py 中命中 0;真实账号标记命中 0。
仓库级 test.test_cloud_config 仍因 HEAD 基线中导入已不存在的
fetch_remote_config 而失败;本次未越界修改该无关模块。带顶层外部 Redis
写入的历史脚本也未通过 unittest discover 导入。
用户在 --arm 模式完成登录后只释放了一次 Book 重查,观察到:
ITA_BOOK_RECHECK_START service_id=1321 book_attempt=1
Target Italy service showed the verified no-availability notice.
ITA_BOOK_RECHECK_NONE_AVAILABLE service_id=1321
ITA_BOOK_CLEANUP_OK
结论:用户 Session 中的 1321 单次重查、已知无号分类、失败结果和清理分支
均已真实验证。【高】本次没有进入 bookingForm,没有验证表单结构;也没有
DevTools Network 记录,因此不把代码级零提交约束扩写成网络级证据。
当前只有一个账号,所以 P0-02 的“Query 账号 A → 用户账号 B”跨账号同窗验证 仍未完成。【低/待第二个已授权账号】同账号并发登录可能使旧 Session 失效, 在取得网站证据前不采用该测试方式。
已确认 Sentinel 从 ie.it.sentinel 调用现有 /api/account/next,现有账号写入口
为 /api/account/add。VFS 注册脚本中的旧上传函数会输出账号标识并带 VFS
专用 metadata,因此没有直接用于 Italy。
新增 tools/add_ita_query_account.py,约束如下:
ie.it.sentinel / 1321;--apply 才允许一次 POST,自动重试次数为 0;传输结果不确定时 exit 5,并要求先在管理端核实再决定是否重试。
ITA_ACCOUNT_UPLOAD_PREFLIGHT_OK pool=ie.it.sentinel service_id=1321 request_sent=false
ITA_ACCOUNT_TOOL_DRY_RUN_EXIT=0
账号上传工具与 Italy 回归共 56 项测试通过;工具编译、空白和真实账号标记
检查均 exit 0。真实 /api/account/add 尚未调用,等待单独授权。
本地调试阶段优先读取 config/ita_query_account.local.json,供
tools/debug_ita_query.py、tools/debug_ita_monitor.py 以及登录调试器显式的
--local-query-account 模式使用:
tools/debug_ita_book.py 不读取该文件,仍使用用户账号;config_sentinel.json 或生产账号池;/api/account/add。真实验证记录(用户执行,2026-08-27):
ITA_SERVICE_ID=1321 python tools/debug_ita_query.py
Successfully reached authenticated /UserArea.
ITA_QUERY_PROBE_START service_id=1321 query_attempt=1
ITA_QUERY_NONE_AVAILABLE service_id=1321 status=NoAvailable
ITA_QUERY_CLEANUP_OK
EXIT_CODE=0
由此已验证:【高】本地文件中的账号可被 Query 调试器读取、凭据有效、登录能
到 /UserArea、Dublin service_id=1321 可查询、已知无号分支分类正确且
cleanup 成功。该次没有 Network 录制,因此不把“没有预约业务写请求”列为
本次新增证据;无号探测的网络副作用边界仍沿用此前人工 DevTools 记录。
仍未验证:真实有号时是否进入 bookingForm、弱信号能否被另一个用户账号在
30 秒内复现,以及 AVANTI 之后的 Calendar/TimeSlot。
新增 tools/debug_ita_monitor.py,只在本地 Discovery 阶段使用:
--run 才访问网站;debug_ita_query.py 的本地账号、登录配置、Query、弱信号分类、表单
结构脱敏和失败诊断;action=start-user-book-recheck-now,不自动调用 Book;离线验证:监控器及 Italy 回归共 74 项测试通过,exit 0。真实循环尚未启动; 没有因为新增监控器而产生网站请求。
真实监控第一次在 IAM 授权阶段异常改道并以 exit 1 安全停止;随后独立的
登录调试成功到达 /UserArea,但该调试 Session cleanup 后删除了全部临时
浏览器资料。紧接着启动的第二次监控进入
validate.perfdrive.com/<dynamic-challenge>,从未出现登录表单,也从未进入
Query,最终 exit 1 且 cleanup 成功。按“同类错误最多两次”停止真实重试。
代码审查确认:每个 Italy 插件实例原先都使用带随机 instance id 的
data/temp_browser_data/.../user_data,cleanup 时完整删除。因此成功登录所
获得的 Cookie、Radware 客户端状态和浏览器上下文不能被下一个本地 Query
进程复用。这不证明持久化一定能通过 Radware,但证明原调试流程会主动丢失
刚获得的会话连续性。
本阶段增加以下边界:
data/ita_query_profiles/<account-hash>;路径不包含账号
明文,根目录和账号目录在 POSIX 上强制为 0700;.gitignore 忽略,Profile 只保存在本机;--local-query-account 模式
复用同一 Profile;validate.perfdrive.com 被明确分类为
ItaAuthenticationChallengeError,动态 challenge path 在日志中脱敏;离线回归共 83 项测试通过,exit 0。
真实登录-only 验证(用户授权,2026-08-27):
python tools/debug_ita_session.py --local-query-account --non-interactive
Browser profile mode=persistent id=<redacted-profile-id>
Successfully reached authenticated /UserArea.
ITA_SESSION_OK url=https://prenotami.esteri.it/UserArea
ITA_SESSION_CLEANUP_OK
EXIT_CODE=0
验证后调试端口无监听;Profile 为 0700,存在浏览器状态,独占锁可重新获取,
并继续被 Git 忽略。该次只登录,没有执行 Query、Book、OTP 或预约表单操作。
第二个独立进程复用验证(用户再次授权,2026-08-27):Profile ID 与第一次
一致;网站仍显示 IAM 登录表单,因此 OAuth 认证本身没有跨进程免登录;凭据只
提交一次后成功返回 /UserArea,ITA_SESSION_OK、cleanup 和 exit 0 均成立,
没有进入 Radware challenge。结束后端口无监听、Profile 仍为 0700、独占锁
已释放且 Git 状态中不可见。
精确结论:跨进程 Profile 复用已验证;跨进程免登录未实现;两个持久化 Profile
进程连续登录成功且未出现 Radware,但样本不足以宣称永久消除挑战。仍待验证:
同一 Profile 下的一次 service_id=1321 Query。
真实有界轮询验证(用户授权,2026-08-27):
ITA_SERVICE_ID=1321 python tools/debug_ita_monitor.py \
--run --non-interactive --min-wait 60 --max-wait 90 --max-probes 3
ITA_MONITOR_STARTED service_id=1321 session_attempts=1 max_probes=3
ITA_MONITOR_NONE_AVAILABLE service_id=1321 probe=1
ITA_MONITOR_WAIT next_probe=2 seconds=84
ITA_MONITOR_NONE_AVAILABLE service_id=1321 probe=2
ITA_MONITOR_WAIT next_probe=3 seconds=63
ITA_MONITOR_NONE_AVAILABLE service_id=1321 probe=3
ITA_MONITOR_MAX_PROBES_REACHED service_id=1321 probes=3
ITA_MONITOR_CLEANUP_OK
EXIT_CODE=0
同一个持久化 Profile 和同一个已认证浏览器 Session 完成 3 次真实 Query;两个
等待值均不低于 60 秒,三次均命中已验证的无号文案,没有出现 Radware、未知
结果或弱信号。结束后调试端口无监听、Profile 仍为 0700、独占锁已释放且
Git 不可见。由此本地有界轮询能力已验证;生产账号池、长期保活和弱信号后的
用户 Book 抢占仍属于后续 Gate。
生产链路已经由 Sentinel、Redis 和 OrderBooker 完成,因此本阶段没有创建第二套
生产队列,也没有修改 sentinel.py、booker.py、vs_types.py 或 Redis
payload。新增的 tools/ita_local_handoff.py 只是 Discovery 阶段的本地适配器:
Query Monitor(团队授权账号 + Query Profile)
→ 确认进入 bookingForm
→ 原子写入 30 秒 metadata-only 本地信号
→ Book Debugger(用户账号 + 独立临时 Profile)原子领取一次
→ ItaPlugin.book() 在用户 Session 中重新查询 1321
→ 无号:明确结束
→ bookingForm:输出脱敏结构并停在 AVANTI 前
本地信号只包含固定 schema、service_id、routing_key、booking-form
证据和签发时间;不包含账号、密码、Cookie、Token、表单值、日期或时间。目录权限
为 0700、信号文件为 0600,路径被 Git 忽略。发布使用临时文件加原子替换,
领取使用同目录原子重命名;两个消费者并发时只有一个能取得信号。信号超过 30 秒、
目标不匹配、格式未知或权限异常时 fail-closed,不能触发 Book。
这里保证的是本地 Discovery 所需的“至多一次”,不是分布式事务意义上的“恰好 一次”:若 Book 在原子领取后、用户重查前进程崩溃,信号会丢失,不会自动重放。 这是安全取舍——宁可错过一次调研机会,也不在结果未知时重复触发 Book。生产仍 由既有信号 TTL、Booker cooldown 和用户 Session 重查合同负责,不依赖这个文件。
debug_ita_monitor.py 只有显式指定 --publish-local-signal 才发布;无号、未知
结果或异常均不发布。debug_ita_book.py --wait-for-local-signal 会先登录用户账号,
最多等待 900 秒,并在领取后只调用一次 book()。自动模式在任何网站请求之前
校验本地 Query 账号与 Book 用户账号不同;Book 不复用 Query Profile、Cookie
或页面状态。
两个终端的未来真实验证命令如下。终端 A 必须输入用户自己的 Book 账号,终端 B
读取 config/ita_query_account.local.json 中不同的团队 Query 账号:
# Terminal A:先让用户 Book Session 就绪;账号和密码使用隐藏输入,不写入命令行
python tools/debug_ita_book.py \
--wait-for-local-signal \
--signal-timeout 900
# Terminal B:再启动有界 Query;只有 bookingForm 弱信号才发布本地交接
ITA_SERVICE_ID=1321 python tools/debug_ita_monitor.py \
--run \
--non-interactive \
--publish-local-signal \
--min-wait 60 \
--max-wait 90 \
--max-probes 3
离线端到端测试已注入一个真实格式的弱信号,并机械证明:Query 与 Book 是两个
插件实例;Query 调用 query() 一次、book() 零次;Book 原子领取一次并调用
book() 一次;第二次领取为空;最终标签为
stage=before-avanti submit_attempts=0。过期信号、目标不匹配和双消费者竞争也有
独立测试。
验证记录:
.venv/bin/python -m unittest \
test.test_ita_local_handoff \
test.test_debug_ita_monitor \
test.test_add_ita_query_account \
test.test_ita_plugin \
test.test_debug_ita_query \
test.test_debug_ita_book \
test.test_debug_ita_session
Ran 93 tests
OK
EXIT_CODE=0
相关 Python 文件 compile: ok,EXIT_CODE=0
Monitor 本地交接 preflight: external_request=false,EXIT_CODE=0
Book CLI 参数检查:EXIT_CODE=0
git diff --check:EXIT_CODE=0
git diff --exit-code -- sentinel.py booker.py vs_types.py:EXIT_CODE=0
git check-ignore data/ita_local_handoff/query-weak-signal.json:EXIT_CODE=0
真实交接尚未执行:当前网站没有出现弱信号,且本地目前只有一个账号。不能用 同账号并发登录冒充“团队 Query 账号 → 用户 Book 账号”的 P0-02 证据。取得第二个 已授权且属于 Dublin 的账号,并在真实开放窗口出现后,才执行上述两个终端命令。
新增 tools/debug_ita_soak.py,用于在接入生产 Sentinel 之前完成一天的本地
稳定性验证。它复用现有 Query 本地账号、持久化 Profile、ItaPlugin.query()
和弱信号判断,不新增第二套生产调度器,也不连接 Redis:
--run 才访问网站;SessionExpiredOrInvalidError 才允许清理并重建 Session,重建前
至少等待 60 秒;正常过期不再受固定总次数限制,由 86,400 秒任务时长约束;/Services/Booking/1321 首次缺失记录脱敏结构并等待下一轮,连续第二次缺失
时停止;Radware、未知页面和未知业务结果均立即停止;bookingForm 时写入 weak_signal 状态并立即停止,不调用 Book、AVANTI、
Calendar、OTP、表单提交或生产本地交接;data/ita_soak/status.json 只保存固定 metadata,目录和文件权限分别为
0700、0600,并被 Git 忽略。为解决此前真实 10 次 Monitor 在第 3 次偶发找不到 1321 链接的问题,Italy
Query 对目标链接的有界等待从 3 秒扩为 15 秒,并新增专用的
ItaTargetServiceLinkMissingError。诊断只包含 path、文档 ready state、表格数、
行数、Booking 链接数和目标链接数,不采集服务文本、账号或页面字段值。
离线验证记录:
.venv/bin/python -m unittest \
test.test_debug_ita_soak \
test.test_ita_local_handoff \
test.test_debug_ita_monitor \
test.test_add_ita_query_account \
test.test_ita_plugin \
test.test_debug_ita_query \
test.test_debug_ita_book \
test.test_debug_ita_session
Ran 103 tests
OK
EXIT_CODE=0
其中加速的一天模拟以 300 秒固定间隔完成 288 次 Query,证明持续时间边界、
一次缺链后恢复、连续两次缺链停止、显式 Session 过期后安全重建、弱信号立即
停止、状态文件权限和零网络 preflight。相关文件 compile、git diff --check、
生产 sentinel.py/booker.py/vs_types.py 零改动检查均为 exit 0。
真实 15 分钟短测记录:
ITA_SERVICE_ID=1321 .venv/bin/python tools/debug_ita_soak.py \
--run --non-interactive \
--duration-seconds 900 \
--min-wait 60 --max-wait 90 \
--max-session-attempts 2 --restart-wait 60
ITA_SOAK_COMPLETED duration_seconds=900 probes=11 \
none_available=11 transient_errors=0 session_attempts=1
ITA_SOAK_SESSION_CLEANUP_OK session=1 reason=soak-finished
ITA_SOAK_CLEANUP_OK
EXIT_CODE=0
同一真实登录 Session 完成 11 次探测,全部命中已验证的无号分支;未出现缺链、
Radware、Session 过期、未知结果或弱信号。结束后状态为 completed,调试端口
无监听,Profile 锁可重新获取。由此已验证“可安全启动一天本地稳定性测试”;
尚未验证真实开放窗口和 bookingForm 弱信号。
第一次启动 86,400 秒任务时,probe 1 成功,随机等待 205 秒后 probe 2 在读取
页面前发生 DrissionPage PageDisconnectedError。状态正确写为 failed,
cleanup 成功,系统电源日志没有睡眠记录,也没有本机 Chrome crash report;因此
只能确认“浏览器/CDP 连接已经断开”,不能臆测网站拒绝或具体崩溃原因。
基于这条真实证据,轮询器只新增一个窄恢复分支:首次
PageDisconnectedError 清理旧实例、等待至少 60 秒并复用同一私密 Profile
创建新 Session;若没有成功 Query 就连续第二次断连,则以
consecutive-browser-disconnects 停止,不创建第三个 Session。其他未知异常仍
立即停止。新增两项测试后 Italy 回归为 105 项,全部通过,exit 0。
后续真实长测在 5,704 秒内完成 36 次探测、32 次已知无号和 3 次正常 Session
过期重建;第 36 次发生一次 PageDisconnectedError,随后新 Chrome/CDP 启动
抛出 BrowserConnectError,程序安全退出。这个证据同时证明两点:
因此本地 soak 的重认证模型调整为与 Sentinel 相同的“生命周期内持续重建”:
max_session_attempts=0,表示不设错误的固定总次数上限;BrowserConnectError 允许等待 60 秒后重试一次,连续第二次失败停止;--max-session-attempts 时仍可施加更严格的人工总上限。加速 24 小时测试让 Session 按 660 秒周期正常过期,实际经历至少 96 次过期与
重新认证后仍运行到 86,400 秒并 exit 0;另有独立测试证明密集重登、连续过期、
连续浏览器连接失败分别熔断。更新后的 Italy 回归共 110 项,全部通过,exit 0;
生产 sentinel.py、booker.py、vfs_plugin.py、bls_plugin.py 和通用类型均未
修改。
切换到新实现后的真实验证(2026-08-28):新任务从零开始运行;前 6 次 Query
均为已知无号。第 7 次探测明确抛出 SessionExpiredOrInvalidError 后,旧 Session
cleanup 成功,等待 60 秒,自动登录到 /UserArea 并创建 Session 2;紧接着第
8 次 Query 成功返回已知无号。状态快照随后显示:state=running、
session_attempts=2、session_expirations=1、
consecutive_session_expirations=0、browser_connect_failures=0。由此真实验证了
“过期 → 清理 → 有界等待 → 重新认证 → 继续 Query”的完整闭环;24 小时终态仍
需由正在运行的真实任务到时确认。
本文对应的早期 Gate 已由香港 E42 证据闭环取代。下一步不再沿用“禁止进入 Calendar”的旧调查路径,而应转到当前规范 R3 的 D0、Q-CAL、SLOT-POS、FINAL 和 PROD Gates。任何新的开发、测试或上线判断都必须以当前规范为准。