Wallpaper Engine 资源打不开？repkg 解包转换终极指南：一行命令提取 PKG、TEX 转 PNG

Wallpaper Engine 资源打不开？repkg 解包转换终极指南：一行命令提取 PKG、TEX 转 PNG

【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg

从创意工坊下载的壁纸，明明是个压缩包，后缀却是.pkg、.tex，双击没反应，拖进 Photoshop 也不认。想拆开看看里面的素材，手上却一把趁手的工具都没有。别急着放弃，开源工具repkg就是专门解决这个问题的：它能把 Wallpaper Engine 的 PKG 资源包完整解开，还能把加密的 TEX 贴图直接转成 PNG 图片，全程只需在终端敲一行命令。

从"打不开"说起：.pkg 和 .tex 到底是什么

先说结论：它们不是坏文件，只是被"打包"了。

一个 Wallpaper Engine 壁纸工程，通常包含模型、脚本、配置文件，以及若干张纹理贴图。这些内容被封装进.pkg文件——你可以把它理解成一个快递箱，箱子外面贴着运单，里面塞着各种杂物。而其中的贴图，又被单独套进了.tex这种密封袋里，袋口还上了特殊的封条。

普通用户能看到的只有快递箱和密封袋，看不到里面。repkg 干的事就是两件：

• 拆箱：把.pkg里所有条目原样提取出来，包括原始字节。
• 冲印：撕开.tex密封袋，把里面的照片洗成 PNG、GIF 等通用格式，直接能看、能用。

整个过程不需要任何编程基础，你要做的只是学会敲几条命令。

repkg 快速上手：从下载到第一次成功解包

第一步：把工具拿到手

打开终端，执行：

git clone https://gitcode.com/gh_mirrors/re/repkg

git clone会把整个项目源码下载到你当前目录。完成后你会看到一个repkg文件夹。

第二步：编译一次，生成可执行文件

cd repkg dotnet build RePKG.sln -c Release

• dotnet build是 .NET 官方的编译命令，-c Release表示生成优化过的正式版本。
• 编译成功后，可执行文件repkg会出现在RePKG/bin/Release/目录下，把它加入系统 PATH 或用完整路径调用都行。

⚠️ 前提条件：编译需要先安装 .NET SDK；在 Windows 上运行还需要 .NET Framework 4.7.2 或更高版本。去微软官网下载安装即可，一路"下一步"就能装好。

第三步：跑出第一个成果

repkg extract 你的壁纸.pkg -o ./output

• extract是提取子命令，后面紧跟要处理的.pkg文件路径。
• -o ./output指定结果保存到当前目录下的output文件夹（不写则默认存到当前目录）。

期望输出：

### Extracting package: 你的壁纸.pkg * Extracting: materials/textures/背景.png * Extracting: materials/textures/人物.tex * Reading: materials/textures/人物.tex Done

看到Done，就说明解包完成了。打开output文件夹：里面既有原始文件，也有自动转换好的 PNG 图片，每个 TEX 旁边还会多出一份.tex-json信息文件，记录着尺寸、格式等元数据。

按你的身份选玩法：三类人群的实用命令组合

工具已经跑通，接下来不用背参数表，按下面的身份对号入座即可。

普通玩家：只想挑出贴图，别的一概不要

问题：一个包里有二十来个文件，模型、脚本、音频混在一起，我只想要里面的图片素材。

办法：用-e参数限定只提取指定扩展名的条目，多个扩展名用英文逗号分隔：

repkg extract 壁纸.pkg -e "tex,png" -o ./textures

想反过来"除了这些都不要"，用-i参数，比如-i "mp3,json"。

结果：textures文件夹里只剩贴图相关文件，清爽利落，其余条目一概不碰。

收藏家：上百个壁纸包，想一次全解

问题：本地囤了一整个创意工坊目录，几百个.pkg手动一个个解，手会断。

办法：-r开启递归搜索，让它自动扫遍所有子文件夹；再加-c把每个壁纸旁边的project.json和预览图一并复制出来：

repkg extract -r -c ./wallpapers -o ./all_projects

结果：all_projects下按壁纸 ID 自动分好文件夹，每个都带着配置文件和预览图，等于一份份完整的、可直接重新导入 Wallpaper Engine 的壁纸工程。

设计人员：手里只有一堆 TEX，批量转 PNG 做素材

问题：没有.pkg包，只有别人给的几十个.tex文件，想全部转成 PNG 放进设计稿。

办法：-t告诉工具"这个目录里全是 TEX，请都转成图片"；-s让所有结果平铺在同一个输出目录，不保留子目录层级：

repkg extract -t -s ./tex_files -o ./png_output

结果：png_output里是一张张能直接用的 PNG，旁边配有.tex-json元数据。如果转换时提示文件已存在，追加--overwrite即可强制覆盖旧文件。

💡 冷知识：运行repkg interactive可以进入交互模式，之后逐行输入extract、info命令，适合边摸索边试参数。

动手前先"体检"：看看包里到底有什么

问题：不确定某个包有多大、装了什么，想先看清单再决定要不要解。

办法：用info命令做个体检：

repkg info 壁纸.pkg -e -s

• -e打印包内所有条目清单；
• -s让条目按名称排序；想按大小排序，追加-b size；
• 想查看壁纸标题等工程信息，追加-p "*"打印project.json的全部字段。

结果：终端里列出每个文件的完整路径和字节数，包内结构一目了然，还能顺手筛出"最大的那个贴图"是谁。

新手最常踩的四个坑：报错原因与修复命令

⚠️ 路径含空格时，记得给路径加上英文引号，例如repkg extract "我的 壁纸.pkg"，否则命令会被拆散。

从会用走向会玩：读源码与自动化流水线

工具用顺了，想更进一步？有两条路可以走。

一是读源码。项目按RePKG.Core（核心数据模型）、RePKG.Application（读写与转换逻辑）、RePKG（命令行界面）三层组织，从RePKG/Program.cs读起，就能看清一条命令从输入到输出的完整旅程。RePKG/Command/Extract.cs里的参数定义、RePKG.Application/Texture/TexToImageConverter.cs里的转图逻辑，都是很好的学习样本。

二是写脚本。把上面的批量解包和批量转图组合进一个 shell 脚本，就能搭出自己的处理流水线：

#!/bin/bash repkg extract -r -c ./downloads -o ./projects repkg extract -t -s ./projects -o ./png_all echo "解包转图完成，共 $(find ./png_all -name '*.png' | wc -l) 张图片"

"下载壁纸 → 自动解包 → 自动转图 → 统计报告"一气呵成，收藏夹再大也不怕。

写在最后：用好工具，也要守好边界

repkg 的价值，是让你能真正理解和使用自己拥有的资源。但请记住：提取素材仅限合法创作，务必尊重原作者版权。开源精神从来不是"随便拿"，而是"共享、学习、回馈"。用的时候发现 bug，欢迎向作者反馈；写出了好用的脚本，也请分享出来——这正是开源工具越变越好的方式。祝你拆包顺利，创作自由！

【免费下载链接】repkgWallpaper engine PKG extractor/TEX to image converter项目地址: https://gitcode.com/gh_mirrors/re/repkg