Zvec v0.4.0 正式发布

DashVector2026-05-11 14:14

Zvec v0.4.0 正式发布，带来官方 Dart/Flutter SDK（支持 Android 与 iOS）。本版本同时放宽了 topK 上限以支持大规模召回场景，强化了 Windows 和 iOS 跨平台稳定性，进一步提升代码质量标准。

完整 Release Notes 请查看 GitHub。

Dart/Flutter SDK：Zvec 走向移动端

Zvec v0.4.0 发布了第一个官方 Dart/Flutter SDK，让 Android 和 iOS 应用能够直接内嵌 Zvec，在移动端实现进程内高速向量检索。

该包已发布至 pub.dev，一行命令即可集成：

csharp 复制代码

flutter pub add zvec

SDK 基于 dart:ffi 构建，支持同步向量操作。原生库在构建时自动下载，终端用户无需手动编译任何原生代码。

平台支持：

平台	架构
Android	arm64-v8a
iOS	arm64

快速上手：

ini 复制代码

import 'package:zvec/zvec.dart';

Zvec.initialize();

final schema = CollectionSchema(name: 'demo', fields: [
  FieldSchema.vector('embedding', dimension: 128),
  FieldSchema.string('title'),
]);

final collection = Collection.createAndOpen('/path/to/db', schema);

// 插入、查询、获取 ...

collection.close();
Zvec.shutdown();

扩大 topK 上限

单次查询的 topK 结果上限已大幅放宽，支持更大规模的候选召回场景，便于下游进行精排或重排序处理。

ini 复制代码

import zvec
result = collection.query(  
 vectors=zvec.VectorQuery(
  field_name="dense_embedding",
  vector=[0.1] * 768,
 ),
 topk=70000, # topK限制扩大后的一个样例
 include_vector=False,
)
print(result)

改进与修复

SQ8 量化器召回率：修复了因 SQ8 量化器元数据计算中缺失 int8 取整逻辑而导致的召回率下降问题。
Windows 兼容性 ：修复 MakePath 在驱动器根路径下的处理逻辑；新增 GetLastErrorString() 辅助函数，提供更精准的系统错误信息。
Collection 路径限制：放宽了对 collection 存储路径过于严格的校验约束，支持更灵活的部署配置。

路线图

如需了解 Zvec 未来的规划方向------包括存储可扩展性、更多算法支持以及更多语言 SDK------欢迎访问我们的官方路线图。