Repository navigation
NeuG v0.3.1 Release Notes
Released: 2026-11-09 (since v0.3.0, 2026-10-26)
A patch release focused on runtime stability, extension usability, and release-pipeline hardening.
Highlights
- Extensions auto-load on database open (#1162): installed extensions are loaded automatically when a database is opened — no manual
INSTALL/LOADneeded. - Faster, safer HNSW vector index (#1190, #1170): HNSW writes are buffered and index updates optimized within transactions; concurrent reads/writes no longer hit unavailable vectors.
- Linux symbol hygiene (#1161):
libneug.sono longer re-exports bundled OpenSSL symbols, avoiding clashes with host applications. - Windows hardening (#1163, #1177, #1182): fixed the Node SDK extension
LOADerror 127 (extension home + mimalloc ABI);vector_searchnow builds and tests on Windows, including ARM64. - Release pipeline (#1187, #1166, #1192, #1199, #1205): the release workflow reuses validated dry-run artifacts, a version-consistency gate guards every package run, and self-hosted ARM64 wheel packaging is fixed.
New Features
- Auto-load extensions when opening a database (#1162)
Bug Fixes
- Raise a clean binder error for single-argument
properties(n)instead of segfaulting (#1189) - Cast or reject mismatched column types in
COPY FROMsubquery (#1188) - Handle unavailable HNSW vectors during concurrent reads and writes (#1170)
- Silence misleading logs during normal database lifecycle (#1158)
- Stop re-exporting bundled OpenSSL symbols from
libneug.so(Linux) (#1161) - Fix Windows Node SDK extension
LOADerror 127 (extension home + mimalloc ABI) (#1163) - Build and test
vector_searchon Windows ARM64 (#1182) - Package and publish ABI-compatible extensions (#1155)
Performance & Refactoring
- Buffer HNSW writes and add transactional index optimization (#1190)
- Unify build image tags onto
2026.03.13-2(#1179)
CI & Release
- Consolidated platform test and package/release workflows (#1147); CI Plan runs on self-hosted runners (#1172)
- Automated version bump with a version-consistency CI gate (#1166); preserved v-prefixed versions and moved version-check into
package.yml(#1192) - Release workflow reuses dry-run package artifacts (#1187)
- Java client dry-run pins Maven 3.9.16 and validates the Central bundle (#1165)
- DingTalk notifications for release and nightly workflows (#1184)
linux_wheelcibuildwheel runs on a glibc-compatible host Python (#1199); Python is prepared on self-hosted ARM64 runners before wheel packaging (#1205)- Restored Linux npm workspace ownership after packaging (#1196); run macOS/Windows build tests in forks (#1186); limited credentialed OSS export tests to Linux (#1181)
- Discovered extension C++ tests and aligned HNSW test linking (#1194); tolerated FP32 rounding in the cosine distance test (#1203)
Documentation
NeuG v0.3.1 发布说明
发布日期:2026-11-09(自 v0.3.0,2026-10-26 以来)
一个聚焦运行时稳定性、扩展可用性与发布流水线加固的补丁版本。
亮点
- 打开数据库时自动加载扩展(#1162):打开数据库即自动加载已安装扩展,无需手动
INSTALL/LOAD。 - 更快、更安全的 HNSW 向量索引(#1190、#1170):HNSW 写入改为缓冲并在事务内优化索引更新;并发读写不再命中不可用向量。
- Linux 符号卫生(#1161):
libneug.so不再重新导出内置的 OpenSSL 符号,避免与宿主应用冲突。 - Windows 加固(#1163、#1177、#1182):修复 Node SDK 扩展
LOADerror 127(extension home + mimalloc ABI);vector_search现可在 Windows(含 ARM64)构建与测试。 - 发布流水线(#1187、#1166、#1192、#1199、#1205):发布工作流复用已验证的 dry-run 产物,版本一致性门禁守护每次打包,修复自托管 ARM64 wheel 打包。
新特性
- 打开数据库时自动加载扩展(#1162)
缺陷修复
- 单参数
properties(n)现抛出清晰的 binder 错误,而非段错误(#1189) COPY FROM子查询中对不匹配的列类型进行转换或拒绝(#1188)- 处理并发读写期间不可用的 HNSW 向量(#1170)
- 消除正常数据库生命周期中的误导性日志(#1158)
- 停止从
libneug.so(Linux)重新导出内置 OpenSSL 符号(#1161) - 修复 Windows Node SDK 扩展
LOADerror 127(extension home + mimalloc ABI)(#1163) - 在 Windows ARM64 上构建并测试
vector_search(#1182) - 打包并发布 ABI 兼容的扩展(#1155)
性能与重构
CI 与发布
- 整合平台测试与打包/发布工作流(#1147);CI Plan 运行在自托管 runner 上(#1172)
- 自动化版本 bump 并新增版本一致性 CI 门禁(#1166);保留 v 前缀并将 version-check 迁入
package.yml(#1192) - 发布工作流复用 dry-run 打包产物(#1187)
- Java 客户端 dry-run 固定 Maven 3.9.16 并校验 Central bundle(#1165)
- 为发布与 nightly 工作流添加钉钉通知(#1184)
linux_wheel的 cibuildwheel 运行在 glibc 兼容的宿主 Python 上(#1199);wheel 打包前在自托管 ARM64 runner 上准备 Python(#1205)- 恢复打包后 Linux npm 工作区所有权(#1196);在 fork 中运行 macOS/Windows 构建测试(#1186);将带凭证的 OSS 导出测试限定在 Linux(#1181)
- 发现扩展 C++ 测试并对齐 HNSW 测试链接(#1194);容忍 cosine 距离测试中的 FP32 舍入(#1203)