移动指针扰动粒子 · 滚动切换飞行状态

v0.3.7 · 现在可用

AGENT-SAFE DATABASE CHANGE RUNTIME

让数据库变更
拥有一套安全飞行协议

使用 Agent Skill、CLI、本机 Web 工作台或 Spring Boot Starter。每一次迁移，都从计划、校验和预览开始。

01 推荐入口 · 安装技能族查看技能仓库 ↗ 国内线路 · SkillHub ↗

npx skills add https://github.com/zzxCoding/skills --skill flydb

不用 Agent？CLI 与 Starter 直达 ↓

30 秒快速入手探索 Flydb

8: 内置方言
0: 内核运行时依赖
Java 8+: 存量系统可用

SCROLL TO LAUNCH

01 QUICK START

给 Agent 的 Skill，
给开发者的 CLI

同一套安全协议，两种入口：让 Agent 接管工作流，或直接用 CLI 与 Spring Boot Starter 落进现有工程。

一步安装 Flydb 技能族总入口

AGENT SKILL

npx skills add https://github.com/zzxCoding/skills --skill flydb

国内直连 GitHub 慢？把这段提示词发给 AI 助手，走 SkillHub 国内线路安装技能族：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-cli-release。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-migration-scripts。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-multi-environment。

在 SkillHub 查看技能详情 ↗

然后，对 Agent 说：

“使用 Flydb 帮我检查项目里的迁移脚本，先给出计划和 dry-run 结果，不要直接修改数据库。”

ROUTERflydb

理解诉求并组合工作流

RUNTIMEflydb-cli-release

安装 CLI、校验、执行命令

SCRIPTSflydb-migration-scripts

管理版本、命名与 checksum

DELIVERYflydb-multi-environment

环境矩阵、CI 与离线发布

CLI 发行包 · v0.3.7 · Java 8+ Release Notes ↗

curl -LO https://github.com/zzxCoding/Flydb/releases/download/v0.3.7/flydb-cli-0.3.7.zip

解压后把 JDBC 驱动放入 drivers/，执行 bin/flydb init 生成工程骨架。

下载 flydb-cli-0.3.7.zip 安装指南 ↗

Spring Boot Starter

<dependency>
  <groupId>io.github.zzxcoding</groupId>
  <artifactId>flydb-spring-boot-2-starter</artifactId>
  <version>0.3.7</version>
</dependency>

<dependency>
  <groupId>io.github.zzxcoding</groupId>
  <artifactId>flydb-spring-boot-3-starter</artifactId>
  <version>0.3.7</version>
</dependency>

0.3.7 已发布到 Maven Central，复制对应坐标即可接入 Spring Boot 2 或 3。

02 CLI + LOCAL WEB WORKBENCH

命令行与 Web，
共用一套安全边界

先在本机工作台核对状态与 SQL，再确认执行并查看结果；CLI 真实记录继续保留，便于逐行检查。

bin/flydb web

Flydb 本机 Web 工作台的迁移状态页面 — 来自 Flydb Web 验收记录的真实画面查看 2880 × 1800 高清原图 ↗

真实画面截取自 0.3.7 CLI 内置的本机 Web 工作台。

03 SAFETY PROTOCOL

Agent 决定改什么，
Flydb 守住怎么改

滚动经过每个阶段，变更才会被允许进入下一道闸门。

01 / PLAN

⌁

先看清影响范围

识别目标数据库、待执行脚本、版本边界与潜在风险；任何写入动作都从可审查计划开始。

flydb info

02 / VALIDATE

◇

校验历史，预演未来

checksum 漂移、失败记录和顺序问题会在执行前暴露；dry-run 给人和 Agent 同一份预览。

flydb validate && flydb --dry-run migrate

03 / APPLY

△

获得授权，再执行变更

并发锁、事务语义、稳定错误码和安全密码输入共同约束执行过程；clean 默认禁用。

flydb migrate

04 / VERIFY

✓

用状态闭环，而不是凭感觉

迁移结果、版本状态与退出码构成机器可读证据，适合本地终端、CI 和 Agent 自动化。

flydb info

04 BUILT FOR REAL SYSTEMS

不是另一个漂亮外壳，
而是一套克制的迁移内核

既能进入 Java 8 存量系统，也能进入 Spring Boot 3 和 Agent 工作流；能力扩展，安全边界不打折。

CORE / 00

零依赖 Java 8 内核

flydb-core 不绑定连接池、日志框架或 JDBC 驱动，适配存量系统，也避免把依赖冲突带进业务。

GUARD / 01

危险操作默认关闭

clean 需要双重开关；失败迁移阻断后续执行；密码不进入命令行、日志或 SQL。

CONTRACT / 02

012345

机器真正读得懂

稳定退出码与结构化错误码让 CI 和 Agent 能判断成功、校验失败、配置错误或运行时异常。

STARTERS / 03

BOOT2BOOT3

Spring Boot 2 / 3 分线支持

存量 Java 8 与现代 Java 17 环境各用独立 Starter，启动迁移失败即阻止应用带病上线。

05 DATABASE CONSTELLATION

主流与信创数据库，
在同一条航线上

8 种内置方言；其他 JDBC 数据库可通过 DatabaseType SPI 接入。

查看 JDBC 接入指南 ↗

FLYDB

MyMySQL

PgPostgreSQL

OraOracle

DM达梦 DM8

KBKingbaseES

oGopenGauss

OBOceanBase

TiTiDB

验证状态

支持矩阵不只是图标：每个数据库的验证等级公开分级，真实实例、自动化测试与契约测试如实标注。

数据库	验证等级	说明
Oracle	真实实例端到端	2026-08-14 · 授权真实实例完成 validate、--dry-run migrate、clean、migrate（26 个脚本）端到端验证
OceanBase	真实实例端到端	Oracle 租户已真实实例端到端验证；MySQL 租户为轻量兼容测试
MySQL	自动化测试	自动化兼容测试 + CLI 发行包端到端验证
PostgreSQL	自动化测试	自动化兼容测试
达梦 DM8 / KingbaseES / openGauss	契约测试	方言与驱动元数据契约测试；真实环境认证待补
TiDB	契约测试	轻量兼容测试

Oracle 验证轮次暴露并修复三处方言缺陷： b910409 e314c54 9372d09 查看完整验证记录 ↗

READY START WITH THE SKILL

下一次数据库变更，
从一条安全的安装命令开始

npx skills add https://github.com/zzxCoding/skills --skill flydb 我是开发者 · CLI 与 Starter 入口 → 国内网络？SkillHub 入口 →