A native DSH plugin that turns DeepSeek Harness into a conversational data analyst: connect a DB, ask in natural language, get SQL-backed conclusions and HTML reports. Supports 9+ engines with read-only protection. Install via `dsh plugin --profile web add @yejiming/dsh-data-agent`.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-23
License
MIT
01What can it help you accomplish?
Analyze data by conversation: connect a database and ask business questions in plain language
DSH views the schema, writes and runs SQL against real data, iterates, and returns clear data conclusions and business insights; analysis reports save as offline HTML
Analysts and engineers who run DeepSeek Harness and want to query MySQL/PostgreSQL/SQLite/Oracle/ClickHouse/SQL Server etc. by talking to the agent
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness with the `dsh plugin` command
- Database client installed for your engine (mysql/psql/sqlcmd etc.) and network access to the target DB
Installation steps
- 01
Run `dsh plugin --profile web add @yejiming/dsh-data-agent` (or from GitHub: `dsh plugin --profile web add github:omdsh-dev/dsh-data-agent`)
$ dsh plugin --profile web add @yejiming/dsh-data-agent
- 02
Start the web UI with `dsh --profile web`, create a session, pick the '数据模式' (Data Mode) preset, then connect a database in the workbench
$ dsh --profile web
Verify the integration
Not specified by the author
Rollback
- Uninstall with `dsh plugin --profile web remove @yejiming/dsh-data-agent` (also `remove` for desktop and dsh-tui profiles); clear the preset with `rm -rf "$DSH_HOME/.agent-presets/data-agent"` if needed.
03DSH integration and capability boundaries
Native DSH plugin that connects databases and lets DeepSeek Harness analyze data by conversation (auto SQL, business insights, HTML reports, read-only protection).
Conversational data analysis
Natural-language business questions→DSH writes and executes SQL, iterates on real results, returns conclusions and business insights
When not in read-only mode the agent can run update/management statements at your requestAI data governance (catalog)
Database schema, columns, comments, relations→AI-proposed business meanings per table/column, confirmed by the user; later queries read them via catalog-search/catalog-get/metric-get
Catalog persists only desensitized source summaries, metadata, versions and human curated meanings — no passwords, credentials, query results or sample rowsHTML analysis reports (render-analysis)
Analysis results→Versioned offline HTML reports (metric/line/bar/pie/scatter/table) saved under analysis-reports/ in the working dir
Reports are atomically saved to the session working dir; the full dashboard is self-contained (inline data/styles/SVG) and opens offline18-tool data protocol
Same 8-tool protocol across web/desktop/dsh-tui/headless→sql-query, sql-write, sql-cmd, render-analysis, catalog-search, catalog-get, metric-get plus str_replace_editor for files
Host/community tools like describe_image and ssh_* do not enter Data Mode
04Who is it for? When not to use it?
Good for
- Analysts and engineers who run DeepSeek Harness and want to query MySQL/PostgreSQL/SQLite/Oracle/ClickHouse/SQL Server etc. by talking to the agent
Not for
- The plugin and its ecosystem adapters run in-process inside DSH — not an OS, process or realm sandbox. Ecosystem permission only negotiates admission; it does not replace DB account privileges, network isolation or host security policy.
- For production databases, use a read-only DB account and enable read-only mode in the connection form; otherwise the agent can run update/management statements.
- Each engine needs its own CLI client (mysql/psql/sqlcmd/clickhouse HTTP); SQL Server needs Microsoft ODBC sqlcmd 18.x and only supports SQL Login (no Windows/Entra/DSN/named instances).
05Compatibility, maintenance and safety notes
- The plugin and its ecosystem adapters run in-process inside DSH — not an OS, process or realm sandbox. Ecosystem permission only negotiates admission; it does not replace DB account privileges, network isolation or host security policy.
- For production databases, use a read-only DB account and enable read-only mode in the connection form; otherwise the agent can run update/management statements.
- Each engine needs its own CLI client (mysql/psql/sqlcmd/clickhouse HTTP); SQL Server needs Microsoft ODBC sqlcmd 18.x and only supports SQL Login (no Windows/Entra/DSN/named instances).
MIT · 由 facts pack 抓取（README 分支 main）
06Frequently asked questions
How do I install dsh-data-agent?
Run `dsh plugin --profile web add @yejiming/dsh-data-agent` (or `github:omdsh-dev/dsh-data-agent`), then `dsh --profile web`. In a new session pick the 'Data Mode' preset and connect a database in the workbench.
Which databases are supported?
MySQL, PostgreSQL, SQLite, Oracle, Hive, Impala, ClickHouse, Apache Doris and SQL Server. Each needs its own CLI client; SQL Server requires Microsoft ODBC sqlcmd 18.x and SQL Login only.
Is my database safe?
The plugin runs in-process inside DSH (not a sandbox), so for production use a read-only DB account and enable read-only mode in the connection form. Otherwise the agent can run update statements at your request.
What do the analysis reports look like?
The render-analysis tool writes versioned, self-contained HTML reports (metric/line/bar/pie/scatter/table) to analysis-reports/ in the session working dir; they open offline and persist with the session log.
07Related DSH workflows
weknora
by tencent
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
honcho
by plastic-labs
Memory library for building stateful agents
mirage
by strukto-ai
The World's First Virtual Terminal for AI Agents
reme
by agentscope-ai
ReMe: Memory Management Kit for Agents - Remember Me, Refine Me.
08Data and sources
dsh-data-agent是DeepSeek Harness（DSH）的数据分析插件。
dsh plugin --profile web add @yejiming/dsh-data-agent
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-23. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.