❓ 常见问题

快速找到您需要的答案。如果未找到解决方案，请前往 GitHub Issues 提交问题。

📚 分类导航

1. 🏗️ 安装部署

如何安装 NextConsole？

安装步骤

基础资源依赖：

硬件配置：至少 2 核 CPU、4GB 内存
操作系统：Linux 系统
浏览器：Chrome 浏览器，版本 110 及以上
容器化工具：Docker

快速安装：

git clone https://github.com/TuringOpsSH/NextConsole.git
cd NextConsole/docker
docker compose up -d

访问服务：

Server 服务：http://127.0.0.1:8080
Admin 服务：http://127.0.0.1:8082

默认登录信息：

用户名：admin@nextconsole.cn
密码：next_console

查看详细安装指南

支持哪些操作系统？

目前支持的操作系统：

✅ Windows 10/11
✅ macOS 10.15+
✅ Ubuntu 18.04+
✅ CentOS 7+

最低要求：

Node.js >= 18.0.0
Python >= 3.8
Docker 21+

如何配置模型API密钥？

配置路径：管理后台 → 模型管理 → 编辑模型配置

需要配置的密钥：

# SiliconFlow API密钥（用于文档理解与重排序）
EMBEDDING_KEY = "您的-SiliconFlow-API-KEY"
RERANK_KEY = "您的-SiliconFlow-API-KEY"

# Serper Dev 搜索引擎密钥
search_engine_key = "您的-Serper-API-KEY"

获取地址：

SiliconFlow：https://www.siliconflow.cn/
Serper Dev：https://serper.dev/

源码构建镜像的步骤是什么？

前置准备：

Docker 21+
Node.js 16+ (前端构建)
Python 3.10+ (后端服务)

构建步骤：

# 构建后端服务镜像
docker build -f docker/build/server/Dockerfile -t nc:standalone .

# 构建前端服务镜像  
docker build -f docker/build/web/Dockerfile -t nc-web:standalone .

# 启动服务
docker compose -f docker/docker-compose.yml up -d

2. 🎮 功能使用

小亦助手有哪些功能？

核心功能：

🤖 大模型问答：支持多轮对话，保持上下文
🔍 AI搜索：联网获取实时信息，提供基于最新资讯的解答
📚 文档问答：基于上传的文档进行智能问答
🏪 知识库问答：从AI资源库选择已有知识库进行问答

使用路径： AI工作台 → 小亦助手 → 新建对话

如何启用AI搜索功能？

操作步骤：

工作台 → 小亦助手 → 创建新会话
点击启用「AI搜索」按钮（按钮呈高亮状态表示已激活）
在输入框中提出问题

前置配置（管理员）：

vi docker/config/server/private.py
# 填入必要的API密钥

示例使用：

输入：2024年人工智能领域有哪些最新的发展趋势？
输出：智能摘要+参考来源

知识问答的两种方式有什么区别？

文档问答：

📄 上传新文档（PDF、Word、Excel等格式）
⏱️ 需要解析和构建处理时间
🎯 适合临时性文档分析

知识库问答：

🏪 从AI资源库选择已有文档或文件夹
⚡ 即时可用（已构建完成的文档）
👥 适合团队协作和重复使用
📦 集中存储和管理企业知识资产

AI资源库的主要功能有哪些？

功能	描述	应用场景
文件管理	上传、下载、删除、重命名文件，创建文件夹分类	企业研发部分类存放技术文档
文件预览	直接预览常见格式文件，无需外部程序	营销人员快速查看调研报告
文件分享	设置权限分享文件，多种分享方式	项目经理分享进度报告
RAG供数	对文件语义分析和索引，助力大模型精准回答	智能客服参考资源库解答问题

3. 🐛 故障排查

启动Docker容器时出现端口冲突怎么办？

解决方案：

检查端口占用情况：

netstat -tuln | grep 8080
netstat -tuln | grep 8082

修改docker-compose.yml中的端口映射：

ports:
  - "8083:8080"  # 将外部8083映射到内部8080
  - "8084:8082"  # 将外部8084映射到内部8082

重新启动容器：

docker compose down
docker compose up -d

模型配置连接失败如何解决？

排查步骤：

✅ 检查API密钥是否正确
✅ 验证API端点地址是否可达
✅ 确认网络连接正常
✅ 检查模型名称是否支持

常见问题：

API密钥格式错误
模型名称拼写错误
网络防火墙限制
API服务商额度不足

文档处理时间过长怎么办？

优化建议：

文档预处理：
- 将大型文档分章节上传
- 使用标准格式（PDF、DOCX）
- 避免扫描版图片PDF
系统优化：
- 增加系统内存配置
- 检查网络带宽
- 确认嵌入模型服务正常
监控状态：
- 在AI资源库查看文件处理状态
- 等待状态显示为"成功"后再使用

图片图标和文件下载异常如何解决？

问题现象

图片无法正常显示，显示为破损图标
文件下载失败或下载链接不正确
资源路径指向 127.0.0.1 导致外部无法访问

解决方案

1. 检查配置文件中的 domain 配置

# 进入 Docker 配置目录
cd NextConsole/docker

# 检查 server 配置文件
vi config/server/config_private.py

# 检查 admin 配置文件  
vi config/admin/config_private.py

2. 修改 domain 配置

在两个配置文件中，确保 domain 配置为当前服务器的实际 IP 或域名：

# config/server/config_private.py 和 config/admin/config_private.py
app.config["domain"] = "http://<您的服务器IP>:8080"    # 替换 127.0.0.1 为实际IP
app.config["admin_domain"] = "http://<您的服务器IP>:8082"  # 替换 127.0.0.1 为实际IP

示例配置：

# 正确配置（使用实际服务器IP）
app.config["domain"] = "http://192.168.1.100:8080"
app.config["admin_domain"] = "http://192.168.1.100:8082"

# 或者使用域名
app.config["domain"] = "http://your-domain.com:8080"
app.config["admin_domain"] = "http://your-domain.com:8082"

3. 重启服务生效

# 重启 Docker 容器
docker compose down
docker compose up -d

验证步骤

检查配置生效：

# 查看容器内配置
docker exec -it nextconsole_server cat /app/config_private.py | grep domain

测试资源访问：
- 访问 http://您的IP:8080 查看图片是否正常显示
- 尝试文件下载功能是否正常工作

常见问题排查

如果问题仍然存在：

检查网络连通性：

# 从服务器内部测试
curl http://127.0.0.1:8080/api/health

# 从外部客户端测试
curl http://您的服务器IP:8080/api/health

检查防火墙设置：

# 查看防火墙状态
sudo ufw status

# 如果需要开放端口
sudo ufw allow 8080
sudo ufw allow 8082

查看日志信息：

# 查看服务日志
docker logs nextconsole_server
docker logs nextconsole_admin

预防措施

部署前准备：
- 提前确定服务器IP地址
- 在配置文件中使用正确的IP或域名

环境变量配置（推荐）：

# 使用环境变量替代硬编码IP
export SERVER_IP="192.168.1.100"
# 在配置文件中使用
app.config["domain"] = f"http://{os.environ.get('SERVER_IP')}:8080"

如果以上步骤无法解决问题，请收集相关日志并在 GitHub Issues 提交问题。

4. 🔌 API 接口

如何获取API访问权限？

授权流程：

在AI应用工厂创建或导入应用
点击「发布新版本」
进入授权页面 → 点击「新增授权」
从用户列表中选择目标用户
完成授权设置

当前支持：

✅ NextConsole智能体服务平台
🔄 API接口（开发中）
🔄 钉钉集成（开发中）

API文档：访问 NextConsole官方文档获取详细API说明

如何调试应用工作流？

调试步骤：

进入应用工厂 → 选择应用
点击「测试运行」按钮
在右侧对话框中进行体验调试
点击调试图标查看节点执行数据
双击单元格查看详细执行情况

调试功能：

🔍 执行链路追踪
📊 中间结果分析
⚡ 实时错误提示
💡 性能监控指标

5. 💰 计费与订阅

NextConsole的许可证类型？

许可证信息：

📜 开源协议：Apache 2.0 License
🆓 免费使用：完全免费开源
🤝 社区支持：通过GitHub Issues获取帮助
🏢 企业版：提供商业支持和企业特性（可选）

官方资源：

📚 文档：https://docs.nextconsole.cn
🐛 Issues：https://github.com/TuringOpsSH/NextConsole/issues
💬 讨论：https://github.com/TuringOpsSH/NextConsole/discussions

第三方API服务的费用如何计算？

主要成本构成：

大模型API调用：
- 按token数量计费
- 不同模型价格不同
嵌入和重排服务（SiliconFlow）：
- 免费额度可用
- 超出后按使用量计费
搜索服务（Serper Dev）：
- 提供免费额度
- 额外搜索次数需付费

节约建议：

合理使用缓存
优化提示词减少token消耗
监控API使用情况

需要更多帮助？ 访问官方文档或联系 support@turingops.com

📚 分类导航​

1. 🏗️ 安装部署​

安装步骤​

2. 🎮 功能使用​

3. 🐛 故障排查​

问题现象​

解决方案​

验证步骤​

常见问题排查​

预防措施​

4. 🔌 API 接口​

5. 💰 计费与订阅​