KameleonDB

核心功能

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 是一款专为 AI Agent 打造的无模式（Schema-less）结构化数据存储工具。用户通过简单的 CLI 命令即可完成从数据建模到查询分析的全流程操作。核心使用模式为：使用 schema create 动态定义实体类型 → 通过 data insert 存储记录 → 借助 schema alter 随时添加新字段 → 利用 query run 执行标准 SQL 查询。支持 SQLite（本地零配置）和 PostgreSQL（生产环境）两种后端，数据以 JSONB 格式灵活存储，字段类型和约束可随时扩展。

显著优点

零迁移成本：无需预定义完整 Schema，发现新字段时即时添加，历史记录自动兼容，彻底解决传统数据库的迁移痛苦。Agent 原生设计：CLI 输出支持 --json 机器可读格式，内置 Schema 上下文生成辅助 SQL 编写，查询性能自动提示优化建议。关系型查询能力：完整支持 JOIN、过滤、排序等 SQL 操作，可通过 link/unlink 构建多对多关系。审计追踪：每次 Schema 变更自动记录原因和时间，形成完整的决策日志。轻量部署：SQLite 版本无需服务器，单文件即可运行，适合个人 Agent 和快速原型。

潜在缺点与局限性

外部依赖风险：Skill 本身为纯文档，实际数据操作依赖外部 kameleondb CLI 工具，其安全性不在本 Skill 审计范围内，需用户自行验证。来源可信度：维护者为个人开发者（T3），长期维护能力和企业级支持存疑。性能边界：SQLite 在高并发场景下性能受限，大规模应用需迁移至 PostgreSQL 并自行运维。无内置备份：文档未提及数据备份机制，用户需自行制定容灾策略。学习曲线：虽免除 Schema 设计，但 SQL 查询和性能优化仍需一定数据库基础。

适合的目标群体

• AI Agent 开发者：需要为 Agent 构建长期记忆和知识库的开发者
• 快速原型团队：产品初期需求不稳定，需要频繁调整数据结构的创业团队
• 个人效率用户：希望用数据库管理联系人、任务、笔记，但不想学习复杂数据库技术的个人用户
• 数据集成场景：需要存储 API 响应、爬虫结果等半结构化数据的工程师
• 轻量级 CRM/PM 需求：不想部署复杂系统，但需要基础客户关系或项目管理功能的小团队

使用风险

运行时安全风险：Skill 仅提供文档指导，实际执行的是外部 CLI 工具，需确保从官方 PyPI 安装并验证 GitHub 仓库完整性。配置安全：数据库 URL 可能包含密码，必须使用环境变量 KAMELEONDB_URL 配置，避免硬编码泄露。数据持久性：SQLite 为文件级数据库，单文件损坏可能导致全部数据丢失，建议定期备份。版本兼容性：上游工具更新可能引入 Breaking Changes，建议订阅 Release 通知并测试后再升级。权限边界：CLI 工具需要数据库文件读写权限，在多用户环境中需妥善设置文件权限，防止未授权访问。