refactor: 提取 is_vp_or_py_at/JoinPath/read_file_to_buf 公共工具，消除 IncludesScanner/Phase2 重复代码

App/lib/Projectrans/Utils.vp

@@ -7,6 +7,7 @@ import viperlib
 import hashlib
 import w32.win32file
 import w32.win32base
+import w32.fileio as fileio
 
 
 # ============================================================
@@ -91,6 +92,122 @@ def compute_sha1(pool: memhub.MemBuddy | t.CPtr, content: str) -> str:
     return bytes_to_hex(pool, digest, 8, 0, 0)
 
 
+# ============================================================
+# is_vp_or_py_at - 检查路径段是否以 .vp/.py 后缀结尾
+# ============================================================
+def is_vp_or_py_at(p: str, start: t.CSizeT, plen: t.CSizeT) -> int:
+    """检查 p[start, start+plen) 是否以 .vp/.py 后缀结尾（1=是，0=否）"""
+    if p is None or plen <= 3:
+        return 0
+    base: t.CSizeT = start + plen - 3
+    if p[base] == '.':
+        if p[base + 1] == 'v' and p[base + 2] == 'p':
+            return 1
+        if p[base + 1] == 'p' and p[base + 2] == 'y':
+            return 1
+    return 0
+
+
+# ============================================================
+# JoinPath - 拼接两个路径段为 a/b
+# ============================================================
+def JoinPath(a: str, b: str) -> str:
+    """拼接路径段为 "a/b"（stdlib.malloc 分配，调用方负责 free），失败返回 None"""
+    if a is None or b is None:
+        return None
+    a_len: t.CSizeT = string.strlen(a)
+    b_len: t.CSizeT = string.strlen(b)
+    total_len: t.CSizeT = a_len + b_len + 2
+    buf: str = stdlib.malloc(total_len)
+    if buf is None:
+        return None
+    viperlib.snprintf(buf, total_len, "%s/%s", a, b)
+    return buf
+
+
+# ============================================================
+# read_file_to_buf - 读取整个文件到缓冲区（null 终止）
+# ============================================================
+def read_file_to_buf(path: str, buf_size: t.CSizeT) -> bytes:
+    """读取文件到 stdlib.malloc 缓冲区并保证 null 终止
+
+    返回缓冲区（调用方负责 free）；打开失败/空文件/分配失败返回 None。
+    合并自 Phase2/StubMerger/IncludesScanner 的重复"打开+读取+终止"序列。
+    """
+    if path is None or buf_size <= 0:
+        return None
+    sf: fileio.File | t.CPtr = fileio.File(path, fileio.MODE.R)
+    if sf.closed:
+        return None
+    buf: bytes = stdlib.malloc(buf_size)
+    if buf is None:
+        sf.close()
+        return None
+    br: t.CInt64T = sf.read_all(buf, buf_size)
+    sf.close()
+    if br <= 0:
+        stdlib.free(buf)
+        return None
+    if br < buf_size:
+        buf[br] = 0
+    else:
+        buf[buf_size - 1] = 0
+    return buf
+
+
+# ============================================================
+# PathToModuleName - 文件路径转模块名
+# ============================================================
+def PathToModuleName(path: str, strip_includes_prefix: int) -> str:
+    """将文件路径转换为模块名（stdlib.malloc 分配，调用方负责 free）
+
+    strip_includes_prefix=1 时跳过 includes/ 前缀（如 includes/ast/__init__.vp → ast）。
+    特殊处理 __init__.vp：pkg/__init__.vp → pkg（而非 pkg.__init__）。
+    合并自 StubMerger._PathToModuleName / IncludesScanner 内联模块名计算。
+    """
+    if path is None:
+        return None
+    plen: t.CSizeT = string.strlen(path)
+    # 跳过 includes/ 或 includes\ 前缀（Windows 反斜杠兼容）
+    prefix_len: t.CSizeT = 9
+    path_start: t.CSizeT = 0
+    if strip_includes_prefix != 0 and plen > prefix_len and string.strncmp(path, "includes", 8) == 0:
+        psep_ch: t.CChar = path[8]
+        if psep_ch == '/' or psep_ch == '\\':
+            path_start = prefix_len
+            plen = plen - prefix_len
+    # 去掉 .vp 或 .py 后缀（.vp 为 Viper 源，.py 向后兼容）
+    if is_vp_or_py_at(path, path_start, plen) != 0:
+        plen -= 3
+    if plen == 0:
+        return None
+    # 检查是否以 /__init__ 或 \__init__ 结尾（包的 __init__.vp）
+    # 同时支持 / 和 \ 两种分隔符（TPC 写入的路径可能混合使用）
+    if plen > 9:
+        tail_off: t.CSizeT = path_start + plen - 9
+        sep_char: t.CChar = path[tail_off]
+        if (sep_char == '/' or sep_char == '\\') \
+           and path[tail_off + 1] == '_' and path[tail_off + 2] == '_' \
+           and path[tail_off + 3] == 'i' and path[tail_off + 4] == 'n' and path[tail_off + 5] == 'i' \
+           and path[tail_off + 6] == 't' and path[tail_off + 7] == '_' and path[tail_off + 8] == '_':
+            # 去掉 分隔符+__init__ 后缀，plen 就是包名部分长度
+            plen = tail_off - path_start
+    if plen == 0:
+        return None
+    # 复制并替换 / 为 .
+    result: str = stdlib.malloc(plen + 1)
+    if result is None:
+        return None
+    for ri in range(plen):
+        ch: t.CChar = path[path_start + ri]
+        if ch == '/' or ch == '\\':
+            result[ri] = '.'
+        else:
+            result[ri] = ch
+    result[plen] = '\0'
+    return result
+
+
 # ============================================================
 # CleanDir - 递归删除目录中所有文件和子目录（保留 dir_path 本身）
 #
@@ -131,10 +248,8 @@ def CleanDir(dir_path: str) -> int:
                 elif fname[1] == '.' and fname[2] == '\0':
                     fname = None
         if fname is not None:
-            fname_len: t.CSizeT = string.strlen(fname)
-            full_path: bytes = stdlib.malloc(dir_len + fname_len + 2)
+            full_path: bytes = JoinPath(dir_path, fname)
             if full_path is not None:
-                viperlib.snprintf(full_path, dir_len + fname_len + 2, "%s/%s", dir_path, fname)
                 # 检查是否为目录（dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY）
                 is_dir: t.CUInt32T = find_data.dwFileAttributes & w32.win32file.FILE_ATTRIBUTE_DIRECTORY
                 if is_dir != 0: