核心用法
seekdb 是一款专为 AI Agent 设计的数据库 CLI 工具，支持嵌入式模式（本地库）和服务器模式（远程连接）两种部署方式。通过 seekdb-cli 可执行结构化 SQL 查询、管理向量集合、注册 AI 模型，所有输出均为 JSON 格式，便于程序解析。
主要功能模块：
1. SQL 数据库操作：seekdb sql 执行查询（默认只读），seekdb schema tables/describe 探索表结构，seekdb table profile 分析数据分布，seekdb relations infer 智能推断表间 JOIN 关系
2. 向量/语义搜索：seekdb collection 管理向量集合，支持 query 语义搜索、全文检索、混合检索（RRF 排序），add/get/export 实现数据增删改
3. AI 模型集成：seekdb ai model 注册和管理大语言模型、嵌入模型、重排模型，支持 SiliconFlow、OpenAI、DeepSeek、阿里云、腾讯云等主流供应商
显著优点：
- AI 原生设计：
seekdb ai-guide输出完整 CLI 自描述，AI Agent 可自动学习全部命令 - 安全护栏：自动限制无 LIMIT 查询（>100 行阻断）、写操作需显式
--write标志、禁止危险操作（无 WHERE 的 DELETE/UPDATE、DROP/TRUNCATE） - 智能纠错：SQL 错误自动返回相关表结构提示，加速问题定位
- 敏感数据保护：自动脱敏手机号、邮箱、密码、身份证等字段
- 零配置启动：自动发现连接配置，支持
.env和环境变量
潜在缺点与局限性：
- 平台限制：嵌入式模式不支持 Windows 和旧版 macOS，需改用服务器模式
- 功能边界：作为 CLI 工具，复杂事务管理和可视化分析需配合其他工具
- 依赖外部模型：AI 完成功能需预先配置模型和 API 端点
适合人群：
- AI Agent 开发者构建数据库交互能力
- 数据工程师进行快速数据探查和 Schema 分析
- 应用开发者集成向量搜索和 RAG 功能
- 运维人员管理 OceanBase/seekdb 数据库实例
常规风险：
- 数据误操作：虽有写保护，但
--write标志开启后仍可能因 SQL 错误导致数据变更，建议生产环境配合备份策略 - API 密钥泄露：
seekdb ai model endpoint create需传入 access-key，注意环境变量或配置文件权限管理 - 敏感信息：查询日志记录于
~/.seekdb/sql-history.jsonl，需定期清理避免敏感数据留存