# vdb

**Repository Path**: ledao/vdb

## Basic Information

- **Project Name**: vdb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-03-27
- **Last Updated**: 2025-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VectorDB - 向量数据库

## 项目背景
本项目采用AI代码生成与人机协同审查的协作模式：
- 核心代码由AI生成（GPT-4/Copilot等）
- 人工负责架构设计、代码审查和测试验证
- 关键决策通过人机协作讨论确定

## 安装指南
```bash
# 编译项目
cargo build --release

# 启动服务（默认端口3000）
./target/release/vdb --storage-type=proto # 选项：proto/json
```

## API文档
### 核心端点
- 使用`--storage_type`参数指定集合创建时的存储类型（内存/磁盘）
- 内存存储提供更高性能，磁盘存储支持持久化
- `POST /create_collection` 创建集合
- `POST /insert` 插入向量（格式：(集合名称, [(ID, 向量, 元数据)]))
- `POST /delete` 删除向量（格式：(集合名称, [ID列表]))
- `POST /search` 相似性搜索（格式：(集合名称, 查询向量, topK))
- `POST /close` 关闭集合

## 工具脚本使用
### 插入数据
```bash
python3 tools/client_insert.py 集合名称 ID [0.1,0.2,...] '{"tags":"示例"}'
```

### 删除数据
```bash
python3 tools/client_delete.py 集合名称 ID1 ID2
```

### 相似性搜索
```bash
python3 tools/client_search.py 集合名称 [0.1,0.2,...] 5
```


## 贡献指南
欢迎通过以下方式参与贡献：
1. 创建GitHub issue报告问题
2. 提交AI生成的改进PR（推荐方式）
3. 在讨论区分享AI协作经验

> 特别鼓励：
> - 提交生成代码时注明使用的AI工具
> - PR应包含用于生成代码的完整提示词
> - 复杂功能建议先在讨论区发起提案

遇到问题请立即创建issue！