# 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 用户手册描述的顺序是: ```text 填写服务表单并接受隐私条款 → AVANTI → Calendar → 选择日期与时间 → PRENOTA → 注册邮箱收到 OTP → 输入 OTP 并点击 OK → 显示预约摘要、预约编号和二维码 ``` 手册同时说明,不同领馆和不同服务的字段会变化。因此我们复用 VFS/BLS 的流程骨架,但不能复制它们的网站字段。 来源: - [Prenot@Mi 官方用户手册 V2.0](https://consstoccarda.esteri.it/wp-content/uploads/2023/08/ManualeCittadino_2.0.pdf) - [意大利驻都柏林大使馆签证说明](https://ambdublino.esteri.it/en/servizi-consolari-e-visti/servizi-per-il-cittadino-straniero/visti/) ### 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 已经提供目标形态: ```text 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 第三层:信号链路——直接复用 现有链路: ```text 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 已存在以下结果: ```python 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 在触发任务时设置: ```text task.next_run = now + booking_cooldown ``` Italy 当前 `signal_ttl=30s`,但 `booking_cooldown=10s`,同一个信号理论上可能被重复消费。首版不新造原子 claim,只使用现有配置能力: ```text signal_ttl = 30s booking_cooldown = 45s target_instances = 1 query_wait.random_min = 60s ``` 机械约束: ```text 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 直接复用这条顺序: ```text 收到弱信号 → 用户 Session 中重新 GET service 1321 → 重新读取 bookingForm → 提交 AVANTI → 重新读取 Calendar → 重新读取当日 TimeSlot → 应用用户日期偏好 → 使用当前 slot 继续 PRENOTA ``` Italy 不读取 Query 账号的 Cookie、页面对象或临时参数,也不依赖 Query 的日期。 ### 4.7 第七层:OTP——直接复用 VFS/BLS 基建 VFS/BLS 都使用: ```python 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` 继续填充现有字段: ```text 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. 最终目标数据流 ```text 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 通过后只改成: ```python 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 主流程 ```text 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 的方法拆分风格,在同一类中新增或重写: ```python _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。 完成标准: ```text 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:受控启用 ```text 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`,避免下一轮卡死。 验证记录: ```text .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 重查,观察到: ```text 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,并要求先在管理端核实再决定是否重试。 ```text 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): ```text 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/`,从未出现登录表单,也从未进入 Query,最终 exit 1 且 cleanup 成功。按“同类错误最多两次”停止真实重试。 代码审查确认:每个 Italy 插件实例原先都使用带随机 instance id 的 `data/temp_browser_data/.../user_data`,cleanup 时完整删除。因此成功登录所 获得的 Cookie、Radware 客户端状态和浏览器上下文不能被下一个本地 Query 进程复用。这不证明持久化一定能通过 Radware,但证明原调试流程会主动丢失 刚获得的会话连续性。 本阶段增加以下边界: - 本地 Query 账号使用 `data/ita_query_profiles/`;路径不包含账号 明文,根目录和账号目录在 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): ```text python tools/debug_ita_session.py --local-query-account --non-interactive Browser profile mode=persistent 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): ```text 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 阶段的本地适配器: ```text 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 账号: ```bash # 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`。过期信号、目标不匹配和双消费者竞争也有 独立测试。 验证记录: ```text .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 链接数和目标链接数,不采集服务文本、账号或页面字段值。 离线验证记录: ```text .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 分钟短测记录: ```text 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。任何新的开发、测试或上线判断都必须以当前规范为准。