# docs 索引

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

## todo

- [verify-video-reference-on-gpu.md](todo/verify-video-reference-on-gpu.md) — Ref2VA 新加的
  参考视频功能（2026-08-20 本地写的，没有 GPU 没测过），明天回服务器第一件事要验证
- [quality-tuning-plan.md](todo/quality-tuning-plan.md) — 为什么生成视频画质比 ComfyUI 官方
  演示差很多：分辨率/Turbo步数/CFG/negative prompt 几个待实测方向，按优先级排好了
- [h3-rtxpro6000-setup.md](todo/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](todo/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](todo/fl2va-ref2va-mutual-exclusive-bug.md) — `api.py`
  同时传首尾帧和参考图时，pipeline 层会静默丢弃首尾帧、没有报错，今天的真实任务已经因为
  prompt 里瞎写 `@图片N` 误以为挂了参考图踩过这个坑；要加一条校验直接拒绝这种组合，
  优先级不高但成本低，顺手做掉

## done

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