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

环境要求

• DeepSeek Harness 的 dsh CLI（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 天在后台静默更新到最新版，失败则沿用现有版本。

• 不碰你的配置：通过 PATH / mise 自行安装的 dbhub 不会被插件改动。

数据位置

所有配置与凭据存放在模块目录之外（不受 pnpm 打包影响），删除该目录即可完整清空：

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

卸载

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

故障排查

许可证

MIT