GVSDS/TransPyC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
188 Commits 1 Branch 0 Tags
8ce08493e885b689adefc9ba9df9abfeec4182bf
Commit Graph
188 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
TermiNexus 8ce08493e8 feat(coro): M7——try/finally、异常消息、自定义异常类、帧池复用 
- try/finally（无 except）：正常/异常路径都执行 fbody，异常时 finally 后
  重新传播（done+br exit）；finally 内暂不支持 await
- 异常消息：帧加 msg 槽（i8*，index 4），raise X(msg) 存消息，await 传播，
  coro_exception_msg 查询
- raise 支持自定义异常类（exception_registry 码），多 except 匹配子类码
- 帧池复用：per-type free-list 全局池，create 弹池/空则 malloc，coro_destroy
  回池（帧头部存 next），避免反复 malloc/free
- 修复 ast.walk 传 list 崩溃（finalbody/For body）
- CoroTest 验证：finally 执行、MyError exc=100 msg=boom msg、3 次循环池复用
 2026-08-21 14:46:21 +08:00
TermiNexus 8b9e88287a feat(coro): M6——raise 异常类型 + 多 except 类型匹配 
- raise 支持异常类型名/调用（EXCEPTION_CODE_MAP/exception_registry → 异常码），
  普通表达式仍走值路径
- _HandleCoroTry 多 except dispatch：独立 check_bbs 链式匹配 exc 码（含子类码
  集合），命中进入对应 handler，全不匹配重新终止传播；Exception/裸 except 捕获所有
- CoroTest 验证：raise ValueError 匹配 except ValueError → 1；
  raise KeyError 匹配 except KeyError → 2（gather 并发）
 2026-08-21 14:32:52 +08:00
TermiNexus 69447025a7 feat(coro): M5——协程内 try/except 捕获（raise 与 await 传播异常） 
- _HandleCoroTry：except_bb/merge_bb 控制流，单 except 捕获所有异常
- 协程内 raise 与 await 子协程异常传播：处于 try 栈内时改跳 except 处理器，
  栈外维持原终止语义（done=1 + br exit）
- except X as e：异常码绑定到 e（帧槽），捕获后清帧 exc
- 预扫描/_CollectFrameVars 递归 Try（handler.name 进帧槽，跨挂起存活）
- CoroTest 验证：try 捕获 await 传播异常 → coro result = 42, exc = 0
 2026-08-21 14:28:52 +08:00
TermiNexus 411e0bb774 feat(coro): M4——异常传播（帧 exc 槽 + raise + await 传播）+ gather 并发调度 
- 帧布局加固定 exc 槽（i32，0=无异常），协程内 raise 存异常码并终止
- await 子协程后检测异常并传播到父帧（父协程带异常终止，状态机短路）
- return await x：await 值直接存父帧 ret 槽（挂起前），修复 child_ret 跨块
  dominate 错误；挂起不再写 ret=0（避免覆盖返回值）
- coro.coro_gather(帧...)：并发推进全部协程到完成（含 coro_sleep 轮询），
  返回完成数
- coro.vp 追加 coro_exception/coro_gather 占位
- CoroTest 验证：异常传播 exc=42；gather=2 r1=2 r2=3
 2026-08-21 14:26:19 +08:00
TermiNexus c979f0f94d fix(coro): M3 三处修复——nonlocal 闭包、wake 空块终止、coro_run 唤醒槽按索引定位 
- _PreScanExtraSlots 内嵌 _walk 闭包变量需 nonlocal（UnboundLocalError）
- coro_run wake_due_bb 补 br loop（空块导致 opt ASan 插桩解析失败）
- coro_run 内联在 main 翻译时 _coro_wake_ptr 已被恢复为 None，改为按
  _coro_slot_vars 索引定位 __coro_wake_us 槽
- 验证：CoroTest ASan 模式编译+运行通过，coro result = 15
 2026-08-21 14:20:51 +08:00
TermiNexus 3acf24c7d0 feat(coro): M3——For 内 await、coro_sleep 挂起、coro_destroy 释放帧 
- For 内 await：range 迭代变换为 While（__f_idx_N/__f_len_N 帧槽），复用协程版 While
  就地挂起/恢复；For 迭代目标进帧槽跨挂起存活；仅支持 range 1/2 参数
- coro_sleep(ms)：帧加 __coro_wake_us（i64）唤醒槽，挂起后 coro_run 轮询
  GetTickCount64，未到点 Sleep(1) 续轮询，到点自动恢复
- coro_destroy(帧)：coro.coro_destroy 内联翻译为 free 释放帧内存
- coro.vp 追加 coro_sleep/coro_destroy 占位；CoroTest 用例覆盖
  for+await/sleep/destroy（期望 coro result = 15）
 2026-08-21 14:17:27 +08:00
TermiNexus 4640211e3c docs(mcp): 非生产环境默认推荐启用 ASan，ASan/非 ASan 切换需 --rebuild-includes 
- protocol.md 新增 5.8 ASan 推荐：非生产环境 --asan 捕获内存错误，生产环境不启用
- 明确 ASan 与非 ASan 共享 includes.binary 缓存会互相污染（undefined symbol: __asan_*），切换必须重建缓存
- README/tools.json 同步更新 asan 字段描述
 2026-08-21 14:08:37 +08:00
TermiNexus 004121de40 feat(mcp): 实现 transpyc_mcp 服务器——stdio JSON-RPC 驱动 TPC/TPV 
- transpyc_mcp/server.py：零依赖 MCP 服务器（initialize/tools/list/tools/call）
- 14 个工具按协议实现：tpc_build/tpc_build_file/tpc_run_test/tpc_run_regression/
  tpc_clean_project/tpc_clear_cache/tpc_rebuild_includes/tpv_build/tpv_bootstrap/
  tpv_compile_project/tpv_run_test/tp_read_ast/tp_read_log/tp_sha1_map
- 安全：路径白名单/命令白名单/工程串行锁/TPV 内存保护（>=1GiB）
- 输出统一 {ok, exit_code, stdout, stderr, artifacts, elapsed_ms}，日志末尾 50 行
- 冒烟测试通过：init/tools-list/AST 解析/日志/越界拒绝/未知工具/锁
- 修正协议：--clean 为清理后继续完整编译（非独立清理）
 2026-08-21 14:05:36 +08:00
TermiNexus e412885a3e docs(mcp): 新增 MCP 协议规范——规定如何通过 MCP 操作 TPV 与 TPC 
- MCP/README.md：总览、目录、快速接入与命令速查
- MCP/protocol.md：14 个工具定义（tpc_/tpv_/tp_ 前缀）、执行约定、
  输出格式、安全约束、错误码
- MCP/tools/tools.json：可被客户端直接加载的工具 schema 集合
 2026-08-21 14:00:43 +08:00
TermiNexus ff7c0457ad feat(coro): M2——async 参数/嵌套 await 表达式/If-While 控制流 
- 帧结构体增加参数槽与提升临时变量槽，create_<name> 带参数存入帧
- 嵌套 await（如 a = b + await f()）提升为顶层临时赋值 __await_N，帧预留槽
- 协程版 If/While：条件求值 + 分支内 await 就地挂起/恢复（动态状态号恢复块）
- For 循环委托现有 handler（仅支持无 await/return，M3 扩展）
- CoroTest 用例覆盖参数/嵌套 await/while+await/if+await（期望 coro result = 30）
 2026-08-21 13:31:37 +08:00
TermiNexus a775ec9932 fix(coro): 帧结构体定义输出到 IR，修复 GEP base element must be sized 
协程帧类型 %Coro_<name> 只存 _coro_frame_types 未注册进 Gen.structs，
StructGen.finalize 不输出其定义 → resume_<name> 的 GEP 引用 opaque
类型，opt ASan 插桩报 "base element of getelementptr must be sized"。
修复：_GetOrCreateFrameType 注册帧到 Gen.structs；finalize 追加
_coro_frame_types 兜底输出（防 _generate_structs 清空时丢定义）。
 2026-08-21 12:41:10 +08:00
TermiNexus 13a8f6c1b6 feat(coro): 语言内协程 M1——async def + await + coro_run 状态机 
TPC 新增协程生成器 AsyncFunctionHandle（lib/core/Handles/HandlesAsyncFunctions.py）：
async def 编译为帧结构体 {state, done, ret, 局部变量槽} + create_<name>()（malloc
分配）+ resume_<name>()（switch 状态机，0=SUSPEND/1=DONE）。await 按顶层赋值
切分函数体：创建子帧 -> resume -> 取子帧 ret -> 存父帧槽 -> 父挂起（state 前进）；
普通调用 async 函数生成 create（返回帧指针）；coro.coro_run 在调用点内联翻译为
resume 循环。vast parser 已支持语法；新增 includes/coro.vp（Coroutine + 占位
运行时）与 Test/CoroTest（期望输出 coro result = 14）。

M1 限制：async 无参数、返回 i32/int；协程体仅顶层 AnnAssign/Assign/Expr/Return；
await 仅顶层赋值形式、子协程假设一次完成（无嵌套挂起）；coro_run 依赖本模块
先赋值的协程变量。M2 将支持参数/嵌套 await/控制流。
 2026-08-21 12:36:00 +08:00
TermiNexus 12207e91d8 fix(phase2): 并行编译 worker 数按可用内存动态限制，修复内存不足 OOM 
系统可用内存低（Trae CN/Java 占用后仅剩 ~1GB）时，ProcessPoolExecutor
按 cpu_count 开满 worker，多进程编译内存叠加在 StructGen.finalize 拼接
module IR 时 MemoryError（编译 StubMergerTopo.vp 报错即此）。新增
_PickWorkerCount：GlobalMemoryStatusEx 读 ullAvailPhys，按 per_worker_mb
估算 worker 上限（翻译 700MB / llc 400MB），内存不足自动降为单 worker
串行，内存充足回落 cpu_count。StructGen.finalize 拼接改中间变量拆分，
降低单 worker 峰值副本。
 2026-08-21 09:04:40 +08:00
TermiNexus e37cdf2eb0 docs(TODO): 记录 Mixin 方法直接调用合法性静态检查待办 
MixinC2.outer2(c) 用非组合类实例直接调用编译通过但运行期 this_adjust 越界——Mixin 方法必须经组合类实例调用。日后编译器提前报错预警功能需在调用处验证 self 类型的组合完整性。
 2026-08-21 01:30:25 +08:00
TermiNexus 8a0da29461 fix(exprcall): 兄弟 Mixin 兜底按调用类是否声明该方法过滤，修复 NoVTable 回归 
780cd4a 用 MRO/组合类判断 _is_mixin_parent 不可靠：Combined 定义在 BaseB 之后，BaseB.caller 翻译时组合类未注册、MRO 查询失败 → 兜底静默跳过 → NoVTableCrossMixinTest 的 TPC 编译 fallback 生成不存在的 BaseB.helper（定义在 BaseA）→ ld.lld undefined symbol（回归）。

改为：调用类自身声明了该方法（class_methods 含 MethodName）但 stub 未命中（如 JsonValue.__getitem__ 跨模块 stub 注册问题）→ 不兜底，fail-fast 暴露上游 stub 问题（防误绑 HashTable，1.LOG 根因）；调用类未声明（BaseB.helper / MixinC2.mid2）→ 跨 Mixin，全量遍历找定义类。保留 list 特化过滤（3fd875d）。
 2026-08-21 01:26:19 +08:00
TermiNexus f703fdaf23 test(NoVTableCrossMixinTest): 扩展三段式覆盖——多级 Mixin 链 + 第二父类 this_adjust 
Test 2：Combined2(MixinB2(MixinA2), MixinC2) 多级链——MixinC2.outer2 调兄弟 MixinB2.mid2，mid2 调父类 MixinA2.inner2 并写字段，验证链式 this_adjust。

Test 3：Combined3(PtrMixin, DataMixin)——DataMixin 第二父类字段区偏移非 0，get_val 内 self.val 需 this_adjust；含指针字段 get_name。
 2026-08-21 01:16:32 +08:00
TermiNexus 780cd4a13b fix(exprcall): 兄弟 Mixin 兜底仅对组合类父类启用——防误绑 HashTable 方法 
3fd875d 只过滤了 list 特化类名，普通类（HashTable）仍被误绑：JsonValue.__getitem__ 未命中时遍历 class_methods 命中 HashTable.__getitem__，this 前移 sizeof(HashTable)=-48 → Load_project_config root.__getitem__ 读 -1 崩溃（1.LOG 4c1f8f779b98eab9.HashTable._slot_hash）。

加固：兜底前检查 class_name 是否是多继承组合类的父类（存在以它为父类的类，如 Generator 的 44 个 Mixin / Combined(BaseA,BaseB)）。普通类方法未命中时不再回退到无关类，走 fail-fast（Undefined method）暴露上游 stub 注册/时序问题。
 2026-08-20 17:08:14 +08:00
TermiNexus 51c0e026f4 fix(includes): 链式 GSList.append 改局部变量写法，避免方法解析错位写穿内存 
链式 func.Params.append() / func.Blocks.append() / block.Lines.append() 会被编译器解析成 LinkedNode.append 且 this 前移 sizeof(LinkedNode)（兄弟 Mixin 兜底误匹配），写穿 GSList 容器前 48 字节破坏数据结构 → LLvmLiteTest Test 3 崩溃（AddParam/CreateBlock/build_add 后链表损坏，PrintFunction/RenumberSSA 遍历垃圾指针）。

改为局部变量 + 类型参数写法（对齐 function_move_block_to_end 既有正确模式）。
 2026-08-20 16:45:19 +08:00
TermiNexus d698fad162 fix(TPC): 泛型基础类型字段访问特化，修复 GSList.Head 返回泛型占位 T* 
_handle_attr_nested 对声明为特化泛型（GSList[BasicBlock] | t.CPtr）的字段（如 Function.Blocks）访问 Head/Tail/Count 时，基础 GSList 有 body 直接按基础类型返回泛型占位 T*，AnnAssign 存储时变量被污染为 T*（var_struct_class 错设为 T），后续字段访问/while 循环体翻译静默失败 → llvmlite __function.vp _find_max_ssa_number/RenumberSSA 死循环（LLvmLiteTest Test 3 崩溃根因）。

修复：字段类型为泛型占位指针时，用 class_member_element_class 记录的特化版本 bitcast 后访问返回真实元素类型（如 BasicBlock*）；AnnAssign 兜底跳过泛型占位参与变量类型重建，防其它 T* 场景污染。
 2026-08-20 15:35:21 +08:00
TermiNexus 3fd875daca fix(exprcall): 兄弟 Mixin 兜底过滤泛型特化类名——防误绑定 list 特化函数 
与 TPV CallGenCall.vp 086e792 同根因：JsonValue.__getitem__ 在 found_func 未命中时被兜底遍历 class_methods 误绑到 list[ASTptr].__getitem__ 特化函数，this 按 list 布局前移 sizeof(list) → 运行期读 -1 崩溃（Config.vp root.__getitem__）。候选类名含 '[' 时跳过。
 2026-08-20 11:27:13 +08:00
TermiNexus f2cdbdc70f fix(exprlen): 剥离 sha1 前缀修复 len() 分派失效 
class_members/class_member_element_class 的 key 为裸类名，而 _CurrentCpythonObjectClass 可能带 sha1 前缀导致 gate miss 落到 strlen（stdint.vp 0xC0000005 根因）。同时按字段静态类型沿 MRO 分派 list.__len__，并移除排查期诊断 printf。
 2026-08-20 10:28:29 +08:00
TermiNexus bd5d2467ab fix(exprcall): NoVTable 跨 Mixin self. 调用按定义类解析 + this 前移 
缺陷（TPV bootstrap 的 undefined symbol: <sha1>.StmtGenDeclMixin.translate_return
同根因）：NoVTable 多继承下，BaseB.caller 内 self.helper()（helper 定义在兄弟
Mixin BaseA，经 Combined(BaseA, BaseB) 组合）被 mangle 成 BaseB.helper —— 用
调用者类做前缀，而定义符号是 BaseA.helper -> ld.lld undefined symbol。

修复（HandlesExprCall.py）：
1. 调用端 MRO 回退失败后，全局扫描已注册类找方法定义类（兄弟 Mixin 兜底）；
2. _adjust_this_for_inherited_method 支持"调用类不含定义类字段"场景：
   this 按组合布局前移 sizeof(定义类 struct)（BaseB* -> BaseA*）。

新增 Test/NoVTableCrossMixinTest 回归（caller()==42 通过），TestsOverview 记录。
 2026-08-20 10:23:47 +08:00
TermiNexus 015d5c38ea fix(global): external 声明升级用 initializer 判空（llvmlite.ir 无 is_declaration 属性） 
上次修复用 getattr(g, 'is_declaration') 判断声明态，但该属性仅在
llvmlite.binding 层存在，ir.GlobalVariable 没有 -> 恒 False -> 升级不生效，
_g_gen 依旧无定义。改用 initializer is None 判断（external 声明必无
initializer；已定义全局必有），验证 common + null initializer 可设。
 2026-08-20 07:53:33 +08:00
TermiNexus c904fac54d fix(global): import 注入的 external 全局声明遇本模块定义时升级为 common 
根因：_EmitExternalGlobalDeclLlvm 把被 import 模块的下划线私有全局
（如各 Handles 模块 _g_gen）以裸名 external 声明注入本模块 module.globals，
_EmitGlobalAnnAssignLlvm 的"VarName in module.globals"误判已存在而跳过定义
创建 -> 全工程 _g_gen 无定义 -> ld.lld undefined symbol: _g_gen。

修复：定义端检测到 existing_gv 是 external 声明（is_declaration）时，
升级为 common linkage + null 初值（多模块同名合并为零值，对齐 _mbuddy
模式），而非静默跳过。
 2026-08-20 07:46:36 +08:00
TermiNexus 485ab0d329 docs(todo): 记录 list[ptr].append 运行期读零页崩溃待查 
编译问题已解（2f0d52e 系列），但 list[ptr].append 运行期崩溃（读零页
0xf8/0x128/0x148）未根修：构造插桩确认 pool 有效 elem=8，差异在
item:t.CPtr 参数/lem_ptr[0]=item store 生成。当前 BuildPipeline 用
list[str] 绕开（TPV dc5bb21）。
 2026-08-19 23:35:12 +08:00
TermiNexus c02f7dbaf1 fix(gentype): _HandleSizeofLlvm 的 CType.POINTER 改 t.CType.POINTER 
CType 未导入 HandlesExprCall.py，6ff76f3 引入 NameError。t 模块已导入，
改用 t.CType.POINTER。
 2026-08-19 22:52:49 +08:00
TermiNexus 6ff76f3cb6 fix(gentype): t.CPtr.__sizeof__() 返回 8 修复 list[CPtr] elem_size=0 
CPtr 无显式 Size（t.py class CPtr 未设 Size）→ GetClassByName 路径
size_bits=0 → t.CPtr.__sizeof__() 返回 0 → list[t.CPtr](_mbuddy) 单参
构造时 elem_size=0（T.__sizeof__() 分支）→ append 崩溃（ASAN: 读 0xf8
零页，pool.alloc 处）。GetClassByName 路径补 POINTER 判断：HasPosition
(POINTER) 且 size_bytes==0 → 8（指针大小，与 str/bytes 一致）。
 2026-08-19 22:49:37 +08:00
TermiNexus 2f0d52e736 fix(gentype): list[t.CPtr] 特化与 list[对象] elem_size 根本修复 
两处根因：
1. list[t.CPtr] 报 Undefined method 'append'：
   - _resolve_generic_slice_type 对 t.CPtr 返回裸名 'CPtr'，type_map['T']='CPtr'
     替换进模板（item: CPtr）后 CPtr 不在顶层作用域 → append 声明注册失败
   - 改保留带前缀 't.CPtr'（可解析）
   - 查找端（SymbolUtils.FindStructNameInAnnotation）与声明端
     （DeclarationGenerator）的 CPtr 统一规范化为 'ptr'，与特化端
     _mangle_generic_class_name 一致（list[CPtr]/list[i8*] vs list[ptr]）
   - _specialize_generic_class 的 cptr_params/class_type_names 判定改 tn_bare
2. list[对象] elem_size=0（get(0)==get(1) 同槽根因）：
   - T.__sizeof__() 特化后为 'X | t.CPtr'（BinOp 联合），_HandleSizeofLlvm
     对 BinOp 落到 else 返回 0 → list.__elem_size__=0 → 元素全写同槽
   - 改含 t.CPtr 的联合类型返回 8（指针大小）
 2026-08-19 22:44:15 +08:00
TermiNexus e82640ac94 fix(gentype): c.Deref 类型推断支持转换包裹与联合全 side 
_infer_deref_target_type 仅在 Deref 为赋值直接 RHS 时推断加载类型，
被类型转换链包裹（如 (T | t.CPtr)(t.CPtr(c.Deref(p)))）时返回 None →
回退 load 1 字节 → 读回垃圾指针（BuildPipeline run_llc_parallel 存
Thread* 后 join/is_alive 失效、llc 并行 5 秒误报失败的根因）。
增强：新增 _IsCastWrappingDeref 放行"转换链包裹 Deref"（ifexp/binop
仍不放行）；联合注解（A | B）遍历全部 side，取第一个可解析类型。
 2026-08-19 21:14:13 +08:00
TermiNexus 0db1ccd1bb refactor(asan): TPC_ASAN 环境变量改 args 直传 
--asan 不再写 TPC_ASAN 环境变量，改为 Config 解析后直接经
asan_mode=args.asan 传给 Phase2Translator（主进程 .ll→.obj 插桩与
链接 -fsanitize=address 均读 self.asan_mode），消除环境变量在
worker 子进程/外部调用链下的不可靠性。
 2026-08-19 08:47:32 +08:00
TermiNexus e83c06041a fix(ast): 解析器支持括号内行首运算符跨行续接 
and/or 与 binop/比较链循环此前在检查运算符前不跳 Nl：
A and B 换行后再 and C（ThreadingTest check 多行 and 链）停在 Nl 上
循环退出，上层把续行运算符当非法 token 报 SyntaxError。每轮循环先
_skip_nl 再查运算符（对齐 vast 实现），支持 (a\n + b)、(a < b\n < c)
等行首运算符续行。
 2026-08-19 06:52:20 +08:00
TermiNexus 197a7f3314 test: 新增 ThreadingTest vthreading 专项测试 
覆盖 Thread(start/join/is_alive/get_exit_code/传参)、Lock 多线程互斥、
Event 唤醒、Condition 生产者/消费者、RWLock 多读单写、TLS local、
get_current_thread_id/sleep_ms，以及 stdlib.system 多线程并发调用。
 2026-08-19 06:42:32 +08:00
TermiNexus 73e5eea3f0 fix(llvmlite): create_block 块名与参数名冲突去重 
LLVM 中块标签 entry 即值 percent-entry，与参数 percent-entry 重名导致 llc
unable to create block named entry（CallGenCall._field_byte_offset 的 entry
参数根因）。create_block 创建块时扫描函数参数值名（剥离百分号前缀），
冲突则追加 .1/.2 后缀，覆盖全部 7 处入口块创建点。
 2026-08-19 05:54:11 +08:00
TermiNexus 915054495f fix(ast): 补齐 exprs 字段访问辅助函数 re-export 
5cda173 只补了 attribute_get_attr，TypeGen 还以 ast.<helper> 调用
attribute_get_value/name_get_id/constant_get_str_val/binop_get_left/
binop_get_right（均定义在 ast.exprs）→ 同样触发跨模块返回类型解析
fail-fast。一次性全部补入 from .exprs import 导出列表。
 2026-08-19 05:26:26 +08:00
TermiNexus 5cda173a5e fix(ast): re-export attribute_get_attr 修复跨模块返回类型解析失败 
TPV TypeGenCType/TypeGenResolve 以 ast.attribute_get_attr(at) 调用，但 ast
包 from .exprs import (...) 未 re-export 该函数（定义在 ast.exprs）→ 跨模块
函数返回类型解析在 ast 包 text.ll 找不到定义 → fail-fast "返回类型无法
精确获取"。按既有 re-export 惯例（如 get_parse_err_line）补入导出列表。
 2026-08-19 05:18:41 +08:00
TermiNexus 267e9881b4 perf(structgen): finalize 特殊字符 struct 名加引号合并为单次 re.sub 
逐 name 全文本 re.sub 改为单正则 alternation 一次扫描，消除 N 次 O(text) 扫描（lookahead 边界保证备选互斥，语义等价）
 2026-08-19 00:32:21 +08:00
TermiNexus fbd132284b perf(phase2): 按 PROF 热点优化编译耗时 
- HandlesImports: _TryLoadClassMembersFromPyi 复用 _pyi_cache 跳过重复 isfile（-12.8s）；_LookupStubFuncType 类级缓存 + 签名增量扫描新增 stub，去掉每文件 isfile（-6.5s+）
- Phase2Translator: pyi cache 仅主进程构建（worker 只读 pkl，-23s+pickle 10.4s）；include 源文件 sha1/存在性缓存消除 _build_current_ModuleSha1Map 重复磁盘 I/O
- StructGen.finalize: 行过滤改 startswith(tuple) 预计算，消除 O(lines×structs×patterns) 嵌套循环（tottime 84.8s → 预期数秒）
- 附带 fail-fast（任意文件出错立即终止）+ 子进程 PROF 硬编码
 2026-08-19 00:28:40 +08:00
TermiNexus 1808e90fd3 feat(projectrans): 主进程 PROF 自动落盘 + 编译耗时统计 + 分析脚本升级 
- Projectrans.py 入口包 cProfile，整次编译自动导出 main_prof_{pid}.prof 到 ./PROF；成功/失败均输出 [TIMING] 总耗时（stderr）并落盘 main_time.txt
- Config.py 新增 --asan（透传 TPC_ASAN=1）+ 每次编译自动清理 PROF 目录 *.prof
- PROF/1.py 升级为综合报告（tottime/cumtime top + callers 定位 + 模块聚合 + 上次编译耗时）
 2026-08-19 00:28:18 +08:00
TermiNexus bdc5ec3e88 fix(HandlesImports): 跨模块展平父类无条件 force 重载，消除并行 worker 布局不确定 
并行 worker 中 class_members[Generator] 曾出现 83/85/88/89/105/106 vs 114
的不确定变体：父类在某次展平时祖先未加载完成即被冻结为部分成员，guard
（成员非空即跳过）又阻止重载 → this_adjust 按不完整 members 计算字节偏移
→ 继承方法 self 错位 → 运行时越界崩溃（FuncTest is_exception_name strcmp，
错位 68 字节）。

修复：
- 父类加载循环无条件 force 重载：_TryLoadClassMembersFromPyi(force=True)
  先清空该类 class_members/defaults/signeds/bitfields/byteorders/bitoffsets
  再重建，字段顺序与定义模块 stub 一致；对其祖先递归同样强制重载，
  最终所有 worker 展平结果确定性一致。
- 已加载父类经 class_sha1_map 直连定义模块 sha1 强制重载（O(1)），
  避免对每个父类全量扫描 ModuleSha1Map。
- _TryLoadClassMembersFromPyi 返回 bool（找到即停），移除 [DIAG-EXT] 诊断。
 2026-08-18 14:38:06 +08:00
TermiNexus 858aba46d0 fix(HandlesImports): _seen_flat_cls 移到父类循环外，菱形去重真正生效 
b021c5b 的递归展平把 _seen_flat_cls 定义在 for _ParentClass 循环内，每个父类新建 seen → 菱形祖先(ClassGenBase)被每个继承它的 ClassGen* 父类各展平一次 → Generator class_members 707 字段(与 struct 114 不一致) → this_adjust sub_off 索引越界 → 继承方法不调整 → register_reexport 写 0x3f 崩溃。运行时诊断确认(707→114)，register_reexport 调用生成正确 this_adjust(GEP +776)。已移除全部临时诊断。
 2026-08-18 14:04:33 +08:00
TermiNexus b021c5b527 fix(HandlesImports): 跨模块 class_members 展平同步按继承源去重 
81ad712 只同步了 HandlesClassDef(运行时) 与 DeclarationGenerator(stub struct)，遗漏并行 worker 跨模块重建路径 _EmitExternalClassDeclLlvm：仍用旧拼接+按字段名过滤算法，菱形继承下与 stub struct 布局不一致，worker 中 this_adjust 算不出偏移，继承方法 self 不调整，运行时错位崩溃(register_reexport 写 0x3f)。改为递归按继承源去重，与 HandlesClassDef._FlattenInherited 一致。
 2026-08-18 13:44:22 +08:00
TermiNexus 97b714603d fix(HandlesExprCall): this_adjust 字段偏移计算剥离 sha1 前缀 
register_reexport 等继承方法调用时 ClassName 带 sha1 前缀（如 e1ea7eaf63a9c3d1.Generator），而 class_members 的 key 是裸类名 → _compute_field_byte_offset 查不到字段 → this_adjust 被跳过 → 继承方法 self 不调整 → 方法内按 ImportsGenMixin 独立布局(0-3)访问 Generator 内存错位 → ReexportSrcs 读到 null 后写 [63] 越界（ASAN 写 0x3f 崩溃）。修复：查 class_members/structs 前剥离前缀（对齐 _EnsureClassParentsLoaded 做法）。
 2026-08-18 13:32:01 +08:00
TermiNexus 7c6a497111 fix(DeclarationGenerator): 按自有字段展平时补齐祖先 vtable 指针 
_FlattenInheritedDecl 递归只取类自有字段，而原 _get_inherited_members 返回完整 struct 天然含 vtable。改造后 Module(AST CVTable) 等子类 struct 缺 vtable 指针 → 字段错位 → 编译报 'cannot store i8* to %AST**'（写 vtable 到 parent 槽位）。新增 _ShouldEmitOwnVtablePtr 判定，递归各祖先类时在自有字段前补齐 vtable。
 2026-08-18 13:19:51 +08:00
TermiNexus 81ad712475 fix(Handles): 多继承字段展平按继承源去重，消除菱形重复 
Generator 同时继承 ClassGenMixin/ClassGenEnum/ClassGenGeneric/ClassGenVTable/ClassGenDef/ClassGenBase，而前 5 个都继承 ClassGenBase → ClassGenBase 41 字段被重复展平 6 次（struct 707 元素），class_members 索引与 struct 布局错位 → 跨 Mixin 方法 this_adjust 失效 → is_exception_name 读错位内存 strcmp 越界（ASAN heap-buffer-overflow）。

修复：HandlesClassDef 与 DeclarationGenerator 的多继承展平改为递归按继承源去重（每类只展平一次，只取自有字段；同名字段如 TempDir 跨非继承 Mixin 仍各自保留，避免 2026-08-10 历史去重缺陷回归）。
 2026-08-18 13:13:25 +08:00
TermiNexus 2922af79f1 fix(LLVMCG): 禁止对 null 指针常量做 load 转 int 字段 
_coerce_value 中 target 为 IntType 且 val 为 PointerType 时，若
val 是 null 常量且 pointee.width == target.width，此前直接
builder.load(null) 生成 load i32, i32* null，运行时 ASAN
access-violation。根因场景：Generator.__init__ 里
self.ClassMetaKinds = None（字段注解 t.CInt | t.CPtr，联合类型
退化为 i32 槽位，None 解析为 i32* null）。修复：null 常量赋 int
字段直接返回 0；_store 的 null 分支同步补 IntType 处理。
 2026-08-18 12:50:31 +08:00
TermiNexus 0e80019033 fix(subscript): 泛型 T|t.CPtr 指针槽变量优先走 i8** load，修 8fbba list[str].get 返回类型不匹配 
TPC 编译 TPV 时 _list.vp 泛型方法体 elem_ptr: T|t.CPtr = t.CPtr(...)：
T 未解析时 var_struct_class[elem_ptr] 误注册 llvmlite.Value →
_HandleSubscriptLlvm 的 elem_class 推断为 Value → cast Value* → 与
get 声明 i8* 不匹配（llc 报错）。修复：
1. _is_struct_ptr_union 放宽——泛型参数 Name（单字母大写）也判定指针槽
   联合（标量 T 退化为 Ptr(i32) 不命中 i8 分支，安全）
2. _HandleSubscriptLlvm 的 var_ptr_element 分支提前到 elem_class 推断
   之前——T|t.CPtr 指针槽变量优先 i8** load i8*（8 字节）
 2026-08-18 10:12:06 +08:00
TermiNexus a2378e6878 chore(ast): Attribute.__init__ 加构造断点，定位 stdint.vp attr 垃圾来源 2026-08-18 09:25:36 +08:00
TermiNexus 802377e9ab feat(ast): 加 Name/Attribute/Constant/BinOp 字段访问器，绕开跨模块 stub 字段访问陷阱 2026-08-18 08:59:10 +08:00
TermiNexus 4f95867209 fix(llvmlite): PrintModule param_scan 改用访问器绕开 stub 字段访问陷阱 
printf.fmt Param 创建后 next=0（正常）、dump_ir 诊断访问器读 next=0，
但 PrintModule 直接访问 param_scan.Next 遍历超限死循环——同一指针两次
读取结果不同，指向跨模块 stub 字段访问生成错误 GEP/静默跳过
（param_scan 永不更新 → 死循环）。param_scan 遍历改用 param_get_next/
param_get_ty（__function.vp 完整类型内读取），并打印首节点 param/next
供对比验证。
 2026-08-18 08:26:38 +08:00
TermiNexus 37e6dd1863 feat(llvmlite): 加 module_get_func_head 跨模块访问器，供 dump 诊断遍历函数链 2026-08-18 08:17:51 +08:00