# 开发周期与工作包安排 版本:1.1;日期:2026-09-01;依赖:[技术方案](01-technical-design.md)、[可行性](02-feasibility.md)、[测试计划](04-test-plan.md)。 > CR-001 已获用户确认:W2/W4 不再为敏感日志脱敏和未知提交暂停保留专属结构;W4 改为验证单次调用一次点击、普通失败交回 Booker、后续调用完整重试。 ## 1. 周期怎么理解 按一名熟悉项目的工程师、已有本地依赖可用估算,净工程投入约 **6.5–9 个工作日**,包含测试迁移、回归及文档记录,不只是改插件的时间。自动化与代码复用可以缩短实际耗时;不要求等满估算天数才进入下一项。 真实预约验收取决于账号、OTP、网站状态和实际档期,等待窗口单独记录,不承诺日历日期。下表是原始净投入估算,不是从今天重新计算的交付承诺,也不是完成证明;当前 W0 已建基线、W1 已离线回归,W2/W3/W4 仅部分收敛。W5 的旧文档账号池命令已迁移并通过离线回归,但约 1000 行预算及 W5 其余条件仍未完成;实际进度、返工和剩余估算以 [执行记录](06-execution-records.md) 为准。 ## 2. 工作包与交付物 | 工作包 | 估算 | 主要工作与代码位置 | 前置条件 | 验证/交付 | | --- | --- | --- | --- | --- | | W0 行为与消费者基线 | 0.5 天 | 盘点 `plugins/ita_plugin.py`、相关 `tools/`、`test/`;核对用户已有改动 | 用户确认文档及实施范围 | 现有行为测试结果、配置消费者表、私有符号迁移表;T-11/T-12、H-11 | | W1 公共能力接入 | 0.5–1 天 | 替换手写初始化/日期筛选/清理;主要改 Italy,公共模块只补必要缺口 | W0 基线明确 | UT-01/02/03;公共消费者回归;H-01/H-02 | | W2 登录与会话准备收敛 | 1 天 | 使用 `BaseFlow`,合并表单/验证等待/OTP准备与会话状态 | W1 验证通过 | UT-04/05/06;错误/重复调用测试;H-06 | | W3 Query/日历共用 | 1–1.5 天 | 共用读取/解析,逐月最早日期;保留 Book 可调用的内部读取步骤 | W2、H-03/H-05 有证据 | UT-07/08/09、IT-01;扫描与准备次数;可选 H-04 对照 | | W4 Book 与最终核验收敛 | 1–1.5 天 | 申请人库存重查、日期/时段选择、单次调用一次点击、最小成功判定和普通失败 | W3 共用日历稳定 | UT-10/11/12/13、IT-02/03;H-07 | | W5 工具、热更新和全量回归 | 1–1.5 天 | 迁移旧私有调用、支持命令、单文件加载;公共改动回归 | W1–W4 完成 | UT-14/15、IT-04/05/06;行数及净变化报告 | | W6 现场与发布验收 | 1–1.5 天净投入 | 先 Query,再 Book 预提交,再有授权的真实预约;更新执行记录 | 离线通过;用户现场条件/授权具备 | LT-01/02/03;逐项 RC 验收、发布/回退说明 | W6 的实际等待时间不包含在净投入内。任何任务发现新协议或外部依赖问题,先更新 H 编号、估算和影响,不以“再补几行”无限扩展。 ### 2.1 阶段执行对照表 各阶段都以 01 技术方案为约束、02 的假设为待验证问题、04 为测试依据、05 为最终准出标准,并把结果写入 06。下表是执行索引,不另造一套流程或重复生成报告;“阶段完成”只说明本阶段证据齐备,不表示关联 RC 已通过全部离线和现场验收。 | 阶段 | 必须核对的技术/假设 | 必须留下的阶段完成证据 | 关联准出 | | --- | --- | --- | --- | | W0 | T-01/T-11/T-12;H-08/H-11 | 带版本的行数、旧行为测试结果、配置和工具消费者清单;已有失败与本次回归分开记录 | RC-01/07/10 | | W1 | T-02/T-08;H-01/H-02 | UT-01/02/03、IT-06;实际复用函数、删除的重复实现、公共消费者兼容结果及净行数变化 | RC-02/08 | | W2 | T-05/T-07/T-08;H-01/H-06 | UT-04/05/06;登录、延迟表单、自动 OTP、重复调用与账号/会话隔离的离线证据 | RC-04/06/07 | | W3 | T-03/T-05/T-08;H-03/H-05/H-08 | UT-07/08/09、IT-01;首次正向月停止、最早日期、范围耗尽、无最终请求及剩余行数预算 | RC-01/03/07 | | W4 | T-04/T-09;H-03/H-07 | UT-10/11/12/13、IT-02/03;申请人重查、选择一致性、单次调用一次点击、普通失败和下一次独立重试的离线证据 | RC-04/05 | | W5 | T-01/T-02/T-11/T-12;H-08/H-09/H-10/H-11 | UT-14/15、IT-04/05/06 及完整相关回归;约 1000 行和净变化、两套领区配置、单文件热更新、可执行的现行命令 | RC-01/02/07/08/10 | | W6 | T-03/T-04/T-07/T-09;所有尚需现场验证的假设 | LT-01/02/03;同一待发布版本的真实查询、预提交和受控预约回执,逐项填写最终 RC 记录 | RC-03/04/05/06/09/10 | H-04 仅在获授权验证并通过后,才允许更换相应的读取通道;没有通过则沿用浏览器路径,不阻止其他工作。开始、执行、结束均使用同一组编号;如果本阶段还有必需证据缺失,标记“部分完成”并列缺口,不自动放宽后续条件。 ## 3. 实施顺序 ```text W0 基线 → W1 公共能力 → W2 登录/准备 → W3 Query → W4 Book → W5 集成 → W6 现场 ``` - 不一口气删掉 5000 行后才测试。 - 每个工作包保持独立可审查的差异;Git 提交是否执行取决于用户授权。 - 不依赖后一步的测试可以提前编写,但不能用提前写好的测试代替当前结果。 - H-04 的 HTTP 对照是可选支线,失败不阻塞浏览器方案的其他工作。 - W3 和 W5 必须重新核对总行数预算,提前暴露超支,不能直到发布前才发现仍有数千行。 当前优先顺序:R1–R5 已完成,Italy 为 2598 行。R3 已用现有 Booker 的普通失败/后续信号重试替换跨调用 fence、未知暂停和复杂 reconciliation;R2 已合并 Query/Book 的月份与候选表示;R4 已把表单/OTP/Turnstile 约二十字段快照收为五个布尔事实;R5 已将持久 profile、锁和诊断观察状态归位 Italy 工具,并保持公共模块及 VFS/TLS/BLS 零改动。下一结构包重新审计日历捕获、选择及表单脚本的重复表示。不能把消费者修复、夹具或整理导入当作整体完成;W3/W4/W5 的局部产物不代表现场最终提交验收通过。 结构性减量按 [生产代码精简盘点](07-reduction-inventory.md) 的 R1→R3→R2→R4→R5 执行;五包当前均已完成。由于 2598 行仍未满足 RC-01,后续结构包继续使用本文件的记录、测试和准出规则,不修改其他插件换取 Italy 行数。 本次周期复核:R3 为 3532 → 2883、净减 649 行;R2 为 2883 → 2823、净减 60 行;R4 为 2823 → 2752、净减 71 行;R5 为 2752 → 2598、净减 154 行。当前 Italy 384 项、调试 280 项、框架离线 75 项、配置/账号 27 项通过。生产 checkpoint/restore、预约列表/详情读取、跨调用 fence、未知暂停、提示日期优先双扫描、重复月份结果类、二十字段表单快照、生产阶段枚举、持久 profile/锁和诊断观察字段已删除;明确响应判定及底层网站事实仍保留。当前仍需净减约 1598 行;下一包必须以真实剩余结构重新盘点,不重复开发已经统一的协议、选择、OTP 或宿主重试能力,也不自行放宽总预算。 ## 4. 每个工作包开始前的检查 1. 引用本包对应 T/H/UT/IT/LT/RC 编号。 2. 读取将修改的函数及现成参照,列出“复用、保留、删除、合并”清单。 3. 记录涉及文件、是否影响 VFS/TLS/BLS、配置兼容及热更新依赖。 4. 记录本包前后的预计行数;确认没有新增 Italy 私有运行时模块。 5. 确认本次授权范围,不能把开发权限当成真实预约或部署权限。 ## 5. 每个工作包结束时的检查 按 [执行记录模板](06-execution-records.md) 填写: - 实际修改、引用的现成能力和删除的重复结构。 - 运行过的精确命令、代码版本/工作区指纹、退出码、测试数量及失败明细。 - 原有业务断言迁移到哪里;哪些仅绑定旧内部结构的测试被替换及原因。 - Italy 完整行数、新增公共代码行数、全仓生产代码净变化。 - 未解决问题、相关假设状态和下一步;没有证据的项目仍为待验证。 ## 6. 用户需要配合的环节 离线重构不需要用户反复操作。W6 才集中配合:确认测试账号和领区、确认邮箱授权可用、完成网站要求的人工验证,并在真实提交前确认本轮允许预约的用户与日期范围。 已明确授权的真实提交运行无需额外输入完整确认句;但开发脚本不能默认提交,也不能把过去另一轮授权用于新增账户或范围。 ## 7. 进度更新规则 进度用“已完成工作包+当前可验证产物+剩余阻碍”表达,不用已删行数代替完成度。 如果公共模块扩展、HTTP 假设或回执核验导致返工,更新文档和剩余估算。不得为了赶周期改成手动 OTP、单账号 Query/Book、香港硬编码或不核验真实预约的缩水版本。