dsh-dbhub-live

Позволяет DeepSeek Harness (DSH) напрямую и безопасно работать с базами данных: постоянные мульти-источниковые соединения + инструменты по рабочим пространствам + временные динамические подключения.

dsh-dbhub-live — это плагин DSH, основанный на DBHub (MCP-сервер для баз данных), который позволяет модели напрямую выполнять запросы к базам данных: как использовать постоянные соединения в настроенных рабочих пространствах, так и временно подключаться к произвольным базам для разовых проверок.

✨ Особенности

• Постоянный мульти-источниковый сервис — один фоновый сервис dbhub одновременно подключается к нескольким источникам данных, соединения используются повторно, запросы выполняются быстрее.

• Инструменты по рабочим пространствам — dbhub_execute_sql_<рабочее_пространство> / dbhub_search_objects_<рабочее_пространство>, имя инструмента совпадает с рабочим пространством, несколько рабочих пространств не путаются, метки соединений (с маскировкой паролей) хорошо видны.

• Временные динамические подключения — dbhub_query / dbhub_query_objects каждый раз независимо подключаются к произвольной базе, можно параллельно запрашивать несколько разных баз, что удобно для кросс-средовой диагностики.

• Готово к использованию — при первом использовании, если dbhub не установлен, он устанавливается автоматически, затем автоматически обновляется, не требуя ручного вмешательства.

• Несколько способов настройки — явный DSN / заполнение отдельных полей / авторизованное сканирование конфигурационных файлов проекта, учётные данные хранятся только в домашнем каталоге пользователя, пароли полностью десенсибилизированы.

Поддерживаемые источники данных

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

Требования к окружению

• CLI dsh от DeepSeek Harness (dsh web отвечает за запуск GUI)

• Рекомендуется Node.js ≥ 18 (с npm) — при первом использовании dbhub установится автоматически

Установка

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

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

После установки перезапустите dsh web для применения.

Быстрый старт

# 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;"

Инструменты

Примечание: search_objects доступен только для SQLite; для MySQL / PostgreSQL и других используйте dbhub_query напрямую (например, SHOW TABLES).

Способы настройки

1. Явный DSN — передать полную строку подключения, например mysql://user:pass@host:3306/db.

2. Заполнение отдельных полей — последовательно указать тип / хост / порт / учётную запись / пароль / имя базы данных.

3. Авторизованное сканирование — после авторизации сканировать конфигурационные файлы проекта (.env, application*.yml, docker-compose, jdbc.properties и т.д.), вывести кандидатов (с маскировкой паролей) для вашего подтверждения.

Если в рабочем пространстве уже есть mise env или .env (с DSN / DB_*), плагин обнаружит их автоматически, ручная настройка не требуется.

🔄 Автоматическая установка и обновление dbhub

• Автоматическая установка при первом использовании: если на машине нет dbhub, плагин установит его при первом запросе, после чего он будет доступен и в офлайн-режиме.

• Автоматическое поддержание актуальности: каждые 7 дней в фоне выполняется тихое обновление до последней версии; при неудаче используется текущая версия.

• Не затрагивает ваши настройки: dbhub, установленный через PATH / mise, не будет изменён плагином.

Расположение данных

Все настройки и учётные данные хранятся вне каталога модуля (не затрагиваются упаковкой pnpm). Для полной очистки удалите этот каталог:

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

Удаление

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

Устранение неполадок

Лицензия

MIT