KameleonDB

🦎 Agent 原生无模式数据库,存数据即建 Schema

面向 Agent 的无模式数据库,支持动态 Schema 演进、SQL 查询与关系追踪,无需预设计即可构建持久化知识库与 CRM 系统

收藏
5.1k
安装
2.5k
版本
0.1.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

KameleonDB 是一款专为 AI Agent 设计的无模式(schema-less)关系型数据库,核心价值在于 "存储即设计" —— 无需预先定义完整 Schema,可随时根据业务发现动态添加字段,历史数据自动兼容。

核心用法流程
1. 初始化kameleondb admin init 快速部署(SQLite 零配置,或 PostgreSQL 生产环境)

2. 动态建表schema create <Entity> 定义实体,字段支持 string/int/float/bool/datetime/json 及修饰符 required/unique/indexed

3. 演进式扩展schema alter <Entity> --add/--drop/--rename 持续迭代,带 --reason 审计追踪

4. 数据操作data insert/get/update/delete/list 标准 CRUD,支持 --from-file 批量导入

5. 关系管理data link/unlink/get-linked 实现多对多关系,无需外键约束

6. SQL 查询query run 直接执行 SQL,JSON 字段通过 data->>'field' 语法访问

7. 性能优化:查询自动提示 storage materialize 物化建议,加速大数据量场景

显著优势

  • 零迁移成本:Schema 变更即时生效,旧记录自动填充 null,软删除保留历史
  • Agent 原生设计--json 全局支持机器可读输出,Schema Context 辅助 LLM 生成准确 SQL
  • 审计完备admin changelog 完整记录谁在何时因何修改了 Schema
  • 轻量部署:SQLite 单机运行,PostgreSQL 无缝升级,无额外基础设施依赖

局限与风险

  • 功能边界:非分布式数据库,无内置高可用/分片机制,TB 级数据需手动优化
  • JSON 查询限制:复杂 JSON 路径查询依赖 PostgreSQL 特定语法,SQLite 性能受限
  • 关系完整性:无级联删除/外键约束,需应用层维护引用一致性
  • 安全风险--force 强制删除字段不可逆,生产环境建议开启 admin changelog 监控

适用场景:Agent 记忆持久化、轻量级 CRM/项目管理、知识库构建、API 数据缓存、用户偏好存储。特别适合需求快速迭代、Schema 不确定的探索性项目。

不适合场景:金融级事务一致性要求、高并发写入(>1000 QPS)、复杂 OLAP 分析(建议导出至专用数仓)。

KameleonDB 内容

examples文件夹
手动下载zip · 9.4 kB
schema.jsonapplication/json
请选择文件