Jojocodex/H3-Wushu-Fight-Simulator

H3 武斗工作室 v20.6.7：Hugging Face 发布与使用

H3 武斗工作室将故事拆成文戏与武戏，自动整理资产、编排镜头、运行本地战斗或文戏设计、优化提示词并同步可编辑画布。最终结果是完整资产提示词和分镜提示词；图片与视频生成由用户从成稿页面启动。

下载与启动

在仓库 Files 页面下载 H3-Studio-v20.6.7-Windows-Full.zip，完整解压后运行 H3WushuSim.exe，保留所有同目录 DLL。窗口应显示 v20.6.7；不要在压缩包内启动。Windows 版不要求安装 Node.js 或 Python，WebView2 Runtime 需要可用。

本仓库只发布 Windows 程序包（不提供源码包），因此无需安装 Node.js 或 Python。

本仓库只发布 Windows 程序包（不提供源码包），因此无需安装 Node.js 或 Python。

浏览器打开终端给出的地址。上传 EXE 到 Hugging Face 并不会使 EXE 直接在网页上运行。本说明用于软件文件分发；要部署成 Space 还需另做服务启动与部署配置。

基本使用

1. 新建项目，输入一句话或故事，选择总时长与提示词平台。
2. 选择图片和视频风格，默认真人写实。
3. 在右上角 API 设置中配置语言模型。勾选全自动，点“开始 / 下一步”。
4. 等待故事、资产、场次、镜头、文武戏优化、最终检测完成；左侧状态显示进度，画布同步结果。
5. 在成稿预览编辑或复制提示词，统一保存全部清单。每镜仅引用其需要的 @资产。
6. 可上传资产图，或配置图片接口反复抽卡，选定满意图片作为参考。
7. 配置视频接口，保存本段参考绑定后生成视频，预览并下载。查询中断使用原任务编号恢复。

每段与镜头采用 5–15 整数秒，整体时长贴近设定；文戏和武戏可拆成多场。项目中的资产、镜头、画布与图片选择彼此独立。Agent / SKILL 页面可查看来源、修改提示词规则并用于后续调用。

接口与模型

模型权重不包含在 ZIP 中。Qwen 需要安装对应模型和节点；llama.cpp 使用 GGUF。Windows 语言设置提供模型目录扫描，默认 I:\llama-cpp\models。模型下载工具提供断点续传与 SHA256 校验。

统一设置可下载官方 Qwen FLOW、执行器及当前项目 FLOW 包。FLOW 包需要选择单条资产/片段执行，缺图草稿必须先补全绑定：

$env:MINIMAX_API_KEY="在本机设置自己的密钥"
python run_flow.py 导演项目-FLOW.json --source-id S01 --output renders

发布者上传文件

建议以 Dataset 仓库保存软件归档。将 Windows ZIP 与校验清单放进本机 release 文件夹，并将本说明用作仓库 README.md。安装并登录 Hugging Face CLI 后，替换下面的 YOUR_NAME：

python -m pip install -U huggingface_hub
hf auth login
hf repos create YOUR_NAME/H3-Studio --repo-type dataset
hf upload YOUR_NAME/H3-Studio ./release . --repo-type dataset

仓库已存在时跳过创建命令。安装包只是发行文件，不要将 API Key、私人故事、项目档案或模型权重混入 release 文件夹。本仓库不发布源码包。

下载较大 ZIP 时也可使用 CLI：

hf download YOUR_NAME/H3-Studio H3-Studio-v20.6.7-Windows-Full.zip --repo-type dataset --local-dir downloads

下载完成后使用发布者的 SHA256 校验；Windows PowerShell 可执行 Get-FileHash .\H3-Studio-v20.6.7-Windows-Full.zip -Algorithm SHA256。不要下载仓库网页的 HTML 当作 ZIP，解压错误时检查文件大小与校验值。

CLI 命令依据 Hugging Face 官方说明。本任务未替用户发布到 Hugging Face 账号。

验证范围

350 项 Node 单元测试通过，另通过引擎/动作/模板/文戏测试链和 8 项新增 Python 测试；浏览器完成受控的 120 秒导演全流程、项目隔离、上传、候选选择和生成接口契约验证。Windows 宿主已编译并核对打包，未在本次 Linux 环境中实际运行，也未使用真实付费 Key 或 GPU 模型。

实时 3D 和 AI 角色控制为 1v1，群战采用群战结算；当前未实现多角色实时 3D 群战，也未更换商业战斗引擎。最终视频质量与审核取决于生成平台，白膜预演和提示词检测不保证最终视频完全无漂移。

更完整的操作、参数、来源与验收范围见包内 docs/v18-使用指南.md、docs/v18-需求验收.md 与 docs/来源与适配说明.md。

本次更新（v20.6.7 · 2026-10-05 修订）

完整解压后运行 H3WushuSim.exe，保留同目录依赖。

本次修复最终交付卡在86%的问题：审核返回普通正文、中文冒号、Markdown字段时自动规范为H3六段；保留审核后的动作正文；重新检测当前稿而非旧缓存；分镜单镜格式同步补齐；一致性问题纳入自动修复；评分建议保留展示但不单独阻断交付。素材超限、时长越界、真实内容错误仍会拦截，并显示具体原因。

旧项目读取后可点“AI全部修复 / 继续”完成最终交付，无需从第一步重做。

截图未包含具体质量报告，因此不能确认所有内容问题的原因。此版本针对已确认的格式和流程缺陷修复，未宣称屏蔽所有检测。

怎么启动（Windows）

1. 下载 H3-Studio-v20.6.7-Windows-Full.zip，完整解压到一个新目录（不要只解出 EXE）。
2. 双击解压目录里的 启动 H3 武斗工作室.cmd —— 它会自检依赖、提示缺失项，然后拉起主程序。
3. 也可以直接双击 H3WushuSim.exe（主程序本体，154 MB）。
4. 如果打不开，双击 **排错启动-显示报错.cmd**，把窗口里的输出发回来即可定位。

同目录 DLL 与 runtimes\ 子目录必须与 EXE 放在一起；需要 Windows x64 与 WebView2 Runtime。

本仓库文件

文件	说明	大小	SHA256
H3-Studio-v20.6.7-Windows-Full.zip	Windows 版程序（2026-10-06 版：分级修复——错误按类分诊（时间/H3格式/长度/施法/连贯性），本地规则能修的不调AI，必须调AI的自动注入对应SKILL并逐次升档输出上限；另含长度上限根治、漫剧SKILL库、360条目化、镜头时间根治等）	69.69 MB	D250C4C353E6A843A28F4F3257F4B05038063ACB826E08BBD2294846C87ABD8B
使用说明-v20.6.7.md	使用说明	—	—
更新说明-v20.6.7.md	本次更新	—	—
SHA256.txt	校验清单	—	—

⚠ 必须完整解压后运行 H3WushuSim.exe：同目录 DLL 与子目录（director/、docs/、tools/）缺一个都可能打不开；需要 Windows x64 与 WebView2 Runtime。 本仓库只发布程序包；源码包不在仓库提供。模型权重、平台 Key 与本地 ComfyUI 需自行配置。