[stqfdyr]

本地缓存代理对外服务这一块的整理，含一处安全修复。

安全

• 外挂字幕的缓存文件名以服务器给的编码名为扩展名，原样拼进路径：编码名里带 /、\、.. 时能把内容写到字幕缓存目录以外（Windows 上可写到任意位置）。登记时文件名只保留字母数字和 ._-，全是点或为空时改用随机 key。

修复

• Range: bytes=5-3（终点小于起点）会让 Content-Length 下溢；按 RFC 当作没有 Range、回整个文件。
• 磁盘上被截短的已完成块：读任务一直重读、空转到程序退出。repair 改为核对大小，读循环每轮检查播放器是否已断开。
• 接受连接出错（句柄耗尽等）时立即重试会占满一个核，改为等 100 ms。
• 第一次读一个文件（还在等总大小）时，块尾 1 MiB 的预览没有连下一块一起取；与后续读取共用 wanted。

整理

• 读循环拆出 locate，接受连接拆出 accept；Role::Thumb / Role::Prefetch 调度上早无区别，并为 Role::Preview。
• 响应头用 HeaderValue::from，去掉 parse().unwrap()；等总大小的上限提成 SIZE_WAIT（编译期断言长于 OPEN_LIMIT）。
• 字幕缓存命中时的读与刷新修改时间复用图片缓存的 cached（阻塞池里做），写入改 tokio::fs。
• stream.rs 的注释全部改英文（日志与错误文案保持中文）。

测试

• 退避类测试（反复断线、断网、5xx、429、预览失败）原来断言整个读的总耗时，机器一忙就超；改为断言「上游断开到下一次请求」的间隔，翻倍退避照样能抓到。
• 按变异测试补测试：405 / HEAD / key 种类、跨块边界读、块尾预览取两块、同名重新登记换地址、字幕只重试暂时性失败且有上限、正在写的块边下边读、上游 403 后已缓存的块照常读、预取遇拒绝只请求一次、主任务碰到已下好的块断开重开、别处被拒绝时不断开读着在跑任务的连接、每次 retain 都重算占用等。

验证

• cargo test 80 项、cargo clippy --all-targets -- -D warnings、cargo fmt --check 通过；Linux 上 stream 测试连跑 10 轮无失败。
• 未跑：真服端到端、Windows CI。