Files
VRMify-Enhanced/formats/longpath.py
T
Black-Cyan 60cce66993
Tests / test (push) Has been cancelled
初始化 VRMify 增强版(VRMify Enhanced)
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
2026-11-15 23:21:59 +08:00

178 lines
6.1 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- 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)