dsh-dbhub-live 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mr-mihu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# dsh-dbhub-live
+
+> 让 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/DeepSeek-Harness) 直接、安全地操作数据库：常驻多源连接 + 按工作区工具 + 临时动态连接。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![DSH](https://img.shields.io/badge/DSH-plugin-blue.svg)](#安装)
+[![DBHub](https://img.shields.io/badge/Built_on-DBHub-22a05a)](https://github.com/bytebase/dbhub)
+
+`dsh-dbhub-live` 是一个 DSH 插件，基于 [DBHub](https://dbhub.ai)（数据库 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`
+
+## 安装
+
+```bash
+# 方式一：使用本机已安装的 dsh
+dsh plugin --profile web add github:mr-mihu/dsh-dbhub-live
+
+# 方式二：通过 npx 调用 dsh（无需本机全局安装 dsh）
+npx @deepseek-ai/dsh plugin --profile web add github:mr-mihu/dsh-dbhub-live
+```
+
+安装后**重启 `dsh web`** 生效。
+
+## 快速开始
+
+```text
+# 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/
+```
+
+## 卸载
+
+```bash
+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)

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-dbhub-live bundle patch — declares the plugin row this package mounts.
+# `dsh plugin --profile web add dsh-dbhub-live` installs this package into the
+# profile; reconcilePlugins sees `dsh.bundle.patch` and appends the package to
+# `dsh.profile.bundles`, then this patch layer inserts the row. The bare name
+# resolves the package's main (lib/index.mjs) from the profile's node_modules.
+- insert:
+    - id: dbhub-live
+      name: 'dsh-dbhub-live'