Windows 中国大陆一键安装包
压缩包约 35 MiB，已内置 pip 引导与 Windows SageAttention，不内置约 60GB 模型。Cloudflare 版本会从本站分片下载、自动合并并校验；安装器随后自动检测显卡，并通过国内源断点下载依赖与模型。
下载 H3 Studio 一键安装包系统Windows 10 / 11 x64
推荐空间至少 100GB 可用
网络中国境内直连镜像
01 · 开始之前
先更新显卡厂商的正式驱动，确认目标磁盘空间，然后关闭正在运行的 ComfyUI。安装路径可包含中文和空格，但必须完整解压，不能在 ZIP 预览窗口内运行。
01
检查系统Windows x64；管理员权限通常不需要。
02
检查容量模型约 60GB，另留缓存与输出空间。
03
更新驱动NVIDIA / AMD / Intel 使用厂商正式驱动。
04
关闭重复引擎避免 8189 端口与数据库被占用。
不需要预装 Git、Docker、Conda、venv 或 CUDA Toolkit。RTX 加速依赖由安装器按硬件选择；不修改系统 PATH。
02 · 环境与下载入口
正常情况只需运行一键安装器，下面的入口仅用于驱动过旧、Windows 运行库缺失或镜像维护时手动修复。平台不要求预装 Python、CUDA Toolkit、Git、Docker、Conda 或 venv。
NV
NVIDIA Studio DriverRTX Maxine 需要 Windows 10/11 x64、Tensor Core 显卡及 570.65 或更高驱动。NVIDIA 中国官网下载 ↗
AM
AMD Radeon 驱动AMD/Intel 在 Windows 一键包中默认使用通用媒体终修，不会误装 CUDA。AMD 官方下载 ↗
IN
Intel 显卡驱动适用于 Arc 与核显；若自行接入 XPU/DirectML，可在高级配置选择实验档。Intel 中国官网下载 ↗
VC
Microsoft Visual C++ x64遇到 DLL load failed、WinError 126 或 Python 无法启动时安装。微软固定下载地址 ↗
PY
Python 3.12.10 便携包安装器自动从华为云下载；仅在镜像故障时手动获取并保留原文件名。华为云镜像 ↗
H3
MiniMax H3 模型安装器从 ModelScope 直接写入 ComfyUI/models，支持续装且不再保留重复副本。ModelScope 国内源 ↗
PT
PyTorch CUDARTX/NVIDIA 完整档由安装器从阿里云 wheel 目录匹配安装，不需要系统 CUDA Toolkit。阿里云 CUDA 13.0 wheel ↗
LR
Turbo LoRA通过 HF-Mirror 中国节点下载；下载失败时重新运行安装器即可。HF-Mirror ↗
一键安装目前支持 Windows 10/11 x64。Windows ARM64/x86、macOS 与 Linux 可使用网页画布连接另一台已部署的 H3 引擎，但不应运行此 Windows x64 安装包。
03 · 一键安装的全部操作
- 下载 H3-Studio-OneClick-CN.zip，右键“全部解压”。完整 H3 放到至少有 100GB 空间的磁盘；仅终修建议至少 15GB。
- 进入解压后的根目录，双击 setup_h3_cn.cmd。
- 只有被判定可安全运行 H3 的电脑才会要求阅读并确认 MiniMax H3 社区模型许可。
- 等待硬件检测、便携 Python、ComfyUI 依赖、节点和模型下载完成。不要关闭窗口。
- 若网络中断，再次双击同一文件即可续装；残缺缓存会被识别并重新下载，已校验文件会跳过。
- 看到安装完成后，浏览器会打开 H3 Studio；以后只需双击 start_h3_studio.cmd。
setup_h3_cn.cmd默认中国大陆下载链路
PY
Python华为云，失败后切换阿里云。
PK
Python 依赖清华 TUNA；PyTorch 使用阿里云。
H3
MiniMax H3 权重魔搭 ModelScope，直接落盘、支持续传。
LR
Turbo LoRAHF-Mirror 中国节点。
便携运行时位于 .runtime\python\。它不是 venv，不写入 Windows Installer，可以随整个项目目录移动，也不会污染其他 Python 项目。
04 · 安装器如何选择部署规格
无需手工选择 CUDA 或插件版本。安装器同时依据显卡、显存、Compute Capability、驱动与系统内存选择安全档案；随后部署向导会再次按真实运行时能力校验并自动回退。
| 检测结果 | 自动规格 | 主要能力 |
|---|---|---|
| RTX 24GB+、内存 48GB+ | RTX 创作者完整档 | H3、R2V、重绘、SageAttention、Maxine、Direct 2K 验证 |
| RTX 16–23GB、内存 32GB+ | RTX 低显存实验档 | 低显存 H3、通用/RTX 终修；先用草图参数 |
| 非 RTX NVIDIA 24GB+、Compute 8.0+ | CUDA 通用档 | PyTorch Attention、通用终修 |
| AMD / Intel / 旧 NVIDIA | 通用媒体终修档 | 稳定降噪与 Lanczos 超分；不自动下载无法使用的 H3 权重 |
| CPU / 未知配置 | 通用媒体终修档 | 保留网页画布与终修，不强行启动 H3 |
AMD/Intel 用户若已自行配置可用的 ROCm、XPU 或 DirectML PyTorch，可在高级规格中手动尝试实验档。笔记本双显卡或远程桌面识别不准时，可在左侧齿轮手动选择；不要选择高于实际容量的档案。
04 · 首次启动与验证
- 双击 start_h3_studio.cmd；看到“本机助手已就绪”后启动窗口可以关闭。
- 启动器优先使用 8191；若被占用，会自动改用 8192、8193 或 18191。界面与引擎始终只监听本机。
- 打开左侧齿轮，完成硬件、规格、组件和保存四步；缺失能力会明确标注。
- 先运行 608×352、0.5 秒草图验证。成功后再提高到 1280×736、5–10 秒。
- 首次 SageAttention 编译会较慢，后续任务复用项目内缓存。
start_h3_studio.cmd需要原生 ComfyUI 节点界面时可运行 start_h3.cmd 并访问 8189；日常创作无需进入它。公共网页点击“启动并连接”时也会通过已注册的 h3studio:// 协议自动执行启动器。
05 · 制作第一个视频
- 从左侧工作流库选择“文生视频”“首帧生成”“首尾帧”“R2V 多参考”“重绘”或“降噪与超分”。
- 点击素材节点上传文件，或从素材库分配已有文件；R2V 可混合最多 9 图、3 视频/配套音轨、3 独立音频。
- 填写提示词。长镜头和建筑场景优先用首尾双锚，并明确“保持结构、不漂移”。
- 确认生成节点的分辨率、时长与步数。正式 Turbo 建议 6–8 步；R2V 使用独立步数。
- 终修节点会根据显卡自动选择 NVIDIA Maxine 或通用时序降噪与 Lanczos 超分。
- 点击底部“运行工作流”，完成后在成片输出节点预览和下载。
画布、节点参数和素材引用保存在当前浏览器本机。不要在任务运行中关闭启动窗口，也不要并行运行两个高显存任务。
06 · 公共网页连接
网页与 H3 在同一台电脑（推荐）
- 使用最新版一键安装器完成安装，它会注册 H3 Studio 本机启动协议。
- 打开公共网站，点击“连接 / 安装 H3”与“启动并连接本机助手”。
- 浏览器询问是否打开 H3 Studio 时选择允许；启动器会自动选择可用端口并打开本机授权页。
- 确认后网页自动返回并保存连接。助手没有响应时网页会停留在修复面板，不再跳到拒绝连接页。
不同设备或必须使用 Tunnel
- 为实际使用的助手端口建立受保护的 HTTPS Tunnel，禁止直接公开 8189。
- 在项目根目录运行下方命令，把公共网站的精确 HTTPS 域名加入允许列表。
- 只在网页的高级连接界面输入 Tunnel 地址和本地密钥；不要把密钥写进公开仓库或 config.js。
.runtime\python\python.exe tools\configure_cloud_access.py --origin https://你的站点.example“Unexpected token '<' … is not valid JSON”通常代表网址返回了 HTML 页面，而不是 H3 API。请检查 Tunnel 是否转发本机助手实际端口的根路径，并重新执行测试连接。
07 · 更新、迁移、续装与卸载
- 续装/修复：再次运行 setup_h3_cn.cmd；安装器会复用已校验文件。
- 日常启动：只运行 start_h3_studio.cmd，不需要重复安装。
- 迁移电脑：停止 Studio 后复制整个解压目录；新电脑运行 setup_h3_cn.cmd，让运行时按新硬件补齐或切换。
- 输出备份：成片位于 ComfyUI\output；输入素材位于 ComfyUI\input。清理前先备份自己的文件。
- 配置重检：显卡或驱动变化后，在部署向导点击“重新检测”。
- 故障：点击左侧“!”进入故障中心，先诊断再按单项建议修复。
- 卸载：停止所有 H3/ComfyUI 窗口，备份 input/output 后删除整个项目目录即可；安装器未修改系统 PATH。
模型许可、权重来源和版本说明以安装包内 README_FIRST.txt 与项目 README.md 为准。