Windows 中国大陆一键安装包
压缩包约 18 MiB，不内置约 60GB 模型。安装器会自动检测显卡，在项目目录写入独立标准运行时，并通过国内源断点下载依赖与模型。
下载 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 · 一键安装的全部操作
- 下载 H3-Studio-OneClick-CN.zip，右键“全部解压”到至少有 100GB 空间的磁盘。
- 进入解压后的根目录，双击 setup_h3_cn.cmd。
- 阅读并确认 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，可以随整个项目目录移动，也不会污染其他 Python 项目。
03 · 安装器如何选择部署规格
无需手工选择 CUDA 或插件版本。安装器会依据显卡厂商、RTX 能力与实际显存选择安全档案；随后部署向导会再次按真实运行时能力校验并自动回退。
| 检测结果 | 自动规格 | 主要能力 |
|---|---|---|
| RTX 24GB+ | RTX 创作者完整档 | H3、R2V、重绘、SageAttention、Maxine、Direct 2K 验证 |
| RTX 16–23GB | RTX 低显存实验档 | 低显存 H3、通用/RTX 终修；先用草图参数 |
| 非 RTX NVIDIA 24GB+ | CUDA 通用档 | PyTorch Attention、通用终修 |
| AMD / Intel 16GB+ | 实验档 | 可用后端探测；不兼容功能自动关闭 |
| 其他配置 | 通用媒体终修档 | 降噪、重绘替代与 Lanczos 超分，不强行启动 H3 |
笔记本双显卡或远程桌面识别不准时，打开左侧齿轮，在“识别电脑配置”中手动选择显卡厂商和显存。不要为了显示更多功能而选择高于实际显存的档案。
04 · 首次启动与验证
- 双击 start_h3_studio.cmd，保持黑色启动窗口开启。
- 浏览器访问 http://127.0.0.1:8191/；界面与引擎都只监听本机。
- 打开左侧齿轮，完成硬件、规格、组件和保存四步；缺失能力会明确标注。
- 先运行 608×352、0.5 秒草图验证。成功后再提高到 1280×736、5–10 秒。
- 首次 SageAttention 编译会较慢，后续任务复用项目内缓存。
start_h3_studio.cmd需要原生 ComfyUI 节点界面时可运行 start_h3.cmd 并访问 8189；日常创作无需进入它。关闭启动窗口或点击左侧电源按钮即可停止。
05 · 制作第一个视频
- 从左侧工作流库选择“文生视频”“首帧生成”“首尾帧”“R2V 多参考”“重绘”或“降噪与超分”。
- 点击素材节点上传文件，或从素材库分配已有文件；R2V 可混合最多 9 图、3 视频/配套音轨、3 独立音频。
- 填写提示词。长镜头和建筑场景优先用首尾双锚，并明确“保持结构、不漂移”。
- 确认生成节点的分辨率、时长与步数。正式 Turbo 建议 6–8 步；R2V 使用独立步数。
- 终修节点会根据显卡自动选择 NVIDIA Maxine 或通用时序降噪与 Lanczos 超分。
- 点击底部“运行工作流”，完成后在成片输出节点预览和下载。
画布、节点参数和素材引用保存在当前浏览器本机。不要在任务运行中关闭启动窗口，也不要并行运行两个高显存任务。
06 · Cloudflare Pages 网页端连接
网页与 H3 在同一台电脑（推荐）
- 先运行本机 start_h3_studio.cmd。
- 打开你部署的 Pages 网站，点击“连接 / 安装 H3”。
- 选择“一键本机配对”，在 127.0.0.1 授权页确认；网页会自动返回并保存连接。
不同设备或必须使用 Tunnel
- 为本机 8191 建立受保护的 HTTPS Tunnel，禁止直接公开 8189。
- 在项目根目录运行下方命令，把你的 Pages 精确域名加入允许列表。
- 只在 Pages 的高级连接界面输入 Tunnel 地址和本地密钥；不要把密钥写进公开仓库或 config.js。
.runtime\python\python.exe tools\configure_cloud_access.py --origin https://你的站点.pages.dev“Unexpected token '<' … is not valid JSON”通常代表网址返回了 HTML 页面，而不是 H3 API。请检查引擎地址是否指向 8191、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 为准。