dsh-dbhub-live

简体中文 · English

让 DeepSeek Harness (DSH) 直接、安全地操作数据库：凭据零知识（密码永不经模型）+ 一次性进程执行（无常驻服务、天然并发与多实例安全）+ 按工作区×环境的连接管理 + 浏览器状态卡片。

dsh-dbhub-live 是一个 DSH 插件，基于 DBHub（数据库 MCP 服务器）让模型直接查询数据库：模型只说「查哪个工作区的哪个环境」，插件在宿主侧解析真实连接并执行——密码/连接串永远不会出现在模型能看到的地方。每次调用都是独立的一次性 dbhub 进程，跑完即杀。

✨ 特性

• 凭据零知识 — 模型只见 source 句柄与元数据（类型 / 主机 / 端口 / 库名）；密码、用户名、完整 DSN 只在宿主侧存在；配置/修改密码时在界面输入，不经过模型。

• 一次性进程执行 — 没有常驻 dbhub 服务：每次调用 spawn 一条独立进程执行完即回收。单条查询挂掉只影响它自己；多任务并行、多个 DSH 实例同时跑互不干扰（无共享端口、无互杀）。

• 工具声明恒定 4 个 — dbhub_configure / dbhub_list_sources / dbhub_execute_sql / dbhub_search_objects，环境再多也不膨胀模型上下文。

• 按工作区 × 环境管理连接 — 一个工作区可配多个环境（default / prod / dev / test…），通过 source 值区分，互不混淆。

• 鉴权失败闭环 — 凭据或连接信息不对时，工具给出明确指引；模型引导你在界面更新密码（不会向模型索要密码），或你直接在设置卡片修改。

• 启用 / 禁用开关 — 关闭后所有 dbhub 工具立即返回「插件已禁用」友好提示，无需重启。

• 浏览器状态卡片 — 设置 → 插件 → dsh-dbhub-live 实时展示：状态徽章、工作模式（一次性连接）、已注册工具数、环境数、最近错误，并提供启用/禁用开关、连接增删改查与连接测试。

• 开箱即用 — 未安装 dbhub 时首次执行自动安装，之后按设置间隔自动更新。

支持的数据源

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

# 更新到指定版本（推荐写明当前发布的版本号，避免 pnpm 判「Already up to date」跳过）
dsh plugin --profile web update dsh-dbhub-live@4.0.0

安装后重启 dsh web 生效（重启后到 设置 → 插件 → dsh-dbhub-live 可看到状态卡片）。

快速开始

以下工具由 DSH 的 AI 自动调用，你不用手动执行——直接用自然语言提出需求即可（如「查一下 users 表」）：

# 1) 若当前工作区还没有连接，AI 先引导配置（密码在界面输入，AI 看不到）
dbhub_configure

# 2) 在已配置工作区的连接上执行查询（source 见 dbhub_list_sources）
dbhub_execute_sql  source=myapp  sql="SELECT * FROM users LIMIT 10;"

# 3) 查看已注册的连接与 source 值
dbhub_list_sources

工具

安全：模型无法通过本插件拿到任何密码——结果与列表只标注 mysql://host:3306/db 这类元数据；dbhub 的报错文本在返回前也会被清洗。查询失败时按提示到界面更新密码即可。

注：search_objects 仅对 SQLite 开放；MySQL / PostgreSQL 等请用 dbhub_execute_sql 直接查（如 SHOW TABLES）。

配置方式

1. 显式 DSN — 在界面输入完整连接串，如 mysql://user:pass@host:3306/db。

2. 填写分项 — 在界面按类型 / 主机 / 端口 / 账号 / 密码 / 库名依次填写。

3. 授权扫描 — 授权后扫描项目配置文件（.env、application*.yml、docker-compose、jdbc.properties 等），列出候选（只显示主机/端口/库，密码不显示，由插件直接读取）供你确认。

工作区若已有 mise env 或 .env（DSN / DB_*），插件会自动发现，无需手动配置。

状态卡片

设置 → 插件 → dsh-dbhub-live：插件会把状态与配置实时同步到 Web 设置面板（仅 dsh web 端可见）。卡片为整行折叠样式（与其它插件设置卡一致）：

卡片全部文案（名称、状态、配置项、按钮、连接行）跟随 dsh 界面语言（中 / 英，设置 → 通用 → 语言）切换；模型的报错/反馈与宿主日志同样跟随。

折叠态（默认）：一行显示 状态徽章（🟢 运行中 / ⚪ 已禁用）、环境数量、启用/禁用开关。

展开后分三块——

状态：

• 工作模式：一次性连接（每次调用独立进程）。

• 工具声明：4 个（固定）；环境：N 个 · 已保存 M。

• 最近错误（异常时红色展示）。

配置（编辑后点「保存配置」即时生效并持久化）：

优先级：用户设置 > 进程环境变量（默认值种子）> 内置默认。自动安装包不在 UI 中（DSH_DBHUB_PACKAGE 环境变量单独控制，默认 @bytebase/dbhub）。

工作区连接：

• 列出每个工作区 × 环境的连接：工作区名、环境名、source 值（模型调用 dbhub_execute_sql 时填这个，等宽字体显示）、连接元数据（🔒 mysql://host:3306/db——不含账号密码，密码永不出现在卡片上）、来源徽章（已保存 / 自动）与来源明细（已保存·用户 / 已保存·扫描 / 自动·mise env / 自动·.env）。

  • 已保存：你配置过（dbhub_configure 或卡片添加）。

  • 自动：未保存，来自 mise env / .env 自动发现——不持久化，随源文件变化；自动发现不对时可直接「修改」为手动配置覆盖。

• 每行可「测试」（连接探活，见下）、「修改」（覆盖连接串，自动项会转成已保存项）或「删除」（仅已保存项）。

• 连接测试：点「测试」后 Host 用该环境的真实 DSN 走一次性临时连接（独立 dbhub 进程执行 SELECT 1）实测可达性，成功 / 失败即时在行内提示。结果是一次性反馈：不持久化、约 10 秒后自动消失；失败不会标记、限制或改动这条连接，不影响其他环境与查询（慢库 / 不通库最长等待约 30 秒）。

• 同一工作区可添加多个环境：表单填「工作区（路径或标题，留空=默认当前工作区）+ 环境名 + 连接串」点「添加连接」。默认环境 source 不带后缀，命名环境如 <工作区>_<环境>。

dbhub 环境变量

🔄 dbhub 自动安装与更新

• 首次使用自动安装：本机没有 dbhub 时，插件会在第一次执行时自动安装，之后离线也可用。

• 自动保持更新：后台静默更新到最新版（间隔见「状态卡片 → 可配置参数」），失败则沿用现有版本。

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

更新间隔默认值也可用环境变量播种，见「状态卡片 → 配置」；一旦在设置卡片保存过，即以设置值为准。

数据位置

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

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

按 DSH_HOME 实例隔离，同一实例的多个 profile 共享（与 dsh 自身 workspace.json 同一约定）。工作区连接按「工作区 × 环境」存储（environments.default 为默认环境）；v1 旧格式单连接条目启动时自动迁移。插件对升级/手改遗留的旧格式配置自动清洗并一次性迁移；运行目录被误删或写入被系统拦截时不会崩溃——自动重建目录、写入失败仅告警并继续内存态运行。没有常驻 dbhub 进程与共享配置文件：同机多实例、同 DSH_HOME 并发运行也不会互相干扰。

卸载

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

故障排查

许可证

MIT