一个面向商业分析场景的 AI Agent。
连接数据源后，用户只需使用自然语言提问，系统即可自动完成：

• 数据结构识别
• SQL 生成与执行
• 图表生成
• 业务洞察分析

© 2026 Zafer-Liu · 已申请中国计算机软件著作权（受理号 2026R11S0817877，软件名称：自然语言交互式经营数据分析软件 V1.0）· 采用 CC BY-NC 4.0 授权，禁止未授权商业使用，商用请联系作者。

💬 官方交流群： QQ 群 991636855 · Telegram 群 · Discord

• 📝 更新日志
• 🙏 赞助商
• ✨ 项目亮点
• 🧠 核心能力
• ⚙️ 安装说明
• 🛠 斜杠命令
• 📈 使用示例
• 🤖 LLM 配置说明
• ❓ FAQ
• 🤝 贡献指南
• 📄 License
• ⭐ 项目目标

---

📝 更新日志

当前版本 v1.1.0 LTS · 2026 年 7 月 2 日 · 📦 下载安装包

本次升级新增 斜杠命令系统、文件时光回退、Hooks 自动化、AI 预填建议 等多项功能，同时全面提升聊天界面与 Dashboard 的交互体验。

1. 全新斜杠命令系统
2. Hooks 用户自动化
3. AI 预填下一步建议
4. 工作目录时光回退
5. 工作目录管理增强

📖 详细更新日志

• Version Update Log（中文）
• Version Update Log (English)

---

🙏 赞助商

感谢以下赞助商对本项目的支持！

☁️ 赞助 · Sponsored by Bloome

感谢 Bloome 对本项目的赞助！Bloome 让多个 AI agent（Claude、ChatGPT、DeepSeek 等）在同一个对话里协作——零配置、云端运行，网页和手机都能用，还能把配好的 agent 分享给团队。

👉 试试 Bloome

---

☁️ 赞助 · Sponsored by DolOffer

感谢 DolOffer 对本项目的支持！DolOffer 是一个专注于数字产品推荐与优惠分享的平台，帮助用户快速发现值得关注的工具、服务和限时福利。平台提供 YouTube Premium、Claude、ChatGPT Plus、Spotify、Apple Music 等多种热门订阅服务，价格低至官方价的 3 折甚至更低，正版稳定，售后无忧。现在通过我们的专属链接注册，并在充值时输入优惠码 AI8888，即可额外享受 9 折优惠。

👉 了解更多

---

☁️ 赞助 · Sponsored by Atlas Cloud

感谢 Atlas Cloud 对本项目的支持！Atlas Cloud 是一个全模态 AI 推理平台，为开发者提供统一的 AI API 接口，涵盖视频生成、图像生成和大语言模型 API。您无需分别集成多个供应商，只需一次连接即可统一访问 300 多个精选的全模态模型。快来查看 Atlas Cloud 新推出的编程套餐推广活动，获取更经济实惠的 API 访问。

👉 了解更多

---

✨ 项目亮点

智析Agent是一个对话式商业数据分析智能体，目标是让非技术用户也能像"聊天"一样完成数据分析。

上传 Excel / CSV，或连接数据库后，用户可以直接提问：

最近三个月销售额趋势如何？
哪个地区利润最高？
帮我生成用户增长图

系统会自动：

1. 理解问题意图
2. 分析数据结构（Schema）
3. 自动生成 SQL
4. 执行查询
5. 自动推荐图表
6. 输出业务洞察

并通过 SSE（Server-Sent Events）流式输出，实时展示分析过程。

---

🎬 产品演示

一图胜千言，一段演示胜万图。

https://github.com/user-attachments/assets/4cc6f9d7-52d9-42c5-b3e7-059019f67275

---

🧩 推荐管理方式：智管-Agent Manager

智能商业分析 Agent 可以独立运行，也可以搭配 智管-Agent Manager 使用，获得更方便的桌面端管理体验。

智管-Agent Manager 是一个本地 AI Agent 的统一管理中心，适合管理多个本地 Agent 项目。 将智能商业分析 Agent 添加到智管后，你可以：

• 一键启动 / 停止智能商业分析 Agent
• 实时查看运行日志与端口状态
• 在桌面应用内直接打开 Web 分析界面
• 使用 Manager Agent 通过自然语言启动或打开本项目
• 开会演示时一键生成临时公网分享链接

示例：
帮我启动智能商业分析 Agent，并打开它的界面

这对于需要频繁演示、调试或同时运行多个 Agent 的用户尤其有用。

👉 项目地址：智管-Agent Manager

---

🧠 核心能力

1️⃣ 自然语言数据分析

无需编写 SQL，只需输入自然语言：

今年每个月的订单量趋势

系统即可自动完成：

• SQL 生成
• 数据查询
• 图表推荐
• 分析总结

2️⃣ 多数据源支持

支持上传和连接多种数据源：

• 文件：Excel / CSV
• 数据库：SQLite、MySQL、PostgreSQL、SQL Server
• 未来计划：DuckDB、Spark

3️⃣ 智能图表系统

系统会根据查询结果，从以下 6 大类 43 种图表中自动推荐最合适的一种：

分类	图表类型
对比类	Marimekko_ABS、Marimekko_PCT、Bar_Chart、Grouped_Bar_Chart、Stacked_Bar_Chart、Diverging_Bar_Chart、Dot_Plot、Waffle、Bullet_Chart、Sankey_Chart、Heatmap、Waterfall
时间趋势类	Line_Chart、Circular_Line_Chart、Slope_Chart、Sparkline、Bump_Chart、Cycle_Chart、Area_Chart、Stacked_Area_Chart、Horizon_Chart、Connected_Scatter
分布类	Histogram_Pareto_chart、Pyramid_Chart、Error_Bar_Chart、Box-and-Whisker_Plot、Violin_Chart、Ridgeline_Plot、Beeswarm_Plot、stem_leaf
地理类	Flow_Map、Dot_Density_Map、Choropleth_Map
关系类	Scatter_Plot、Bubble_Plot、Radar_Charts、Chord_Diagram、Arc_Chart、Network_Diagram、Parallel_Coordinates_Plot
占比类	Treemap、Sunburst_Diagram、Nightingale_Chart、Pie_Chart

4️⃣ SSE 流式分析体验

分析过程实时可见：

[1/4] 正在读取数据结构...
[2/4] 正在生成 SQL...
[3/4] 正在执行查询...
[4/4] 正在生成图表与洞察...

相比传统 BI 工具，更透明、更具交互感。

5️⃣ 多模型兼容

支持以下模型服务：

• DeepSeek
• OpenAI
• AtlasCloud
• 任意 OpenAI SDK Compatible API

并支持自定义 base_url、model、api_key。默认配置如下：

Provider	Default Model
DeepSeek	deepseek-v4-flash
OpenAI	gpt-4o-mini
AtlasCloud	deepseek-v4-pro

6️⃣ 数据分析

目前支持的数据分析功能包括：

• 异常值处理（截尾、缩尾处理）
• 十分位分组分析
• K-Means 聚类分析
• 决策树建模
• ……

7️⃣ 报告生成

支持导出：

• 整理后的 Excel 表格
• docx 格式报告
• 内置风格 PPT

8️⃣ MCP 拓展

支持连接本地或远程 MCP，拓展 Agent 技能。

• 教程：MCP_tutorial

9️⃣ 知识库输入

支持上传业务知识，让 Agent 更加了解你的数据。

• 教程：repository_tutorial

---

⚙️ 安装说明

🖥️ 方式 1：Windows 安装包（最简单，推荐）

从 GitHub Releases 下载最新版本：

平台	文件
Windows	BusinessAnalyticsAgent_v1.0.0_LTS.exe

前置要求：Python 3.10+、Windows 10 / 11 64 位。

双击安装包并按提示安装。安装完成后，从桌面或开始菜单启动 Business Analytics Agent。

---

方式 2：下载压缩包（推荐新手，跨平台）

前置要求：Python 3.10+
还没装？点此下载（Windows 安装时请勾选 "Add Python to PATH"）

第一步：下载并解压

第二步：双击启动

① 打开终端（Command + 空格 → 输入 Terminal → 回车）
② 在终端中运行（把路径替换为实际解压位置）：

chmod +x ~/Downloads/Data-Analysis-Agent/start.command
xattr -d com.apple.quarantine ~/Downloads/Data-Analysis-Agent/start.command

③ 双击 start.command 即可

首次启动会自动创建虚拟环境并安装依赖，约需 3–5 分钟，请耐心等待。之后启动无需等待。

第三步：启动后浏览器自动打开 http://localhost:5001

第四步：配置 API Key

第五步：后续更新

---

方式 3：一键在线安装

Windows（在 PowerShell 中运行）：

iwr -useb https://raw.githubusercontent.com/Zafer-Liu/Data-Analysis-Agent/main/install.ps1 | iex

安装完成后双击桌面的 data-analysis-agent.bat 启动，或：

cd $env:USERPROFILE\.data-analysis-agent\Data-Analysis-Agent
.\.venv\Scripts\activate
python app.py

macOS / Linux（在终端中运行）：

curl -fsSL https://raw.githubusercontent.com/Zafer-Liu/Data-Analysis-Agent/main/install.sh | sh

安装完成后运行：

data-analysis-agent

如提示 command not found，将以下内容添加到 ~/.zshrc 或 ~/.bashrc，然后重启终端：

export PATH="$HOME/.local/bin:$PATH"

---

方式 4：通过 GitHub Clone

git clone https://github.com/Zafer-Liu/Data-Analysis-Agent.git
cd Data-Analysis-Agent
pip install -r requirements.txt
python app.py

浏览器打开 http://localhost:5001，然后配置 API Key（同方式 1）。

---

🛠 斜杠命令

Command	Status	Description
/chart	✅	强制优先生成图表
/sql	✅	直接执行 SQL
/analyze	✅	深度统计分析
/tree	✅	决策树分析
/kmeans	✅	K-Means 聚类分析
/data	✅	数据探查与预览
/inset	✅	缺失值插补处理
/winsorize	✅	缩尾处理（极值替换）
/trimming	✅	截尾处理（极值剔除）
/export	✅	导出数据文件
/report	✅	导出 Word/PDF 报告
/ppt	✅	导出 PPT 演示文稿
/status	✅	查看任务状态

---

📈 使用示例

示例 1：趋势分析

用户输入：

最近 12 个月销售趋势

系统输出：

• SQL 查询
• 趋势折线图
• 销售增长分析

---

示例 2：区域分析

用户输入：

哪个地区利润最高？

系统输出：

• 地区利润排行
• 柱状图
• 区域经营洞察

---

示例 3：图表优先模式

用户输入：

/chart 用户增长情况

系统会优先生成可视化图表。

---

🤖 LLM 配置说明

在侧边栏 ⚙ 中填写：

API Key
Base URL
Model

即可切换模型。

---

❓ FAQ

脚本会自动切换清华源重试。

若仍失败，请手动执行：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

脚本会自动切换国内镜像（清华源）重试。

若仍失败，请手动指定镜像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

同时请确保磁盘至少保留 2 GB 可用空间。

查看当前版本：

python --version

如果版本低于 3.10，请前往：

https://www.python.org/downloads/

下载并安装最新版本。

Python 未正确加入系统 PATH。

重新安装 Python 时勾选 "Add Python to PATH"，然后重启电脑再试。

在终端执行以下命令解除限制：

xattr -d com.apple.quarantine /你的路径/start.command

如果提示：

"无法打开，因为无法验证开发者"

可以：

1. 右键点击 start.command
2. 选择"打开"
3. 再次点击"打开"

---

在侧栏 ⚙ 中填写 API Key 并保存。

这里以 DeepSeek 为例：

---

请使用以下格式连接：

mysql+pymysql://用户名:密码@主机:端口/数据库名

示例：

❌ 错误写法：

mysql://user:pass@host:3306/dbname

✅ 正确写法：

mysql+pymysql://user:pass@host:3306/dbname

---

生成的图表保存在本地目录：

outputs/charts

可直接使用浏览器打开对应的 HTML 文件。

---

🤝 贡献指南

我们欢迎任何形式的贡献！无论是修复 Bug、改进文档还是添加新功能。

贡献流程

1. Fork 本仓库
2. 创建特性分支

   git checkout -b featu