docs 索引

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

todo

• 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、精度选型对比（NF4/int8-convrot/fp8/bf16 实测文件大小）、 uv 环境搭建方式，还没开始下权重
• 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 动态帧数校验）