别再手动改后缀了一行命令搞定原神 USM 过场动画提取【免费下载链接】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 影片——适合所有想收藏、剪辑原神动画的玩家和技术爱好者。一、从差点删库到真香一个收藏党的自救说实话我第一次尝试提取过场动画时差点原地放弃。打开游戏目录找到VideoAssets里面躺着几十个.usm文件拖进播放器打不开改成.mp4后缀花屏加无声。后来才弄明白USM 是 CRIWARE 的私有容器格式里面的视频是加密的 VP9音频是加密的 HCA——等于游戏把打包箱焊死了还上了两道锁。光靠改名显然不行直到朋友甩给我 GI-cutscenes 这个开源小工具我才意识到原来不是我的问题是我缺一把对的钥匙。二、第一印象一把拆箱、换料、重新装箱的瑞士军刀 如果把 USM 比作一封死的打包箱GI-cutscenes 干的事就是三步拆箱解密容器、把里面的东西换成通用规格HCA 音频解密转换、视频提取为 IVF 格式、再重新装箱成 MKV——一份能像小电影一样播放、字幕样式和游戏里几乎一致的文件也就是一次完整的 USM 转 MKV 流程。它暴露给用户的入口只有三个命令很好记demuxUsm处理单个 USM 文件batchDemux批量处理整个文件夹convertHca单独把 HCA 转成 WAV覆盖范围也很硬核从 1.0 到 6.3 版本的过场动画都能解密连 CBT3 内测资源都包含在内。三、三分钟跑通第一次提取第一次运行别慌就三步。第一步拿到工具。想从源码编译可以克隆仓库想省事就直接下载对应平台的 release 包Windows、Linux、macOS 都有还区分了自带运行时的独立版和需要 .NET 6 的轻量版。git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes第二步准备字幕和字体可选但强烈建议。字幕来自游戏数据仓库放到工具目录的GenshinData/Subtitle下字体则从游戏安装目录的HttpServerResources\font里拷出两个 TTF千万别重命名否则字幕样式会对不上。第三步跑人生第一条命令。GICutscenes demuxUsm cs_xxx.usm --output ./output --merge --subs人话翻译demuxUsm解析并解密这个 USM 文件--output指定输出目录--merge把音视频和字幕合并成 MKV--subs把字幕一起装进去。跑完去output目录一份能拖进任何播放器的过场动画就到手了。原神 USM 过场动画提取MKV 成片在播放器中播放图片占位建议放一张最终 MKV 在播放器如 VLC中播放的截图重点展示与游戏内一致的字幕样式。四、把它玩出花三个藏起来的实用技巧 说完了上手接下来聊聊它真正厉害的地方。技巧一原神过场动画批量提取 保留中间文件。想一口气把整个VideoAssets目录搬空用batchDemux加上--no-cleanup会保留合并前的原始提取物方便以后单独拿视频或音频做二次创作。GICutscenes batchDemux VideoAssets/StandaloneWindows64 --output ./output --merge --subs --no-cleanup技巧二多语言音轨一次配齐。--audio-lang jpn,eng,chi,kor可以按需挑选想保留的语言轨道做多语言对比学习或者剪双语字幕都很好用。技巧三三套合并引擎随你换。从 0.4.0 版本起内置了合并引擎不装任何外部软件也能出 MKV但你也可以指定--mkv-engine mkvmerge或--mkv-engine ffmpeg想自定义编码格式时甚至能直接--audio-format aac --video-format h264走 FFmpeg 路线。GI-cutscenes 批量提取原神过场动画的控制台输出图片占位建议放一张batchDemux批量处理时控制台逐文件进度的截图。五、翻车现场与急救方案别问我是怎么知道的 症状一提示缺少解密密钥。新版本游戏发布后本地versions.json可能还没有对应密钥。先跑GICutscenes update拉取最新密钥如果还是没有可以自己去仓库的 Pull Requests 里翻翻社区同学通常早就提交了。症状二字幕和音频不同步。先别急着砸键盘——README 里写得很直白有些字幕在原作里就是不同步的锅不在这个工具。对不上的时候可以对比一下游戏内的原始表现再决定要不要手动偏移。症状三字幕变方框或乱码。九成是字体没放对。确认两个 TTF 已经拷进工具目录且文件名与游戏原始文件名一致再看一眼appsettings.json里的SubsStyle配置。实在搞不定加个--stack-trace把完整报错信息亮出来去 Issue 区提问时带上它能省掉一大轮来回。六、藏在代码里的设计心思这个项目的出身很有意思作者一年前先用 Python 写了个概念验证后来为了练手 C#又把它完整重写了一遍。所以代码组织带着很典型的结构清晰气质——src/FileTypes/专门放格式解析USM、HCA、MKV、ASS 各一文件src/Mergers/GIMKV/是内置的 MKV 合并器密钥则统一维护在versions.json里。我最欣赏的一点是它把不依赖外部工具这件事做到了底。内置合并引擎意味着你只需要这一个可执行文件就能走完解密到封装的全流程想更深入理解 MKV 结构仓库里还自带一份doc/mkv spec.txt规范笔记对格式爱好者来说简直是现成的教材。GI-cutscenes 内置 MKV 合并引擎的源码目录结构图片占位建议放一张src/Mergers/GIMKV目录结构截图展示内置合并器的模块划分。七、它值得被更多人看见也包括你 项目路线图上还挂着 GUI、更多输出格式、云处理这些待办但眼下最有价值的参与方式是帮它维护版本密钥——每次新版本更新社区里总有人第一时间把密钥提上来这大概就是开源项目最让人舒服的地方你不只是使用者也可以成为让工具变强的其中一环。如果你手头正好有一堆.usm现在就克隆下来跑一条命令试试把那些高光时刻从游戏目录里搬进自己的收藏夹吧。工具的价值终究取决于你怎样使用它——请遵守游戏条款合理合规地使用提取内容。【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 别再手动改后缀了：一行命令搞定原神 USM 过场动画提取
别再手动改后缀了一行命令搞定原神 USM 过场动画提取【免费下载链接】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 影片——适合所有想收藏、剪辑原神动画的玩家和技术爱好者。一、从差点删库到真香一个收藏党的自救说实话我第一次尝试提取过场动画时差点原地放弃。打开游戏目录找到VideoAssets里面躺着几十个.usm文件拖进播放器打不开改成.mp4后缀花屏加无声。后来才弄明白USM 是 CRIWARE 的私有容器格式里面的视频是加密的 VP9音频是加密的 HCA——等于游戏把打包箱焊死了还上了两道锁。光靠改名显然不行直到朋友甩给我 GI-cutscenes 这个开源小工具我才意识到原来不是我的问题是我缺一把对的钥匙。二、第一印象一把拆箱、换料、重新装箱的瑞士军刀 如果把 USM 比作一封死的打包箱GI-cutscenes 干的事就是三步拆箱解密容器、把里面的东西换成通用规格HCA 音频解密转换、视频提取为 IVF 格式、再重新装箱成 MKV——一份能像小电影一样播放、字幕样式和游戏里几乎一致的文件也就是一次完整的 USM 转 MKV 流程。它暴露给用户的入口只有三个命令很好记demuxUsm处理单个 USM 文件batchDemux批量处理整个文件夹convertHca单独把 HCA 转成 WAV覆盖范围也很硬核从 1.0 到 6.3 版本的过场动画都能解密连 CBT3 内测资源都包含在内。三、三分钟跑通第一次提取第一次运行别慌就三步。第一步拿到工具。想从源码编译可以克隆仓库想省事就直接下载对应平台的 release 包Windows、Linux、macOS 都有还区分了自带运行时的独立版和需要 .NET 6 的轻量版。git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes第二步准备字幕和字体可选但强烈建议。字幕来自游戏数据仓库放到工具目录的GenshinData/Subtitle下字体则从游戏安装目录的HttpServerResources\font里拷出两个 TTF千万别重命名否则字幕样式会对不上。第三步跑人生第一条命令。GICutscenes demuxUsm cs_xxx.usm --output ./output --merge --subs人话翻译demuxUsm解析并解密这个 USM 文件--output指定输出目录--merge把音视频和字幕合并成 MKV--subs把字幕一起装进去。跑完去output目录一份能拖进任何播放器的过场动画就到手了。原神 USM 过场动画提取MKV 成片在播放器中播放图片占位建议放一张最终 MKV 在播放器如 VLC中播放的截图重点展示与游戏内一致的字幕样式。四、把它玩出花三个藏起来的实用技巧 说完了上手接下来聊聊它真正厉害的地方。技巧一原神过场动画批量提取 保留中间文件。想一口气把整个VideoAssets目录搬空用batchDemux加上--no-cleanup会保留合并前的原始提取物方便以后单独拿视频或音频做二次创作。GICutscenes batchDemux VideoAssets/StandaloneWindows64 --output ./output --merge --subs --no-cleanup技巧二多语言音轨一次配齐。--audio-lang jpn,eng,chi,kor可以按需挑选想保留的语言轨道做多语言对比学习或者剪双语字幕都很好用。技巧三三套合并引擎随你换。从 0.4.0 版本起内置了合并引擎不装任何外部软件也能出 MKV但你也可以指定--mkv-engine mkvmerge或--mkv-engine ffmpeg想自定义编码格式时甚至能直接--audio-format aac --video-format h264走 FFmpeg 路线。GI-cutscenes 批量提取原神过场动画的控制台输出图片占位建议放一张batchDemux批量处理时控制台逐文件进度的截图。五、翻车现场与急救方案别问我是怎么知道的 症状一提示缺少解密密钥。新版本游戏发布后本地versions.json可能还没有对应密钥。先跑GICutscenes update拉取最新密钥如果还是没有可以自己去仓库的 Pull Requests 里翻翻社区同学通常早就提交了。症状二字幕和音频不同步。先别急着砸键盘——README 里写得很直白有些字幕在原作里就是不同步的锅不在这个工具。对不上的时候可以对比一下游戏内的原始表现再决定要不要手动偏移。症状三字幕变方框或乱码。九成是字体没放对。确认两个 TTF 已经拷进工具目录且文件名与游戏原始文件名一致再看一眼appsettings.json里的SubsStyle配置。实在搞不定加个--stack-trace把完整报错信息亮出来去 Issue 区提问时带上它能省掉一大轮来回。六、藏在代码里的设计心思这个项目的出身很有意思作者一年前先用 Python 写了个概念验证后来为了练手 C#又把它完整重写了一遍。所以代码组织带着很典型的结构清晰气质——src/FileTypes/专门放格式解析USM、HCA、MKV、ASS 各一文件src/Mergers/GIMKV/是内置的 MKV 合并器密钥则统一维护在versions.json里。我最欣赏的一点是它把不依赖外部工具这件事做到了底。内置合并引擎意味着你只需要这一个可执行文件就能走完解密到封装的全流程想更深入理解 MKV 结构仓库里还自带一份doc/mkv spec.txt规范笔记对格式爱好者来说简直是现成的教材。GI-cutscenes 内置 MKV 合并引擎的源码目录结构图片占位建议放一张src/Mergers/GIMKV目录结构截图展示内置合并器的模块划分。七、它值得被更多人看见也包括你 项目路线图上还挂着 GUI、更多输出格式、云处理这些待办但眼下最有价值的参与方式是帮它维护版本密钥——每次新版本更新社区里总有人第一时间把密钥提上来这大概就是开源项目最让人舒服的地方你不只是使用者也可以成为让工具变强的其中一环。如果你手头正好有一堆.usm现在就克隆下来跑一条命令试试把那些高光时刻从游戏目录里搬进自己的收藏夹吧。工具的价值终究取决于你怎样使用它——请遵守游戏条款合理合规地使用提取内容。【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考