前言¶
在 DeepSeek Harness（DSH）里做智能体或 Web 侧开发时，经常要在对话、脚本和配置之间切换，再去单独的客户端查表结构或跑 SQL。DSH 社区主张「一切皆插件」，右侧栏可以挂能力面板；若能在同一界面里维护连接、浏览 schema、执行查询并预览结果，日常调试会少很多窗口切换。下面介绍维护者 lidaiyue 开源的 dsh-database：定位为 DSH 右侧栏里的数据库工具，在 Harness 界面内提供连接树、SQL 控制台、结果网格与导入导出等能力。插件在 SkillHub 分类为「记忆」，当前 GitHub 星标为 0；源码与说明以仓库为准。
这是什么¶
dsh-database（npm 包名 dsh-database，当前版本 1.1.2）是挂在 DSH Web 右侧栏的数据库探索与 SQL 工具。README 用一句话概括：A database tool in the DeepSeek Harness right column.
package.json 中的描述更接近产品形态：IDEA 风格的数据库资源管理器，包含连接、schema/表、可内联编辑的预览、导入导出，以及 SQL/Redis 控制台。
维护者：lidaiyue。许可证：MIT。
社区目录页：SkillHub - dsh-database（独立站点，与 DeepSeek / 幻方无官方从属关系）。源码：github.com/lidaiyue/dsh-database。
核心功能¶
以下能力均来自仓库 README 与 package.json 披露的实现范围（依赖含 pg、mysql2、ioredis，Oracle 通过可选依赖 oracledb）。
连接与资源树¶
- 支持 PostgreSQL、MySQL、Oracle、Redis 连接树。
- 可按名称或注释过滤，拖拽排序，折叠树节点；表行在存在注释时会显示注释。
SQL 控制台与结果¶
- SQL 高亮与关键字补全随当前连接变化。
- 可执行选中片段或整段脚本；控制台标签可重命名、固定、关闭与重新打开。
- 结果网格：默认每页 50 行，或一次加载全部（上限 5000 行）。
- 双击单元格可编辑、增行并提交；单表结果可写回，JOIN 结果只读。
- 可复制选中单元格为纯值，或将选中行复制为
INSERT语句；可将可见行导出为 CSV。
表结构与可见 schema¶
- 查看列、可空性、默认值与注释；可从树中表节点打开，也可在控制台选中表名打开。
- Visible schemas：选择树中展示的 schema；留空表示显示全部。此设置仅过滤树，不限制 SQL 能访问的对象。
导入导出与安全提示¶
- 支持对连接、schema 或表做 SQL 导入导出；Redis 导出为 JSON。
- 若导入内容包含
DROP或TRUNCATE，会列出这些语句并等待确认后再继续。
Redis¶
- 双击 key 可预览类型、TTL 与值；可复制名称或删除 key。
快捷键与打开方式¶
- 打开数据库标签：
⌘2/Ctrl+2；执行 SQL：⌘Enter/Ctrl+Enter；表结构：F1；关闭当前控制台：⌘W/Ctrl+W；可在页脚重新绑定。README 注明不依赖其他插件。 - Open mode：状态栏可在全屏与分栏之间切换，选择与编辑器共用并立即生效。
凭据与 Oracle 连接¶
- 密码保存在 Harness 凭据存储中，不写在连接文件里；编辑时空密码字段表示保留原密码。可选对等依赖
@deepseek-ai/dsh-credentials。 - Oracle 12.2 及以上以 Thin 模式连接；更旧版本需在连接配置中指定 Instant Client 目录。
安装与启用¶
官方 README 给出的安装方式为本地路径添加（须将路径换成你本机克隆或解压后的绝对路径）：
dsh plugin --profile web add /absolute/path/to/dsh-database
完成后重启 dsh web，再刷新页面。插件通过 cordis.patch.yml 注入 Web 客户端，并挂载到 @deepseek-ai/dsh-client-ui-sidebar-right。
典型用法¶
- 按上一节安装并重启 Web 后，用
Ctrl+2（macOS 为⌘2）打开右侧数据库标签。 - 在连接树中配置 PostgreSQL / MySQL / Oracle / Redis；密码通过凭据存储管理，勿期待明文写在连接配置文件中。
- 在 SQL 控制台编写脚本，用
Ctrl+Enter执行选中或全文；在单表结果网格中双击编辑并提交，或使用结构视图（F1）核对列定义。 - 需要备份或迁移时，对连接、schema 或表使用导入/导出；含破坏性语句的导入会先列出
DROP/TRUNCATE再等待确认。 - 树节点过多时，在 Visible schemas 中限定展示范围，仅影响左侧树，不影响可执行的 SQL 范围。
适用场景与注意¶
适合谁：已在 DSH Web 环境内开发、希望把查库、改数、看结构和轻量迁移收进右栏的开发者；需要同时接触关系库与 Redis 的团队也适合用同一面板切换。
运行与安全：
- 插件随当前 dsh 进程权限访问数据库与文件系统；安装前应阅读源码与 MIT 许可证，并确认连接目标与凭据策略符合你的环境规范。
- 不要用本文臆造的安装命令；除 README 所示的
dsh plugin --profile web add <绝对路径>外，资料未给出其他一键安装方式。 - SkillHub 上的分类「记忆」描述的是目录归类；具体能力以 GitHub README 为准。
结尾¶
dsh-database 把多引擎连接树、SQL 控制台、可编辑结果网格、结构视图与导入导出放进 DSH 右侧栏，并配合快捷键与分栏/全屏切换，减少在 Harness 与外部数据库工具之间的来回切换。进一步了解与获取源码：
- 目录页：https://www.skillhub.cn/plugins/lidaiyue/dsh-database
- GitHub：https://github.com/lidaiyue/dsh-database
