给那些已经超越了
传统向量数据库的 AI 智能体

# 1. 启动 VecminDB（零外部依赖）



# 官方 GitHub GHCR 源 (海外直连推荐):

docker run -d --name vecmindb -p 5520:5520 -v vecmindb-data:/home/vecminDB/data -e VECMIN__SECURITY__ADMIN_KEY=my-secret-key ghcr.io/lingxinmind/vecmindb:latest



# 备选：国内阿里云极速专线 (中国大陆开发者推荐，免翻墙秒级下载):

# docker run -d --name vecmindb -p 5520:5520 -v vecmindb-data:/home/vecminDB/data -e VECMIN__SECURITY__ADMIN_KEY=my-secret-key crpi-ngtfnt7d3tsnwk7l.cn-shanghai.personal.cr.aliyuncs.com/vecmindb/vecmindb:latest







# 2. 存一条记忆——纯文本，不要向量。内置模型自动处理 Embedding。



curl -X POST http://localhost:5520/api/v1/mcp/message \



  -H "Content-Type: application/json" \



  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"store_memory","arguments":{"text":"Customer #4521 always disputes charges over $50; requires manager approval for refunds","agent_id":"billing"}}}'







# 3. 语义搜索——"who disputes charges" 找到 "always disputes charges over $50"



curl -X POST http://localhost:5520/api/v1/mcp/message \



  -H "Content-Type: application/json" \



  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_memory","arguments":{"query":"who disputes charges","agent_id":"billing"}}}'







# 4. 浏览器打开 Dashboard，看记忆蒸馏实时发生



open http://localhost:5520/dashboard

# docker-compose.yml

# 一键拉起 3 节点 Raft 强一致性分布式集群

version: '3.8'

services:

  node1:

    image: ghcr.io/lingxinmind/vecmindb:latest

    ports: ["5520:5520"]

    volumes: ["vecmin-data1:/home/vecminDB/data"]

    command: ["--node-id", "1", "--raft-addr", "node1:6001", "--peers", "node1:6001,node2:6002,node3:6003"]

  node2:

    image: ghcr.io/lingxinmind/vecmindb:latest

    volumes: ["vecmin-data2:/home/vecminDB/data"]

    command: ["--node-id", "2", "--raft-addr", "node2:6002", "--peers", "node1:6001,node2:6002,node3:6003"]

  node3:

    image: ghcr.io/lingxinmind/vecmindb:latest

    volumes: ["vecmin-data3:/home/vecminDB/data"]

    command: ["--node-id", "3", "--raft-addr", "node3:6003", "--peers", "node1:6001,node2:6002,node3:6003"]



volumes:

  vecmin-data1:

  vecmin-data2:

  vecmin-data3:

# 1. 一键拉起 3 节点 Raft 强一致性分布式集群（自带 30s 极速自愈）

docker compose up -d



# 2. 集群启动自动探测硬件并自动调优，检查集群拓扑健康状态

curl http://localhost:5520/api/v1/cluster/topology



# 3. 分布式多节点高并发存入记忆，数据根据分区哈希路由与重平衡

curl -X POST http://localhost:5520/api/v1/mcp/message \

  -H "Content-Type: application/json" \

  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"store_memory","arguments":{"text":"Internal Audit Secured","agent_id":"cluster"}}}'



# 4. 无损平滑升级集群 (Raft 数据卷自动保留):

docker compose down && docker compose pull && docker compose up -d