核心能力
该技能提供 SurrealDB 3 的全栈深度支持，从 SurrealQL 查询语言 mastery 到多模型数据建模（文档、图、向量、时序、地理空间），涵盖架构设计、安全权限、性能调优与生产部署。支持 10+ 官方 SDK（JS/TS、Python、Go、Rust、Java、.NET、PHP、Swift、Kotlin、Ruby），并集成 SurrealMCP 供 AI 代理宿主（Claude、Cursor、Copilot、Zed）直接读写数据库。
显著优点
- 多模型统一：单一查询语言同时处理文档、图关系、向量相似度搜索，消除多数据库架构复杂度
- AI 原生集成：内置 MCP 服务器、LangChain 向量存储支持、SurrealML 模型推理，为 RAG 与智能代理优化
- 开发体验完整：提供 doctor.py 健康检查、schema.py 模式自省、LSP/Tree-sitter 编辑器工具链
- 部署灵活：单二进制、Docker、Kubernetes、分布式 TiKV 存储引擎全覆盖
局限性与风险
- 版本迭代快：v3 相对 v2 有破坏性变更（如范围语法），技能需定期同步上游
- 部分功能预览中：SurrealML 部分 API 在 v1.4.1 被撤回，LangChain JS 集成被撤回，依赖 Python 版本
- 权限配置复杂：行级安全、JWT 访问控制需仔细设计，默认 root/root 仅适用于本地开发
- 网络依赖：脚本需连接用户指定的 SurrealDB 端点，生产环境需 TLS 与强认证
适合人群
- 构建 AI 代理系统的开发者（通过 SurrealMCP）
- 需要统一 OLTP + 向量 + 图数据库的技术团队
- 追求 SurrealQL 专家级掌握的架构师与 DBA
安全建议
始终使用 DEFINE USER 创建最小权限用户，生产环境禁用默认 root 凭证，敏感变量通过环境注入而非硬编码。