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 的
dshCLI（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;"工具
| 工具 | 说明 |
|---|---|
dbhub_configure(workspace?, dsn?) | 为工作区配置/持久化数据库连接。 |
dbhub_execute_sql_<工作区> | 在指定工作区的常驻连接上执行 SQL。 |
dbhub_search_objects_<工作区> | 在指定工作区搜索数据库对象（表/视图/列/索引等）。 |
dbhub_query(dsn, sql) | 临时连接任意库执行 SQL（多语句用 ; 分隔）。 |
dbhub_query_objects(dsn, ...) | 临时连接任意库搜索数据库对象。 |
> 注：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不会被插件改动。
| 环境变量 | 说明 | 默认 |
|---|---|---|
DSH_DBHUB_PACKAGE | 自动安装使用的 npm 包名 | @bytebase/dbhub |
DSH_DBHUB_UPDATE_DAYS | 自动更新间隔天数，0 关闭 | 7 |
数据位置
所有配置与凭据存放在模块目录之外（不受 pnpm 打包影响），删除该目录即可完整清空：
~/.dsh/storages/dsh-dbhub-live/卸载
dsh plugin --profile web remove dsh-dbhub-live故障排查
| 现象 | 处理 |
|---|---|
| 首次使用报「无法获取 dbhub」 | 确认本机有 npm 且能联网；离线可手动安装 dbhub 并加入 PATH。 |
| 工具显示「dbhub 服务不可用」 | 查看 dsh web 日志；进程异常退出时插件会在下次调用自动重启。 |
| 扫描不到配置文件 | 默认跳过 node_modules / .git / target / dist 等目录，可改用「输入 DSN」或「填写分项」。 |
| 需要自定义 dbhub 版本 | 删除 ~/.dsh/storages/dsh-dbhub-live 后设置 DSH_DBHUB_PACKAGE 指定包/版本。 |
| 不希望自动更新 dbhub | 设置环境变量 DSH_DBHUB_UPDATE_DAYS=0。 |
许可证
[MIT](./LICENSE)