Jojocodex/H3-Wushu-Fight-Simulator

H3 武斗模拟器 v9.25

一个 Windows 单文件程序：在本地把"两个人（或神仙）怎么打"真的模拟一遍，再据此生成 MiniMax H3 影片提示词。

• 先跑一场 60Hz 确定性 3D 打斗结算（谁出招、什么招、命中还是被格挡、有没有被击退、离地几米……全部是算出来的，不是编的）；
• 把结算结果 + 打斗风格 + 角色套路 + 招式具名形态 + 特效分级整理成素材，喂给 AI（你自己的 Key）写成可提交的 H3 提示词；
• 全程本地：不需要 Node、不需要 Python，不填 Key 也能用（本地规则体检、实时 3D 预览、素材与骨架提示词都在本机出）。

主要解决四件事：

1. 位置与人不会乱：逐拍走位表（谁在画面哪侧、相距几米、离地多高）随素材一起给模型，切镜有交接句，体检会拦"瞬移/换人/消失"。
2. 打法不千篇一律：7 档打斗风格（自动／近战对拼／法术为主／近战衔接法术／空战腾挪／游走一击／仙神斗法）× 16 份角色套路档案（杨过＝重剑挥砍→衔接黯然销魂掌、洪七公＝降龙十八掌、孙悟空＝棍法＋分身术／七十二变／法相天地…），内核按同一份参数真的执行。
3. 神仙打架是神仙打架：89 级默认走「仙神斗法」——法术为主（法术相关拍 ≥70%）、**每次施法蓄力 24 秒**（长蓄力期间第一次被打中会被"施法护体"硬吃、不打断）、法相与天地异象铺满画面。
4. 特效有规格、有仓库：116 件具名特效仓库（拳掌／兵器／元素／仙侠法术／天地异象／神通法相／身法／护体／环境留痕／收尾共 10 类），每件按官方的形·色·量·光·破·影写全＋五拍＋蓄力秒数＋声音层＋留痕；特效量级按武力等级×风格档分 9 档给出体量（米）与留痕要求。提示词里会按"等级×风格×片长"挑好本场要写的原件数并列出【特效清单】【施法时间】。

一、下载哪个文件

文件	大小	什么时候用
H3武斗模拟器.exe	69.7 MB	只想要程序：单文件，双击即用（页面、三维、战斗内核都已内嵌）
H3武斗模拟器-v9.25-便携版.zip	65 MB	想要 程序 + 文档 + 规则手册
H3武斗模拟器-v9.25-完整版含LAYA运行时-模型按需下载.zip	244 MB	想连本地 Laya 裁判／排镜头一起开箱可用（自带 Python 运行时与启停脚本；权重不随包分发，勾选启用后自动下载约 2.4 GB）
docs/*	—	说明书、版本说明、技术日志
h3-skill/*	—	提示词规则手册（wushu-fight-rules-V3.2-优化版.md/.txt）、**特效仓库全表 fx-library-V1.md/.txt/-en.txt**（116 件具名特效写法）与 MiniMax 官方格式参考

EXE 校验值见仓库内 SHA256.txt，或：

Get-FileHash .\H3武斗模拟器.exe -Algorithm SHA256

二、怎么跑（三分钟）

1. 解压到任意目录（便携版／完整版不要只把 exe 拖出来单独放，脚本与文档在同一层）；
2. 双击 H3武斗模拟器.exe。首次启动会把内嵌页面解压到 %LOCALAPPDATA%\H3WushuSim\，十几秒后秒开；
3. 武打页：

步	做什么	要花钱吗
①	（可选）填「一句话设定」→ 点「AI 填充角色卡和规则」；也可手填角色卡	要 Key（这步是 AI）
②	选「打斗情景」「打斗风格」，再用「角色套路档案」一键套给 A/B（例：套「孙悟空」给 A）	不要
③	点「模拟并生成 H3 提示词」——本地内核先真打一场，再写素材与提示词	不要
④	点「实时 3D 对打」看这一场（可关「3D 动画」开关，只要提示词不渲染）	不要
⑤	点「提示词体检」看逐条改法（本地规则引擎）	不要
⑥	点「Laya 裁判（本地）」判分 →「按LAYA意见改」按判分与体检条目重写一版	要 Key（这步是 AI）

不填 Key 时：③④⑤ 与全部素材（走位表／招式形态／特效分级／打斗风格／角色套路／神通）照常产出，只是不调 AI 润色。

三、环境要求

• Windows 10/11 x64（.NET 8 单文件 + WebView2；多数系统已自带 WebView2 运行时，缺了装一次微软官方 Evergreen 运行时即可）。
• 不需要 Node.js、不需要 Python、不需要联网（联网仅用于：AI 润色、可选的 Laya 模型自动下载）。

四、可选的本地 Laya（裁判 / 排镜头 / 总控）

• 勾选「启用 Laya」后程序会自动识别本机是否已有模型，没有才下载（约 2.4 GB）；
• 下载源默认 HuggingFace（convaiinnovations/laya），支持 hf-mirror.com 镜像；想走自建仓库时设环境变量 H3_LAYA_REPO=<用户名>/<仓库名>，或用完整版里的「下载LAYA模型.bat」；
• 它负责给提示词打分、指出弱项、决定下一步该修哪条；不开也不影响其它任何功能。

五、包里有什么（便携版／完整版）

H3武斗模拟器.exe                主程序（单文件）
H3武斗模拟器_使用指南.md         完整说明书（3D、特效分级、Laya、文戏、模板库、常见问题）
README-优化版.md                这一版做了什么（按需求逐条，含量化前后对比）
上下文日志.md                   逐次改动的技术记录（含每次怎么验收的）
快速开始.txt                    纯文本版快速开始
h3-skill/                       提示词规则手册与官方格式参考（base-en.txt / ref-en.txt）
SHA256.txt                      校验值

完整版另有 LAYA后台\（Python 运行时、laya_serve.py、laya_fetch.py、启动/停止/检查环境/下载模型四个 .bat）。

六、常见问题

• 提示缺少 WebView2：装一次微软官方 Evergreen 运行时。
• AI 润色没反应：右上「API设置」没填 Key，或地址不是 OpenAI 兼容格式。
• 想换打法：左侧「打斗风格」7 档（第一项「自动」按武力等级选：8 级以上→仙神斗法）；角色级用「角色套路档案」（16 份）；神仙角色的神通写在角色卡的「神通」一行（中文名或 clone 这类 key 都认）。
• 想要更多特效写法：看「💥 特效仓库」面板（可折叠，分类/搜索/复制/导出 Markdown），或读仓库里的 h3-skill/fx-library-V1.md。
• 配置在哪：%LOCALAPPDATA%\H3WushuSim\（Key、模板、勾选状态、selftest.txt、laya_service.log）。删掉＝恢复出厂。
• 自检：H3武斗模拟器.exe --selftest，报告写在上面那个目录，status=PASS 表示无异常。

七、说明

• 3D 是"先算后播"的程序化角色预演（基础人形 + 队色区分），不是已生成的写实武打视频；它的用途是核对位置、节奏与招式。
• 1v1 走 60Hz 真实结算；一打多目前走群战结算（实时 3D 预览只支持 1v1）。
• 本仓库分发的是可执行程序与文档；规则手册 h3-skill/wushu-fight-rules-V3.2-优化版.md 可直接当提示词工程的参考读物使用。

八、版本

当前 v9.25。EXE 内自带完整自检（200+ 项断言），发版都在本机跑通 --selftest（status=PASS）后才打包。