快速开始

本指南将帮助你快速搭建 夜月AI应用平台 开发环境，并创建你的第一个AI应用。

环境要求

软件	版本	说明
Java	17+	JDK 17或更高版本
Maven	3.8+	构建工具
MySQL	8.0+	关系型数据库
Redis	6.0+	缓存和向量存储
Neo4j	5.0+	图数据库（可选）
Node.js	18+	前端开发（可选）

安装步骤

1. 克隆项目

git clone https://github.com/Nutgin/NiteMoon-Cloud.git
cd NiteMoon-Cloud

2. 配置数据库

创建MySQL数据库：

CREATE DATABASE nitemoon DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

导入数据库脚本：

mysql -u root -p nitemoon < docs/sql/nitemoon.sql

3. 配置Redis

确保Redis服务已启动：

redis-cli ping
# 应该返回 PONG

4. 配置应用

编辑配置文件 nitemoon-boot/src/main/resources/application.yml：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/nitemoon?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: your_password
  
  data:
    redis:
      host: localhost
      port: 6379
      password: # 如果有密码

# LLM配置（选择一个）
llm:
  providers:
    openai:
      api-key: ${OPENAI_API_KEY}
      base-url: https://api.openai.com/v1

5. 启动应用

# 编译项目
mvn clean install -DskipTests

# 启动应用（单体模式）
cd nitemoon-boot
mvn spring-boot:run

6. 访问系统

启动成功后，访问以下地址：

服务	地址	说明
管理后台	http://localhost:8000/boot	后台管理系统
API文档	http://localhost:8000/boot/doc.html	Knife4j API文档

默认管理员账号：

• 用户名：admin
• 密码：admin123

第一个应用

1. 配置LLM模型

登录管理后台，进入 系统管理 → 模型配置，添加LLM模型：

字段	值
提供商	OpenAI
模型名称	gpt-4
API Key	your_api_key
API端点	https://api.openai.com/v1

2. 创建知识库

进入 知识库管理 → 知识库列表，创建知识库：

字段	值
名称	产品文档
描述	产品相关文档

3. 上传文档

在知识库详情页，上传文档：

• 支持格式：PDF、Word、TXT、Markdown
• 自动解析和分块
• 自动生成嵌入向量

4. 创建对话应用

进入 应用管理 → 应用列表，创建对话应用：

字段	值
名称	智能客服
模型	gpt-4
知识库	产品文档
系统提示词	你是一个专业的客服助手...

5. 测试对话

在应用详情页，点击 对话测试，输入问题：

用户：如何配置RAG知识库？
AI：配置RAG知识库的步骤如下：
1. 进入知识库管理页面
2. 创建新的知识库
3. 上传文档
4. 配置检索参数
5. 在应用中关联知识库

常见问题

数据库连接失败

问题： 启动时报 Communications link failure

解决：

1. 检查MySQL服务是否启动
2. 检查数据库连接配置是否正确
3. 检查防火墙设置

# 测试MySQL连接
mysql -u root -p -h localhost

Redis连接失败

问题： 启动时报 Unable to connect to Redis

解决：

1. 检查Redis服务是否启动
2. 检查Redis配置是否正确
3. 检查Redis密码设置

# 测试Redis连接
redis-cli ping

模型调用失败

问题： 对话时报 Model call failed

解决：

1. 检查API Key是否正确
2. 检查API端点是否可访问
3. 检查模型名称是否正确
4. 检查账户余额是否充足

# 测试API连接
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer your_api_key"

知识库检索失败

问题： RAG检索返回空结果

解决：

1. 检查文档是否成功上传和解析
2. 检查嵌入模型是否配置正确
3. 检查向量存储是否正常
4. 调整相似度阈值

内存不足

问题： 启动时报 OutOfMemoryError

解决：

1. 增加JVM内存：

java -Xmx4g -jar nitemoon-boot.jar

2. 减少连接池大小
3. 优化查询语句

下一步

• API文档 - 了解RESTful API
• 示例代码 - 查看更多示例
• 技术架构 - 了解系统架构
• 功能概览 - 了解平台功能

在线演示

在线体验地址：platform.nitemoon.cn

• 用户名：demo
• 密码：UhOtrDnzRh

获取帮助

• GitHub Issues：提交问题和建议
• 文档：查阅详细文档
• 社区：加入开发者社区
• 邮箱：nutgin@foxmail.com