RePKG：Wallpaper Engine资源处理工具全解析

1. 工具概述

RePKG是一款专为Wallpaper Engine用户设计的开源工具集，采用C#语言开发，提供PKG文件提取与TEX图像转换功能。该工具通过逆向工程解析Wallpaper Engine专用格式，帮助用户轻松管理壁纸资源、提取素材并进行格式转换，适用于壁纸定制、资源分析与二次开发场景。

2. 核心功能模块

2.1 PKG文件处理

2.1.1 文件提取

🔧 痛点解决：破解Wallpaper Engine封装格式，释放加密资源
功能说明：递归解析PKG/MPKG文件结构，提取包含的图像、音频、配置等资源
总结：完整释放壁纸资源包内容

适用场景：获取壁纸原始素材用于修改或二次创作
操作示例：

repkg extract -o ./extracted_files ./wallpaper.pkg

2.1.2 项目生成

🔧 痛点解决：简化壁纸项目创建流程
功能说明：将提取的资源自动组织为Wallpaper Engine项目结构，包含必要配置文件
总结：一键生成可编辑壁纸项目

适用场景：快速搭建壁纸开发环境
操作示例：

repkg extract -c -n ./workshop_content ./output_projects

2.2 TEX图像转换

2.2.1 格式转换

🔧 痛点解决：突破专用图像格式限制
功能说明：将Wallpaper Engine专用TEX（Texture）文件转换为PNG等通用图像格式
总结：实现专用图像格式兼容

适用场景：编辑壁纸图像资源或保存为常用格式
操作示例：

repkg extract -t -s ./tex_files ./output_images

2.2.2 信息导出

🔧 痛点解决：缺乏TEX文件元数据查看工具
功能说明：解析并展示TEX文件详细信息，包括分辨率、格式、Mipmap层级等
总结：全面呈现图像技术参数

适用场景：资源审计或技术分析
操作示例：

repkg info -t ./texture.tex

3. 版本更新与功能对比

3.1 v2.0 核心改进

功能	v1.5	v2.0	改进说明
文件支持	仅PKG	PKG+MPKG	新增对多资源包格式的解析能力
提取效率	基础算法	并行处理	平均提速40%，大型文件效果更显著
图像转换	基础格式	全格式支持	新增对DXT5、RG88等高级纹理格式的转换
筛选功能	无	按扩展名筛选	可通过-e/-i参数精确控制提取内容

重要提示：v2.0引入的--no-tex-convert参数可显著提升纯资源提取速度，建议非图像资源提取时使用

4. 技术实现解析

4.1 核心架构

RePKG采用分层设计架构：

• 应用层（RePKG.Application）：实现命令解析与用户交互
• 核心层（RePKG.Core）：提供格式解析与转换核心算法
• 接口层：定义统一的数据访问与处理契约

4.2 关键技术

• 格式解析：基于逆向工程实现的PKG文件格式解析器
• 图像压缩：支持DXT（DirectX Texture Compression）格式编解码
• Mipmap处理：实现多级纹理的生成与 decompression

5. 常见问题

5.1 提取失败提示"UnknownMagicException"

原因：遇到不支持的文件格式或魔数
解决：确认文件为Wallpaper Engine正版PKG/TEX，或尝试更新至最新版本

5.2 转换的图像出现色彩偏差

原因：TEX文件使用特殊色彩空间或压缩算法
解决：添加-d参数启用调试模式重新转换，或提交issue附带样本文件

6. 使用指南

6.1 环境准备

git clone https://gitcode.com/gh_mirrors/re/repkg
cd repkg
dotnet build RePKG.sln

6.2 基础命令速查

• 提取单个PKG：repkg extract <文件路径>
• 批量转换TEX：repkg extract -t <目录路径>
• 查看文件信息：repkg info <文件路径>
• 高级帮助：repkg help "extract"