dsh-dbhub-live

Permite que DeepSeek Harness (DSH) opere bases de datos de forma directa y segura: conexiones persistentes de múltiples fuentes + herramientas por espacio de trabajo + conexiones dinámicas temporales.

dsh-dbhub-live es un plugin de DSH basado en DBHub (servidor MCP de base de datos) que permite a los modelos consultar bases de datos directamente: tanto reutilizar conexiones persistentes en espacios de trabajo configurados como conectar temporalmente a cualquier base de datos para inspecciones puntuales.

✨ Características

• Servicio persistente de múltiples fuentes — Un único servicio dbhub en segundo plano se conecta a múltiples fuentes de datos, reutilizando conexiones para consultas más rápidas.

• Herramientas por espacio de trabajo — dbhub_execute_sql_<espacio_de_trabajo> / dbhub_search_objects_<espacio_de_trabajo>, el nombre de la herramienta es el espacio de trabajo, múltiples espacios de trabajo no se confunden, las etiquetas de conexión (contraseñas enmascaradas) son claramente visibles.

• Conexiones dinámicas temporales — dbhub_query / dbhub_query_objects se conectan de forma independiente a cualquier base de datos cada vez, permitiendo consultas paralelas a múltiples bases de datos diferentes, facilitando la depuración entre entornos.

• Listo para usar — Si dbhub no está instalado, se instala automáticamente en el primer uso, y luego se mantiene actualizado automáticamente, sin necesidad de intervención manual.

• Múltiples formas de configuración — DSN explícito / completar campos / escanear archivos de configuración del proyecto con autorización. Las credenciales se almacenan solo en el directorio de usuario local, las contraseñas están enmascaradas en todo momento.

Fuentes de datos compatibles

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

Requisitos del entorno

• CLI dsh de DeepSeek Harness (dsh web se encarga de la ejecución de la GUI)

• Se recomienda tener Node.js ≥ 18 (con npm) en la máquina local — en el primer uso se instalará dbhub automáticamente.

Instalación

# 方式一：使用本机已安装的 dsh
dsh plugin --profile web add dsh-dbhub-live

# 方式二：通过 npx 调用 dsh（无需本机全局安装 dsh）
npx @deepseek-ai/dsh plugin --profile web add dsh-dbhub-live

Después de la instalación, reinicia dsh web para que surta efecto.

Inicio rápido

# 1) 为当前工作区配置数据库连接（三种方式任选其一）
dbhub_configure

# 2) 在已配置工作区的常驻连接上执行查询
dbhub_execute_sql_myapp  SELECT * FROM users LIMIT 10;

# 3) 临时连任意库做一次性排查
dbhub_query  dsn=mysql://root:pass@192.168.77.6:3306/tx_sd_jinengshu  sql="SHOW TABLES;"

Herramientas

Nota: search_objects solo está disponible para SQLite; para MySQL / PostgreSQL, etc., usa dbhub_query directamente (por ejemplo, SHOW TABLES).

Formas de configuración

1. DSN explícito — Proporciona la cadena de conexión completa, por ejemplo mysql://user:pass@host:3306/db.

2. Completar campos — Rellena secuencialmente tipo / host / puerto / usuario / contraseña / nombre de base de datos.

3. Escaneo autorizado — Después de autorizar, escanea los archivos de configuración del proyecto (.env, application*.yml, docker-compose, jdbc.properties, etc.), lista candidatos (contraseñas enmascaradas) para que los confirmes.

Si el espacio de trabajo ya tiene mise env o .env (DSN / DB_*), el plugin lo detectará automáticamente, sin necesidad de configuración manual.

🔄 Instalación y actualización automática de dbhub

• Instalación automática en el primer uso: Si la máquina no tiene dbhub, el plugin lo instalará automáticamente en la primera consulta, y luego estará disponible sin conexión.

• Actualización automática: Se actualiza silenciosamente en segundo plano cada 7 días a la última versión; si falla, se mantiene la versión actual.

• No modifica tu configuración: El dbhub instalado manualmente a través de PATH / mise no será alterado por el plugin.

Ubicación de los datos

Toda la configuración y credenciales se almacenan fuera del directorio del módulo (no afectado por el empaquetado de pnpm). Eliminar ese directorio borrará todo:

~/.dsh/storages/dsh-dbhub-live/

Desinstalación

dsh plugin --profile web remove dsh-dbhub-live

Solución de problemas

Licencia

MIT