LTX-2.3 I2V AudioSync Simple Workflow V4b (RTX-VSR) Reviews
遇到了不少问题，好在有claude.win11\0.16.4版本，5080最新studio驱动。
# LTX-2.3 AudioSync Workflow 安装报告 v2
## 环境信息
| 项目 | 版本 |
|------|------|
| ComfyUI | 0.16.4 |
| Python | 3.13.11 |
| PyTorch | 2.10.0+cu130 |
| CUDA | 13.0 |
| GPU | NVIDIA GeForce RTX 5080 (sm_120, Blackwell) |
| OS | Windows 11 |
---
## 问题一：SageAttention 版本不兼容
### 错误
```
sageattention is not new enough version or could not determine CUDA architecture,
cannot apply LTX2 Memory Efficient Sage Attention Patch.
```
### 原因
- 初始安装的 `sageattention 1.0.6` 不支持 RTX 50xx (sm_120) Blackwell 架构
- PyPI 上无 2.x 版本，Wildminder 仓库的 `2.2.0.post3+cu130torch2.10.0` 版本存在 DLL ABI 不兼容问题（WinError 127）
### 解决方案
安装 woct0rdho 提供的 ABI3 预编译版本（支持 torch ≥ 2.9，Python ≥ 3.9）：
```powershell
# 卸载旧版本
C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded\python.exe -m pip uninstall sageattention -y
# 安装 woct0rdho 预编译版（从 GitHub Releases 下载 whl 后本地安装）
# 文件名：sageattention-2.2.0+cu130torch2.9.0andhigher.post4-cp39-abi3-win_amd64.whl
C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded\python.exe -m pip install ".\sageattention-2.2.0+cu130torch2.9.0andhigher.post4-cp39-abi3-win_amd64.whl"
```
### 验证
```
✅ 成功：SageAttention 完全正常，sageattn 函数已加载
```
---
## 问题二：Triton tcc.exe 编译失败（已彻底修复）
### 错误
```
triton\windows_utils.py:302: UserWarning: Failed to find Python libs.
subprocess.CalledProcessError: Command '[...tcc.exe, cuda_utils.c, -lpython313...]'
returned non-zero exit status 1.
```
**触发节点：** `LTX2MemoryEfficientSageAttentionPatch` 和 `LTX2AttentionTunerPatch`（KJNodes）中 `triton_kernels=True`
### 根本原因分析
| 问题 | 原因 |
|------|------|
| `Python.h` 找不到 | Embedded Python 不含开发头文件，且 tcc 不支持 `\\?\` UNC 路径前缀 |
| `python313.lib` 找不到 | Embedded Python 无 `libs/` 目录，`find_python()` 返回空列表 |
| `build.py` 路径 bug | `normalize_path()` 生成 `\\?\` 前缀路径，tcc 无法识别 |
### 解决方案（三步完整修复）
#### 第一步：补全 Python 开发文件（从官方 nuget 下载）
```powershell
$pyver = "3.13.1"
$nupkg = "$env:TEMP\python313_dev.zip"
Invoke-WebRequest -Uri "https://www.nuget.org/api/v2/package/python/$pyver" -OutFile $nupkg
***tract = "$env:TEMP\python313_dev"
Expand-Archive -Path $nupkg -DestinationPath ***tract -Force
$dest = "C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded"
Copy-Item "***tract\tools\include\*" "$dest\Include\" -Recurse -Force
Copy-Item "***tract\tools\libs\*" "$dest\libs\" -Recurse -Force
```
**验证：**
```
✅ Python.h 已存在：python_embeded\Include\Python.h（4099 bytes）
✅ python313.lib 已存在：python_embeded\libs\python313.lib（366830 bytes）
```
#### 第二步：修改 build.py（修复路径 + 库搜索逻辑）
文件路径：
```
C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded\Lib\site-packages\triton\runtime\build.py
```
**核心改动：**
1. 新增 `_*****_unc()` 函数，剥离 tcc 不支持的 `\\?\` UNC 路径前缀
2. `_cc_cmd()` 中对 tcc 编译器的所有路径参数调用 `_*****_unc()`
3. `_build()` 中 Windows 库搜索逻辑增加回退：当 `find_python()` 返回空时，自动使用 triton 自带的 `tcc/lib/` 目录（内含 `python313.def`）
```python
def _*****_unc(path):
"""移除 \\\\?\\ 前缀，tcc 不支持 UNC 扩展路径"""
if path and path.startswith("\\\\?\\"):
return path[4:]
return path
# _build() 中 Windows 部分：
python_lib_dirs = find_python()
if not python_lib_dirs:
tcc_lib_dir = os.path.join(
sysconfig.get_paths()["platlib"], "triton", "runtime", "tcc", "lib"
)
if os.path.isdir(tcc_lib_dir):
python_lib_dirs = [tcc_lib_dir]
library_dirs = library_dirs + python_lib_dirs
```
#### 第三步：清除 Triton 缓存并验证
```powershell
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\triton" -ErrorAction SilentlyContinue
C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded\python.exe -c "from triton.backends.nvidia.driver import CudaUtils; c = CudaUtils(); print('✅ Triton 初始化成功！')"
```
**验证结果：**
```
✅ Triton 初始化成功！
```
---
## 问题三：Lora 文件缺失（次要警告）
### 错误
```
Value not in list: lora_name: 'gemma-3-12b-it-abliterated_heretic_lora_rank64_bf16.safetensors'
not in (list of length 65)
```
### 解决方案
从 HuggingFace 下载该文件并放入对应 loras 目录：
```
下载地址：https://huggingface.co/Comfy-Org/ltx-2/resolve/main/split_files/loras/gemma-3-12b-it-abliterated_heretic_lora_rank64_bf16.safetensors
放置路径：C:\Users\23338\Desktop\Comfy_UI_Models\loras\LTX-2.3\
```
---
## 问题四：nodes_math.py 导入失败（次要警告）
### 错误
```
ModuleNotFoundError: No module named 'simpleeval'
IMPORT FAILED: nodes_math.py
```
### 解决方案
```powershell
C:\Users\23338\Desktop\ComfyUI_0.164\python_embeded\python.exe -m pip install simpleeval
```
---
## 最终安装结果汇总
| 组件 | 版本 | 状态 |
|------|------|------|
| triton-windows | 3.6.0 | ✅ 正常（含 JIT 编译） |
| sageattention | 2.2.0+cu130torch2.9.0andhigher.post4 | ✅ 正常加载 |
| Python.h 开发头文件 | 3.13.1（nuget） | ✅ 已补全 |
| python313.lib | 3.13.1（nuget） | ✅ 已补全 |
| build.py UNC 路径修复 | - | ✅ 已修复 |
| ComfyUI-Manager | V3.39.2 | ✅ 正常 |
| ComfyUI-KJNodes | - | ✅ 正常 |
| ComfyUI-LTXVideo | - | ✅ 正常 |
| ComfyUI-MelBandRoFormer | - | ✅ 正常 |
| Nvidia_RTX_Nodes_ComfyUI | - | ✅ 正常 |
| Triton JIT 编译 | - | ✅ 已修复（triton_kernels=True 可用） |
| gemma lora 文件 | - | ⚠️ 需手动下载 |
| simpleeval 模块 | - | ⚠️ 需安装（nodes_math.py 依赖） |
---
## 部署说明（多机）
| GPU | 架构 | 备注 |
|-----|------|------|
| RTX 4080 | Ada (sm_89) | 同上流程，安装相同 whl |
| RTX 5080 | Blackwell (sm_120) | 已验证 ✅ |
| RTX 5090 | Blackwell (sm_120) | 同上（架构相同） |
> **注意：**
> - 每台电脑的 `python_embeded` 环境相互独立，需单独安装，不可直接复制
> - nuget 下载的 Python.h / python313.lib 版本需与 python_embeded 的 Python 版本一致（本机为 3.13.1）
> - 修改 build.py 后需清除 `%LOCALAPPDATA%\triton` 缓存才能生效
