DSH Data Analysis

简体中文 | English

在 DeepSeek Harness 中，用自然语言完成数据分析， 浏览和复用业务指标定义，并将结果整理为可交互、可离线阅读的图表、报告和看板。 语义分析能力由 Marivo 提供。

本项目是个人维护的社区插件，并非 DeepSeek 官方发行或维护的软件。

能力与特性

安装

环境准备

• Node.js ^22.19.0 || >=24.0.0：22.x 需至少 22.19.0，或使用 24.0.0 及以上版本；不支持 23.x。
• 已通过 npx @deepseek-ai/dsh web 启动并配置好 DeepSeek Harness >=0.1.5-rc.1。
• 命令行中可使用 pnpm，供 Harness 安装插件。
• Python 3.10+，命令行可运行 python3（Windows 为 python），且支持 venv/ensurepip；部分 Linux 发行版需额外安装 python3-venv。

无需预装 Marivo。首次启动会自动准备分析环境，需要联网下载依赖，请等待准备完成。

安装并启动

以下命令均通过 npx 运行 Harness，无需全局安装或将 dsh 添加到 PATH。

将插件安装到 Web Profile：

npx @deepseek-ai/dsh plugin --profile web add @chengxianglibra/dsh-data-analysis

安装后启动 Web Profile；如果已在运行，请先退出再重新启动：

npx @deepseek-ai/dsh web

在 Web 界面选择分析使用的工作区（Workspace），新建会话并发送一条消息。 会话标题旁会显示“数据源”“语义层”“报告”三个入口，相关页面在右侧标签页打开。以下以 Web 界面为例。

如何使用

1. 准备数据

本地文件：上传文件后直接提问，或指定工作区中已有文件，无需先配置数据源或建立业务定义。 支持 CSV、JSON、Parquet 和 Excel .xlsx；首次读取 .xlsx 需要联网下载扩展。 旧版 .xls 请先转换为 .xlsx、CSV 或 Parquet。

数据库：在会话标题旁打开“数据源”，查看当前工作区的连接与配置状态：

1. 点击“新增数据源”，选择引擎，填写名称及连接信息。
2. 如果需要身份认证，在“连接凭证”中填写用户名、密码或令牌。
3. 保存并测试连接，根据结果检查地址、凭证或访问权限。

已有数据源可通过“编辑配置”修改连接信息，名称和引擎保持不变；保存后重新测试。 已保存的凭证值不会回显，留空可沿用。请通过凭证表单提交密码或令牌，不要粘贴到聊天消息中。

分析过程中需要新增或修复数据源时，助手可打开配置页。你可以填写新连接，或选择“使用已有数据源”， 点击“保存并测试，成功后继续”，连接与目标数据访问验证通过后，助手会继续分析。

2. 用自然语言提出分析问题

说明使用哪些数据、时间范围、指标口径和希望得到的结果。例如：

使用订单数据，分析 2026 年 8 月的销售额和订单量，与 7 月比较，按渠道拆分，并说明数据来源和口径。

检查最近七天的查询耗时，找出耗时最高的查询类型，给出趋势图和明细表。

如果还没有整理业务定义，可以先让助手帮助梳理：

先查看当前数据源中有哪些订单相关表，和我确认销售额、支付订单数的统计口径，再保存为可复用的业务定义。

需要报告时，直接说明希望的内容：

将这次分析整理为一份报告，包含结论、关键指标、趋势图、渠道对比表和来源说明，并提供可下载的 HTML。

3. 浏览和引用业务定义

点击“语义层”，按分类或关键词查找指标、维度等对象，查看业务定义和对象关系。 支持独立打开对象，方便对照阅读。

在聊天输入框输入 @，搜索并选择当前工作区的对象；多词搜索可输入 @"monthly revenue"。 选中后即可围绕指定对象提问，让助手使用一致的业务口径开展分析。

4. 阅读、调整和追问报告

当前会话交付新报告后，会自动在右侧打开。通过“报告”目录可按标题查找报告，并排阅读不同报告和版本。 发现新版本时，页面会提示更新，你可以选择何时切换。没有活动会话时，也可通过侧栏的“报告”入口阅读工作区中的报告。

• 探索数据：筛选图表和表格，调整支持的图形及展示字段。交互使用报告中已保存的数据；获取新数据或重新计算时，在会话中提出要求。
• 查看来源：查看报告内容附带的来源信息，核对分析依据。
• 调整呈现：在最新版本页面点击“编辑报告”，编辑标题、正文、指标标签和图表／表格配置，移动或删除内容，支持撤销、重做和保存。
• 继续追问：在支持的报告内容菜单中选择“加入提问”，将相关内容引用到输入框，补充问题后发送。
• 查看历史：保存编辑后可在历史侧栏查看和下载已保存的版本，历史版本只读。

页面筛选不会重新计算指标卡，也不会写入保存的报告。希望保留当前筛选结果时，使用“导出当前视图”。

5. 下载与分享

报告右上角的导出菜单提供两种方式：

也可以直接让助手将报告导出为 HTML 文件。下载的文件可用浏览器打开，离线阅读和交互，无需连接原始数据源。 编辑模式下，请先保存或取消编辑再导出。

分析超时设置

在“设置 → 插件 → 插件配置 → 数据分析”中可调整 Python 分析的默认超时时间，默认为 120 秒， 保存后对下一次分析调用生效。实际执行时限仍受 Harness 执行策略约束。

许可证

本项目采用 MIT License。