这里记录可直接查阅的稳定接口与运行约定：
- 配置项参考：CLI、环境变量、
flydb.conf与 Spring Bootflydb.*配置。 - 错误码参考：稳定错误码、常见原因、修复动作和 CLI 退出码。
- CLI 命令参考：全局选项、命令、锁范围和常用流程。
- JSON 输出参考：
--json机器输出信封 schema 与稳定性承诺。 - MCP 工具参考：Flydb MCP Adapter 的工具清单、输入输出约定与安全模型。
- 本机 Web API 与执行记录：GUI 启动、配置快照、操作和事件契约。
- 兼容性矩阵：模块与 Java/Spring Boot 运行环境、数据库方言与驱动、验证层级。
- 命令与 CLI 设计：命令语义、驱动加载和发行包布局；机器契约设计见设计 10。
接入新数据库的操作流程见JDBC 数据库快速接入；方言扩展接口见数据库方言层设计。
Agent 自动化入口见仓库根目录的 AGENTS.md 和 flydb-skills。其中的 flydb-cli 按开放 SKILL.md 格式面向 Claude Code、OpenAI Codex、Gemini CLI、Kimi Code、ZCode、Hermes Agent、Pi 等主流 Agent 复用；它只引用本目录和数据库上手文档，不另行维护命令参数。
配置优先级统一为：
CLI 参数 > FLYDB_* 环境变量 > flydb.conf > 内置默认值