Passer au contenu principal
F

dsh-db-browser

fengb3/dsh-db-browser

Plugin de navigation de bases de données dsh : onglet « Database » en haut de session, gestion de connexions multiples, tables paginées, protections en lecture seule multicouches et architecture de registre de pilotes pour prendre en charge autant de bases que possible. Installation en une commande : `dsh plugin add`.

Installer

dsh plugin --profile web add github:fengb3/dsh-db-browser

README

dsh-db-browser

npm version dsh-plugin

DSH(DeepSeek Harness) 的只读数据库浏览器插件:在会话顶部增加一个「数据库」视图 Tab,与 聊天/轨迹 并排,直接浏览数据库数据,零构建、纯主题 token 样式。

功能

  • 顶部视图 Tab:「数据库」页内嵌在会话视图区,不弹窗、不占侧栏。
  • 多驱动:驱动注册表架构,新数据库引擎即插即用,目标支持尽可能多的数据库。
  • 连接管理:添加 / 编辑 / 删除 / 刷新;每个连接是可折叠下拉项,展开即列出表和视图。
  • 测试连接:探测成功转圈 → 绿 ✓(显示服务器版本/库名或文件大小),失败红 ✕(悬停看原因)。
  • 浏览表数据:点表即分页浏览(每页 50 行,上一页/下一页在顶部工具栏),行数统计自动 COUNT。
  • 主题适配:全部颜色/字体走 --dsw-alias-* 主题 token,暗色/亮色自动跟随,无硬编码颜色。
  • 安全模型:只读多层防护——驱动级只读打开/会话只读、语句白名单、SELECT/WITH 强制包一层 LIMIT/OFFSET(单页 ≤ 500 行)、分页参数数字化、标识符转义、单元格序列化截断。

连接

文件型数据库填绝对文件路径(~ 开头会展开);服务型数据库填 URI 或 键=值; 风格连接串(自动转换,密码自动编码),侧栏展示时密码隐藏为 ***。

安装

一行命令(推荐)

dsh plugin --profile web add dsh-db-browser
# 或从 GitHub 安装:dsh plugin --profile web add github:fengb3/dsh-db-browser

重启 dsh web,会话顶部即出现「数据库」Tab。需装有 pnpm;非默认 profile 换掉 --profile 名字即可。

让 DSH agent 代装

把下面整段文本复制,粘贴给你正在使用的 DSH agent,它会替你完成安装:

请帮我安装 DSH 插件 dsh-db-browser(只读数据库浏览器,装好后会话顶部会多一个「数据库」Tab,与 聊天/轨迹 并排):
1. 执行:dsh plugin --profile web add dsh-db-browser(若我明确说了用别的 profile,把 web 换成对应名字;执行失败的完整报错原样发给我,不要自行重试超过一次;失败时可改用 dsh plugin --profile web add github:fengb3/dsh-db-browser 再试一次)。
2. 完成后告诉我需要手动重启 dsh web 才生效(你自己不要尝试重启 dsh web,那会终止你所在的会话)。重启后会话顶部应出现「数据库」Tab;若启动报错,把 dsh web 的错误日志发给我排查。

卸载

dsh plugin --profile web remove dsh-db-browser

重启 dsh web。连接清单保存在 $DSH_HOME/db-browser/connections.json,删除该目录即彻底清除。

结构

index.js           host 半:dbBrowser Typert Remote 服务(连接存储、驱动、查询守卫)
client.js          浏览器半:conversation.view Tab + 连接/表/结果 UI(loader 格式,零构建)
cordis.patch.yml   bundle 声明:`dsh plugin add` 据此自动登记为 profile 层
package.json       dsh.bundle.patch + dsh.client.inject 声明

扩展新驱动

host 半在 DRIVERS / ALLOWED_STATEMENTS 登记类型与白名单,实现 probe / tables / columns / query;client 半在 DRIVERS 登记 label、占位符、提示与标识符引用符。

License

MIT

Plugins associés