TRAE AI CREATIVITY CONTEST 2026

MUGEN 星海管理面板

从战绩统计到 AI 对话,从自动对战到剧情编排——为 MUGEN 角色星海而生的全生态管理面板,让格斗引擎开口说话、按剧本演出

80,000+
行代码
9
大功能模块
6
处引擎源码定制
3
实战移植案例
18
章AI设计手册
38万字
AI编程指导文档

真实使用数据

不是 Demo,是已经在重度使用的工具

👥

559 个角色

角色库已收录 559 个角色,其中 523 个已有战绩记录。涵盖 MUGEN 社区各类角色,从普通到神凶全覆盖。

⚔️

2476 场对战

已自动执行 2476 场 AI 对战,产生 1563 条结构化对局记录和 2691 条积分变动明细。全部通过内存级胜负检测自动记录。

🏆

15 级实力定档

配置了 15 级实力档位(超神到地板),283 个角色已自动定档。含 1v1 和 1v2 双人守门员挑战机制,档位判定由真实战绩驱动。

📅

4 个月持续使用

对局记录从 2026-05-09 持续到 2026-09-08,跨越 4 个月的日常使用。不是做出来就放着,是每天都在用的工具。

MUGEN:全球最大的开放格斗引擎

20 年社区沉淀,角色星海浩瀚

🌍

10万+角色资源

全球社区累计 10 万+ 自制角色,仅知名合集就涵盖 3,000~18,000+ 角色规模。涵盖街头霸王、龙珠、火影、海贼王、真人快打、漫威、卡普空等数百个 IP,从动漫、游戏、影视到网络热梗全覆盖。

🗺️

海量舞台地图

单个合集就包含 300~400+ 独立舞台,全球累计数千个自制战场,涵盖经典游戏场景、动漫名场面、原创世界观等。

🔧

活跃的开发者社区

MUGEN Free For All、Mugen Archive、GitHub 等平台汇聚全球数千名角色作者和 AI 开发者,持续 20 年产出新角色和新引擎补丁。

🎬

跨界文化熔炉

从七龙珠到原神,从赛尔号谱尼到雷电将军,从漫威英雄到初音未来,MUGEN 是唯一能让任何角色跨 IP 对战的开放平台,真正的文化大熔炉。

九大核心模块

从自动对战到 AI 生成,从战绩统计到剧情编排,覆盖 MUGEN 全生态

⚔️

自动批量对战

选好角色,点一下按钮,自动配对、自动启动 MUGEN 子进程、自动记录胜负、自动更新战绩。全程零人工干预,百场比赛压缩到喝杯咖啡的时间。

内存级胜负检测 100ms轮询 协作式取消
🎲

五种对战模式

自由战斗(1v1指定角色)、随机战斗(多角色自动配对)、档位挑战(守门员1v1/1v2)、批量挑战(多角色循环挑战某档位)、播放列表(编排赛程拖拽排序)。随机模式支持按段位/实力档次匹配对手,支持左侧固定锚定角色。

自由战斗 随机配对 档位挑战 批量循环 播放列表
🏅

段位积分系统

可配置的段位阈值与积分规则,7 级档位(青铜→王者)。守门员挑战机制支持 1v1 和 1v2 双人守关,5 级优先级判定链确保档位公正。

7级档位 守门员机制 自动重算
🎨

角色立绘与P数分析

从 SFF 精灵文件直接提取 9000 号大头像,渲染各 P 数站立姿态。P 数差异分析引擎扫描角色源码,自动识别 AI/性能/动作/模型/色表差异。

SFF精灵提取 12色表槽位 逆向分析
💬

AI 角色对话模式

与 Ikemen GO 中的角色用自然语言对话——"释放小型火焰""跳过去打他"。DeepSeek API 解析意图生成 [ACTION:xxx] 动作标记,转成 realtime_cmd.json 文件指令,Lua 端 hook.add("loop") 每帧检测执行 selfState/setAILevel,实现零延迟帧级控制。

DeepSeek API 动作标记解析 实时指令通道 帧级控制
🎚️

战斗干预系统

战斗进行中右侧悬浮窗随时接管——上部技能快捷按钮一键释放指定招式,下部自然语言指挥框输入"让桐人现在开大反击",LLM 解析意图后写入 realtime_cmd.json,与剧情模式共用 story_runtime.lua 底层。Watch 模式下 AI vs AI 推荐场景。

技能快捷按钮 自然语言指挥 实时接管 Watch 模式推荐
🎬

剧情编排系统

可视化编排多场连续战斗剧情:14 种步骤类型(对话/状态/生命/能量/AI/等待/受击等待/动画/速度/结束)× 8 种节点条件(始终/存活/阵亡/血量≤/血量≥/能量≥/状态/回合状态),4 种内置模板(变身反杀/绝地反杀/阶梯训练/多场对话)一键创建。

14种步骤 8种条件 4种模板 节点链触发
🤖

AI 自动生成系统

五阶段向导(分析→决策→生成→检查→测试)为无 AI 角色自动生成战斗代码。3 种战斗模式(近战连段型/均衡型/远程压制型)× 3 种实现模式(独立 AI 文件/主文件追加/覆盖作者),严格兼容 MUGEN 1.1 标准。检查清单覆盖招式覆盖率/距离校验/安全条件/兼容性,未通过可自动修复重试。

5阶段向导 3×3组合 DeepSeek辅助 自动修复
🔄

角色版本转换

将 WinMUGEN/1.0 角色移植到 1.1 引擎。自动化扫描风险项、报错驱动修复、功能验证全流程。已成功转换谱尼(455处%n)、雷电将军、流萤等角色。

扫描-修复-验证 3个实战案例 99%代码保留率

源码级重构 Ikemen GO 引擎

不止"用"引擎,而是改引擎——fork 源码做 6 处 Go 定制 + 新增 2 个 Lua 每帧运行时脚本,AI 对话 / 战斗干预 / 剧情编排三大模块都建立在这层改造之上

📄

比赛结果落盘

上游引擎打完不写输赢,我们在 system.go 新增 writeMatchResult(),整场结束时把 winner / p1_wins / p2_wins 写入 save/logs/match_result.txt。自动对战的胜负判定因此无需逆向内存,与 MUGEN 侧的内存读取形成两条互为备份的路线。

system.go 文件闭环 双检测路线
🎨

对战界面 P 数显示

fightscreen.go 在角色名后附加当前实际生效的配色号(P 数),批量 AI 对战核对双方配色一眼可见;并保留"未加修改"的备份 exe 作对照。

fightscreen.go 配色核对 备份对照
💬

剧情轮流对话框

上游是"两个对话框同时挂"的格斗游戏风格,且新对话会因渲染状态未释放而卡死。motif.go + script.go 改造后:头像显示说话者本人、只绘制当前说话者一侧、连续对话即时加载——剧情演出才成立。

motif.go script.go 轮流发言
🧭

运行时稳定性修复

main.go 用 os.Executable() + os.Chdir 把工作目录钉死在 exe 目录,治"save/ 落到盘根";dllsearch_windows.go 放宽 DLL 检查——官方发布包不带 avdevice-*.dll,原版检查会导致启动即崩。

main.go baseDir 修复 DLL 检查放宽
⚙️

Lua 每帧运行时(约 1000 行)

新增 story_loader.lua + story_runtime.lua:hook.add("loop") 每帧调度——实时指令消费(读后即删)→ 无限血守护 → 静止敌人压制 → holdState 持续状态保持 → 14 步骤剧情状态机 → 中文对话气泡。全部 pcall 包裹,出错不崩引擎。

story_loader.lua story_runtime.lua hook.add("loop")
🔍

引擎调试版三件套

带 -trace 参数的运行时追踪版(可追踪任意角色的实际绘制帧与调色板)、调色板追踪版、P 数显示修改前的备份版——引擎级的问题,在引擎里排查。

-trace 追踪 调色板追踪 可观测

技术亮点

解决 MUGEN 社区长期存在的工程难题

内存级胜负检测

直接读取 MUGEN 进程内存基址,通过指针偏移定位双方胜场计数器。解决 MUGEN 1.1 原生日志不含胜者字段的根本问题。

中文路径零拷贝

用 Windows mklink /J 创建 junction 联结,将中文路径映射为 ASCII 短路径,资源文件零拷贝直接引用,彻底解决崩溃问题。

6种Worker多线程

BattleWorker / PrefetchWorker / RecalculateWorker / LivePreviewWorker / PortraitQueue + 60s 看门狗,UI 全程不卡顿。

5级缓存体系

以 file_signature (size+mtime) 为核心原语,6 层递进签名校验 + SHA1 内容寻址缓存,源文件变化自动失效。

实力定档闭环

定档结果反向进入战斗编排系统自动播放战斗,战斗后再计算实力定档,实现完全自动化的联赛循环。

UI布局完整持久化

窗口/分割器/表格列序/冻结列/自定义列名/折叠状态全部自动保存恢复,含离屏检测和防抖机制。

版本转换工程规范

三层解耦:扫描只发现、运行才证明、Fatal 才修改。配套自动化脚本 fix_tagout / fix_exploit / fix_binary_st。

AI设计方法论

18 章系统化手册:分层决策(宏观策略/中观距离/微观连段)+ 概率驱动 + 安全优先 + 全招式覆盖,3 个端到端参考角色。

SFF精灵逆向解析

逆向分析 MUGEN 二进制 SFF 精灵文件格式,提取 9000 号大头像和站立姿态精灵。不依赖 Fighter Factory 等第三方工具,纯代码实现精灵解析与渲染。

Python+Lua 跨语言文件桥

Python 端写 realtime_cmd.json / active_story.lua 文件,Ikemen GO Lua 端 hook.add("loop") 每帧检测执行。零进程间通信开销,零延迟帧级精度,无需改引擎源码即可注入剧情逻辑。

Ikemen GO 引擎源码级重构

不是"拿来就用":fork 引擎源码定制 6 个 Go 文件——writeMatchResult() 结果落盘、对战界面 P 数显示、baseDir 修复、DLL 检查放宽、连续对话修复、剧情轮流对话框。DLL 全部放 lib/ 并在 PATH 注入,stdout 重定向捕获 init() 阶段错误。

Lua 引擎运行时扩展

新增 story_loader.lua + story_runtime.lua(约 1000 行),hook.add("loop") 每帧调度实时指令→无限血→holdState→剧情状态机,全部 pcall 包裹;配套 -trace 追踪版 / 调色板追踪版 / 备份版三个定制 exe,引擎行为全链路可观测。

withActor 焦点切换模式

Ikemen GO Lua API 操作 sys.debugWC(当前焦点角色),严格遵循"保存 id()→player() 切换→操作→playerId() 恢复"模式,实现 selfState/setLife/setPower/setAILevel 帧级角色控制。

三层无限血保护

命令行参数 -p1.life 999999 兜底 + Lua 每帧守护检测 infinite_life.flag 标志文件生命值低于 50% 回满 + 标志文件生命周期管理(对话模式启动创建/关闭删除),防止 AI 对话误杀导致模式自动退出。

角色技能标准化

CharacterStandardizer 一次性读取角色 .def/.cmd/.cns 文件,调用 DeepSeek API 提取技能(人话名/状态号/类型/命令/消耗/描述)存入 character_skills 表,AI 对话、技能按钮、剧情编辑三功能共用,避免反复读文件。

五阶段 AI 生成向导

分析(读取 .def/.cmd/.cns/.air + DeepSeek 辅助)→ 决策(战斗模式/实现模式/var 规划)→ 生成(CMD 虚拟命令 + CNS Statedef -3)→ 检查(招式覆盖率/距离校验/安全条件/MUGEN 1.1 兼容性)→ 写入+测试。未通过检查可自动修复重试。

3×3 AI 生成组合矩阵

3 种战斗模式(近战连段型/均衡型/远程压制型)× 3 种实现模式(独立 AI 文件/主文件追加/覆盖作者)= 9 种组合,每种模式有独立策略状态机和连段系统。远程压制型采用技能轮换替代连段,每帧攒气维持火力。

MUGEN 1.1 兼容性约束

开发用 Ikemen GO 排查问题,目标运行环境为 MUGEN 1.1。禁止使用 AssertCommand/RedirectID/AILevelF/ZSS 语法等 Ikemen 独有特性;AI 开关用 var(59) 虚拟命令 + 恒真兜底(ai设计.md 模式二),所有版本通用。

AIR 碰撞框逆向提取

逆向解析 AIR 动画文件的 Clsn1(攻击碰撞框)和 Clsn2(受击碰撞框),结合 CNS Statedef 提取每招式的伤害/距离/取消链,为 AI 生成提供精确的招式元数据,避免 AI 释放超出攻击范围的招式。

14步骤剧情状态机

story_runtime.lua 实现节点条件检测→执行步骤序列的状态机:非阻塞步骤(dialogue/state/life/power/ai)立即执行推进,阻塞步骤(wait/wait_hit/wait_alive/wait_state)设置 blocking 状态条件满足后解除,end 步骤跳下一节点。

textImg 中文对话气泡

懒加载 simhei.ttf 系统黑体支持中文,角色名黄色 24px + 对话文本白色 20px,UTF-8 自动换行(中文算 2 宽度英文算 1),luaFlushDrawQueue 在 renderFrame 中执行,frames 倒计时到 0 自动清除。

左右悬浮窗跟随系统

无边框半透明深色背景,置顶可切换;100ms 采样 win32gui 跟随 Ikemen GO 引擎窗口移动/缩放;引擎最小化时悬浮窗跟随隐藏恢复时自动恢复;左右边界拖拽条调整宽度。

AIR动画帧逆向渲染

逆向解析 AIR 动画定义文件,提取角色站立动作序列帧,自动选择最佳帧渲染各 P 数(1-12 色表槽位)的实机预览图,无需进入游戏即可查看角色。

战场背景逆向渲染

逆向解析 .def 舞台定义文件格式,提取背景层定义、parallax 视差参数和遮挡关系,独立渲染战场预览图,不启动 MUGEN 即可预览场景全貌。

性能优化与工程深度

80000+ 行代码背后,是反复打磨的工程细节

协作式取消三重保险

threading.Event() 零开销查询取消标志,先设协作标志,再 terminate() 进程,3s 后 kill(),确保战斗任务安全终止不残留。

立绘队列看门狗

PortraitQueue 每 5s 检查 worker 状态,超过 60s 未完成的任务自动踢出,_emitted 标志防止超时与正常完成的竞争条件。

表格批量更新防抖

批量更新战绩表/角色表时 blockSignals(True) 阻止逐行触发信号,20+ 处调用,避免大量无用的 UI 重绘。

战绩内存缓存

StatsService 用 (file_signature, data) 对做内存缓存,读取前先比对文件签名,未变化则跳过 JSON 解析直接返回。SQLite 5 个索引加速查询。

战斗监控效率

WinCountMonitor 100ms 轮询间隔,仅在胜场变化时记录。诊断采样 5s 一次,样本上限 40 条,防止长时间战斗内存无限增长。

日志自动管理闭环

启动时清理 30 天前的 .log 文件,desktop_runtime.log 超 5MB 自动归档为带时间戳文件,归档文件 30 天后自动删除。

布局持久化健壮性

离屏检测恢复时检查窗口矩形与屏幕相交;offscreen 平台保护跳过保存;启动防抖 500ms 防中间状态写入;自动保存防抖 350ms 单发定时器。

内容寻址缓存自动清理

立绘/预览缓存文件名由 SHA1(源文件签名+版本号) 生成,源文件变化产生新路径,旧缓存自动孤立无需手动清理。