原神USM过场动画提取实战清单从解密到MKV的完整攻略【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenesGI-cutscenes 是一款专为原神USM过场动画提取而生的开源命令行工具它能将游戏目录中加密的 USM 动画文件解密、拆分出视频与音频轨道把 HCA 音频自动转成通用 WAV 格式再连同游戏内字幕一起封装成标准 MKV 影片。全程只需几条命令无需昂贵的视频剪辑软件也无需手动处理一堆中间文件。本文采用任务清单的形式组织每一步都对应一个可直接复制的命令跟着打勾做完你就能拥有一个随开随看的原神过场动画私人影库。无论你是想收藏名场面、做多语言对比学习还是给视频创作积累素材这份实战攻略都够用。动手之前认识三个关键词 在敲命令之前先花一分钟弄清这三个文件格式后面才不会懵格式全称通俗理解USMCRI 通用媒体容器游戏里过场动画的打包箱视频和音频都装在里面且经过加密HCACRI 音频编码箱子里装着的加密音频普通播放器无法直接读取MKVMatroska 视频容器一种能把视频、多条音轨、字幕、字体打包成一个文件的万能盒子GI-cutscenes 的工作流可以概括为一条流水线解密 USM → 拆出 VP9 视频与 HCA 音频 → 把 HCA 解码为 WAV → 按需附上 ASS 字幕 → 合并成 MKV。理解了这条线后面每个命令在做什么你一眼就能看懂。☐ 任务一获取工具三分钟就绪工具基于 .NET 6.0 开发。如果你只是想用直接下载对应平台Windows / Linux / macOS的预编译版本即可其中独立版连 .NET 运行时都不用装若你的机器已有 .NET SDK也可以从源码自己编译git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes cd GI-cutscenes dotnet publish -c Release -r linux-x64拿到程序后先运行一句GICutscenes -h看看帮助菜单确认命令、参数与本文一致。见到帮助信息第一个任务就算打勾完成。☐ 任务二配置 appsettings.json一次到位程序根目录下有一个appsettings.json它是全局配置的核心默认内容如下{ Settings: { MkvMergePath: , FfmpegPath: , SubsFolder: ./GenshinData/Subtitle, SubsStyle: Style: Default,{fontname},12,H00FFFFFF,H000000FF,H00000000,H00000000,0,0,0,0,100.0,100.0,0.0,0.0,1,0,0.5,2,10,10,14,1 } }四个配置项的用途分别是MkvMergePathmkvmerge 可执行文件的路径。如果你用默认方式安装了 MKVToolNix留空即可用了绿色便携版则填完整路径。FfmpegPathffmpeg 程序路径。已加入系统 PATH 就留空否则填写二进制文件所在位置。SubsFolder字幕文件夹路径默认指向工具目录下的GenshinData/Subtitle字幕按语言分子目录存放。SubsStyleASS 字幕的样式字符串遵循 SubStation Alpha 规范。想调字号、颜色、位置改这一行就行比如把中间的12改成16就能让字幕变大一号。万一配置改坏了别慌运行GICutscenes reset即可一键恢复默认配置。☐ 任务三准备字幕与字体还原游戏体验想让 MKV 自带和游戏里一模一样的字幕需要两样东西字幕文本和字体文件。字幕文本来自游戏数据仓库只拉取 Subtitle 子目录即可体积很小git clone --depth 1 --filterblob:none --sparse 你的字幕仓库地址 cd GenshinData git sparse-checkout set Subtitle把得到的GenshinData文件夹放在工具目录下正好对应配置里的默认SubsFolder。字体文件需要从游戏安装目录中拷贝路径一般是[游戏目录]\Genshin Impact game\GenshinImpact_Data\StreamingAssets\MiHoYoSDKRes\HttpServerResources\font将里面的两个 TTF 字体文件不改名地复制到工具根目录程序会按ja-jp.ttf与zh-cn.ttf这两个名字寻找并内嵌进 MKV作为字幕附件。没有字体文件也能运行只是字幕可能显示为方块所以建议一步到位。☐ 任务四第一次提取看命令如何生效一切就绪现在对单个过场动画下手。最常用的命令是demuxUsmGICutscenes demuxUsm D:/Genshin/VideoAssets/StandaloneWindows64/Cs_102106_Summon_Boy.usm --output ./output --merge --subs这条命令做了四件事解密并提取视频与音频 → 把 HCA 转成 WAV → 找到匹配的中文字幕并转成 ASS → 全部合并为一个 MKV 文件。执行完output目录里躺着的就是可以双击播放的成片。常用参数速查参数别名作用--output-o指定输出目录默认./output--merge-m提取后合并为 MKV--subs-s合并时附上字幕需先完成任务三--audio-lang-al选择保留的音频语言可选chi,eng,jpn,kor默认四种全要--no-cleanup-nc合并后保留中间的 IVF / WAV 等文件便于调试-a/-b无手动指定解密密钥的低 4 字节与高 4 字节16 进制例如只想保留日文和英文音轨可以写成GICutscenes demuxUsm story.usm -o ./output -m -s -al jpn,eng小提示若某部影片在游戏里本来就有字幕音画不同步的问题那是游戏数据自带的工具并不会额外引入。☐ 任务五批量提取整个文件夹 ️剧情动画动辄几十上百个一个个处理显然不现实。把demuxUsm换成batchDemux把文件路径换成文件夹路径即可GICutscenes batchDemux D:/Genshin/Genshin Impact game/GenshinImpact_Data/StreamingAssets/VideoAssets/StandaloneWindows64 --output ./collection --merge --subs --no-cleanup它会自动遍历文件夹下所有.usm文件逐个解密、合并最后还会打印出总耗时。建议首次批量处理时加上--no-cleanup把中间文件留一段时间方便对照排查问题确认全部成功后再清掉也不迟。☐ 任务六单独转换 HCA 音频 有些场景你只需要音频比如做语音素材、提取背景音乐。convertHca命令支持文件或文件夹两种输入# 转换单个文件 GICutscenes convertHca audio_0.hca # 转换整个目录下的所有 HCA GICutscenes convertHca ./hca_folder --output ./wav_folder转换采用多线程解码速度很快输出为无损 WAV方便后续直接导入剪辑软件或音频工作站。☐ 任务七挑选合并引擎三种方案随你选从 0.4.0 版本起工具内置了完整的 MKV 合并引擎不再依赖任何外部程序。通过--mkv-engine别名-e可以在三种引擎间切换引擎适用场景备注internal开箱即用零依赖默认选项推荐多数用户直接使用mkvmerge已安装 MKVToolNix 的用户老牌 MKV 合并工具兼容性好ffmpeg需要转码、或已有 ffmpeg 环境功能最全代价是需要安装 ffmpeg# 使用内置引擎默认可省略 GICutscenes demuxUsm file.usm -m -e internal # 使用 mkvmerge GICutscenes demuxUsm file.usm -m -e mkvmerge # 使用 ffmpeg GICutscenes demuxUsm file.usm -m -e ffmpeg内置引擎的实现位于src/Mergers/GIMKV/目录包含完整的 MKV 容器元素构建逻辑感兴趣的话可以当作容器格式的入门教材来读项目根目录下的doc/mkv spec.txt则是对照 MKV 规范的参考资料。☐ 任务八自定义编码控制画质与体积默认情况下视频保持游戏原生的 VP9 编码、音频保持 PCM画质无损。但如果你想压缩体积或兼容老设备可以通过--video-format和--audio-format指定编码格式GICutscenes demuxUsm file.usm -m -s -vf h264 -af aac需要注意只要指定了任一格式参数合并引擎就会自动切换为 ffmpeg因为转码只有 ffmpeg 能做。想无损收藏就什么都不加想节省硬盘就转一次 H.264 AAC按需取舍。☐ 任务九密钥更新与版本维护 每个版本的过场动画都有对应的解密密钥这些密钥集中存放在根目录的versions.json中。遇到新版本游戏时密钥可能还没收录此时# 一键拉取最新的密钥文件并检查程序更新 GICutscenes update # 网络受限时指定代理 GICutscenes update --proxy http://proxy.example.com:8080 # 检测到新版本时不自动打开浏览器 GICutscenes update --no-browser日常排查问题时还可以给任意命令加上全局参数--stack-trace让终端打印完整的错误堆栈方便定位原因GICutscenes demuxUsm file.usm --stack-trace 常见问题速查症状原因解决办法提示找不到解密密钥versions.json未收录该影片运行GICutscenes update更新密钥文件字幕显示为方块缺少字体文件把游戏目录下的 TTF 字体复制到工具根目录提示找不到字幕SubsFolder路径不对检查appsettings.json中的配置与目录结构命令报配置错误appsettings.json被改坏执行GICutscenes reset恢复默认部分动画无字幕该动画本身就没有字幕属正常现象可直接跳过 三个实战场景让提取的动画真正用起来个人收藏党用任务五的批量命令把全部剧情动画转成 MKV放进 Jellyfin、Plex 等媒体服务器随时随地在大屏上重温主线剧情。多语言学习者一次提取四种语言的字幕和音轨--audio-lang chi,jpn,eng按需组合配合 Aegisub 微调字幕样式做发音对比练习再合适不过。内容创作者先只提取不合并去掉-m拿到 IVF 视频和 WAV 音频作为素材用 Pr、达芬奇等软件自由剪辑二创想快速出片就保留 MKV 原片直接当素材导入。写在最后你的原神名场面值得被收藏 GI-cutscenes 把解密、提取、转码、合并这一整套原本繁琐的多媒体处理流程压缩成了几条一眼就能看懂的命令。它开源、免费、跨平台从 1.0 到 6.3 版本的过场动画都能处理配合社区持续更新的密钥库新版本动画也能第一时间提取。现在就从任务一出发跑通你的第一条命令吧。收藏夹里那些尘封的 USM 文件很快就能变成随时可播的 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），仅供参考