GVSDS/TransPyC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
237 Commits 1 Branch 0 Tags
63bc435723a526c573d9f05de52f95d48d7308de
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
TermiNexus 63bc435723 feat(tpc): 注解支持 C 风格指针后缀 T*（int* → int | t.CPtr 多级展开） 2026-08-28 08:01:03 +08:00
TermiNexus 0230385891 feat(tpc): 新增单目 * / & 运算符（Deref/AddrOf）AST 节点与 LLVM 翻译 2026-08-28 07:34:58 +08:00
TermiNexus d6150bd595 工作提交，增加 Test 2026-08-28 05:59:47 +08:00
TermiNexus e376b949c9 fix(memhub): 移除 free 记录前标记校验——合并重分配误报（与 w0/w1 同类） 
下溢写误报实锤：1024B free 块 hdr=0x0、同 ptr 仅一条 F 记录、前标记被写零——块合并进更大块后新分配用户区覆盖旧记录前标记区而旧块头仍为 0，前标记校验原理性不可靠（SlotsBugTest 1024B 块误报例）。

移除 free 记录全部校验，只保留 active 记录前/后标记校验（存活块独占，header LSB=1 不会合并，可靠）。
 2026-08-25 17:21:27 +08:00
TermiNexus c9ccea4014 feat(memhub): 下溢写打印增强——块头/记录index/上下文/同ptr记录 
SlotsBugTest 越过 can 问题后新信号：free 块前标记(block+8..9)被写零（前标记区是安全区，子块边界2^n>=32永不落此，free-list写只在block+0..7）→ 真实下溢/UAF写。

增强打印：hdr 块头值（判断 free-list 状态）、记录 index、±3 上下文记录、同 ptr 记录（F/A 标注），一次运行定位写入者。
 2026-08-25 17:17:29 +08:00
TermiNexus 3ac48282a3 feat(callgenctor): 构造参数列表头+槽位 0xCDCD 诊断 
ASAN 崩溃 node=0xCDCDCDCDCDCDCDCD（_translate_struct_ctor → translate_value）确认：is_alive(cargs) 只验列表结构体，get() 读的是 __data__ 数组——两者都可能未初始化（MEMBUDDY_FILL_GUARD 无条件填 0xCD）或悬空。

新增：读取列表头（__data__@0 __count__@8 __capacity__@16），命中 0xCDCD 打印定位 fail-fast；预检每个实参槽位 0xCDCD 并打印 ai/can/data/count/cap。区分列表未初始化 vs 槽位悬空两种根因分支。
 2026-08-25 16:29:48 +08:00
TermiNexus 7c7629852a perf(memhub): detection 采样探测，O(n²) 降为 O(n²/256) 
每次 alloc 全表扫描（分配重叠 + _det_probe）是 O(n) ，2M 次 alloc = O(n²)，detection 模式过慢。

改为每 MEMBUDDY_DET_PROBE_PERIOD(256) 次 alloc 采样扫描一次；记录追加保持 O(1)。损坏是持久性的，不依赖即时扫描，检测能力不损失。
 2026-08-25 16:21:34 +08:00
TermiNexus b777d7c925 fix(memhub): 移除 free 记录 0xCD 完整性校验，消除 buddy 自写误报 
free 记录 w0/w1 校验验证 free 后用户区 0xCD 完整，但 buddy 分配器 free 后会把 next 指针/子块头合法写进 free 块（free 块用户区即管理区），0xCD 必然被破坏 → 持续误报（SlotsBugTest 4352B 块首 8B=0x400000000、前标记完好的误报例）。

只保留可靠的前标记校验（子块边界 2^n>=32 对齐永不落在 block+8）。0xCD 填充保留。探测器可推进到 Phase2 用 is_alive 抓真实 KwEntry cargs 读取型 UAF。
 2026-08-25 16:16:02 +08:00
TermiNexus 0f6ebb9065 fix(memhub): detection 记录表随 reset_to/reset 截断 
reset_to/reset 只把块归还 free list、从不清理 _det_records，导致 reset 后旧记录仍标 active：下一轮 alloc 复用同一块被误报为分配重叠/越界写（SlotsBugTest 7B buf + 72B Token 误报根因），探测器在 Phase1 扫描就 exit(1)，永远走不到 Phase2 的真实 UAF 检查。

修复：reset_to(mark) 同步截断 _det_count=mark（与 chk_depth 等长，每次 alloc 各追加一条、free 只置标志不删），reset() 置 _det_count=0。
 2026-08-25 16:05:21 +08:00
TermiNexus 74ed6f2dbc feat(memhub): 分配重叠即时检测 
SlotsBugTest 崩溃实锤：同一块被重复分配（记录表同 ptr 两条，[353]sz=7 与 [10298]sz=72）——7B 字符串缓冲与 72B Token 重叠，Token 初始化覆盖 buf 导致越界写，KwEntry cargs 只写 0/40 根因。

根因指向 MemBuddy free list 损坏（active 块混入 free list）。新增检测：每次 alloc 前将新块地址与 active 记录比对，命中即打印两个 size 并 exit(1)，在第一次重叠处拦截，便于回溯具体分配调用。
 2026-08-25 16:01:07 +08:00
TermiNexus 49feb6a2b4 feat(memhub): [DET] 越界写追加同ptr记录检测 - 扫描记录表找同一 ptr 的多条记录，验证 alloc 重叠（Token 72B 与字符串 buf 7B 共用块 → 互相覆盖），定位 size=7 块被当 Token 写的根因 2026-08-25 15:57:45 +08:00
TermiNexus d3a84c25e0 feat(memhub): [DET] 越界写追加记录表上下文 - 打印越界块前后各3条 {ptr,size}，推断分配阶段（如 lexer/parser 小结构），配合越界区数据定位 size=7 块写入者 2026-08-25 15:53:44 +08:00
TermiNexus 878840a081 feat(memhub): [DET] 越界写追加打印越界区24字节 - 判断写入者写多长/方向（0x00=写穿 0xCD=未写 其它=写入值），定位 size=7 块 {10,1} 越界写源头 2026-08-25 15:51:24 +08:00
TermiNexus e48f2104ff feat(memhub): [DET] 越界写打印块内容前16字节 - 定位 size=7 块被越界写的写入者（扫描 includes 阶段，后标记被写 0x0000） 2026-08-25 15:47:04 +08:00
TermiNexus fe98b5048e fix(memhub): __init__ 显式初始化 detection 字段防默认值失效 - TPC 类字段默认值对 CDefine 常量可能不生效，detection_size=垃圾 → malloc(垃圾) 1-byte 记录区 → 扩容 realloc double-free(ASAN 捕获)；显式赋值 detection_size/MEMBUDDY_DET_RECORD_SIZE + _det_arena/_det_records/_det_count/_det_cap 2026-08-25 15:43:54 +08:00
TermiNexus 40f10f6348 fix(memhub): detection 记录表满时 realloc 扩容 - 原 32MB/16B=2M 条满后新 alloc 无记录，is_alive 误报读取悬空（hdr=0x5 活跃块不在记录表）；改为 stdlib.realloc 翻倍扩容（对齐 chk_stack），保证 is_alive/_det_probe 全程覆盖 2026-08-25 15:39:09 +08:00
TermiNexus b3b82a8093 feat(tpc): [DET] 读取悬空打印 cargs 指向块头 - is_alive 拦截时输出 cargs/block/hdr（0=已free UAF实锤 奇数=活跃但记录表异常 其它=非pool块），定位 KwEntry cl.args 悬空源 2026-08-25 15:35:28 +08:00
TermiNexus fefc1e8343 feat(memhub): 读取侧存活校验 is_alive - 补 detection 写入检测盲区：struct_ctor 读 cargs 前校验 cl.args 是否在记录表 active 记录中，不在即 [DET] 读取悬空 打印 cargs 值并终止；拦截 use-after-free 读取（SlotsBugTest KwEntry cargs=cl.args 悬空根因），detection==0 时 is_alive 恒返回 1 不拦截 2026-08-25 15:31:39 +08:00
TermiNexus 1de7c8d2ca chore(tpc): 移除全部临时 DBG 日志 - VDBG(ExprGenMixin)/CTORDBG(CallGenCtor)/LISTDBG(_list)/ALLOCDBG+set/get_debug_log+set/get_alloc_src(memhub)/CLDBG+[DEPDBG](CallGenMixin)/--enable-debug-log(main)/set_alloc_src(HandlesTranslator)；保留 detection 机制(前后 0xCDCD 标记+记录表探测)与 MEMBUDDY_FILL_GUARD 守卫 2026-08-25 15:17:51 +08:00
TermiNexus 769ffda04f feat(memhub): detection 补前标记探测（对称拦截下溢写） - active 记录验证返回ptr-2 处 0xCDCD，free 记录同样验证前标记+用户区 0xCD；与后标记上溢检测、free 填 0xCD 的 UAF 写入检测构成完整三方覆盖 2026-08-25 15:12:48 +08:00
TermiNexus 91120ae00a feat(memhub): detection 增强 - free 后用户区填 0xCD + 记录保留并置 free 标志，探测时对仍 free 的块验证 0xCD 完整（首末 8 字节），被写穿即 [DET] UAF 写入 报警终止 - 拦截 use-after-free 写入（如 SlotsBugTest KwEntry cargs 块 free 后被部分覆盖），与后标记越界写检测互补；块被重新 alloc 后块头变奇数自动跳过旧 free 记录防误报 2026-08-25 15:02:14 +08:00
TermiNexus 0efd438bfb feat(main): --detection 命令行开关应用 MemBuddy 分配检测到双池 - 创建内存池前用 GetCommandLineA 扫描 --detection（sys._init_argv 依赖 mb 不能提前），mb(1GB) 与 perm_pool(512MB) 均传 detection 布尔；detection 数据区大小硬编码 32MB(memhub MEMBUDDY_DET_RECORD_SIZE)；argparse 注册 --detection 帮助项 2026-08-25 14:59:21 +08:00
TermiNexus c559c0f2d6 feat(memhub): MemBuddy 分配检测机制（detection 开关） - alloc 布局改为 [0xCDCD][size][0xCDCD]（实际多 4 字节，返回指针后移 2 字节，free/realloc 前移 2 字节回收）；每次 alloc 记录 {返回ptr,size} 到独立 32MB 记录区（stdlib.malloc，默认 detection_size=32MB），随后探测全部存活块后标记——被破坏即越界写，汇报 ptr/size 并终止；free 时移除对应记录防块复用误报。定位 SlotsBugTest KwEntry cargs '存活块被部分覆盖' 的写入者（ASAN/Valgrind 对自研池透明，此机制补齐池内越界写检测盲区）。MemBuddy(arena, size, detection=1) 开启，默认 False 2026-08-25 14:56:04 +08:00
TermiNexus 21e67cac40 fix(tpc): 含 raise 函数调用参数补全排除 EH 输出参数，杜绝双重注入 - CallGenMixin 零值兜底与 CallGenCall found_func 参数数回退原将 %__eh_msg_out__/%__eh_code_out__ 计入形参数，为 raise_disk() 无参调用补 2 个 zeroinitializer 占位，_emit_eh_guarded_call 又追加真实 EH 实参 → call 4 参 vs define 2 参 → x64 ABI 错位 → 函数写 null 输出指针 0xC0000005(TestFBProject raise_disk 崩溃根因)；三处计数均排除 EH 参数 2026-08-25 14:04:27 +08:00
TermiNexus 916c1284c9 fix(tpc): 虚调用 vtable 布局按接收者静态类型解析而非 this 调整后父类指针 - _do_virtual_call 原用 self_ptr.Ty 解析 vc_entry，多继承中 self 被 bitcast 成父类指针(如 ColorM*)后得到父类单槽 vtable 布局(method_index/method_count 按父类算)→ GEP 槽位 0 读到 area 而非 color_code(MultiInheritTest color_code 虚调用 FAILED 根因)；改优先用 vtable_base(对象头)类型解析，未传 vtable_base 时回退 self_ptr 保持原行为 2026-08-25 13:53:56 +08:00
TermiNexus 3100bb9343 feat(memhub,list,llvmlite): 0xCD 分配守卫、诊断开关与 INT64_MIN 常量修复 - memhub.vp alloc 填充 0xCD 哨兵 + set_debug_log/get_debug_log + ALLOCDBG 分配者记录; _list.vp __init__/append 诊断; llvmlite i64 INT64_MIN 输出无符号位模式(LLVM 拒绝 -9223372036854775808 字面量)。定位 SlotsBugTest KwEntry cargs use-after-free 与常量 dump 错误 2026-08-25 13:19:08 +08:00
TermiNexus c3a43dfe76 refactor(includes): 标准库 extern 软关键字语法迁移 + _append_cstr O(1) 追加缓存 
- posix/stdio 等 19 文件: def ... -> T|t.State: pass 改写为 extern def ... -> T
- llvmlite/__builder.vp: _append_cstr 加写入位置缓存（_g_last_dst/_g_last_pos，缓冲切换/重置自动回退 strlen，防 O(n^2)）
 2026-08-24 23:31:12 +08:00
TermiNexus 50ca560563 fix(tpc): list 联合类型方法分派保护 + str 压平条件收紧 + external global 裸名兼容 
- HandlesAssign: 变量已有同 base 声明类型时不再覆盖 var_struct_class（sha1 前缀特化名覆盖裸名，导致 dbody.get 查表 miss 后 fallback 到 list[int].get，i32 返回值被截断成垃圾指针崩溃——TPC 侧根治）
- HandlesExprCall: IdentifiedStructType 真值判断改 is None（opaque 时 bool() 触发 __len__ assert）
- HandlesFunctions/HandlesImports: IsStr 压平条件加 PtrCount<=1，str|t.CPtr(i8**) 不压平；external global 正则兼容裸名格式
 2026-08-24 23:31:08 +08:00
TermiNexus 3b0a73db5e fix(tpc): _translate_file 以 out_path 文件名作 sha1，修复前缀漂移链接失败 - 原实现重读文件重算 sha1 覆盖 _module_sha1：主流程收集与翻译间隙文件变化时，函数定义前缀与文件名/调用方引用前缀不一致（696d41ca86e0a29a.BuildTopoSortedIndices 被生成成 5536… 前缀）→ ld.lld undefined symbol - 改为以 out_path 文件名（主流程 sha1）为准并告警内容变化，保证链接一致 2026-08-23 14:03:34 +08:00
TermiNexus 1dc23ffdde feat(tpc): llc 编译阶段日志带进度/源文件/耗时 
- 用户反馈 SUCCESS: xxx.ll 只有 sha1 看不到对应源文件与进度
- 改为 '[i/N] sha1.ll  源文件相对路径 (耗时s)'（sha1_map 反查源文件，提交时刻计时含排队）
 2026-08-22 08:05:19 +08:00
TermiNexus 7b04b72d4b feat(tpc): 翻译进度日志带源文件路径与耗时——并行时不再只有 sha1 
- 用户反馈并行分支日志只有 -> xxx.ll（sha1 无文件名无耗时），看不到进度
- _translate_file 加计时，打印改为 '-> xxx.ll  <源文件相对路径> (Xs)'（含仅声明分支）
 2026-08-22 07:41:58 +08:00
TermiNexus ebfaacf7bf fix(tpc): worker cProfile 默认禁用——环境变量 TPC_WORKER_PROF=1 开启 
- 之前 getprofile 互斥检查仍冲突（用户环境仍报 Another profiling tool is already active，viztracer --log_multiprocess 场景）
- 彻底修复：cProfile 默认不启用（TPC_WORKER_PROF=1 显式开启才启用），与 viztracer 等外部 profiler 完全解耦；开启时仍有 getprofile 让位 + enable 异常兜底双保险
- 冲突根源：Python 只允许一个 profiling tool 活跃，TPC worker cProfile.enable() 检测到 viztracer 注入的 profiler 即抛错 -> worker 崩溃 -> batch 异常 -> 编译终止
 2026-08-22 07:31:06 +08:00
TermiNexus c2f07e10cd fix(tpc): worker cProfile 与 viztracer 互斥——外部 profiler 活跃时跳过 
- 冲突机制：viztracer --log_multiprocess 经 sys.setprofile 注入 profiler 到 worker，TPC _ProfileWorker 的 cProfile.enable() 检测到已激活 profiler 抛 'Another profiling tool is already active' -> worker 崩溃 -> batch 0 异常 -> 编译终止
- 修复：_ProfileWorker 先查 sys.getprofile()，非 None（viztracer 等外部 profiler 活跃）时跳过 cProfile 让 viztracer 独占；正常编译（无外部 profiler）仍保留 cProfile（PROF 数据不受影响）
 2026-08-22 07:16:52 +08:00
TermiNexus d092b4d31f perf(tpc): 并行 worker 决策放宽——per_worker_mb 700 降至 350 
- 根因：_PickWorkerCount 按可用内存/700MB 决定 worker 数，实测翻译 worker 稳态 ~110MB/峰值 ~300MB，700 过保守——可用内存稍紧即整体降级单 worker 串行（76 文件逐个翻译 1180s vs 并行 ~400s，2-3 倍波动，用户反馈编译不稳定）
- 修复：per_worker_mb 700 -> 350（留峰值余量），更多场景走并行
 2026-08-22 06:54:56 +08:00
TermiNexus c62153a685 perf(tpc): import 热路径优化——walk 结果缓存 + DebugPrint 参数惰性化 
- import 兜底查找（_EmitModuleDeclarationsLlvm）每次解析失败都 os.walk 递归扫描 includes/工程目录，且多级模块名与 basename 永不匹配纯浪费：改为多级跳过 + 目录 walk 结果类级缓存（编译进程内目录不变）
- DebugPrint 调用点（HandlesTypeMerge 类型查询热路径）无条件构造 f-string 参数（含昂贵的 ast.dump），即使 DebugFile 未设置也执行：改为 getattr(DebugFile) 防护后才构造（单文件 profile：_io.open 1253 次 1.76s + DebugPrint cum 2.24s）
 2026-08-22 06:05:43 +08:00
TermiNexus daf79af1cc fix(tpc): 返回 fail-fast 豁免 void 联合注解与 extern/export 声明型函数 
- sprintf 误报：返回注解 t.CVoid | t.CExport（BinOp BitOr 联合）被旧判定忽略 -> 掉出末尾误报，且 [FATAL] 终止杀死 include worker -> BrokenProcessPool
- 修复：新增 _IsVoidOrDeclAnnotation 递归识别联合注解（注解中 | 表示 and）：void（None/t.CVoid）+ extern/export 声明型辅助符号（State/CExport/CExtern）均豁免
- 验证：t.CVoid|t.CExport / int|t.State / t.CVoid / None -> 豁免；裸 int -> 仍 fail-fast（missing_return 用例保持命中）
 2026-08-22 05:17:03 +08:00
TermiNexus 0e8283551c 修正 HandlesExprCall 的 import 2026-08-22 04:35:40 +08:00
TermiNexus 56a4b5c818 fix(tpc): stub 加载器解析全局变量声明——跨模块全局变量不再静默丢失 
- 根因：_LoadDeclarationsFromStubLlvm 只解析 struct/declare，忽略全局变量声明行，TPC 编译 TPV 时跨模块全局变量（StubMerger._sha1_store_count 等）从未嵌入 Gen.module.globals
- 后果：_lookup_module_global 恒 None -> return 静默跳过 ret（HandlesReturn 的 if Val 分支）、跨模块赋值静默丢失
- 修复：逐行循环加分支解析 16hex 前缀的 external global 声明（剥离 zeroinitializer 与 align 尾部修饰），用 _parse_llvm_type 解析类型后嵌入 external GlobalVariable；.str. 内部常量与 @main 等非 16hex 前缀跳过
- 诊断脚本验证 4 种真实 stub.ll 格式（struct 指针/数组/zeroinitializer/vtable 结构体）全部解析成功
 2026-08-22 04:21:04 +08:00
TermiNexus 4b0482657b fix(tpc): 返回 fail-fast 判据改为源码层面——显式 return 结尾不再误报 
- PopulateSha1MapStore 源码末句是 return（vast 解析 body[-1]=Return），但翻译后未 terminated（HandlesReturn L133 HandleExprLlvm 返回 None 时静默跳过 ret）被误判为掉出末尾
- 判据从 builder 状态改为源码结构：末句是 Return 或控制流（If/Match/While/For/Try/With）即不报错；只有末句是普通语句且非 void 注解才 fail-fast
- 静态检查（源码）与动态状态（builder block）分离，翻译层问题不该归类为源码掉出缺陷
- NegativeTest missing_return（末句 Assign）仍报错
 2026-08-22 04:13:43 +08:00
TermiNexus 09d03f4525 fix(tpc): 返回 fail-fast 误报修复——末句控制流掉出末尾不报错 
- 检查未区分普通语句掉出与末句控制流（match/if）掉出：match 翻译后停在合成 after 块（未 terminated）是机械产物，所有 arm 已 terminated 属正常（fatal_error + return None 样板），被误判为掉出缺陷
- 修复：Node.body[-1] 是 If/Match/While/For/Try/With 时豁免 fail-fast（符合隐式返回规则：末句控制流 -> unreachable）
- NegativeTest missing_return（末句 Assign）仍报错
 2026-08-22 04:08:43 +08:00
TermiNexus 3117ab3dec fix(tpc): import fail-fast 判据误报修复——文件系统找不到不等于模块不存在 
- TPV 自举工程 includes 为合并形态，源码模块（lib.Stub.StubMerger 包）不提供裸 .vp 文件，声明由 ModuleSha1Map 定位 sha1 -> temp/*.stub.ll 加载（_LoadDeclarationsFromStubLlvm，与 FullModulePath 无关）
- 原判据只看 FullModulePath 文件系统存在性 -> TPV 构建所有 import 误报 ImportError
- 改为：文件系统找不到时查 _source_module_sig_files / Gen.ModuleSha1Map（TPV 工程由 Phase2Translator._ModuleSha1Map 同步而来），模块有 sha1 注册即视为可解析
- 单文件编译两表皆空，NegativeTest 假 import 用例仍 fail-fast
 2026-08-22 04:04:30 +08:00
TermiNexus 0ce4a4d073 fix(tpc): import 路径/隐式转换/缺失 return 三项漏检 fail-fast 
- HandlesImports: 模块在所有来源找不到时 raise ImportError（原静默容忍导致跨模块 mangled fallback，链接期才暴露 undefined symbol）
- LlvmGenerator: import 处理 ImportError 直接重抛，不被 _ErrorStack 吞掉
- FuncGen: 指针→整数、浮点→整数隐式转换改 raise TypeError（显式 cast 仍允许，符合隐式转换规则）
- HandlesFunctions: 有非 void 返回注解但函数体掉出末尾 raise Exception（-> None / -> t.CVoid 视为 Void 仍合法）
- 新增 Test/NegativeTest 反向测试专项：9 个漏检用例，当前 9 PASS / 0 FAIL
 2026-08-22 03:57:19 +08:00
TermiNexus 567d925235 perf(tpc): PROF 热点优化——vast 节点 _Init unroll 特化 + isfile 结果缓存 
- vast/Nodes.py：_MakeNodeClass 动态生成 __init__，全位置参数路径按字段
  索引直赋（unroll，去 zip 迭代器），语义与通用路径完全等价
  （PROF：_Init 158 万次 29s 最大纯 Python 热点，实测 ~1.4x）
- Phase2Translator.py：新增模块级 _CachedIsFile（编译进程内文件状态稳定），
  替换全部 os.path.isfile 存在性检查（PROF：2.6 万次 16.4s）
 2026-08-22 03:08:29 +08:00
TermiNexus b7b17e0e7b 修正 main 的 import 2026-08-22 02:35:30 +08:00
TermiNexus 2f0ebc285b test(coro): 新增 TPV 协程 try/finally + 帧池 + c.Addr 句柄综合测试 2026-08-22 01:58:04 +08:00
TermiNexus 58594d4cf7 refactor(coro): Coroutine 改 @t.NoVTable，去掉无用 vtable（纯句柄语义） 2026-08-22 01:35:04 +08:00
TermiNexus 7d147c55e1 fix(mcp): 编译默认启用 --asan，tpv_build 支持 asan 参数 
- tpc_build/tpc_run_test/tpv_build/tpv_compile_project 的 asan 默认 true
- tpv_build 新增 asan 参数（编译器自身 ASan 插桩，崩溃时可输出报告定位）
- tpv_bootstrap Phase A 对齐 tpv_build 加 --asan
- includes/coro.vp: 裸 null 改 t.CPtr(0)（TPV 兼容，M1 遗留未提交）
 2026-08-21 23:02:16 +08:00
TermiNexus 44124b2f2f chore(mcp): .mcp.json 移入 MCP/ 目录，README 更新说明 
- git mv .mcp.json → MCP/.mcp.json（cwd 保持项目根，args 相对项目根解析）
- README 更新 .mcp.json 位置说明
 2026-08-21 22:06:17 +08:00
TermiNexus 39228d5654 chore(mcp): MCP 服务器移入 MCP/ 目录，新增 .mcp.json 客户端配置 
- git mv transpyc_mcp → MCP/transpyc_mcp；server.py ROOT 改为向上定位项目根（兼容新位置）
- 新建项目根 .mcp.json：transpyc-tools 直接以 python MCP/transpyc_mcp/server.py 启动
- MCP/README.md 更新服务器路径与快速接入说明
- smoke test 通过：initialize/tools-list(14)/tp_read_ast 调用链路正常
 2026-08-21 22:04:57 +08:00
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
TermiNexus 1805790336 fix(tpv): vpi 参数数上限哨兵 + declare 链遍历哨兵，定位 builtins.vp dump 卡死根因 
dump 步数哨兵已定位卡死链路为 printf 的 Params 链异常。新增：
1. VpiReader _inject_function_declare/_inject_method_declare 参数数上限
   128（fail-fast）：vpi tree 深层节点被覆盖损坏时 args_list.__len__()
   返回垃圾大数 → add_param 海量次 → Params 链超长，dump 误报成环
2. CallGenBase._ensure_method_declare FuncHead/Params 遍历步数上限
   （防 translate 期间死循环）
3. dump 哨兵报错增强打印 Params.Count，区分真成环与海量节点
 2026-08-18 08:10:02 +08:00