VLink  2.3.0
A high-performance communication middleware
🗒️ 更新日志

v2.3.0 (2026/09/30)

新增功能

  • **Proxy 桥接与配置**:支持跨域镜像与下发、URL 过滤及全部启动参数的 JSON 配置;主动采集下发默认关闭,WebViz 本地代理同步支持。
  • **FastBuffer**:新增通用 CPU/GPU 缓冲区、发布池与 CUDA、HIP、hbmem、shm 提供者。
  • **Python 接口补齐**:补齐 ProxyAPI/ProxyServer(含桥接配置)、发现消息循环、Bag 插件、点云与对象数组深拷贝、日志回调重置接口。
  • **Bag 拼包**:新增 vlink-bag merge,支持 clone 的选项、进度显示和覆盖确认。
  • **Bag 分包轮转**:BagWriter::Config 与 vlink-bag record 新增 max_split_count,超限时删除最旧分包。
  • **VCAP 块校验开关**:BagWriter::Config、TriggerRecorder、Python API 与录制 CLI 可启用 MCAP chunk CRC;默认关闭,VDB 不受影响。
  • **DDS 非阻塞发送**:新增 VLINK_DDS_NOBLOCK 与节点属性 dds.noblock,支持发送缓冲区满时丢包而不阻塞。
  • **发现多网卡**:新增 VLINK_DISCOVER_IP,DiscoveryReporter 逐地址发送、DiscoveryViewer 逐地址加入发现组播;未设置时收发仍按系统路由走。
  • **发现进程地址**:ip 改为 ip_list,合并多网卡重复进程,地址按数值排序、独立过期;同步 CLI、Viewer 及绑定,API/ABI 与 Proxy 协议不兼容旧版。
  • **发现域隔离**:新增 VLINK_DISCOVER_DOMAIN(0–255,默认 0),发现端口取 51600 + domain。
  • **日志 PID 隔离**:新增 VLINK_LOG_PID_ENABLE,置 1 时默认日志目录追加 <PID> 子目录,同名多实例不再共享轮转文件集;默认关闭,目录布局与旧版本一致。

改进

  • **消息拷贝**:减少共享内存回复、加密响应及混合类型 RPC 中 Bytes 请求的拷贝,字符串反序列化复用目标缓冲。
  • **基础库热路径**:减少 Base64 解码拷贝、进程缓冲搬移与调度开销。
  • **Python 绑定结构**:按功能拆分绑定实现,保持导入方式不变。
  • **WebViz 重构**:统一消息解析、字段映射与实时/离线转换,支持 Foxglove 全部官方 FBS 类型及 Rerun 数据 Archetype。
  • **Monitor hostname 过滤**:新增 --hostname,按 URL 关联进程的 hostname 关键字筛选。
  • **eproto / efbs 终端显示**:各类订阅内容超过终端显示宽度时主动换行,并在终端尺寸变化时重新分页,暂停状态下同步重排。
  • **Native DDS 地址**:CLI、Proxy、Viewer 与 WebViz 在 native 模式下创建的 DDS 节点从 VLINK_DDS_NATIVE_IP 读取 IP。
  • **vlink-check diag**:VLink 发现项在设置 VLINK_DISCOVER_IP 后校验其地址是否存在于本机,未设置时仍检查 239.255.0.100 路由。
  • **发现热路径**:收包批量投递,快照仅在内容变化时重建,上报按 500ms 节流。
  • **日志热路径**:减少重复初始化检查,回溯回调交换复用缓冲以消除逐条拷贝。
  • **日志环境变量**:VLINK_LOG_ENABLE_UTC 更名为 VLINK_LOG_UTC_ENABLE,语义不变;旧名不再识别,部署环境须同步更新。
  • **发现端口**:发现通道 UDP 基础端口由 51694 改为 51600(实际端口为 51600 + VLINK_DISCOVER_DOMAIN);新旧版本进程互不发现,须同批升级并同步防火墙规则;域 94 的端口与旧版本默认端口重合,滚动升级期间避免使用。
  • **内存池热路径**:free-list 分片数按硬件并发度取值,消除超过 8 线程后的吞吐崩塌;命中与释放计数移入分片锁内,去掉每次分配的原子累加;直通与超大块路径在默认对齐下改用普通 operator new,计数按线程条带化,全哨兵配置跳过档位扫描。
  • **内存池回收**:trim() 改为锁外分组,不再毫秒级阻塞并发分配。
  • **内存池档位**:新增 VLINK_MEMORY_LAZY_SCALE=1 / MemoryPool::Config::lazy_scale(默认关闭),开启后懒增长单次安装上限随档位配额放大;Config 新增字段,使用它的外部 C++ 二进制需重新构建。

修复

  • **Proxy 桥接**:联合主机名、IP 与 machine-id 判断同机,以兼容的发现来源标记防止回流,镜像与下发 Pub 均可发现;绑定参数统一为 allow_ip。
  • **零拷贝**:修复 Client 留存 CPU 响应的载荷生命周期、混合类型 RPC 与 Python 发送丢失 loan 身份,以及自身视图赋值和点云转置覆盖源数据的问题。
  • **Viewer 套件**:修复递归消息与字段编辑、录放状态、图表与三维渲染及资源释放,减少载荷拷贝、重复解析与 URL 扫描。
  • **Extension**:修复 Bag 录放与 Schema、空 Protobuf、URL 重映射、插件启动、SQLite 关闭构建及 OpenSSL 退出期线程资源泄漏,减少 Schema 拷贝。
  • **发现卡顿丢报**:消息循环饥饿时延迟执行而非丢弃发现任务,过期阈值随调度间隔放宽,避免快照误清空。
  • **Proxy 业务线程**:心跳与控制任务迁到 ProxyServer 自身循环,异步转发改用独立循环,避免被批量转发阻塞而心跳断连;订阅拆除增加 3 轮缺失滞回。
  • **时间命名分包**:同一毫秒内按大小连续分包时追加序号,避免 record/clone/merge 覆盖已写分包。
  • **Bag 同戳顺序**:SQLite 读取以录制行序打破相同时间戳的并列,避免复合索引按 URL 重排消息。
  • **Bag 强制录制**:vlink-bag record -g 改为跳过服务发现,直接订阅 -u 指定的 URL 并按原始字节录制;此前仅跳过收集等待,订阅仍依赖发现结果。
  • **通信后端**:修复回调分发、嵌套同步请求死锁、Zenoh 字段通知生命周期与共享订阅暂停隔离;SHM / SHM2 服务命名变更,需同批升级。
  • **公共通信接口**:修复 Field 去重、连接回调取消,以及安全退出的锁顺序死锁。
  • **安全 RPC**:修复同步 Bytes RPC 解密失败仍返回成功,以及同步响应加密失败后自动应答后端发送明文的问题。
  • **Field 录放**:统一触发录制、节点隐式录制(含 Python)、CLI 与 Viewer 的 Field 动作和回放路由,补齐后端角色适配与初值接收;NodeImpl 增加初始化角色,应用、绑定及后端插件需同批重新编译,Proxy 两端需同步更新。
  • **URL 插件赋值**:修复复制赋值后仍保留旧后端配置的问题。
  • **基础任务调度**:修复图依赖传播、移动参数及返回类型推导、协程生命周期与 deferred future 等待。
  • **基础库**:修复并发与生命周期问题,以及计时、终端输出、插件多继承和智能指针识别错误;十六进制输出统一大写。
  • **定时器与日志**:修复定时器计数、回调状态与生命周期;修复 handler/回溯重入、退出期 TLS、首次 Trace、运行期开启文件通道及控制台 flush,磁盘故障后仍可控制台重放。日志宏内联调用的内部接口有变化,应用与日志插件需重新编译。
  • **进程与系统工具**:修复进程参数与回调、键盘与信号处理及退出顺序,以及时区、环境变量、DDS 地址和 macOS 信号量问题。
  • **Python 稳定性**:修复浅视图与空数据深拷贝的生命周期问题,以及满队列投递、日志回调并发替换、Process 重启、Timer 回调释放、异步 RPC 与自定义加解密的并发死锁;补齐 UUID 序列构造。
  • **C API**:修复安全 Getter 更新与读取交叠时的防重放误拒绝,以及 Schema 枚举窄化校验遗漏。
  • **后端初始化清理**:修复 SHM 监听器满载时的异常终止,以及 SHM、SHM2、Zenoh 部分初始化失败后的空对象清理崩溃;Getter 传播接收注册失败并回滚初始化,DDS 双向 Server 拒绝缺失响应 writer 的监听。
  • **日志格式化**:修复 VLOG_* 传入 std::hex 等标准操纵符时的编译错误。
  • **Bag 克隆与退出**:防止克隆覆盖源包及关联文件,修复 RPC 过滤、时间换算和初始化/退出异常;明确单 .vcap 不支持修改标签。
  • **Parse 导出与切片**:修复二进制导出缓冲生命周期和 JSON 错误处理;保护源包及关联文件。
  • **消息调试**:修复 eproto/efbs 刷新丢失、根路径和资源释放问题,支持显式空文本输入,并完善后端初始化失败处理。
  • **Monitor / List / Check**:修正监控采样与过滤统计、同名进程计数和 Cyclone DDS URI 诊断;隐藏 TLS 密码,处理监控重复初始化异常。
  • **Bench 正确性**:修正测量窗口、统计与图表,修复参数校验、取消响应和初始化/JSON 异常处理,保留已有输出目录权限。
  • **Foxglove 协议与路由**:完善多输出路由和动态 Schema 同步,修复发布 ID 冲突、连接图、参数订阅及 RPC 调用状态。
  • **WebViz 数据与退出**:修复退出崩溃、障碍物快照残留及 Rerun 共享实体清理、重连和 YUV 色彩问题;离线导出禁止覆盖源 Bag 及其链接别名。
  • **Monitor 动态刷新**:URL 上下线导致列表排序变化时保持当前选中的 URL 与详情面板;选中 URL 下线时清除选择,避免跳转到其他 URL。
  • **CLI 修复**:bag fix 按实际数据重算计数;parse --hz 在 bag 下按帧时间计时;bench 非法 URL 不再中止进程;trigger 拒绝负毫秒字段。

v2.2.0 (2026/08/30)

新增功能

  • **MessageLoop 回调分发**:intra、FDBUS 与 SOME/IP 节点支持 attach() / detach();intra queue 绑定后直接投递目标 loop。
  • **SOME/IP payload 序列化**:新增 Serializer::kSomeipType 与一组 VLINK_SOMEIP_* 宏,按字段自动生成 Bytes 编解码,覆盖嵌套结构、容器、map、union 与 TLV,并可配置大小端、AUTOSAR alignment 和长度宽度;头文件 include/vlink/extension/someip_serializer.h 需显式包含。
  • **AUTOSAR SOME/IP 生成器**:支持合并多个 ARXML,并可按类型或 package 生成带依赖关系和汇总入口的多个头文件;生成注释保留类型、字段、上限、INIT-VALUE 来源及实际 deployment 信息,直接字段的 maximum 同步用于接收校验或截断。
  • **自研日志后端**:新增公开的 LoggerBackend,支持异步写入、队列背压、周期刷新、固定/时间戳轮转、UTC 和 backtrace。
  • **格式化修饰符**:vlink::format 与 MLOG_* 支持完整的 std::format 风格 spec,含动态宽度/精度、long double、nullptr、format_as 扩展点、{:?} 和返回 std::string 的 format();无效 spec 宽容忽略,不抛异常。

改进

  • **QoS 预设调整**:kLarge 更名为 kStream(URL 名 stream),history 由 KeepLast(500) 调整为 KeepLast(100);kBest 的 history 由 KeepLast(200) 调整为 KeepLast(10),避免饱和链路上过深的写者历史持续重传消费端已追不上的样本。
  • **日志后端配置**:CMake ENABLE_LOG_BACKEND / Conan enable_log_backend 取代原后端选择项;Android/QNX CMake 与 Android.bp 默认使用平台日志,其余构建默认启用自研后端;移除 spdlog、Quill、DLT 及其开关和依赖。
  • **日志后端迁移**:原 CMake SELECT_LOG_BACKEND / Conan select_log_backend 已删除;改用 LoggerBackend 时设置新开关为 ON,在 Android、QNX、Linux 上改用平台日志时设置为 OFF;旧 VLINK_ENABLE_LOG_{SPD,QUI,DLT,NAT} 特性宏不再提供。
  • **日志插件与热路径**:LoggerPluginInterface 新增 flush(),钩子改为 noexcept,修复初始化递归与卸载排空;日志宏通过运行期级别过滤后才求值参数。现有插件需适配并重新编译。
  • **MessageLoop 背压**:普通与优先级满队列阻塞改为在容量释放或退出时唤醒;全局阻塞策略也会响应策略切换,避免固定 1 ms 轮询。
  • **内存池增长粒度**:惰性增长改为按最多 64 KiB(且不小于单块)的小 chunk 安装,限定触发增长线程的单次缺页突发;预分配与分配/释放热路径不变,惰性层 chunk 数量相应增多。
  • **SHM 初始化**:内置内存策略调整为 1 mini / 2 低 / 3 中 / 4 高,默认使用 3;原 1 / 2 / 3 档调用方需对应迁移为 2 / 3 / 4。vlink-check、vlink-bench 与 SHM 单元测试自启 RouDi 时使用 2。

修复

  • **QoS 时间约束默认值**:所有内置 QosProfile 均默认构造 Deadline 与 Lifespan,使其时长字段统一为 -1,避免预设额外施加发布周期约束,并防止跨机时钟偏差导致样本被过早丢弃;自定义 QoS 仍可显式配置有限值。
  • **边界正确性**:自定义日志 handler 异常不再越过 noexcept 边界,C 风格超长日志不再写入截断 NUL;修复 signed __int128_t 构造丢失高 64 位。
  • **RPC 超时判定**:请求按绝对截止时间等待并拒绝截止时间之后到达的响应,避免调度延迟导致超时响应被误判为成功。
  • **SHM 并发发布**:序列化共享同一地址的 Publisher 对底层发布端口的 loan、归还和发送操作,避免多发布者并发破坏端口状态。
  • **Windows 退出挂死**:新增 Utils::is_terminating() 探测进程终止阶段;终止期间各模块单例改为泄漏式释放、析构跳过跨线程清理,避免 ExitProcess 后 DLL 卸载回调中的锁死锁。

v2.1.0 (2026/07/26)

新增功能

  • **日志限频**:C++ 新增线程安全的调用点级 VLOG_{T,D,I,W,E}_EVERY_MS(interval_ms, ...) 宏,支持按周期抑制重复日志且不求值被抑制的日志参数。
  • **CLI/dump 改名**:cli/dump 已彻底改为 cli/parse,命令由 vlink-dump / dump 改为 vlink-parse / parse,构建开关由 ENABLE_CLI_DUMP 改为 ENABLE_CLI_PARSE;不提供旧名称兼容入口。
  • **零拷贝解析**:新增统一的 C++ / Python MessageParser,支持反射解析、零拷贝视图和通用文本渲染;Parse、Viewer、Analyzer、eproto 与 efbs 已接入。
  • **PointCloud**:C++ / Python 新增 get_key_list() 字段描述接口;Python Key.type 返回 PointCloud.Type 枚举。
  • **CameraFrame**:扩展 Raw、Bayer、YUV 和压缩图像格式,新增编码辅助函数、Python 绑定与自动解码模式,线上枚举值保持兼容。
  • **Trigger**:新增 vlink-trigger、TriggerRecorder 及 Python 绑定,支持触发前后数据缓存、Bag 落盘、历史轮转和完成回调插件。
  • **Bag 插件**:新增读会话 on_reset(),回放前补全序列化和 Schema 类型。on_read() / on_write() 改为纯虚函数,并移除版本查询接口;插件仍声明 2.0,但需按新头文件适配并重新构建。
  • **Viewer 感知显示**:新增可配置的 Protobuf / FlatBuffers 消息映射,覆盖目标、雷达、车道、轨迹、停车位、占据栅格和车辆 HUD。
  • **原生 DDS CDR**:支持 FastDDS IDL、ROS 2 消息及按类型名加入 Topic,并支持 CDR 录制、回放和发现上报。

改进

  • **工程布局**:C / Python 绑定源码迁至 languages/c_api/ 与 languages/python_api/;公开构建开关、CMake target、库名和安装布局保持不变。
  • **接收端 loan API 移除**:删除 C++ / Python 的 set_manual_unloan() 与 is_manual_unloan();接收缓冲统一在回调后自动归还,发布侧 loan() / return_loan() 不受影响。
  • **传输后端移除**:删除 modules/ddst 与 modules/qnx,不再支持 ddst:// 和 qnx://;同步移除 DdstConf / QnxConf、对应 TransportType 与启用标志、构建选项、CLI / 补全入口、Python 枚举、测试和文档。QNX 目标操作系统的工具链、原生日志及平台适配不受影响。
  • **公共 API**:TerminalStream 移至 base,并统一 Bag / Trigger 接口命名;旧接口不再保留。
  • **URL 插件**:扩展 VLINK_URL_PLUGINS,支持按需自动加载 transport、关闭加载或显式预加载;运行时包可独立完成动态加载。
  • **Bag**:公开幂等的 BagWriter::close(),并由 Config::sync_mode 统一帧、Schema 和插件输出的写入模式。逐调用 immediate 参数及受保护 record() 签名已调整,外部派生类和既有二进制需适配并重新构建。
  • **Bag 性能**:优化异步写入、回放过滤、Schema 持久化和未启用录制时的热路径。
  • **基础库**:优化 MemoryPool 和任务调度;MemoryPool::Config 新增 batch_size,使用该配置的外部 C++ 二进制需重新构建。
  • **序列化**:新增 Serializer::serialize_to_transport(),修复 transport loan 生命周期并加强边界校验;C 字符串改为仅支持发送,接收端须使用 std::string。
  • **CDR 数据面**:统一使用含 encapsulation header 的字节负载,接收侧在回调期间直接借用 FastDDS payload;C API、Python API 与构建宏同步支持 CDR / ROS 2。
  • **接收回调**:每次投递使用独立值对象,裸 Protobuf 指针也在 Arena 中逐条分配,避免嵌套回调覆盖。
  • **Zenoh**:原生 Key Expression 增加 domain / event 隔离;采用该寻址的新旧版本不能互通,升级时需同步通信两端。未设置环境变量时沿用配置文件默认值;zenoh-pico 构建要求启用 local subscriber、local queryable、liveliness 和 matching。
  • **Viewer / Webviz**:改进多相机解码、感知帧合并、动态 Schema 解析及多种图像格式在 Foxglove / Rerun 中的展示。
  • **Parse**:收紧参数校验,优化 slice / scan 的解析时机、频率限制和同步写入路径,并保证质量与 manifest 输出稳定。
  • **eproto / efbs**:兼容较新 Protobuf 版本,统一默认标量、字段顺序、map 排序和 JSON 输出行为。
  • **构建与基准**:修正无 intra 构建和 lcov 2.x 排除规则;benchmark 可按 payload 调整 shm2 配置,并改进延迟统计与报告分组。

修复

  • **Bytes 压缩**:修复错误地将 1 MiB LZAV 哈希缓存大小当作压缩输入上限的问题。
  • **DDS**:节点释放时清理回调、请求状态和匹配计数,支持同进程重新初始化;安全处理无数据样本,修复 FastDDS 3 与 CycloneDDS 的内置 Raw 类型互操作,同时修正 DDSR liveliness 配置及无 SSL DDSC 的 TCP 误启用。
  • **DDS CDR**:修复类型名兼容、运行中切换类型、RPC 类型一致性、ROS 2 空消息、接收 payload loan 生命周期及旧版 FastDDS 变长 payload 扩容。
  • **SHM / SHM2**:回复路径现在返回真实发送结果;SHM2 正确应用 iceoryx 配置,优化大消息 loan、listener 等待和节点生命周期处理。
  • **VDB / VCAP**:修复多次回放、停止或跳转后的重排缓存污染;新会话通过 on_reset() 清理旧状态,并正确处理自然完成与中断边界。
  • **Bag / Trigger**:修复退出崩溃、队列满时丢写、延迟写入错误未上报,以及已放弃的 Trigger dump 残留或重现。
  • **Parse**:修复插件解绑死锁、live 资源生命周期、slice / scan 边界遗漏、输入输出碰撞、Schema 插件路径加载和 proxy 包大小处理。
  • **图像与 Schema**:加强异常图像尺寸处理;在 efbs、Parse、Viewer 和 Webviz 解码前验证 FlatBuffers Schema 与 payload。
  • **Viewer / Webviz**:修复动态 Schema 生命周期、缺失字段默认值、慢客户端队列增长、Rerun 多格式路由及录制关闭错误上报。
  • **Intra**:修复回调内注销、嵌套投递、同 pipeline RPC 死锁和跨 event 误连接。
  • **Python**:修复状态字典类型读取、零拷贝解析器 use-after-free 和 vlink 模块路径;Bytes 支持负索引。
  • **基础库**:修复 MemoryResource::is_equal() 与外部 PMR resource 比较时的未定义行为。

v2.0.0 (2025/07/01)

  • 初始化源码。