Skip to content
  • Home
  • Plugin manual
  • dsh-data-agent

omdsh-dev/dsh-data-agent

282Last commit Aug 15, 2026

dsh-data-agent DSH plugin

dsh-data-agent is a DSH plugin that enables natural language data analysis. It connects to databases, automatically examines table structures, writes and executes SQL, and iterates based on results to provide business insights.

developer-toolsskills-workflows

How to install the dsh-data-agent DSH plugin

dsh plugin --profile web add @yejiming/dsh-data-agent

Copying does not run this command. Review the repository and version before installing the dsh-data-agent DSH plugin.

dsh-data-agent DSH plugin data source

dsh-data-agent DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-data-agent DSH plugin can do

  • Natural language querying: describe analysis goals in plain English, and DSH generates and executes SQL
  • Automatic SQL execution with error handling and iterative refinement
  • Continuous analysis: keep the conversation context, ask follow-up questions to drill deeper
  • Support for MySQL, PostgreSQL, SQLite, Oracle, Hive, and Impala
  • Read-only mode with database read-only accounts for safe data exploration

Where the dsh-data-agent DSH plugin fits

  • Business performance analysis: ask questions like 'analyze order trends for last 30 days'
  • Anomaly detection: identify regions with declining sales and drill into causes
  • Customer segmentation: analyze repurchase rates and save SQL for review
  • Ad-hoc data exploration: browse tables, run temporary SQL, and get insights without leaving the chat

Who the dsh-data-agent DSH plugin is for

  • Data analysts who want to query databases through conversation
  • Business users who need quick data insights without writing SQL
  • Developers integrating DSH with databases for debugging or monitoring

dsh-data-agent DSH plugin limitations

  • Requires local database client tools (e.g., mysql, psql) installed on the machine
  • Database must be accessible from the machine running DSH; network and firewall settings apply
  • Read-only mode depends on the database account's permissions; the plugin itself does not enforce physical write prevention
  • Passwords are hidden in TUI but temporary; credential persistence relies on DSH credential reference feature

dsh-data-agent DSH plugin: from the repository README

Quoted from the omdsh-dev/dsh-data-agent README, the upstream source of the dsh-data-agent DSH plugin. Copyright remains with the original authors.

**中文** | [English](README.en.md) <p align="center"> <img src="assets/dsh-data-agent-banner.png" alt="dsh-data-agent HERO图" width="100%"> </p> <p align="center"> <img src="https://img.shields.io/github/v/release/omdsh-dev/dsh-data-agent?style=flat-square" alt="Version"> &nbsp; <img src="https://img.shields.io/github/stars/omdsh-dev/dsh-data-agent?style=flat-square" alt="Stars"> &nbsp; <img src="https://img.shields.io/npm/v/@yejiming%2Fdsh-data-agent?style=flat-square&label=npm" alt="npm"> &nbsp; <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"> </p> <p align="center"> <strong>让DeepSeek Harness连接数据库，用对话完成数据分析与商业洞察</strong><br> <em>自然语言查询 · 自动执行SQL · 连续分析 · Web UI · dsh-tui · 只读保护</em> </p> <p align="center"> [项目简介](#项目简介) · [主要功能](#主要功能) · [快速安装](#快速安装) · [Web UI](#在web-ui中使用) · [dsh-tui](#在dsh-tui中使用) · [安全说明](#安全说明) </p> ## 项目简介 dsh-data-agent是DeepSeek Harness（DSH）的数据分析插件。连接数据库后，直接提出业务问题，DSH会自动查看库表、编写并执行SQL、根据真实结果继续分析，最终给出清晰的数据结论和商业洞察。插件同时支持Web UI与dsh-tui，无需修改DSH源码。 ## 主要功能 - **通过对话完成数据分析**：直接用自然语言描述目标，DSH会理解问题、拆解分析步骤、查询真实数据并整理结论。你可以继续追问，分析会沿着当前上下文逐步深入。 - **自动寻找商业洞察**：不仅返回查询结果，还能帮助比较趋势、定位异常、识别高价值客户或商品，并把数据转化为便于业务决策

Read the full READMERepository license: MIT

dsh-data-agent DSH plugin questions

How do I install the dsh-data-agent plugin?

Run `dsh plugin --profile web add @yejiming/dsh-data-agent` for Web UI, and `dsh plugin --profile dsh-tui add @yejiming/dsh-data-agent` for TUI. If you use both interfaces, run both commands. After installation, restart DSH.

What databases does dsh-data-agent support?

It supports MySQL, PostgreSQL, SQLite, Oracle, Hive, and Impala. You need the corresponding database client installed on the machine where DSH runs (e.g., mysql for MySQL, psql for PostgreSQL).

Can I use dsh-data-agent with read-only access?

Yes, it is recommended to use a database read-only account and enable the 'Read-only' toggle in the connection form. This prevents accidental data modification. The plugin does not enforce physical write protection, so you should also set proper database permissions.

How do I switch to data mode in dsh-tui?

In an empty session, type `/preset data-agent` to switch to data mode, then use `/database connect` to fill in the connection details. After a successful connection, you can start asking analytical questions.

How do I uninstall the dsh-data-agent plugin?

Run `dsh plugin --profile web remove @yejiming/dsh-data-agent` and/or `dsh plugin --profile dsh-tui remove @yejiming/dsh-data-agent`. Then delete the preset with `rm -rf $DSH_HOME/.agent-presets/data-agent`. This does not delete saved non-sensitive connection info; clean DSH storage manually if needed.