用途：seekdb-cli 是面向 AI 智能体的命令行数据库客户端，用于通过 shell 命令与 seekdb/OceanBase 数据库交互。输出为 JSON 结构化、无状态，并带有内置安全护栏。
主要能力：可用 SQL 查询与写入数据库；探索表结构与统计信息；推断表间 JOIN 关系；管理向量集合并进行混合、语义或全文检索；添加、导出集合数据；注册 AI 模型与端点并调用文本补全；通过 ai-guide 获取结构化命令指南。
安装：推荐 pipx install seekdb-cli；也可 pip install seekdb-cli。Ubuntu 23.04+ / Debian 12+ 系统级 pip 受 PEP 668 限制，建议用 pipx。seekdb 与 seekdb-cli 共享同一入口点。
连接：DSN 优先级为 --dsn 参数（须在子命令前）、SEEKDB_DSN 环境变量、当前目录 .env、~/.seekdb/config.env，默认使用嵌入式 ~/.seekdb/seekdb.db。嵌入式模式需 Linux（glibc ≥ 2.28）或 macOS 15+；其他系统请用远程 DSN，如 seekdb://user:pass@host:port/db，可附加 ?tls=skip-verify|required|verify-ca|verify-identity。嵌入式格式为 embedded:<path>[?database=<db>]。
使用方式：先运行 seekdb ai-guide 了解全部命令与工作流。表探索可按 schema tables、schema describe、table profile、relations infer、sql 顺序进行；向量集合按 collection list、collection info、query 进行。输出默认 JSON，可用 --format 切换 table/csv/jsonl（须在子命令前）。
限制与安全：无 LIMIT 的查询若超过 100 行会被阻止；写入操作默认被拦截，需加 --write，且无 WHERE 的 DELETE/UPDATE 仍被阻止；TEXT/BLOB 默认截断为 200 字符，可用 --no-truncate；敏感字段自动脱敏；所有命令记录到 ~/.seekdb/sql-history.jsonl。退出码 0 成功、1 业务错误、2 用法错误。