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（该目录不受版本控制）

App/lib/Stub/StubMerger/StubMergerCollect.vp

@@ -26,31 +26,18 @@ import lib.Stub.StubMerger.StubMergerBuild as StubMergerBuild
 import lib.Stub.StubMerger as StubMerger
 
 # ============================================================
-# StubMergerCollect - StubMerger 拆分（阶段 E）：StubMergerCollect
+# StubMergerCollect - 切片路径构建与 stub 文件 SHA1 收集
 #
-# 直接移动模式：函数实现迁至此模块，原 StubMerger.vp 仅保留
-# 常量/全局变量；调用方经本模块前缀访问。全局变量跨模块经
-# StubMerger._xxx 访问（main.vp 先例）。
+# 函数实现直接位于本模块，调用方经本模块前缀访问；全局变量跨模块经 StubMerger._xxx 访问。
 # ============================================================
 
 # ============================================================
-# _sliced_path - 构建切片路径（stdlib.malloc 分配，调用者负责 free）
+# _sliced_path - 构建切片路径（stdlib.malloc 分配，调用者负责 free；level>0 时自动调 BuildPipeline.ensure_dir 建子目录）
 #
-# 根据 Config.Sha1SliceLevel 将文件分散到 SHA1 前缀子目录:
-#   level=0 → {temp_dir}/{sha1}.{ext}
-#   level=1 → {temp_dir}/b7/{sha1}.{ext}
-#   level=2 → {temp_dir}/b7/90/{sha1}.{ext}
+# 按 Config.Sha1SliceLevel 分散到 SHA1 前缀子目录：level=0 → {temp_dir}/{sha1}.{ext}；level=1 → {temp_dir}/b7/{sha1}.{ext}；level=2 → {temp_dir}/b7/90/{sha1}.{ext}
 #
-# 自动调用 BuildPipeline.ensure_dir 创建子目录（level>0 时）。
-#
-# Args:
-#   temp_dir: 基础目录
-#   td_len: temp_dir 长度（避免重复 strlen）
-#   sha1: SHA1 字符串
-#   ext: 文件扩展名（如 "stub.ll"）
-#
-# Returns:
-#   完整路径（stdlib.malloc 分配，需 stdlib.free），None 失败
+# Args: temp_dir 基础目录；td_len temp_dir 长度（避免重复 strlen）；sha1 SHA1 字符串；ext 文件扩展名（如 "stub.ll"）
+# Returns: 完整路径（stdlib.malloc 分配，需 stdlib.free），None 失败
 # ============================================================
 def _sliced_path(temp_dir: str, td_len: sizet, sha1: str, ext: str) -> str:
     """构建切片路径（stdlib.malloc 分配，调用者负责 free）
@@ -94,22 +81,12 @@ def _sliced_path(temp_dir: str, td_len: sizet, sha1: str, ext: str) -> str:
 
     return path
 # ============================================================
-# _collect_stub_sha1s - 递归扫描子目录，收集 .stub.ll 文件的 SHA1
+# _collect_stub_sha1s - 递归扫描子目录，收集 .stub.ll 文件的 SHA1（从文件名提取）
 #
-# 根据 level 递归扫描子目录:
-#   level=0 → 扫描 {base_dir}/*.stub.ll，从文件名提取 SHA1
-#   level>0 → 扫描 {base_dir}/* 的子目录，对每个子目录递归调用
+# level=0 → 扫描 {base_dir}/*.stub.ll；level>0 → 扫描 {base_dir}/* 的子目录并对每个子目录递归调用。
 #
-# Args:
-#   base_dir: 当前扫描目录
-#   bd_len: base_dir 长度
-#   level: 剩余递归层数
-#   out_arr: 输出数组（每个 SHA1 17 字节 = 16字符 + null）
-#   out_count: 当前已收集数量
-#   max_count: 最大数量
-#
-# Returns:
-#   收集后的总数量
+# Args: base_dir 当前扫描目录；bd_len base_dir 长度；level 剩余递归层数；out_arr 输出数组（每个 SHA1 17 字节 = 16字符 + null）；out_count 当前已收集数量；max_count 最大数量
+# Returns: 收集后的总数量
 # ============================================================
 def _collect_stub_sha1s(base_dir: str, bd_len: sizet, level: int,
                         out_arr: str, out_count: int, max_count: int) -> int:
@@ -222,18 +199,11 @@ def _is_in_sha1_set(sha1: str, sha1_set: str, set_count: int) -> int:
             return 1
     return 0
 # ============================================================
-# WriteIncludesSha1Map - 将 includes 扫描结果写入 _sha1_map.txt（人类可读输出）
+# WriteIncludesSha1Map - 将 includes 扫描结果写入 _sha1_map.txt（仅人类可读的调试输出，程序内部不读取，
+# 机器分析用 PopulateSha1MapStore 填充的全局内存存储器）
 #
-# _sha1_map.txt 仅作为人类可读的调试输出，程序内部不读取此文件。
-# 机器分析使用 PopulateSha1MapStore 填充的全局内存存储器。
-#
-# Args:
-#   mb: 内存池
-#   temp_dir: 临时目录（_sha1_map.txt 写入位置）
-#   scan_result: IncludesScanner 扫描结果
-#
-# Returns:
-#   0 成功，非 0 失败
+# Args: mb 内存池；temp_dir 临时目录（_sha1_map.txt 写入位置）；scan_result IncludesScanner 扫描结果
+# Returns: 0 成功，非 0 失败
 # ============================================================
 def WriteIncludesSha1Map(mb: rowptr[memhub.MemBuddy], temp_dir: str,
                          scan_result: rowptr[IncludesScanner.ScanResult],