[mingyangbest]

这是什么

tools/probe_resume.py：断点续传的前置验证，不涉及任何生产行为。它只回答一个问题——服务端还认不认几小时前的那个 uniqueId。这个问题的答案直接决定续传怎么做，所以先探再写。

脚手架，不混进 v0.2.1。合并后跑完再决定它是留作诊断工具还是删掉。

为了让探针「探的是生产」而做的小抽出

原来 upload() 里内联构造分片字段。探针如果照抄一份，测到的就是探针自己的实现，阳性结果迁移不到真续传上。所以抽出：

• file_type_of() / file_info_plain() / enc_file_info() / new_unique_id()
• Wopan.part_fields() —— 单片 multipart 字段的唯一构造点

upload() 与探针都走这一份。行为不变：用一个 fake _upload_part 抓包，逐字段比对过字段名集合、totalPart/partSize/partIndex 序列、uniqueId 复用、fileInfo 解密后的 fileName/fileSize/fileType/directoryId/batchNo。

探针自己负责的部分

• 两阶段：start 传 1..100 片（云端留 800MiB 残片）→ 进程退出 → 隔 ≥2 小时 resume 从第 101 片续（默认总 150 片 / 1.2GiB）。不在进程里 sleep，被杀不白等。
• journal 原子写（tmp + fsync + replace），记录 TP_DATA；start/resume 必须同一个 TP_DATA，否则 resume 找不到 journal 并明确提示。
• token 指纹留痕：若这 2 小时里 token 续期过，「会话超时」和「会话绑旧 token」两种解释会同时成立，指纹与 token_renewed 一起写进报告，避免误判归因。
• 四态判定：0 接受 / 2 报错 / 3 不完整 / 4 未观测到（网络三次无响应、或拿不到内容哈希）。1 留给脚本自身错误。断网不会伪装成服务端拒收。
• SHA256 来源写死：优先云端返回的 sha256 字段；缺失则下载回来自己算（1.2GiB 一次可接受），报告记 hash_source=cloud|download；两者都拿不到判 4。
• cleanup 独立子命令：读 journal（坏了也能跑）删云端文件，目录空了才删目录，再清本地与 journal。

验证到哪一步

• 本地离线验证（未连真实云盘）：四态判定各跑一次、hash_source 两条分支、下载失败→4、token 续期留痕、坏 journal 拦住、cleanup 三种情形（坏 journal / 目录非空 / 目录已空）。
• pyflakes + compileall 全过。
• 真机运行尚未执行，按约定先审代码再部署。

用法

docker cp tools/probe_resume.py tpbackup:/app/probe_resume.py
docker exec -it tpbackup python3 /app/probe_resume.py start
# 等 ≥2 小时
docker exec -it tpbackup python3 /app/probe_resume.py resume
docker exec -it tpbackup python3 /app/probe_resume.py cleanup

[mingyangbest]

CI 记录：run #15（e750b20）的 docker job 挂了 19 秒，定位为镜像源瞬时不可用，与本 PR 无关：

#10 [5/6] RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
ERROR: Could not find a version that satisfies the requirement fastapi==0.115.6 (from versions: none)

requirements.txt 本 PR 未改动，同一份文件在 #14 已构建成功；失败点在 pip 拉包（不是 apt、不是 docker pull），且报的是 from versions: none——清华镜像当时没返回索引。

已 Re-run failed jobs：docker + static 均通过，run 状态 success。按 transient 处理，不改代码。

若以后同类失败反复出现（比如一天内多次），可以在 Dockerfile 里加一个 fallback index（--extra-index-url https://pypi.org/simple，或换阿里云镜像），那是独立的健壮性改动，不放进本 PR。