数据分析插件
这是一个给 DeepSeek Harness 使用的数据分析插件。安装以后，用户只要把一个表格文件交给它，再用一句话说明想分析什么，它就会自动完成后面的工作：读数据、清洗数据、做探索分析、画图或建模、生成报告。
界面预览
支持多种表格文件
插件可以直接读取下面这些文件：
- CSV 和 TSV 文本表格
- Excel 文件（
.xlsx、.xls） - JSON 数据
- Parquet 文件
- 普通文本文件（
.txt）
读取时会自动判断文件编码、分隔符和表格结构，不需要用户手动告诉它“这是逗号分隔还是制表符分隔”。
自动清洗数据
模型会自动处理常见的数据问题，包括重复值、缺失值、数据类型错误和异常值。清洗后的中间结果会保存成文件，方便下一步继续使用。
自动做探索分析
插件会先帮用户快速了解数据：看看每列有多少空值、数据大致长什么样、有没有明显规律，再决定接下来怎么分析。
支持两条分析路线
- 可视化分析：生成可以在网页上交互的图表。
- 机器学习建模：做分类或回归任务。
用户可以在分析过程中选择走哪条路。
全自动模式
用户可以在一开始就说"全自动"或 "auto"，插件会跳过中间的确认步骤，从读取文件、清洗数据、选择路线到生成报告一路跑完，不需要人工介入。如果没有指定全自动，插件会在清洗数据后停下来，等用户确认继续并选择分析路线。
自动生成报告
分析结束后，插件会生成一份 Markdown 报告，并尝试导出成 PDF。如果当前环境里没有 PDF 渲染工具，它会保留 HTML 版本，不让分析结果丢失。
过程可以回看
插件会把“读了哪个文件、选了哪条路线、画了哪些图、生成了哪份报告”都记录下来。用户刷新页面后，仍然能看到当前进度、已经生成的图表和报告。
一次分析是怎么跑完的
- 用户给出文件路径和分析问题。
- 插件读取文件，生成一个标准格式的数据文件。
- 插件自动清洗数据，把清洗后的数据保存下来。
- 插件询问用户是否继续；如果用户一开始说了“全自动”，就跳过这一步。
- 用户选择可视化分析或机器学习建模。
- 插件做探索分析，然后画图或训练模型。
- 插件保存图表和最终报告。
- 插件尝试导出 PDF；没有 PDF 工具时，给用户 HTML 报告。
它由哪几部分组成
| 部分 | 作用 |
|---|---|
| Python 运行环境 | 在一个独立的 Python 进程里运行模型写的数据分析代码，避免影响主程序 |
| 分析工具 | 提供读取文件、选择路线、保存图表、保存报告、导出 PDF 等按钮 |
| 操作说明 | 告诉模型每一步应该怎么清洗、探索、画图和建模 |
| 网页展示层 | 把保存的图表和报告渲染成网页里的可交互卡片 |
| 安装组合包 | 把上面几个部分按正确顺序装到一起，让插件启动时能正常使用 |
如果你关心更具体的内部结构，可以看后面的架构文档。
运行示例
GUI界面展示可视化结果
分析报告生成
安装
安装前需要准备三样东西：
- 一个可以运行的 DeepSeek Harness
- Python 3.11 或更高版本
- pnpm
推荐使用本地源码部署。下面的脚本会自动安装 profile 和 data-analysis agent preset。完整步骤见 给人工看的安装、卸载与重装说明，快速路径是：
cd <插件目录>
pnpm install
pnpm build
scripts\reinstall-local.ps1 -DshRoot <dsh 源码目录> -PluginRoot <插件目录>
cd <dsh 源码目录>
pnpm dsh --profile data-analysis
如果你希望让 AI 自动安装，请看：
如果插件已经发布到 npm，也可以使用下面这条命令安装：
dsh plugin --profile data-analysis add @deepseek-ai/dsh-web-app@0.1.0-rc.6
dsh plugin --profile data-analysis add @andy1797833970/dsh-bundle-data-analysis
dsh plugin --profile data-analysis install
dsh --profile data-analysis
发布包安装后，还需要从插件源码目录安装一次 data-analysis agent preset：
cd <插件目录>
scripts\install-preset.ps1
macOS / Linux：
cd <插件目录>
sh scripts/install-preset.sh
注意：
- 上面两条
add命令要分开执行，不能合并成一条。 @deepseek-ai/dsh-web-app必须保留版本号0.1.0-rc.6，因为 npm 的latest标签目前仍指向更早版本。
卸载
在插件源码目录下运行卸载脚本，会删除 data-analysis profile 和对应的 agent preset，但不会删除会话历史：
scripts\uninstall.ps1
macOS / Linux：
sh scripts/uninstall.sh
如需同时删除插件根目录下的 .venv，加上 -RemoveVenv（PowerShell）或 --remove-venv（Shell）。
文档
| 文档 | 适合谁看 |
|---|---|
| 使用与概念说明 | 想了解插件怎么用、内部有哪些零件的人 |
| 架构说明 | 想知道插件内部怎么组合、数据怎么流动的人 |
| 开发与修改说明 | 想修改插件或了解完整卸载方式的人 |
| 安装说明 | 需要手动安装、卸载或重装的人 |
| AI 自动安装说明 | 帮用户自动安装插件的 AI |
| 运行示例 | 只想快速跑一个例子的人 |
当前限制
- PDF 导出依赖 Python 环境；如果环境里没有 PDF 渲染工具，就只给 HTML 报告。
- Python 代码运行在独立进程和文件沙箱里，但不是完整的容器级安全隔离。
后续计划
- 把 Python 运行环境升级到更严格的容器隔离。
- 增加更多数据来源和更多报告格式。
- 提供更简单的跨平台一键安装方式。
还没有评论，来写第一条。