导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
This commit is contained in:
@@ -0,0 +1,177 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
r"""Windows 超长路径(MAX_PATH 260)兼容层 —— 纯标准库。
|
||||
|
||||
问题
|
||||
----
|
||||
Windows 默认把路径限制在 260 字符(MAX_PATH)。Unity 资源包解出来的目录树
|
||||
本身就很深,例如::
|
||||
|
||||
Assets/NFD_Costume/HatsukoiVampire/Gimmick/Resource/Animator/
|
||||
Animation/Toggle/Accessory/NeckRibbon/Accessory_NeckRibbon_ON.anim
|
||||
|
||||
再叠上「输出目录 / 文件名_日期_序号 / 文件名_extracted」这几层,很容易超过
|
||||
260。一旦超出,open() / os.makedirs() 就抛::
|
||||
|
||||
FileNotFoundError: [Errno 2] No such file or directory: 'F:\...'
|
||||
|
||||
而且报错里那串路径看着完全正常,非常难排查。
|
||||
|
||||
注意:这**不是中文路径的问题**。Python 3 的 Unicode 路径本来就是好的,中文、
|
||||
日文、空格、方括号、全角符号都没问题,纯粹是「总长度」超限。所以同一台机器
|
||||
上路径浅就能转、路径深就报错,换台电脑因为存放位置不同结果又不一样。
|
||||
|
||||
绕过办法
|
||||
--------
|
||||
给路径加 ``\?\`` 前缀(Win32 扩展长度路径),直接跳过 MAX_PATH 检查。它
|
||||
**不依赖**注册表 LongPathsEnabled,也不需要管理员权限或重启,所以在别人的
|
||||
电脑上同样有效。
|
||||
|
||||
本模块把常用的文件 API 包一层:
|
||||
* 路径短(< 240)→ 原样透传,行为和以前完全一致;
|
||||
* 路径长 → 自动补 ``\?\``。
|
||||
|
||||
因此对现有用户零影响,只在「本来必然失败」的长路径上生效。
|
||||
|
||||
用法
|
||||
----
|
||||
``import longpath`` 即可,模块导入时自动安装(重复导入无副作用)。
|
||||
"""
|
||||
|
||||
import builtins
|
||||
import os
|
||||
import os.path as _path
|
||||
import shutil
|
||||
|
||||
# 文件路径上限 260、目录上限 248。这里留余量:超过 240 就上前缀,
|
||||
# 免得刚好卡在 258 那种「有时行有时不行」的位置。
|
||||
_THRESHOLD = 240
|
||||
|
||||
_PREFIX = '\\\\?\\' # \?\
|
||||
_UNC_PREFIX = '\\\\?\\UNC\\' # \?\UNC\
|
||||
|
||||
_installed = False
|
||||
_originals = {}
|
||||
|
||||
|
||||
def long_path(path):
|
||||
r"""路径过长时返回带 ``\?\`` 前缀的绝对路径;否则原样返回。
|
||||
|
||||
短路径一律原样返回(连 abspath 都不做),保证不改变任何现有行为。
|
||||
"""
|
||||
if os.name != 'nt':
|
||||
return path
|
||||
if not isinstance(path, str) or not path:
|
||||
return path # 只处理 str;fd / PathLike 原样放行
|
||||
if path.startswith(_PREFIX):
|
||||
return path # 已经加过前缀,别重复加
|
||||
if len(path) < _THRESHOLD:
|
||||
return path # 短路径不碰
|
||||
try:
|
||||
p = _path.abspath(path)
|
||||
except (OSError, ValueError):
|
||||
return path
|
||||
if len(p) < _THRESHOLD:
|
||||
return path
|
||||
if p.startswith('\\\\'):
|
||||
# UNC:\\server\share\x → \?\UNC\server\share\x
|
||||
return _UNC_PREFIX + p[2:]
|
||||
return _PREFIX + p
|
||||
|
||||
|
||||
def _install():
|
||||
"""给 os / builtins / shutil 的相关函数套上长路径包装。幂等。"""
|
||||
global _installed
|
||||
if _installed or os.name != 'nt':
|
||||
return
|
||||
_installed = True
|
||||
|
||||
# ---- 单路径参数 ------------------------------------------------------
|
||||
for name in ('makedirs', 'mkdir', 'rmdir', 'remove', 'unlink',
|
||||
'stat', 'lstat', 'chmod', 'utime', 'listdir', 'scandir',
|
||||
'access', 'truncate', 'readlink', 'startfile'):
|
||||
fn = getattr(os, name, None)
|
||||
if fn is None:
|
||||
continue
|
||||
_originals[name] = fn
|
||||
|
||||
def make(fn):
|
||||
def wrapper(path, *a, **kw):
|
||||
return fn(long_path(path), *a, **kw)
|
||||
return wrapper
|
||||
setattr(os, name, make(fn))
|
||||
|
||||
# ---- 双路径参数(源、目标都要处理)------------------------------------
|
||||
for name in ('rename', 'replace'):
|
||||
fn = getattr(os, name, None)
|
||||
if fn is None:
|
||||
continue
|
||||
_originals[name] = fn
|
||||
|
||||
def make2(fn):
|
||||
def wrapper(src, dst, *a, **kw):
|
||||
return fn(long_path(src), long_path(dst), *a, **kw)
|
||||
return wrapper
|
||||
setattr(os, name, make2(fn))
|
||||
|
||||
# ---- 内置 open -------------------------------------------------------
|
||||
_originals['open'] = builtins.open
|
||||
|
||||
def _open(file, *a, **kw):
|
||||
return _originals['open'](long_path(file), *a, **kw)
|
||||
builtins.open = _open
|
||||
|
||||
# ---- shutil:显式包一层(虽然底层最终也会走到上面的 open/stat)---------
|
||||
for name in ('copyfile', 'copy', 'copy2', 'copymode', 'copystat',
|
||||
'rmtree'):
|
||||
fn = getattr(shutil, name, None)
|
||||
if fn is None:
|
||||
continue
|
||||
_originals['shutil.' + name] = fn
|
||||
|
||||
def makes(fn):
|
||||
def wrapper(path, *a, **kw):
|
||||
return fn(long_path(path), *a, **kw)
|
||||
return wrapper
|
||||
setattr(shutil, name, makes(fn))
|
||||
|
||||
for name in ('move',):
|
||||
fn = getattr(shutil, name, None)
|
||||
if fn is None:
|
||||
continue
|
||||
_originals['shutil.' + name] = fn
|
||||
|
||||
def makes2(fn):
|
||||
def wrapper(src, dst, *a, **kw):
|
||||
return fn(long_path(src), long_path(dst), *a, **kw)
|
||||
return wrapper
|
||||
setattr(shutil, name, makes2(fn))
|
||||
|
||||
|
||||
_install()
|
||||
|
||||
|
||||
def probe(base):
|
||||
"""自检:在 base 下建一条超长路径并写入/读回,返回 (是否成功, 说明)。
|
||||
|
||||
给界面或命令行排查用;平时不调用。
|
||||
"""
|
||||
deep = os.path.join(base, '_longpath_probe')
|
||||
while len(deep) < 300:
|
||||
deep = os.path.join(deep, 'LongSegmentName_0123456789')
|
||||
target = os.path.join(deep, 'probe.txt')
|
||||
try:
|
||||
os.makedirs(deep, exist_ok=True)
|
||||
with open(target, 'w', encoding='utf-8') as f:
|
||||
f.write('ok')
|
||||
with open(target, encoding='utf-8') as f:
|
||||
got = f.read()
|
||||
return got == 'ok', '长度 %d,写入并读回成功' % len(target)
|
||||
except Exception as e: # pragma: no cover
|
||||
return False, '%s: %s' % (type(e).__name__, e)
|
||||
|
||||
|
||||
if __name__ == '__main__': # pragma: no cover
|
||||
import sys
|
||||
base = sys.argv[1] if len(sys.argv) > 1 else os.getcwd()
|
||||
ok, msg = probe(base)
|
||||
print(('[OK] ' if ok else '[FAIL] ') + msg)
|
||||
Reference in New Issue
Block a user