前言¶
在 DeepSeek Harness（DSH）里做数据分析或调试业务库时，常见做法是切到独立的数据库客户端或写临时脚本，再把结果贴回对话。上下文容易断，助手也拿不到结构化的表与连接信息。dsh-db-studio 是社区插件，由 etShaw-zh 维护，分类为联网工具；它把连接管理、SQL 执行和对话内操作收进 DSH 界面，让查询与有限度的写操作可以在同一条对话里完成。
下面介绍插件定位、能力、安装步骤和配置要点；安装命令与配置项均来自仓库 README 与 package.json。
这是什么¶
dsh-db-studio 的定位是：在 DSH 中连接数据库，并在对话中查询、编辑数据。简介原文为：Connect to databases in DeepSeek Harness (DSH), then query and edit data right in the conversation.
- 维护者：etShaw-zh
- 仓库：https://github.com/etShaw-zh/dsh-db-studio
- 社区目录页：https://www.skillhub.cn/plugins/etShaw-zh/dsh-db-studio
- 许可证：MIT
- npm 包名：
dsh-db-studio，当前资料中稳定安装示例版本为1.0.3 - 运行要求（package.json）：Node
>=22.13，DSH>=0.2.1-rc.3
核心功能¶
浏览与管理数据库¶
左侧栏提供「数据库」面板，可浏览连接、表结构、分页数据并执行 SQL。驱动层面支持 SQLite / PostgreSQL / MySQL；SQLite 无需额外安装驱动（PostgreSQL、MySQL 依赖插件自带的 pg、mysql2）。
在对话里直接使用¶
- 对话内「数据库」标签：在当前对话中查看和操作已选数据库。
- 输入框旁多选下拉：为本次对话选择要使用的数据库，支持多选。
- 内置 4 个助手工具：协助查询、建表、写数据（可通过配置关闭，见下文
agentTools）。 /db指令：输入/，在指令列表选择「数据库」，打开数据库面板。- 查询历史：对话内数据库面板有「查询历史」tab，按用户对话轮次分组、可折叠，记录 SQL、连接、耗时和影响行数，点击可复现；左侧全局面板的查询历史按对话分组，点击可进入对应对话。
助手只能访问当前对话选中的数据库；未选择时会提示先选择。
安装与启用¶
安装前请确认本机 dsh CLI 路径。README 以 macOS 桌面端为例；Windows / Linux 需替换为对应路径。
从 npm 安装指定版本：
# macOS 桌面端
DSH_CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH_CLI" plugin --profile desktop add dsh-db-studio@1.0.3
从 GitHub 安装：
"$DSH_CLI" plugin --profile desktop add github:etShaw-zh/dsh-db-studio
安装后重启 DeepSeek Harness。更多稳定版见 Releases。
README 还说明可从源码目录安装（需本地已有克隆目录）：
"$DSH_CLI" plugin --profile desktop add "$PWD/dsh-db-studio"
插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证，再决定是否用于生产环境连接。
开始使用¶
- 左侧栏点击「数据库」，新建连接，或使用内置示例数据库。
- 在对话框里选中要用的数据库；也可以直接用自然语言让助手操作。
README 中的示例请求：
查一下示例数据库里最近 10 笔订单，按金额排序
把 users 表里杭州的用户城市改成「杭州·西湖区」
给 orders 表加一个备注字段
配置¶
插件配置写在 profile 的 cordis.patch.yml 中。常用项如下：
| 配置 | 默认 | 说明 |
|---|---|---|
demo |
true |
没有连接时自动创建示例数据库 |
allowWrite |
true |
是否允许写操作 |
agentTools |
true |
是否注册对话工具 |
maxRows |
200 |
查询最多返回行数 |
数据与安全¶
- 连接信息保存在
~/.dsh/dsh-db-studio/connections.json，文件权限为0600。 - 密码只保存在本机，不会发送到浏览器或模型上下文。
- 对接生产库时，README 建议：使用只读账号、只读连接，或设置
allowWrite: false。
适用场景与注意¶
适合需要在 DSH 里快速查表、验证 SQL、让助手基于真实库结构回答问题的开发者。不适合把未审计的写权限直接交给对话助手操作核心生产库——应结合 allowWrite 与数据库账号权限做限制。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的插件来自社区维护者 etShaw-zh，而非官方内置能力。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/etShaw-zh/dsh-db-studio
- GitHub：https://github.com/etShaw-zh/dsh-db-studio
- npm：https://www.npmjs.com/package/dsh-db-studio
经过上面的步骤，你可以在 DSH 内完成从建连接到对话查改数据的闭环；具体行为以仓库 README 与发布版本为准。
