# ZY SmartBI 安装与快速入门指南

## 产品简介

ZY SmartBI 是一款先进的对话式商业智能 (BI) 平台，它让您能够使用自然语言与企业数据进行交互。无需编写复杂的 SQL 查询，您只需提出问题，ZY SmartBI 就能为您生成准确的 SQL、可视化数据并提供智能分析。它支持多轮对话、数据下钻、异常检测和根因分析等高级功能，帮助您从数据中获取深刻洞察。

目前本产品为预览版，有6个月可用时间，获取更多授权，以及定制开发请联系我们。

更多信息请参阅 [用户快速入门指南](docs/user/01_quick_start.md) 和 [核心功能使用手册](docs/user/02_core_features_guide.md)。

## 安装步骤

请按照以下步骤安装和配置 ZY SmartBI：

### 1. 准备安装包

1. 从网盘下载 3 个必需的安装软件包以及本压缩包。

或者手动下载：
PostgreSQL （最新 17.6） ：https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

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

或者：https://drive.google.com/drive/folders/1MOtZ-NhEozVuN9MWv_lrjECpXn8WsLyZ?usp=sharing

注意：目前暂不支持 win7 系统，请升级到win10或win11以上

2. 将下载的 2 个软件包放置在本目录下，或手动安装。

### 2. 安装核心组件

1. 双击运行 `安装 展映 AI 智慧经营.bat` 脚本，安装核心组件。

### 3. 数据库配置 (默认使用 PostgreSQL)

ZY SmartBI 默认使用 PostgreSQL 数据库。请确保已安装并配置好 PostgreSQL。
**重要：在运行服务前，请务必手动创建名为 `chatbi_forge_dev` 的数据库。**
然后根据实际情况修改 `.env` 文件中的数据库连接信息：

```env
# 数据库配置
DB_USER=postgres
DB_PASSWORD=ZYCBI2025
DB_HOST=127.0.0.1
DB_PORT=5432
DB_NAME=chatbi_forge_dev
```

运行 services.msc 命令，启动 服务管理器，把 POSTGRE SQL 服务器 ，设置为自动启动。

### 4. 配置环境变量

编辑 `.env` 文件，配置以下关键信息：

```env
# 管理员账户 (首次启动时创建)
DEFAULT_ADMIN_USERNAME=admin
DEFAULT_ADMIN_PASSWORD=admin1

#开启任意密码登录，取消为False
LOGIN_DEBUG=True

# LLM API 密钥 (至少配置一个)
DEEPSEEK_API_KEY=your_deepseek_api_key_here
#或者使用 kimi2 
DEEPSEEK_API_BASE_URL="https://api.moonshot.cn/v1"
DEEPSEEK_TEXT_MODEL="kimi-k2-0711-preview"

DASHSCOPE_API_KEY=your_dashscope_api_key_here
DASHSCOPE_API_BASE_URL=https://dashscope.aliyuncs.com/api/v1

# 项目信息文件路径 (可选)
PROJECT_INFO_FILE_PATH=ZYchatBI_project_info.txt
```

### 5. 启动服务

双击运行 `运行 ZY chatBI.bat` 脚本，启动 ZY SmartBI 服务。

服务启动大约需要 40 秒。启动成功后，您可以通过以下 URL 访问系统：

*   **用户登录:** http://127.0.0.1:8000/login
*   **对话界面:** http://127.0.0.1:8000/chat
*   **管理员界面:** http://127.0.0.1:8000/admin/dashboard

## 快速体验

1. 打开浏览器，访问 http://127.0.0.1:8000/login
2. 使用默认管理员账户登录：
   *   用户名: `admin`
   *   密码: `admin1`
3. 在对话界面提出您的第一个问题，例如："显示去年每个月的销售总额。"
4. 查看系统生成的 SQL 查询、数据表格和可视化图表。

## 相关资源

*   **提示词示例:** `prompt_example.txt`
*   **用户手册:** `docs/user/` 目录下的系列文档
*   **管理员手册:** `docs/admin/` 目录下的系列文档

## 技术支持

如有任何问题，请联系您的系统管理员或技术支持团队。

深圳展映科技
微信 youkpan
zyinfo.pro