GVSDS/ViperC
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
874 Commits 1 Branch 2 Tags
main
Commit Graph
60 Commits
Author SHA1 Message Date
TermiNexus 42b094a575 refactor(viperc): 退役 t/c 模块标记，内建类型改由编译器直接识别 2026-10-18 12:56:57 +08:00
TermiNexus 3242560d02 支持 tls 关键字，全面准备清退 t, c 2026-10-17 23:40:06 +08:00
TermiNexus 508428bbc9 fix(viperc): 浮点常量按目标类型/声明宽度直接出 f32，不再先出 double 
- 浮点字面量在 f32 目标（float(1.5) / x: float = 1.5 / f32 形参）下直接物化 f32 常量，
  负号折叠（-c）同口径；去掉旧的「f64 常量 + fptrunc」
- CDefine 浮点条目记录宽度种类（1=f64 / 2=f32）：define PI: float = ... 的使用处
  直接出 f32 常量，与 f32 字面量混算不再被提升成 double（现场 33 处 cvtss2sd）
- 本模块注册 / pyi·vpi 跨模块重解析 / xmod 缓存三处都按注解裁决宽度，保持跨模块一致
 2026-10-15 18:35:48 +08:00
TermiNexus 32599a08c1 fix(stub): .vpi 读取侧复刻字段标记判定（volatile/pointee-volatile/const/字节序），跨模块不再丢字段标记 2026-10-13 12:30:23 +08:00
TermiNexus 4e46a25ab1 fix(gen): define 位宽/整数提升/移位/AugAssign 规则收敛，修 va_list 与 traceback 卡死 
- define 位宽：cdefine_decl_bits 单一裁决（注解 → 右侧强转 → 值最小可存宽度），定义方与 VpiReader 两处跨模块注册共用；lookup_cdefine_bits 取最后一条非零记录；存储即截断；使用侧改按声明位宽；通用求值器加编译期除零/移位越界 fail-fast
- 消除对无符号强转加宽方向的依赖：define_min_width 改 (value>>32)==0，截断改左移+算术右移，修 TPC/TPV 判定不一致导致 0x80000000 误判 64 位
- 整数提升：算术/移位、比较、一元 +/-/~ 提升到 i32；位运算保持同宽不提升
- AugAssign：y 有效宽度须 <= x、禁 y 显式有符号而 x 无符号；移位计数静态范围检查
- 函数入口复位 va_list 状态与 willFree 失效槽表（FuncGenDef/FuncGenMixin/VarGenMixin 等）
- BuildPipeline：traceback 逐行扫描改 span 判定，去掉对全文 strlen 的 O(n^2)
 2026-10-12 12:37:48 +08:00
TermiNexus c1d3f62bf0 fix(gen): ret(borrows=...) 支持 0 起序号写法（原来只认形参名） 
现场：@life(noescape(a, b), ret(borrows=1)) 报
LifetimeError: @life(ret(borrows=...)) accepts only a parameter name or `none`
—— _RetKindFromTag 的关键字分支只处理 Name（形参名）与 CONST_NONE，遇到整数常量
（形参位置序号）就落到 fail-fast。

修法：Name（形参名 / none）与 Constant（CONST_NONE = 非本帧）先分流，
其余一律交给 _WillFreeArgIndex —— 它本来就同时认"形参名"与"0 起序号"
（与 willFree(...) 同口径，见 includes/stdlib.vp 注释），非法实参在那边 fail-fast。
于是 ret(borrows=x) 与 ret(borrows=0) 等价可用。
 2026-10-10 13:27:24 +08:00
TermiNexus 1784eaf906 fix(gen): _WillFreeMergeTag 置位判据写反（is_wf != 0 → == 0），P2 willFree 全面漏检 
string.strcmp 相等返回 0，所以 `is_wf != 0` 的含义是"这个标签**不是** willFree"。原来的
`if is_wf != 0: mask |= 1 << idx` 于是：真正标了 willFree 的形参位**永不置位**，而任何别的
标签（noescape/escape/stores/borrows）反而把 willFree 位置 1。

实测证据（本轮编译产物）：
- EscapeXmodTest/.tpv_build/.../73b2b3ff01d73ce2.vpi（stdlib）第 9 行
  `def free(p: rawptr) -> t.State: pass` —— 连尾注都没有（wf_mask 为 0 ⇒ 不写 wf=）；
- EscapeOkTest/.tpv_build/.../4ccdbfc0e006b3d5.vpi 第 44 行 StoreNS（只标了 noescape）
  却写着 `# wf=1 escn=1`（反向误标）。

后果：跨模块 wf= 通道形同虚设 → 调用点从不"标记实参失效" → P2 全面漏检
（NewLifetimeWillFreeTest / WillFreeKwargTest / WillFreeMethodTest / WillFreeAddrTest 静默通过），
同时 NewLifetimeWillFreeOkTest 是**空过**（根本没有标记发生）。反向误标还可能造成假报。

回归来源：fc797da（A1 把三元 guard 扩成五元时把这行一起改反）。本行判据改为 is_wf == 0，
与同文件 @willFree 兼容分支（strcmp(...) == 0 即相等）的口径一致。
 2026-10-10 11:55:57 +08:00
TermiNexus 41674d125c fix(gen): 修 vpi 生成阶段 is_file_func 读到已回收池的悬垂表（ASan 野读崩溃） 
现场：TransPyV.exe（ASan）编译 EscapeOkTest 崩在 Phase A-pre-vpi →
_GeneratePyiFromAst → _PyiFunction → compute_escape_summary → _ScanEscapes →
_PushInductionEntry → is_file_func → HashTable._slot_hash
（access-violation on unknown address 0xffffffffffffffff）。

根因（潜伏已久，非本阶段语义改动引起）：
- FileClassNames / FileFuncNames / FileVarNames / FileModuleSha1 是按文件重建的表，
  表与键共用该文件的瞬时池；契约要求跨文件/跨阶段先清空再重建
  （原写在 reset_visible_structs 里那四行）。
- Phase A-pre-vpi 为生成 vpi 会重新 lex/parse 每个文件，但不走 register_file_*、
  也不清表 → _PushInductionEntry 的 is_file_func 只认 range 的判据，落在 Phase1
  最后一个文件的表上，而那个池已被 reset_to(mark1) 回收。非 ASan 下常表现为读到
  0/旧值 的静默错答，ASan 下 0xfd 填充 → 垃圾容量/垃圾 __slots__ → 野读崩溃。

修法：
- 抽出 reset_file_name_window() 作为文件级名字窗口的唯一开启入口（原四行清空搬进去，
  reset_visible_structs 改为调它），并在注释里写死契约。
- 新增轻量 register_file_func_names(pool, tree)：只重建本文件顶层函数名（核对过 vpi
  路径只需这一张；FileClassNames/FileModuleSha1/FileVarNames 的读取点全在翻译期）。
- Phase A-pre-vpi 循环里，在 _GeneratePyiFromAst 之前调用
  reset_file_name_window() + register_file_func_names(mb, tree_vp2)。
- register_file_classes / register_file_funcs 改为无条件重建（原来 没有才建 的写法在
  表已被别的阶段建过时会静默复用悬垂表）。
 2026-10-10 09:41:15 +08:00
TermiNexus 79d1c86982 fix(gen): return 本帧存储改为声明感知 fail-fast（A2 方案 A） 
A2 原本整体移除定义端 return <本帧地址> 的 fail-fast，导致无 @life(ret(...))
声明的函数返回本帧存储时静默通过（调用点只拿到 LIFE_UNKNOWN，悬垂一路无声）。
现改为按被调者自己的 ret 声明判定：
- ret(frame) / ret(borrows=<该形参>) → 放行；
- ret(heap|static|borrows=none) → 报错（声明与返回值矛盾）；
- 无声明 → 报错（提示补 @life(ret(frame)) 或 ret(borrows=<param>)）。
落点：AssignGenMixin.check_return_frame_decl（判据复用 life_of_expr，target_ty 传
返回类型，与移除前的口径一致）；ret_kind 由 StructGenMixin.get_ret_kind_by_func
反查 EscFuncTable → EscDirTable（顶层函数/方法/嵌套 def 一次覆盖，无需猜类名），
当前 FunctionDef 取 StructGenMixin.NllCurFunc。
新检查是旧检查的严格子集 ⇒ 自举无回归。
 2026-10-10 09:16:26 +08:00
TermiNexus 6da8e2e095 feat(gen): 落地 @life(ret(...)) 返回值生命期契约（A2） 
- GenApi：新增 compute_life_anno / _RetKindFromTag 与 RET_KIND_* 编码，
  提供 get_ret_kind / get_ret_kind_method / lookup_ret_kind_via_vpi；
  _WillFreeMergeTag 不再拦截 ret（改由 compute_life_anno 收集校验）。
- StructGenMixin：EscDirTable 由 3 槽扩到 4 槽（新增 ret_kind 列），
  compute_escape_summary 把契约落在 box[5] 并登记。
- Stub：.vpi 行尾新增 escr=<ret_kind>（Converter 写、VpiReader 读 _g_vpi_esd_r）。
- AssignGenMixin.life_of_expr(Call)：@life(ret(...)) 声明优先于任何推断；
  frame/heap/static/borrows=none 直接映射，borrows=x 取对应实参生命期，
  方法调用按接收者静态类型解析类名。
- StmtGenCifMixin：同批移除定义端 return <本帧地址> 的 fail-fast，
  返回值去向改由调用点按被调者契约判定。
 2026-10-09 22:58:33 +08:00
TermiNexus 6000734704 feat(life): A1——@life 新增 stores(x)/borrows(x)（复用 escape/noescape 契约位）；ret/owns 显式报未实现 
§14 路线 A 第一步（零语义变化）：
- stores(x) 归到"强制逃逸"位、borrows(x) 归到"强制不逃逸"位（同一对契约位，调用点已在最后套用、.vpi 已有 esce=/escn= 通道）
- _WillFreeMergeTag 白名单同步扩 stores/borrows；ret/owns 显式 fail-fast "not implemented yet (planned A2/A3)"，不做静默忽略
- 矛盾契约报文改为 escape/stores 与 noescape/borrows 两两对立
 2026-10-09 22:14:26 +08:00
TermiNexus 2bd37e80e3 feat(lifetime): 方法/构造器调用点也接 @life(escape/noescape) 最终裁决 
StructGenMixin: 新增 _DirForceOf / _DirForceMethod（查 "Class.method" 并沿 MRO 回退）与
get_param_escape_force_method / get_param_noescape_force_method；GenApi 加同名委托。

CallGenCall: 构造器分支（esc_mask_ci）与方法分支（esc_mask_mc）在跨模块回退、常量特化之后
最后套用一次 esc_mask = (esc_mask | escape_force) & ~noescape_force，与模块级函数那条口径一致。
 2026-10-09 20:34:34 +08:00
TermiNexus fc7c5d5560 feat(lifetime): @life(escape/noescape) 升为调用点最终裁决（契约不可被推断推翻） 
StructGenMixin: 新增 EscDirTable（3 槽/项：[名哈希, 强制逃逸位, 强制不逃逸位]），
_RegisterFuncEscapeSummary 把 compute_escape_summary 落在 box[3]/box[4] 的指令掩码单独落表
（与 EscTable 的"推断结果"分开）；新增 _DirLookup / get_param_escape_force / get_param_noescape_force。
compute_escape_summary 的指令输出缓冲由 g+68 改为 box[3]（同一内存，语义显式化）。

CallGenMixin: 在常量特化、同命裁剪、跨模块回退**全部做完之后**，最后套用一次指令：
esc_mask = (esc_mask | escape_force) & ~noescape_force。这样 escape(...) 不会被"死分支/同命"折掉，
noescape(...) 也不会被任何上游路径重新解释成"逃逸"。
 2026-10-09 20:30:03 +08:00
TermiNexus 8881dea2e2 fix(diag): 泄漏点采集改为"确认报错后才跑"，并保存/恢复扫描期状态 
原先在调用点的位循环里就调 escape_leak_line：该函数会重扫被调者函数体并改 EscConstEnv/EscIndCount，
而循环里可能紧接着发现"该实参其实不是帧生命期"从而不报错 —— 等于白白跑一遍扫描、还留下脏状态。
现在改成把 (被调者, 形参位) 传给检查方，过了 LIFE_FRAME 判定才采集；escape_leak_line 内部
把 EscConstEnv/EscIndCount/EscLeakWant 先存后还。
 2026-10-09 19:50:31 +08:00
TermiNexus 2353dca8ec feat(diag): 逃逸类 LifetimeError 追加 File lifetime leak 帧，标出泄漏点 
StructGenMixin: 新增 escape_leak_line——错误路径重扫被调者函数体，取指定形参的**首个逃逸点**行号；
_NoteLeak 在三处置位来源采集（字段/全局写、return 形参、传递闭包调用），新增 EscLeakWant/EscLeakLine。

Diag: DiagEntry 增加 LeakFileName/LeakLine + set_leak + emit_leak_frame（标签 File lifetime leak），
打印顺序 = 调用链 → 错误点 → 泄漏点 → 类别: 消息。

TypeGenErr.fatal_error / GenApi.fail_if_stack_addr_escape 增加 leak_file/leak_line 透传；
CallGenMixin 调用点按失败实参位取行号。**仅同模块**：跨模块 EscFuncTable 无 AST → 返回 0，不打该帧。
 2026-10-09 19:32:54 +08:00
TermiNexus c98730f717 refactor(diag): 精简 LifetimeError 报错词，去掉冗长从句 
逃逸主报文由三段长从句压缩为「frame-local + 悬垂 + 修法」两句：
  stack address escapes: `&x` is frame-local; using it at {where} hands out a dangling pointer
  once this frame returns. Copy the value, or allocate on the heap (`new heap hlife ...`).

同步缩短 where 短语（return value / escaping callee|method parameter / constructor parameter stored
into a field / longer-lived field-element / module-level global）

其余冗长报文一并精简：willFree 失效、slife 手动 free/del、async slife、stack+hlife 矛盾、三处容量上限、
@life 标签实参缺失

测试只断言关键字 LifetimeError，不受文案影响（Test/*.py 已确认）。
 2026-10-09 19:22:04 +08:00
TermiNexus fc797da542 feat(lifetime): @life(escape/noescape) 多形参、硬逃逸位同命精化、归纳变量区间与跨模块常量特化 
- GenApi：escape/noescape 标签支持多实参；新增 compute_escape_directives 与若干委托

- StructGenMixin：硬逃逸位（box[2]）、常量与归纳变量区间折叠、_PackEscapeClear/compute_escape_clears

- Call 系：调用点同命裁剪（_FrameArgsEscapeClears）+ 跨模块 escg= 查询；写侧 Converter、读侧 VpiReader

- AssignGenMixin：裸 T()（无 new、无 __new__）判为帧生命期
 2026-10-09 18:44:51 +08:00
TermiNexus 14a8dcb98b feat(gen): new 支持基本类型 + 跨过程常量特化重算逃逸摘要 
- CallGenCtor._translate_new_primitive：
ew [stack|heap|memgr(x)] T（T 为标量）取存储 + 零初始化 → T*；stack 走入口块 alloca、heap 走 malloc、memgr 复用既有通道；标量带实参 fail-fast，不引入第二套标量构造语义

- StructGenMixin：新增 EscFuncTable / EscRefineScratch / EscConstEnv 与常量求值器 _EvalConstInt / _EvalConstCond；_ScanEscapes 的 if 分支按形参常量折叠只扫被走到的分支（死分支里的写不记为逃逸）

- 调用点（普通函数 + 方法，方法沿 MRO 回退）在逃逸检查前用常量实参重算摘要；跨模块拿不到函数体仍保守返回原掩码

- 折叠只会减少逃逸位，不引入新的误报
 2026-10-09 14:55:28 +08:00
TermiNexus b60ce06335 feat(gen): willFree 覆盖关键字实参、方法调用与取地址三条路径 
关键字/混合实参：CallGenMixin._MarkWillFreeKwargs 按形参序（位置实参占前 can 个形参，其余按关键字名匹配）标记。方法调用：CallGenCall._translate_method_call 的 kwargs 与位置两条循环，实参链含 self 故用户第 ai 个实参对应 bit (ai+1)；新增 GenApi/StructGenMixin.get_param_willfree_method（查 Class.method 并沿 MRO 回退）。取地址：ExprGenOps 的 AddrOf 分支对已失效变量 fail-fast。
 2026-10-08 21:39:53 +08:00
TermiNexus d921dcd9e7 fix(gen): willFree 形参表访问先转 Arguments*，修复 TPC 侧 MemberLookupFailFast 
FunctionDef.args 的字段静态类型是 AST*，直接写 fn.args.args 会在 AST 类上查 args（class_members=7 不含 args）。改为先 ast.Arguments*(fn.args) 再取 .args 列表，与 VpiReader / FuncGenMixin / ClassGenVTable 等既有写法一致。
 2026-10-08 21:34:14 +08:00
TermiNexus 97313e9e55 feat(gen): P2 生命期标注 @life(willFree(...)) 驱动释放后使用与二次释放检查 
标注面：@life(willFree(<形参名|0起序号>))，兼容叠加式 @willFree(...)，可混用累加；序号按形参表下标、self/cls 计入。GenApi.compute_willfree_mask 解析标注并对非法标注 fail-fast。本文件表 StructGenMixin.WfTable + 跨模块 .vpi 行尾 wf=<mask>（Converter 写 / VpiReader 读 / CallGenBase 查）。调用点在实参全部翻译之后把对应实参变量槽置 VarEntry.Freed；其后的读取路径报 LifetimeError。重新赋值清除失效态。
 2026-10-08 21:28:49 +08:00
TermiNexus cd68bb62ac feat(gen): M2.3 v3 跨模块逃逸摘要 + 全局赋值判据双保险 
【v3 跨模块摘要】Converter._PyiFunction 在每个 def 签名行尾写 `# esc=<mask> ret=<ret>`（仅非零时写）；VpiReader 新增逃逸摘要缓存（键 {sha1}.{Class}.{method} / {sha1}.{func}，值打包 mask|ret<<32），与返回注解缓存同一次加载解析，并加"模块已加载"备忘 + 键前缀过滤避免拖慢编译；StructGenMixin 抽出 compute_escape_summary 供登记与落盘共用；CallGenBase.lookup_escape_via_vpi 按本类 + MRO 祖先模块 sha1 查询，方法/构造器/模块级函数三处调用点在本地表未命中时回退查 vpi。

【修复】Converter._PyiEnsureEscScratch 补 global（漏写导致全局仍 NULL，box 算成 0+520 → ASan WRITE on 0x208）；函数内写"本文件已声明的模块全局"且无 global/nonlocal 时必须 fail-fast——原判据只看 SymTab.Root.Vars，部分时序看不到模块全局而静默建局部影子；新增 FileVarNames（register_file_funcs 预扫收集顶层变量名）+ is_file_var() 兜底，普通赋值与注解式重声明两处都接上。
 2026-10-08 17:28:06 +08:00
TermiNexus 9f98e683a9 feat(gen): M2.3 覆盖面扩展——类方法与嵌套函数的逃逸摘要 
摘要键约定：模块级/嵌套函数用裸名（与调用点 func_name 一致），类方法用 "Class.method"，查询沿 MRO 回退；刻意不回退裸名，避免方法名与同名模块函数（error/init 等）串味产生误报。

register_file_funcs 登记类方法与嵌套函数摘要，v2 传递闭包相应覆盖（_RescanEscapes 拆为 _RescanOne/_RescanNested/_RescanClassMethods）。

调用点新增：_translate_method_call 的方法路径检查（形参下标含 self，用户第 ai 个实参对应 bit ai+1）、_call_method_on_ptr 的 __init__ 构造器检查（self.f = p 的逃逸；__new__ 形参可能与 __init__ 共享并裁剪，不查）。

已知边界：摘要表按文件重置，跨模块查询待 v3；_PropagateCallEscapes 只处理裸名被调者，方法调用链的传递待补。
 2026-10-08 16:55:34 +08:00
TermiNexus 4ce577d8fb feat(gen): 函数生命期摘要表 + 逃逸 walker（M2.3 v1b 步骤1-3） 
- StructGenMixin：EscTable/EscCount（追加在类末尾，避免偏移漂移）；register_file_funcs 每文件重置并逐函数算摘要。 - 逃逸 walker：return p / global 赋值 / obj.f 赋值，递归 if/while/for；不进嵌套 def/class；形参访问逐级显式重转（AST 退化）。 - 表内只存 u64 名哈希（djb2-64），不解引用字符串指针，消除槽内坏指针导致的 strcmp 崩溃。 - 表从 PermPool 分配并 memset。 - GenApi：get_param_escapes/get_ret_borrow 查询入口。调用点检查（步骤4）待接。
 2026-10-08 13:29:28 +08:00
TermiNexus ec47401151 feat(gen): 生命期标签（LifeTag）与借用传播（M2.1） 
- GenTypes：新增 define LIFE_VALUE/FRAME/HEAP/STATIC/UNKNOWN 与 VarEntry.Life。 - VarGenMixin：set_var_life/get_var_life/life_meet；add_var 初始化 Life=UNKNOWN。 - AssignGenMixin：life_of_expr（&local、数组退让、变量 Life 读取）、propagate_life（赋值传播）、fail_if_life_escapes（汇点检查，LifetimeError）；在 AnnAssign 与单 Name Assign 处挂传播。 - GenApi.fail_if_stack_addr_escape 改为薄壳并委托 fail_if_life_escapes；原 (a)(b) 语法判据并入 life_of_expr。于是 s: str = l; return s 被拦截。
 2026-10-08 12:22:10 +08:00
TermiNexus 7070bc1608 feat(gen): 栈地址逃逸检查（LifetimeError）、按值返回聚合、标量→聚合 fail-fast 
- GenApi.fail_if_stack_addr_escape：禁止把本帧栈地址写出帧外（显式 &local，以及局部数组名退让到指针目标，如 return arr with '-> char*'）；裸聚合名 + 同型聚合目标是值拷贝，不在其列；err_type 记为 LifetimeError。 - StmtGenCifMixin.translate_return：按值返回聚合时，对被指类型与返回聚合类型同一的指针补 load（与多返回值 struct 的 ret 同形），修复 return 局部数组报 CastError。 - ExprGenBase.coerce_to_type：聚合目标不接受标量（旧行为落成 store i32 0, ptr，只写首元素字节并抬高对齐），改为编译期 fail-fast。
 2026-10-08 12:10:13 +08:00
TermiNexus 7a9bc5ae75 chore(messages): TransPyV 运行时中文字符串英文化 
把 TransPyV/App 下 57 个文件的运行时中文字符串（编译器报错/告警/日志、CLI 帮助与横幅、REPL 提示、Phase1/Phase2 流程日志、Codegen 各 Mixin 的类型与调用报错、Stub/Vpi 诊断等）共 1091 行译为英文。

口径：只改字符串字面量内部文字，行数零变化（+1092/-1092）；printf 格式符与转义序列多重集合校验不变（_strcheck 异常 0）；译文不引入撇号以免干扰单引号字面量解析。验证：三重重编 SUCCESS（136.20s）+ 全量 77/77 顺序回归通过 + VET 编译 SUCCESS / --search-paths 7 条 exit 0；新产物 help/日志输出已为英文。
 2026-10-07 00:03:58 +08:00
TermiNexus cd55a7e214 refactor: rawptr[T] -> T*（R14）+ 修 REnum 前向占位未就地填充 
R14：rawptr[X] -> X*（56 文件 / 834 行改动）；保留 6 处 rawptr[t.CPtr]（存纯裸指针的规范例外）。 修复：class X(t.REnum) 的变体字段写成自引用 X* 时，字段解析在变体扫描期经 ensure_forward_class 建了一个 opaque 前向占位；末尾 register_struct 按 Ty 指针去重会再建第二个同名 entry，而 find_struct 取首个（占位，0 字段）→ X.__sizeof__() == 0，报「已注册但大小为 0（字段链表未填充）」。改为注册前若命中同模块前向占位则就地填充（与 ensure_forward_class 文档口径一致）。TPC 无此问题，属 TPV 侧缺口。 验证：自举三重重编 SUCCESS；全量 77/77 顺序回归通过（修复前卡在 LLvmLiteTest）。
 2026-10-05 17:38:28 +08:00
TermiNexus aeb4e8e54c refactor(gen): R12 收尾同步——12 处计数 while 循环改 for range 
与 includes 同步：<= 条件转 range(expr + 1)，并放宽初始化行的紧贴要求（同块内最近一次写即为初始化即可）。其余保守守卫不变。

验证：bootstrap 三重重编 SUCCESS；全量 77/77 顺序回归通过。
 2026-10-05 16:36:36 +08:00
TermiNexus 0f4aeeceff docs(tpv): R11 注释与 docstring 英文化并压缩到 2 行内 
按 wiki/新规范：注释只讲作用、不掺杂历史原因、避免超长、尽可能英文（含三引号 __doc__）。全文 79 个 .vp：# 注释 16269 行（中文 13808）与 docstring（中文 1381 处）全部改英文；超 2 行的注释块（2093）与 docstring（397）全部压到 2 行。运行时可见文本未动（fatal_error/VLogger 的中文报错文案、stdio.printf 的横幅格式串）。校验：屏蔽注释与三引号后逐行比对各文件代码骨架，0 漂移。验证：自举重建 153.48s 通过（跨模块内联完成）；TPV 顺序回归 77/77 全通过。
 2026-10-05 13:38:22 +08:00
TermiNexus f2ef1bb240 refactor(tpv): 新语法 R10 括号内隐式续行并一行（1140 处 / 67 文件） 2026-10-05 07:14:14 +08:00
TermiNexus 4a685d478f refactor(tpv): 新语法 R10 单语句块并一行（7722 处 if/for/while 单语句体） 2026-10-05 03:10:55 +08:00
TermiNexus 7b3e814524 refactor(backend): 单端 MLIR —— 发射器全树改名 mlirlite 并删除 --backend 开关 
- App/Test 的 .vp 中 llvmlite 全部改名为 mlirlite（import、限定名、类型注解、注释）

- 删除后端开关：Config.set_backend/is_mlir_backend/alias_module_name、BackendTarget/BackendIsMlir、CLI --backend、options.backend/options.target 读取，以及 IncludesScanner/StubMergerIR 的模块别名调用

- BuildPipeline 的 mlir-opt -> mlir-translate 降级管线去掉开关门，改为恒执行

- backend_dir_suffix 改名 mlir_dir_suffix 并恒返回 _mlir：TempDir/OutputDir/includes 缓存继续落在 *_mlir，避免复用旧 LLVM 后端的 .ll/obj

- project.vpj 删除已失效的 options.target
 2026-10-03 19:26:24 +08:00
TermiNexus 692998820c feat(generic): 泛型函数类型实参推断与单态化 
支持 def f[T](x: T) -> T 及 f(x)/f[T](x)：模板注册（Phase1Scan/Phase2 顶层 FunctionDef，键 {sha1}.{name}）、按形参注解对齐从实参推断类型实参（无来源即 fail-fast，不静默默认 int）、克隆模板并 set_generic_context 后翻译生成特化体（名字 {sha1}.f[int]，规范化复用 _mangle_generic_class_name）、同签名去重、跨模块按模板签名补 declare。泛型函数模板不再发 vpi（模板签名含未绑定 T），也不再发射 int 兜底版本。已知限制（未静默）：bound [T: bound] 解析期已被丢弃；t.CExport/t.CExtern/t.State 泛型函数、关键字/默认参数调用、mod.f[T](x) 显式下标等暂 fail-fast 或走既有报错。
 2026-10-03 11:59:26 +08:00
TermiNexus 15b416b527 fix(type): 统一注入期类归属与导入上下文记账，修占位表爆与属性标记误解析 
- StubMergerStore 新增共享导入上下文记账（AppendImportedModule / AppendFromImport /
  ImportCtx / AllocImportCtx / NotePlainImport），ImportsGenMixin 与 VpiReader 共用同一份
  口径；顺带移除 add_from_import 的 256 缓冲静默截断，VpiReader 删除两份私有副本

- 注入窗口按「名字归属」判据解析（is_module_class + CurDefModuleSha1）：
  _forward_declare_ptr_from_node 的 Name 分支、resolve_annotation_type 的 Name/Attribute
  分支均补齐，使同一 stub 内先声明/先引用的类产出**具名占位**而不是 Ptr(i8)，并新增
  _is_tattr_marker 让 t.attr.* 属性标记不参与类型联合竞争

- VpiReader._inject_class_struct_declare：命中前向声明占位时不再早退，改为「占位 Ty
  原地写入」（对齐 ClassGenDef.fill_fwd），修 StructTable 爆表（table full, cannot
  register Translator）

- 清除全部一次性探针：[DBG-GEN]（VpiReader / StructGenMixin / ClassGenDef）、
  [DBG-ATTR]（ExprGenAttr）、[MODSHA1]（CallGenMixin）

根因记录：vpi 注入期漏记 `import X as Y -> from_imports "Y:X"`，使 GenTypes.VarEntry.Spec
（TSpec.TypeSpec | t.CPtr）取不到模块 SHA1、退化为 i8* 并被永久冻结
（CallGenCtor.vp:897 .PtrLevel 属性访问失败）。
 2026-10-02 17:29:38 +08:00
TermiNexus dc4e06d88b fix(TPV): 本文件自己声明的 extern 裸名优先于依赖 vpi 注入的同名声明 
现场：Test/WebTest 编译 includes/socket.vp:236 报
  CastError: 指针隐式转指针已禁止：源 %"56d0ee99ecf0a0b5.SocketAddr"* →
  目标 %"99c88d4cbd933ac6.WSASocketAddr"*
  源码: result = connect(self.fd, c.Addr(addr), 16)

机制（**链接期无冲突**——两边都不是 export，@connect 是同一个 C 符号，最终只有
ws2_32 里一个定义；问题在"编译 socket.vp 时的同一个模块内"）：
1. extern/state/export 声明的符号**不带 SHA1 前缀**（FuncGenDef.vp:172-173
   `mangled_name = fd.name`）⇒ socket.vp 与 w32.winsock2 都产出裸名 @connect
   （前者形参 SocketAddr|t.CPtr，后者 WSASocketAddr|t.CPtr）。
2. Translator 的 prologue 先注入依赖 w32.winsock2 的 vpi
   （StubMergerBuild.LoadDepVpiIntoModule → VpiReader.ParseVpiIntoModule →
   _inject_function_declare：create_declare + module_add_function），当前模块里
   先出现了 winsock2 版的 @connect。
3. 随后 forward_declare_functions 处理 socket.vp 自己的 `extern def connect` 时，
   find_func_in_module 命中已存在 ⇒ `continue`（FuncGenDef.vp:178-182）
   ⇒ **本文件自己的声明被静默丢弃**，调用点改按 winsock2 的形参 coerce
   （报错里的目标类型 WSASocketAddr* 正是 winsock2 版的指纹）。
   （同文件 send/recv/socket/listen 亦被顶掉，只是形参是 i8*/u64，不报错——
   即 socket.vp 的 POSIX 分支本来就在调用 winsock2 的声明。）

改动（注入期跳过"本文件已声明的裸名"，让本文件自己的声明优先）：
- StructGenMixin：新增 FileFuncNames 表 + register_file_funcs(pool, tree) /
  is_file_func(name)，与既有的 FileClassNames / register_file_classes /
  is_file_class 同规矩（键与表同池、每文件随 reset_visible_structs 重建）。
- GenApi：新增 register_file_funcs / is_file_func 委托包装。
- Translator._translate_module_level：在 register_file_classes 之后调用
  register_file_funcs（三种模式共用、早于依赖 vpi 注入）。
- VpiReader._inject_function_declare：算出 mangled name 后，若 `use_bare_name != 0`
  且 `is_file_func(fd.name) != 0` 直接返回（不注入）。判据只用**裸名**：带 SHA1
  前缀的依赖函数名与本文件同名声明不会互相顶替，避免误跳过跨模块调用。

待验证：重编译 TransPyV（自举两遍）→ WebTest / JsonTest / FileIoTest。
 2026-10-01 14:46:47 +08:00
TermiNexus c1a22411ca fix(TypeGenResolve): 规则 5.5 增「本文件顶层类名」证据，模块级早于类定义的窗口不再留裸名 
类别：a 编译器缺陷（TPV 侧；补齐"第二个裸类名窗口"）

现象（与上一轮 e1bb42f 同一现场、不同窗口）：编译 includes/ast/base.vp 时 :359
`_append_child(self.children, node, self.pool)` 报"指针隐式转指针已禁止（被指类型是
非基本类型…）"，源 list[rawptr[AST]]* 与目标 list[rawptr<定义模块SHA1>.AST]* 差在实参的
SHA1 前缀。

判据（第二个窗口 = 模块级语句早于类定义）：
· Translator.translate 的 prologue 先跑模块级 AnnAssign/Assign（Translator.vp:592-599）
  与 forward_declare_functions（:601），**之后**才 translate_children(:602) 逐个翻译类；
  而"正在定义类"窗口（CurDefModuleSha1/CurDefClassName）只在类定义入口
  （ClassGenDef.vp:50）或 .vpi 注入（VpiReader.vp:2659）才建立 ⇒ 前者解析注解时窗口为
  None ⇒ `_norm_type_arg_name` 规则 5.5 的 ①②③④ 全落空 ⇒ 注解里的裸类名（base.vp:148
  `_append_child(..., lst: list[rawptr[AST]])` 的形参即此窗口）以**裸名**形式被首次注册，
  并被后续复用（首写者胜：StructGenMixin 按 Ty 去重、ClassGenDef existing 早退不重算）
  ⇒ 与同一特化在类定义期解析出的带 SHA1 形式分裂。

修法（正向事实，不猜；与窗口/类定义顺序无关）：
1. `StructGenMixin` 增文件级登记：字段 `FileClassNames`（本文件顶层 ClassDef 类名表，
   表与键同池、每文件随 `reset_visible_structs` 重建）+ `FileModuleSha1`（本文件模块
   SHA1），以及 `register_file_classes` / `is_file_class` / `get_file_module_sha1`。
   键从 AST 的 name **复制到 pool** 后再登记（AST name 零拷贝指向 src_buf，跨阶段可能
   失效，直接当表的键会 strcmp 到悬空内存）。
2. `Translator.translate` prologue：在模块级变量/前向声明**之前**调用
   `GenApi.register_file_classes(pool, self.ModuleSha1, tree)`（GenApi 增同名委托）。
3. `TypeGenResolve._norm_type_arg_name` 规则 5.5 增**第五类证据**：①②③④ 全落空时，
   若 `is_file_class(name)`（该裸名确由本文件声明）且本文件模块 SHA1 已知 ⇒ 归属本文件。

验证：TPV 侧改动需重新自举 TransPyV.exe 后生效；本轮以代码级证据链
（Translator.vp:592-602 / ClassGenDef.vp:50 / TypeGenResolve.vp 规则 5.5 闸门）自证。
TransPyV 仓另有他人未提交文件，本次只提交本改动的 4 个文件。
 2026-09-30 00:23:43 +08:00
TermiNexus 31f341cf6f fix(transpyv): vpi 注入期登记「本模块声明的类」，裸类名实参不再冻结成裸名 
类别 a（编译器缺陷）：_norm_type_arg_name 规则 5.5 的入口闸门是
`_def_sha1 is None and _def_mod is not None`（_def_mod = CurDefModuleSha1），而
VpiReader._inject_class_struct_declare 是在**注入期**解析字段注解的——此刻既没有
"类定义窗口"（CurDefModuleSha1=None ⇒ 闸门整条关闭、四条证据一条都不查），被注入的类
也尚未 register_struct ⇒ 注解里的裸类名实参取不到定义模块 SHA1 ⇒ 特化名被冻结成
**裸名版本**，与该类在自身翻译期（类已注册）解析出的带前缀形式分裂成两个特化名，
最终以"非基本类型指针不可隐式转换"报出。现场：includes/ast/base.vp:359
  _append_child(self.children, node, self.pool)
  源 %"…list[rawptr[AST]]"* vs 目标 %"…list[rawptr<定义模块SHA1>.AST]"*
这也解释了前两轮修复为何无效：③（自引用判据）依赖 CurDefClassName、④（entry.Ty 取
前缀）依赖 struct 条目，而注入期两者都不可用，且此时连日志条件（entry 命中）都不成立。

- GenApi：新增 mark_module_class 委托（与 add_visible_struct / find_struct_by_module 同款）。
- VpiReader._inject_class_struct_declare：在解析字段注解之前调用
  GenApi.mark_module_class(pool, src_sha1, cls_name) —— 一次调用同时完成
  ① 登记"{src_sha1}.{cls_name}"（名字归属，与 struct 注册状态无关）；
  ② 把 CurDefModuleSha1/CurDefClassName 指向本次注入的模块与类（打开规则 5.5 的闸门）。
 2026-09-29 22:29:48 +08:00
TermiNexus 4255ab9d32 fix(fstr): f-string 改回每站点栈缓冲 + 禁止逃逸，逃逸点改 stdlib 拷贝 
ExprGenFstr._fstr_finalize：结果缓冲改回每站点栈 alloca（线程安全、零运行时依赖；每站点各建一个，站点之间不再共享），docstring 与文件头写明语义：f-string 结果是当前函数内的临时值。

GenApi 新增唯一判据 fail_if_fstring_escape 与唯一拷贝出口 escape_fstring_copy（stdlib.malloc + string.strcpy）；逃逸位置接护栏：translate_return（函数返回值）、translate_assign（字段/元素/全局变量赋值）、handle_module_level_var（模块级 AnnAssign 初始化）。

编译器自身 7 处逃逸点（ExprGenBase._cast_fail_where 6 处、AssignGenMixin.const_assign_msg 1 处）改为 escape_fstring_copy 显式拷贝——正是造成 ASan stack-buffer-underflow in vsnprintf 的那条路径。

残留（已在 GenApi 头注释诚实记录）：间接逃逸（把 f-string 传进会保存它的函数、或放进容器后带走容器）静态判不出；类字段默认值路径未接护栏。全仓自查：TransPyV/App、includes、ViperApps 均无 容器/字段/全局 存 f-string 的写法，也无残留 return f-string。
 2026-09-27 14:45:28 +08:00
TermiNexus 951b89be36 修正了部分代码的表达方式，最后可用版本，正在为 mlirlite 做准备 2026-09-23 16:09:32 +08:00
TermiNexus a5ceb3d4eb 增加 JIT REPL 2026-09-21 16:17:19 +08:00
TermiNexus 9910e05760 修复了一些错误，更改了一点语法 2026-09-18 20:00:40 +08:00
TermiNexus 9e2ccbfab7 将部分 | t.CPtr 修正为 rawptr[T] 2026-09-18 17:56:24 +08:00
TermiNexus cb0836de8a 清理了 t.CVoid 2026-09-16 16:06:48 +08:00
TermiNexus 9a191daa8d 错拼 rowptr 改为 rawptr 2026-09-16 11:42:28 +08:00
TermiNexus 7cba4cbc95 chore: 清理超长历史注释，并一并提交并行会话的代码改动 
注释清理（65 文件 / 约 -2578 行 / 约 516 处）：删除/压缩叙述式历史注释——多行根因叙事、工作代号段（D25/D30/N11/B5/S4/阶段E 等）、改前改后与先例叙述、逐条推导块，压成一行讲清作用信息；契约类注释（用途、参数与返回、关键约束与不变量、IR 结构说明）与被注释掉的代码一律保留

存疑 标记 6 处一字未动：StubMergerStore.vp、VpiReader.vp、VLogger.vp、AssignGenMixin.vp、CallGenLib.vp、CallGenLeafKit.vp

本次一并带入并行会话的代码改动（同批文件，按文件粒度无法拆分）：fileio.File -> rowptr[fileio.File] 等

已知副作用/残留：① CallGenDispatch.vp 有 2 行非注释行的行尾被 LF->CRLF 规范化（纯字节变化，无文本改动）；② core/Gen 区约 24 处压缩因并行会话整文件覆写被写回原样，尚未生效（StmtGenCifMixin/ClassGenVTable/FuncGenDef/ClassGenEnum/StructGenMixin/TypeSpec 等）

清单与复跑判据见 Debugger/comment_cleanup_summary.md（该目录不受版本控制）
 2026-09-16 11:27:05 +08:00
TermiNexus 82eea2719f refactor(tpv): rowptr[T] 迁移 + D 表定长缓冲改精确分配 + SHA1 前缀判定收敛（D1/D3/D4/D5/D6/D7/C10） 2026-09-12 11:09:35 +08:00
TermiNexus 41c5908c5e refactor(tpv): Y 类兜底改 fail-fast（vpi 声明返回/形参 + vpi 类型文本） 
新增 GenApi.fatal_error：VpiReader/Converter 等模块级函数无 self.Gen，统一经此报错通道；GenApi._g_gen 为空时回退 Generator._g_gen（Phase 1 vpi 生成早于 BuildPipeline 注入 GenApi._g_gen）。

VpiReader._inject_function_declare/_inject_method_declare 共 4 处：有注解却解析不出类型 → fatal；无注解的 i32 返回/i8* 形参合法默认保留。Converter._PyiTypeStr 未知节点类型不再静默写 int。
 2026-09-11 22:46:39 +08:00
TermiNexus 0a108e6289 refactor(tpv): 删除 FuncEntry.TypeStr 旧路径，函数类型文本改由 Spec 派生 
- 删 FuncEntry.TypeStr 字段、_build_func_type_str 生产者、_check_func_spec_text 闸门
- update_global_func_typestr 改名 update_global_func_spec，仅填 Spec（去 pool 参数）
- ClassGenVTable vtable 合并 func_valid 分支，统一 SpecToLLVMText 派生
- 同步 FuncGenDef/ClassGenVTable/GenApi/VpiReader 调用点
 2026-09-11 21:33:58 +08:00
TermiNexus cfb92e5da5 初步清理 t. 类型异味 2026-09-11 18:36:32 +08:00