Skip to content

v0.15.0

Latest

Choose a tag to compare

@hesheng01 hesheng01 released this 18 Oct 08:40
· 1 commit to main since this release

Changed

  • rel_eval 正式更名为上游写法 reval(旧名不再兼容;expr@offset 语法糖不变)。
  • set 移除, set! 成为唯一赋值写法(直接对已定义变量赋值,词法穿透共享 cell;不再支持
    (set (x 1) (y 2)) 多对赋值)。
  • count/step / find/step 移除(与 count/find 完全重叠:统一引擎与逐拍回退现在共用
    "索引空间=实际读值波形"的同一规则,不再需要两组算子)。

Removed

  • 与上游 WAL 对齐的功能清理:save(CSV 导出)、parse、require、import、call、
    repl(算子形式)、fold/signal、trim-trace、new-trace、dump-trace、timescale、
    assert-eq、set。保留 eval-file(上游核心文件加载)、reval/@、groups/scopes、宏系统、
    谓词、print/printf、timeframe、for/list 等上游核心与波形核心算子。
    替代:assert-eq 用脚本 (if ... (exit 1));count/step→count;find/step→find;
    import/require→eval-file;fold/signal→find + map/sum 组合。

Changed

  • fmt-time 更名为 beat:(beat t) 返回人类可读时间串;(beat t "clk") 返回整数拍号
    (首个上升沿 = 第 0 拍,首沿之前 = -1)。旧名 fmt-time 不再兼容(调用报未知算子)。
  • 拍号显示模式 WAL_BEAT_CLK=<clk[,clk2]>:设置后 at / getwave / wave / edges / search
    的时间输出改为时钟拍号 —— 单时钟输出整数,多时钟每个时钟一对 ("clk名" 拍号)(分开显示、不合并);
    多波形按"实际会读值的那条波形"解析时钟;配置的时钟无法唯一解析或没有上升沿时明确报错并整体回退
    到绝对时间;首个上升沿之前显示 -1(首次出现时给一行提示)。

Removed

  • save 算子(CSV 导出):移除无人使用的波形 CSV 导出能力;需要导出的场景请用其他工具。

Added

  • 波形指标与统计算子(延迟/吞吐/分布): median / percentile / stddev / stats /
    histogram(纯数值列表)与 latency / ipc(波形侧配对)。
    (stats (latency (rising "req") (rising "ack"))) 这种组合就是"握手延迟分布"的完整答案。
    语义写死在 docs/waveform-metrics.md:latency 用原生时间单位、默认 FIFO 配对
    (#restart 让新 start 作废未配对的旧 start)、配不上的两端丢弃、边沿口径与查询引擎一致
    (x→1 是 changes 不是 rising);两个波形算子只在时间域取变更列, 不建索引空间 ——
    千万时间戳的大波形上不会触发"全文件物化时间线"。闸:tests/metrics_test.rs(手算期望值)。
  • FSDB 时间线的并行/集群预计算: 新增两个正式子命令 ——
    wal-rust fsdb-timeline-map <file> <shard> <shards> <out.part>(算一片)与
    wal-rust fsdb-timeline-merge <file> <part>...(归并 → 安装 .ftl)。
    集群上用 scripts/lsf_fsdb_prewarm.sh <file.fsdb> [shards] 一条命令提交/等待/归并
    (bsub -n 1 × N, 无 LSF 时 --local 本机并发, --dry-run 只打印提交命令)。
    WAL_FSDB_TL_JOBS 支持 auto(= min(额度, 8))。
    归并产物与单进程写出的 .ftl 逐字节一致(单测 + 真机 cmp 双重验证), 分片怎么切、
    归并顺序如何都不影响结果。
  • bsub -n N + stdin 会话: scripts/lsf_wal_run.sh <wave> <probes.wal> [slots]
    把 wal-rust --stdin -l wave < probes.wal(一次加载、多探针)提交成 bsub -n N
    (--queue/--wall/--wait/--dry-run, 默认加 -R "span[hosts=1]")。
  • -j N|auto / --jobs: 一个波形的并行度(默认 auto, 不需要 LSF 也能用 —— 单机就是多核)。
    默认 = min(可用额度, 8), 额度优先取 bsub -n 分配的 slot 数, 否则核数;
    小波形自动退回单进程(WAL_FSDB_TL_MIN_MB 默认 32MB, 或信号数 ≥ 16384), 因为每个
    worker 各有一次 NPI 初始化开销;-j 1 强制单进程, 显式数字一律照办。VCD 侧同步按该数建
    线程池。实测(200 万时间戳夹具, 冷缓存): 默认(小文件)39.1s / -j 8 21.0s。
  • scripts/bench_fsdb.sh(make bench-fsdb FSDB=x.fsdb [SIG=tb.clk]): FSDB 查询基准,
    冷建/暖查询/只加载分开计时并追加到 bench/perf-history.csv; CI perf 阶段在设了
    WAL_FSDB_BENCH=<file.fsdb> 时自动跑(判据: 暖查询应接近"只加载")。

Changed

  • 大波形的并行冷建不再需要人工配环境变量: 波形文件 ≥ WAL_FSDB_WALK_SCAN_MB(默认 128MB)时,
    每个 fsdb-timeline-map worker 自动启用"边走边扫"(WAL_FSDB_WALK_SCAN=1), 并在多分片下
    自动选切分层(WAL_FSDB_SCOPE_SPLIT 留空/auto): 在"子树数 ≥ 分片数"的层里取每 worker
    认领的子树数最接近 256
    (WAL_FSDB_SCOPE_TARGET_PER_WORKER)的那层。于是直接
    make fsdb-prewarm FSDB=big.fsdb SHARDS=8 LOCAL=1 就是内存安全且接近最优的那条路 ——
    以前必须自己 export WAL_FSDB_WALK_SCAN=1 WAL_FSDB_SCOPE_SPLIT=5, 忘了就会让 8 个 worker
    各走整棵树。小文件行为不变;想回到旧口径: WAL_FSDB_WALK_SCAN=0、
    WAL_FSDB_SCOPE_SPLIT=0|off, 显式数字仍然照办(想固定层做 A/B 就用它)。
    • 甜点 256 是真实波形上量出来的(321MB / 1796 万信号, 同机同天, 端到端
      make fsdb-prewarm SHARDS=8 LOCAL=1): depth4(42 棵/worker) 668s、
      depth5(265 棵) 636s、depth8(4595 棵) 760s。depth8 的信号数其实是三档里
      最均衡的(每片恰好 ≈12.3%, 即"完美平衡"), 但每 worker 要认领 4595 棵树 ——
      真正决定耗时的是变更密度(时钟类信号每条 13 万次变化, 逻辑信号常常几次),
      均匀切信号数不等于均匀切工作量。所以选层用"目标棵数"而不是"按信号数算均衡度"。
    • 统计"每层多少棵子树、每棵多大"要一次只数数的树遍历(这份 1796 万信号波形 ~44s,
      NPI 驻留 ~10GB): 8 路并发走这一遍会 OOM —— 首版实测 8 个 worker 同时统计时 NPI 直接
      SIGSEGV([fhdb][fatal] Can not get user data 刷屏)。现在用 flock 串行化:
      第一个 worker 走一遍并把结果写进 <cache>/<file_identity>-v1.fscope
      (魔术字 WSCP2 + 每层子树数与每棵子树大小, 原子 rename), 其余 worker 在锁上等 ~44s 后
      直接命中, 之后的每次运行 0 代价。缓存目录不可写时不猜也不走树, 直接按最深一层分片
      (子树最小 = 每 worker 最省内存; 而"不切分"意味着每个 worker 走整棵树)。
      自动选中的层 WAL_DEBUG_FSDB=1 会打印。闸: 单测比对选层规则、缓存往返(含文件身份失效)。
    • 归并产物与分片口径无关: depth4 / depth5 / depth8 三条口径的 .ftl 都是
      md5 ca1cb095…(320,204 个时间点, 460,014 B) —— 自动选层换了口径也不会动产物。

Performance

  • FSDB 加载: 名字索引的哈希改为并行计算, 索引段 5.2s → ≈1.0s(真波形实测)。
    把加载拆开看(WAL_DEBUG_FSDB=1 的分段时戳, 336MB / 1796 万信号):

    阶段 之前 现在 说明
    NPI init+open(+文件属性) 4.4s 4.4s NPI 自己的账, 每个进程一次
    名字就位(.fnames 解出 17.96M 个名字) 4.7~6.2s 4.7~6.2s 未改动;区间来自页缓存冷热
    名字索引建完(哈希 → 下标) 5.20s 0.94~1.34s 2.85GB 名字的 FNV 哈希改 rayon 并行(插表仍是随机写, 不并行)
    合计 ≈15.8s ≈10.5s --stdin 一次加载;之后每个探针 ≈0
    • 索引段是相邻两次会话测的(5.20s → 0.94s / 1.34s), 同机同文件;
      整段墙钟受页缓存影响会在 10.5s ~ 14.8s 之间跳(同一二进制), 比数字前先看机器状态。
    • 两个负结果(都实测过、都没有采用, 记下来免得下次再试):
      ① 逐名 from_utf8 校验换成 unchecked 只从 4.69s 变 4.84s(噪声级);
      ② .fnames 改 mmap + decode_tree_into 就地解码, 相邻两次 4.70s vs 4.69s —— 收益在噪声里,
      却多一个"缓存文件被并发截断 → SIGBUS"的风险, 所以保持流式解码。
    • 名字解码剩下的 ~4.7s 要靠缓存格式 v3(偏移表 → 并行解码 / 零拷贝 arena)才能再压;
      那是我们自己的格式, 不需要动 FSDB。
  • 大波形时间线: 按 scope 子树的多进程并行(以及一个靠"三种分片对拍"抓到的真 bug)。
    WAL_FSDB_SCOPE_SPLIT=<depth> 让每个 worker 只走自己那几棵子树 —— NPI 遍历期内存随子树
    下降(实测每 worker 2.8~3.9GB, 而单 walker 是 ~12GB), 于是 8 路并行在这台 27GB 机器上
    可行。选层靠一次标定遍历(WAL_FSDB_SCOPE_STATS=<depth>): 这份 core 级设计 depth1/2 都只有
    1 个子树(切了等于没切), depth3 = 7 棵, depth4 = 334 棵(最大 13.7%)。

    • ⚠️ 抓到的 bug: 用了 scope 分片后我仍然按"信号下标 % N"过滤信号, 两套分片口径叠加
      导致每个 worker 丢掉自己子树里 7/8 的信号 —— 表现是"三条分片合并出来的时间线并集少了
      43 个时间点"。是"不同分片口径必须产出同一并集"这条对拍(而不是单测)抓到的, 已修:
      scope 分片时信号级轮转自动关闭。
    • 实测(1796 万信号真波形): depth5/8 片 494s、depth4/8 片 570s(单 walker 外推 2700s),
      每 worker 4
      8GB; 合并后 .ftl 装好, 暖查询 11.4s / 6.35GB(之前 20 分钟跑不完的那条)。
    • 正确性: depth3/7、depth4/8、depth5/8 三种独立分片口径的并集逐点相同(320,204 个时间点)。
  • 大波形的时间线冷建换路: "边走边扫"。常规路径在这类波形上要么先按名字把句柄一个个
    解析出来(实测 550µs/个 → 18M 信号 ≈ 2.75 小时), 要么把 18M 句柄全攒着(NPI 遍历期
    自己涨到 ~10GB)。新路径"走到一批信号就扫一批、扫完丢句柄"(timeline_by_walk_split):
    不建名字表、不攒句柄数组, 峰值内存与信号总数解耦。

    • 信号数 ≥ WAL_FSDB_WALK_SCAN_MIN(默认 2,000,000)自动启用, WAL_FSDB_WALK_SCAN=0 关闭;
    • 产物与常规 worker 逐字节相同(cal1m 上 cmp 验证);
    • 1796 万信号真波形实测: 1/8 分片(约 224 万信号)369s / 11.9GB, 产出 318,809 个时间点
      —— 单 walker 全量按此线性外推 ~45 分钟(每变更记录 ~1.45µs 是 NPI 的硬成本, 换路只
      免掉了"按名字解析 18M 次句柄"的那两小时, 并没有免掉逐条扫描);
    • 另支持按 scope 子树分片(WAL_FSDB_SCOPE_SPLIT=<depth>)以便多进程并行时内存随
      子树大小下降; 这份设计只有一个顶层 scope 切不动, 留给别的设计。
  • 真波形的时间线冷建: 代价量化 + "只取句柄"的 worker。在 1796 万信号 / 4377 万时间戳的
    core 级波形上把"整文件过一遍"拆开量: iter.start() 装载 ≈0.2µs/条、iter.next() 逐条
    ≈1.25µs/条 → ≈1.45µs / 变更记录(代价跟"记录条数"走, 不跟信号数走 —— 时钟类信号
    独占大头, 单个 adapter clk 就 130,590 次变化)。块大小有甜点(65536 最好, 4096 慢 35%,
    262144 更慢), iter_next(time&) 单参数重载不提速(开销在 NPI 内部逐条处理)。
    暖路径的句柄解析是致命项: .fnames 命中时句柄按名字懒解析, 实测 550µs/信号
    (18M 信号 ≈ 2.75 小时) → 新增 WAL_FSDB_HANDLES_ONLY=1(时间线 worker 默认开):
    跳过名字 arena/索引/scope, 走树只留句柄, handle_of 归零, 代价变成一次树遍历(~41s)。
    WAL_DEBUG_FSDB=1 多了"时间线扫描剖析"一行(handle_of / add / start / next×N / 时间点),
    下一轮的优化目标(按 scope 边走边扫 / 直接读 FSDB 全局时间表)在 bench/RESULTS.md 里记着。

  • 真实 core 级波形(321MB / 1796 万信号 / 162 万 scope): 加载内存砍半、名字表不再物化。
    实测(本机原生读, VCS X-2025.06-SP2 写的文件): 冷加载 66.9s/17.8GB → 52.9s/13.6GB;
    暖加载 13.5s/11.0GB → 10.1s/6.35GB;(length (SIGNALS)) 11.3GB → 6.35GB。三处改动:
    ① .fnames 缓存升 v2: 定长 48B header 带"信号数 / 名字总字节 / scope 数 / scope 总字节",
    读侧一次精确 reserve(老口径按 n*32 猜 + 翻倍增长: 2.85GB 名字字节会涨到 4.6GB 容量,
    最后一次扩容旧新两份同时驻留 ≈7GB);
    ② 冷路径边遍历边流式写 .fnames: 遍历期间内存里不攒 arena, 走完按精确容量解码回来;
    顺带把"先拼 3.2GB Vec 再落盘"改成流式(指纹 seek 回填)。缓存不可写或流式失败 → 自动
    回退内存 arena(重走一遍树), 绝不影响"能不能读波形";
    ③ (length (SIGNALS)) 不再物化整表: 新增 Trace::signal_count()/signal_at()(FSDB/VCD
    都是 O(1)/O(名长)), 求值器给 (length (SIGNALS)) 加快路, CLI sigs 按下标懒遍历 ——
    1796 万信号上少背一张 ≈4.8GB 的 Vec<String>。(SIGNALS) 整表语义不变。
    WAL_DEBUG_FSDB=1 现在按 open 后 / 名字就位 / 索引建完三段打印 RSS, 便于定位内存大头。

  • FSDB 时间线冷建 @ 400 万信号: 112s → 14.2s(单进程) / 69.6s → 12.1s(8 路)。
    病根不是"把数据过一遍", 而是 npiFsdbTimeBasedVcIter::start() 的每块固定开销
    100140ms
    (与块内信号数、文件数据量都无关: 19 信号/200 万时间戳夹具上 18 块比 1 块
    多 2.45s;4M 信号夹具上 977 块比 16 块多 98s) —— 400 万信号按老的 4096/块切 = 977 次
    start = 100s 纯开销
    。现在默认块大小随信号数放大 clamp(signals/64, 4096, 65536)
    (总块数 ≈64 封顶;并行 worker 也按文件总信号数定块, 否则每片 50 万信号又变 122 块),
    WAL_FSDB_CHUNK 仍可显式覆盖做 A/B。峰值 RSS 不变(1.5~2.0GB)。

  • 时间线 .ftl 的落盘判据不再只看点数: FSDB 冷建代价 ≈ 信号数 × 每信号开销(~3.5µs),
    与时间点数几乎无关 —— "400 万信号 / 200 个时间点"点数 <256 曾因此每个新进程都重建一次
    (75.6s/次, hit 与 cold 一样慢)。现在"本次建了 ≥150ms"也算数(并行/单进程共用同一
    判据), 暖查询 75.6s → 4.9s(15.6×);电平计数冷查询 75.6s → 21.2s。数字与复现记在
    bench/RESULTS.md。

  • 4M 信号的"名字路径"实测与两处修补: 加了离线基准
    cargo test --release --lib -- --ignored --nocapture fsdb_name_path_4m(不需要波形文件,
    直接造 400 万名字走 encode/decode/建索引/叶子排序), 一跑就露出两个问题:
    ① 叶子名排序 3.5s: 比较器里现算 rsplitn('.') → 每个名字被重复扫描 O(log N) 次;
    改成"先一遍预计算叶子 (偏移,长度), 排序只比字节切片"后 0.36s(9.8×);
    ② .fnames 缓存要额外背 207MB: 改成从文件流式解码进 arena(decode_tree_file),
    多花 ~70ms 换掉 207MB 峰值; 截断/损坏仍当未命中回退走 NPI 树(真波形上验过)。
    4M 信号名字路径现状: encode 56ms → 207MB; 流式 decode 127ms; 建索引 558ms; 叶子排序 360ms;
    内存 arena 199MB + spans 30MB + 索引 96MB + 叶子序 15MB ≈ 340MB(改动前 ≈1.1GB)。
    数字与复现命令记在 bench/RESULTS.md。

  • FSDB 名字存储改 arena + 开放寻址索引(4M 信号级的头号开销): 改动前同一份名字在
    进程里存了四遍(Sig.name 叶子名 / Sig.full 全名 / sig_names[] / HashMap<String,_>
    的键), 微基准口径 280B/信号 → 4M 信号 ≈ 1.1GB;现在名字进连续 arena(每信号只多
    8B 的 (偏移,长度))、索引只存 64 位哈希 + 下标, 73B/信号 → 4M 信号 ≈ 0.3GB(省 74%)。
    读/写 .fnames 缓存也改成直接对 arena 编解码, 省掉 4M 信号下两次几百 MB 的瞬时峰值。
    闸: trace::name_store::per_signal_bytes_stay_small(同时打印新旧口径)。

  • 批处理里按申请的 slot 自动并行冷建: bsub -n N 会导出 LSB_DJOB_NUMPROC, wal-rust
    现在按它(其次 LSB_MCPU_HOSTS, 再其次核数)决定时间线 worker 数(封顶 8), 不用再手设
    WAL_FSDB_TL_JOBS;只在检测到批处理变量时才这样(登录节点仍默认单进程, 不会偷偷吃许可),
    自动开时往 stderr 打一行提示。实测(客机模拟 LSB_DJOB_NUMPROC=8, 200 万时间戳夹具,
    一个进程跑两条 stdin 探针): 21.5s(单进程 40.1s)。

  • FSDB 逐信号变更列有了跨进程缓存(.fcol): FSDB 取某信号的变更列只能重走一遍
    NPI 变更流(npiFsdbTimeBasedVcIter), 以前每个新进程都要为该查询用到的信号重扫一遍,
    与查询复杂度无关 —— 大波形上就是"每次查询都慢"。现在冷扫描后把列(t0 初值放在文件头部,
    取值不必解整列)落盘, 下一个进程直接命中;prepare() 声明的多信号查询同样先吃缓存。
    实测(客机, 200 万时间戳 / 100 万沿夹具, TCG 模拟下偏保守):
    电平计数暖查询 8.6s → 4.1s(2.1×)、沿计数 8.0s → 3.6s(2.2×), 冷查询 48.5s → 36.6s;
    暖查询已逼近"只加载"的 3.2s 底线。

  • 单机并行冷建对"信号少、时间戳多"的波形也生效了: 并行判据曾是"信号数 ≥ 2048",
    于是"一组计数器打满时间轴"(几百毫秒级别的信号数、几千万时间戳)这类波形永远走单进程。
    改成"每个 worker 至少分到一个信号"。实测冷建 40.1s → 24.8s(TL_JOBS=4)/ 21.6s(TL_JOBS=8)。

  • 时间线冷建不再逐块拷贝主表: 每 4096 信号一块, 以前每块结束都把已累积的时间线整份
    拷贝一遍(O(块数 × 主表长) —— 1.88M 信号 = 459 块 × 上千万时间点 = 几十 GB memcpy),
    现在收齐分片后一次归并。

Fixed

  • "边走边扫"的两个坑: WAL_FSDB_WALK_SCAN=0 之前是反的, 判据只看信号数会误伤小夹具。
    ① worker 里用 env_ok("WAL_FSDB_WALK_SCAN") 判"要不要换路", 于是 =0(文档写着"关")反而
    打开了它 —— 现在改成三态判断(0/off/no 关, 1/on/yes 开, 未设才按阈值)。
    ② 进程内与"交给子进程建 .ftl"两条路的判据过去只看信号数(≥200 万), 于是 400 万信号 /
    3.6MB 的合成夹具(只有 200 个时间戳, "按名字解析句柄"那笔钱根本不存在)被拖去走单 walker:
    冷 level 查询 30.6s;现在判据是"信号数 ≥ 阈值 且 文件 ≥ WAL_FSDB_WALK_SCAN_MB(128MB)",
    同一条查询 15.3s(3 次中位数;0.14.35 基线 21.2s)。真波形(336MB / 1796 万信号 / 4377 万
    时间戳)两个条件都满足, 路径与数字不变。回归行见 bench/perf-history.csv。

  • 许可不可用时别再报"缺 libNPI.so": NPI 库加载成功、但 npi_init 因 check out 不到
    Verdi 席位而失败时, 原来的报错头一句是"FSDB 需要 Verdi 的 NPI 读库(libNPI.so)…设置
    $VERDI_HOME" —— 实测库好得很(dlopen 13ms 成功), 照这条线索会白翻安装目录。
    现在按 npi_init 与否分成两种文案: 库缺失照旧;初始化失败明确写"是许可"(并给出
    $SNPSLMD_LICENSE_FILE、scripts/fsdb_env_check.sh、并发 worker 各占一个席位三条线索)。

Docs

  • 新增 docs/fsdb-env.md: FSDB 读写环境/许可/版本兼容运行手册 ——
    两套许可(25A 27080 / 2018 27051)身份互斥、宿主机原生读 FSDB 的启动顺序(run25.sh 起 VM →
    license_up.sh 拉通道, VM 只当许可服务器, 解析在宿主原生跑)、以及四个真实坑
    (SERVER 主机名要换 127.0.0.1、vendor daemon 端口要钉、客机 NixOS 防火墙默认 reject
    会被误判成 FlexLM -16,287
    、起 daemon 前要等旧进程死透否则 lmgrd 只会重试 5 分钟);
    第 8 节是"现场大波形就位后的接收流程"。
  • 新增 scripts/fsdb_env_check.sh(make fsdb-env [FSDB=…]): 一条命令打出"写者版本 /
    magic / 许可(含端口可达性探测) / 真实 open 一次", 拿到别人的波形先跑它。
  • 新增 scripts/fsdb_landing_check.sh(make fsdb-land FSDB=…): 波形到手一条命令做完
    身份 sha256/写者 → 环境与许可 → 磁盘余量 → 冷/建/暖基线(bench_fsdb.sh) → 并行轴
    -j 1|auto|8 → .ftl 逐字节一致性(并行正确性闸)。--quick 只做能读+并行收益。

Docs

  • 新增 docs/fsdb-rust-backend-spec.md: "纯 Rust 读 FSDB 全局
    时间线"的交付范围与验收标准(里程碑 M0–M3、门 G0–G7、锚点值 320,204 点 / .ftl md5
    ca1cb095… / 冷 ≤30s、暖 ≤5s / RSS ≤2GB / fuzz 只许"相同或 Err")。状态是"计划未实现",
    且写清了今天的实测起点(open_meta 在真文件上只认出 60 / 17,956,098 个名字 → G0 红)。
  • bench/RESULTS.md 加"当前性能快照"(v0.14.45): FSDB 冷热加载/取值/边沿/电平/冷建/指标算子、
    400 万信号夹具、VCD 现测, 并写明两个坑(暖路径 10.5↔17.2s 是页缓存波动、不是回归;
    .tools/vm/license_up.sh 报成功后许可可能几分钟内又掉)。
  • docs/README.md 修正与刷新: 修掉"指标算子"那行的列错位、把 waveform-metrics.md 正式登记进
    文档清单、刷新全部行数, 并给新 spec 与"性能数字在哪"加入口。
  • docs/fsdb-env.md §5 补一行判读: "license_up.sh 报成功后一分钟又不可用"的真因与处置
    (宿主 hostfwd 监听一直在, "端口通"≠可用;要在同一次调用里"起来 → 立刻真打开一次")。

Internal

  • trace::name_store: 把 VCD 后端早就有的 NameArena/OpenIndex 提成共享类型, FSDB 后端
    迁到同一套;补了 arena 往返、开放寻址扩容/碰撞、每信号字节数的单测。
  • tests/fsdb_diff.rs::fsdb_col_cache_hit_matches_cold 之前从未真正跑过(需要 Verdi)。
    环境打通后第一次跑就暴露两处测试自身的问题: ①缓存落在 CWD 下的 .wal-rust-cache/, 断言
    却只看工作目录顶层;②没显式设 WAL_CACHE_DIR, 环境里若已有它(CI 会设)缓存就写到别处。
    两条都修掉后, 这个门现在真的在跑(冷/建/命中三次同答 + .fcol 落盘)。
  • scripts/bench_fsdb.sh 修两处: 二进制解析成绝对路径(run 里会 cd, 相对路径会静默 0.00s)、
    查询失败直接报错而不是把 NA 混进回归库(并把之前误写的 14 行清掉)。
  • -j/--jobs 用环境变量而不是进程内 static 传递: src/main.rs 自己 mod trace;
    (二进制 crate 二次编译了一份库代码), 两边的 OnceLock static 不是同一个变量 —— 用 static
    传参会静默失效(踩过: -j 1 照旧开 8 个 worker)。现在 -j 统一写 WAL_FSDB_TL_JOBS,
    两份编译与子进程 worker 都读同一个值。
  • tests/fsdb_diff.rs 新增三个闸: fsdb_col_cache_hit_matches_cold(需 Verdi, 同一查询在
    "不用缓存 / 建缓存 / 命中缓存"三次运行下必须同答且 .fcol 落盘)、
    timeline_map_reduce_matches_single_process_encoding(map/reduce 的 .ftl 与单进程
    逐字节一致 + 归并顺序无关 + 坏分片报错)、timeline_jobs_parsing_is_conservative;
    src/trace/fsdb.rs 增加列缓存编解码往返单测(含 4-state、初值缺失、指纹失效、损坏)。
  • 并行写的缓存临时文件带 PID 后缀: N 个 worker 同时走 FsdbTrace::load 会写同一份
    .fnames, 固定 tmp 名会互相 rename 走半份文件。