02-feasibility.md 13 KB

可行性分析、假设与风险

版本:1.1;日期:2026-09-01;依据:技术方案。

方案覆盖 CR-001:用户已明确接受调试阶段记录 OTP、Token 与敏感表单,并接受最终提交按普通失败由 Booker 后续重试。旧的“敏感信息绝不落日志”和“未知结果必须暂停”证据仅描述历史实现,不再是当前架构前提。

1. 结论

精简方向具备明确可行性:当前 Italy 大量重复了已有浏览器初始化、流程调度和内部校验;公共接口、网站协议及查询到预提交的历史证据已经存在。

但“可以明显减少代码”不等于“1000 行版本已经可靠”。约 1000 行是本次交付目标,能否在保留全部必要行为的前提下达到,必须由实际重构、行数统计和行为测试证明。不能保证外部网站持续有号或不改变页面,也不使用“100% 信心”替代证据。

约 1000 行的新版本尚未完成。W1、W2 及 W3/W4/W5 局部改动已有证据,见 执行记录;R5 后当前 2598 行,比 6286 行基线减少 3688 行,仍需净减约 1598 行,不能据此宣称总预算可行性已经证明。R2 已统一 Query/Book 月份表示,R3 已删除 Italy 专属提交状态机,R4 已把表单准备压成五字段合同,R5 已把持久 profile、锁和诊断观察状态移出生产。R5 实际只净减 154 行,说明剩余预算必须从日历捕获、选择和表单脚本的重复协议表示中取得;不能靠继续清理入口或修改其他插件达标。以下所有未执行实验保持待验证,不把离线结果标成现场通过。

2. 已有证据及其边界

证据 已能说明什么 不能说明什么
代码基线 a22596f1fcdffb946960724ef299f249e7860891 Italy 是 6286 行单文件,VFS/TLS 已调用公共工具 不能证明压缩后仍正确
公共 init_chromium_options、BaseFlow 等源码 可替换一部分重复机制 不能直接证明持久化清理、登录刷新语义完全等价
用户历史 Query 日志 旧版本曾逐月查到最早日期、首个正向月份停止 不能证明当前库存、纯 HTTP 可用或新版本已通过
用户历史自动 OTP/Book 预提交日志 旧版本曾自动读码、进入日历、选中可用时段,最终请求为 0 不等于真实预约成功,更不等于重构后的成功
现有最终提交、回执解析及测试源码 已有可迁移的请求字段和核验逻辑 不能替代新版本真实提交与回执验收
单文件安装器和工厂 现有交付路径只需 Italy 插件文件及已安装宿主公共依赖 新公共 API 不会随插件单文件自动安装

文档建立时未重新运行原业务测试;其后 W0 已补齐基线,W1 和 W2 已实现部分 已回归。没有访问真实站点或邮箱,不能据此证明现场登录、API 等价或真实预约成功。

3. 假设与验证计划

编号 假设/问题 验证办法 通过标准 不通过怎么办
H-01 公共初始化和 BaseFlow 可替代自建生命周期 对照新旧选项、登录页面序列和错误分支;模拟一次提交后长时间停留 参数等价,能到认证页,凭据只提交一次,无额外刷新 保留必要 Italy 页面规则,不复制整套调度器;记录公共缺口
H-02 公共清理足以兼容持久化目录/锁 模拟页面退出失败、隧道失败、目录删除失败及二次清理 不删持久化目录,不误判释放完成,不让另一实例接管仍占用目录 使用小范围向后兼容扩展,先验证 VFS/TLS 原调用
H-03 一套月份读取可服务 Query 和 Book 同一组日历夹具驱动两个公开接口;不同账号/服务/日期范围交叉测试 共用解析与读取但不共享 Cookie、运行时 ID、选中状态 仅保留必要的业务分支,不复制整套扫描流程
H-04 日历接口可替代部分 UI 操作 先以脱敏样本确认请求参数,再在获授权会话中比较原生请求与候选读取方式 同服务、同月份结构与语义一致,无预约写入,无认证/验证回退 保留原生浏览器读取;不阻塞其他精简,也不宣称纯 HTTP 可用
H-05 减少模型层不会削弱协议判断 双重 JSON、日期、库存、运行时 ID、未知结构和边界值回归 异常仍明确失败,不把错误当无号;正向样本一致 修正集中解析边界,不恢复层层重复对象
H-06 表单/OTP 可压缩为一个准备步骤 模拟字段延迟、验证码前导零、过期/旧码、验证等待与多次 Query 有效会话只准备一次;发送/读取有界;账号绑定不变 修正准备状态,不增加新的邮件服务或自动重发策略
H-07 薄提交路径可使用宿主普通重试 注入成功、拒绝、丢包、超时、错误回执及连续两次独立调用 单次调用最多一次最终点击;可确认成功才返回成功;其余返回普通失败;下一次调用重新准备/重查/选择,不复用运行时 ID;健康登录可复用 若宿主不能重试普通失败,先修正适配或配置;不在 Italy 内新增重试调度器
H-08 完整实现可收敛到约 1000 行 每个工作包统计文件行数和新增公共代码;在 W3/W5 重估剩余预算 总预算成立、无隐藏 Italy 运行时文件、主流程可读 提交具体超预算原因与替代方案,用户确认前不扩大上限
H-09 领区差异可由现有配置表示 至少两个不同服务 ID、路由及表单取值的合成配置;香港现场一次 无香港/邮箱/日期硬编码,错误领区不继续提交 显式标为配置能力缺口;不谎称所有领区已实测
H-10 工厂热加载及现有宿主不受影响 单文件安装、两个版本重载、多实例及真实宿主方法离线测试 新实例用新代码,旧实例停止,共享公共类型和暂停语义不丢失 修复加载/绑定,不新建打包器或自定义缓存框架
H-11 私有接口精简不会损坏常用工具 盘点所有导入 Italy 私有类型的测试/调试工具,逐项迁移并执行 现行支持命令可启动且调用新实现;废弃命令有明确替代 不发布留有隐蔽 ImportError 的工具集,不用旧实现充当兼容层

H-04 为可选优化实验;其他假设关联必需行为或结构验收。未通过 H-04 时,以浏览器路径完成同样的约 1000 行目标,不降低 Query/Book 范围。

4. HTTP 可行性实验的具体边界

  1. 只选择已有协议证据的日历/时段读取请求。POST 不一定是写入,GET GenerateOTP 也不是无副作用;按实际业务作用分类。
  2. 当前账号、服务和月份固定;原生浏览器结果与候选结果可保留完整调试摘要,包括本轮用户允许的 Token 或敏感表单。
  3. 至少覆盖无号月、正向月、选中日期时段和认证失效;并发库存变化导致差异时,不能硬判等价,需重新取得可比较样本。
  4. 记录响应状态、路径、字段、月份、正向日期集合和请求副作用;当前阶段允许调试输出包含 Cookie/Token、验证码和敏感表单,但不得因此把真实秘密写入 Git。
  5. 没有授权或真实条件不足时,只报告离线验证,候选传输路径不成为默认实现。
  6. 不通过增加账号/IP轮换、重复登录、无限重试来“证明 API 可用”。

5. 主要风险与处理

风险 影响 处理
为凑行数删除了关键行为 假阳性有号、错号或重复预约 行数与行为双验收;RC-01 不能替代其余准出条目
用 utils 隐藏专属代码 Italy 看起来短,项目仍然复杂 统计新增公共代码与真实消费者;禁止 Italy 专属运行时外移
直接复用公共函数改变语义 排序随机化、重复登录或持久化目录被删 H-01/H-02;调用参数和异常语义单独回归
网站文案、DOM、库存变化 测试环境不稳定 结构化字段优先,未知结构明确报错;保留脱敏样本及实测日期
邮件服务超时或返回旧内容 错码、连续发码、风控 保留时间窗和账号绑定,单次发送/读取,不回退 fetch-top
清理失败掩盖已成功预约 下一次普通重试可能再次预约 单次调用只点击一次并尽量读取结果;失败交回 Booker。此重复风险由用户在 CR-001 中明确接受,不再用 Italy 专属暂停状态机规避
旧调试工具紧耦合旧类 插件可用但验收命令损坏 W0 先列消费者清单;W5 统一迁移,不保留第二套生产实现
新公共 API 未部署到宿主 单文件更新后 ImportError 优先零新增公共依赖;有扩展则记录最低宿主提交和部署顺序
现场没有号/账号不可用 无法证明真实提交成功 继续离线和预提交验收;不能标记 RC-09 完成,也不能占用无关预约

6. 可行性判断更新方式

每个工作包结束更新相关 H 编号:待验证、通过、失败或条件成立。必须附代码版本、测试编号/命令和观测结果。

截至最新 W3 / W4 记录:

  • H-01、H-02 已列离线场景有通过证据,现场效果仍待 W6;仅供 soak 的跨实例 checkpoint 已从插件公开入口归位工具,生产 Sentinel/Booker 仍按 health_check → cleanup → create_session 重建。H-06 的表单、OTP 绑定及服务入口已收敛为同一五字段合同和线性准备流程,相关离线场景通过;真实网站仍待 W6。
  • H-03 的共用月份捕获已有离线证据:真实公开 Query 与 Book 共用 _capture_month,但账号、页面和运行时参数各自持有;申请人侧旧日期已售罄时选择其下一候选。该测试没有替换 query()/book() 或在测试内重写业务算法。H-04 已有显式、默认关闭的只读对照探针和离线错误/副作用测试;尚未在获授权现场同时取得空月与正向月等价证据,因此生产仍不切换。
  • H-05 的库存模型、统一解析及页面读回已部分收敛。每个 Book 捕获响应只解析一次,候选筛选/DOM 等待已合并;日期和时段脚本现使用同一五字段语义合同,但内部仍逐项检查最后一位库存、冲突计数、服务/日期/ID/时间/容量、CSS、只读不得点击和点击前账号变化。第一轮实际 Node 测试发现并修复点击后日期漂移未绑定选中语义的问题;当前 Italy 385 项、调试 280 项通过,不代表整个协议/模型层已精简完毕。
  • H-06 的当前准备上下文已统一,普通 Query 的读取前后与准备登记中均核对身份;生产不再导出跨实例恢复参考。soak 工具的受控恢复仍只保存 route/账号/profile/URL/服务比较值,并由迁移后的参数化测试覆盖,现有手动诊断和自动 OTP 合同保留;现场仍待验证。
  • H-07 已有当前离线证据:严格匹配的明确成功才返回成功;网站拒绝、监听超时和请求不匹配均在一次点击后返回普通失败并清除日历准备;错误申请人或已清除上下文不会点击;原 OrderBookerGCO 在失败后保留任务,并可在下一信号完成新的服务/日历准备后再次调用。真实网站成功与跨进程现场调度仍待 W6,因而 RC-05/09 尚不能整体通过。

表单收拢补充:生产与现有日历调试入口现在使用同一有边界校验的脚本生成器。两套配置、重复业务控件、原生 change 离页和两阶段 OTP 的实际 Node 证据已增加;原账号/发送窗口、单次 OTP、单次提交及回执规则未修改。R4 将约二十字段快照收为五个布尔事实,删除生产阶段枚举、日志门禁及恢复状态类,2823 → 2752、净减 71 行。utils/network_interceptor.py 会暂停并修改请求,不能替代被动计数器。该下降不证明 H-08 已通过,也不把公共模块“有类似名字”当作可复用证据。

  • H-08 尚未达标;W3 结束必须用实际剩余结构重估预算,不能把分区目标当作可行性证明。
  • H-10/H-11 已迁移 Book 入口、诊断消费者和旧文档账号池命令:公开 Book 的热加载测试验证自身版本函数绑定;表单结构/日期格式/服务表统计仅在调试工具执行;账号池 Query 共用现有 SDK、分组、邮箱校验和 PluginTester,且禁止最终提交。原脱敏、错误路径和只读断言保留。该消费者已通过 27 项离线测试,但其他工具、热更新、两领区和完整预算仍须继续验收。
  • Book 同日排序已改为方案要求的时间升序;新增回归明确验证较晚时段余量更多也不能抢先。修改的是旧实现,不是倒改技术方案。

其他假设不得因旧代码测试通过自动改为“新方案通过”。

如果需要超过行数预算、改变配置含义或放弃已要求的行为,属于方案变更,不是“实现细节”。先按 执行记录 提交变更,再由用户决定。