refactor(tpv): rowptr[T] 迁移 + D 表定长缓冲改精确分配 + SHA1 前缀判定收敛（D1/D3/D4/D5/D6/D7/C10）

App/lib/core/Gen/GenApi.vp

@@ -3,6 +3,7 @@ from stdint import *
 import ast
 import llvmlite
 import memhub
+import string
 import lib.core.Gen.GenTypes as GenTypes
 import lib.core.Gen.Generator as Generator
 import lib.core.Gen.Translator as HT
@@ -70,7 +71,7 @@ def clear_ctypedefs() -> None:
 
 
 # ---------------- RegisterCTypedefFromSource（委托 TypeGenCType.register_ctypedef_from_source） ----------------
-def RegisterCTypedefFromSource(pool: memhub.MemBuddy | t.CPtr, src: str) -> int:
+def RegisterCTypedefFromSource(pool: rowptr[memhub.MemBuddy], src: str) -> int:
     """委托到 gen.register_ctypedef_from_source（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.TypeGenCType.register_ctypedef_from_source(pool, src)
@@ -105,7 +106,7 @@ def fatal_error(node: ast.AST | t.CPtr, msg: str,
 
 
 # ---------------- map_t_type（委托 TypeGenResolve.map_t_type） ----------------
-def map_t_type(pool: memhub.MemBuddy | t.CPtr, type_name: str) -> llvmlite.LLVMType | t.CPtr:
+def map_t_type(pool: rowptr[memhub.MemBuddy], type_name: str) -> llvmlite.LLVMType | t.CPtr:
     """委托到 gen.map_t_type（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.TypeGenResolve.map_t_type(pool, type_name)
@@ -113,7 +114,7 @@ def map_t_type(pool: memhub.MemBuddy | t.CPtr, type_name: str) -> llvmlite.LLVMT
 
 
 # ---------------- resolve_typedef_or_map（委托 TypeGenResolve.resolve_typedef_or_map） ----------------
-def resolve_typedef_or_map(pool: memhub.MemBuddy | t.CPtr,
+def resolve_typedef_or_map(pool: rowptr[memhub.MemBuddy],
                            name: str,
                            imported_modules: str,
                            from_imports: str,
@@ -125,7 +126,7 @@ def resolve_typedef_or_map(pool: memhub.MemBuddy | t.CPtr,
 
 
 # ---------------- infer_external_func_ret_ty（委托 CallGenLib._infer_external_func_ret_ty） ----------------
-def infer_external_func_ret_ty(pool: memhub.MemBuddy | t.CPtr,
+def infer_external_func_ret_ty(pool: rowptr[memhub.MemBuddy],
                                func_name: str) -> llvmlite.LLVMType | t.CPtr:
     """委托到 gen.CallGenLib._infer_external_func_ret_ty（外部函数返回类型白名单）
 
@@ -157,7 +158,7 @@ def _is_ctypedef_annotation(annotation: ast.AST | t.CPtr) -> int:
 
 
 # ---------------- resolve_annotation_type（委托 TypeGenResolve.resolve_annotation_type） ----------------
-def resolve_annotation_type(pool: memhub.MemBuddy | t.CPtr, node: ast.AST | t.CPtr, imported_modules: str, from_imports: str, trans: HT.Translator | t.CPtr = None, depth: int = 0) -> llvmlite.LLVMType | t.CPtr:
+def resolve_annotation_type(pool: rowptr[memhub.MemBuddy], node: ast.AST | t.CPtr, imported_modules: str, from_imports: str, trans: HT.Translator | t.CPtr = None, depth: int = 0) -> llvmlite.LLVMType | t.CPtr:
     """委托到 gen.resolve_annotation_type（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.TypeGenResolve.resolve_annotation_type(pool, node, imported_modules, from_imports, trans, depth)
@@ -174,7 +175,7 @@ def has_decorator_marker(node: ast.AST | t.CPtr, marker_name: str,
 
 
 # ---------------- _get_type_name_from_annotation（委托 TypeGenResolve._get_type_name_from_annotation） ----------------
-def _get_type_name_from_annotation(pool: memhub.MemBuddy | t.CPtr, node: ast.AST | t.CPtr) -> str:
+def _get_type_name_from_annotation(pool: rowptr[memhub.MemBuddy], node: ast.AST | t.CPtr) -> str:
     """委托到 gen._get_type_name_from_annotation（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.TypeGenResolve._get_type_name_from_annotation(pool, node)
@@ -182,7 +183,7 @@ def _get_type_name_from_annotation(pool: memhub.MemBuddy | t.CPtr, node: ast.AST
 
 
 # ---------------- register_ctypedef（委托 TypeGenCType.register_ctypedef） ----------------
-def register_ctypedef(pool: memhub.MemBuddy | t.CPtr, name: str, type_str: str):
+def register_ctypedef(pool: rowptr[memhub.MemBuddy], name: str, type_str: str):
     """委托到 gen.register_ctypedef（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.TypeGenCType.register_ctypedef(pool, name, type_str)
@@ -205,7 +206,7 @@ def is_cdefine_found() -> int:
 
 
 # ---------------- register_cdefine_constant（委托 TypeGenCDef.register_cdefine_constant） ----------------
-def register_cdefine_constant(pool: memhub.MemBuddy | t.CPtr,
+def register_cdefine_constant(pool: rowptr[memhub.MemBuddy],
                               name: str, value: int64):
     """委托到 gen.register_cdefine_constant（原 Handles 壳）"""
     if _g_gen is not None:
@@ -213,7 +214,7 @@ def register_cdefine_constant(pool: memhub.MemBuddy | t.CPtr,
 
 
 # ---------------- register_cdefine_double（委托 TypeGenCDef.register_cdefine_double） ----------------
-def register_cdefine_double(pool: memhub.MemBuddy | t.CPtr,
+def register_cdefine_double(pool: rowptr[memhub.MemBuddy],
                             name: str, value: double):
     """委托到 gen.register_cdefine_double（原 Handles 壳）"""
     if _g_gen is not None:
@@ -259,7 +260,7 @@ def get_temp_dir() -> str:
 
 
 # ---------------- reset_visible_structs（委托 StructGenMixin.reset_visible_structs） ----------------
-def reset_visible_structs(pool: memhub.MemBuddy | t.CPtr, strict: int):
+def reset_visible_structs(pool: rowptr[memhub.MemBuddy], strict: int):
     """委托到 gen.reset_visible_structs（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.StructGen.reset_visible_structs(pool, strict)
@@ -311,7 +312,7 @@ def get_enum_base_type(enum_name: str) -> llvmlite.LLVMType | t.CPtr:
 
 
 # ---------------- add_visible_struct（委托 StructGenMixin.add_visible_struct） ----------------
-def add_visible_struct(pool: memhub.MemBuddy | t.CPtr, name: str):
+def add_visible_struct(pool: rowptr[memhub.MemBuddy], name: str):
     """委托到 gen.add_visible_struct（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.StructGen.add_visible_struct(pool, name)
@@ -334,7 +335,7 @@ def find_struct_by_type(struct_ty: llvmlite.LLVMType | t.CPtr) -> GenTypes.Struc
 
 
 # ---------------- register_struct（委托 StructGenMixin.register_struct） ----------------
-def register_struct(pool: memhub.MemBuddy | t.CPtr,
+def register_struct(pool: rowptr[memhub.MemBuddy],
                     name: str,
                     struct_ty: llvmlite.LLVMType | t.CPtr,
                     sha1: str = None) -> GenTypes.StructEntry | t.CPtr:
@@ -345,7 +346,7 @@ def register_struct(pool: memhub.MemBuddy | t.CPtr,
 
 
 # ---------------- add_field（委托 StructGenMixin.add_field） ----------------
-def add_field(pool: memhub.MemBuddy | t.CPtr,
+def add_field(pool: rowptr[memhub.MemBuddy],
               struct_entry: GenTypes.StructEntry | t.CPtr,
               field_name: str,
               field_ty: llvmlite.LLVMType | t.CPtr) -> int:
@@ -356,7 +357,7 @@ def add_field(pool: memhub.MemBuddy | t.CPtr,
 
 
 # ---------------- register_struct_alias（委托 StructGenMixin.register_struct_alias） ----------------
-def register_struct_alias(pool: memhub.MemBuddy | t.CPtr,
+def register_struct_alias(pool: rowptr[memhub.MemBuddy],
                           name: str,
                           sha1: str,
                           src_entry: GenTypes.StructEntry | t.CPtr) -> GenTypes.StructEntry | t.CPtr:
@@ -376,7 +377,7 @@ def get_stdlib_alloc() -> int:
 
 
 # ---------------- compute_package_from_relpath（委托 ImportsGenMixin.compute_package_from_relpath） ----------------
-def compute_package_from_relpath(pool: memhub.MemBuddy | t.CPtr, rel_path: str) -> str:
+def compute_package_from_relpath(pool: rowptr[memhub.MemBuddy], rel_path: str) -> str:
     """委托到 gen.compute_package_from_relpath（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.ImportsGen.compute_package_from_relpath(pool, rel_path)
@@ -391,8 +392,56 @@ def is_module_imported(imported_modules: str, name: str) -> int:
     return 0
 
 
+# ============================================================
+# SHA1 前缀识别的**唯一真源**（C10 / D3 收敛）
+#
+# 「名字带 SHA1 前缀」有两种书写形态，各自给一个判定：
+#   sha1_prefix_len(name) → 完整名 "{16位小写hex}.Class"  ⇒ 返回 17（前缀字节数），
+#                            否则 0。判据三条缺一不可：长度 >= 17、第 17 字节是
+#                            '.'、前 16 字节全是小写 hex（0-9a-f）。
+#   is_sha1_hex16(seg)    → 单独的**模块段**（"16位小写hex"）⇒ 1/0。
+#                            用于已把 "mod.Class" 切成两段后判 mod 段（此时无从
+#                            判断 '.' 存在与否）。
+#
+# 为什么必须唯一：此前全仓有 8 份以上同义拷贝且**口径互不相同**——有的省略 hex
+# 校验（只判 `len > 17 && s[16] == '.'`）、有的允许大写 A-F、有的只要 `len >= 16`
+# 就盲取前 16 字节当 SHA1。同一名字在不同路径被判成"是/不是 SHA1 前缀"，会产生
+# 「重复加前缀 / 把 SHA1 当模块名再查一次（查不到）/ 该跳过 store 查询的没跳过」
+# 等隐蔽不一致（跨模块同名类归属错乱、泛型实参解析退化均源于此族）。
+# ============================================================
+def sha1_prefix_len(name: str) -> int:
+    """名字若是 "{16位小写hex}." 形态返回 17（前缀字节数），否则返回 0"""
+    if name is None:
+        return 0
+    if string.strlen(name) < 17:
+        return 0
+    if name[16] != '.':
+        return 0
+    i: sizet
+    for i in range(16):
+        c: int = name[i]
+        # 48-57 = '0'-'9'，97-102 = 'a'-'f'
+        if not ((c >= 48 and c <= 57) or (c >= 97 and c <= 102)):
+            return 0
+    return 17
+
+
+def is_sha1_hex16(seg: str) -> int:
+    """seg 是否恰为 16 位小写 hex（SHA1 模块段），1=是 / 0=否"""
+    if seg is None:
+        return 0
+    if string.strlen(seg) != 16:
+        return 0
+    i: sizet
+    for i in range(16):
+        c: int = seg[i]
+        if not ((c >= 48 and c <= 57) or (c >= 97 and c <= 102)):
+            return 0
+    return 1
+
+
 # ---------------- add_imported_module（委托 ImportsGenMixin.add_imported_module） ----------------
-def add_imported_module(pool: memhub.MemBuddy | t.CPtr, imported_modules: str, name: str) -> str:
+def add_imported_module(pool: rowptr[memhub.MemBuddy], imported_modules: str, name: str) -> str:
     """委托到 gen.add_imported_module（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.ImportsGen.add_imported_module(pool, imported_modules, name)
@@ -432,7 +481,7 @@ def _get_parent_class(cd: ast.ClassDef | t.CPtr, trans: HT.Translator | t.CPtr =
 
 
 # ---------------- _register_generic_template（委托 ClassGenGeneric._register_generic_template） ----------------
-def _register_generic_template(pool: memhub.MemBuddy | t.CPtr, cd: ast.ClassDef | t.CPtr, module_sha1: str):
+def _register_generic_template(pool: rowptr[memhub.MemBuddy], cd: ast.ClassDef | t.CPtr, module_sha1: str):
     """委托到 gen._register_generic_template（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.ClassGenGeneric._register_generic_template(pool, cd, module_sha1)
@@ -479,7 +528,7 @@ def translate_children(trans: HT.Translator | t.CPtr, tree: ast.AST | t.CPtr) ->
 
 
 # ---------------- init_symbol_table（委托 VarGenMixin.init_symbol_table） ----------------
-def init_symbol_table(pool: memhub.MemBuddy | t.CPtr) -> GenTypes.SymbolTable | t.CPtr:
+def init_symbol_table(pool: rowptr[memhub.MemBuddy]) -> GenTypes.SymbolTable | t.CPtr:
     """委托到 gen.init_symbol_table（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.VarGen.init_symbol_table(pool)
@@ -502,7 +551,7 @@ def find_func_in_module(mod: llvmlite.LLVMModule | t.CPtr, name: str) -> llvmlit
 
 
 # ---------------- add_func_to_table（委托 CallGenLeafKit.add_func_to_table） ----------------
-def add_func_to_table(funcs: GenTypes.FuncEntry | t.CPtr, func_count: int, name: str, func: llvmlite.Function | t.CPtr, max_count: int, defaults: t.CPtr = None, default_count: int = 0, param_count: int = 0, pool: memhub.MemBuddy | t.CPtr = None, def_sha1: str = None) -> int:
+def add_func_to_table(funcs: GenTypes.FuncEntry | t.CPtr, func_count: int, name: str, func: llvmlite.Function | t.CPtr, max_count: int, defaults: t.CPtr = None, default_count: int = 0, param_count: int = 0, pool: rowptr[memhub.MemBuddy] = None, def_sha1: str = None) -> int:
     """委托到 gen.add_func_to_table（原 Handles 壳）
 
     def_sha1：定义该函数的模块 SHA1（依赖注入路径必须传，避免默认值被挂到导入方名下）
@@ -513,7 +562,7 @@ def add_func_to_table(funcs: GenTypes.FuncEntry | t.CPtr, func_count: int, name:
 
 
 # ---------------- init_func_table（委托 CallGenLeafKit.init_func_table） ----------------
-def init_func_table(pool: memhub.MemBuddy | t.CPtr, max_count: int) -> GenTypes.FuncEntry | t.CPtr:
+def init_func_table(pool: rowptr[memhub.MemBuddy], max_count: int) -> GenTypes.FuncEntry | t.CPtr:
     """委托到 gen.init_func_table（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.CallGenLeafKit.init_func_table(pool, max_count)
@@ -521,7 +570,7 @@ def init_func_table(pool: memhub.MemBuddy | t.CPtr, max_count: int) -> GenTypes.
 
 
 # ---------------- translate_call（委托 CallGenMixin.translate_call） ----------------
-def translate_call(pool: memhub.MemBuddy | t.CPtr, builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, node: ast.AST | t.CPtr, funcs_ptr: t.CPtr, func_count: int, trans: HT.Translator | t.CPtr = None) -> llvmlite.Value | t.CPtr:
+def translate_call(pool: rowptr[memhub.MemBuddy], builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, node: ast.AST | t.CPtr, funcs_ptr: t.CPtr, func_count: int, trans: HT.Translator | t.CPtr = None) -> llvmlite.Value | t.CPtr:
     """委托到 gen.translate_call（原 Handles 壳）"""
     if _g_gen is not None:
         return _g_gen.CallGen.translate_call(pool, builder, mod, node, funcs_ptr, func_count, trans)
@@ -529,14 +578,14 @@ def translate_call(pool: memhub.MemBuddy | t.CPtr, builder: llvmlite.IRBuilder |
 
 
 # ---------------- translate_printf_call（委托 CallGenLeafKit.translate_printf_call） ----------------
-def translate_printf_call(pool: memhub.MemBuddy | t.CPtr, builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, cl: ast.Call | t.CPtr, trans: HT.Translator | t.CPtr = None):
+def translate_printf_call(pool: rowptr[memhub.MemBuddy], builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, cl: ast.Call | t.CPtr, trans: HT.Translator | t.CPtr = None):
     """委托到 gen.translate_printf_call（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.CallGenLeafKit.translate_printf_call(pool, builder, mod, cl, trans)
 
 
 # ---------------- translate_print_call（委托 CallGenLeafKit.translate_print_call） ----------------
-def translate_print_call(pool: memhub.MemBuddy | t.CPtr, builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, cl: ast.Call | t.CPtr, trans: HT.Translator | t.CPtr = None):
+def translate_print_call(pool: rowptr[memhub.MemBuddy], builder: llvmlite.IRBuilder | t.CPtr, mod: llvmlite.LLVMModule | t.CPtr, cl: ast.Call | t.CPtr, trans: HT.Translator | t.CPtr = None):
     """委托到 gen.translate_print_call（原 Handles 壳）"""
     if _g_gen is not None:
         _g_gen.CallGenLeafKit.translate_print_call(pool, builder, mod, cl, trans)