feat: unify Insert/Update/Delete API for SQL and vector databases

- Remove all preset constructors (QdrantHighPrecision/HighSpeed/Balanced)
- Remove all preset constructors (MySQLWithUpsert/WithIgnore)
- Remove InsertPoint/InsertPoints methods (not needed)
- Support []float32/[]float64 in InsertBuilder and UpdateBuilder
- JsonOfDelete() auto-sets built.Delete flag internally
- Add Built.SqlOfUpsert() and Built.SqlOfInsertIgnore() convenience methods
- Smart format detection in QdrantCustom for Insert(func) API

Complete API Unification:
- Insert(func) works for both SQL and Qdrant
- Update(func) works for both SQL and Qdrant
- JsonOfDelete() works without extra Delete() method
- Only NewQdrantCustom() and NewMySQLCustom() constructors

Design Philosophy: Don't add concepts to solve problems.
Let users configure via fields or existing closures (QdrantX).

All 140+ tests passing. Documentation fully updated.

Author: sim-wangyan

README.md

@@ -41,24 +41,44 @@ sql, args := built.SqlOfUpsert()
 // INSERT INTO users ... ON DUPLICATE KEY UPDATE ...
 
 // Qdrant Vector Search (v1.1.0)
-// 方式1: 使用默认 Custom
 built := xb.Of(&CodeVector{}).
     Custom(xb.NewQdrantCustom()).
     Eq("language", "golang").
     VectorSearch("embedding", queryVector, 10).
+    QdrantX(func(qx *xb.QdrantBuilderX) {
+        qx.HnswEf(512).ScoreThreshold(0.85)  // 配置参数
+    }).
     Build()
 json, _ := built.JsonOfSelect()
 
-// 方式2: 使用 QdrantX 闭包配置（推荐）
+// Qdrant CRUD (v1.1.0) - 与 SQL 完全一致的 API
+// Insert
 built := xb.Of(&CodeVector{}).
     Custom(xb.NewQdrantCustom()).
-    Eq("language", "golang").
-    VectorSearch("embedding", queryVector, 10).
-    QdrantX(func(qx *xb.QdrantBuilderX) {
-        qx.HnswEf(512).ScoreThreshold(0.85)
+    Insert(func(ib *xb.InsertBuilder) {
+        ib.Set("id", 123).
+           Set("vector", []float32{0.1, 0.2, 0.3}).
+           Set("language", "golang")
     }).
     Build()
-json, _ := built.JsonOfSelect()
+json, _ := built.JsonOfInsert()
+
+// Update
+built := xb.Of(&CodeVector{}).
+    Custom(xb.NewQdrantCustom()).
+    Eq("id", 123).
+    Update(func(ub *xb.UpdateBuilder) {
+        ub.Set("language", "rust")
+    }).
+    Build()
+json, _ := built.JsonOfUpdate()
+
+// Delete
+built := xb.Of(&CodeVector{}).
+    Custom(xb.NewQdrantCustom()).
+    Eq("id", 123).
+    Build()
+json, _ := built.JsonOfDelete()
 
 // Standard SQL (no Custom needed)
 built := xb.Of(&User{}).

builder_insert.go

@@ -66,6 +66,9 @@ func (b *InsertBuilder) Set(k string, v interface{}) *InsertBuilder {
 		// Vector 类型：不做处理，保持原样
 		// 让 database/sql 调用 driver.Valuer 接口
 		// Vector.Value() 会返回正确的数据库格式
+	case []float32, []float64:
+		// ⭐ 向量数组：保持原样（用于 Qdrant/Milvus）
+		// 不做 JSON 序列化
 	case interface{}:
 		bytes, _ := json.Marshal(v)
 		v = string(bytes)

builder_update.go

@@ -69,6 +69,9 @@ func (ub *UpdateBuilder) Set(k string, v interface{}) *UpdateBuilder {
 		// Vector 类型：不做处理，保持原样
 		// 让 database/sql 调用 driver.Valuer 接口
 		// Vector.Value() 会返回正确的数据库格式
+	case []float32, []float64:
+		// ⭐ 向量数组：保持原样（用于 Qdrant/Milvus）
+		// 不做 JSON 序列化
 	case interface{}:
 		bytes, _ := json.Marshal(v)
 		v = string(bytes)

doc/CUSTOM_INTERFACE_README.md

@@ -206,7 +206,7 @@ var custom xb.Custom
 
 switch config.VectorDB {
 case "qdrant":
-    custom = xb.QdrantBalanced()
+    custom = xb.NewQdrantCustom()
 case "milvus":
     custom = NewMilvusCustom()
 case "weaviate":
@@ -256,10 +256,18 @@ built := xb.Of("t").
 ### Qdrant（官方支持）
 
 ```go
-xb.QdrantDefault()       // 默认配置
-xb.QdrantHighPrecision() // 高精度
-xb.QdrantHighSpeed()     // 高速
-xb.QdrantBalanced()      // 平衡
+// 基础构造函数
+xb.NewQdrantCustom()  // 默认配置
+xb.NewMySQLCustom()   // 默认配置
+
+// 手动配置
+custom := xb.NewQdrantCustom()
+custom.DefaultHnswEf = 512
+
+// 或使用闭包
+xb.Of(...).QdrantX(func(qx *QdrantBuilderX) {
+    qx.HnswEf(512)
+})
 ```
 
 ### 用户自定义

doc/CUSTOM_QUICKSTART.md

@@ -482,13 +482,13 @@ func main() {
 
     switch os.Getenv("VECTOR_DB") {
     case "qdrant":
-        custom = xb.QdrantBalanced()
+        custom = xb.NewQdrantCustom()
     case "milvus":
         custom = NewMilvusCustom()
     case "weaviate":
         custom = NewWeaviateCustom()
     default:
-        custom = xb.QdrantBalanced()
+        custom = xb.NewQdrantCustom()
     }
 
     // ⭐ 统一的查询构建

doc/CUSTOM_VECTOR_DB_GUIDE.md

@@ -207,7 +207,7 @@ json, _ := built.ToMilvusJSON()  // 自动使用默认 Custom
 var custom xb.Custom
 switch config.VectorDB {
 case "qdrant":
-    custom = xb.QdrantBalanced()
+    custom = xb.NewQdrantCustom()
 case "milvus":
     custom = xb.NewMilvusCustom()
 case "weaviate":
@@ -367,7 +367,7 @@ built := xb.Of("code_vectors").
     Build()
 
 // ⭐ 只需切换 Custom
-qdrantJSON, _ := built.Custom(xb.QdrantBalanced()).JsonOfSelect()
+qdrantJSON, _ := built.Custom(xb.NewQdrantCustom()).JsonOfSelect()
 milvusJSON, _ := built.Custom(xb.NewMilvusCustom()).JsonOfSelect()
 weaviateJSON, _ := built.Custom(xb.NewWeaviateCustom()).JsonOfSelect()
 ```
@@ -594,7 +594,7 @@ func SearchDocuments(config Config, query string) ([]Document, error) {
     var custom xb.Custom
     switch config.VectorDB {
     case "qdrant":
-        custom = xb.QdrantBalanced()
+        custom = xb.NewQdrantCustom()
     case "milvus":
         custom = xb.NewMilvusCustom()
     case "weaviate":
@@ -657,10 +657,9 @@ func (c *QdrantCustom) ToJSON(built *Built) (string, error) {
     return built.toQdrantJSON()
 }
 
-// 预设模式
-func QdrantHighPrecision() *QdrantCustom { ... }
-func QdrantHighSpeed() *QdrantCustom { ... }
-func QdrantBalanced() *QdrantCustom { ... }
+// 使用说明：
+// 1. 基础构造函数：NewQdrantCustom()
+// 2. 手动配置字段或使用 QdrantX() 闭包
 ```
 
 ---

doc/QDRANT_FULL_CRUD_SUMMARY.md

@@ -135,13 +135,12 @@ json, _ := built.JsonOfUpdate()
 ### 3. **DELETE - 删除向量**
 
 ```go
-built := xb.X().
+built := xb.Of(&CodeVector{}).
     Custom(xb.NewQdrantCustom()).
     Eq("id", 456).
     Build()
 
-built.Delete = true
-
+// ⭐ JsonOfDelete() 自动设置 Delete = true
 json, _ := built.JsonOfDelete()
 ```
 
@@ -158,7 +157,7 @@ json, _ := built.JsonOfDelete()
 
 ```go
 built := xb.Of(&CodeVector{}).
-    Custom(xb.QdrantHighPrecision()).
+    Custom(xb.NewQdrantCustom()).
     Eq("language", "golang").
     VectorSearch("embedding", queryVector, 10).
     Build()

doc/XB_ORM_PHILOSOPHY.md

@@ -164,7 +164,7 @@ switch config.Database {
 case "oracle":
     custom = oracle_custom.New()
 case "mysql":
-    custom = xb.MySQLWithUpsert()
+    custom = xb.NewMySQLCustom()
 case "postgresql":
     custom = nil  // 默认即可
 }