前言¶
DeepSeek Harness (DSH) 采用了插件化架构，旨在将各类数据源和工具接入智能体。在企业应用中，让智能体访问数据库或内部业务 API 是常见需求，但直接暴露凭证或赋予无限调用权限存在风险。dsh-connect 插件提供了一套标准化的连接与工具注册方案，解决数据接入与 Agent 调用之间的安全与协作问题。
插件定位¶
这是 DeepSeek Harness 的数据源连接插件，由 niuhuoshan 维护。它主要解决两个问题：一是将企业数据库和第三方 API 安全接入 DSH 环境；二是将这些连接转化为受约束的 Agent 工具，供智能体在对话中按需调用。
核心功能¶
插件提供以下核心能力：
* 数据库连接与结构发现：连接 MySQL、PostgreSQL 等数据库，扫描物理结构，生成可供 Agent 检索的元数据。
* AI 语义建模：利用 DSH 默认模型对表和字段进行语义识别，生成业务名称、描述和标签。
* 只读 SQL 查询：支持 Agent 生成受限的只读 SQL 语句进行数据查询。
* 固定 HTTP API 调用：配置固定的第三方 API，注册为受约束的 Agent 工具，模型无法修改 URL 或参数。
* Agent 工具注册：自动将配置好的数据源和 API 注册为 DSH Agent 可识别的工具。
* 元数据同步与指标推荐：支持增量同步和指标推荐功能，并支持 YAML 格式导出。
安装与启用¶
在 DSH 的 Web profile 中执行以下命令进行安装：
dsh plugin --profile web add @niuhuoshan/dsh-connect
安装完成后重启 DSH。进入 设置 -> DSH连接器，即可看到插件入口。页面包含 数据库 和 HTTP API 两个 Tab。
典型用法¶
数据库接入¶
- 在 设置 -> DSH连接器 -> 数据库 中点击 添加数据库。
- 填写连接信息（主机、端口、用户名、密码等），点击 测试连接。
- 点击 扫描 完成物理结构发现。若需语义识别，勾选 AI 语义增强 后点击 AI 建模。
- 在聊天中直接提问，例如：“华东区域本月每天的订单量和销售金额是多少？”，Agent 会检索元数据并调用查询工具。
HTTP API 接入¶
- 在 设置 -> DSH连接器 -> HTTP API 中添加 API。
- 配置固定的基础 URL、路径模板、认证方式和参数。
- 测试请求成功并启用后，在聊天中用自然语言描述需求，Agent 即可触发调用。
适用场景与注意事项¶
- 安全边界：数据库仅支持只读、DDL 和多语句，不支持写库。HTTP API 配置固定，模型无法修改 URL、方法或跨域跳转。
- 数据脱敏：样例数据仅保存在本地，不会暴露给 Agent 或模型。敏感字段（如密码、Token）会被自动脱敏。
- 凭证管理：数据库密码和 API 凭证保存在 DSH credential service 中，不会出现在列表接口或 Agent 返回值中。
- 开源协议：插件采用 MIT 许可证。
总结¶
dsh-connect 为 DSH 提供了标准化的数据源接入方案，通过 AI 语义建模和受约束的工具调用，让智能体能够安全、高效地访问企业数据和业务接口。如需了解更多细节，可参考社区目录或 GitHub 仓库。
