docs 索引

按状态分两个目录：一件事没做完在 todo/，做完验证过了挪到 done/（mv 过去，不是复制）。 每份文档自己保持简短，完整的踩坑记录/实测数据以顶层 CHANGELOG.md 为准，这里的文件只做 索引和"现在该干什么"的摘要，不重复 CHANGELOG 已经写过的细节。

todo

• ssh-public-tunnel-broken.md — 公网 SSH 隧道（22→6000） 实测不通，TCP 握手成功但 SSH 协议层被直接断开，需要下次接触到局域网/服务器本机时现场排查 frpc；在这之前在家/公司网络外只能用 qwen.wudaima.com 的 HTTP 隧道看状态，改不了服务器
• verify-video-reference-on-gpu.md — Ref2VA 新加的 参考视频功能（2026-08-20 本地写的，没有 GPU 没测过），明天回服务器第一件事要验证
• quality-tuning-plan.md — 为什么生成视频画质比 ComfyUI 官方 演示差很多：分辨率/Turbo步数/CFG/negative prompt 几个待实测方向，按优先级排好了
• h3-rtxpro6000-setup.md — 新租的 RTX PRO 6000（Blackwell 96GB）装 H3：为什么不用 GGUF、精度选型对比、uv 环境搭建方式、装环境踩的坑。 首次冒烟测试已成功（int8-convrot，3.7s/步），环境/部署细节挪到了 h3-rtxpro6000/README.md，画质待人工确认是唯一剩下的事
• raylight-comfyui-multi-gpu-eval.md — 评估要不要把 2080Ti 那套换成 ComfyUI + Raylight 做序列并行，把 4×22G 当一个显存池用来跑更高分辨率/更长 时长——调研阶段，确认现有 DiffSynth-Studio 架构不支持多卡拆分；Raylight 确认支持 Turing+PCIe+ MiniMax-H3，但要换整套推理引擎，是独立迁移项目不是顺手能试的，建议先做完 quality-tuning-plan.md 里不用下载东西的两项再决定要不要推进
• fl2va-ref2va-mutual-exclusive-bug.md — api.py 同时传首尾帧和参考图时，pipeline 层会静默丢弃首尾帧、没有报错，今天的真实任务已经因为 prompt 里瞎写 @图片N 误以为挂了参考图踩过这个坑；要加一条校验直接拒绝这种组合， 优先级不高但成本低，顺手做掉

done

• h3-console-build-and-deploy.md — h3-console 从零 构建到部署上线，公网访问改走 qwen.wudaima.com/console
• h3-console-reliability-and-ux-fixes.md — 上线后的一系列可靠性修复（假运行中、并发竞态、任务落盘、下载文件名）+ 常用功能（重跑、 回收站、rows 动态帧数校验）