USearch索引容量保存问题分析与修复

在USearch项目v2.12.0版本中，发现了一个关于索引容量保存的重要问题。当开发者使用save_to_stream方法将索引保存到磁盘时，索引的容量信息（nodes_capacity_）未能正确序列化到文件头中，这导致后续加载索引时容量信息丢失。

问题本质

USearch索引在内存中维护了两个关键属性：

1. nodes_capacity_：表示索引预分配的容量大小
2. nodes_count_：表示当前已存储的非空节点数量

在序列化过程中，index_serialized_header_t结构体负责保存索引的元信息。然而，在保存到流时，代码错误地将nodes_count_而非nodes_capacity_写入了文件头。这导致当索引从磁盘重新加载时，系统会错误地将已使用节点数当作总容量，从而可能严重影响索引的性能和扩展性。

影响分析

这个bug会导致以下问题：

1. 索引加载后容量缩小，可能无法容纳原有数据
2. 后续插入操作可能触发不必要的扩容，影响性能
3. 内存使用效率降低，因为预分配的空间信息丢失

解决方案

项目维护者通过提交修复了这个问题，确保在序列化时正确保存nodes_capacity_值。修复后：

1. 保存操作会完整保留原始容量信息
2. 加载操作能正确恢复索引的原始容量
3. 索引的性能特性在保存/加载前后保持一致

最佳实践建议

对于使用USearch的开发者，建议：

1. 升级到包含此修复的版本
2. 对于重要索引，保存/加载后验证容量信息
3. 在性能敏感场景中，注意监控索引的扩容行为

这个修复体现了USearch项目对数据一致性的重视，确保了索引在持久化过程中的完整性，为生产环境中的可靠使用提供了保障。