Zvec v0.4.0 正式发布

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

您可以在 GitHub 上查看完整的 Release Notes。

Dart/Flutter SDK：Zvec 走向移动端

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

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

flutter pub add zvec

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

平台支持：

快速上手：

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 结果上限已大幅放宽，支持更大规模的候选召回场景，便于下游进行精排或重排序处理。

import zvec

result = collection.query(
  vectors=zvec.VectorQuery(
    field_name="dense_embedding",
    vector=[0.1] * 768,
  ),
  topk=70000, # 可以召回更大规模的结果
)

print(result)

改进与修复

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

路线图

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