当前代码位置:Italy 专属运行时已机械迁移到 plugins/ita_plugin.py。
下文历史名称对应其中的同名分区;可执行示例已更新导入。
参见 单文件重构、热更新验证与宿主要求。
更新日期:2026-08-31。合同:existing-framework-offline-v2。
本轮完成的是“真实框架代码 + 模拟外部依赖”的离线协同验收,不是真实网站、真实 Redis 或上线验收。
上一版 tools/debug_ita_query_book.py 虽然复用了生产插件和 SDK,却自己维护了内存信号、TTL 和单次消费,又编排了一套账号与浏览器生命周期。这不符合“最大化复用”。
本轮移除这些实现,包括 LocalQuerySignal、独立池账号适配、JSON 拼装/消费、手工 Book 派发和独立 session 管理。旧 --run 参数已经失效,不能再照上一版命令执行。 文件保留为薄薄的离线测试入口,不是另一套协调器。
| 环节 | 本轮实际执行的方法 | 未再实现的能力 |
|---|---|---|
| 池账号领取、Query 配置及 Task 创建 | SentinelGCO._spawn_sentinel_worker() |
账号选择、冷却参数、配置绑定、失败清理 |
| 实际查询、快照生成和发布 | SentinelGCO._monitor_loop() → ItaPlugin.query() → redis_client.setex() |
查询调度、JSON envelope、TTL 发布 |
| 订单领取、申请人凭据绑定 | OrderBookerGCO._spawn_worker() |
订单队列名、账号映射、任务身份和可接受路由 |
| 读取快照并触发订单 | BaseBookerGCO._booking_trigger_loop() |
JSON 解码、路由筛选、订单日期筛选、冷却、线程创建和 join |
| 实际执行预约逻辑 | OrderBookerGCO._execute_book_job() → ItaPlugin.book() |
订单有效性检查、用户输入传递、成功/失败处理 |
| 重新查日期/时段 | 现有 ita_workflow、ita_calendar_book |
不使用 Query 的旧库存直接选中时段 |
| 停止与清理 | 两个现有 GCO 的 stop() |
不新建生命周期管理器 |
| 其他既有契约 | 原有信号保留、订单结果和 Sentinel 恢复测试 | 不复制已有测试场景的业务实现 |
本地配置中 BLS/TLS 使用 account_source=order,VFS 使用 built-in;main.get_gco_class() 按这个配置选择共同框架。你的需求对应 BLS/TLS 的 OrderBookerGCO,不是把所有插件都强行改成同一种账号模式。
既有自动 OTP 继续使用 VSCloudApi.fetch_mail_content();邮件只通过原有筛选与确定性验证码解析,不当作指令、不送给大模型。本轮没有修改邮箱服务,也没有新增邮件组件。
真实执行: 上表的 GCO 构造、池/订单创建方法、两个循环、Task 数据结构、快照序列化/反序列化、订单条件判断、Book 线程、Italy 的日期扫描与库存重查、框架停止逻辑。
仅模拟外部边界:
FakeRetainedSignalRedis fixture 和 Mock 命令边界;不建立真实 Redis 连接。新增测试会阻止真实 socket 连接、HTTP 请求和子进程启动;真实框架的 Book 线程仍照常创建并 join。
所以,“框架方法被验证”不等于“真实 Redis 时效、真实池冷却、真实邮箱和网站都通过了”。
booking_cooldown 与订单状态判断;信号仍有效、冷却结束时,可能再次调用 Book。不能拿上一版单次消费语义替换它。success,Booker 解码后它默认是 false;保持这个现成合同,不补造 true。expected_end_date 先由 Booker 筛选;起止日期仍传给真实 Book 做选择。不能在测试入口丢掉订单条件。这些是复用边界,不是宣称现有公共框架具备完美的分布式幂等或无限自动恢复能力。
仅修改此前本任务新增的三个文件:
tools/debug_ita_query_book.py:离线测试入口,原 341 行缩减为 55 行;没有自建信号、调度、账号领取或浏览器流程。test/test_debug_ita_query_book.py:真实框架协同测试与 CLI 边界测试,复用既有 Query、Book、Redis fixtures。未修改 Sentinel、Booker、共享类型、Italy 生产插件、VFS/BLS/TLS、共享 SDK、正式配置。工作区原有修改全部保留,没有提交或部署。
设计方式:组合既有实现,并在测试中替换外部依赖;没有新增公共框架、调度模式或运行时抽象。
新增/替换文件中的 18 项测试覆盖:
--run 拒绝;空、跳过或失败套件不得报告通过。2026-08-31 当前代码实测:
| 命令/范围 | 结果 |
|---|---|
python -B -m unittest -q test.test_debug_ita_query_book |
18 tests,OK,exit 0 |
python -B tools/debug_ita_query_book.py --offline |
新框架用例 + 既有复用用例,共 26 tests,OK,exit 0 |
| Italy 相关 18 个模块回归 | 546 tests,OK,exit 0 |
18 个回归模块是:test_ita_preflight、test_ita_otp、test_ita_workflow、test_debug_ita_book、test_ita_protocol、test_ita_plugin、test_ita_calendar_book、test_ita_calendar_book_flow、test_ita_calendar_query、test_ita_booker_integration、test_ita_booking_final、test_ita_final_attribution、test_ita_final_read_port、test_debug_ita_calendar_gate、test_debug_ita_production_query_gate、test_debug_ita_book_gate、test_debug_ita_query_book、test_ita_query_recovery,均位于 test 包中。
首次运行新用例时,Query fixture 的准备标记被真实 set_config() 清除,导致无法发布。这是测试装配问题:修正为在模拟登录/准备完成后记录标记;没有删除生产检查,也没有改 Query 算法。正向用例同时断言真实发布确实发生,避免“没有执行任何逻辑也通过”的假阳性。
在自己的终端:
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
PYTHONDONTWRITEBYTECODE=1 python -B tools/debug_ita_query_book.py --offline
echo "EXIT_CODE=$?"
不需要填写任何账号、密码、池名或邮箱;不会打开浏览器。预期:
ITA_QUERY_BOOK_TOOL=existing-framework-offline-v2
Ran 26 tests ...
OK
ITA_QUERY_BOOK_FRAMEWORK_RESULT=... "passed": true, "liveAcceptance": false ...
EXIT_CODE=0
不要再使用旧 --run 命令,也不要为了现场验收直接启动现有生产配置。
离线框架复用验证已完成;真实协同还需要独立验收:
ie.it.sentinel 是 Dublin 配置,不能直接推定可用。如果没有隔离环境,先解决测试依赖隔离,继续使用原框架;不要退回独立 Italy 信号机制,也不要冒险拿正式队列做试验。不能给网站预约成功率作 100% 保证;可以要求每个准出节点都有对应证据。
config/test_conf.json 的 ita_plugin 已补齐香港现场样例:slot.hkg.it.tourist、服务 4937、单人旅游表单和最多 12 个月扫描;由现有 Query 逐月扫描,在首个正向月份停止并返回其中最早日期。地区与服务仍通过配置映射,不修改公共测试器或 Italy 算法。
原有账号、密码、代理、个人资料及其他插件配置保留。账号必须已在网站绑定香港;本地修改路由不会替账号切换机构。
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B tools/plugin_tester.py --plugin ita_plugin -c config/test_conf.json
echo "EXIT_CODE=$?"
这是实际网站查询命令,本次配置修改只做离线检查,未替用户执行。首次进入 Calendar 的准备阶段使用人工 OTP,可能发送一次验证码并提交 AVANTI;已准备好的 Calendar 查询不会每次发 OTP。最终提交开关为 false,不要手动点击最终 Prenota。
此配置先不追加 --book:公共测试器的该参数继续使用同一个插件实例,不代表“池账号 Query → 申请人账号 Book”;当前 Calendar Query 配置也不允许作为申请人 Book 会话。真正双账号协同仍使用上文的既有 Sentinel/OrderBooker 框架。
离线配置回归入口:python -B -m unittest -q test.test_plugin_tester_ita_config。使用真实 JSON 加载器与生产路由解析器,账号在测试加载时用合成值覆盖,不创建插件或浏览器。
本次验证:配置与协议/查询定向回归 59 项通过;加入新配置测试后的 Italy 19 模块回归共 549 项通过(exit 0)。与修改前逐项比较确认:其他插件、原账号密码、代理、个人资料和原有私有配置均未变。公共测试器、生产插件和正式调度配置未修改;真实账号当前机构与现场查询仍待用户运行上述命令确认。
2026-08-31 用户提供的公共测试器日志确认:替换为私有 Query 账号并覆盖实际代理后,create_session() 已成功进入 /UserArea;服务 4937 的表单可打开。失败发生在发送 OTP 前,组件/API/脚本存在,但 turnstileTokenPresent=false 持续到超时,最终状态为 turnstile_and_avanti_pending。没有进入 Calendar,不能将本轮故障归因于登录或无号。
代码原因:ita_workflow.prepare_calendar() 只在 role == "book" 时传入 ItalyTurnstileRecovery;Query 准备未接入同一处理。此证据说明程序的处理缺口,不足以单独证明网站未生成 token 的全部原因。
授权修复:Query 与 Book 的首次 Calendar 准备共用现有恢复实例,继续复用 VFS 的 CloudflareBypasser.click_verification_button(is_dfs=False);不新增验证码算法,不修改公共 helper、登录逻辑或日期扫描。保持初始等待 5 秒、间隔 10 秒、跨 OTP 前后合计最多 3 次操作,且只有真实 token 与可用 AVANTI 同时就绪才允许继续。正常已准备 Calendar 的查询不进入该处理,Query OTP 仍为人工输入,最终提交仍关闭。
新增角色提示为 Italy query Calendar preparation: reusing bounded Turnstile recovery.;共用诊断沿用 ITA_BOOK_* 前缀以保持兼容,该前缀不代表调用了 Book。
验证:定向准备/验证框测试 25 项通过;Italy 19 模块回归共 553 项通过,均 exit 0。覆盖 Query 成功后只记录 Query 准备、点击成功但无 token 时三次后仍不发送 OTP、OTP 前后共享预算、已成功的验证框不重复操作、已准备 Query 跳过整个准备路径,以及既有 Book 回归。所有外部网站/邮件交互均为模拟;真实通过情况待复测。
以下命令替代第 9 节在本机直接使用默认账号/代理的启动命令。仍执行公共 PluginTester,只在内存覆盖账号与代理,不将私有密码写入被 Git 跟踪的配置或命令行参数。代理端口 6268 是本次本机诊断结果,不是其他机器的通用默认值。
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B -c '
from utils.local_account import load_local_account
from tools.plugin_tester import PluginTester
account = load_local_account("config/ita_query_account.local.json")
tester = PluginTester.from_json_config(
"ita_plugin", "config/test_conf.json",
user_override=account.username,
password_override=account.password,
proxy_override="http://127.0.0.1:6268",
)
raise SystemExit(0 if tester.run_pipeline(test_book=False) else 1)
'
echo "EXIT_CODE=$?"
现场只需配合页面要求的人机验证,并在终端提示后输入 OTP;不手动点击 OTP、AVANTI 或最终 Prenota。成功标准为验证通过、进入 Calendar 并获得 Query 结果,不能仅以 clicked=true 判定通过。如仍失败,收集固定诊断与页面错误文字,不记录账号、密码、验证码或验证 token。
用户已实测第 10 节修复:验证框操作一次后 token 就绪,人工 OTP 写入回读通过,Query 返回最早日期 2026-09-01,公共测试器全部通过、exit 0。
随后用户授权 Query 自动接码。现已复用 Book 的同一 OTP 分支及共享 SDK;95 项定向测试、561 项回归测试通过。Query 首次准备支持 otp_mode=cloud,已准备的扫描不再发码;最终提交仍关闭。
本地尚缺确认过的 mail.authorization_email,因此保留当前可用的 manual 测试配置,没有擅自猜测授权邮箱或转发关系。自动接码的配置、测试、信任边界与现场准出见 自动 OTP 文档第 10 节。本轮未运行真实网站/邮箱。
用户确认已在后台把测试账号加入 hkg.it.sentinel,并为同名 Gmail 登记了邮箱授权。以下配置取代第 11 节“缺邮箱配置”的现状,不把用户确认当成一次实际 API/邮箱连通性测试。
config/config_sentinel.json 新增 ita.hong_kong,保留 Dublin 与其他组;账号来源仍是原来的 Sentinel → VSCloudApi.get_next_account(),没有本地账号回退。一个实例,账号冷却与会话寿命均 1800 秒,参考 TLS 的对齐配置;查询间隔沿用现有 Random 策略(60–300 秒)。这不是网站限流安全性的证明。enable=false:仅完成本地配置,未发布云端配置、启动常驻 Sentinel 或连接 Redis/订单消费。main.py 仍沿用云端/缓存加载机制,不能把修改本地 JSON 当作已部署。4937、单人旅游表单、最多 12 个月扫描、首个正向月份即停止保持不变。otp_mode=cloud,mail.authorization_email=chatgptshareplus@gmail.com;密码/邮箱授权码仍只在既有后台,不写入新配置。config/test_conf.json 的香港 Query 同步自动 OTP 与邮箱配置;其中旧固定测试账号不作为本节验收来源。Book、公共测试器、共享 SDK、生产调度代码均不修改。本节命令已更新为 account-mailbox-v2(见第 13 节):允许池中不同账号,邮箱来源由当前账号决定,不再检查其是否等于最初的固定邮箱。
复用公共 PluginTester 和与 Sentinel 相同的 SDK 取号方法,不增加 Italy 专用运行器。仅运行一次 Query,不启动调度线程、Redis 或 Book;不等同于真实 Query → 订单 Book 联调通过。
下面命令由用户在自己的终端执行。本轮助手未执行:取账号会立即把该账号置于 30 分钟冷却,即使后续浏览器失败也不会自动解除;不要反复领取/重置冷却。若后台已有冷却记录,需要等待其到期。代理 6268 是此前本机已验证端口,若本机端口变化须先调整;只覆盖本次浏览器代理,不改系统或其他插件配置。
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B -c '
import json
from pathlib import Path
import configure
from plugins.ita_plugin import resolve_route_config
from plugins.ita_plugin import validate_cloud_otp_environment, validate_cloud_otp_logging
from toolkit.vs_cloud_api import VSCloudApi
from tools.plugin_tester import PluginTester
from vs_types import GroupConfig, VSAccount, VSPlgConfig
groups = json.loads(Path("config/config_sentinel.json").read_text())
group = GroupConfig.from_json(next(g for g in groups if g["identifier"] == "ita.hong_kong"))
route = resolve_route_config(group.free_config["apt_configs"], group.appointment_types[0].routing_key)
if configure.TEST_ACCOUNT:
raise SystemExit("Stop: TEST_ACCOUNT overrides the real pool; disable it first.")
validate_cloud_otp_logging()
print("ITA_POOL_QUERY_CONTRACT=account-mailbox-v2")
try:
raw = VSCloudApi.Instance().get_next_account(group.sentinel.account_pool_id, group.sentinel.account_cd)
except Exception as exc:
print("ITA_POOL_QUERY_ACCOUNT_FAILED type=" + type(exc).__name__)
raise SystemExit(1) from None
if not isinstance(raw, dict) or raw.get("pool_name") != group.sentinel.account_pool_id or raw.get("status") != "active":
raise SystemExit("Stop: backend did not return an active account from the expected pool.")
account = VSAccount.model_validate(raw)
if not account.password:
raise SystemExit("Stop: the pooled account is missing its Prenot@Mi website password.")
try:
validate_cloud_otp_environment(route.mail, account.username)
except Exception as exc:
print("ITA_POOL_QUERY_MAIL_CONFIG_FAILED type=" + type(exc).__name__)
raise SystemExit(1) from None
config = VSPlgConfig(account=account, debug=False, session_max_life=group.session_max_life,
free_config=group.free_config, proxy=PluginTester.parse_proxy_url("http://127.0.0.1:6268"))
tester = PluginTester(group.plugin_config.plugin_name, group_id=group.identifier,
config=config, appointment_types=group.appointment_types)
print("ITA_POOL_QUERY_SOURCE=cloud_pool pool=" + group.sentinel.account_pool_id + " book=false")
raise SystemExit(0 if tester.run_pipeline(test_book=False) else 1)
'
echo "EXIT_CODE=$?"
准出观察:出现 ITA_POOL_QUERY_SOURCE=cloud_pool;成功登录,自动 OTP 邮件读取和 DOM 回读通过;进入 Calendar 获得 Available+最早日期或有效 NoAvailable 结果;cleanup 成功、exit 0。不应出现人工输入 OTP 提示,也不要手动点击 OTP、AVANTI 或最终 Prenota;网站若要求人机验证,按页面完成。仅公共测试器显示“全部通过”不能单独证明当前有号,仍需看 Query 返回状态。
失败时只反馈错误阶段和脱敏日志;不贴后台账号响应、验证码、Cookie 或完整邮件正文。本节命令在取号前检查 DEBUG 邮件日志与 TEST_ACCOUNT 覆盖,避免把测试常量误认为真实池取号。
python -B -m unittest -q test.test_plugin_tester_ita_config test.test_ita_route_wiring:21 tests,OK,exit 0。test_ita_route_wiring。final_submit_enabled=true 被拒绝,不修改生产验证逻辑。git diff --check:exit 0。未创建真实浏览器、领取后台账号、读取邮箱、发布 Redis 信号或提交预约;自动接码现场结果待用户回传。2026-08-31,用户在收到第 12.1 节命令后回传公共测试器日志(本节证据来自用户终端,不是助手重新运行):
turnstile_token_pending;一次 helper 操作后实际 turnstileTokenPresent=true、outcome=ready。Italy query OTP sent; waiting for the authorized mailbox (one read attempt). 自动读取分支。ITA_QCAL_OTP_DOM_WRITE_VERIFIED matched=true;后续检查 otpValuePresent=true,进入 Calendar。所贴日志中没有人工 OTP 输入提示。probe index=0 available=0、index=1 available=11;首个正向月份即停止,返回 success=True、AvailabilityStatus.Available、earliest_date=2026-09-01。这是当时快照,不表示号源现在仍在或已被预留。EXIT_CODE=0。结论:该测试账号的自动 OTP → Calendar → 逐月最早日期 Query 单次真实链路已通过。 不再把该链路列为仅离线验证。
证据边界:本次截取从表单阶段开始,没有包含 ITA_POOL_QUERY_SOURCE=cloud_pool pool=hkg.it.sentinel book=false 或执行命令。若按第 12.1 节原命令执行,账号必经既有 SDK 池领取与返回池名检查,且无本地回退;仅凭这段后半程日志不能独立确认取号来源。需要补证时只补原运行的来源标记/确认命令,不为补日志重新登录、取号或发送 OTP。
第 12.1 节入口明确 test_book=False、配置最终提交关闭;本次回传未包含网络审计计数或预约前后基线,因此不将“零最终请求”记为本次独立 Network 实测。共享诊断沿用 ITA_BOOK_* 前缀不代表执行了 Book。
下一节点是原有 Sentinel → Redis 信号 → OrderBooker 的受控现场联调,Query 用池账号、Book 用目标用户账号,并在最终提交前停止。先落实隔离的信号/订单测试环境,避免误触正式订单;本次通过不等于常驻恢复、多人账号池、跨邮箱映射、真实 Book 或正式上线已验收。本轮只归档证据,不改变 enable=false,不启动任何外部流程。
用户新增池账号后,旧命令在 account.username != route.mail.authorization_email 或网站密码为空时退出。此检查是单账号验收命令的限制,不是 Prenot@Mi、SDK 或账号池要求。此前“加第二个账号就可直接重试”的说明遗漏了当前固定邮箱映射的前提;本节修正该限制。单独的 ITA_POOL_QUERY_ACCOUNT_FAILED type=BizLogicError 则只能证明后台取号失败,不能仅凭异常类型断言一定是冷却,需结合后台账号状态与 next_use_time。
plugins/ita_protocol.py 的既有 OtpMailConfig 增加显式 authorization_source,默认 configured 保留原有固定/转发邮箱行为;account 通过 mailbox_for(account_email) 按本次账号解析收件邮箱,不修改共享 route、不缓存上一个账号的地址。配置同时提供 account 与固定地址会被拒绝,避免静默读错邮箱。plugins/ita_otp.py 仍只调用既有 VSCloudApi.fetch_mail_content:账号来源模式将 email 和 recipient 都绑定本次账号邮箱;固定来源模式仍允许两者不同。固定 Prenot@Mi 发件人、主题、发送时间窗口、六位数字解析、失败不回退另一个邮箱/旧邮件、禁止 DEBUG 正文输出均保留。日志检查提取成共享 helper,供命令在领取账号前复用。mail: {"authorization_source": "account"},删除这两处固定邮箱地址;不改账号池调度、冷却、实例数、Book 配置或 SDK。enable=false 与最终提交关闭保持不变。ITA_POOL_QUERY_CONTRACT=account-mailbox-v2 和 ITA_POOL_QUERY_MAIL_CONFIG_FAILED。命令与正式 Sentinel 都使用生产 OTP 适配器,不只在测试命令里替换地址。池中每个账号需在 Prenot@Mi 绑定目标机构、可登录,且其自己接收 OTP 的邮箱已经通过 /api/email-authorizations 登记;应用专用密码仍由现有后台保管。此模式不自动创建邮箱授权、不猜转发、不把缺授权伪装成可用。若账号的 OTP 实际转发至统一收件箱,应明确使用原 configured 模式,而不是对所有池账号反复改一个固定地址。
多账号现场验收:等待已领取账号正常冷却到期,用第 12.1 节完整命令领取可用池账号,确认新命令版本、自动 OTP 写入验证、Query 结果及 cleanup/exit 0。助手本轮不领取账号、不发 OTP、不修改后台冷却。前一次单账号通过仍有效,但不能据此宣布本次新账号现场已通过。
git diff --check exit 0。2026-08-31,用户明确要求更新新账号冷却。旧命令在领取账号后才执行单邮箱限制检查,因此即使未启动浏览器,后台领取动作也已推进 next_use_time。本次只补偿这次失败测试,不永久缩短池的默认冷却。
hkg.it.sentinel 中新账号为 717、状态 active,原 next_use_time=2026-08-31T11:01:35 UTC(北京时间 19:01:35)。原账号 716 未修改。VSCloudApi.lock_account(717, lock_duration=0),仅发出一次 /api/account/update 请求。2026-08-31T10:46:24 UTC(北京时间 18:46:24),账号仍为 active,已满足时间上的领取条件。account_cd=1800 保持不变。没有领取账号、登录网站、读取 OTP 或运行 Query/Book,站点请求数为 0。此次更新只恢复可领取资格,不强制下一次领取账号 717;池仍按既有最早可用时间顺序分配。第 13.2、13.3 节“无后台操作”描述的是上一轮代码修改和离线验证,不包含此次单独授权的补偿操作。新账号自动 OTP + Query 现场结果仍待验证。
2026-08-31,用户要求复刻正常 Query 发布、Book 感知并执行的行为,不将云端测试订单和上线配置作为前提;随后明确授权实现。合同:existing-framework-local-prefinal-v1。
用户本轮另一次 Query 回传全部通过(94.66 秒),自动 OTP、两个月扫描、当时最早日期 2026-09-01。状态日志仍为原测试账号,不能作为新账号验收;该输出也不是 Redis → Booker 现场证据。
tools/debug_ita_query_book.py 默认仍离线;新增显式 --local-preflight、--local-run。旧 --run 继续拒绝,避免旧独立协调器命令误运行。tools/ita_query_book_local.py,不改变生产 Sentinel、Booker、Italy 插件、SDK 或任何线上配置。模式采用“现有对象组合 + 测试边界替代”,不是另写 Query/Book 调度器。OrderBookerGCO._spawn_worker、SentinelGCO._spawn_sentinel_worker、SentinelGCO._monitor_loop、BaseBookerGCO._booking_trigger_loop、OrderBookerGCO._execute_book_job 和两者 stop()。user_inputs 数据结构,供原 OrderBooker 读取;不领取、创建、更新正式订单,不发通知。任何未明确支持的云端操作拒绝执行;成功上报在进入异步执行器前阻断。setex、原 JSON envelope、原 key 和原 TTL,Booker 仍通过原 get/解析/路由/日期/冷却逻辑判断;工具仅记录发布内容摘要并核对接收内容一致,不复制信号解析或有效期逻辑。redis-server,只开放临时 Unix socket,不监听 TCP、不写 RDB/AOF、不使用共享 Redis、不执行 FLUSHDB/FLUSHALL。临时 Redis、连接和目录在退出时清理;不是常驻服务,也未调用 brew services start。先检查配置、Chrome、Redis 程序和本机代理端口,再获取 Book 用户资料;这些检查失败不领取池账号。先建立 Book 用户登录会话,再领取 Query 池账号并登录,最后执行一次原查询循环和一次原触发循环。这样不让信号在 Book 首次登录期间等待过期;Book 的 OTP/日历准备仍在原 Book 调用中执行。
循环仅通过测试中的退出事件限定一次迭代,不改循环内部业务。没有启动 creator/maintain/cache-refresh 常驻线程、云端配置热更新或订单回写;因此此入口验证的是真实单轮数据链路,不是常驻生命周期/云端订单链路验收。信号过期或日期不匹配时本轮不补发、不重试。
最终提交始终关闭,另对生产最终提交入口加测试拦截。复用 CalendarRequestAudit 和 verify_precommit_selection:两端最终请求必须为 0,单角色 OTP/AVANTI 不得超过一次;必须真实读回选中的日期、时段才可通过。pre-final 返回 bookResult.success=False 是既有合同,不能据此上报预约成功。
Ctrl+C 后停止并清理原 GCO、审计和浏览器;若已有 Book 线程正在等待 SDK 调用,保留云端/最终提交保护直到它退出,不提前恢复依赖、不重试。该等待遵循既有 SDK/浏览器超时,不承诺任意阻塞都能立刻退出。
池领取会按原规则更新冷却。若领取后才发现账号与 Book 用户相同,本轮拒绝继续且不自动解锁;选择一个不在 Query 池中的授权 Book 用户可避免这种情况。OTP 邮箱注册和网站账号所属机构是否正确,仍需事先满足,不能仅靠本地格式校验证明。
无需修改 config_booker.json,也不需要后台测试订单。保持本机代理 127.0.0.1:6268 可用;Book 用户接收 OTP 的邮箱须已登记。执行:
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B tools/debug_ita_query_book.py \
--local-run \
--group ita.hong_kong \
--proxy http://127.0.0.1:6268
echo "EXIT_CODE=$?"
随后在本地终端输入 Book 目标用户 的网站邮箱和网站密码(密码隐藏输入;不写入文件,不在聊天发送)。Query 账号自动从池中取得,不手填。也可显式使用既有私有 --book-account-file 或 ITA_BOOK_USERNAME/ITA_BOOK_PASSWORD;不会自动借用 Query 本地账号文件。
默认使用生产 Book 的无额外日期限制行为,只做 pre-final 选中验收;需要测试用户日期限制时,入口接受 --expected-start-date / --expected-end-date 并原样进入现有订单过滤与 Book 日期选择。地区、service id、表单和邮箱策略均从所选 Query group 复制,不在装配模块硬编码香港服务号。
只做环境检查、不开浏览器不取号:
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B tools/debug_ita_query_book.py \
--local-preflight \
--group ita.hong_kong \
--proxy http://127.0.0.1:6268
echo "EXIT_CODE=$?"
其他机器若提示 redis_server_missing_run_brew_install_redis,需安装 Redis 可执行程序;不要因此启动共享 Redis 或手工改信号 key。两窗口若出现人机验证,按页面要求处理;不要手动点击 OTP、AVANTI 或最终 Prenota。
成功摘要 ITA_QUERY_BOOK_LOCAL_RESULT 应同时满足:passed=true、outcome=pre_final、queryCalls=1、bookCalls=1、signalPublished=true、signalReadByBooker=true、selectionVerified=true、cleanupVerified=true;两端审计 finalRequests=0,EXIT_CODE=0。
有效无号、日期过滤/过期不触发、Book 重查后无号均不伪装成完整联调通过,返回 exit 2;异常/清理失败返回非零。只有真正提交并核验新增回执的后续阶段才能宣称预约成功。
--local-preflight:exit 0,ready=true;未创建浏览器、领取账号、读取邮件或访问 Prenot@Mi。--offline 仍不启动 Redis 子进程。time.sleep 替换为 Mock,导致测试未真实等待到期;修正测试为使用替换前的真实 sleep 后通过,未改生产 TTL。--local-run 回传;本轮不把历史单端成功拼成新的现场联调通过。未提交、部署或启用常驻分组,最终预约仍关闭。2026-08-31,用户回传 existing-framework-local-prefinal-v1 摘要与 EXIT_CODE=0。
这是用户自己终端的真实验收证据,不是助手重跑,也不延续第 14.4 节的“尚待现场验证”状态:
liveAcceptance=true、passed=true、outcome=pre_final;queryCalls=1、bookCalls=1。signalPublished=true、signalReadByBooker=true;原框架真实 Redis 发布/读取已在本轮贯通。2026-09-01;Book 重查后选中同日 10:05 - 11:05,selectionVerified=true。cleanupVerified=true、cloudOrders=false、finalSubmissionEnabled=false。v1 入口强制不同账号、真实池领取及各自会话;该摘要不包含账号身份,不据此断言具体领取哪个邮箱。 本轮只证明实时单轮协同到提交前;未创建预约、不验证云端订单回写/通知或常驻恢复。日期时段是当时快照,没有锁位。
2026-08-31,用户明确表示“我现在要的就是真实提交”。在原本机联调工具内增加
--local-run --submit-once,最初合同为 existing-framework-local-submit-once-v2;用户随后明确要求无需确认输入,
现行合同为 existing-framework-local-auto-submit-once-v3(见 15.5)。
默认 --local-run 仍是 v1 pre-final;离线/预检不能携带 --submit-once。
tools/debug_ita_query_book.py:只增加显式 CLI 开关/互斥校验和离线用例入口。tools/ita_query_book_local.py:原组合装配增加独占防重复记录以及真实结果观察;
Query 的配置副本仍 final=false,只有本次 Book 内存副本设为 true,原配置文件完全不变。ItaPlugin.book → ita_workflow.book → 原生产 submit_final →
FinalBookingAttempt / NativeFinalSubmitter / FinalReceiptReadPort,没有重写提交接口、回执匹配器或轮询器。VSBookResult(success=True) 后走原 Booker 成功分支;本地仅在原通知入口之前截获,
不进入异步云端订单更新/通知。unknown 保留原异常类型,走原暂停分支,仅将本地合成任务标记 pause。--local-run --submit-once 即启用自动真实提交,不要求交互终端。读取 Book 凭证后,先检查该申请人/服务的本地防重复记录,再创建浏览器或领取 Query 池账号。automaticSubmission=true,直接进入原生产最终流程,不等待确认句或按键。tools.ita_final_evidence.claim_once 的 O_EXCL + fsync 独占写入;然后只调用一次原生提交器。Confermata 回执,才返回 Book 成功。页面跳转、HTTP 200 或按钮点击都不能单独算成功。bookingConfirmed=true、bookResultSuccess=true、successHandledLocally=true、
passed=true、outcome=confirmed、Query final=0、Book final=1、清理通过、EXIT_CODE=0。
selectedTime 是选择的时段,confirmedTime 是网站实际分配的时刻,二者不必是同一字符串。防重复文件位于既有私有目录的 query-book-final/<sha256>.claim;hash 绑定站点、规范化账号及 service_id,
不绑定本轮 run id/日期/routing alias,重启或换路由别名不能自动再提交。文件内容只有已尝试状态,无密码、邮箱、验证码或预约编号。
独占记录不自动清除;不同申请人的记录彼此隔离。这只是本 checkout 的验收防重复措施,不是分布式生产锁。
旧 final-evidence-once.claim 不删除、不重置、不复用为新账号身份依据;docs/ita_book_cs5.md 第 29 节已有确认预约仍受网站基线检查保护,不重建或取消它。
提交后无法核验返回 outcome=unknown_do_not_retry、EXIT_CODE=4;即使响应丢失也不二次提交。
已经核实成功但诊断清理失败,同样保留 bookingConfirmed=true 并返回非零/4,不能为了修复清理而再预约。
无号或信号/日期过滤未触发返回 2;预提交配置/基线失败返回 1。本工具不恢复云端订单写入,不宣称全生产常驻链路已经上线验收。
保持本机代理可用,在用户自己的终端执行(这次会真实占用预约名额):
cd /Users/zhangwei/JSWorkSpace/open_source/coordinate
source .venv/bin/activate
python -B tools/debug_ita_query_book.py \
--local-run \
--submit-once \
--group ita.hong_kong \
--proxy http://127.0.0.1:6268
echo "EXIT_CODE=$?"
输入目标 Book 用户的网站账号/密码;Query 自动从池中领取,双方自动 OTP。
选位后自动提交一次并核验回执,不要求输入 BOOK 确认句。运行前用可选日期范围参数表达真实可接受范围;未指定则沿用生产 Book 的无额外日期限制行为。
除按网站要求完成真人验证外,不手动点击 OTP、AVANTI 或最终 Prenota。
如果配置过 ITA_BOOK_USERNAME/ITA_BOOK_PASSWORD 或通过 --book-account-file 指定私有账号文件,沿用原凭证读取规则,无需再手填网站账号密码。未配置凭证时仍在启动阶段询问账号密码,这与最终提交确认无关。
可选日期范围参数继续复用原订单过滤,不在本工具硬编码香港日期或时段。
反馈 ITA_QUERY_BOOK_LOCAL_RESULT 和退出码即可,不贴密码/OTP/邮件正文。EXIT_CODE=4 时不要重跑,先核对预约回执。
patch.dict(cloud.__dict__) 会在退出时恢复运行前计数;改为仅添加/移除本地暂停方法,累计状态不再被恢复,重启断言及回归通过。git diff --check 均通过。未登录网站、读取真实邮箱、领取真实池账号或提交预约。用户指出完整确认句不符合自动 Book 的预期。该额外步骤由验收工具引入,并非生产插件要求;现已移除。
删除 confirm 回调、确认句输入、拒绝确认分支及最终提交对 TTY 的额外要求;不自动输入确认句来绕过旧逻辑。
CLI --submit-once 是显式开关:启动后按原订单日期条件完成选位、原生产最终提交及回执核验。
Query/默认 pre-final 仍关闭最终提交;已有预约检查、申请人绑定、独占防重复记录、未知结果暂停和退出码 4 均保留。
未改生产插件、共享调度器、OTP、账号池或线上配置;未读取/清除已有 claim,也没有运行真实提交。
更新离线用例:最终链路在 builtins.input 被设为一调用即失败时仍通过;配置了 Book 凭证的非交互启动无需 stdin;
原有无号、日期过滤、身份不符、已有预约、重复提交及未知回执用例继续保留。默认离线 CLI 66 项通过(exit 0);
与 15.4 相同的 20 个 Italy 模块回归 597 项通过(8.442 秒,exit 0)。CLI help 和 git diff --check 通过;真实提交尚待现场回传。
用户回传 v3:Book 已到达认证 /UserArea,随后 pool_allocation_failed;Query/Book 调用均为 0、
possiblySubmitted=false。后台只读查询(北京时间 2026-08-31 20:18:38)确认池内 716/717 均 active,
可用时间分别为 20:27:14 / 20:35:37,当时均不可领取;这次失败不等于 Book 登录失败或已经提交。
随后用户明确授权“都放开吧,我们要测试啊”。重新核对 hkg.it.sentinel 仅包含这两个 active 账号,
逐项更新前再次比较账号业务身份和原 next_use_time,然后各调用一次既有
VSCloudApi.lock_account(id, lock_duration=0),不重复重试写入。
现场证据:用户回传 v3 已完成 Query、信号发布/读取、Book 自动 OTP 和选位,
selectionVerified=true、selectedDate=2026-09-01、selectedTime=10:05 - 11:05;
随后 bookErrorType=CalendarGateError、finalRequests=0、possiblySubmitted=false。
这不是这次预约已成功或名额已保留的证据;失败发生在最终请求之前。
确定根因:ObservedPlugin.create_session() 已在 Book page 的 CDP driver 注册
CalendarRequestAudit。随后原生产 ita_workflow.submit_final() 又创建并启动第二个 audit,
触发原有保护 Passive request audit cannot replace an existing callback,
尚未创建 FinalBookingAttempt,也尚未执行 native submit 或写入本轮 claim。
此前最终链路测试将内外两个 audit 都 Mock 掉,掩盖了这个真实组合冲突。
本次最小修复:
plugins/ita_workflow.py:增加可选 keyword-only request_audit,借用调用方已启动的审计。
未传入时,普通生产调用仍自行创建、启动、停止;借用时不注册、不停止,不产生监听空窗。tools/ita_query_book_local.py:将现有 Book observer 的 audit 显式传给原生产最终流程,
不新增事件分发器、不复制提交或回执核验逻辑。真实模式合同升为
existing-framework-local-auto-submit-once-v4,命令/自动 OTP/自动提交行为不变。plugins/ita_calendar_session.py:核对借用方页面、driver、连接状态和原回调所有权;
每次实时 snapshot 同样核对所有权。最终审计必须包括时段请求;不覆盖其他回调、
不将断连后的 retained counters 当作最终请求证据。新鲜验证(2026-08-31,本地离线):
LocalFinalTests 的两个 Mock audit 换为真实 audit,保留合成浏览器/CDP 传输和时钟:
原成功用例立即失败(exit 1),与现场同样为选位成功、CalendarGateError、最终请求 0。RealFinalAuditTests 9 项,覆盖借用/独立所有权、原拒绝覆盖保护、已有预约、
错误页面/driver/断连/停止、回调被替换(含提交过程中)、缺时段覆盖,以及缺失/重复/混入其他请求不能归为成功。test_debug_ita_production_query_gate、test_ita_calendar_soak、
test_debug_ita_book_gate、test_debug_ita_reservation 的真实审计生命周期回归。python -B tools/debug_ita_query_book.py --offline:75 tests,OK,0 skipped,exit 0;
--help 与 git diff --check 通过。未登录网站、分配/解锁账号、发送 OTP、读取真实邮箱、重置 claim 或提交预约;未提交/推送代码、未部署。
本轮按 phase-gated-delivery 限定为监听组合修复和离线验证。真实 Query → Book 最终成功仍需用户按 15.3 命令现场验收;
本次离线成功不替代新增预约回执。遇到 possiblySubmitted=true 且结果未知/exit 4 时,仍先核验回执而非重跑。
2026-08-31 20:51:36 +08,用户再次授权解除 hkg.it.sentinel 的当前冷却。
先通过现有 SDK session 对 /api/account/list_all 做只读查询:默认连接两次分别在 15/20 秒超时;
确认本机 6268 代理端口可连接后,经该代理只读查询同样在 15 秒超时(均 ReadTimeout)。
未取得新鲜账号状态,因此本轮 没有发出任何账号更新/领取请求,没有改默认冷却、领取账号或预约。
当前冷却是否已自然到期也未核实;不能沿用 15.6 的旧读回结果宣称本轮已解除。待后台连接恢复后再核对并更新。