Skip to content
Back to search

dsh-db-tool

DSH plugin: chat-driven database admin tool (8 databases, per-project grants, danger confirmation, sidebar console)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mengqi1436/dsh-db-tool with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mengqi1436/dsh-db-tool'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mengqi1436--dsh-db-tool/badge.svg)](/listings/mengqi1436--dsh-db-tool)

HTML

<a href="/listings/mengqi1436--dsh-db-tool"><img src="/api/listings/mengqi1436--dsh-db-tool/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**运行环境**:Node.js ≥ 22(部分数据库驱动要求);DSH 宿主需提供官方右侧栏。

# npm(推荐,请钉当前版本号,@latest 会因 release-age 校验回落旧版)
dsh plugin --profile desktop add dsh-db-tool@<版本号> --registry=https://registry.npmjs.org/

# GitHub 源码
dsh plugin --profile web add "dsh-db-tool@github:mengqi1436/dsh-db-tool"

# 本地开发
dsh plugin --profile web add "link:/path/to/dsh-db-tool"

桌面端若 `dsh` 命令不在 PATH:打开菜单栏点 **Manage dsh command** 注册。安装完成后重启 DSH 桌面端加载插件。

**关于 oracledb**:其安装脚本会被 pnpm 默认拦截,首次安装会报告失败。在 DSH 插件安装界面点 **Allow these scripts and retry** 即可完成——该脚本仅做 Node 版本检查与横幅打印,批准会持久化到 profile。

**前端挂载位置**:数据库面板挂在 DSH 自带的右侧栏上,不需要额外安装任何侧边栏插件;`dsh.client.inject` 已声明 `@deepseek-ai/dsh-client-ui-sidebar-right` 作为加载前置。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 261 lines
  1. # dsh-db-tool
  2. [English](README_EN.md) | 简体中文
  3. DSH 宿主插件。在聊天中安全地操作数据库:九种数据库、项目级细粒度授权、危险操作确认、全量审计,配套右侧栏管理台与 SQL 控制台。
  4. ## 功能流程
  5. 一次数据库操作从入口到落库审计的完整路径——聊天工具与右侧栏两个入口共用一套语义,中间必须穿过项目级授权与语句级风险分级两道闸门:
  6. ![dsh-db-tool 功能流程](assets/feature-flow.png)
  7. [打开交互式版本](assets/feature-flow.html) —— 支持缩放、拖动、路径高亮,可点节点查看源码证据。
  8. > 有问题或建议?[提 Issue](https://github.com/mengqi1436/dsh-db-tool/issues/new/choose)。
  9. ---
  10. ## 支持的数据库
  11. | 类别 | 数据库 |
  12. | --- | --- |
  13. | 关系型 | MySQL、PostgreSQL、GaussDB、SQLite、Oracle、达梦 DM、SQL Server |
  14. | NoSQL | Redis、MongoDB |
  15. 连接、元数据浏览、查询与预览覆盖九种数据库。数据传输按能力分层:八种数据库(MySQL / PostgreSQL / GaussDB / SQLite / MongoDB / Oracle / 达梦 / SQL Server)走原生表级互传,Redis 通过固定 envelope 表 `__redis_keys` 降级参与。Redis 原生键空间保真(stream consumer group、跨版本 `DUMP`、逻辑库 `dbN`)不在支持范围内。
  16. 方言差异在适配器内部处理,对上层统一暴露 `?` 占位符与标准结果集。
  17. ---
  18. ## 核心能力
  19. ### 模型工具 `DatabaseManager`
  20. 单一工具、多 action,减少模型选工具的歧义:
  21. | action | 作用 |
  22. | --- | --- |
  23. | `list_connections` | 列出可选连接(不含凭据) |
  24. | `query` | 执行只读查询,返回列与行 |
  25. | `execute` | 执行写语句,危险操作需确认 |
  26. | `schema` | 查看库 / 表 / 列结构 |
  27. | `preview` | 预览表数据(分页,每页最多 50 行) |
  28. | `run_script` | 在沙箱中跑脚本,可多次调用 `db.query` / `db.execute` |
  29. `run_script` 的隔离边界:独立子进程 + `node:vm` 沙箱,60 秒超时后进程级强杀,只注入受限的 `db.{query,execute}` 句柄——不提供文件系统、网络与 `require`。
  30. ### 项目级授权(ro / rw)
  31. 授权以「项目路径 → 连接 → 模式」三级存储(`grants.json`):
  32. - **ro(只读)**:允许查询与浏览,拒绝一切写操作
  33. - **rw(读写)**:允许执行语句、脚本与事务
  34. 未授权的项目对任何连接一律拒绝。授权模式变更(含 rw → ro 降级)会立即作废旧会话,无需重连。
  35. Windows 下路径按 NTFS 语义归一(大小写不敏感),`E:\GitHub\MyApp` 与 `e:\github\myapp` 视为同一项目。
  36. ### 危险操作确认
  37. DDL、`FLUSHALL`、`dropDatabase` 等语句先返回 `NEEDS_CONFIRMATION`,不会直接执行:
  38. 1. 首次调用返回待确认状态与一次性 `challengeId`
  39. 2. `challengeId` 绑定语句的 SHA256,5 分钟内有效、用后即废
  40. 3. 用户确认后携同一 `challengeId` 重试才真正执行
  41. 聊天工具侧经对话确认,SQL 控制台侧经弹窗确认——两条路径共用同一套语义,任一处都无法绕过。
  42. ### 全量审计
  43. 每次执行(包括被拒绝的请求)都追加一行到 `audit.jsonl`:语句、危险级别、是否经过确认、结果与耗时。右侧栏可实时查看。
  44. ### 数据浏览
  45. - 连接 → 库 → schema → 表四级树形展开
  46. - 库筛选 + 跨库表名模糊搜索(MySQL / PostgreSQL / GaussDB 走 `information_schema` 原生查询,其余库回退内存过滤)
  47. - 表结构查看与数据预览,结果网格支持排序、分页、单元格复制
  48. ### SQL 控制台
  49. Navicat 风格的右侧栏多标签编辑器(CodeMirror 6):
  50. - **多标签**:每标签独立保存 SQL、结果与历史(50 条上限,点击回填)
  51. - **语法高亮与补全**:按方言自动切换(MySQL / PostgreSQL / SQLite / PL-SQL / T-SQL),表列元数据注入补全
  52. - **快捷键**:`Ctrl/Cmd+Enter` 执行全部,`Ctrl/Cmd+Shift+Enter` 执行选中
  53. - **格式化**:按方言调用 sql-formatter,解析失败回退原文
  54. - **逐条执行**:客户端预分类读写语句,分别路由到查询与执行通道;ro 授权下写语句自动跳过并标注
  55. - **批分隔符 `GO`**:支持 `GO` 与 `GO n`(sqlcmd 语义,`GO 0` / `GO 1` 均等同 1 次),重复上限 1000 次防放大
  56. - **事务**:rw 授权下可开始 / 提交 / 回滚,服务端粘性连接;空闲 5 分钟自动回滚并审计
  57. - **结果网格**:三态排序、每页 50 行、CSV / JSON 导出
  58. ### 数据传输
  59. 同类或跨类数据库之间的表数据搬运:
  60. - **写入模式**:`insert`(追加)、`ignore`(跳过冲突)、`replace`(覆盖)、`truncate`(先清空)
  61. - **自动建表**:目标表不存在时按源表结构生成 DDL
  62. - **依赖顺序**:目标端已有外键关系时自动排序——删除/清空先处理子表、装载先处理父表;互为引用的表组按各库官方机制整组删除(装载顺序不保证,外键冲突如实报错);被未选中表引用的目标表在覆盖删除时提前失败并给出明确提示
  63. - **分页读取**:有序游标(keyset)/ 范围 / 偏移三种策略
  64. - **进度与历史**:实时进度推送 + 按项目隔离的传输历史
  65. - **传输配置**:按项目保存,自动保存、重启后回填、失效连接自动清空
  66. - **中间类型模型**:异构列先归一化到统一中间类型再映射目标列,避免九库点对点转换
  67. - **Redis envelope 降级**:Redis 以固定表 `__redis_keys` 参与,六列语义如下
  68. | 列 | 语义 |
  69. | --- | --- |
  70. | `key` | 键名 |
  71. | `type` | string / hash / list / set / zset / stream 等 |
  72. | `ttl_ms` | 剩余 TTL 毫秒,无过期为 0 |
  73. | `encoding` | `OBJECT ENCODING` 内存编码诊断值,与 `payload` 的序列化无关 |
  74. | `payload` | 按类型展平的值,恒为 UTF-8 JSON 字符串 |
  75. | `dump` | `DUMP` 的 RDB 序列化字节,仅同构 Redis 经 `RESTORE` 恢复用 |
  76. ### 连接导出 / 导入
  77. 一键把所有连接(含密码)导出为口令加密文件,用于跨机器迁移:
  78. - scrypt 派生密钥 + AES-256-GCM 整体加密,文件打开无明文
  79. - 口令最短 8 位,由服务端强制校验
  80. - 导入时已存在的连接 id 一律跳过不覆盖,返回「已导入 / 跳过 / 失败」摘要
  81. ---
  82. ## 右侧栏
  83. 通过 DSH 官方右侧栏(`@deepseek-ai/dsh-client-ui-sidebar-right`)注册一个页签,不依赖任何第三方侧边栏。页签内含五个面板(中英双语):
  84. | 面板 | 用途 |
  85. | --- | --- |
  86. | 连接管理 | 新增 / 编辑 / 删除连接,卡片式自适应列表,单连接或一键测试连通性,导出导入 |
  87. | 项目授权 | 为当前项目勾选各连接的 ro / rw |
  88. | 数据浏览 | 树形浏览库表、搜索、预览数据 |
  89. | SQL 控制台 | 多标签编辑器、事务、历史、结果网格 |
  90. | 数据传输 | 库表级数据迁移,批量 / 并行与写入模式可选,附传输日志 |
  91. ### 使用须知
  92. 两条都是官方右侧栏的契约行为,容易误判为插件缺陷:
  93. - **未选择会话时,右侧栏不显示数据库面板。** 官方右侧栏的布局状态按会话 id 键控,没有会话就没有停靠面,也就没有入口卡片与页签——先选一个会话再展开右侧栏。
  94. - **若当前 DSH 就绪的入口卡片只有一个,「+」新建格会直接打开数据库页签而不是引导页。** 这是官方默认页规则,不是跳过引导页的异常。
  95. ---
  96. ## 安全模型
  97. | 层次 | 机制 |
  98. | --- | --- |
  99. | 存储 | 密码与完整 URL 存 `secrets.json`(0600),永不返回给模型,返回给界面的连接信息密码一律脱敏为 `***` |
  100. | 授权 | 项目级 ro / rw 白名单,未授权即拒绝 |
  101. | 语句级 | 风险分级(danger / warning / none)+ 一次性确认 |
  102. | 只读强制 | MySQL / PostgreSQL 走会话级 `SET TRANSACTION READ ONLY`;SQL Server 退化为应用层五道闸门 |
  103. | 传输加密 | 默认优先明文建连,仅当服务器强制加密时升级;详见「传输加密」 |
  104. | 错误脱敏 | 连接串解析失败时,错误文案中的 userinfo 已脱敏,不回显明文密码 |
  105. | 脚本隔离 | 独立子进程 + vm 沙箱 + 60 秒强杀 + 仅注入 db 句柄 |
  106. **SQL Server 的 ro 强度弱于 MySQL / PostgreSQL**:SQL Server 没有等价的会话级只读语句,ro 授权下由应用层五道拦截兜底——首词白名单、拒绝多语句、拒绝 `SELECT ... INTO`、拒绝 `WITH ... (INSERT|UPDATE|DELETE|MERGE)`、拒绝 `OPENQUERY` / `OPENROWSET` / `OPENDATASOURCE`。这仍是应用层拦截,需要数据库侧强隔离时请为连接配置只读账号。
  107. ### 传输加密
  108. **默认可连即可,不强制加密。** SQL Server 默认 `encrypt=auto`:先不带加密建连;仅当服务器**强制加密**时报错,才升级到加密并信任其证书重试一次——只重试一次,只针对这一种原因,显式写 `encrypt` 时不重试。达梦同理:仅当服务器协商了本机 OpenSSL 已移除的加密算法(`[6071]`)时,才关闭通信加密重试一次。
  109. **明文是这条策略的代价**:SQL Server 的 `auto` / `encrypt=false` 与达梦的 `loginEncrypt=false` 都会以明文传输账号密码与查询结果。可信内网无妨;跨公网或不可信网段请显式要求加密,并解决随之而来的证书或算法问题。
  110. ---
  111. ## 安装
  112. **运行环境**:Node.js ≥ 22(部分数据库驱动要求);DSH 宿主需提供官方右侧栏。
  113. ```bash
  114. # npm(推荐,请钉当前版本号,@latest 会因 release-age 校验回落旧版)
  115. dsh plugin --profile desktop add dsh-db-tool@<版本号> --registry=https://registry.npmjs.org/
  116. # GitHub 源码
  117. dsh plugin --profile web add "dsh-db-tool@github:mengqi1436/dsh-db-tool"
  118. # 本地开发
  119. dsh plugin --profile web add "link:/path/to/dsh-db-tool"
  120. ```
  121. 桌面端若 `dsh` 命令不在 PATH:打开菜单栏点 **Manage dsh command** 注册。安装完成后重启 DSH 桌面端加载插件。
  122. **关于 oracledb**:其安装脚本会被 pnpm 默认拦截,首次安装会报告失败。在 DSH 插件安装界面点 **Allow these scripts and retry** 即可完成——该脚本仅做 Node 版本检查与横幅打印,批准会持久化到 profile。
  123. **前端挂载位置**:数据库面板挂在 DSH 自带的右侧栏上,不需要额外安装任何侧边栏插件;`dsh.client.inject` 已声明 `@deepseek-ai/dsh-client-ui-sidebar-right` 作为加载前置。
  124. ---
  125. ## 数据存放
  126. `<我的文档>/DSH/db-tool/`(目录权限 0700;与传输日志同根,用户可直接打开查看):
  127. | 文件 | 内容 |
  128. | --- | --- |
  129. | `connections.json` | 连接定义(`urlSafe` 中密码脱敏为 `***`) |
  130. | `secrets.json` | 0600,密码与完整 URL,永不返回给模型 |
  131. | `grants.json` | 项目授权(归一化路径 → connId → ro / rw) |
  132. | `transfer-config.json` | 0600,数据传输页按项目的连接与选项配置 |
  133. | `audit.jsonl` | 追加式审计日志,每行一条 JSON |
  134. 同级还有 `transfer-log.jsonl`(传输过程日志与历史)。路径解析优先级:显式注入(测试)> `DSH_DB_TOOL_DIR` > `<我的文档>/DSH`。「我的文档」在 Windows 下由 Shell API 解析,自动跟随重定向(OneDrive 等);非 Windows 走 `XDG_DOCUMENTS_DIR` 或 `~/Documents`。旧版本存放于 `$DSH_HOME/db-tool/` 的数据在首次启动时按文件粒度迁移(目标已存在则跳过,旧文件保留不删)。
  135. ---
  136. ## 开发
  137. ```bash
  138. npm install
  139. npm run build # 编译 + 生成 vendor bundle(mongodb / sqlserver / codemirror)
  140. npm test # vitest 全量
  141. npm run typecheck # tsc --noEmit
  142. ```
  143. 真机冒烟测试由环境变量门控,设置了才运行:
  144. ```
  145. DBT_TEST_MYSQL_URL / DBT_TEST_PG_URL / DBT_TEST_REDIS_URL / DBT_TEST_DM_CONNECT
  146. DBT_TEST_MONGO_URL / DBT_TEST_ORACLE_CONNECT / DBT_TEST_SQLSERVER_URL
  147. ```
  148. CI 见 [`.github/workflows/ci.yml`](.github/workflows/ci.yml):Node 22 与 24 两档,跑 `npm ci → build → typecheck → test`。
  149. ### 目录结构
  150. ```
  151. lib/ 插件主体
  152. adapters/ 9 种数据库适配器 + 传输实现
  153. store/ 连接/授权/审计/密钥存储
  154. guard/ 语句风险分级
  155. manager.ts 业务编排(授权、分派、确认、审计)
  156. http/ 右侧栏 HTTP 路由
  157. script/ run_script 沙箱与子进程
  158. client/ 右侧栏单文件产物
  159. skills/ db-admin skill
  160. scripts/ 构建与工具脚本
  161. patches/ DSH 宿主热修复补丁
  162. tests/ vitest(离线 mock + 真机门控)
  163. assets/ 功能流程图
  164. vendor/ 驱动与编辑器 bundle(构建产物,发布时收录)
  165. ```
  166. ---
  167. ## 贡献者
  168. 感谢所有把修复真正推进到 `master` 的外部贡献者,逐条记录见 [CONTRIBUTORS.md](CONTRIBUTORS.md):
  169. - [a19920714liou](https://github.com/a19920714liou) — [PR #1](https://github.com/mengqi1436/dsh-db-tool/pull/1):ro 连接钩子卡死 + Windows 路径大小写授权错位
  170. - [weicy98](https://github.com/weicy98) — [PR #12](https://github.com/mengqi1436/dsh-db-tool/pull/12):达梦 DM 通信加密为 DES_CFB 时的连接失败
  171. 欢迎提交缺陷修复与适配器支持,提交约定见 [CONTRIBUTORS.md](CONTRIBUTORS.md#贡献方式)。
  172. ---
  173. ## 许可证
  174. [Apache License 2.0](LICENSE) © 2026 mengqi1436
  175. 可自由商用、修改、分发与再许可,需保留版权与许可声明,修改过的文件需标注改动;附带的专利授权不可撤回,但对本作品发起专利诉讼时终止。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.