# Italy 生产代码精简盘点 日期:2026-09-01。原盘点基线为 `plugins/ita_plugin.py` 3566 行;R1/R3/R2/R4/R5 后当前为 2598 行,SHA-256 `2af5585124d6e73892a0043c24da1a8014f154644906dca356d6df43a9b71569`。 本文件是后续实施的删除清单,不是另一个设计。若与 [技术方案](01-technical-design.md) 冲突,以技术方案和用户最新指令为准。 CR-001 已确认两项结构性减法:敏感日志脱敏层可在本轮删除;最终提交失败统一交回 Booker 普通重试,Italy 不再维护跨调用的未知暂停、持久提交 fence 或复杂 reconciliation 状态机。 ## 1. 结论 当前问题不是算法慢,而是同一事实被多层对象、快照、验证器和诊断接口重复表示。 R3 以宿主 Booker 替代 Italy 专属提交状态机后一次净减 649 行,证明整块删除有现成宿主 归属的职责有效;R4 删除重复表单表示和状态类 71 行,R5 删除生产 profile/锁与诊断状态 154 行。当前仍需从 2598 行净减约 1598 行, 不能退回逐个包装器微调,也不能把 Italy 专属逻辑搬入公共文件冒充精简。 后续改为整块收敛:以 `ItaPlugin.query()`、`ItaPlugin.book()` 和宿主生命周期为生产 合同,保留真实网站协议和必要安全边界;删除只为离线取证、私有测试接口或历史迁移 存在的生产结构。测试迁移到公开行为和少量协议边界,不再以“旧私有符号仍存在”作为 兼容条件。 ## 2. 当前分区与目标 | 分区 | 当前行数 | 目标 | 主要删除对象 | | --- | ---: | ---: | --- | | 配置、协议和库存模型 | 404 | 140 | 多层字段验证函数、仅用于展示的状态枚举、嵌套配置包装 | | Query 日历 | 362 | 120 | 请求监听、月份导航和必要解析;R2 已删除独立扫描结果层 | | Book 日历 | 551 | 180 | 日期/时段上下文和读回包装;R2 已删除提示日期优先双扫描 | | 最终提交与明确响应判定 | 135 | 200 | R3 已低于预算;不再继续为行数删除一次点击和严格匹配 | | 表单、OTP、Turnstile 和准备工作流 | 497 | 220 | R4 已删除多阶段快照模型、日志门禁和恢复状态类;剩余是页面脚本、OTP 与线性准备 | | 登录、插件入口和生命周期 | 758 | 120 | 调试专用持久 profile、重复身份字段、私有工具钩子和转发层 | | 组织开销 | 45 | 20 | 历史分区说明与不再准确的迁移注释 | | **合计(R5 前盘点)** | **2752** | **1000** | R5 后实测 2598;需重新划分剩余结构,不自行扩大总预算 | 目标不是通过压行、分号或外置巨型字符串取得。每批同时记录生产文件行数、公共生产 代码变化、测试结果和被删除行为的归属。 ## 3. 直接复用的公共能力 | 能力 | 现有来源 | Italy 动作 | | --- | --- | --- | | 插件接口与宿主调度 | `IVSPlg`、Sentinel、Booker | 只实现接口;不实现池子、Redis、退避或订单状态机 | | 浏览器、代理、指纹 | `init_chromium_options` | 直接调用;Italy 只提供账号、代理和目录 | | 登录流程调度 | `BaseFlow`、`on`、`guard`、`done` | 只保留 Prenot@Mi 页面规则 | | 鼠标与键盘 | `HumanMouse`、`HumanKeyboard` | 直接使用,不包装第二层交互框架 | | 日期范围 | `filter_dates_in_range(..., shuffle=False)` | Query 取首个正向月最早日;Book 按用户范围重查 | | 邮箱 OTP | `VSCloudApi.fetch_mail_content` | 只保留 Italy 发件人、模板、当前账号和发送时间约束 | | 公共返回与异常 | `VSQueryResult`、`VSBookResult`、现有异常 | 不再创建平行的业务结果体系 | | 清理 | `cleanup_browser_workspace` | 直接复用现有默认合同;不修改公共签名,不复制目录/隧道销毁逻辑 | `perform_browser_fetch` 只有在 H-04 真实对照通过后才能替换月份原生请求。当前不为了省行 擅自切换生产传输。 ## 4. 不下沉到公共模块的内容 - Prenot@Mi 的双层 JSON、服务 ID、日期/时段字段、DOM 选择器和最终提交参数。 - Turnstile 页面状态和 Prenot@Mi 的 OTP 表单。 - Calendar 原生请求监听。它目前只有 Italy 一个生产消费者;移到 `utils` 只是搬家。 - 预约列表与最终回执语义。VFS/TLS/BLS 的网站结构不同,强行抽象会制造新的框架。 只有出现第二个真实插件消费者,或补全现有公共函数的通用返回能力时,才向后兼容扩展 公共模块。新增公共基类会使单文件热更新依赖宿主先升级,本轮不采用。 ## 5. 五个结构性工作包 ### R1:协议与配置 保留一份路由对象、日期对象、时段对象和稳定协议异常。配置在入口一次校验;日历与时段 共用一个双层 JSON 解码器。删除只为层层转发存在的 `CalendarScanConfig`、`InventoryState` 和 重复模型校验。`FormControlConfig` 暂保留为两个页面控件共用的三字段命名结构;把它展平成 route 六个字段或位置元组既不会减行,也会降低表单脚本可读性,后续只随 R4 一起重估。 通过标准:服务/能力/月份、双层 JSON、日期、库存、时段 ID、OTP 六位 ASCII 和账号邮箱 约束仍失败关闭;不同领区继续只由配置决定。 ### R2:Query/Book 日历(已完成离线实现) 保留一个严格、不可变的 `CalendarProbeResult` 作为网站月份边界,以及一个只读逐月扫描和 “日期→时段→选中并读回”调用链。Query 在首个正向月份停止并返回最早日期;Book 使用申请人 会话重新扫描并选最早合格时段。`CalendarQueryScanResult`、`_CapturedMonth`、初始/下一月二行 包装和提示日期优先双扫描已删除;Query 诊断只保存不可变月份元组,不保存第二份候选状态。 当前结果:R2 为 2883 → 2823,净减 60 行;Query 分区 385 → 362,Book 分区 588 → 551。 Query 信号日期只负责唤醒,不再覆盖申请人库存中的更早日期;日期售罄仍按申请人当前响应尝试 下一候选。保留一个边界对象是为了月份、服务和库存输入失败关闭,不用位置 tuple 代替命名协议。 通过标准:Query 最终请求恒为 0;Book 不使用 Query 会话的 Cookie、OTP 或运行时 ID; 日期有号但时段耗尽时继续下一候选。 ### R3:最终提交与结果(已完成离线实现) 不再保留申请人交易对象、跨调用提交状态机或持久 fence。`book()` 在当前申请人会话中完成 服务/日期/时段复核后点击一次;网站能给出可归属的明确成功结果才返回成功,拒绝、断线、 超时或证据不足一律返回普通失败。现有 Booker 负责后续重试调度;Italy 不复制重试机制。 生产请求审计、复杂历史回执 reconciliation、详情协议和多套快照/观察对象从生产删除,必要 现场取证继续由现有 `tools/` 完成。 当前结果:最终分区 770 → 135 行;单次 `book()` 最多一次最终点击;失败正常返回宿主;下一次 调用重新进入服务、准备日历、读取库存并取得新运行时 ID,健康登录可复用。无插件内循环重提、 通道切换重发或失败误报成功。离线标准已通过,真实网站成功仍属于 W6/RC-09。 ### R4:表单、OTP 与验证等待(已完成离线实现) 一个 `prepare_calendar()` 顺序完成:表单字段→Privacy→Turnstile 就绪→发送一次 OTP→从 当前账号授权邮箱读取→写入并核对→AVANTI→确认 Calendar。生产只返回“已准备”或明确 异常;详细快照和请求计数留在调试 gate。 当前结果:R4 为 2823 → 2752,净减 71 行。约二十字段 Python 快照收为五个布尔事实;删除 生产 `BookingPreflightStage`、`validate_cloud_otp_logging` 和 `ItalyTurnstileRecovery`。 Turnstile 仍复用 VFS 已用的 `CloudflareBypasser`,OTP 仍复用 `VSCloudApi`,Book 重试仍由 宿主承担;公共生产代码未增加。底层脚本对表单来源、字段、同步、单人、Privacy、未知必填项和 唯一控件的检查没有删除。R4 原目标 220 行未达到,因此不能把该包标为总预算通过。 通过标准:不固定邮箱;不读取旧码回退;不自动重发 OTP;邮件正文只作数据;人工验证有界 等待;未知必填字段失败关闭。 ### R5:插件入口与生命周期 对齐 VFS/TLS:临时浏览器目录、公共初始化、`BaseFlow` 登录、健康检查、公开 Query/Book、 公共严格清理和状态快照。日历准备上下文只保存当前实例、页面、账号、角色、路由和运行时 服务。调试专用持久 profile 与 soak 恢复不再支配生产结构,由对应工具拥有。 通过标准:生产配置、池子 Query、独立申请人 Book、热更新和清理行为通过;另一个实例不能 复用准备状态;现行支持命令无隐藏 ImportError。 当前结果:R5 为 2752 → 2598,净减 154 行。生产不再解释本地持久 profile 配置,也不拥有 profile 文件锁;`utils/ita_local_profile.py` 仅由 Italy 本地工具显式绑定和释放。扫描摘要、 预提交观察及重复 Book 状态改为工具观察真实返回值;准备上下文只保留当前 page/tab、账号、 代次、route、role 和运行时服务。公共 `cleanup_browser_workspace` 恢复并保持 HEAD 原签名, VFS/TLS/BLS 和 `utils/plugin_utils.py` 均为零差异。当前 384/280/75/27 项离线回归通过。 后续事实变化:上述本地 Italy 调试工具已删除,`utils/ita_local_profile.py` 因而失去最后一个 运行调用者,现已连同专属测试删除。生产继续使用实例临时工作区,不恢复持久 Profile 配置。 ## 6. 测试取舍 保留并优先执行: 1. `query()` 的无号、首个正向月、认证失效、限流和最终请求为 0。 2. `book()` 的独立账号、自动 OTP、日期范围、库存竞争、预提交和一次最终提交。 3. 成功、拒绝、超时/断线普通失败、连续独立调用和跨账号结果归属。 4. 两套不同服务配置、插件测试器、Sentinel→Booker 离线串联和单文件热更新。 5. 公共 VFS/TLS/BLS 回归,证明公共函数改动没有退化。 迁移或删除:只断言私有类名、私有字段数、诊断 JSON 键全集、历史脚本源码字符串和旧分层 调用次数的测试。测试数量不是准出条件;公开行为覆盖和零 skip 才是。 ## 7. 实施顺序与停止条件 顺序为 R1→R3→R2→R4→R5:五包均已完成,但 2598 行仍未达到 RC-01。下一结构包重新审计日历捕获、选择和表单脚本的重复表示;每包开始前记录基线,结束后记录差异、测试和剩余预算。 若某包为了保留真实行为不能达到其预算,先在 [可行性分析](02-feasibility.md) 记录证据并调整下一包结构;不靠删除安全断言补数字。 任何包出现以下情况立即停止并修正:Query 触发最终写入、Book 复用池子会话、OTP 可能读取 错误账号、同一次 `book()` 出现多次最终点击、重试复用旧运行时 ID、失败被误报成功、单文件 热更新依赖新增 Italy 运行时文件。