---
name: db-connect
version: "1.0.0"
category: database
description: "数据库连接管理 / 连接配置、连接测试、连接池管理 — 安全凭证存储到 .opop/credentials/"
triggers:
  zh: ["数据库连接", "连接测试", "connection", "数据库配置", "host", "port", "连接池"]
  en: ["database connection", "connection test", "DB config", "host", "pool"]
license: MIT
compatibility: opespro-opencode >= 2.3.0
metadata:
  author: "OpesPro Team"
  created: "2026-06-29"
  status: "stable"
  agent_profile: db-master
---

# DB Connect / 数据库连接管理

## Core Concept

**Input:** 连接参数 (host/port/user/database) | **Output:** 连接配置 + 连接测试结果

---

## Iron Law

1. 密码/凭证使用 `git_credential_set` 存储到 `.opop/credentials/`，绝不硬编码
2. 连接测试必须包含超时处理（默认 5 秒）
3. 连接配置写入 `.opop/config.json` 的 database 字段

## Usage

```bash
# 存储数据库凭证（密码不进入命令行历史）
git_credential_set platform="other" type="password" label="mysql-prod" value="xxx"

# 测试连接
node scripts/db-connect-test.js --host=localhost --port=3306 --user=root --database=test
```

## Red Flags

- 🔴 密码硬编码在代码或 SQL 文件中 → 中断
- 🔴 生产环境数据库直接操作 → 请求双重确认