前言¶
在 DeepSeek Harness（DSH）里让 Agent 回答业务数据问题，常见做法是手写 MCP、把连接串塞进环境变量，或让模型直接拼 SQL。连接分散、权限难收口，结构探索也容易把整库元数据一次性灌进上下文。社区插件 dsh-database（维护者 blkpne）走另一条路：在 Web 里集中管理连接，按连接授权后，由 Agent 先发现表或集合结构，再执行只读查询。下面介绍它的定位、能力与上手步骤。
这是什么¶
dsh-database 是 DSH 的「联网工具」类插件：通过 Web 界面管理数据库连接，为每个连接暴露 MCP 工具，使 Agent 在授权范围内探索结构并执行只读查询。支持 MySQL、MariaDB、PostgreSQL、SQL Server、Oracle 和 MongoDB。
项目托管于 GitHub：blkpne/dsh-database，目录页见 SkillHub。当前 npm 包版本为 0.1.1，采用 MIT 许可证。插件以只读数据访问为设计边界：不提供写入、结果导出、SQL 历史重放或 SSH 隧道；数据库账户也应配置为只读。
核心功能¶
根据官方 README，插件主要提供以下能力：
- 连接管理：在同一界面填写连接信息、测试认证，管理多种数据库类型；凭据由 DSH 保存，新连接默认启用 TLS 证书校验。
- 按需了解结构：搜索表、视图和集合，查看字段、约束与索引，无需预先加载整个库的定义。
- 控制 Agent 访问：连接默认关闭 Agent 访问；可限定会话、只开放结构发现，并设置调用额度。
- 调用可观测：查看诊断、耗时、错误阶段和取消状态；调用记录不保存 SQL、参数或业务行。
查询结果会进入 Agent 上下文；宿主会话与模型侧的数据处理范围见仓库内 使用指南。
安装与启用¶
插件随 DSH 进程运行，安装前请自行查看源码与许可证，并确认当前环境权限是否适合挂载生产或测试库连接。
环境要求¶
- Node.js：
>=22.19.0（见package.json的engines） - DSH：
>=0.2.0-rc.2 - 详细兼容性见仓库 docs/compatibility.md
尚未安装 DSH 时，可先全局安装：
npm install --global @deepseek-ai/dsh@latest
Windows PowerShell 可使用 npm.cmd 和 dsh.cmd。
安装插件¶
已安装 DSH 时，在终端执行以下命令，将插件安装到 web Profile。安装或更新前，请先停止正在运行的该 Profile：
dsh plugin --profile web add dsh-database@latest --ignore-scripts
命令从 npm 下载已构建的插件，无需克隆仓库或本地打包。更新插件使用同一条命令，完成后重新启动 Web。若安装时提示找不到 pnpm，可先执行 npm install --global pnpm@latest 后重试。
启动 Web¶
dsh --profile web --host 127.0.0.1 --port 3080 --no-open
web Profile 不存在时，DSH 会初始化它。打开终端输出的登录链接，侧栏应出现「数据库」。首次使用 DSH 时，按宿主提示完成模型配置。
典型用法：第一次查询¶
经过上面的步骤，可按 README 完成首次连通与授权：
- 打开「数据库」，创建连接，填写可访问的数据库地址、数据库名和只读账户。
- 点击「测试当前配置」，成功后保存。私有 CA 的配置见使用指南中的 TLS 连接。
- 在「授权规则」中选择访问范围并保存，再开启「Agent 访问」。
- 在获授权的会话中提问，例如：
使用「业务分析库」列出我能访问的表。先查看相关字段，再统计订单数量，并说明使用了哪张表。
测试成功只代表当前配置可连接，不会自动保存或开启 Agent 访问。查询数据与分析结论在 Agent 对话中查看；「调用记录」用于查看状态、耗时和错误。
官方还给出一个可复现的场景：电商经营复盘——例如分析订单增长而净收入增速放缓时，Agent 可先通过插件了解订单与退款表，在数据库端按月、按渠道聚合，再结合宿主文件与执行工具生成图表与建议。合成数据与操作步骤见 docs/examples/ecommerce/README.md。
适用场景与注意¶
适合谁：需要在 DSH Web 里统一管理多种关系型库与 MongoDB、希望 Agent 在明确授权与额度下做只读探库与查询的团队或个人。
边界与运维：
| 现象 | 先检查 |
|---|---|
| 侧栏没有「数据库」 | 是否安装到正在使用的 Web Profile、是否重启、DSH 版本是否匹配 |
| TLS 或证书错误 | 主机名是否匹配证书，宿主是否信任签发 CA |
| Agent 看不到工具 | 访问开关、已保存的授权范围、当前会话；仅结构发现模式不会提供查询工具 |
| 查询被拒绝、结果不完整 | 查询是否只读，是否达到额度或结果上限 |
工具参数、返回格式与限额见 docs/reference.md。更新、停用或卸载见使用指南中的维护章节。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。选用第三方插件前，请结合组织安全策略评估连接凭据与查询结果进入模型上下文的风险。
结尾¶
dsh-database 把多库连接、结构发现与只读查询收口到 DSH Web 与按连接授权，适合在 Harness 里用自然语言驱动数据分析，又需要可控权限与可观测调用的场景。进一步了解请访问 目录页 与 GitHub 仓库。
