🛠️ 本地开发

确保上一步环境配置已配置好

1. 后端依赖安装

• uv安装 参考uv官方文档

# 安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh

#进入项目目录
cd sanic-web

# 创建虚拟环境
uv venv --clear

# 激活虚拟环境

# Mac or Linux 用户执行
source .venv/bin/activate

# Windows 用户执行
.venv\Scripts\activate

# 安装依赖
uv sync --no-cache

# pycharm 配置虚拟环境
Settings -> Project: sanic-web -> Project Interpreter -> Add -> Existing environment
选择.venv目录

2. 修改.env.dev配置文件

• 根据实际情况修改一下配置信息
• 以下配置本机启动默认不用修改在服务器上启动时localhost需修改为实际IP地址
  • 可修改MYSQL_HOST MySQL数据服务地址
  • 可修改SQLALCHEMY_DATABASE_URI 数据库连接池地址
  • 可修改MODEL_API_KEY 大模型服务API-KEY
  • 可修改MINIO_ENDPOINT MinIO服务地址
  • 可修改DIFY_SERVER_URL Dify服务地址
  • 必须修改MINIO_ACCESS_KEY MinIO服务Key
  • 必须修改MINIO_SECRET_KEY MinIO服务密钥
  • 必须修改DIFY_DATABASE_QA_API_KEY Dify智能体Api-Key
  • 必须修改MCP_HUB_COMMON_QA_GROUP_URL 通用问答MCP-HUB工具集组地址
  • 必须修改MCP_HUB_DATABASE_QA_GROUP_URL 数据问答MCP-HUB工具集组地址
  • 可修改MODEL_NAME 大模型名称如qwen-plus
  • 可修改MODEL_BASE_URL 公网大模型服务地址默认使用阿里云公网模型服务

3. 初始化数据库

• 如果使用已安装的mysql,初始化数据时需修改源码initialize_mysql里面的连接信息

# Mac or Linux 用户执行
cd docker
./init_data.sh

# Windows 用户执行
cd common
python initialize_mysql.py

4. 前端依赖安装

• 前端是基于开源项目可参考chatgpt-vue3-light-mvp安装二开

# 安装前端依赖&启动服务
cd web

#安装依赖
npm install -g pnpm

pnpm i

#启动服务
pnpm dev

5. 启动后端服务

#启动后端服务
python serv.py

6. 访问服务

• 前端服务：http://localhost:2048

7. 构建镜像

• 执行构建命令：

# 构建前端镜像 
make web-build

# 构建后端镜像
make service-build