types

type Config struct {
	// 基础配置
	Dimension      int
	IndexType      IndexType
	DistanceMetric DistanceMetric
	StorageType    StorageType
	StoragePath    string

	// 容量配置
	MaxVectors int
	CacheSize  int

	// HNSW 参数
	M              int // 每层最大连接数
	EfConstruction int
	EfSearch       int

	// IVF 参数
	NumClusters int // 聚类数量
	Nprobe      int // 搜索时检查的聚类数

	// 量化配置
	Quantize      bool
	QuantizerType string

	// 性能参数
	NumThreads int

	// Embedding配置
	EmbeddingType  EmbeddingType // Embedding类型（默认bm25）
	EmbeddingField string        // 从Payload中提取文本的字段名（默认"content"）
}

type DistanceMetric string

type EmbeddingType string

type IndexNode struct {
	ID      int
	Vector  []float32
	Deleted bool // 软删除标记
}

type IndexSearchResult struct {
	Node     *IndexNode // 命中的节点
	Distance float32    // 距离值
}

type IndexType string

type SearchOptions struct {
	TopK        int                    // 返回结果数量
	MinScore    float32                // 最小相似度阈值
	MaxDistance float32                // 最大距离阈值
	WithVector  bool                   // 是否返回向量数据
	WithPayload bool                   // 是否返回负载数据
	Filter      map[string]interface{} // Payload过滤条件

}

type SearchResult struct {
	ID       string                 // 向量 ID
	Score    float32                // 相似度分数 (0-1，越大越相似)
	Distance float32                // 原始距离值
	Vector   []float32              // 可选：返回向量数据
	Payload  map[string]interface{} // 可选：返回负载数据
}

type StorageType string

type Vector struct {
	ID        string                 // 向量唯一标识
	Vector    []float32              // 向量数据
	Payload   map[string]interface{} // 元数据/负载数据
	Timestamp time.Time              // 创建时间戳
}