Skip to content

v0.14.17

Choose a tag to compare

@hesheng01 hesheng01 released this 20 Sep 14:12
· 71 commits to main since this release

Added

  • 工程外壳: LICENSE(MIT/Apache-2.0)、CHANGELOG、CONTRIBUTING、SECURITY、issue/PR 模板、
    rust-toolchain.toml、.editorconfig、.gitattributes。
  • 本地 CI: make ci(scripts/ci.sh)—— 环境自检 / 文档一致性 / fmt / clippy / build / test /
    语义冻结闸 / 打包冒烟 / 性能冒烟, 本机与 GitHub Actions 跑同一份脚本;失败的阶段会给出日志路径与复跑命令。
  • 文档一致性检查(python3 scripts/check_docs.py, CI 的 docs 阶段): 本地路径引用是否还存在、
    docs/README.md 索引是否收录全部文档、文档里声称的测试数是否与实际一致、面向当前用户的文档是否还在讲旧版本。
  • 发版脚本 scripts/release.sh(make release VERSION=x.y.z): 校验工作区/分支/tag/CHANGELOG →
    跑本地 CI → glibc 2.17 交叉构建 → 推送 → 创建 release;make release-dry 可演练。
  • CI 徽章与文档地图: README 重写为项目门面(安装/上手/速查/口径/架构/性能),docs/README.md 作为文档唯一入口。
  • 历史归档目录 docs/history/ 与"历史文档不追改"的约定(带横幅的文档, 其过时路径由 CI 降级为提示)。

Fixed

  • (slice x start end) 在 start >= end 时崩溃: (slice (list 0 1 2 3 4 5 6 7) 3 0) 直接
    panic(slice index starts at 3 but ends at 0);字符串分支还会错取((slice "hello" 3 1) → "lo")。
    现在按空区间返回 ()/""。回归: matrix_slice_reversed_range_is_empty。
  • 含 % 的源码里中文被双重编码(mojibake): % 归一化(% → mod )的实现逐字节
    push(b as char),把 UTF-8 的多字节序列映射成 Latin-1 —— 于是 (printf "信号: %s\n" 42)
    打印 ä¿¡å·: 42,而不带 % 的中文正常(所以长期没被发现)。现在按字节切片拷贝原串。
    回归: matrix_percent_normalize_keeps_utf8(同时冻结 (% a b) ≡ (mod a b) 与 %% 行为)。
  • 多文件/缓存/打包相关的三处修复见 [0.14.8] 与 [0.14.9]。

Changed

  • Cargo.lock 纳入版本控制(二进制项目需要可复现构建)。
  • 仓库根目录清理: 散落的实验脚本归位(examples/wal/、bench/、test_samples/),
    删掉无人引用的 verify.sh(旧的工程结构检查, 已被 make ci 取代)、
    误命名的 analysis(内容其实是个 VCD 夹具)、以及已废弃的 C++ 垫片
    src/trace/fsdb_shim/(404 行, 纯 Rust FFI 取代后无人引用;垫片源码见历史提交 b993d8c)。
  • test_samples/ 重写为真正能跑的脚本: 旧入口引用了两个不存在的 .wal 与不存在的
    test_data/, 必然失败;现在自包含脚本直接跑, 需要波形的脚本用 -l/WAVE= 提供。

Docs

  • 全量文档审计(93 条: 断链 15 / 版本过时 8 / 与实现不符 31 / 已完成却写成 TODO 8 / 自相矛盾 15 /
    重复 6 / 结构 10)并逐条修复: 见 docs/README.md 的状态约定与 CHANGELOG 下方各版本条目。
  • 重点纠正的事实错误: 0 是假值(README 原写"0 为真")、多文件同名信号先 -l 的为准
    (README 原写"以后加载的为准")、count/find 是逐索引语义(迁移文档原写"变化点采样")、
    FSDB 自 0.14.x 起已支持(复盘文档仍写"被拒绝")、TS 返回的是 INDEX 而非时间戳、
    手册里 22 个"标准库宏"其实未随 wal-rust 发布(std/ 不存在)、(signals) 等小写形式不存在(只认大写)。
  • docs/README.md: 10 篇文档的索引(性质/状态/读者);新增文档必须登记。
  • 手册 MOC 修正(补 8.3、锚点错位)、convert 从"现存操作符"移除、&&/|| 返回值更正为 true/false。