edit | blame | history | raw

B 站博主动态采集辅助工具 HOLD/5 最小修复设计 V003

1. 唯一修订点

  • 事项：DEV-PROJECT-INFO-BILI-DYNAMIC-COLLECTOR-MVP-20260804-001
  • 基线组合：V001 11917/16C14FB2751A0EAB63F76371E75D0569FF8EF5B47FDD8724BE861314B6062733 + V002 6342/DA3B3DDAA3C8B8EE33E2C0B6857B962754D740EB4BEE075E3BFB0F0FD4382736
  • 前序唯一阻断：F1_R1_ACTIVE_MOVE_ALLOWLIST_REGRESSION
  • 本修订只覆盖 V002 第 2.1 节第 4 项、2.2 节和第 3 节的活动状态允许列表；其他文字与全部已通过合同不变。

2. ACTIVE_MOVE 精确允许列表

V002 中“或没有移动终态”“无终态”两处表述废止，禁止作为实施依据。

读取每个实体最新有效 manifest 事件后，只允许按以下顺序分类：

  1. 最新状态为 VIDEO_MOVED 或 COMPLETE：TERMINAL_MOVED，按 V002 投影为 ALREADY_MOVED、exit 0。
  2. 最新状态为 VIDEO_MOVED_SOURCE_RETAINED：TERMINAL_RETAINED，按 V002 投影为同名状态、exit 4。
  3. 最新状态精确等于 TODO_QUEUED 或 MOVE_FAILED：ACTIVE_MOVE，允许进入阶段 B 的源/目标安全预检。
  4. 最新状态为 PROCESSING_HANDOFF_CONFIRMED、PROCESSING、PROCESSING_FAILED，事件缺少/空白 status，或任何未知状态：在阶段 A 返回 E_STATUS、SAFETY_STOP、exit 3。

第 4 类禁止进入阶段 B，禁止 stat/resolve 源文件，禁止复制、创建目标、删除源文件或追加 manifest；正式业务文件和 manifest 原始 bytes 必须不变。该安全停止不改变 V001 的任何状态、exit code 或产品边界。

3. 修正后的精确矩阵

最新状态 分类 是否进入阶段 B 输出/exit manifest 变化
VIDEO_MOVED / COMPLETE TERMINAL_MOVED 否 ALREADY_MOVED / 0 无
VIDEO_MOVED_SOURCE_RETAINED TERMINAL_RETAINED 否 VIDEO_MOVED_SOURCE_RETAINED / 4 无
TODO_QUEUED / MOVE_FAILED ACTIVE_MOVE 是 按冻结事务合同 仅运行时事务可追加
PROCESSING_HANDOFF_CONFIRMED / PROCESSING / PROCESSING_FAILED 禁止状态 否 E_STATUS + SAFETY_STOP / 3 无
缺失、空白或未知 status 禁止状态 否 E_STATUS + SAFETY_STOP / 3 无

4. 参数化非真空入口反例

测试通过 CLI/main() 入口参数化覆盖：

  • PROCESSING_HANDOFF_CONFIRMED
  • PROCESSING
  • PROCESSING_FAILED
  • 缺少 status
  • status=""
  • status="UNKNOWN_STATE"

每个 case 均在 TemporaryDirectory 中准备净化 manifest、合法 mapping 和一个哨兵源文件；调用前记录 manifest 原始 bytes、源文件 bytes、业务目录树和所有文件哈希。调用后统一断言：exit 3、stdout 中 status=SAFETY_STOP 且 error.code=E_STATUS；manifest 原始 bytes、源文件、正式目标集合和所有业务文件均完全不变；无 .partial、锁残留或新增事件。

5. 门禁

V001+V002+V003 为唯一组合实施合同。V003 限定复审 PASS 前，代码、配置、测试和 fixture 继续冻结。PASS 后只实施前序 HOLD/5 五项，不增加网络、浏览器、下载、调度、自动发送或正式数据能力。