原神USM过场动画提取与解密指南一条命令把加密视频转换为可播放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。从一堆打不开的 .usm 说起如果你玩过《原神》应该知道它的过场动画质量相当高从角色传说任务到主线剧情很多片段都值得收藏。但这些动画被封装在 Criware 的专有容器 USM 里视频轨加密、音频轨还是 HCA 加密格式普通软件根本无法直接读取。想手动拆解你得先搞懂容器结构、密钥算法、音频解码……门槛高得足以劝退绝大多数人。没有它之前收藏过场动画要过五关斩六将在遇到 GI-cutscenes 之前我试过不少路子用录屏软件边播边录画质损失大、还容易录进 UI去视频网站找搬运分辨率被压、字幕被水印盖住、想找多语言版本更是奢望甚至尝试过手动分析十六进制数据坚持了十分钟就放弃了。有了 GI-cutscenes 之后整个流程变成了一句话它负责解密、提取、转换、合并你只负责挑选想看的片段。为什么推荐它而不是别的方案三个理由足够有说服力覆盖广支持 1.0 到 6.3 版本的全部过场动画含 CBT3 测试版只要游戏更新密钥社区就会跟进。零依赖从 0.4.0 版本起内置了 MKV 合并引擎不装任何额外软件也能产出成品当然你想用 mkvmerge 或 FFMPEG 也完全支持。字幕贴心自动把游戏数据里的 SRT 字幕转成 ASS 格式样式风格与游戏内几乎一致还支持多语言。最短路径一条命令把 USM 变成 MKV先别急着研究各种参数我们走一遍最短路径让你五分钟内看到成果。首先获取程序git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes cd GI-cutscenes项目基于 .NET 6.0如果你不想自己编译直接下载对应平台Windows / Linux / macOS的预编译包解压即可里面有自包含版本连 .NET 运行时都不用装。拿到程序后找到游戏目录里的过场文件通常在GenshinImpact_Data\StreamingAssets\VideoAssets\StandaloneWindows64下挑一个执行GICutscenes demuxUsm Cs_200919_SHG_Boy.usm --output ./output --merge --subs命令运行后会先打印Finding encryption key for ...自动从versions.json匹配密钥随后解出视频轨和音频轨、把 HCA 转成 WAV、合并出 MKV。预期输出output文件夹里出现一个Cs_200919_SHG_Boy.mkv双击即可播放。如果字幕和字体文件准备好了连字幕都一并烧进去。我第一次跑这条命令时其实踩了个小坑以为加了--merge就会自动带字幕结果 MKV 里只有画面没有字幕。后来才反应过来字幕要显式加--subs才会处理。记住这个组合--merge管合并、--subs管字幕。逐个击破三个命令吃透提取流程工具的核心命令只有三个学会它们基本就毕业了。目的先看懂有哪些牌可打GICutscenes -h预期输出列出全部子命令demuxUsm、batchDemux、convertHca、update、reset以及它们的参数说明。花两分钟扫一遍比看十篇教程都管用。目的单文件精确提取demuxUsm是使用频率最高的命令负责把单个 USM 文件拆解并可选合并GICutscenes demuxUsm story_cutscene.usm --output ./raw_materials预期输出raw_materials目录下出现一个.ivf视频文件VP9 编码和若干_0.hca、_1.hca音频文件。IVF 是中间格式直接用 VLC 就能预览。想一步到位直接看成品加上--merge就好。不想让中间文件被自动清理加--no-cleanup方便后续手动调试。目的整个文件夹批量打包如果你的目标是全量收藏一个个处理就太慢了batchDemux会把目录里所有 USM 一次扫完GICutscenes batchDemux VideoAssets/StandaloneWindows64 --output ./collection --merge --subs预期输出每个过场对应一个 MKV批量处理期间会打印每个文件的处理进度。等它跑完你的收藏夹就成型了。目的单独转换 HCA 音频有时候你只想提取某段 BGM 或语音不需要整个视频。convertHca可以把 HCA 直接转成 WAVGICutscenes convertHca audio_0.hca预期输出同目录下生成audio_0.wav用任意音频播放器都能打开。音频解码是多线程的批量转换时速度很可观。目的把字幕素材准备好想用上--subs得先让工具认识字幕。字幕来自游戏数据的开源镜像仓库克隆时用稀疏检出只拉字幕部分git clone --depth 1 --filterblob:none --sparse [字幕仓库URL] cd GenshinData git sparse-checkout set Subtitle把GenshinData文件夹放到工具目录下确保路径与 appsettings.json 中的SubsFolder默认./GenshinData/Subtitle一致。字体文件则从游戏安装目录的StreamingAssets\MiHoYoSDKRes\HttpServerResources\font里复制ja-jp.ttf和zh-cn.ttf到工具目录——这两个文件会被自动作为附件嵌入 MKV字幕样式才能与游戏内一致。进阶玩法多语言、换引擎、追新版本基础命令熟练之后下面这几个特性才是拉开差距的地方。多语言音轨与字幕一部动画多种打开方式想对比中日英韩配音--audio-lang参数可以指定保留哪些语言音轨默认是chi,eng,jpn,kor全保留GICutscenes demuxUsm story.usm --merge --subs --audio-lang jpn,eng预期输出MKV 里只有日语和英语两条音轨播放器里可以随时切换。字幕同理工具会自动扫描GenshinData/Subtitle下各语言目录把匹配的字幕全部转成 ASS 塞进 MKV——这正是它比网上搬运版强的地方字幕样式还原游戏内效果而不是粗糙的硬字幕。三种合并引擎自由切换从 0.4.0 起内置了合并引擎代码在src/Mergers/GIMKV/一个完整的 MKV 容器构建实现默认就用它GICutscenes demuxUsm file.usm --merge --mkv-engine internal如果你装了 MKVToolNix 或 FFMPEG也可以换引擎GICutscenes demuxUsm file.usm --merge --mkv-engine mkvmerge想顺便转码指定--audio-format或--video-format如aac、h264后工具会自动切换到 FFMPEG 引擎完成转码合并。注意走这条路的前提是你装了 FFMPEG否则会直接报错。新版本密钥一条命令跟上节奏每次游戏大版本更新新过场的解密密钥会先由社区提交再合并进versions.json。如果你手上的版本落后了直接运行GICutscenes update这个命令会拉取最新的versions.json并检查工具本体是否有新版有更新时还会自动打开浏览器跳转下载页不想它开浏览器就加--no-browser走代理就加--proxy http://ip:port。如果发现某个文件还是提示密钥缺失多半是密钥尚未公开可以去项目的 Pull Requests 里蹲守通常很快就有热心人提交。避坑速查卡五个高频问题一次说清遇到问题时对照下面这张速查卡比瞎试参数高效得多症状原因与解法提示Unable to find the second key in versions.json该过场的解密密钥还没收录运行GICutscenes update更新versions.json或手动替换成仓库最新版合并出的 MKV 没有字幕忘记加--subs或SubsFolder路径不对确认GenshinData/Subtitle下按语言分了子目录字幕显示成方框乱码工具目录缺少ja-jp.ttf/zh-cn.ttf字体文件从游戏目录复制过来文件名保持一致指定了--audio-format却报错引擎被自动切换为 ffmpeg但你的系统没装 FFMPEG安装后重试或去掉转码参数输出目录里找不到 WAV / IVF合并后中间文件被默认清理了想保留就加--no-cleanup另外两点容易被误判的异常个别过场比如天气变化演示本来就没有字幕工具会跳过属正常现象字幕偶尔与音频不同步这是游戏原文件就存在的问题不是工具的锅——README 里作者专门解释过这一点。组合拳GI-cutscenes 与周边工具的协作姿势单一工具解决单一问题组合起来才能发挥最大价值VLC 预览中间产物提取出的.ivf文件VP9 编码VLC 直接能播改后缀为.m2v也行适合在正式合并前快速确认内容。MKVToolNix 兜底内置引擎搞不定的特殊情况mkvmerge可以手动封包、重新混流。FFMPEG 扩展玩法需要转 H.264 方便手机播放、或提取单条音轨做素材交给它准没错。Aegisub 微调字幕想改 ASS 字幕的字号、颜色、位置用 Aegisub 打开Subs目录下的文件调整样式参数也可以直接改 appsettings.json 里的SubsStyleSubStation Alpha 格式的样式字符串。Plex / Jellyfin 入库批量提取完成后把 MKV 丢进媒体服务器就能像看剧集一样管理全部过场动画。如果你对 MKV 容器的内部结构感兴趣项目自带的 doc/mkv spec.txt 是一份不错的参考资料想深入源码从 src/FileTypes/USM.cs容器解析和 src/FileTypes/HCA.cs音频解密读起即可代码组织得很清晰。最后一步动手跑通你的第一段过场回到开头的场景那些曾经只能望文件兴叹的.usm现在离可播放的 MKV 只差一条命令的距离。先把工具克隆下来、复制好字体文件、准备好字幕目录然后挑一段你最想收藏的过场动画试试手——当成品 MKV 在播放器里带着原汁原味的字幕亮起来的那一刻你会觉得之前的所有折腾都值了。git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes最后提醒一句这些工具和素材请用于个人收藏与学习交流不要用于商业分发也请遵守游戏的使用条款。技术让好内容触手可及合理使用才能让它走得更远。现在就动手吧你的过场动画收藏之旅从第一条命令开始。【免费下载链接】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过场动画提取与解密指南一条命令把加密视频转换为可播放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。从一堆打不开的 .usm 说起如果你玩过《原神》应该知道它的过场动画质量相当高从角色传说任务到主线剧情很多片段都值得收藏。但这些动画被封装在 Criware 的专有容器 USM 里视频轨加密、音频轨还是 HCA 加密格式普通软件根本无法直接读取。想手动拆解你得先搞懂容器结构、密钥算法、音频解码……门槛高得足以劝退绝大多数人。没有它之前收藏过场动画要过五关斩六将在遇到 GI-cutscenes 之前我试过不少路子用录屏软件边播边录画质损失大、还容易录进 UI去视频网站找搬运分辨率被压、字幕被水印盖住、想找多语言版本更是奢望甚至尝试过手动分析十六进制数据坚持了十分钟就放弃了。有了 GI-cutscenes 之后整个流程变成了一句话它负责解密、提取、转换、合并你只负责挑选想看的片段。为什么推荐它而不是别的方案三个理由足够有说服力覆盖广支持 1.0 到 6.3 版本的全部过场动画含 CBT3 测试版只要游戏更新密钥社区就会跟进。零依赖从 0.4.0 版本起内置了 MKV 合并引擎不装任何额外软件也能产出成品当然你想用 mkvmerge 或 FFMPEG 也完全支持。字幕贴心自动把游戏数据里的 SRT 字幕转成 ASS 格式样式风格与游戏内几乎一致还支持多语言。最短路径一条命令把 USM 变成 MKV先别急着研究各种参数我们走一遍最短路径让你五分钟内看到成果。首先获取程序git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes cd GI-cutscenes项目基于 .NET 6.0如果你不想自己编译直接下载对应平台Windows / Linux / macOS的预编译包解压即可里面有自包含版本连 .NET 运行时都不用装。拿到程序后找到游戏目录里的过场文件通常在GenshinImpact_Data\StreamingAssets\VideoAssets\StandaloneWindows64下挑一个执行GICutscenes demuxUsm Cs_200919_SHG_Boy.usm --output ./output --merge --subs命令运行后会先打印Finding encryption key for ...自动从versions.json匹配密钥随后解出视频轨和音频轨、把 HCA 转成 WAV、合并出 MKV。预期输出output文件夹里出现一个Cs_200919_SHG_Boy.mkv双击即可播放。如果字幕和字体文件准备好了连字幕都一并烧进去。我第一次跑这条命令时其实踩了个小坑以为加了--merge就会自动带字幕结果 MKV 里只有画面没有字幕。后来才反应过来字幕要显式加--subs才会处理。记住这个组合--merge管合并、--subs管字幕。逐个击破三个命令吃透提取流程工具的核心命令只有三个学会它们基本就毕业了。目的先看懂有哪些牌可打GICutscenes -h预期输出列出全部子命令demuxUsm、batchDemux、convertHca、update、reset以及它们的参数说明。花两分钟扫一遍比看十篇教程都管用。目的单文件精确提取demuxUsm是使用频率最高的命令负责把单个 USM 文件拆解并可选合并GICutscenes demuxUsm story_cutscene.usm --output ./raw_materials预期输出raw_materials目录下出现一个.ivf视频文件VP9 编码和若干_0.hca、_1.hca音频文件。IVF 是中间格式直接用 VLC 就能预览。想一步到位直接看成品加上--merge就好。不想让中间文件被自动清理加--no-cleanup方便后续手动调试。目的整个文件夹批量打包如果你的目标是全量收藏一个个处理就太慢了batchDemux会把目录里所有 USM 一次扫完GICutscenes batchDemux VideoAssets/StandaloneWindows64 --output ./collection --merge --subs预期输出每个过场对应一个 MKV批量处理期间会打印每个文件的处理进度。等它跑完你的收藏夹就成型了。目的单独转换 HCA 音频有时候你只想提取某段 BGM 或语音不需要整个视频。convertHca可以把 HCA 直接转成 WAVGICutscenes convertHca audio_0.hca预期输出同目录下生成audio_0.wav用任意音频播放器都能打开。音频解码是多线程的批量转换时速度很可观。目的把字幕素材准备好想用上--subs得先让工具认识字幕。字幕来自游戏数据的开源镜像仓库克隆时用稀疏检出只拉字幕部分git clone --depth 1 --filterblob:none --sparse [字幕仓库URL] cd GenshinData git sparse-checkout set Subtitle把GenshinData文件夹放到工具目录下确保路径与 appsettings.json 中的SubsFolder默认./GenshinData/Subtitle一致。字体文件则从游戏安装目录的StreamingAssets\MiHoYoSDKRes\HttpServerResources\font里复制ja-jp.ttf和zh-cn.ttf到工具目录——这两个文件会被自动作为附件嵌入 MKV字幕样式才能与游戏内一致。进阶玩法多语言、换引擎、追新版本基础命令熟练之后下面这几个特性才是拉开差距的地方。多语言音轨与字幕一部动画多种打开方式想对比中日英韩配音--audio-lang参数可以指定保留哪些语言音轨默认是chi,eng,jpn,kor全保留GICutscenes demuxUsm story.usm --merge --subs --audio-lang jpn,eng预期输出MKV 里只有日语和英语两条音轨播放器里可以随时切换。字幕同理工具会自动扫描GenshinData/Subtitle下各语言目录把匹配的字幕全部转成 ASS 塞进 MKV——这正是它比网上搬运版强的地方字幕样式还原游戏内效果而不是粗糙的硬字幕。三种合并引擎自由切换从 0.4.0 起内置了合并引擎代码在src/Mergers/GIMKV/一个完整的 MKV 容器构建实现默认就用它GICutscenes demuxUsm file.usm --merge --mkv-engine internal如果你装了 MKVToolNix 或 FFMPEG也可以换引擎GICutscenes demuxUsm file.usm --merge --mkv-engine mkvmerge想顺便转码指定--audio-format或--video-format如aac、h264后工具会自动切换到 FFMPEG 引擎完成转码合并。注意走这条路的前提是你装了 FFMPEG否则会直接报错。新版本密钥一条命令跟上节奏每次游戏大版本更新新过场的解密密钥会先由社区提交再合并进versions.json。如果你手上的版本落后了直接运行GICutscenes update这个命令会拉取最新的versions.json并检查工具本体是否有新版有更新时还会自动打开浏览器跳转下载页不想它开浏览器就加--no-browser走代理就加--proxy http://ip:port。如果发现某个文件还是提示密钥缺失多半是密钥尚未公开可以去项目的 Pull Requests 里蹲守通常很快就有热心人提交。避坑速查卡五个高频问题一次说清遇到问题时对照下面这张速查卡比瞎试参数高效得多症状原因与解法提示Unable to find the second key in versions.json该过场的解密密钥还没收录运行GICutscenes update更新versions.json或手动替换成仓库最新版合并出的 MKV 没有字幕忘记加--subs或SubsFolder路径不对确认GenshinData/Subtitle下按语言分了子目录字幕显示成方框乱码工具目录缺少ja-jp.ttf/zh-cn.ttf字体文件从游戏目录复制过来文件名保持一致指定了--audio-format却报错引擎被自动切换为 ffmpeg但你的系统没装 FFMPEG安装后重试或去掉转码参数输出目录里找不到 WAV / IVF合并后中间文件被默认清理了想保留就加--no-cleanup另外两点容易被误判的异常个别过场比如天气变化演示本来就没有字幕工具会跳过属正常现象字幕偶尔与音频不同步这是游戏原文件就存在的问题不是工具的锅——README 里作者专门解释过这一点。组合拳GI-cutscenes 与周边工具的协作姿势单一工具解决单一问题组合起来才能发挥最大价值VLC 预览中间产物提取出的.ivf文件VP9 编码VLC 直接能播改后缀为.m2v也行适合在正式合并前快速确认内容。MKVToolNix 兜底内置引擎搞不定的特殊情况mkvmerge可以手动封包、重新混流。FFMPEG 扩展玩法需要转 H.264 方便手机播放、或提取单条音轨做素材交给它准没错。Aegisub 微调字幕想改 ASS 字幕的字号、颜色、位置用 Aegisub 打开Subs目录下的文件调整样式参数也可以直接改 appsettings.json 里的SubsStyleSubStation Alpha 格式的样式字符串。Plex / Jellyfin 入库批量提取完成后把 MKV 丢进媒体服务器就能像看剧集一样管理全部过场动画。如果你对 MKV 容器的内部结构感兴趣项目自带的 doc/mkv spec.txt 是一份不错的参考资料想深入源码从 src/FileTypes/USM.cs容器解析和 src/FileTypes/HCA.cs音频解密读起即可代码组织得很清晰。最后一步动手跑通你的第一段过场回到开头的场景那些曾经只能望文件兴叹的.usm现在离可播放的 MKV 只差一条命令的距离。先把工具克隆下来、复制好字体文件、准备好字幕目录然后挑一段你最想收藏的过场动画试试手——当成品 MKV 在播放器里带着原汁原味的字幕亮起来的那一刻你会觉得之前的所有折腾都值了。git clone https://gitcode.com/gh_mirrors/gi/GI-cutscenes最后提醒一句这些工具和素材请用于个人收藏与学习交流不要用于商业分发也请遵守游戏的使用条款。技术让好内容触手可及合理使用才能让它走得更远。现在就动手吧你的过场动画收藏之旅从第一条命令开始。【免费下载链接】GI-cutscenesA command line program playing with the cutscenes files (USM) from Genshin Impact.项目地址: https://gitcode.com/gh_mirrors/gi/GI-cutscenes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
