初始化 VRMify 增强版(VRMify Enhanced)
Tests / test (push) Has been cancelled

导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
This commit is contained in:
2026-11-15 23:21:59 +08:00
commit 60cce66993
114 changed files with 56114 additions and 0 deletions
+140
View File
@@ -0,0 +1,140 @@
"""Unpack a .unitypackage without Unity.
一个 .unitypackage 只是一个经过 gzip 压缩的 tar 归档文件。每个资源都存放在一个以其 32 位十六进制 GUID 命名的文件夹中,该文件夹包含:
asset the real file (FBX, prefab, png, ...)
asset.meta Unity metadata (importer type, guid)
pathname original path inside Assets/
preview.png optional thumbnail
解包后的落盘规则:
asset → <输出目录>/<Assets 里的相对路径> 例:.../FBX/model.fbx
辅助文件 → 与资产同层,名字带上资产名 例:.../FBX/model.fbx.meta
(asset.meta → <名>.meta,pathname / preview.png → <名>.pathname 等)
文件夹资源 → 建出同名空文件夹(tar 里没有它的 asset 本体)
辅助文件之所以带上资产名,是因为同一目录下常有两个以上资产,若统一叫
asset.meta / pathname 就会互相覆盖,只剩最后一个。
Usage:
python unitypackage_unpack.py <file.unitypackage> [-o OUTDIR] [--list]
# 先看包里有什么(不解包)
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage" --list
# 解包到默认目录(<文件名>_extracted)
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage"
# 解包到指定目录
python unitypackage_unpack.py "Sexy Sailor_Sapphy_v1.00.unitypackage" -o "D:/output/Sapphy"
只要路径里带空格或中文,就套一层双引号,否则 shell 会按空格切参数。
"""
import argparse
import os
import shutil
import sys
import tarfile
# Windows 超长路径支持:Unity 包里的目录树很深,再叠上输出目录很容易超 260
# 字符而报 FileNotFoundError。这个模块导入即生效,短路径行为不变。
# 单独把本文件拷出去用时可能找不到,所以吞掉 ImportError。
try:
import longpath # noqa: F401
except ImportError: # pragma: no cover
pass
def _members(src):
"""按包里的顺序逐个给出 (GUID, 文件名, 内容),整个包只解压一遍(流式读 tar)。
以前先 getmembers() 走一遍、再按成员回头读 pathname、再逐个解出:gzip 不能往回跳,
每次回头都从头再解,161 MB 的包要解三遍。"""
with tarfile.open(src, 'r|gz') as t:
for m in t:
if m.isfile():
guid, fn = m.name.split('/', 1)
yield guid, fn, t.extractfile(m).read()
def _target(outdir, raw, guid, fn):
"""一个成员的落盘路径,以及它是不是「文件夹」资源的辅助文件(要建出空文件夹)。"""
# pathname 以 '/' 结尾 = 这是一个「文件夹」资源(Unity 里文件夹也是资源)。
# tar 里没有它的 asset 本体,只有 asset.meta / pathname / preview.png。
is_folder = raw.endswith('/') or not raw or raw == guid
# 去掉开头的 "Assets/"(以前用 lstrip('Assets/'),那是按字符集剥:
# "Assets/shaders/x" 会被剥成 "haders/x")
rel = (raw[len('Assets/'):] if raw.startswith('Assets/') else raw).rstrip('/') or guid
if fn == 'asset':
return os.path.join(outdir, rel), rel, False
# asset.meta / pathname / preview.png 是辅助文件:跟资产放在同一层,
# 名字里带上资产名(asset.meta 按 Unity 习惯写成 <名>.meta)。
# 早先直接写 <父目录>/<文件名>,同一目录下有两个以上资产时,
# 后一个会把前一个**静默覆盖**(实测 172 个输出里 51 个碰撞、
# 168 个成员被覆盖,其中 92 个 asset.meta + 92 个 pathname)。
name = os.path.basename(rel) or guid
aux = name + '.meta' if fn == 'asset.meta' else name + '.' + fn
return os.path.join(outdir, os.path.dirname(rel), aux), rel, is_folder
def unpack(src, outdir, list_only=False, verbose=True):
"""解包到 outdir;verbose=False 时不逐个列出文件(界面 / 流水线自己记一行汇总)。
一个资源的成员在包里是挨着的(asset、asset.meta、pathname、preview.png),落盘路径要等
读到 pathname 才知道:之前的成员先留在内存里(最多一个资源的大小),读到它再按原顺序写出。"""
if list_only:
paths, sizes = {}, []
for guid, fn, data in _members(src):
if fn == 'pathname':
paths[guid] = data.decode('utf-8', 'replace').strip()
elif fn == 'asset':
sizes.append((guid, len(data)))
for guid, size in sizes:
print('%10d %s' % (size, paths.get(guid, '?')))
return 0
if os.path.isdir(outdir):
shutil.rmtree(outdir)
os.makedirs(outdir)
paths, pending = {}, {}
n = 0
def write(guid, fn, data):
dst, rel, folder = _target(outdir, paths.get(guid, ''), guid, fn)
os.makedirs(os.path.dirname(dst), exist_ok=True)
if folder:
# 文件夹资源的 asset 本体不存在,不在这里建的话空文件夹会丢
os.makedirs(os.path.join(outdir, rel), exist_ok=True)
with open(dst, 'wb') as w:
w.write(data)
if verbose:
print(' %8.1f KB %s' % (len(data) / 1024, os.path.relpath(dst, outdir)))
for guid, fn, data in _members(src):
if fn == 'pathname':
paths[guid] = data.decode('utf-8', 'replace').strip()
if guid in paths:
for item in pending.pop(guid, ()):
write(guid, *item)
write(guid, fn, data)
else:
pending.setdefault(guid, []).append((fn, data))
n += 1
for guid, items in pending.items(): # 没有 pathname 的资源:按 GUID 落盘
for item in items:
write(guid, *item)
if verbose:
print('\n%d files -> %s' % (n, outdir))
return 0
def main():
ap = argparse.ArgumentParser()
ap.add_argument('src')
ap.add_argument('-o', '--out', default=None)
ap.add_argument('--list', action='store_true')
a = ap.parse_args()
out = a.out or os.path.splitext(a.src)[0] + '_extracted'
return unpack(a.src, out, a.list)
if __name__ == '__main__':
sys.exit(main())