一、运行当前完整测试
Shell
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release --parallel
ctest --test-dir build -C Release --output-on-failure覆盖 Writer 和 WriteSession 的字节、边界、发布、背压与生命周期；读端的完成块优先、current 快照、定向通知、拒收重试与退出；内存池及块资源的所有权、对齐、代号、归还和回收；SPSC / MPMC 交接与并发完整性；完整双层流程和全部有效示例。
每个用例独立注册 CTest。通过一个子集或矩阵中的一项不等于完整套件通过。线程测试的超时用于防止死锁，不能当作性能或尾部延时结论。
二、单独检查一部分
Shell
ctest --test-dir build -C Release -L read_ctrl --output-on-failure
ctest --test-dir build -C Release -R '^read_ctrl_notification_' --output-on-failure
ctest --test-dir build -C Release -R '^read_ctrl_single_' --output-on-failure
ctest --test-dir build -C Release -L catalog --output-on-failure机器可读 cases.json 与对应 Markdown 表格保持一致，其中历史场景文字保留原中文。测试标识和实际可运行代码共用一份，源码注释和诊断使用英文；它们不是另一套中文实现。
三、历史记录与平台范围
读端历史检查按日期区分当时覆盖范围。发布检查记录和此前验证数据保留实际平台、命令和限制，不能把旧子集数量当作今天的完整测试数量。
Linux、Windows、macOS 及 sanitizer / 可选开源 SPSC 对照的 CI 已配置，远程执行要等仓库发布并实际运行。文档和界面翻译不改变库的非注释 C++ 内容，也不修改历史测量的源码快照。