状态:CS3A VERIFIED(一次负责人现场回传);CS3B / OTP-AUTO 邮箱接入列为待办,暂缓
修订:2026-08-30 / R5(保留 R3/R4 的设计与历史验证记录)
当前 Query 恢复合同:CS3R:掉线恢复与持续盯号。本地实现、387 项 Italy 回归及零网络预检已验证;E51 的 15 分钟实测已通过(909 秒、3 次查询、1 次受控恢复、exit 0,版本指纹一致)。真实认证过期及 2/24 小时现场证据待补。自动处理重新需要 OTP 仍是必须完成的 ITA-OTP-01,不以人工停止点代替完成。CS3R 不授权上线或 Book 最终提交。
唯一事实源:Italy Discovery
历史实现记录:Italy Recovery Design
约束:香港是第一条正向协议样本,不是代码分支;Dublin 是无号回归样本,不是默认产品目标。CS3A 的人工准备加两次生产 Query 已通过一次现场验收;负责人确认 Query 邮箱尚未接入并授权云邮箱 API,要求记为待办。当前不执行邮箱接入、新的 OTP、真实取信、共享框架修改或最终预约。
D0 只完成设计审查。以下条件必须同时满足,缺一项都不能说“方案完成”:
2026-08-29 负责人随后明确批准 R3、CS1 和 CS2。该批准不改写 D0 的历史完成标准;CS1/CS2 的实际文件、测试和边界记录在 §17、§23.2 与 §23.3。
旧方案只有一半正确。
正确的一半是:
团队账号负责发现
→ Sentinel 发布短 TTL 信号
→ 用户账号自己的热 Session 收到信号
→ 用户账号重新检查
→ 只使用当前 Session 的日期、时间和动态状态完成预约
不正确的一半是:把“能进入 bookingForm”当成足够好的生产信号。
香港已经真实证明两件必须同时记住的事:
GET /Services/Booking/4937
→ 200 + bookingForm
→ OTP + AVANTI
→ Calendar
├─ 默认 2026-08 窗口:日期/时段均为负向
└─ 向后到 2026-10:出现真实正向日期与时段
Availability:SlotLiberi=1 / SlotRimanenti=0
TimeSlot:普通 fascia、无红点、显示 (1)
所以,bookingForm 只表示“门开着”,不携带日期、扫描范围和容量;它既不能单独证明有号,也不能单独证明无号。若 Sentinel 每 60–300 秒都把这个弱事实发给用户 Book,用户账号会反复发送 OTP,却仍不知道目标日期范围内是否有 Slot。这既不能可靠回答“什么时候有号”,也不珍惜真实机会。
R3 的推荐方案是:
团队 Query 账号
├─ 每个认证/业务 Session 至多一次:
│ 原生选择单人 + 旅游 → Privacy → OTP → AVANTI
│ 进入自己的 Calendar Session
│
└─ 后续每个 Query probe:
在配置日期范围内逐月读取 Availability
→ 不能因默认月份无号提前结束
→ 至少一个正向日期才返回 Available
→ times 保持空;不把动态 Slot 状态跨账号传递
Sentinel
→ 原样发布 VSQueryResult Available 强信号
用户 Book 账号
→ 独立登录、独立 OTP、独立 Calendar
→ 重查同一服务、日期和时段
→ 满足全部提交前不变量后
→ 原生点击一次 btnPrenotaNoOtp
→ 只读核对预约结果
这叫“准备型 Calendar Query”。它复用 VFS/BLS 已有的最小强信号:Query 发布真实日期,DateAvailability.times=[],Book 在自己的 Session 重新查具体时段;也复用现有账号池和信号链路。Query 不主动为每个日期扇出 TimeSlots 请求,页面原生自动产生的 TimeSlots 只作为诊断,不作为信号前提。它比旧弱信号多一次团队账号的 OTP + AVANTI 副作用,因此必须经过单独授权和无预约副作用 Gate。E43 已用同日 TimeSlots 交叉证明 Availability 的正向 1/0 确实对应一个真实时段,但没有替这些安全 Gate 背书。
旧弱信号仍有价值,但只用于 Discovery、告警或手工唤醒,默认不得触发生产 Book。
外部网站、自然放号和网络永远不受本项目 100% 控制。把这种不确定性口头改成“有信心”是不诚实的。
本方案把 100% 定义成分阶段准入:
| 阶段 | 达到 100/100 的机械条件 | 当前状态 |
|---|---|---|
| 设计一致性 | 本文无内部矛盾;P0/P1 全部有关闭路径;检查 exit 0 | 已验证 D0 |
| CS1 配置与纯解析器 | 只实现已观察 schema;全部离线 fixture 通过;网站写请求 0 | 已验证:28 个协议测试 + 30 个现有 Italy 回归测试 |
| CS2 通用路线接线 | Plugin、配置和本地工具只从 routing key 解析 route;HK/Dublin 同路径;网站请求 0 | 已验证:137 个相关离线测试 + 静态扫描 |
| 强 Query | 团队账号准备 Calendar 被单独授权;预约列表前后不变;重复只读 probe 无 OTP/AVANTI/最终 POST | 外部 Gate |
| Book 到最终按钮前 | 用户 Session 的 OTP、AVANTI、Calendar、正向 Slot 合同全部真实验证;最终 POST=0 | 外部 Gate |
| 一次最终 Canary | 用户明确需要该真实预约;preflight 全绿;InsertNewBooking 次数=1;结果可权威核对 | 外部 Gate |
| 生产准出 | 端到端 Canary 成功;异常响应和重启恢复不重复提交;第二 Sede 同协议验证 | 外部 Gate |
纪律是:某阶段没有达到 100/100,就不进入该阶段的有副作用动作;不是把总置信度四舍五入成 100。
使用已明确授权的团队成员真实账号检测任意已配置 Prenot@Mi Sede 的单人短期申根旅游签证真实号源,并使用申请人自己的真实账号完成预约。
香港用于跑通第一条完整成功链;通用性由配置和第二 Sede 回归证明。
以下五项必须同时成立:
OTP 发送成功、AVANTI 302、进入 Calendar、看到正向日期、点击 PRENOTA、HTTP 200 都不能单独算成功。
Public / IAM
→ callback_1 + callback_2
→ /UserArea
→ /Services
→ /Services/Booking/{service_id}
├─ Dublin 1321:302 → /Services + 明确无号 marker
└─ Hong Kong 4937:200 + bookingForm
→ single=1
→ tourism=42
→ PrivacyCheck
→ GET GenerateOTP:200 / SENT / 邮件送达
→ OTP 输入
→ 原生 AVANTI
→ POST /Services/Booking/4937:302
→ GET /BookingCalendar?...:200
→ Availability / TimeSlots
→ btnPrenotaNoOtp
→ POST InsertNewBooking
[从未执行]
关键纠正:
| 能力 | Method / Path | 已观察输入 | 已观察输出 |
|---|---|---|---|
| 日期 | POST /BookingCalendar/RetrieveCalendarAvailability | JSON:_Servizio、selectedDay | 外层 JSON 字符串,内层数组:DateLibere、SlotLiberi、SlotRimanenti |
| 时段 | POST /BookingCalendar/RetrieveTimeSlots | JSON:selectedDay、idService | 外层 JSON 字符串,内层数组;含两个 Slot 数量、时间和 daily ID |
| 最终预约 | POST /BookingCalendar/InsertNewBooking | form:idCalendarioGiornaliero、selectedDay、selectedHour | 静态观察含 errorMessage、url;真实结果未知 |
网站当前前端判定:
SlotLiberi>0 AND SlotRimanenti>=0 是 E43 已观察的正向组合;SlotRimanenti=0 不能判无号;1/0 显示 (1),负向 0/-1 显示 (0);plugins/ita_plugin.py 当前只实现:
尚未实现:
当前调试工具和大部分 fixture 仍硬编码 Dublin 1321。这属于待通用化的实现债务,不是通用设计。
| 层级 | 现有参照 | Italy 决策 | 复用程度 |
|---|---|---|---|
| 插件接口 | IVSPlg | 原样实现生命周期 | 100% |
| Query 调度 | SentinelGCO | 原样使用账号池、节奏和 Redis 发布 | 100% |
| 用户 Book | OrderBookerGCO | 原样使用 order 账号和热 Session | 100% |
| 账号边界 | VFS/BLS 集成方式 | Query built-in;Book order;状态不共享 | 100% |
| route 配置 | VFS/BLS apt_configs[routing_key] | Italy 从顶层单一 service_id 迁移到相同模式 | 100% |
| 强信号 | VFS/BLS Available + dates | 生产 Query 发布真实 Calendar 正向日期,times=[];Book 重查时段 |
100% |
| 弱信号 | BLS success=True + NoneAvailable + [] | 仅 Discovery/降级诊断,不作为生产精确检测 | 有条件复用 |
| Book 重查 | VFS Book 自己查 Calendar/TimeSlot | Italy 用户 Session 独立重查 | 100% |
| 日期范围 | VFS 的 Book 内过滤纪律 | 复用边界;改为确定性排序,不复制随机选择 | 规则复用 |
| OTP 邮箱 | VFS/BLS VSCloudApi.fetch_mail_content() | 复用 API;Italy 自己配置 sender/subject/regex | 100% 基建复用 |
| 结果 | VSBookResult | 原样填充现有字段 | 100% |
| 错误类型 | 现有 Biz/Session/RateLimit 类型 | 原样映射;Italy 增加站点内局部分类 | 100% |
| 浏览器 Network | USA/TLS 的 page.listen 一次监听 | 用于监听原生动作结果,不手写敏感 POST | 复用现有能力 |
| 最终恢复 | VFS/BLS 没有足够的模糊结果合同 | 先用 Prenot@Mi /Reservation 作为权威对账;失败才提框架扩展 | 需 Gate |
复用的是稳定控制结构:
账号池
→ Session
→ Query 事实
→ 标准结果
→ Redis 信号
→ 用户 Session 重查
→ 标准 Book 结果
不复制:
“最大化复用”不等于把别的网站偶然实现也当成规范。
旧方案建议所有逻辑继续塞进 ita_plugin.py。E22–E44 之后,这个选择不再成立:当前文件已经接近 1,000 行,新增协议又包含双层 JSON、两个 Slot 数量、跨月扫描、异步日期回退、重复 id、selected 一致性和一次性提交屏障。
推荐只新增一个小模块,不新增框架:
plugins/ita_plugin.py
Imperative Shell / Site Adapter
- IVSPlg 生命周期
- 浏览器和原生 DOM 交互
- page.listen
- OTP/AVANTI/最终点击
- 阶段编排和写屏障
plugins/ita_protocol.py
Functional Core
- route 配置校验
- 双层 JSON 解码
- CalendarDay / SlotCandidate 纯数据
- 日期范围过滤
- 候选排序
- precommit 不变量
- response 分类
- 不导入 DrissionPage,不访问网络
这样做的长期价值:
| 文件 | 职责 |
|---|---|
| plugins/ita_plugin.py | 站点适配、原生交互、一次性副作用和 IVSPlg |
| plugins/ita_protocol.py | 新增;纯配置/解析/选择/不变量 |
| config/config_sentinel.json | 每 Sede 的 apt_configs、Query 模式和安全开关 |
| config/config_booker.json | 与 Sentinel 同一 route 合同、Book 模式和安全开关 |
| test/test_ita_protocol.py | 新增;E15–E44 纯协议/选择态 fixture |
| test/test_ita_plugin.py | 浏览器适配、写次数、错误和结果测试 |
| 现有 test/test_debugita*.py | 通用目标和安全停点回归 |
| 现有 tools/debugita*.py | 参数化 route;不复制香港工具 |
| docs/ita_plugin_discovery.md | 只记录事实,不承载未来设计 |
| 本文 | 唯一目标设计、Gate 和发布合同 |
首版禁止修改:
若实现被迫修改这些文件,当前 Change Set 立即停止,先提交最小失败测试和扩大范围理由。
唯一已知的潜在例外是最终提交的跨进程持久写屏障。当前 OrderBooker 的 tracker 是 心跳租约,云端 grabbed 状态又发生在成功结果之后;两者都不是“提交前已持久化”的 证据。Gate FENCE-1 会先验证现有任务 API 能否原样承载这个屏障。不能承载时,必须 另开一个最小框架 Change Set 并单独批准;在此之前 final 永久保持 disabled。
示意,不是本轮对生产配置的修改:
{
"query_mode": "calendar",
"final_submit_enabled": false,
"apt_configs": {
"slot.hkg.it.tourist": {
"service_id": 4937,
"capability": "single_schengen_tourism",
"calendar_scan": {
"lookahead_months": 3
},
"form": {
"booking_type_control_id": "typeofbookingddl",
"booking_type_value": "1",
"booking_type_labels": ["Prenotazione Singola", "Single booking"],
"purpose_control_id": "ddls_0",
"purpose_value": "42",
"purpose_labels": ["Turismo", "Tourism"]
},
"mail": {
"authorization_email": "<configured-outside-logs>",
"sender": "<gate-required>",
"subject_keywords": "<gate-required>",
"body_keywords": "<gate-required>",
"otp_pattern": "<gate-required>"
}
},
"slot.dub.it.tourist": {
"service_id": 1321,
"capability": "services_probe_only"
}
}
}
calendar_scan.lookahead_months 必须是正整数,并由产品日期窗口和 Q-CAL 实测校准;示例值 3 只用于表达“默认月份 + 后续月份”,不是全局常量。控件结构和值是主合同;本地化 label 只是第二重交叉检查。label allowlist 由 route 配置扩展,不把实现限制为中文、意大利语或英语,也不允许仅凭翻译文案继续提交。
首版每个运行组只服务一个 Sede。一个账号池只放属于该 Sede 的账号;扩容用于容错,不用于提高单位时间请求频率。
同一个 ItaPlugin 能处理多个 Sede,含义是“同一协议 + 不同配置”,不是“一个浏览器同时切换多个 Sede”。
| 模式 | 行为 | 信号 | 用途 |
|---|---|---|---|
| services_probe | 只进入服务入口;不发 OTP | bookingForm 只记录诊断 | Dublin 回归、Discovery |
| calendar | 团队账号每 Session 准备一次 Calendar;后续扫描只读 Availability | 至少一个正向日期才发 Available,times 为空 | 生产候选 |
services_probe 不得把 bookingForm 弱信号交给生产 OrderBooker。
每个 Query 插件实例、每个 route、每个认证 Session 至多执行一次:
Q0 AUTHENTICATED_USER_AREA
→ Q1 ROUTE_RESOLVED
→ Q2 SERVICE_ENTRY
→ Q3 BOOKING_FORM_VALIDATED
→ Q4 SINGLE_AND_TOURISM_SELECTED
→ Q5 PRIVACY_AND_TURNSTILE_READY
→ Q6 OTP_SENT_ONCE
→ Q7 OTP_RECEIVED_AND_ENTERED
→ Q8 AVANTI_SUBMITTED_ONCE
→ Q9 CALENDAR_READY
它不会选择最终日期/时段,也不会点击 btnPrenotaNoOtp。
这一步是团队账号的业务 Session 准备,不是普通只读 Query。必须由配置开关显式启用,且满足:
Calendar ready 后,每轮:
calendar_scan.lookahead_months 逐月驱动网站原生 Calendar;默认月份无号不能提前结束,但首个正向月份必须立即停止;page.listen,捕获当月 Availability response,并在 finally 停止监听;DD/MM/YYYY 00:00:00 严格归一化为内部日期;重复日期或冲突记录 fail-closed;SlotLiberi>0 AND SlotRimanenti>=0 的日期,并应用扫描范围;success=False/NoneAvailable;Available,earliest_date 与唯一一项 DateAvailability(date=earliest, times=[]) 指向同一天;不传播该月其他日期;为什么这里不要求 Query 先拿到具体时段:VFS/BLS 的稳定合同本来就是“Query 给日期,Book 重查时间”;E43 又证明 Availability 的正向容量与同日 TimeSlots 一致。这样少一次主动交互、少一批请求,也避免把转瞬即逝的动态时段误当成用户账号事实。
| 当前事实 | success | status | payload |
|---|---|---|---|
| 服务明确无号 | false | NoneAvailable | 空 |
| bookingForm 但未准备 Calendar | false | NoneAvailable | 只记录 stage,不发生产信号 |
| 完整配置范围内没有正向日期 | false | NoneAvailable | 空 |
| 首个正向月份至少一个 E43 合同的正向日期 | true | Available | 该月最早日期,times=[];不含 runtime/daily ID 或 token |
| Waiting List | 只有真实验证后 | Waitlist | 首版默认不支持 |
| 未知状态 | 异常 | 不伪造 | signal=0 |
VSQueryResult 快照只传播可公开的日期线索。daily calendar ID、Calendar runtime service ID、Cookie、OTP、DOM 对象和 Query 账号时段不进入 Redis。
Sentinel 只在 query_result.success=True 时写 Redis;to_snapshot_payload() 本身不保存 success,Booker 反序列化后该字段会回到默认 false,但 Booker 以“Redis 信号存在”触发,不再次检查 success。
首版不修改这个既有合同,但必须加回归测试固定它,避免以后误以为反序列化后的 success 仍为 true。
B0 TRIGGER_VALIDATED
→ B1 USER_SESSION_RECONCILED
→ B2 SERVICE_RECHECKED
→ B3 BOOKING_FORM_VALIDATED
→ B4 FORM_SELECTIONS_VALIDATED
→ B5 PRIVACY_AND_TURNSTILE_READY
→ B6 OTP_SENT_ONCE
→ B7 OTP_RECEIVED_AND_ENTERED
→ B8 AVANTI_SUBMITTED_ONCE
→ B9 CALENDAR_READY
→ B10 CURRENT_AVAILABILITY_RECHECKED
→ B11 CURRENT_SLOT_SELECTED
→ B12 PRECOMMIT_VALIDATED
→ B13 FINAL_CLICK_ONCE
→ B14 OUTCOME_RECONCILED
→ B15 VSBookResult
状态只存在于同一个插件实例的内存中,不创建新工作流服务。关键防重复标志:
这些标志只能防住同一进程内的重复动作,不能防住进程在最终点击附近崩溃后重启。 在 B13 前还必须有一个以 task/order + route 为键的持久 final-attempt fence。fence 必须 在点击前成功写入;重启看到 fence 后只能对账或人工处理,不能再次 final。
这保证的是 at-most-once:正常成功路径 final=1;任何 crash/timeout 路径 final<=1。 如果进程恰好在 fence 已写入、网站尚未收到请求时崩溃,宁可丢失这次机会,也不能 自动制造第二次不可逆提交。网站没有已观察到的 idempotency key,因此不能诚实承诺 同时做到“绝不重复”和“崩溃后绝不丢机会”。
Session 变化会清除页面临时状态,但在任何新的最终写动作前仍必须先做 /Reservation 对账。
每次 book() 开头先检查:
若已经存在预约,直接解析并返回成功;若存在持久 final-attempt fence 或结果未知, 只做对账,不重新提交。
这个步骤是发布 P0。当前 Booker 对 success=False 会在下一信号重试,单靠异常无法阻止进程重启后的重复写。 当前插件 book() 也没有显式 task_id 上下文,现有云任务更新只在成功后异步执行;因此 不能用插件内存、tracker TTL 或 grabbed 通知冒充持久 fence。
Book 操作可见控件并触发网站原生事件:
禁止直接给 hiddenTipoPrenotazione、numAccSelected、hiddenSelezionato_0 赋值。网页原生同步链本身就是协议的一部分。
顺序:
记录 UTC sent_at
→ 监听 GenerateOTP
→ 原生点击 otp-send 一次
→ 只接受 HTTP 200 + SENT
→ VSCloudApi.fetch_mail_content()
→ 只搜索 sent_at 之后的新邮件
→ 正则只返回验证码,不输出正文
→ 输入 otp-input
约束:
首个 Canary 可以人工输入 OTP;无人值守生产必须关闭邮件自动读取 Gate。
提交前:
执行:
Book 与 Query 使用同一纯解析器,但使用完全不同的浏览器 Session。
Book 忽略 Query 的 daily ID 和临时 DOM,只用 Query 的日期作为优先线索:
首版确定性策略:
不复制 VFS 当前的随机 shuffle/random choice。确定性选择更容易审计,也不会在同一输入下随机偏离用户意图。
| 操作 | 类别 | 同一阶段上限 | 结果不明 |
|---|---|---|---|
| /UserArea、/Services | 只读 | 同一错误最多 2 次 | 重建 Session |
| 服务入口 GET | 探测 | 每 probe 1 次 | 当前轮停止 |
| Calendar document/已证明只读 XHR | 只读 | 同一错误最多 2 次 | 当前轮停止 |
| DOM/纯解析 | 本地 | 可重算 | fail-closed |
| GenerateOTP | 外部命令 | 每 Session/attempt 1 次 | 禁止重发 |
| AVANTI form POST | 外部命令 | 每 Session/attempt 1 次 | 对账/停写 |
| date/slot 原生选择 | 页面状态 | 每候选 1 次 | 重新读 DOM |
| InsertNewBooking | 最终不可逆 | 每机会 1 次 | 只读对账 |
“同一错误最多两次”只适用于可证明幂等的只读操作。OTP、AVANTI、最终 POST 不因为报错而获得第二次机会。
E43 已关闭当前页面版本的零值语义,E44 已关闭安全点击后的唯一选择态;但二者仍不等于“可以最终提交”。解析器和 precommit 必须同时满足:
SlotLiberi > 0;SlotRimanenti >= 0;SlotLiberi > 0 且 SlotRimanenti >= 0;E43 的 1/0 必须判正向;仅以下任一项单独出现都不够:
不手写 InsertNewBooking 请求。先用纯逻辑批准 DOM 快照,再触发网站原生 btnPrenotaNoOtp:
当前静态合同:
response.errorMessage
response.url
真实成功 response、失败 response 和成功 URL 仍是外部 Gate。
listener 取得响应后:
只有服务器明确表示 Slot 已失效/请求失败,且 /Reservation 明确没有新记录,才返回可重试失败。不会在同一调用中重提。
包括:
处理:
final_submitted = true
outcome_unknown = true
durable_final_attempt_fence = present
→ 永久关闭当前实例的最终写入口
→ 只读 /Reservation
→ 找到唯一记录:成功
→ 明确无记录且协议允许:失败
→ 仍不确定:manual-reconciliation-required
下一次信号只允许再次对账。进程重启后每次 Book 开始仍先查 /Reservation。
重启后若 durable fence 存在,即使 /Reservation 暂时没有记录,也不得自动 final; 应在有界窗口内继续只读对账,超时后转人工。fence 何时归档、绝不能被普通失败路径 清除,必须由 FENCE-1 的状态迁移测试固定。
如果网站不能提供权威对账,现有 VSBookResult + Booker retry 无法安全表达未知结果;届时必须停止发布,再提出最小框架级 OutcomeUnknown/任务冻结扩展。不能在 Italy 内假装解决。
| 角色 | 账号 | Profile | 可以做什么 |
|---|---|---|---|
| Query | 已授权团队成员 | 每账号独占 | 准备自己的 Calendar;只读发现;不最终预约 |
| Book | 申请人自己 | 与 Query 完全独立 | 为自己的订单完成预约 |
一个 Profile 同时只能有一个浏览器实例;现有文件锁继续复用。
生产强信号沿用:
signal_ttl = 30s
booking_cooldown > signal_ttl
target_instances = 1
有效 Italy OrderBooker 部署数 = 1
强信号来自真实 Slot,不再每轮发送 bookingForm 弱信号。
OTP 的 120 秒冷却不能只靠 booking_cooldown=45 保护。插件自己的 attempt guard 必须阻止同一 Session 重发;如果仍在同一路由 Calendar,下一次 book() 直接重查 Calendar,不重新走 OTP。
当前 Italy 配置的 session_max_life=900 会主动每 15 分钟淘汰 Session。准备型 Query 若照搬,会每 15 分钟重新发 OTP。
不能猜一个更长值。Gate 必须测量:
生产配置使用已验证寿命的保守下界。账号数量不能被用来掩盖 Session 设计错误。
| 状态 | 结果 |
|---|---|
| 已验证无号/无正向 Slot | 正常 success=False |
| IAM 登录页或认证回跳 | SessionExpiredOrInvalidError |
| 429 | RateLimiteddError,当前实例停止 |
| 403/挑战 | 明确挑战/权限错误,不自动绕过 |
| 目标 route 缺失 | 配置或结构错误 |
| 未知弹窗/字段/schema | BizLogicError,signal=0 |
| OTP timeout | OTP 专用业务错误,不重发 |
| AVANTI 结果未知 | attempt 停写并对账 |
| 最终结果未知 | manual reconciliation,禁止重提 |
| ID | 假设 | 当前状态 | 机械关闭标准 | 失败动作 |
|---|---|---|---|---|
| P0-01 | IAM 自动登录可达 /UserArea | 已关闭 E9 | 真实 exit 0 + DOM 双标志 | Session 不可用 |
| P0-02 | Dublin 1321 无号分类安全 | 已关闭 E7/E12 | GET/302/marker;业务 POST=0 | 保留回归 |
| P0-03 | Hong Kong 4937 是单人申根旅游样本 | 已关闭 E14–E20 | service/form/single/tourism 唯一 | 不配 live route |
| P0-04 | bookingForm 能代表真实 Slot | 已否决 E15/E43 | 表单自身无日期、范围、容量;不能从某次后续有号外推恒真 | 禁止生产弱信号 |
| P0-05 | 团队账号准备 Calendar 不创建预约/候补 | 外部 Q-CAL-1 | OTP=1、AVANTI=1、final=0;Reservation 前后相同 | 否决准备型 Query |
| P0-06 | Calendar 重复 probe 是只读且稳定 | 外部 Q-CAL-2 | 连续 N 次;OTP/AVANTI/final=0;记录不变;无 429 | 不自动 probe |
| P0-07 | Query 正向日期对用户账号可传播 | 外部 Q-XACC | 3 个自然窗口 3/3;Book 在 TTL 内重查到可用时段 | 调整模型/不发布 |
| P0-08 | 用户 OTP + AVANTI 能进 Calendar | 已关闭 E21/E22 | OTP 1、POST 1、302、Calendar 200 | 不实现后段 |
| P0-09 | Cloud API 能唯一读取 Italy 新 OTP | 外部 OTP-AUTO | sent_at 后唯一命中;旧码=0;日志泄漏=0 | Canary 手工,生产禁用 |
| P0-10 | 正向 Slot 的两个数量和 DOM truth table 已知 | 已关闭 E43/E44 | response/DOM 一致;安全点击后唯一 active、后代、时间和日期一致 | 保留 final=0 回归 |
| P0-11 | precommit 能拒绝负向/冲突状态 | CS1 纯核心已关闭;CS4 接线时复验 | E23–E44 mutation fixtures 全通过 | 不进入 final |
| P0-12 | InsertNewBooking 真实 response 可分类 | 外部 FINAL-1 | 一次真实 Canary 收集脱敏 schema | 不发布 final |
| P0-13 | /Reservation 可权威对账 | 外部 FINAL-2 | 成功/失败/响应丢失均唯一判断 | 提框架 Unknown 状态 |
| P0-14 | 跨进程 durable fence 保证最终 at-most-once | FENCE-1 + CS5A + FINAL-2 | 正常 final=1;timeout/crash/restart final<=1;fence 后只对账 | 不发布 |
| P0-15 | 通用实现无 Sede 分支 | CS1–CS5 | HK 正向 + Dublin 负向同一路径;源码扫描=0 | 拒绝合并 |
| P0-16 | kill switch 真能阻止最终动作 | CS5 | final_submit_enabled=false 下 final=0 | 不进 Canary |
| ID | 条件 | 关闭位置 |
|---|---|---|
| P1-01 | 任一启用 locale/配置 label 不改变核心结构判断 | locale fixtures |
| P1-02 | 新 required 字段必然停在 OTP/AVANTI 前 | mutation fixture |
| P1-03 | Query/Book route 配置完全一致 | JSON contract |
| P1-04 | snapshot 不含临时 ID/secret | serialization scan |
| P1-05 | date fallback 被检测 | E30/E41/E42 fixtures |
| P1-06 | duplicate hidden id 不会取错 | active-descendant fixture |
| P1-07 | 1/0 正向、0/-1 负向,其他零/负数/冲突组合按 allowlist fail-closed |
E43 truth-table fixtures |
| P1-08 | 一个 retained signal 最多触发一次 Book | Booker offline integration |
| P1-09 | 订单 pause/cancel 不触发 Book | OrderBooker regression |
| P1-10 | Query 账号数增加不放大总频率 | cadence test + soak |
| P1-11 | Session/Calendar 寿命已校准 | Q-CAL-2 |
| P1-12 | Book p95 小于自然 Slot 可用窗口 | Q-XACC telemetry |
| P1-13 | 日志/异常/产物敏感命中 0 | security scan |
| P1-14 | 真实正向链外的未知页面 signal/final 都为 0 | mutation suite |
| P1-15 | 第二 Sede 按配置工作 | GEN-1 |
所有内部设计问题都已分配给 Change Set;所有网站未知都已分配给外部 Gate。不存在无验证路径的内部 P0/P1。
每个 Gate 的授权只覆盖该 Gate,不能继承到下一个副作用。
只评审设计。网站请求=0,代码修改=0。
前提:一个属于目标 Sede、已授权且邮箱可访问的团队账号。
动作:
通过:
GenerateOTP = 1
Booking form POST = 1
InsertNewBooking = 0
预约/候补新增 = 0
Calendar ready = true
2026-08-29 的 Q-CAL-1 受控执行尚未关闭本 Gate:
/Reservation 基线时发现空候补表不会初始化 DataTables;工具在进入
服务、OTP 和 AVANTI 之前停止。该读取假设已离线修正并通过回归。reservations=0, waitlist=0,但当前认证账号的 Services 页面
没有目标 /Services/Booking/4937。页面结构为 8 个数据行、7 个预约链接,目标链接数为
0;工具在 OTP、AVANTI 和 Calendar 之前 fail-closed。GenerateOTP、Booking Form POST 和 InsertNewBooking 均为 0;没有新增预约
或候补。第二次输出只能证明“当前账号所在 Sede 与 Hong Kong 4937 路由不匹配”,不能仅凭
行数把当前 Sede 名称事实化为 Dublin。/Services/Booking/4937,确认 form action 仍为同一路径,Booking Type、Purpose、OTP、
Privacy、Turnstile 与 AVANTI 结构仍存在;工具按“Booking Form 弱信号”合同返回 exit 4。
该 exit code 是安全停止,不是路由失败。预检没有发送 OTP、提交 AVANTI 或进入 Calendar,
因而只关闭“账号与 Hong Kong 4937 已对齐”,没有关闭 Q-CAL-1。reservations=0, waitlist=0 基线并成功观察到一次
GenerateOTP,随后由负责人在隐藏终端提示中人工输入验证码。执行在 AVANTI 前因
Booking preflight rejected otpDisabled 停止;Booking Form POST 和
InsertNewBooking 仍为 0。独立只读审计随后再次得到 reservations=0, waitlist=0,证明
本次 OTP 没有新增预约或候补。BEFORE_OTP_SEND/AFTER_OTP_SEND 阶段校验,且 4 个聚焦测试验证发送后
otpDisabled=true 可接受;真实输出却仍命中旧判据。由于该次进程没有输出非敏感工具版本
标识,不能证明它加载了哪一版合同,也不能排除运行时值形状差异。再次授权前必须先增加
可审计版本标识与脱敏 stage/type 诊断,再做零网站副作用回归;不得直接重发 OTP。otpDisabled、avantiDisabled、turnstileReady 的类型与布尔值。
未知值只记录类型并把 value 置为 null,额外表单字段不会被序列化。19 个 Q-CAL 聚焦测试、
168 个 Italy 相关离线测试、语法编译、diff/尾随空格检查均 exit 0;真实网站请求为 0。
Q-CAL-1 仍为 OPEN,新的 OTP 仍需新的明确授权。data: 页面和真实 Chromium/DrissionPage 桥接验证:JavaScript true/false
均返回 Python bool,命令 exit 0,外部网站请求为 0。由此排除“浏览器桥把 true 转为整数
1”的假设;上次输出来自旧合同进程成为当前最强解释,但仍须由下一次 source fingerprint
实证,不能写成已最终证明。otpDisabled=false,post-OTP 为 otpDisabled=true,两个阶段都以 bool/ready 通过,从而
实证 stage-aware 修复已加载。执行发送 OTP 1 次并提交 AVANTI 1 次,但旧 validator 因
packet.response.status != 302 停止;Calendar probe 和 final 请求均为 0。独立只读审计仍为
reservations=0, waitlist=0,证明本次没有新增预约或候补。POST /booking → 302 Location:/calendar → GET /calendar 200,listener 返回的 packet 却是
request_method=POST, request_path=/booking, response_status=200,
response_path=/calendar,浏览器 final path 也是 /calendar;命令 exit 0,外部请求为 0。
DrissionPage 复用 redirect requestId 并用最终 response 覆盖原始 302,因此“packet 必须
直接暴露 302”是错误的适配器假设,不是 Italy 协议变化。/BookingCalendar、浏览器最终 pathname 也是 /BookingCalendar;若底层
仍能直接提供 302,则继续验证 Location。修复和离线回归未获得本轮授权前不实施;新的 OTP
仍需再次单独授权。2026-08-29 最终状态:Q-CAL-1 CLOSED。
在同一团队账号 Calendar Session 里按计划 cadence 重查。
通过:
不制造 Slot,不点击 unavailable。
阶段 A:response/DOM 正向语义,已由 E43 关闭:
SlotLiberi>0 / SlotRimanenti>=0;1/0、普通 fascia、无红点、显示 (1);act=false;InsertNewBooking=0。阶段 B:安全选择,已由 E44 关闭:
.fascia.act 恰好 1;btnPrenotaNoOtp,Network 中 InsertNewBooking 仍为 0。E44 实际结果:
10:05 - 11:05 候选只调用一次 .click();原 Promise fulfilled 后没有重跑;.fascia.act,且 active 就是同一时间、同一 selected 日期的候选;notAvailableFascia/dotRed,仍显示 (1);btnPrenotaNoOtp 仍存在但点击数为 0;当前页面 Resource Timing 中 InsertNewBooking 为 0;机械总判定 done=true;/Reservation 对账。禁止:InsertNewBooking。
通过:阶段 A 和 B 都关闭,唯一正向候选满足 §11 全部不变量,最终 POST=0。
团队 Query 观察正向日期后发布本地/Redis 信号;用户热 Session 独立重查具体时段。
通过:
通过:
先只调查现有云任务 API 和 OrderBooker,不访问预约网站、不执行 final。
通过必须同时满足:
若现有任务 API 不具备这些能力,结论不是“插件里写个文件”,而是提出最小框架/ 后端扩展并重新评审文件范围。该 Gate 未通过时 CS5 和 FINAL-1 均禁止。
前提:
动作:
用已取得的真实 response/成功页设计离线响应丢失测试,并在不制造第二个预约的前提下验证 Reservation。
通过:成功、明确失败、网络结果未知三种路径都不会导致第二次 final。
香港正向 fixture 与 Dublin 无号 fixture 必须走同一协议代码。随后选择一个合法的第二 Sede 做只读/前置 Gate。
源码中的城市、领馆、1321、4937 控制分支命中必须为 0。
每个 Change Set 都需要单独批准。前一个完成不自动授权下一个。
本轮。
完成:本文、历史文档状态、机械检查。
文件:
内容:
apt_configs[routing_key] 配置入口,严格校验 capability、
service_id、扫描范围与表单控件配置;repr;SlotLiberi>0 && SlotRimanenti>=0 为正向,
0/-1 为负向,矛盾组合 fail-closed;PrecommitApproval;完成结果:28 个聚焦协议测试 exit 0;30 个现有 Italy 回归测试 exit 0;编译、
纯模块导入、地区硬编码/网络副作用、敏感信息与 whitespace 检查 exit 0;生产网站
请求=0;ita_plugin.py 和生产 Query/Book 均未接入,现有 Italy 行为不变。
内容:
完成:HK/Dublin fixture 同一实现;硬编码控制分支扫描=0。
实际结果:
ItaPlugin.query() 与 book() 都通过
apt_type.routing_key → free_config.apt_configs[routing_key] 解析 route;顶层
service_id 不再是运行时 fallback;apt_configs,并显式保持
query_mode=services_probe、final_submit_enabled=false;ita_local_handoff.py 继续只接收显式 routing key/service id,没有新增地区分支;services_probe_only 仍只允许弱入口探测与用户 Session 重查,Book 到达表单后停在
AVANTI 之前;没有接入 CS1 的 Calendar parser,也没有发送 OTP 或最终请求;前提:Q-CAL-1 已关闭;实现仍需保持 final disabled,并由 Q-CAL-2 校准 cadence。
内容:
plugins/ita_calendar_query.py,作为生产 Query 与 Q-CAL 工具唯一共享的浏览器适配层;#datetimepicker th.dtpicker-next 与严格单月递增;Available + earliest_date + DateAvailability(times=[]);InsertNewBooking 观察数必须为 0;当前安全边界:query_mode=calendar 只接受同一插件实例中已经过 route 确认的
/BookingCalendar;未完成准备时明确失败,不把 bookingForm 弱信号降级发布。默认生产配置
仍是 query_mode=services_probe,因此本 Change Set 不会自动发送 OTP、点击 AVANTI 或启用强
信号。
内容:Query Calendar Session stage、OTP/AVANTI 一次性 guard,以及经过 OTP-AUTO Gate 的邮件 读取适配。它必须先证明同一实例内 route 身份连续,不能把旧持久化 Calendar 或页面标题猜成 当前 routing key。CS3A 完成不会自动授权 CS3B,也不会修改生产配置。
内容:
前提:FENCE-1 已证明可复用路径,并单独批准可能扩大的文件范围。
内容:只实现已批准的 task/order fence、状态读取和 crash-point 离线测试;不访问 Prenot@Mi,不执行 final。若需要修改 booker.py、toolkit/vs_cloud_api.py 或后端合同, 必须作为独立 Change Set,不夹带进 Italy 插件提交。
前提:SLOT-POS、Q-XACC、OTP-AUTO、FENCE-1、CS5A 已关闭,且 FINAL-1 已授权。
内容:
内容:
DD/MM/YYYY 00:00:00 日期格式、非法日期和重复日期;lookahead_months 边界、翻月顺序和完整范围为空;SlotLiberi=1 / SlotRimanenti=0 必须判正向;SlotLiberi=0 / SlotRimanenti=-1 必须判负向;每个测试断言调用次数:
| 场景 | OTP | AVANTI | final |
|---|---|---|---|
| Dublin 无号 | 0 | 0 | 0 |
| bookingForm / services_probe | 0 | 0 | 0 |
| 未知 required | 0 | 0 | 0 |
| Turnstile 未就绪 | 0 | 0 | 0 |
| OTP response unknown | 1 | 0 | 0 |
| AVANTI response unknown | 1 | 1 | 0 |
| 配置扫描范围全部无正向日期 | 1 | 1 | 0 |
| 默认月份无号、后续月份有 E43 正向日期 | 1 | 1 | 0 |
| Availability 正向、TimeSlots 无正向(冲突) | 1 | 1 | 0 |
| 负向 Slot 被手工加 act | 1 | 1 | 0 |
| final disabled | 1 | 1 | 0 |
| final listener timeout | 1 | 1 | 1 |
| timeout 后再触发 | 不增加 | 不增加 | 仍为 1 |
| reconcile 找到预约 | 不增加 | 不增加 | 仍为 1 |
“默认月份无号、后续月份正向”还必须断言 Query 发布一次 Available,快照含正向日期且所有 times=[];其他 final=0 场景不得发布错误强信号。
另加 crash-point 矩阵:fence 前崩溃允许重新预检;fence 后点击前、请求发出后和 response 前崩溃均不得产生第二次 final。正常成功 final=1,其余路径 final<=1。
主动修改 fixture:
期望:未知变化 signal=0、final=0,而不是“尽量继续”。
扫描:
测试日志、异常、snapshot、status file 命中必须为 0。
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m unittest -v \
test.test_ita_protocol \
test.test_ita_plugin \
test.test_debug_ita_session \
test.test_debug_ita_query \
test.test_debug_ita_book \
test.test_debug_ita_monitor \
test.test_debug_ita_soak \
test.test_ita_local_handoff \
test.test_add_ita_query_account
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m compileall -q \
plugins/ita_plugin.py plugins/ita_protocol.py tools test
jq empty config/config_sentinel.json config/config_booker.json
git diff --check
真实测试命令必须单独带显式 Gate/arm 开关;默认 CLI 仍是零网络 preflight。
必须:
必须:
必须:
按最小影响顺序:
回滚不删除用户数据、不清理不属于本 Change Set 的工作树修改。
| 能力 | 可行性 | 当前确信度 | 原因 |
|---|---|---|---|
| 登录 | 高 | 高 | 真实自动登录 exit 0 |
| Dublin 无号 | 高 | 高 | DOM/Network/自动 Query 三重证据 |
| route 通用化 | 高 | 高 | VFS/BLS 已有 apt_configs |
| bookingForm 弱信号 | 技术可行但产品价值低 | 高 | 自身不含日期/范围/容量;不能回答“何时有号” |
| 准备型 Calendar Query | 高,需副作用 Gate | 中高 | 完整进入链和 Calendar 协议已知 |
| 日期/时段解析 | 高 | 高 | E43 已取得正负 response/DOM truth table;CS1 的解析与变异测试已验证 |
| 正向 Slot 原生选择到 precommit | 高 | 高 | E44 已验证唯一 active、日期、时间、容量、动态 ID 形状一致且 final 请求为 0;CS1 纯 precommit 已验证 |
| Query 日期→Book 时段传播 | 可行,需实测 | 中 | 与 VFS/BLS 契约一致;同站点库存共享仍需 Q-XACC 证明 |
| 用户 Book 到 Calendar | 高 | 高 | E22 已真实通过 |
| 自动邮件 OTP | 高,需邮件参数 | 中 | 基建存在;Italy filter 未关闭 |
| 最终一次提交 | 技术路径清晰 | 中 | serializer 静态已知;真实 response 未执行 |
| 模糊结果恢复 | 待 Gate | 低 | /Reservation 权威性与 durable fence 均未知 |
| 跨 Sede 通用 | 架构可行 | 中高 | 配置化成立;需第二正向/前置样本 |
当前对“设计结构和安全推进路径”的信心可以达到 100/100;对“现在就无人值守上线”的信心不是 100,因此方案明确不允许现在上线。
| 方案 | 否决原因 |
|---|---|
| Services 有 Prenota 就报有号 | Dublin 已证伪 |
| bookingForm 就持续发弱信号 | 表单本身没有日期/范围/容量;会造成 OTP 噪音 |
| Query 把临时 Slot ID交给 Book | 跨账号/Session,必然过期或错配 |
| Query 每轮都 OTP + AVANTI | 邮件/限流/服务器状态副作用 |
| 用户 Book 不重查直接最终提交 | 机会易失且账号不同 |
| 手写 multipart/InsertNewBooking | 会绕过原生同步、token 和 serializer |
| 只看 .selected/.act | 负向样本已证明会假阳性 |
| 只看一个 Slot 数量字段 | 两个字段职责不同;E43 的正向还是 1/0,单看 Rimanenti=0 会误杀 |
| 对 final/OTP/AVANTI 自动重试 | 可能重复邮件、草稿或预约 |
| 为香港复制插件 | 立即形成地区分叉 |
| 现在修改 Sentinel/Booker/VS 类型 | 现有强信号和账号架构足够 |
| 所有逻辑继续堆进 ita_plugin.py | 接近 1,000 行且协议不变量已复杂到无法纯测 |
| 提前设计大工作流引擎 | 一个局部 pure core + adapter 足够 |
回应:旧边界是在 Calendar 协议未知时设的安全默认。香港已经证明 bookingForm 自身不表达号源,而 E43 证明只有进入 Calendar 并扫描完整范围才能回答“什么时候有号”。R3 不允许每轮发 OTP,而是把一次 OTP + AVANTI 明确建模为“团队账号 Calendar Session 准备”,单独授权、每 Session 一次、前后核对 Reservation,后续 probe 只读。若 Q-CAL-1 发现草稿/预约副作用,就否决该方案,而不是偷偷继续。
回应:BLS 的弱信号是一种技术表达,不是所有网站都适合的产品语义。bookingForm 没有日期与容量,所以会持续触发但无法回答库存。生产优先复用 VFS 的强 Calendar 信号;BLS 弱信号保留给 Discovery/人工告警。
回应:没有新增框架或运行时组件。它只是把浏览器副作用与纯解析拆开,让 E23–E44 能机械测试。旧单文件方案形成于 Calendar 协议未知时;现在继续堆叠反而降低长期可验证性。文件增加 1 个,运行链路仍是原有 IVSPlg。
回应:所以 Query 结果只是“这个时刻团队账号看到了真实正向日期”的强事实,不是预约承诺;快照不携带 times/daily ID,用户 Book 必须重查。Q-XACC 要求 3 个自然窗口 3/3,并测量时间预算。失败就调整或否决跨账号模型,不能用推断上线。
回应:当前 OrderBooker 在 create_session() 时没有把完整 user_inputs 传给插件,其他 Sede 可能有用户必填字段。现在修改通用框架属于过早扩权。先测量从热 /UserArea 到 precommit 的 p95;只有它确实错失 Slot,才用复现数据讨论最小的 prewarm 接口。
回应:不能简单返回 false,也不能只靠插件内存。B13 前必须写入跨进程 durable fence; timeout、异常、新信号或重启看到 fence 后都只能对账。当前 tracker/grabbed 流程不能 证明具备该能力,所以 FENCE-1 是 FINAL-1 的前置 Gate;不足时必须单独扩展框架, 不能在 Italy 内用本地文件假装解决。
回应:E43 已经足够实现双层解码、1/0 正向与 0/-1 负向分类和跨月扫描;E44 又证明通过完整正向 preflight 后,点击会得到唯一且正确的 .fascia.act。但最终 response、/Reservation 对账和 durable fence 仍未关闭。因此 CS1/CS3/CS4 可以在 final disabled 下推进,E44 关闭的选择态不能被偷换成 FINAL/FENCE 已关闭。
回应:这里的 Available 是“该时刻该 Sede 的某个日期有正容量”,不是“用户账号已锁定某个时间”。E43 中 Availability 的 1/0 与同日唯一正向 TimeSlot 的 1/0、普通 DOM、(1) 完整一致;VFS/BLS 也已经用“日期强信号、Book 重查时间”的合同运行。Query 快照明确 times=[],Book 必须重查;库存若在两者之间被抢走,是正常竞争,不是 Query 伪造。若未来出现正向日期长期无法在 Book 侧得到任何时段,Q-XACC 会否决或降级该模型。
回应:E43 已给出直接反例:默认 8 月窗口全负向,但向后到 10 月存在正向库存。只查默认月份会制造确定性的漏报。Query 必须在 route 配置的 lookahead 内从近到远逐月扫描;遇到首个正向月份立即停止,只有范围全部检查完且没有正向日期,才能返回无号。lookahead 是配置和 Gate 数据,不是写死香港月份。
回应:不能保证第三方库存和网络。但能保证:只在真实正向证据下尝试、用户账号独立重查、最终最多一次、结果不明不盲重提、未知变化安全停止。这是工程上可以验证的 100% 边界。
回应:本 Change Set 把已验证的 Calendar 扫描合同放进生产插件代码,而不是把尚未关闭的
Session 准备合同伪装成已完成。生产 calendar 分支会要求同一插件实例已经完成 route 确认;
默认配置继续保持 services_probe。等 CS3B/OTP-AUTO 关闭后,再通过独立配置 Change Set
启用。这既保留了生产代码与调试工具的单一实现,又避免上线一个只能靠人工 OTP 才能维持的
半自动状态。
2026-08-29 实际执行的文档级验证:
以上最终命令组必须全部 exit 0;完整命令与返回值写在本轮交付报告。由于 D0 阶段 只修改设计文档,当时没有运行 Python 测试,也没有把未运行的代码验证写成已验证。 CS1 的后续验证单独记录在 §23.2,不能倒推成 D0 当时已经执行。
过程异常:第一次更新历史文档时,patch 因尾部上下文已经演进而未应用;读取真实 尾部后按实际内容重新执行成功。同一错误只出现一次,没有盲目重试。
2026-08-29 在 CS1 授权边界内实际执行:
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_ita_protocol -v:
exit 0,28 个测试全部通过;PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_ita_plugin -v:
exit 0,30 个现有 Italy 回归测试全部通过;plugins/ita_protocol.py 和 test/test_ita_protocol.py 执行内存编译:exit 0;ruff 在当前 .venv 中未安装,因此明确记为未执行,不能写成已通过;ita_plugin.py、配置、工具或现有测试,没有清理、回滚或覆盖工作区原有修改。2026-08-29 在 CS2 授权边界内实际执行:
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest
test.test_ita_protocol test.test_ita_route_wiring test.test_ita_plugin
test.test_debug_ita_session test.test_debug_ita_query test.test_debug_ita_book
test.test_debug_ita_monitor test.test_debug_ita_soak test.test_ita_local_handoff:
exit 0,137 个测试全部通过;test.test_ita_route_wiring 用 Dublin/1321 与 Hong Kong/4937 fixture 调用同一个
_resolve_route(),并验证顶层 service_id 不回退、未知 capability fail-closed、
Sentinel/Booker route parity,以及运行时代码没有 Sede/service-id 控制分支;git diff --check:exit 0;query()/book() 与工具调用路径执行安全扫描:没有 GenerateOTP、
InsertNewBooking 或表单提交调用;配置保持 final disabled;ITA_VISA_TYPE 返回 exit 1;修正 fixture 后第二次执行 exit 0,26 个测试全部通过,
没有超过两次;ruff 在当前 .venv 中仍未安装,因此明确记为未执行,不能写成已通过;2026-08-29 在单独批准的本地修复边界内完成:
302,因而 fail-closed;独立 /Reservation 审计仍为
reservations=0, waitlist=0,没有新增预约或候补;POST → 302 → GET Calendar 200 会被高层 listener 表示为“原始 POST request + 最终
Calendar 200 response”,因此根因是客户端适配假设,不是网站拒绝的充分证据;302 校验 Booking POST、Calendar Location 与浏览器
最终 Calendar;followed 200 校验同一 Booking POST、packet 最终 Calendar URL 与浏览器
最终 Calendar。所有 URL 均要求同源,原始 POST 还要求无 query/fragment;任意证据不一致
均拒绝;direct_302 或 followed_redirect_200,不会输出 query、Token、OTP、个人
数据或表单内容;语义合同升级为 qcal1-stage-aware-redirect-v2,生产 ItaPlugin、
Query/Book 合同和 final-disabled 边界均未修改;git diff --check 和尾随空格检查均 exit 0。首次聚焦测试因测试补丁误改另一个同形
冒号而 exit 1,读取精确行号后一次修正;/Reservation 对账仍为 0/0、exit 0。负责人确认第二次真实 Gate 使用的是该次新收到的最新 OTP,因此旧验证码假设已降级;但旧 工具只能证明调用过输入方法并观察到 Booking POST,无法证明 OTP 值留在 DOM,也没有保留 Booking Form 返回后的安全错误形状。
经单独授权完成的本地修复如下:
qcal1-avanti-diagnostic-v3;OTP 输入前后分别要求
otpValuePresent=false/true,该字段只记录 presence,不记录值或长度;booking/calendar/services/user_area/other_same_origin/unexpected_origin/missing
等固定类别;HTTP status 和 DOM 计数只接受合法数值,其余置 null;qcal1-avanti-diagnostic-v3 的真实 Gate 在人工输入最新 OTP 后报告
otpValuePresent=false,并在 AVANTI 前停止;该次 OTP=1,AVANTI/Calendar/final=0。这把
问题从“验证码是否正确”收敛为“自动化没有把值保留在 OTP DOM input”。
根因和修复均复用现有实现:
input(clear=True) 时,clear 使用 JavaScript,但该分支
不主动 focus;后续键盘事件可能进入旧焦点;human_click_ele、再 input(clear=True)”,Q-CAL OTP 改为同一
模式,不新增地区分支或另一套输入抽象;this.value === expectedOtp 的布尔值;
Python 和日志都不读取实际 DOM value。比较失败则 AVANTI=0;matched=true,不记录 OTP;qcal1-otp-readback-v4。真实 Chromium + 本地 data: 页面验证 exit 0、外部
请求 0;Q-CAL 聚焦测试 27/27、Italy 离线回归 176/176,均 exit 0。本修复阶段没有真实
Prenot@Mi、OTP、AVANTI、Calendar 或 final 请求。qcal1-otp-readback-v4 的真实 Gate 已关闭进入 Calendar 的整条链路:OTP DOM 精确回读为
true、AVANTI POST 观察到 1 次、redirect 表示为 followed 200、浏览器最终到达
/BookingCalendar,且 final 请求为 0。随后工具在尝试第二个只读月份 probe 时抛出
NoRectError;负责人也观察到页面没有翻月。事后独立 /Reservation 审计仍为
reservations=0, waitlist=0。
根因不是 availability 协议,而是旧工具把横向时间线的 a.next 当成日历翻月控件,并交给
依赖元素矩形的 human_click_ele()。当前页面同时存在 Bootstrap datetimepicker 和横向
timeline;两套控件都可能叫 next,但职责不同。
第一版 v5 曾根据通用 Bootstrap datetimepicker 上游结构推断
#datetimepicker .datepicker-days th.next[data-action="next"]。真实 Gate 到达 Calendar 后却
稳定报告 candidate=0/actionable=0,证明该推断不适用于 Prenot@Mi 当前页面;它在翻月前
fail-closed,OTP=1、AVANTI=1、final=0。随后独立 /Reservation 对账仍为 0/0。
无需再次 OTP 即可恢复同一 Calendar 状态。真实只读探针取得了网站当前合同:
InizializzaCalendario() 对 #datetimepicker 调用 datetimepicker({inline:true, locale:'it'});dp.update,从 e.viewDate 取年月并调用
CaricaTimelineOrizzontale(...),后者自然产生 availability POST;th.dtpicker-next,恰好 1 个可见;另有 4 个
th.dtpicker-prev,同样恰好 1 个可见;a.next 仍存在但不可见,它没有 data-action,职责不是日历翻月;v6 采用以下收敛合同:
#datetimepicker th.dtpicker-next;不再匹配 .cd-horizontal-timeline a.next,也不
依赖当前网站并不存在的 .datepicker-days 或 data-action;POST RetrieveCalendarAvailability,严格 parser 必须接受响应;
两次 request 的 selectedDay 还必须解析为不同年月,否则即使触发了请求也判定没有翻月;qcal1-dtpicker-navigation-v6。早先 127.0.0.1 fixture 只证明“隐藏副本不点、唯一可见副本点一次”的通用过滤算法,不能证明 网站 selector;v5 真实 candidate=0 已明确否定其网站结构假设。v6 因此只以网站函数源码和 真实 DOM 为依据,不再从第三方上游模板反推 Prenot@Mi。
v6 本地准出记录:Q-CAL 聚焦测试 30/30、含账号配置测试的 Italy 全量离线回归 179/179,均
exit 0;源码指纹为 ad4f07908ba5。
随后利用同一授权账号中可恢复的 Calendar 状态执行真实只读验证,不发送 OTP、不经过
AVANTI:刷新 probe 返回 1 个日期项,点击 probe 返回 22 个日期项;两次 request 的
selectedDay 被严格解析为不同月份。点击诊断为 candidate=4、actionable=1、clicked=true。
执行前后 Reservation/Waitlist 均为 0/0,OTP=0、AVANTI=0、final=0,命令 exit 0、清理成功。
这机械关闭了“真实控件可唯一选择、自然触发 availability、请求月份确实变化”的 Q-CAL 翻月
合同,但不代表配置的三个月循环扫描或 Book final 已实现。
初见审查反驳:
“既然 JavaScript
.click()不是真实鼠标点击,是否在绕过网站限制?”
回应:这里不触碰日期、时段或最终预约,只驱动真实 DOM 已证明属于 #datetimepicker 的唯一
可见 .dtpicker-next。网站自己的 dp.update handler 才负责发只读 availability 请求;工具
不手工调用该 endpoint。使用 JS 的目的只是避免 DrissionPage 对三个隐藏副本读取 rect 的
客户端异常。真正的业务结果仍要由自然产生的同源 availability 请求及 request 月份变化双重
证明,任一不成立都停止。
为了回答“网站最远允许翻到哪个月份”,Q-CAL 工具升级为
qcal1-bounded-horizon-v7。这个版本没有改变生产 route 的
calendar_scan.lookahead_months 语义;它仍表示包含当前月在内的总扫描月份数。工具另外增加
仅用于 Discovery 的 ITA_QCAL_FORWARD_MONTHS,取值范围固定为 1–12,表示从当前月向后
点击多少次。这样不会为了调研而污染生产配置合同。
v7 复用 v6 已验证的 listener、严格 Availability parser、唯一可见
#datetimepicker th.dtpicker-next 和 /Reservation 对账。它先刷新并解析当前月,再按上限
逐月点击;每次 request 的月份必须恰好增加一个月,包含跨年。发现正向日期后仍继续,仅因为
本次目标是探查网站边界;未来生产 Query 一旦发现正向日期必须立即返回。
工具仍保持:OTP 最多 1 次、AVANTI 最多 1 次、每月只发自然产生的 Availability 请求,日期
点击 0、时段点击 0、InsertNewBooking 0。下一月控件持续不可交互时只记录
next_control_unavailable,不会在没有服务端证据时武断称为网站业务上限。
离线准出:Q-CAL 聚焦测试 36/36、Italy 全量离线回归 185/185、两文件内存编译、尾随空格
检查和 git diff --check 均 exit 0。真实 12 个月结果仍待负责人在自己的终端完成一次 OTP
后取得;在取得输出前不得宣称网站上限已知。
负责人随后把目标从“探最远边界”改为“验证最早可预约日期”。调试输出合同升级为
qcal1-earliest-date-v8:它只从严格解析后的正向 CalendarDay 中取最小日期,并在
ITA_QCAL_MONTH_SCAN_RESULT.earliestAvailableDate 输出 ISO 日期;无正向日期时输出 null。
这不读取 DOM 文案,也不包含运行时日历 ID、Token 或具体时段。
R3、CS1、CS2 和 CS3A 已在离线边界内完成。生产 ItaPlugin.query() 现在拥有显式的
calendar 分支,并与 Q-CAL 工具共同复用 plugins/ita_calendar_query.py:同一份代码负责
listener、Availability 请求元数据校验、严格 parser、唯一原生翻月控件、最终按钮 guard 和月份
单调递增。生产策略与 Discovery 策略刻意不同:Discovery 可继续探边界;生产在首个正向月份
立即停止,只返回该月最早日期。
这仍不等于“无人值守强 Query 已上线”,更不等于“完整 Italy Book 已跑通”:
query_mode=services_probe;calendar 分支只接受已经由同一实例确认的 Calendar 状态,缺少准备态时 fail-closed;InsertNewBooking 不在 CS3A 范围内。CS3A 已取得一次现场通过结果:负责人回传同一人工准备的 Session 内两次生产 Query
均为正向、OTP/AVANTI 各一次、最终请求为零、前后预约数量不变及 exit 0,见 §24.4 和
Discovery E45。旧工具只有 services_probe 加 scan_calendar_horizon() 的执行不能替代
这一证明;本次验收模式直接调用生产分支。
CS3B/OTP-AUTO 仍依赖云端邮箱授权、Italy 邮件匹配和安全日志证据,见 §25。负责人最新 确认 Query 邮箱尚未接入并授权,要求列为待办(Discovery E50、ITA-OTP-01),暂不推进 邮箱接入。已有人工 OTP 验证结果保留;无人值守自动接码仍未完成,不切换生产配置。
2026-08-30 已机械验证:
earliest_date 与唯一
DateAvailability(times=[]) 一致;plugins/ita_calendar_query.py,调试工具不再复制
listener、翻月、parser 或 final guard;4937、Hong Kong、slot.hkg 或 HKG 硬编码;实际命令与结果:
git diff --check:exit 0;新增文件及本轮相关测试/文档行尾空白检查:exit 0;全文件空白扫描曾以 exit 1 报出 plugins/ita_plugin.py 的历史行尾空格;
git diff --check 证明本 Change Set 没有新增这些问题。遵守“不顺手优化”,本轮没有清理与
功能无关的历史格式。
2026-08-30,负责人授权仅补现有调试工具的生产 Query 验收入口,人工完成一次 OTP 准备。
工具合同为 qcal1-production-query-v10。本次没有修改扫描算法、生产配置、自动邮件读取或
Book;真实网站执行由负责人在自己的终端进行。随后收到一次现场通过结果,详见 §24.4;
这里保留当时批准的验收步骤与边界,不外推为长期稳定性或完整 Book 验收。
tools/debug_ita_calendar_gate.py 增加显式 ITA_QCAL_MODE=production_query;未指定时仍是
原有 discovery_horizon 模式,避免悄悄改变旧命令语义。/Reservation 前后计数;不新建第二套登录或预约流程。services_probe。确认同一实例的 route 后,只在内存把模式改为
calendar,连续调用两次真实 ItaPlugin.query(),无论成功失败都恢复内存模式。scan_until_first_available_month(),不替换扫描函数、不伪造网络
响应,不调用旧 scan_calendar_horizon()。结果复用 VFS 风格 VSQueryResult 及已有
to_snapshot_payload();只验证序列化,不向 Redis 发布测试信号。last_calendar_query_scan 诊断字段。每次 query() 开头清空,成功
扫描后写入;配置、Session 重建和 cleanup 也清空。它不是缓存,不参与下一次业务决策,
不进入共享快照,也不能作为 Book 的时间依据。page.listen 的独立连接并存;拒绝覆盖已有 handler。不启用 Fetch 拦截、不改请求、
不保留 body、Cookie 或 Token,退出时卸载自己的 callback。success、状态、最早日期、唯一 DateAvailability(times=[]) 及共享快照
必须与该次生产扫描证据一致;不能只验证一条自行打印的日期。/Reservation 预约和候补数量前后相同;全程已知最终端点请求数为 0。passed=true,cleanup 成功,进程返回 0。库存可能在两次查询之间变化,因此不要求两次最早日期相同。如果两次完整扫描都自然 无号,只能证明负向查询完成,正向验收仍未关闭,返回 2。入口本身暂时无号时也返回 2, 不会为了得到成功日志而发送 OTP。
以上是客户端可观察的证据:已知请求的计数与预约数量没有变化,并不能证明服务器内部 绝对没有草稿,也不替代 Q-CAL-2 的长期运行验证。本次不批准无人值守生产运行。
香港仅作为已取得字段证据的 route 示例,算法和验收模式不绑定香港或 4937。
最多扫描 12 个月,每次一旦发现首个正向月份就停止;不会为了用满上限继续翻页。
两次查询都无号时可能各扫描满 12 个月。这不是无限循环。
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
ITA_QCAL_MODE=production_query \
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_calendar_gate.py
echo "EXIT_CODE=$?"
production_query 模式只使用 route 的 ITA_CALENDAR_LOOKAHEAD_MONTHS,不使用仅属于旧
Discovery 的 ITA_QCAL_FORWARD_MONTHS。OTP 仍由负责人输入一次;输入可见,终端历史可能
保留验证码,回传输出时应删除该行。运行时不要手动翻月、刷新、选择时段或点击最终按钮,
避免改变扫描证据和请求计数。
需要回传:
ITA_QCAL_TOOL_CONTRACT(版本及源码指纹包含工具、生产插件、共享适配层、纯协议核心);ITA_QCAL_MODE;ITA_QCAL_PRODUCTION_QUERY_RESULT;ITA_QCAL_PRODUCTION_QUERY_GATE_RESULT;ITA_QCAL_GATE_CLEANUP_OK 和 EXIT_CODE;失败时同时提供脱敏的失败行。| 进程返回值 | 含义 |
|---|---|
| 0 | 两次生产 Query 合同与对账通过,至少一次自然正向,清理成功 |
| 1 | 流程、协议或证据检查失败;不要重复发送 OTP 猜原因 |
| 2 | 自然库存未提供正向样本,正向 Gate 未完成,不是假装程序成功 |
| 3 | 清理异常,需要先检查残留状态 |
反驳:“工具也能自己扫出正确日期,怎么证明这次验证的是生产实现?”
回应:验收主调用是生产 ItaPlugin.query(),扫描证据由其内部实际扫描器产生;工具只比对
返回值和被动请求计数,不实现或替换扫描算法。离线集成测试保留真实 Query、共享扫描器、
parser 和序列化,仅用假浏览器提供受控页面与响应;另外验证旧 horizon 入口没有被调用。
这关闭本地接线路径问题,真实浏览器行为仍需上述现场 Gate,不能由 mock 测试代替。
2026-08-30,本轮未执行真实网站登录、OTP 发送、AVANTI 提交或 Book 操作;下述测试全部 离线。生产配置未修改,工作区原有改动保留。
执行命令及返回结果:
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest test.test_debug_ita_production_query_gate
# exit 0;21 tests,OK
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest \
test.test_debug_ita_production_query_gate \
test.test_debug_ita_calendar_gate test.test_ita_plugin test.test_ita_calendar_query
# exit 0;102 tests,OK
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest \
test.test_add_ita_query_account test.test_ita_protocol \
test.test_ita_calendar_query test.test_ita_route_wiring test.test_ita_plugin \
test.test_debug_ita_session test.test_debug_ita_query test.test_debug_ita_book \
test.test_debug_ita_calendar_gate test.test_debug_ita_production_query_gate \
test.test_debug_ita_monitor test.test_debug_ita_soak test.test_ita_local_handoff
# exit 0;220 tests,OK
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -c 'from pathlib import Path; paths = ["plugins/ita_plugin.py", "tools/debug_ita_calendar_gate.py", "test/test_debug_ita_production_query_gate.py", "test/test_debug_ita_calendar_gate.py", "test/test_ita_plugin.py"]; [compile(Path(p).read_bytes(), p, "exec") for p in paths]; print("COMPILE_OK files=" + str(len(paths)))'
# exit 0;COMPILE_OK files=5;不生成 pyc
git diff --check
# exit 0
if rg -n '[[:blank:]]+$' tools/debug_ita_calendar_gate.py test/test_debug_ita_production_query_gate.py test/test_debug_ita_calendar_gate.py test/test_ita_plugin.py docs/ita_plugin_generic_schengen_design.md; then exit 1; else test "$?" -eq 1; fi
# exit 0;本轮所列文件没有行尾空白
if rg -n '4937|Hong Kong|slot\.hkg|HKG' plugins/ita_plugin.py plugins/ita_calendar_query.py plugins/ita_protocol.py; then exit 1; else test "$?" -eq 1; fi
# exit 0;生产模块没有香港特定常量
首次新入口聚焦测试为 101/101、exit 0,但测试替身使用 __new__ 跳过真实初始化,析构时
产生未初始化属性告警。修正测试替身的 cleanup,并补上“必须恰好两次”的负向检查后,
再次验证 102/102、exit 0,无该告警;没有为消除测试告警而修改生产清理逻辑。
唯一事实记录为 Discovery E45。负责人回传了第二轮完整结果及聚合结果:
2026-08、2026-09 的正向日期数 0/0 扫描到 2026-10 的 14 个正向日期;
上限 12 个月、实际 3 个月,停止原因 first_available_month,最早日期 2026-10-13;Available、唯一日期、timesCount=0,snapshotVerified=true;0/0,passed=true;ITA_QCAL_GATE_CLEANUP_OK,EXIT_CODE=0。这是负责人执行 python -B tools/debug_ita_calendar_gate.py(production_query 模式)的
回传证据,不是助手再次访问网站。未回传第一轮完整结果、启动版本/源码指纹行和原始
Network,因此不推断第一轮具体日期,也不宣称独立复现或完整字节级运行溯源。
结论:本次人工准备后的生产 Query 验收通过,确信度高。该日期是发现时的线索,不是锁定 库存;Book 仍需用用户账号重查,自动接码、长时间运行和跨 Sede 验证没有因此通过。
当前待办(2026-08-30,负责人明确要求):
此前负责人同意进行前置补证。已归档 E45、核对现有接码实现与前置条件;当时邮箱接入 状态未知,现已由 E50 更新为未接入并暂缓。负责人分享的 Gmail 标签两次访问未取得正文(E47),随后通过 手工转述补齐一份英文邮件的发件人、主题和验证码行(E48,已脱敏)。这不是完整原始邮件 或云端取信结果。随后两名指定子代理已找到 webapp 中的原有 IMAP/API 实现,确认 web-ui 没有邮箱授权页面(E49,详见 §26);线上授权仍未验证。不会为了收集证据重新发送 OTP, 也不会读取其他邮件、开启转发、注册邮箱服务或修改业务/生产配置。
可以直接复用的是现有邮箱读取 API 和 VFS 的调用顺序,而不是复制其他网站的固定邮箱、 发件人或模板。接码能力是否对本次 Italy 账号真正可用,仍需真实邮箱授权和受控读取证据。
| 现有来源 | 源码事实 | Italy 的复用方式/边界 |
|---|---|---|
plugins/vfs_plugin.py:352、:891 |
在引发 OTP 的请求前记录 UTC sent_at,再传给 _read_otp_email() |
复用“先记时间,再单次发码,再取信”的顺序 |
plugins/vfs_plugin.py:705 |
使用共享 fetch_mail_content();recipient 取当前账号 username;正文 regex,另有 VFS 图片分支 |
直接复用共享 API;不照搬 VFS 图片识别、LLM 或其固定邮件过滤条件 |
plugins/bls_plugin.py:943 |
同样调用共享 API;循环取信;其单次底层请求上限另由 SDK 决定 | 作为接口复用佐证;不能把 wait_sec=30 宣称为整个流程硬超时 |
toolkit/vs_cloud_api.py:361 |
POST /api/email-authorizations/fetch,返回 data.body 字符串 |
不新建 Provider、IMAP 客户端、Resend、消息队列或邮箱后端 |
vs_types.py:127 |
VSAccount 只有 id/username/password,没有 email 字段 |
recipient 使用经确认的当前账号 username,不扩充账号模型 |
tools/debug_ita_calendar_gate.py:745 |
OneShotAction 在调用前消耗许可,异常也不允许同一 guard 再执行 |
复用现成“一次性动作”合同,不重新设计通用工作流引擎 |
| Q-CAL 工具的 preflight、OTP 回读、AVANTI 校验 | 这些行为已经经历人工配合的真实验证 | 后续准备态接线复用这些行为;生产模块不得反向 import tools |
plugins/tls_plugin.py 的本轮检索 |
未找到 fetch_mail_content 或邮箱 OTP 读取调用 |
不把 TLS 插件当成已存在的邮箱接码实现;不推断其他注册工具的能力 |
VFS/BLS 当前使用同一个写死的主邮箱。该值不是 Italy 账号,也不是可直接复制的授权依据;
本轮没有记录其真实地址。authorization_email 必须来自已有、已获授权的私密配置。
本节表格保留 E46 首次走读 Coordinate 调用端时的知识边界。后续 E49 已取得 webapp 实现, sender/recipient、关键字、时间窗口及 MIME 行为的最新结论以 §26 为准;线上授权和真实 邮箱测试仍未完成。
| Python 参数 | 发送字段 | 当前能证明的事实 |
|---|---|---|
email |
email |
VFS/BLS 传主邮箱;目标为 email-authorizations API,不能凭字符串就认为已授权 |
sender |
sender |
过滤值会传给云端;精确地址、显示名、大小写如何匹配,客户端没有实现 |
recipient |
recipient |
VFS/BLS 传当前账号 username;跨账号筛选实际由云端负责 |
subject_keywords / body_keywords |
subjectKeywords / bodyKeywords |
字符串原样传递;云端的包含、分词、AND/OR 语义尚未取得合同 |
sent_date |
sentDate |
VFS 使用 UTC YYYY-MM-DD HH:mm:ss;云端时区解释/比较边界需验证 |
expiry |
expiry |
转为字符串;不能把调用方填写的 300 秒当成 Prenot@Mi 验证码有效期 |
only_text |
onlyText |
默认 True;不需要沿用 VFS 的图片识别分支 |
单次 HTTP timeout 在客户端固定为 300 秒。fetch_mail_content() 本身没有客户端重试循环;
云端是否等待、怎样处理重复邮件并未由此证明。BLS 的外层轮询叠加这个 timeout,不能作为
Italy 的准确等待预算;VFS 的单次调用路径更接近当前“发一次、取一次、不重发”合同。
关键限制:客户端只返回正文,没有把命中邮件的 message id、sender、recipient、接收时间或 命中数量交给调用者。因此“参数传对了”和“后台确实只读到这封新邮件”不是同一项验收。 必须通过既有后端合同或受控正反样本验证,不能只用 mock 参数断言关闭旧码/串号风险。
仓库没有邮箱授权查询或授权建立的 SDK 方法,也没有该服务后端实现。本轮没有猜测新的
API 路由去访问后台。fetch_mail_content_from_top() 缺少当前会话的发送时间参数,不能用作
失败后抓取旧验证码的 fallback。
toolkit/vs_cloud_api.py:43 的 VSC_DEBUG 会格式化请求参数及 resp.text。
vs_log_macros.py:15 将它交给当前 logger;logger_setup.py 的应用 logger/handler 默认是
INFO。本轮用全假的正文和收件人、内存 handler、fake HTTP session 复现:
level=DEBUG body_visible=True recipient_visible=True
level=INFO body_visible=False recipient_visible=False
NETWORK_REQUESTS=0 SYNTHETIC_DATA_ONLY=true
诊断命令 exit 0 表示复现检查正常执行,不是“隐私 Gate 通过”。目前没有执行真实取信, 没有证据表明已有真实 OTP 泄露,但 DEBUG 路径确实不满足 §14 的正文/验证码零日志合同。 只在 Italy 插件里不打印 OTP,不能清除共享 SDK 已经输出的邮件正文。
此外,共享 SDK 的 HTTP/业务异常可能包含云端原始响应文本,接入时需要明确禁止把其内容 带入插件日志或 traceback。默认 INFO 只避免上述 DEBUG 行,不替代完整异常安全验证。
拟处理方向仍是最大化复用:在原共享调用链给邮件请求做最小日志/异常脱敏,保持 API、请求 参数、返回正文和状态分类不变;或找到已经存在且经过验证的等价隔离机制。当前未找到该 机制。因为涉及原方案禁止修改的共享 SDK,必须先单独确认变更范围;本轮没有修改它, 也不会另建邮箱服务来绕开这项问题。
这是基于现有设计的待补证接线顺序,不是本轮已经实现的代码:
plugins/ita_protocol.py 承接经过真实模板验证的 mail 配置/正文提取纯函数;输入输出
不做网络操作,不执行邮件 HTML 或指令,不接入大模型。E48 为英文前缀与六位数字提供
样本依据;完整正文、云端文本转换与唯一候选判定仍需验证,不猜测其他模板。plugins/ita_plugin.py 负责当前账号、route、Session 准备状态与共享 API 调用;复用 VFS
的时间记录和取信顺序、Q-CAL 的一次性 OTP/AVANTI,不改 Sentinel/Booker/账号模型。sent_at 追逐旧信。准入测试清单:
E48 已补齐一份邮件字段与验证码行的手工样本,E49 已找到现有管理 API;无需重新发送 OTP,也不再让负责人寻找 web-ui 中不存在的邮箱授权菜单。E50 已确认未接入并要求暂缓。 后续恢复 ITA-OTP-01 时,从单个授权 Query 邮箱开始核对登记和实际可读性;不索取密码、 密钥或整个接口响应,不把待办登记视为已经授权执行。
2026-08-30,仅更新本文及 Discovery。七个受关注的业务/SDK/生产配置文件用 SHA-256 对比 确认未改变;未运行登录/OTP/取信/AVANTI/Book,未修改任何邮箱设置。
_perform_request 的 AST 方法体、内存日志和 fake HTTP
响应,命令 exit 0,网络请求 0;结果为 §25.4 的潜在敏感日志路径已复现;git diff --check:exit 0。初见审查:“现成 API 都接收 recipient 和 sentDate,为什么不直接认为旧码/串号问题已解决?”
回应:传参只是客户端事实;该客户端返回的只有正文,不能独立证明后台筛选的结果。沿用 同一 API 是复用架构,补真实过滤与隐私验证是接入验收,两者并不冲突。没有这些证据, 不能用一段能匹配六位数字的代码宣称无人值守接码已完成。
负责人已分享现有 OTP 邮件的 Chrome 标签。实例、标签标识、标题和 URL 首次核对均匹配,
但正文读取及一次恢复访问均超时。达到两次上限后停止;没有实际取得发件人或正文,不能
把标签标题 OTP Code 当成完整邮件模板,也不能关闭邮箱云端接入或 OTP-AUTO Gate。
改由负责人提供同一封邮件的脱敏截图或文字,仅需发件人地址、主题和验证码相关正文;
验证码用 [OTP] 替换,个人资料及动态链接移除。无需重新发送 OTP、导出整个邮箱或安装
新邮件服务。现有 API 复用方向、共享 SDK 日志问题及后端正反样本验收要求均保持不变。
负责人手工提供的样本已脱敏归档:显示名 Prenotami、发件地址
noreply-prenotami@esteri.it、主题 OTP Code、正文片段 OTP Code:[OTP],样本验证码
为六位 ASCII 数字。样本转述的字段/形态确信度高,但并非助手读取原始邮件或云端命中结果。
在不新增邮件服务的前提下,现有 fetch_mail_content() 的候选过滤值可收敛为上述发件地址、
主题及正文前缀;recipient 仍是经核对的当前 Italy 账号,authorization_email 仍来自
已授权的私密配置,两者不能混用。不能假设云端将地址、关键字和时间按期望精确组合匹配。
解析沿用 VFS 的确定性正文提取模式,仅在 OTP Code: 上下文取六位数字,保留前导零;
无匹配、多候选或未知模板均停止。完整正文是否还有其他候选、HTML 转文本形态、其他语言
和有效期尚未取得证据;不能把这份样本扩大为全语言/全领区验证,也不使用全文任意六位
数字或大模型猜码。具体实现与测试仍在独立 CS3B 范围内,当前没有新增代码。
当前仍未关闭:云端邮箱授权/收件人对应关系、后台排除旧码/串号的正反例、SDK 日志/异常 安全以及自动填码到 Calendar 的真实验收。人工分享邮件内容不等于授予云端服务新的权限。
两名负责人指定的 luna_worker/max 分别只读调查 web-ui@b21b7ca 与 webapp@fbb82bb。
结论是可以复用原有整条邮件服务链路,不需要新建 Provider 或后台,但现有行为不能
直接宣称满足 Italy 的精确新邮件、隐私和一次性准备合同。完整证据与验证命令见 Discovery E49。
| 层 | 已有实现 | 本阶段动作 |
|---|---|---|
| web-ui | Next.js 门户、用户/站点账号/任务管理;门户绑定邮箱及 email_verified | 无邮箱授权页面,不新增页面,不把门户邮箱验证当作 IMAP 授权 |
| Coordinate | VFS/BLS 共用 VSCloudApi.fetch_mail_content(),八参数 POST Query |
保留 API 调用路径与 VFS 发码前 UTC 时间记录顺序 |
| webapp | FastAPI 管理员 API、邮箱凭据登记、IMAP 取信与候选筛选 | 使用现有服务;本轮只查源码,不修改、不实际取信 |
管理 API 的已确认路径是 GET /api/email-authorizations/email/{email};默认 API 文档在
webapp 根路径 /docs(部署 host/反代路径未验证)。它要求管理员 Bearer session,并会
返回包含授权码等凭据的对象,没有 exists-only 接口;不能让负责人粘贴完整 JSON。
记录存在也不能证明 IMAP 凭据仍有效,模型没有 active/expiry/last-check 状态。
sender/recipient 是 raw From/To 子串,不是精确邮箱地址;多关键字 CSV 是 OR-any。
单纯把完整官方发件地址填入参数,不能宣称完成了地址认证或本地精确校验。[sentDate, sentDate + expiry] 闭区间,取首个命中。没有唯一性、去重或消费语义。onlyText=True 仍保留 HTML,可重复输出 MIME plain/HTML 中的同一码。E48 的候选解析
规则必须覆盖此差异;相同码的 MIME 重复不等于不同验证码冲突,也不能未经验证便对
任意引用/转发去重并取首码。纯函数归一策略需在实现前固定并用真实云端形态验收。当前下一步只核对一个目标邮箱的登记存在性、管理员身份和非敏感配置完整性;在负责人 自己的已授权环境执行,原始凭据不输出、不入日志。该检查不取信、不发 OTP、不修改登记。
获得登记证据后,再制定最小的真实取信 Gate:账号/From/To/Received 时间、正常邮件与 旧邮件/错误收件人、MIME形态、耗时和已读变化,不能仅测“能解析六位数字”。所需动作、 目标邮箱和副作用另行说明,不把此轮只读源码调查当成真实取信授权。
已定位的共享 SDK 日志问题、后端子串筛选与响应/日志风险是明确的接入约束;若关闭 Italy 既定准入条件需要改 webapp 或 SDK,应提交小范围合同/测试计划并单独批准。不修改 VFS/BLS 行为、不替换 Provider、不增加邮箱管理 UI,不在调查中顺手整改硬编码凭据。
_extract_body + 合成 MIME:五场景七断言通过,exit 0;HTML保留、相同前缀
出现两次、空白折叠已离线复现;endpoint八参数 Query/类型绑定也通过。初见审查:“是不是发现现有服务不够严格,就准备重写一套?”
回应:不是。Provider、授权存储、管理员鉴权、API与调用顺序都有现成实现。当前只补事实 和准入证据;若确需改变匹配或脱敏行为,也限定在既有链路的小范围变更,经批准后再做。