日期:2026-08-30。状态:IMPLEMENTING;本地准出及一次 15 分钟受控重建实测已验证(E51);真实认证过期恢复及长期运行仍待验收。
Phase: IMPLEMENTING(本地准出、15 分钟受控重建已验证;整体尚未 VERIFIED) Scope: 已准备 Calendar 的持续生产 Query、故障分类、同账号会话重建、只读 Calendar 恢复、有限重试和人工接续边界。 Non-goals: 不实现自动 OTP,不改 Book/最终提交、共享调度器或生产配置,不提交、推送或部署。 Done: 本文故障矩阵均有离线断言,相关回归 exit 0;真实重建及持续运行另有版本、时长、请求计数和退出码证据。 Approval: 负责人要求“把除了重新需要 OTP 的 TODO 之外的所有其他流程先完成”。 Evidence/Risks: 387 项 Italy 回归及零网络 CLI 检查已验证(§8);同指纹现场回传证明 909 秒、3 次查询、1 次受控恢复且监测阶段无 OTP/AVANTI/final(§11)。重建后复用了仍有效的认证状态,不证明真实认证过期后的可恢复性。
已经能查到最早日期,现在要让它能持续工作:没号继续等,有号报告后也继续查;网络短暂失败不误报,浏览器掉线后按限额重建;重建后确认还是同一账号、同一服务的 Calendar 才继续。
重新需要 OTP 时输出 needs_manual 和 ITA-OTP-01,停止自动动作。这是暂时的接续点,不是删掉自动化要求,也不算无人值守验收通过。
人工完成一次既有 Calendar 准备
→ Query → 校验本次结果和请求 → 等待 → Query
├─ 网络暂时失败 → 退避 → 最多再试一次
├─ 登录过期 / 浏览器掉线 → 清理旧实例 → 同账号重建
│ → 只读恢复 + 身份重新核对 → Query
├─ 限流 → 停止本轮,等待人工决定,不换账号绕过
├─ 需要重新准备 / OTP → needs_manual,保留 TODO
└─ 未知结构 / 挑战 / 审计失败 → 停止,不发布错误号源
| 项目 | 已有依据 | 本轮需要补齐 |
|---|---|---|
| 日期查询 | CS3A:两个生产 Query、逐月到首个正向月份、快照一致 | 持续多轮,正向后不退出 |
| 失效回收 | VFS/BLS 的 is_healthy=False;Sentinel 的 health → cleanup → creator |
Italy 异常正确进入同一机制 |
| 浏览器重建 | 旧 soak 已有同账号、持久 profile、次数/时间上限 | 接续 Calendar 而不是退回弱 Services 探测 |
| Calendar 恢复 | Q-CAL-1 曾在仍有效的持久认证状态下只读恢复 | 重登后重新核对;失败明确停下,不猜测可恢复 |
| OTP 自动化 | VFS/BLS 邮件 API 调用顺序、Italy 邮件样本 | ITA-OTP-01,暂不实现,但必须完成 |
| 长期频率 | 已有有限时长 soak 和间隔配置 | Calendar cadence 尚未实证;首次单实例、间隔至少 300 秒 |
不承诺网站永不失效或预约成功率 100%。可机械承诺的是:每条路径有确定结果、失败不会变成有号/无号、写动作不被恢复机制重复执行。
| 文件/机制 | 职责 | 本轮处理 |
|---|---|---|
sentinel.py、main.py |
账号/实例调度、Redis TTL、禁用组停止 | 原样复用,不另造守护进程、队列或生产轮询器 |
| VFS/BLS 的异常 + 健康标志 | 区分过期、限流、拒绝;失效后回收 | Italy 薄适配;不复制网站专有端点或绕过逻辑 |
plugins/ita_calendar_query.py |
Calendar 浏览器边界、扫描 | 增加可分类但不含响应正文的错误;保留唯一扫描实现 |
plugins/ita_plugin.py |
IVSPlg 与网站能力衔接 | 标记失效;只读恢复前后重新校验账号、profile、完整 route 和 runtime service |
tools/debug_ita_soak.py |
已有有限时长、同账号重建、两次失败上限、状态文件 | 增加 Calendar 适配;继续使用同一个 soak 循环 |
tools/debug_ita_calendar_gate.py |
已验证的一次手工 OTP/AVANTI 和被动请求计数 | 准备完成后把同一实例交给 soak,不复制表单/发码实现 |
plugins/ita_calendar_book.py 的 read_calendar_service() |
已有严格只读 runtime service 读取 | 经插件现有依赖复用,不修改 Book 行为 |
test/ |
故障、恢复、调用次数与回归 | 新增有边界的恢复测试;真实网站不能用 mock 替代 |
设计方式:薄适配器 + 现有生命周期 + 组合既有验收工具。不增加通用状态机框架、邮件 Provider 或地区子类。香港只出现在现场示例配置中。
| 观察 | Query 结果 | 本地盯号行为 |
|---|---|---|
| 明确 401 / 跳回 IAM 或登录入口 | SessionExpiredOrInvalidError,不再健康,旧扫描清空 |
清理一次、等待、同账号重建;连续两次即停 |
| 浏览器断连 | 保留可识别断连类型,不再健康 | 同上,不复制 Cookie 或更换账号 |
| 429 | 复用 RateLimiteddError,不再健康 |
本轮停止,不能自动换账号重试 |
| 403 / 明确挑战页 | 拒绝/挑战类型 | needs_manual,不解验证码、不重新发 OTP |
| 请求超时或 408/502/503/504 | 可区分的暂时网络错误,清空本次证据 | 有限退避;连续两次停止,不为了网络错误强制登录 |
| 未知 schema、跨源、route/runtime 不符 | 明确协议/准备错误 | 停止,无号源发布、不盲目重试 |
| Calendar 回到预约表单/未准备态 | needs_manual |
ITA-OTP-01 接续;本轮发码/AVANTI 增量 0 |
| 完整范围无正向日期 | NoAvailable |
记录成功的负向查询,等待下一轮 |
| 首个正向月份 | Available + 最早日期 + times=[] |
记录标准快照,等待下一轮,不调用 Book |
HTTP method 不能决定副作用:GenerateOTP 本身也是 GET。只读恢复仅使用已观察的 Calendar 导航与原生 Calendar 查询,绝不直接请求 GenerateOTP 或提交表单。
仅在本进程已确认当前 route 的 Calendar 后,生成不落盘、不进入 Redis 的恢复参照:完整 route、账号绑定、持久 profile、同源 Calendar URL、runtime service。它不含 Cookie/OTP、预约日期、时段 ID,也不作为新 Session 已准备好的证明。
重建使用相同配置和账号;新实例到 Dashboard 后,只访问一次已记录的 Calendar 地址。只有当前 URL/DOM/服务身份与参照匹配、最终按钮被保护,才重新登记当前实例的准备态。随后必须执行新的生产 Query,不能重用旧日期或 scan。
参照不能用于另一个账号、profile、route 或 Book。进程重启后不从不可信文件重建此证明;重新走人工准备入口。完整进程重启后的自动 OTP 准备仍属于 ITA-OTP-01。
preparationRequests 单独记录首次人工准备;queryRequests 记录准备后整个监测阶段,包含只读恢复页面自动产生的 Calendar 请求,而不只包含显式 query()。每个成功 Query 另有自己的请求增量。expiryCauses.configuredLifetime 是本地配置主动回收,expiryCauses.authentication 才是认证失效观察;不能把配置寿命当作网站实际寿命。本地代码准出:故障矩阵通过、Italy 回归通过、diff 检查通过、无写动作、无敏感日志。初见审查必须回答“恢复是否用了旧身份/日期,以及失败后是否偷偷重发”。
现场准出:记录命令/源码版本、实际时长、成功/错误/恢复次数、标准快照、请求审计及预约/候补前后计数、清理结果、退出码。未能取得结束计数或审计存在缺口,标为证据不完整,不能写 passed。
生产仍单独准入:当前 Italy 组保持 disabled;旧 services_probe 的 success=True 弱信号会被现有 Sentinel 发布,所以它不是可在线降级的安全模式。回滚应禁用组,复用 main.sync_groups() 的 stop 路径。Sentinel 目前按实例数提高组频率,多账号总频率预算未关闭前只允许单实例实验。自动 OTP、真实长期寿命、跨账号和第二地区验证仍按总方案 Gate 管理。
实施前代码检查确认:401/429 被合并成同一 Calendar 错误;Italy 过期分支未统一置 unhealthy;旧 soak 会在非空结果时停止。
qcal1-calendar-soak-v11。64b0581dbd3e。指纹包含 Gate、Query 适配、Italy 插件、协议、共享 Book Calendar 边界、soak 和现有 backoff;任一相关源文件变动后必须重新验收。test/test_ita_query_recovery.py 与 test/test_ita_calendar_soak.py。覆盖分类、旧证据失效、同账号恢复、错 route/profile/service 拒绝、正负交替、退避、断连/重建上限、OTP 重入停止、限流、审计缺口、清理失败与取消。ItaPlugin.query()、Calendar 扫描与既有 soak 循环;浏览器和时钟替换为本地测试对象。另执行真实 Sentinel._monitor_loop() 的隔离测试,断言回收一次、没有 Redis 写入。它们不等于真实浏览器/网络验收。完整 Italy 回归实际执行:
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q \
test.test_add_ita_query_account \
test.test_debug_ita_book \
test.test_debug_ita_book_gate \
test.test_debug_ita_calendar_gate \
test.test_debug_ita_monitor \
test.test_debug_ita_production_query_gate \
test.test_debug_ita_query \
test.test_debug_ita_session \
test.test_debug_ita_soak \
test.test_ita_calendar_book \
test.test_ita_calendar_book_flow \
test.test_ita_calendar_query \
test.test_ita_calendar_soak \
test.test_ita_local_handoff \
test.test_ita_plugin \
test.test_ita_protocol \
test.test_ita_query_recovery \
test.test_ita_route_wiring
结果:Ran 387 tests in 3.266s、OK、exit 0。这是所列 Italy 测试模块的执行结果,不是全仓外部集成验收。
定向回归实际执行:
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q \
test.test_ita_query_recovery \
test.test_ita_calendar_soak \
test.test_debug_ita_calendar_gate
结果:Ran 87 tests in 0.079s、OK、exit 0。
其他检查:
| 实际执行 | 返回值与观察 | 结论 |
|---|---|---|
§9 的相同 HK 路由配置,不带 --run 的 CLI 预检 |
exit 0;ITA_SOAK_CALENDAR_PREFLIGHT_OK、external_request=false |
参数及配置入口已验证;未读取账号或打开浏览器 |
git diff --check |
exit 0,无输出 | 当前受跟踪文件 diff 无空白错误 |
rg -n '[ \t]+$' docs/ita_query_recovery.md test/test_ita_query_recovery.py test/test_ita_calendar_soak.py |
exit 1,无输出;rg 的 1 表示无匹配 |
三个新增文件无尾随空白 |
git diff --no-index --check -- /dev/null docs/ita_query_recovery.md |
exit 1,无输出(新文件产生差异) | 不能把此命令的 1 写成普通 git diff --check 的 exit 0 |
曾尝试 unittest discover -s test -p 'test*ita*.py' -q:exit 1,收集阶段出现 5 个导入错误(test/test.py 与 test 包解析冲突,继而引入未安装的 cv2)。改用上面的显式模块入口后已验证通过,未安装额外依赖、未修改无关测试。没有运行需要真实云端/Redis 的全仓测试。
反驳:“旧浏览器已经死了,凭什么用保存的信息继续?这不就是拿旧 Session 和旧日期冒充新的吗?”
回应:保存的只是同账号/profile/route 的内存比较值。新实例必须自己登录、访问一次已观察的 Calendar URL、核对当前 runtime service,并重新执行 Query;旧 scan 先清空,日期不会传给新实例。回到表单直接 needs_manual,不重发 OTP,也不退回弱信号。错账号/route/profile/runtime、换 tab、过期与旧 scan 复用均有拒绝测试。
另一个审查点是资源所有权:Gate 只交接一次浏览器和审计,恢复时先清理旧实例再创建新实例,清理失败不能报告成功。健康检查不吞掉 Ctrl+C;准备后的 route 以已确认的上下文为准,不重新解释环境变量。对应故障测试已通过。
确信度:本地已覆盖合同及 E51 的一次受控恢复为高;真实认证过期恢复率及 2/24 小时稳定性为待验证,目前没有相应现场证据。
一个账号、一个地区配置,首次照旧手工输入 OTP,进入 Calendar 后:持续查询 15 分钟;第一次成功查询后,由程序正常关闭它创建的浏览器一次,再重建、只读恢复和重新查询。找到日期仍继续,不运行 Book、不选择时段、不点击最终确认。
香港是现成样例,不是代码中的地区限制。账号必须仍绑定香港,不能与另一个进程共用该持久 profile。不要另开同一工具、手工切换机构、关闭它的窗口或发送第二次 OTP。首次手工准备所用时间不计入 900 秒,因此总等待时间会略长。每轮完成后等待 300 秒,不是每秒刷新。
下列命令含 --run,会真实登录,并执行既有一次 OTP/AVANTI 准备。只在负责人自己的终端执行;本轮 Codex 未执行。只想先检查参数时,去掉 --run,其余保持不变。
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
ITA_ROUTING_KEY=slot.hkg.it.tourist \
ITA_SERVICE_ID=4937 \
ITA_CITY='Hong Kong' \
ITA_VISA_TYPE='Tourist' \
ITA_CALENDAR_LOOKAHEAD_MONTHS=12 \
ITA_SESSION_MAX_LIFE=900 \
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_soak.py \
--calendar --run --duration-seconds 900 \
--min-wait 300 --max-wait 300 --restart-after-probes 1
echo "EXIT_CODE=$?"
这里沿用既有 900 秒本地 Session 回收配置;若它触发回收,报告单列 configuredLifetime,不能视为网站只允许登录 900 秒。--restart-after-probes 1 是一次受控正常关闭,不模拟故障,也不触碰用户另开的浏览器。
只需回传 ITA_QCAL_TOOL_CONTRACT、ITA_SOAK_CALENDAR_RESTORED、最后一条 ITA_SOAK_CALENDAR_RESULT 和 EXIT_CODE。不要贴 OTP、密码、Cookie、完整请求头或私有账号文件。脱敏状态沿用 data/ita_soak/status.json;终端可见 OTP 仍可能留在终端滚动记录里。
首次现场通过必须同时满足:
passed=true,实际监测达到 900 秒。controlledRestart=true、restores >= 1,新实例中 queriesInCurrentSession >= 1。queryRequests.otpRequests/avantiPosts/finalRequests 全为 0;首次人工准备的 preparationRequests 单独计数。auditGaps=0,预约/候补前后数量一致且 reservationVerified=true。| 退出码 | 意义 | 是否通过连续运行验收 |
|---|---|---|
| 0 | 本次有限时长运行证据完整 | 是,仅限本次工况和时长 |
| 1 | 协议/业务错误或重试上限 | 否;保留脱敏原因,不盲目重跑 |
| 2 | 参数/配置错误 | 否,尚未开始现场验证 |
| 3 | 清理或状态落盘失败 | 否 |
| 4 | needs_manual:重新准备/OTP,或网站人工验证 |
否;查看原因,OTP 对应 ITA-OTP-01 |
| 5 | 网站限流 | 否;停止,不换账号继续试 |
| 6 | 曾查询/恢复,但最终证据不完整 | 否;不能把“恢复后查到”当作全程审计通过 |
| 130 | 人工 Ctrl+C | 否,正常取消 |
15 分钟已按 E51 通过。负责人随后明确跳过本轮 2 小时测试,直接推进下一阶段;不再把追加长测作为 Book 提交前验收的前置。2/24 小时及自然过期仍属未验证,不改记为通过,也不后台启动。
Phase: VERIFIED(仅本次受控重建与持续查询工况)。Approval: 负责人在自己的终端执行 §9.2;本轮仅归档,不新增运行、改代码、启用生产或提交预约。Evidence/Risks: 完整日志标头与本地已测试版本一致;认证自然过期、断网和 2/24 小时运行未覆盖。
负责人先回传结束摘要,后补充完整终端日志;以实际回传为依据,Codex 未代替负责人执行真实命令。只保存以下脱敏结果,不复制原日志中的 OTP、profile 标识、指纹 seed、调试端口或账号信息。
ITA_QCAL_TOOL_CONTRACT version=qcal1-calendar-soak-v11 source_sha256=64b0581dbd3e
ITA_SOAK_STARTED service_id=4937 routing_key=slot.hkg.it.tourist duration_seconds=900 min_wait=300 max_wait=300
ITA_SOAK_CALENDAR_RESTORED restores=1 fresh_proof=true
ITA_SOAK_COMPLETED duration_seconds=900 probes=3 none_available=0 transient_errors=0 session_attempts=2
ITA_SOAK_SESSION_CLEANUP_OK session=2 reason=soak-finished
ITA_SOAK_CLEANUP_OK
EXIT_CODE=0
实际执行入口为 §9.2 完整 HK 配置加 python -B tools/debug_ita_soak.py --calendar --run --duration-seconds 900 --min-wait 300 --max-wait 300 --restart-after-probes 1;退出码 0。
| 观察点 | 回传结果 | 可证明的结论 |
|---|---|---|
| 源码身份 | qcal1-calendar-soak-v11 / 64b0581dbd3e |
与 §8 已验证制品一致 |
| 时长 | 配置 900 秒,最终 elapsedSeconds=909 |
完成 15 分钟监测并收尾,未因找到号而提前退出 |
| 查询 | 第 1/2/3 轮开始于 0/382/692 秒;3 次均正向 | 重建前 1 次、重建后 2 次真实新查询 |
| 日期 | 三轮均扫描 8、9、10 月,首次正向月 10 月 | 本次快照最早 2026-10-13,不是当前库存永久承诺 |
| 受控恢复 | 正常清理第 1 个实例,等 60 秒,再启动第 2 个实例;restores=1 |
已准备 Calendar 的同 profile 重建可恢复 |
| 准备与监测 | 准备 OTP 1、AVANTI 1;监测两者均 0;全部 final 0 | 没有因恢复重新发码或提交预约 |
| 审计与对账 | auditGaps=0;预约/候补均 0 → 0 |
本次请求证据完整、前后数量不变 |
| 清理与返回 | 两个实例分别清理成功,passed=true、exit 0 |
本次有限时长 Gate 已通过 |
{
"auditGaps": 0,
"automaticOtpTodo": "ITA-OTP-01",
"controlledRestart": true,
"elapsedSeconds": 909,
"exitCode": 0,
"expiryCauses": {
"authentication": 0,
"configuredLifetime": 0
},
"failureReason": "",
"latestQuery": {
"automaticTimeSlots": 3,
"availabilityCount": 1,
"availabilityStatus": "Available",
"earliestDate": "2026-10-13",
"lookaheadMonths": 12,
"months": [
{
"month": "2026-08",
"positiveDays": 0
},
{
"month": "2026-09",
"positiveDays": 0
},
{
"month": "2026-10",
"positiveDays": 14
}
],
"queryRequestDelta": {
"availabilityRequests": 3,
"avantiPosts": 0,
"finalRequests": 0,
"otpRequests": 0
},
"scannedMonths": 3,
"snapshotVerified": true,
"stopReason": "first_available_month",
"success": true,
"timesCount": 0
},
"mode": "calendar",
"negativeQueries": 0,
"passed": true,
"positiveQueries": 3,
"preparationRequests": {
"availabilityRequests": 1,
"avantiPosts": 1,
"finalRequests": 0,
"otpRequests": 1,
"timeSlotRequests": 0
},
"queriesInCurrentSession": 2,
"queryAttempts": 3,
"queryRequests": {
"availabilityRequests": 10,
"avantiPosts": 0,
"finalRequests": 0,
"otpRequests": 0,
"timeSlotRequests": 11
},
"reason": "",
"reservationAfter": {
"reservations": 0,
"waitlist": 0
},
"reservationBefore": {
"reservations": 0,
"waitlist": 0
},
"reservationVerified": true,
"restores": 1,
"sessionAttempts": 2,
"state": "completed"
}
/UserArea,没有再次经过登录表单;authentication=0、configuredLifetime=0。这是浏览器重建后继续使用仍有效的持久认证,不是强制登录失效后重新认证的验收。queryRequests.availabilityRequests=10 包含监测阶段的恢复页面请求,不只限于三次显式 Query 的 9 个 Availability 请求;自动 TimeSlots 总数 11 原样记录,不将其全部归因于某一个动作。ITA-OTP-01 保持必须完成且暂缓,不能勾选完成。从负责人日志用 rg 仅提取合同、路由、查询和最终结果标记:exit 0。对版本、900 秒阈值、3 个逐轮结果、恢复次数、请求增量、预约计数和退出码执行结构化校核:24 条断言通过。本轮不重跑业务测试,因为没有修改 Python/配置;§8 的测试记录保留其原时间和制品身份。
归档回读:§11.2 JSON 与负责人回传逐字段一致;git diff --check exit 0;新增归档所在文件尾随空白搜索 exit 1、无命中。对本轮关联的五个运行源文件及两份生产配置作前后 SHA-256 比较,内容均未变化。
初见审查:“passed=true 是否等于无人值守的掉线恢复已经全部做好?”
回应:否。完整日志明确显示重建时认证仍有效;本次关闭的是受控重建 Gate,不能关闭自然认证过期或 24 小时 Gate。对这种边界的限定来自实际行为,而不是仅相信 passed 一个字段。
负责人要求跳过 2 小时长测并快速推进。当前直接复用 tools/debug_ita_book_gate.py,不再开发第二套入口:独立申请人登录、手工 OTP、一次 AVANTI、生产 Book 重查并选择真实时段,最终确认前停止。自动 OTP 保留 TODO;当前不执行最终预约。
本轮未改业务代码。已执行 PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest -q test.test_debug_ita_book_gate test.test_ita_calendar_book test.test_ita_calendar_book_flow test.test_ita_plugin:167 项通过,exit 0。既有 HK 配置配合 tools/debug_ita_book_gate.py --preflight:exit 0,external_requests=0 credentials_read=false browser_created=false,版本 book-prefinal-manual-v3、指纹 0c11e4d186d8。
现场命令交给负责人自己的终端执行,默认由其输入 Book 账号,不隐式读取 Query 私有账号文件。既有 CS4C 记录的 Calendar 准备失败仍需 v3 诊断补证,不凭 Query 的成功修改业务校验。成功标准是选中当前真实时段、最终请求 0、预约/候补前后不变、passed=true、exit 0;这不是最终预约成功。