用途:在前后端开发与测试过程中,让 AI 代理立即查看开发数据库中的数据,支持“DB 确认”“数据查询”“表查询”“SQL 执行”“数据验证”等触发场景。
主要能力与安全分层:Tier 1 仅 SELECT 可由 AI 直接执行并返回结果,未指定 LIMIT 时自动加 LIMIT 100,复杂模式可参考 query-patterns.md;Tier 2 的 INSERT/UPDATE/DELETE 只生成 SQL 并说明目标、条件与确认用 SELECT,用户自行在 CLI 执行;Tier 3 的 DROP/ALTER/TRUNCATE/CREATE 不生成,提示改用迁移技能 /peach-db-migrate。仅允许开发环境,使用 env.local.yml 或 env.dev.yml,禁止使用 env.prod.yml 的 DATABASE_URL。
用法:先判断数据库类型。Node/Java 项目在 env.yml 中查找 DATABASE_URL,postgresql:// 走 PostgreSQL,mysql:// 走 MySQL;PHP 项目在 conf.php 中查找 db_host 等变量,db_division 为 pdo/mysqli 走 MySQL,postgresql 走 PostgreSQL。随后解析连接信息并解码 URL 特殊字符,PostgreSQL 用 PGPASSWORD='[password]' psql -h [host] -p [port] -U [user] -d [db] -c "[SQL]",MySQL 用 mysql -h [host] -P [port] -u [user] -p'[password]' [db] -e "[SQL]"。CLI 安装方面,macOS 用 brew install libpq 或 brew install mysql-client 并配置 PATH(libpq 为 keg-only),Linux 用 apt-get install -y postgresql-client 或 mysql-client,Windows 仅可用 Docker 回退,如 docker run --rm postgres:16 psql ...,MySQL 为 docker run --rm mysql:8 mysql ...。结果优先用 psql 默认表格输出,列过多时用 -x 扩展模式。
限制:仅限开发环境只读查询;DML 需人工执行;DDL 禁止生成;未提供生产使用、权限管理、连接池或具体价格等信息。