LibTV 桌面端踩坑清单：下载慢、显存不足、生成失败

大家好，我是程序员晚枫（Wayne Liu）。

「装好了，点生成，然后就没然后了。」

这两天前台收到最多的，不是问 H3 强不强，是问「我卡住了怎么办」。

第一次本地生成失败，九成不是模型不行，是准备工作差了一步。

我把官方教程和社区公开排查经验里最常见的几类问题，按「现象 → 原因 → 怎么办」列成一张清单。你照着从上往下过一遍，大部分情况不用重装就能解决。

👉 点击这里下载 LibTV 桌面端： https://libtv.cgref.cn/s/9omkl4jn4d

一、下载慢、下不全：最常见，也最容易误判

先说最普遍的一个。

模型文件不是一整包，官方和社区的部署资料都提到：最小权重约 42.5GB，完整 FL2VA 检查点约 144GB，还得配齐文本编码器、图像编解码器、分词器这些零件。

国内直连海外模型仓库，慢和断都是常态。

现象	大概率原因	怎么办
进度条卡住不动	跨境链路不稳	换国内镜像源，或用客户端内置的下载通道
下到 99% 断了	大文件分片不完整	别点「重试全部」，先校验已下文件再续
首次生成报「找不到文件」	只下了主干，漏了编码器 / 编解码器	按清单一次下齐，别手动挑着下
解压后启动报错	路径里带中文或空格	换纯英文路径，如 D 盘根目录下建一个短名文件夹

这里讲透一个原理：为什么一个模型要拆成好几个文件？

因为它干的活不止一件。得先有「读懂你那句话」的部分，有「把画面压成数据再还原」的部分，有真正负责生成的主网络，还得有把声音一起合进去的部分。少一个，就像相机没装存储卡——机器是好的，按不下快门。

所以我最不建议的就是中途强关。你以为只是断了一次下载，实际上很可能留了个半截文件，后面报的错会变得越来越看不懂。

我见过最执着的一位，重下了三遍 100 多 GB，最后发现是文件夹名字里有个中文。

嗯，那三遍流量挺贵的。

本地生成之前，先确认硬件和文件都齐了

二、显存不足：不是「等一等」就能过去的

第二类最容易被误判成「电脑卡」的，是显存不够。

典型表现：进度跑到一半直接退出，或者提示显存溢出。

这时候千万别反复点重试。 显存不够是硬门槛，重试十次结果一样，还会把机器拖得更慢。

按这个顺序降负载：

先降分辨率：用 864×480 这类小尺寸试跑，成了再往上调
再降时长：先用 8 秒验证，别一上来就 15 秒
减少参考素材：参考图、参考视频、参考音频越多，要同时处理的内容越长，显存吃得越狠
选更省显存的量化档：8GB 显存基本只能靠 4 位量化加临时卸载，速度会明显变慢
关掉占显存的其他程序：游戏、剪辑软件、浏览器硬件加速都算

再放一次档位，方便自查：

显存	能做什么	别硬试什么
6GB 以下	基本别装	任何时长
8GB	4 位量化、480p、短时长	768p 满时长
12GB	768p 低时长	高分辨率长片段
16GB	768p 标准参数	大量参考素材
24GB	768p 高时长	2K 本地生成（这段没开源）

最后一行要划重点：2K 不是你显存不够，是 H3-Regenerate-2K 压根没在开源包里。 别为了一个不存在的按钮去升级显卡。

👉 点击这里下载 LibTV 桌面端： https://libtv.cgref.cn/s/9omkl4jn4d

三、生成失败、画面不对：多半是提示词和格式

第三类最玄学，其实最讲道理。

现象	原因	怎么办
生成出来跟描述完全不搭	H3 用一整套语言模型读提示词，有它的语法习惯	按官方提示词指南写，别写成散文式抒情
报「结构不匹配」「找不到流程」	原始目录和另一种格式的文件混装	锁定一种格式，别混着放
换模型后一直报错	两个检查点用途不同、文件不同	FL2VA 管文生 / 首尾帧，Ref2VA 管多参考，别混用
声音画面都不对	步数压太狠	先用默认步数跑通，再考虑提速

提示词这一条最值得单说。 H3 不是那种「随便写几个词也能猜个大概」的模型，官方专门写了基础版和参考版两套提示词指南，还强调沿用指南里的术语，多参考图的效果会明显更稳。

说白了，你得把它当成一位很认真但有点死板的同事：交代清楚主体、动作、镜头、声音，比写一大段氛围描写管用。

还有个心态上的坑：第一次不成功就换模型、换版本、重装软件。

其实最稳的做法是先用最短时长、最低分辨率、最简单的一句话，跑通一次。 只要有一条片子出来了，说明环境没问题，剩下的都是调参问题。

顺便把边界再说一遍：本地开源的是 H3-Base，出 768p 原生有声视频；2K 增强和复杂指令理解那两段还在官方托管服务里。权重受 Community License 约束，有地域和营收门槛，不能写成「商用无风险」，也不能理解成「全功能永久离线免费」。客户端免费安装、本地这段不按次扣云端积分，平台上的高级模型和更高额度以应用内当日显示为准。

最后说句实在的。

本地生成这事儿，环境只配一次，坑也基本就那几个。把「先跑通一条最简单的」当成第一步，你会发现后面九十分钟的安装教程，其实都用不上。

真正难的不是让机器出片，是想清楚自己要拍什么。

💬 来评论区聊聊

你第一次本地生成卡在哪一步？下载、显存，还是那句看不懂的报错？评论区丢出来，我挑高频的单独写一篇排查。