前言¶
DeepSeek Harness（DSH）插件化架构下，开发者需要一个既能展示数据库结构、又能供 Agent 调用的统一入口。现有方案往往依赖外部数据库客户端或手动编写 SQL 脚本，无法在 DSH 内完成从浏览、查询到导出的全流程。dsh-ide-database 插件在右侧边栏提供类似 JetBrains Database 工具的视图，同时开放一组 db_* 工具供 Agent 操作数据库。
插件定位¶
该插件是 DeepSeek Harness 的客户端插件，由维护者 qwq1999 提供。它以右侧边栏的数据库工具窗为核心，提供 MySQL、Oracle、Redis、达梦 DM、OceanBase（MySQL / Oracle 模式）等数据源的浏览与查询能力，也支持自定义 JDBC 驱动。Agent 可以通过 15 个 db_* 工具新增、编辑、删除数据源，执行 SQL、EXPLAIN、Redis 命令等，写操作默认关闭，需在配置中显式开启 allowAgentWrites。
右侧边栏入口¶
在右侧边栏的「+」新标签页菜单里选择「数据库」，或在 Guide 页点击「数据库」胶囊即可打开。标签页会保持挂载，切换会话不丢状态。
预设数据源与自定义驱动¶
新建连接时，MySQL、OceanBase（MySQL / Oracle 模式）、Oracle、达梦 DM、Redis 会自动带出默认端口、驱动类和 URL 模板。自定义 JDBC 驱动需填写驱动名、方言、驱动类、URL 模板和 Maven 坐标（可多个 jar），点击下载即可从 Maven Central / 阿里云镜像拉取并缓存，无需手动放置 jar。
数据浏览¶
工具栏提供「新增 / 刷新 / 删除 / 控制台 / 设置」按钮，左对齐。下方是所有数据源 → Schema → 表 / 视图 / 例程 / 序列 / 触发器 的树，每类按文件夹分组并显示数量（表里还能继续展开「列 / 键 / 索引」）。选中表在下方显示列、默认值、主键、索引与注释，右上角的「DDL」按钮弹出该表的建表语句。选中函数、存储过程、触发器或序列时，下方直接展示服务器返回的定义。
Redis 键空间¶
Redis 连接按「数据源 → db{库号}（可展开/收起）→ 键」浏览，每个逻辑库独立分页扫描、各自「加载更多键」，筛选框会自动扫描匹配的键，点键在下方直接看值（表格化返回 hash / list / set / zset，string 原样展示）。行尾可以勾选要展示的逻辑库（默认只展示连接配置里的库，范围为 Redis 的 databases 数量）；未连接或未打开过时行尾显示「连接」按钮，连上自动加载 Schema / 键空间，断线后仍可用缓存浏览。
结构缓存与表下钻¶
连接过一次后，Schema、对象清单、表结构（列 / 键 / 索引）以及 Redis 的逻辑库数量和各库键清单会写入插件数据目录的 structure.json；之后即使不连接（数据库下线、断网、只想离线看结构）也能展开浏览缓存的树，再次连接时自动用最新结构覆盖，离线状态在树上有明确标注。树里展开表即可看到「列 / 键 / 索引」三个分组——列带类型与主键标记，键与索引带所属列。
双击打开数据表与列筛选¶
树里双击表或视图，会在右侧栏新开一个数据表标签页分页浏览数据（标签页标题是表名，正文顶部显示 schema.table）；顶部 WHERE / ORDER BY 输入框回车即生效，底栏显示实际执行的 SQL、当前区间、总行数与翻页按钮，每页 50 / 100 / 200 / 500 / 1000 行可切，同一张表可重复打开互不影响。数据表标签页的漏斗按钮打开列筛选行，每列一个输入框，输入即按 LIKE 过滤（回车立即生效，400ms 自动刷新）；开着筛选行时点任意单元格可按该值精确筛选，点 NULL 单元格筛 IS NULL，筛选条件与顶部手写 WHERE 用 AND 组合，生效的筛选项数显示在漏斗徽标上，逐列 × 或再次收起即可恢复。
结果导出与右键复制¶
数据表标签页的下载按钮导出 CSV、JSON 或 SQL（每行一条 INSERT），都可以选「当前页」或「全部」。CSV 带 UTF-8 BOM、遇逗号引号换行自动加引号，Excel 直接打开不乱码；JSON 保留数字与 null 类型；SQL 按方言加引号并转义字面量。导出内容与当前 WHERE、列筛选条件一致，分页抓取，单次上限 5 万行。结果网格的单元格右键可以复制单元格值、整行（制表符分隔，粘进表格软件就是一行），数据表标签页还能「复制 INSERT 语句」——按当前方言给表名、列名加引号，NULL 原样、数字与布尔按类型输出、字符串转义单引号。
大结果集虚拟滚动与筛选自动展开¶
数据表与 SQL 控制台的网格只渲染可视区域加少量缓冲行（超过 200 行自动启用），500 / 2000 行一页也只保留几十个 <tr>，滚动条长度与行号仍是真实数据；表头 sticky、行高固定 22px，翻页或换页后自动回到顶部。树顶部输入筛选词时，命中项所在的路径会自动展开——数据源、schema、表/视图/例程等分组逐级打开，必要时按需拉取未展开 schema 的对象列表；命中的文字片段以浅色底标记，未加载过结构的数据源保持可见，方便直接连接。
列宽与列序、点表头排序¶
拖动表头分隔线按像素调整列宽，双击分隔线恢复自动列宽；直接左右拖动表头可以调整列的显示顺序，列多了用触摸板双指滑动或 Shift+滚轮横向滚动。列宽按「数据表 / SQL 控制台」分别记在浏览器本地；排序后导出、复制整行都按当前列序。点数据表标签页的列头会在「升序 → 降序 → 不排序」之间循环，排序直接写进 ORDER BY 输入框交给数据库执行，翻页时顺序保持一致；当前排序列的列头显示箭头，输入框里自己写的其它排序不受影响，清空 ORDER BY 即回到默认顺序。
查询控制台¶
工具栏的「控制台」按钮会在右侧栏新开一个查询标签页（可同时开多个）。数据源下拉旁还可以切换「数据库 / Schema」（Redis 则是逻辑库 dbN）：选定后 SQL 不用再写库名前缀，Redis 的键扫描、取值和命令都落在该逻辑库。SQL 模式支持多行编辑、Ctrl+Enter 执行、取消、行数上限、耗时与分页（把单条 SELECT 包成 LIMIT/OFFSET 或 OFFSET … FETCH，每页 200–5000 行可选，也可以选「全部」一次取回，单次上限 5000 行）；写语句执行前二次确认，只读连接永远拒绝写。切到 Redis 数据源时变成键表格（键 / 类型 / TTL / 长度）+ 选中键的值面板 + 命令框，写命令二次确认、危险命令（FLUSHALL 等）始终拒绝。
历史收藏与执行历史¶
历史列表里每条语句右侧的星标可以把语句收藏起来，收藏项固定显示在列表顶部的「收藏」分组，最多 20 条；「清空」只清最近执行，不会删掉收藏。收藏按 SQL / Redis 分别保存在浏览器本地，重开控制台仍在。控制台会记住最近执行过的 50 条 SQL / Redis 命令（存在浏览器本地，刷新和重开控制台都还在）。「历史」按钮展开列表，点一条即回填到编辑器；SQL 编辑器里 Ctrl/⌘ + ↑ / ↓ 直接翻历史，Redis 命令框用 ↑ / ↓，重复的语句会提到最前而不是堆叠。
多语句执行、执行计划与 SQL 格式化¶
在 SQL 编辑器里选中一段语句再执行，就只跑选中部分（多语句脚本里挑一句跑很顺手），没选中时仍然执行全文；控制台会提示「已执行选中内容」。一次粘贴整段脚本也没问题——控制台按分号拆成独立语句逐条执行（字符串、引号标识符与注释里的分号不会误拆），网格展示最后一条的结果，状态栏提示「已顺序执行 N 条语句」；中途失败会指出是第几条并停止。查询控制台的「执行计划」按钮会对当前语句（或选中部分）取执行计划而不是真的执行它——MySQL 走 EXPLAIN，Oracle / OceanBase-Oracle 走 EXPLAIN PLAN FOR + DBMS_XPLAN，达梦走驱动自带的 getExplainInfo（EXPLAIN 语句在达梦上只返回空结果），结果与普通查询一样在网格里展示并标出「执行计划」，看完点「关闭计划」回到编辑器。查询控制台的「格式化」按钮（或 Ctrl/⌘ + Shift + F）会把关键字统一大写，按 SELECT / FROM / WHERE / GROUP BY / ORDER BY / LIMIT 等子句换行并缩进子查询；字符串、反引号标识符、-- 与 /* */ 注释里的内容一概不动。
结果导出、结果排序与列头菜单¶
查询控制台工具栏的下载按钮可以把结果存成 CSV、JSON 或 SQL（每行一条 INSERT，表名自动从当前语句的 FROM / INTO 识别，识别不到时提示而不是编造表名）——CSV 带 BOM，Excel 打开中文不乱码。可分页的查询除了「当前页」，还能选「全部」：按每批 2000 行自动翻页抓取（单次上限 5 万行），导出的就是整条 SQL 的完整结果。点控制台结果网格的表头，就能按这一列对当前页排序——第一次升序、再一次降序、第三次取消；拼音按 zh 排序，空值沉底，导出 CSV/JSON 也会跟着网格的顺序走。在结果网格的列头上点右键，可以「按此列升序 / 降序 / 清除排序」，或者「复制列名」「复制本列值」（一行一个值）——数据表标签页和查询控制台都支持。
DDL 与 Agent 工具¶
详情面板右上角「DDL」按钮展示建表/建视图语句；MySQL 走 SHOW CREATE，Oracle/达梦走 DBMS_METADATA.GET_DDL，服务器取不到时按缓存的列与索引重建，并在弹窗底部注明来源。函数、存储过程、触发器、序列没有列结构，选中后直接在详情面板展示服务器返回的定义（MySQL SHOW CREATE FUNCTION/PROCEDURE/TRIGGER/SEQUENCE，Oracle/达梦 DBMS_METADATA.GET_DDL）；取不到时提示去 SQL 控制台查看，不会拼假 DDL。Agent 工具包含 15 个 db_* 工具，Agent 可新增 / 编辑 / 删除 / 刷新数据源，列出连接、测试连通性、浏览 Schema、查看表结构、执行 SQL/EXPLAIN、读取 Redis 键与执行命令、下载缺失驱动。写操作默认关闭，需显式开启 allowAgentWrites；删除数据源必须显式 confirm: true。
安全与视觉规范¶
密码单独存放在插件数据目录的 secrets.json（base64 + 0600 权限，Windows 下继承 profile ACL），API 与日志只返回 hasPassword 和秘密名。插件遵循 DSH 官方视觉规范，只消费 --dsw-alias-* / --dsw-radius-* 等语义 token，自动适配深色主题，布局使用标准面板、标签、开关与模态组件。
键盘操作与手动事务¶
数据源树支持键盘操作：↑/↓ 在行之间移动，Home/End 跳到首尾，→ 展开、← 收起当前行，Enter 或空格选中该行（连接、查看结构）。展开/收起由行首箭头触发（或 →/←），双击数据源、Schema 或分组行也可以；点击行名不会折叠正在浏览的分支，双击表名仍是打开数据表标签页。焦点所在行有清晰的焦点框，方便只用键盘浏览库表。SQL 控制台工具条的「事务」通过 JDBC 关闭连接的 auto-commit 来开启事务，不再依赖 BEGIN 语句（Oracle 没有 BEGIN，只有 PL/SQL 块开头，直接发送会报 ORA-06550）；「提交」「回滚」调用驱动的 commit() / rollback()，完成后恢复 auto-commit，MySQL、Oracle、达梦等都适用。开启后「提交」「回滚」才可用，工具条同时显示「事务进行中」与操作结果提示。切换数据源或关闭标签页时，未提交的事务会被自动回滚。JDBC 桥接按连接复用同一个数据库会话，因此多条语句共享事务。
Redis 值表格化¶
选中键后按类型展示成表格：hash 拆成「字段 / 值」，list、set 带序号，zset 展示「成员 / 分数」，stream 展示「ID / 字段」；表头显示类型、TTL（永久 表示无过期）与条目数，未知类型回退为原始 JSON。
运行要求¶
DeepSeek Harness >= 0.1.6-alpha.2（当前在 0.2.1 上开发验证）。关系型数据库需要本机可用的 Java（JAVA_HOME、PATH 或「设置 → Java 路径」显式指定），Java 8+ 即可；驱动与桥接 jar 都按 Java 8 字节码编译。也可以随包内置运行时：把 jlink 生成的 JRE 放到插件根目录的 jre/（即 jre/bin/java），启动时会优先使用它，其次才回退到系统 Java。jre/ 已加入 npm 发布文件列表。首次使用某个预设驱动时需要联网下载 jar（可在设置中切换 Maven 中央仓库 / 阿里云镜像）。Redis 走纯 JS 客户端，不需要 Java。
安装与启用¶
安装到 DSH 桌面版（profile desktop）：
dsh plugin --profile desktop add link:E:\ai-code-space\dsh-ide-database
或安装发布版包：
dsh plugin --profile desktop add dsh-ide-database
也可以在 DSH 的「设置 → 插件」页面选择从本地目录/包名安装。安装完成后重启 DSH（宿主半插件在进程启动时加载），在任意会话打开右侧边栏 → 「+」→「数据库」。
本地开发模式：
npm install
npm run build # 编译 Java 桥接、宿主 TS、浏览器 bundle
npm test # 单元测试
本地调试可以用一个独立的 Web profile 启动第二个 DSH 实例：
export DSH_HOME=~/.dsh-dev
export DSH_PROFILE=dbweb
dsh --profile dbweb --from-default-profile web --dump-config # 首次创建 profile
dsh plugin --profile dbweb add link:E:\ai-code-space\dsh-ide-database
dsh --profile dbweb --port 16402 --no-open
典型用法¶
- 打开右侧边栏，点「+」→「数据库」，或在 Guide 页点击「数据库」胶囊。
- 新建连接，选择预设数据源（如 MySQL），填写 host、port、用户名、密码。
- 连接成功后，在树中展开数据源、Schema，浏览表结构与列。
- 双击表名打开数据表标签页，输入
WHERE条件或使用列筛选，翻页浏览数据。 - 右键单元格复制值或整行，或点击下载按钮导出 CSV/JSON/SQL。
- 切换到查询控制台，编写 SQL 或 Redis 命令，执行后查看结果与执行计划。
- 将常用语句收藏到历史顶部，方便重复使用。
适用场景与注意¶
该插件适合需要在 DSH 中统一管理多个数据库、频繁浏览表结构、执行 SQL 或供 Agent 调用的开发者。安装前应检查插件源码与许可证，确保符合项目规范。插件以当前 DSH 进程权限运行，涉及数据库连接与操作，建议仅在受控环境中使用。
结语¶
dsh-ide-database 插件在 DSH 右侧边栏提供了从数据源管理、结构浏览、SQL 查询到结果导出的完整流程，同时也为 Agent 提供了结构化的 db_* 工具。如果你正在为 DSH 寻找可靠的数据库交互入口，可以访问插件目录页与 GitHub 仓库了解更多细节。
