本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-data-agent

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 通过对话完成数据分析：直接用自然语言描述目标，DSH会理解问题、拆解分析步骤、查询真实数据并整理结论。你可以继续追问，分析会沿着当前上下文逐步深入。
• 自动寻找商业洞察：不仅返回查询结果，还能帮助比较趋势、定位异常、识别高价值客户或商品，并把数据转化为便于业务决策的说明。
• 连接常见业务数据库：支持MySQL、PostgreSQL、SQLite、Oracle、Hive、Impala、ClickHouse、Apache Doris和SQL Server，可用于业务系统、分析库、本地数据文件及数仓场景。
• DSH自动完成分析闭环：DSH会根据当前问题查看表结构、编写SQL、执行查询，并结合报错或返回结果继续调整，而不是只生成一段未经验证的SQL。
• 专注数据任务的数据模式：会话使用DSH原生str_replace_editor处理文件，并保留sql-query、sql-write、sql-cmd与render-analysis；Web、Desktop、dsh-tui和headless profile使用同一工具协议。describe_image、ssh_*等宿主或社区插件工具不会进入数据模式。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

插件支持哪些数据库？

支持 9 种：MySQL、PostgreSQL、SQLite、Oracle、Hive、Impala、ClickHouse、Apache Doris、SQL Server，覆盖业务库、数仓、本地 SQLite 文件等多种场景。

数据库密码如何处理？

Web 临时密码只存在进程内；TUI 表单仅显示 *，重新打开不会恢复。持久化采用 DSH credential reference 引用，MySQL/Doris 通过 MYSQL_PWD 环境变量传，SQL Server 用 SQLCMDPASSWORD，ClickHouse 通过 HTTP 认证字段。

是否需要安装数据库 CLI 客户端？

是。除 ClickHouse（用包内置的官方 HTTP 客户端）和 SQLite（系统通常自带）外，其他数据库需命令行客户端（mysql、psql、sqlplus、beeline、impala-shell、Microsoft ODBC sqlcmd 18.x 等），未在 PATH 时可通过 profile 的 clients.searchPaths 或 command 指定。

安装失败或出现 failed to mount 怎么办？

通常是当前 profile 还没装插件或仍在用旧版 preset。未改动的旧版 preset 会自动迁移；手工编辑过的 preset 需要手动删除其中指向 @yejiming/dsh-data-agent/tool 与 /command 的两行配置块。

分析报告 HTML 存放在哪里？

每次成功的 render-analysis 调用都会在会话工作目录的 analysis-reports/{title}.html 生成一份离线 Dashboard，断网也能直接打开；Web 同时给出内联预览与"查看分析"按钮，dsh-tui 只返回文件路径。

只读模式是绝对安全吗？

不是。插件运行在 DSH 进程内（trusted in-process），不提供 OS/进程沙箱。推荐组合是数据库只读账号 + 连接表单只读模式，但账号权限才是最终边界。

Doris 和 SQL Server 当前支持有什么限制？

Doris 当前只浏览当前/internal catalog；SQL Server 只支持 SQL Login，不支持集成/Windows/Entra 认证、DSN 或命名实例。

卸载插件会删除连接信息吗？

默认卸载只移除运行时 effect，不会主动删除已保存的非敏感连接信息（key 为 data_agent_connections@1）和数据模式 preset；如需彻底清理需手动删除 DSH_HOME/.agent-presets/data-agent 并通过 DSH 存储管理删除连接记录。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.7+
• Node: 未声明
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则