ita_plugin_recovery_design.md 47 KB

Italy 插件修复设计:VFS/BLS 复用优先版(历史记录)

文档状态: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 或执行真实预约。


0. 本阶段完成标准

本文满足以下条件才算完成:

  1. 从进程架构、账号模型、信号、插件生命周期、Query、Book、OTP、结果类型到测试,逐层说明复用 VFS/BLS 的哪一部分;
  2. 每个“新增设计”都有证据证明现有 VFS/BLS 无法表达;
  3. 首版修改范围被限制在 Italy 插件、Italy 配置、Italy 测试和调试工具;
  4. 每个未知网站行为都有真实验证 Gate;
  5. 不包含密码、Cookie、Token、OTP、个人资料或第三方密钥值。

本版明确撤回上一版的以下首发设计:

  • 不新增 Signal v2;
  • 不新增 availability episode;
  • 不新增 Redis 原子 claim;
  • 不新增通用工作流引擎;
  • 不创建 plugins/ita/ 子包;
  • 不修改 VSQueryResult、AvailabilityStatus、Sentinel、Booker、Standalone 或 Redis 客户端;
  • 不把 Italy 修复升级为框架重构项目。

这些能力未来只有在现有 VFS/BLS 机制被真实证据证明不够用时,才作为独立改进提案讨论。


1. 一句话结论

首版 Italy 应完整复用现有闭环:Sentinel + 内置 Query 账号池 → VSQueryResult → Redis 30 秒信号 → OrderBooker 用户热 Session → plugin.book();Query 用 BLS 已存在的“成功触发但没有具体日期”表达法发弱信号,Book 用 VFS 的“在自己 Session 中重新加载、重新查 Calendar/TimeSlot、再提交”的方法完成预约,Italy 只实现 Prenot@Mi 特有的页面选择器、表单、Calendar、PRENOTA 和 OTP 顺序。

用人话说:

  • 大架构不改:继续使用项目现成的 Sentinel/Booker 接力;
  • 账号模型不改:Query 是团队账号池,Book 是订单里的用户账号;
  • 信号协议不改:继续写 vs:signal:{routing_key};
  • 数据类型不改:继续用 VSQueryResult、DateAvailability、TimeSlot、VSBookResult;
  • OTP 基建不改:继续调用现有 VSCloudApi.fetch_mail_content();
  • 只写网站适配:修正 Italy 自己的 Query 和 Book。

2. 合规前提

项目方已经确认:

  • VFS/BLS 的整体技术方案属于允许复用的合规实现;
  • Query 池账号属于不同真实团队成员,已经明确授权;
  • Book 使用最终用户自己的真实账号。

本文把这三点作为业务前提,不再重新设计另一套账号或合规体系。

Italy 仍要保持与现有方案一致的身份边界:Query 账号只发现机会,用户账号完成属于自己的预约;不跨账号复制 Cookie、Session、CSRF 或页面状态。


3. 已验证事实与仍待验证事实

3.1 已验证

事实 证据 确信度
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 高

3.2 官方业务顺序

官方 Prenot@Mi 用户手册描述的顺序是:

填写服务表单并接受隐私条款
  → AVANTI
  → Calendar
  → 选择日期与时间
  → PRENOTA
  → 注册邮箱收到 OTP
  → 输入 OTP 并点击 OK
  → 显示预约摘要、预约编号和二维码

手册同时说明,不同领馆和不同服务的字段会变化。因此我们复用 VFS/BLS 的流程骨架,但不能复制它们的网站字段。

来源:

3.3 仍待真实验证

  • Query 账号进入表单时,用户账号能否在 30 秒内进入同一表单;
  • bookingForm 当前 action、method、字段、Tourism 选项和文件要求;
  • AVANTI 的真实请求及副作用;
  • Calendar 日期和 TimeSlot 的真实数据来源;
  • PRENOTA 是否正好触发一次预约 OTP;
  • OTP 提交请求和成功页面结构;
  • 如何从预约摘要或 /Reservation 读取预约编号;
  • 哪一个只读页面适合 Italy keep_alive()。

4. 从大到小的复用矩阵

4.1 第一层:进程与角色架构——直接复用

能力 现有实现 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。

4.2 第二层:账号模型——复用 BLS

BLS 已经提供目标形态:

Sentinel.account_source = built-in
Booker.account_source   = order

Italy 当前配置本来就是:

  • Sentinel 从 ie.it.sentinel 账号池取 Query 账号;
  • OrderBooker 从订单 user_inputs.username/password 创建用户 Session;
  • target_instances=1 表示同一 routing key 只维持一个用户热实例。

因此不新增 AccountProvider,不新增账号对象,也不把邮箱加进 VSAccount。Prenot@Mi 登录名本身就是注册邮箱,OTP 查询沿用 VFS/BLS 的 self.config.account.username。

4.3 第三层:信号链路——直接复用

现有链路:

plugin.query()
  → result.success=True
  → Sentinel 写 vs:signal:{routing_key}
  → TTL 30 秒
  → OrderBooker 读取并反序列化 VSQueryResult
  → task.instance.book(query_result, user_inputs)

Italy 原样使用:

  • Redis key 不变;
  • payload 不变;
  • TTL 不变;
  • trigger loop 不变;
  • 不增加 event ID;
  • 不增加 claim key;
  • 不修改 Sentinel/Booker。

4.4 第四层:弱信号表达——复用 BLS 已有语义

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 后再判断。

4.5 第五层:重复触发控制——复用现有 cooldown

现有 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 设计,而不是现在预设。

4.6 第六层:Book 内重新查询——复用 VFS

VFS 的核心纪律是:Query 的日期只是起点;Book 在自己的 Session 中重新加载配置、查询 Calendar、查询 TimeSlot,最后提交当下仍存在的 slot。

Italy 直接复用这条顺序:

收到弱信号
  → 用户 Session 中重新 GET service 1321
  → 重新读取 bookingForm
  → 提交 AVANTI
  → 重新读取 Calendar
  → 重新读取当日 TimeSlot
  → 应用用户日期偏好
  → 使用当前 slot 继续 PRENOTA

Italy 不读取 Query 账号的 Cookie、页面对象或临时参数,也不依赖 Query 的日期。

4.7 第七层:OTP——直接复用 VFS/BLS 基建

VFS/BLS 都使用:

VSCloudApi.Instance().fetch_mail_content(...)

Italy 也使用该 API,并复用这些行为:

  • 以发送前 UTC 时间作为 sent_at;
  • 使用注册邮箱 self.config.account.username;
  • 按 sender、recipient、subject/body keyword 过滤;
  • 在有限窗口内等待;
  • 正则提取验证码;
  • 没有验证码时抛 NotFoundError/BizLogicError。

Italy 只需真实验证自己的 sender、subject、验证码位数和有效期。不新增 OtpProvider、邮箱服务或消息队列。

安全修正仍属于 Italy 必需实现:不打印 OTP,不把邮件正文写入日志。

4.8 第八层:结果——复用 VSBookResult

继续填充现有字段:

success
account
urn             ← Prenot@Mi 预约编号
book_date
book_time
label

不新增新的通用结果类。Italy 成功条件为:预约成功摘要或 /Reservation 中能读取到预约编号、日期和时间;不能只看 HTTP 200。


5. 明确不复用的内容

最大化复用不等于复制网站私有细节:

内容 为什么不能复用 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

原则:复用控制结构、基础设施和类型;网站协议只认真实证据。


6. 最终目标数据流

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

7. Italy Query 的最小实现

7.1 保留当前已验证逻辑

  1. 每轮先加载 /Services,清除旧弹窗状态;
  2. 按精确 path /Services/Booking/{service_id} 找入口;
  3. 每轮最多导航一次;
  4. 回到 /Services 且 marker/已知 notice 非空,返回无号;
  5. 未知弹窗、未知 path、登录失效继续 fail-closed。

7.2 唯一功能增量

当前代码在出现 #bookingForm 时抛安全异常。Gate 通过后只改成:

result.success = True
result.availability_status = AvailabilityStatus.NoneAvailable
result.earliest_date = None
result.availability = []
return result

Query 到此结束,仍然禁止填表、AVANTI、Calendar、日期/时间、PRENOTA 和 OTP。

7.3 Query 账号池

直接使用现有 Sentinel pool:

  • target_instances=1;
  • 使用现有全局 query gap 和 query_wait;
  • 429/挑战时使用现有账号锁定和 backoff;
  • Query 账号必须属于 Dublin 且能看到 1321;
  • 增加账号只用于轮换,不增加单位时间 Query 总数。

首版不做 release-time 预测。判断“什么时候可能有号”的方式,是观察门禁从无号回退变成允许进入表单。


8. Italy Book 的最小实现

Book 保持和 VFS/BLS 一样:一个 book() 主流程 + 若干站点 helper,仍位于 plugins/ita_plugin.py。

8.1 主流程

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

8.2 Helper 设计

沿用 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 字符串用于脱敏诊断。

8.3 表单处理

复用 VFS/BLS 的实时读取原则:

  • hidden token 从当前用户页面读取;
  • fields/options 从当前表单读取;
  • user_inputs 只映射到已验证字段;
  • 新必填字段出现时停止,不猜默认值;
  • 文件通过真实 file input 或已验证请求提交;
  • 删除当前 Italy 代码中猜测的固定字段 ID、Reason 值和文件字段名。

8.4 Calendar 与日期偏好

复用 VFS Book 模式:

  • 弱信号没有日期,从当前 Calendar 读取;
  • 按用户日期范围过滤;
  • 对候选日期重新查询 TimeSlot;
  • 一个日期没有时间就继续下一个;
  • 最终使用 Book Session 刚取得的 slot ID。

8.5 OTP

复用 VFS/BLS:PRENOTA 前记录 UTC 时间;PRENOTA 一次;用 Cloud API 查 sent_at 之后的匹配邮件;OTP 一次提交;全程不输出 OTP。

首个真实 Canary 可以先由用户手工输入 OTP;自动读取只在 Italy sender/subject/格式验证后打开。

8.6 成功与重试

成功必须取得预约编号、日期和时间。HTTP 200、收到 OTP、看到 Calendar 或发出 PRENOTA 都不算成功。

操作 自动重试
Session/Services 只读 GET 最多再试 1 次
Calendar/TimeSlot 只读查询 最多再试 1 次
表单填写但未提交 可重建 1 次
AVANTI 不盲重试
PRENOTA/发送 OTP 不重试
OTP 提交 不重试

写操作结果不明时检查当前页面和 /Reservation;仍不明就返回失败并人工处理。首版不新增 Redis 状态机。


9. Session 与 keep_alive

create_session() 继续使用已真实验证的 Italy 登录,不复制 VFS JWT/BLS 登录。

keep_alive() 复用 Booker 的现有定时调用,只寻找一个 Prenot@Mi 只读实现。候选依次为 /UserArea、/Services、已观察到的轻量认证请求。

通过标准:连续覆盖两个 session_max_life 周期,Session 有效,Network 无预约业务写请求,429/challenge=0。


10. 完整假设验证方案

10.1 P0:不通过就不实现对应步骤

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 有副作用即废弃

10.2 P1:上线前关闭

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

11. 文件级修改方案

首版只允许修改:

文件 修改内容
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 插件。

如果研发发现必须修改这些文件,先停止,提交“现有能力无法复用”的复现测试,再申请扩大范围。


12. 实现顺序

Change Set 1:Query 弱信号与 cooldown

  • bookingForm 返回 BLS 式弱信号;
  • Italy cooldown 改为 45 秒;
  • 离线证明 30 秒信号只调用一次 Book;
  • 调试 Query 只报告,不执行 Book。

完成标准:

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

Change Set 2:用户 Session 重查与表单解析

用户 Session 重进 1321,动态读取表单,默认停在 AVANTI 前;未知字段 fail-closed。

Change Set 3:AVANTI、Calendar、TimeSlot

P0-05/06/07 通过后实现;默认停在 PRENOTA 前。

Change Set 4:PRENOTA 与 OTP

P0-08/11 通过后实现;默认停在 OTP submit 前。

Change Set 5:最终预约

用户明确授权后,OTP submit 一次,解析摘要/Reservation,返回 VSBookResult。


13. 测试矩阵

场景 期望结果 写调用约束
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。


14. 真实网站 Gate

Gate 0:批准复用优先设计

接受现有 Sentinel/BLS/OrderBooker 信号语义;接受首版单 Booker + cooldown;接受 Italy 单文件结构;后续每个副作用单独授权。

Gate 1:离线 Query 弱信号

Change Set 1 全部通过,不访问网站。

Gate 2:真实 Query Shadow

Booker 禁用;无号分支稳定;首次 EntryAccepted 只输出弱信号与脱敏 metadata;表单提交=0、OTP=0。

Gate 3:跨账号与表单

完成 P0-02/03/04/05;用户账号只进入表单,不提交。

Gate 4:AVANTI + Calendar

逐次授权,停在 PRENOTA 前,完成 P0-06/07。

Gate 5:PRENOTA + OTP

授权发送一次 OTP,停在 OTP submit 前,完成 P0-08/11。

Gate 6:单用户真实预约

用户明确授权;OTP submit=1;摘要或 Reservation 取得编号、日期、时间;Cleanup OK;日志敏感值=0。

Gate 7:受控启用

Sentinel target_instances = 1
Booker target_instances   = 1
booking_cooldown          = 45
signal_ttl                = 30
query_wait.random_min     = 60
有效 Italy OrderBooker 部署数 = 1
kill switch 已验证

15. 可行性与确信度

能力 可行性 确信度
登录 已实现并真实验证 高
无号识别 已实现并真实验证 高
EntryAccepted 弱信号 直接复用 BLS 表达 中;缺真实有号样本
Query/用户账号接力 直接复用 BLS 架构 中;缺同窗验证
用户热 Session OrderBooker 已提供 中高
Calendar/TimeSlot 复用 VFS Book 模式 低;缺 Italy 协议
OTP 复用 VFS/BLS 基建 中;缺 Italy 邮件证据
最终预约 流程清晰 低;缺真实 Canary

当前可以高信心进入 Change Set 1 的离线实现;不能编写 Calendar、OTP 和最终提交,因为对应 Italy 网站证据尚不存在。


16. 初见审查

反驳 1:“现在真的做到最大化复用了吗?”

回应:首版不修改 Sentinel、Booker、Redis、通用类型、接口或插件工厂;直接使用 BLS 的账号拆分与弱信号语义、VFS 的 Book 内重查、两者共有的 OTP Cloud API。运行代码只改 Italy 插件和 Italy cooldown 配置。不能复用的只剩 Prenot@Mi 自己的网页协议。

反驳 2:“success=True + NoneAvailable 不直观,为什么仍采用?”

回应:这是 BLS 已有且能被当前 Sentinel/Booker消费的表达:success 控制触发,NoneAvailable 表示没有具体日期。Italy 的 EntryAccepted 恰好也是“值得重查但没有日期”。为了复用现有协议,首版接受这个约定,用测试固定语义,不在 Italy 修复中重构通用模型。

反驳 3:“不用原子 claim,会不会重复预约?”

回应:首版部署约束是单 Italy OrderBooker、target_instances=1,并让 booking_cooldown=45s 大于 signal_ttl=30s。离线测试必须证明同一信号 book_call_count=1。只有未来需要多节点并发且该约束失效时,才讨论原子 claim。

反驳 4:“为什么 Book 仍要重查?”

回应:Sentinel 与 OrderBooker 本来就是不同插件实例、账号和 Session。VFS 已给出正确做法:Book 在自己的 Session 中重新查询当前 Calendar/TimeSlot。

反驳 5:“为什么不复制 VFS/BLS 的 endpoint 和表单代码?”

回应:复用的是框架和控制结构,不是第三方网站私有协议。复制别的网站 payload 不是复用,而是制造不可验证的硬编码。


17. 实施状态与下一 Gate(2026-08-27)

17.1 已完成:Change Set 1

  1. bookingForm 返回 BLS 式弱信号:success=True + NoneAvailable;
  2. Italy booking_cooldown 从 10 秒调整为 45 秒;
  3. 离线证明 30 秒保留信号只触发一次现有 OrderBookerGCO;
  4. Query 调试器只调用一次 query(),调用 book() 次数为 0;
  5. 未修改 Sentinel、Booker、Redis、通用类型或 VFS/BLS。

17.2 已完成:Change Set 2 的离线安全部分

  1. 删除 Italy 旧 book() 中未经网站证据支持的 OTP、硬编码表单、文件上传和最终确认实现;
  2. book() 在用户自己的 Session 中复用 query(),重新进入 1321;
  3. 用户重查无号时返回 VSBookResult(success=False);
  4. 用户重查进入 bookingForm 时,只读取不含字段值的结构 metadata,并停在 AVANTI 前;
  5. 新增 tools/debug_ita_book.py:单次 Book 重查,book_attempt=1,submit_attempts=0;--arm 可先登录停在 /UserArea,收到 Query 弱信号后再按 Enter;等待期间按 Ctrl+C 会以 book_attempts=0 清理退出,不打印 traceback;
  6. Query 和 Book 均允许从上一次 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 导入。

17.2.1 真实单账号 Book 重查证据(2026-08-27)

用户在 --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 失效, 在取得网站证据前不采用该测试方式。

17.2.2 Query 账号池接入准备(2026-08-27)

已确认 Sentinel 从 ie.it.sentinel 调用现有 /api/account/next,现有账号写入口 为 /api/account/add。VFS 注册脚本中的旧上传函数会输出账号标识并带 VFS 专用 metadata,因此没有直接用于 Italy。

新增 tools/add_ita_query_account.py,约束如下:

  • pool 和 service 固定为 ie.it.sentinel / 1321;
  • 默认只做本地 preflight,不读取凭据、不发请求;
  • --apply 才允许一次 POST,自动重试次数为 0;
  • username、password、API Token 不接受命令行参数,也不写日志;
  • 传输结果不确定时 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 尚未调用,等待单独授权。

17.2.3 本地 Query 调试账号(2026-08-27)

本地调试阶段优先读取 config/ita_query_account.local.json,供 tools/debug_ita_query.py、tools/debug_ita_monitor.py 以及登录调试器显式的 --local-query-account 模式使用:

  • 文件存在且有效:使用其中的 username/password;
  • 文件不存在:保留原环境变量或隐藏输入方式;
  • 文件存在但无效:安全停止,不回退另一个账号;
  • tools/debug_ita_book.py 不读取该文件,仍使用用户账号;
  • 不修改 Sentinel、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。

17.2.4 有界本地 Query 监控器(2026-08-27)

新增 tools/debug_ita_monitor.py,只在本地 Discovery 阶段使用:

  • 默认执行为零网络 preflight,必须显式传 --run 才访问网站;
  • 复用 debug_ita_query.py 的本地账号、登录配置、Query、弱信号分类、表单 结构脱敏和失败诊断;
  • 一次进程只创建一个登录 Session;
  • 默认最多探测 10 次,间隔在 60–300 秒之间随机;最小值禁止低于 60 秒;
  • 每次无号才进入下一次等待;真实弱信号、未知非空结果或任何异常均立即停止;
  • 弱信号输出终端响铃及 action=start-user-book-recheck-now,不自动调用 Book;
  • Ctrl+C 返回 130 且执行 cleanup,不输出 traceback;
  • 不依赖 Redis,不调用 Book、AVANTI、Calendar、OTP 或最终确认。

离线验证:监控器及 Italy 回归共 74 项测试通过,exit 0。真实循环尚未启动; 没有因为新增监控器而产生网站请求。

17.2.5 Radware 证据与本地 Query 持久化 Profile(2026-08-27)

真实监控第一次在 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,但证明原调试流程会主动丢失 刚获得的会话连续性。

本阶段增加以下边界:

  • 本地 Query 账号使用 data/ita_query_profiles/<account-hash>;路径不包含账号 明文,根目录和账号目录在 POSIX 上强制为 0700;
  • 目录被 .gitignore 忽略,Profile 只保存在本机;
  • Query 单次调试、Monitor 和登录调试器的显式 --local-query-account 模式 复用同一 Profile;
  • Book 调试器和生产默认配置不传 Profile,仍使用并删除临时目录;
  • 持久化 Profile 使用非阻塞文件锁,同一账号同一时刻只允许一个插件实例;
  • validate.perfdrive.com 被明确分类为 ItaAuthenticationChallengeError,动态 challenge path 在日志中脱敏;
  • 挑战只报告并停止,不刷新、不自动重试、不调用验证码服务,也不改变 IP 或 浏览器指纹来规避网站控制。

离线回归共 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。

17.2.6 本地弱信号到用户 Book 的一次性交接(2026-08-27)

生产链路已经由 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 的账号,并在真实开放窗口出现后,才执行上述两个终端命令。

17.2.7 本地 24 小时 Query 稳定性验证(2026-08-28)

新增 tools/debug_ita_soak.py,用于在接入生产 Sentinel 之前完成一天的本地 稳定性验证。它复用现有 Query 本地账号、持久化 Profile、ItaPlugin.query() 和弱信号判断,不新增第二套生产调度器,也不连接 Redis:

  • 默认只做零网络 preflight,显式 --run 才访问网站;
  • 以持续时间而非探测次数结束,默认且最长为 86,400 秒;
  • 同一已认证 Session 内每 60–300 秒随机探测一次;
  • 只有明确的 SessionExpiredOrInvalidError 才允许清理并重建 Session,重建前 至少等待 60 秒;正常过期不再受固定总次数限制,由 86,400 秒任务时长约束;
  • 连续两次新 Session 未成功 Query 就过期,或一小时内出现超过 6 次重新认证, 立即熔断,避免把异常认证循环放大;
  • /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,程序安全退出。这个证据同时证明两点:

  1. Prenot@Mi 的真实 Session 生命周期约为 20–30 分钟,固定 12 次上限不可能 支撑完整一天;
  2. 自动重新认证必须覆盖一次临时 Chrome/CDP 启动失败,但不能无限启动浏览器。

因此本地 soak 的重认证模型调整为与 Sentinel 相同的“生命周期内持续重建”:

  • 默认 max_session_attempts=0,表示不设错误的固定总次数上限;
  • 每次明确过期后等待至少 60 秒,再使用同一授权账号和私密 Profile 登录;
  • 正常 Query 成功后,连续过期计数归零;连续第二次未成功 Query 就过期则停止;
  • 滚动一小时最多允许 6 次重新认证,第 7 次停止;
  • 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 小时终态仍 需由正在运行的真实任务到时确认。

17.3 历史终点与当前去向

本文对应的早期 Gate 已由香港 E42 证据闭环取代。下一步不再沿用“禁止进入 Calendar”的旧调查路径,而应转到当前规范 R3 的 D0、Q-CAL、SLOT-POS、FINAL 和 PROD Gates。任何新的开发、测试或上线判断都必须以当前规范为准。