H3
创作系统

选择完整模板，或在无限画布中添加节点并重组连线。

H3 生成 FL2VA
修复与交付自适应
本地素材 0
100%
T2V · 拖拽节点 / 滚轮缩放 / 空白处平移 / Delete 删除
等待任务画布自动保存在本机
H3 STUDIO · USER MANUAL

# 从零安装与使用

覆盖下载、部署规格、国内下载链路、首次启动、工作流创作、网页配对、维护与卸载。正常本机使用不需要 Docker、venv 或系统级 Python。

## 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 · 一键安装的全部操作

1. 下载 H3-Studio-OneClick-CN.zip，右键“全部解压”到至少有 100GB 空间的磁盘。
2. 进入解压后的根目录，双击 setup_h3_cn.cmd。
3. 阅读并确认 MiniMax H3 社区模型许可；只有这一步需要人工确认。
4. 等待硬件检测、标准 Python 运行时、ComfyUI 依赖、节点和模型下载完成。不要关闭窗口。
5. 若网络中断，再次双击同一文件即可续装；已完成且校验通过的文件会跳过。
6. 看到安装完成后，浏览器会打开 H3 Studio；以后只需双击 start_h3_studio.cmd。

`setup_h3_cn.cmd`

### 默认中国大陆下载链路

PY
Python 华为云，失败后切换阿里云。
PK
Python 依赖清华 TUNA；PyTorch 使用阿里云。
H3
MiniMax H3 权重魔搭 ModelScope，支持续传。
LR
Turbo LoRA HF-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 · 首次启动与验证

1. 双击 start_h3_studio.cmd，保持黑色启动窗口开启。
2. 浏览器访问 http://127.0.0.1:8191/；界面与引擎都只监听本机。
3. 打开左侧齿轮，完成硬件、规格、组件和保存四步；缺失能力会明确标注。
4. 先运行 608×352、0.5 秒草图验证。成功后再提高到 1280×736、5–10 秒。
5. 首次 SageAttention 编译会较慢，后续任务复用项目内缓存。

`start_h3_studio.cmd`

需要原生 ComfyUI 节点界面时可运行 start_h3.cmd 并访问 8189；日常创作无需进入它。关闭启动窗口或点击左侧电源按钮即可停止。

## 05 · 制作第一个视频

1. 从左侧工作流库选择“文生视频”“首帧生成”“首尾帧”“R2V 多参考”“重绘”或“降噪与超分”。
2. 点击素材节点上传文件，或从素材库分配已有文件；R2V 可混合最多 9 图、3 视频/配套音轨、3 独立音频。
3. 填写提示词。长镜头和建筑场景优先用首尾双锚，并明确“保持结构、不漂移”。
4. 确认生成节点的分辨率、时长与步数。正式 Turbo 建议 6–8 步；R2V 使用独立步数。
5. 终修节点会根据显卡自动选择 NVIDIA Maxine 或通用时序降噪与 Lanczos 超分。
6. 点击底部“运行工作流”，完成后在成片输出节点预览和下载。

画布、节点参数和素材引用保存在当前浏览器本机。不要在任务运行中关闭启动窗口，也不要并行运行两个高显存任务。

## 06 · Cloudflare Pages 网页端连接

### 网页与 H3 在同一台电脑（推荐）

1. 先运行本机 start_h3_studio.cmd。
2. 打开你部署的 Pages 网站，点击“连接 / 安装 H3”。
3. 选择“一键本机配对”，在 127.0.0.1 授权页确认；网页会自动返回并保存连接。

### 不同设备或必须使用 Tunnel

1. 为本机 8191 建立受保护的 HTTPS Tunnel，禁止直接公开 8189。
2. 在项目根目录运行下方命令，把你的 Pages 精确域名加入允许列表。
3. 只在 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 为准。

SAFE DIAGNOSTICS · LOCAL ONLY

# 故障检测与修复

从实际运行时和日志判断问题。自动修复仅执行明确、可控的本地操作；不会删除模型、结束外部进程或上传日志。

SCAN
尚未检测本机环境点击开始检测，通常在数秒内完成。
检测结果会按“正常 / 提醒 / 错误”分级显示。
每一项都给出原因、操作步骤和可复制命令。
常见报错速查

### 返回 HTML，不是 JSON

出现 Unexpected token '<' 时，引擎地址通常填成 Pages 首页、8189 或错误 Tunnel 路由。

- 本机助手应为 127.0.0.1:8191
- 使用 Pages 的“一键本机配对”重新授权
- Tunnel 必须把根路径完整转发到 8191

### CUDA out of memory

关闭其他 GPU 程序与重复 ComfyUI；改用 608×352 / 0.5 秒草图或 RTX 低显存档，一次只运行一个 GPU 任务。

### 模型 / 节点缺失

再次运行 setup_h3_cn.cmd 续装。不要单独移动 safetensors；模型走 ModelScope，节点与依赖按安装清单恢复。

### 数据库或端口占用

关闭重复的 ComfyUI/H3 启动窗口，再运行 start_h3_studio.cmd。故障中心不会结束它无法确认归属的外部进程。

### SageAttention / Triton

平台会自动回退 PyTorch Attention。先确认生成可用，再按安装器版本恢复；不要安装与 Torch/CUDA 不匹配的随机 wheel。

### Maxine 不可用

非 RTX 会自动切换通用终修。RTX 用户更新驱动并重跑安装器；通用路径仍能降噪、保留音轨和高质量缩放。

H3

## 本地部署向导

不需要理解节点或显存调度。按四步确认，本系统会为你的电脑选择可运行的工作流。

所有检测只在本机完成。视频、模型路径与硬件信息不会上传。

# 正在检测本机

根据显卡、显存与已安装组件生成安全配置。

工作流日志
暂无运行日志。
O5 DESIGN