用途:db-tool(Database)用于执行 SQL 查询和数据库结构探查(schema introspection),属于 @blogic-cz/agent-tools 工具集。适用场景包括运行 SQL、查看数据库结构、列出表或列,以及在多个数据库环境间切换操作。
主要能力:提供 envs(列出已配置环境及默认环境,不联网)、sql(按环境执行 SQL)、schema(按 tables 模式列出表,或按 columns 模式查看指定表的列结构)、commands(输出完整命令与参数树)等子命令。
使用方式:需将 @blogic-cz/agent-tools 作为开发依赖,通过 bun db-tool 运行;禁止直接运行裸 psql,凭证守卫会拦截。认证使用配置中 passwordEnvVar 指定的环境变量,例如 AGENT_TOOLS_DB_PASSWORD。常用命令示例: bun db-tool envs bun db-tool sql --env local --sql "SELECT * FROM users LIMIT 5" bun db-tool sql --env test --sql "SELECT count(*) FROM organizations" bun db-tool schema --env local --mode tables bun db-tool schema --env local --mode columns --table users bun db-tool commands 建议先运行 bun db-tool envs 查看有效环境名,避免猜测;可在 agent-tools.json5 中设置 defaultEnvironment 免除每次传 --env。
限制与注意事项:VPN 或 prerequisites 可通过 database.<profile>.vpn 或 .prerequisites 配置,默认作用于所有环境;环境可声明 database.<profile>.environments.<env>.vpn 或 .prerequisites 覆盖配置文件级设置,prerequisites: [] 可禁用该环境继承的 VPN 设置。命令会先尝试直连数据库,直连成功则跳过 VPN;失败时再连接配置的前置条件并重试。输出默认使用 TOON 格式以节省 token,仅在需要机器解析(如管道传给 jq)时加 --format json。错误响应包含 hint、nextCommand 和 retryable 字段,失败时应检查。官方建议优先使用 CLI 工具而非 MCP 工具,以减少上下文加载。其他细节暂未提供。