# 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、精度选型对比（NF4/int8-convrot/fp8/bf16 实测文件大小）、
  uv 环境搭建方式，还没开始下权重
- [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 里不用下载东西的两项再决定要不要推进

## 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 动态帧数校验）