# 第二步:构建前端并同步产物( npm run build 构建 dist ,npm run sync:dist 复制到 xxl-ai-api 静态资源目录)
cd xxl-ai-ui && npm install && npm run build && npm run sync:dist && cd ..
# 第三步:构建后端
mvn clean package
# 第四步:进入 docker 目录(支持自定义 .env 配置,如修改 MYSQL_PATH 配置设置 Mysql 数据持久化目录)
cd ./docker/
cat .env
# 第五步:启动/停止项目
docker compose up -d
docker compose down
4.2 [本地版( Desk 桌面端)]
XXL-AI 本地版项目,支持跨平台客户端一键安装,下载对应版本(如 mac/win )安装程序即可。
● 下载地址:https://github.com/xuxueli/xxl-ai/releases
五、核心功能操作指南
5.1 [本地版( Desk 桌面端)]
● 安装并打开 Desk 客户端
● 配置供应商模型
● 使用示例:Desk 客户端/Agent 通过 本地系统能力( Node/Python )进行文件操作。
5.2 [云版( Web 服务端)]
● 登录工作台
● 编排 Agent
● 发布 Agent
● 使用示例:Agent 调用 MCP 工具(网页抓取)汇总「今日热点社会新闻」