GI-cutscenes 终极上手指南用命令行工具把《原神》过场动画提取成 MKV 电影【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenes很多玩《原神》的朋友都有过这样的遗憾剧情里那些制作精良的过场动画想回看只能重新进游戏重播想收藏又打不开游戏目录里的文件——因为它们都是加了密的 USM 容器格式。GI-cutscenes 正是为此而生的命令行工具它专门负责 USM 过场动画的提取与转换把视频、音频、字幕全部解出来并合并成一部带字幕的 MKV 电影适合想收藏剧情、剪辑二创素材或对多媒体格式好奇的技术爱好者。拿到工具三种装法任你挑先解决工具从哪来的问题。GI-cutscenes 基于 .NET 6 构建官方为Windows、Linux、macOS三个平台都发布了打包好的可执行文件你按自己的系统选一份就行独立版self-contained体积大一些但装完就能跑机器上有没有 .NET 环境都不影响依赖版framework-dependent体积小很多前提是你已经装过 .NET 6 运行时。如果你喜欢从源码折腾也可以自己克隆构建git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes cd GI-cutscenes dotnet publish -c Release -r linux-x64克隆之后用dotnet publish把项目编译成对应平台的二进制-r后面的参数换成你的目标平台即可。装好之后先跑一条命令确认一切正常GICutscenes -h它会打印完整的命令清单和参数说明。看到帮助信息说明工具已经就位可以进入下一步了。第一次运行从一条最简单的命令开始别一上来就挑战完整流程我们先找一个复制即跑通的最小用例。解包过场动画后音频会以 HCA 格式保存——HCA 是一种被上了锁的加密音频格式普通播放器不认。把它变成通用格式只需要一条命令GICutscenes convertHca bgm_0.hca -o ./wav_outconvertHca负责把 HCA 音频解码成 WAV——WAV 是最常见、几乎任何软件都能打开的无损音频格式-o指定输出目录。运行完去wav_out文件夹看一眼里面应该躺着一个能直接双击播放的.wav文件。就这么简单你已经完成了人生第一次游戏音频的解锁。完整链路把单个过场动画变成一部小电影真正的重头戏是完整链路一次命令从加密的 USM 文件直接得到一部带字幕的 MKV 电影。先解释几个名词免得你后面看晕USM是一个把视频、音频、字幕打包在一起还上了锁的箱子demux拆包就是把箱子打开把里面的轨道一条条取出来MKV是一种开放的多媒体容器能把视频、音轨、字幕甚至字体都装进同一个文件。下面这条命令就是完整链路GICutscenes demuxUsm story_01.usm -o ./out -m -s逐段拆解demuxUsm处理单个 USM 文件-o ./out指定输出目录-m表示合并成 MKV-s表示把字幕也塞进去。中间步骤工具会自动完成视频流提取为 IVF 格式一种存放裸视频的简单容器方便识别 VP9 编码HCA 音频解码成 WAVSRT 字幕转成带样式的 ASS 字幕最后全部合并。等命令跑完./out里就是一部可以当电影看的小短片。批量处理整目录的动画一次搞定单个文件处理没问题之后就该面对真正的需求了一个动画文件夹里可能有几十上百个 USM 文件一个个敲命令不现实。批量命令就是为此准备的GICutscenes batchDemux ./clips -o ./archive -m -s -ncbatchDemux会扫描./clips目录下所有.usm文件并逐个处理-ncno-cleanup的意思是合并完成后保留中间产物方便你检查或二次使用。处理完的目录结构大致是这样archive/ ├── story_01.mkv # 最终成品视频 音频 字幕 ├── story_01.ivf # 提取出的视频流-nc 时保留 ├── story_01_0.wav # 语音轨道一 └── story_01_1.wav # 语音轨道二批量模式下音频解码默认多线程并行几十个文件也花不了太久。另外提醒一句如果不需要中间文件去掉-nc工具会在合并后自动清理省下不少磁盘空间。进阶定制编码、引擎与语言轨道基础流程跑通后你会开始在意细节——比如输出文件太大、只想要某几种语言。这时有三个参数值得认识。选择合并引擎。工具内置了 MKV 合并能力不需要任何外部软件但如果你机器上装了 MKVToolNix 或 FFmpeg也可以让它们代劳GICutscenes demuxUsm story_01.usm -o ./out -m -e mkvmerge-e后面可填internal内置、mkvmerge或ffmpeg默认是内置引擎。压缩编码。原始视频是 VP9、音频是 PCM文件偏大。想换成更通用的编码组合GICutscenes demuxUsm story_01.usm -o ./out -m -af aac -vf h264-af指定音频编码-vf指定视频编码。有个小细节值得注意一旦指定了任一编码参数工具会自动把合并引擎切到 FFmpeg因为它才具备重编码能力。挑语言轨道。如果只想要中、日两轨用-al过滤GICutscenes demuxUsm story_01.usm -o ./out -m -s -al chi,jpn-al的可选值包括chi、eng、jpn、kor用逗号分隔没写进去的轨道会被跳过。别忘了给密钥库充电工具能解密游戏文件靠的是一个名为versions.json的密钥库里面记录着各游戏版本对应的解密密钥。新版本游戏发布后如果你手里的密钥库还没跟上处理时就会提示找不到密钥。解决办法是运行更新命令GICutscenes update它会把最新的密钥库拉下来同时检查工具本身有没有新版本。网络环境特殊时还可以加-p指定代理。万一哪天把配置文件改坏了GICutscenes reset能一键把它恢复成默认状态是个很实用的兜底命令。配置文件里的四个开关工具目录下有个appsettings.json它控制着四个行为开关按需修改后保存即可不需要重新编译MkvMergePathmkvmerge 可执行文件的路径装了 MKVToolNix 且不在默认位置时填这里FfmpegPathFFmpeg 的路径系统 PATH 里能找到就留空SubsFolder字幕数据目录默认指向工具同级的GenshinData/Subtitle里面按语言分子文件夹SubsStyle字幕显示样式遵循 ASS 字幕的样式语法想调字号、颜色、位置就改这一行。顺带一提字幕要生效还需要两样东西一份字幕数据从游戏数据仓库里整理出来按字幕名_语言.srt的命名放到SubsFolder对应语言目录下以及游戏font目录里的字体文件ja-jp.ttf、zh-cn.ttf把它们复制到工具目录即可工具会自动把字体嵌入 MKV。常见问题三个高频坑坑一提示找不到解密密钥。症状是处理新版本过场动画时报密钥不存在。原因是本地的versions.json落后于游戏版本。解决先跑GICutscenes update如果还不行去项目的 Pull Requests 区看看社区通常很快会提交新密钥更新密钥库文件后重试即可。坑二字幕和声音对不上。症状是字幕比音频快或慢几秒。原因可能让你意外游戏里这段动画本身就有偏移工具只是忠实还原。解决先用播放器确认游戏原文件是否同样错位若是游戏自身问题换用--no-cleanup保留字幕文件手动调整时间轴后再合并。坑三字幕显示成方块。症状是字幕文字全部变成□□□。原因是字体文件缺失或没放进工具目录。解决确认ja-jp.ttf、zh-cn.ttf已复制到工具同级目录且文件名未被改动然后重新合并。让流程更顺手的几个习惯处理大量文件时三个习惯能帮你少走弯路。第一用脚本串起来。把重复操作写成一个循环例如在 Linux 下对某个目录批量出片for f in ./clips/*.usm; do GICutscenes demuxUsm $f -o ./archive -m -s done第二管理好磁盘。USM 解包后中间文件体积不小收藏场景建议保留-nc产物便于日后重新压制批量归档场景则去掉它只留 MKV 成品。第三善用调试开关。出错时命令末尾加-st终端会打印完整堆栈把这段输出贴给维护者或社区问题定位会快很多。下一步动手试一次到这里GI-cutscenes 的核心玩法你已经全部掌握了从单条命令解锁音频到一条命令产出带字幕的 MKV 电影再到批量归档、编码定制和密钥维护。别停留在收藏这篇文章——现在就去游戏目录里翻出一个 USM 文件跑一遍demuxUsm -m -s亲眼看看加密的动画变成可播放电影的过程。跑通之后如果发现新版本游戏缺密钥不妨把密钥提交回项目想深入原理doc/目录下的 MKV 格式规范说明和源码里的解包模块都是很好的学习材料。命令行工具的乐趣往往就在第一次亲手打开箱子的那一刻。【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考