Lumi-ONE V0.7 部署指南

发布时间：2025-03-17

更新说明 v0.7.0

– 新增支持 ARM 环境部署：现已全面支持 ARM 架构，确保更广泛的硬件兼容性。

– Lumi 页面增强：Lumi 页面现支持模型配置与维护功能，优化用户管理体验。

– Agent 功能扩展：Agent 现在支持文件导入和发布，提升工作流程的灵活性和效率。

本文档将指导您在 Linux/macOS 和 Windows 系统上部署 Lumi_ONE。我们将详细介绍环境依赖、安装步骤以及常见问题的解决方案。

一、环境依赖

在开始部署 Lumi-ONE 之前，请确保您的环境符合以下要求：

  • Docker：要求版本 19.03.0 或更高。
  • 操作系统：
  • Linux：任何常见的 Linux 发行版（例如 Ubuntu、CentOS、Debian 等）。
  • macOS：macOS 版本 10.12 或更高，目前只支持Intel Chip。
  • 硬件要求：
  • CPU：8核或更高（Intel x86 CPU、 华为 鲲鹏CPU）
  • 内存：32GB或更高
  • 硬盘空间：200GB或更高

二、安装步骤

2.1 加载 Docker 镜像到本地（如果下载的是离线版本）

2.1.1. 加载 Docker 镜像：
执行以下命令加载 Docker 镜像：

   sh load_tar.sh

2.1.2. 注意事项：
如果下载的是在线版本镜像，您无需手动执行此步骤。在部署过程中，Docker 镜像将会自动下载。

2.2 输入邮箱

在安装过程中，系统会要求您输入安装包时填写的邮箱地址。此邮箱必须与下载压缩包时填写的邮箱一致。如果您忘记了邮箱，可以重新进入下载页面并填写。

2.3 执行部署脚本

在终端中运行以下命令以启动部署过程：

sh start.sh

此时，系统会弹出一个选择菜单，提示您选择部署类别。您可以根据需要选择以下选项：

  • 1：选择单一部署产品。
  • 2：选择另一种部署产品。
  • all：选择同时部署所有产品。
  • 3：仅增加模型。
  • 4：导入dsl文件。

2.4 配置模型

部署完成后，系统将提示您进行模型配置。

系统内置了 deepseek:7b 模型，您可以选择使用该模型，也可以根据需要选择其他模型。如果您需要配置 Open-API 接口兼容模型，请提供以下信息：

  • API Key：用于验证 API 请求的密钥。
  • 模型名称：需要配置的目标模型名称。
  • 接口地址：API 请求的目标地址。

2.5 部署完成

一旦配置完成，部署就会成功。您可以根据需要进行后续操作。

三、添加新模型

如果您需要添加其他模型，请按照以下步骤操作：

3.1 执行部署脚本

再次执行以下命令启动配置过程：

sh start.sh

3.2 选择新增模型

在菜单中选择 3，进入新增模型配置界面。

3.3 配置模型信息

根据系统提示，按要求提供新增模型的相关配置信息。确保提供正确的模型名称、API 地址以及其他必要的参数。

Agent 使用说明
可用的 Agent 列表
  • 合同审查智能体
  • 简历优化助手
  • 销售对话洞察
  • 简历生成
  • 慢思考智能体
  • 文档审核代理
  • 职位描述生成
  • 反馈分析
  • 翻译
  • 提示词优化
Lumi 使用说明
模型配置

Lumi 的模型需要在页面的”模型服务”中进行添加和配置。

四、Windows 环境下的部署

在 Windows 上部署 Lumi_ONE 需要使用 WSL（Windows Subsystem for Linux）。以下是详细步骤：

4.1 安装 Docker

首先，您需要在 Windows 上安装 Docker。请参考 Docker 官方文档 完成安装。

4.2 安装 WSL 虚拟机

使用以下命令安装 WSL，并选择合适的 Linux 发行版：

wsl --install -d Ubuntu-20.04

安装成功后，您可以在开始菜单中找到 Ubuntu-20.04 图标。

4.3 配置 Docker 使虚拟机中可运行 Docker

根据 微软官方文档 配置 Docker，使得 WSL 环境下也能使用 Docker。

完成配置后，您可以通过点击 Ubuntu-20.04 图标进入虚拟机，并执行 docker ps 命令来确认 Docker 是否正常运行。

4.4 将脚本放入 WSL 虚拟机内

确保将部署脚本传输到 WSL 虚拟机中，然后在虚拟机内执行相关的部署命令。

4.5 Windows 换行符问题

在 Windows 上执行脚本时，可能会遇到换行符异常的问题，现象可能有两种：

  1. 提示如下错误信息：./start_add_model.sh: line 2: $'\r': command not found
  2. 提示报错信息：换行符不兼容。下图显示了报错和正常执行的区别：
解决方案

Windows 和 Linux 系统使用不同的换行符。Windows 使用 \r\n（回车+换行），而 Linux 使用 \n（仅换行）。解决此问题的常见方法是使用 dos2unix 工具来转换文件中的换行符。

五、常见问题解答（FAQ）

1. 如何将文件从 Windows 拷贝到 WSL 虚拟机中？

在 Windows 中将文件拷贝到 WSL 中，可以使用以下几种方法：

方法 1：使用文件资源管理器
  1. 打开 文件资源管理器，在地址栏输入 \\wsl$。
  2. 找到并进入您所安装的 WSL 发行版（如 Ubuntu）。
  3. 找到您要拷贝到 WSL 的文件夹。
  4. 将文件从 Windows 中拖拽到 WSL 的文件夹中。
方法 2：使用 cp 命令
  1. 在 WSL 终端中执行以下命令，将文件从 Windows 拷贝到 WSL 中：
   cp /mnt/c/路径/文件名 /home/用户名/目标文件夹/

例如，将 Windows 桌面的文件拷贝到 WSL 的 /home/用户名/ 目录：

   cp /mnt/c/Users/你的用户名/Desktop/文件名 /home/用户名/
方法 3：通过 VS Code 的 Remote-WSL 扩展
  1. 在 VS Code 中安装 Remote – WSL 扩展。
  2. 使用 VS Code 打开 WSL 环境，然后直接将文件拖拽到 WSL 文件夹中。

2. Windows 换行符问题（WSL 中不兼容 Windows 换行符）

如果您在 WSL 环境中遇到换行符问题，可以使用以下方法解决：

方法 1：使用 dos2unix 工具
  1. 在 WSL 中，使用以下命令将 Windows 风格的换行符（CRLF）转换为 Unix 风格（LF）：
   dos2unix 文件名
  1. 如果需要批量转换多个文件，可以使用：
   dos2unix *.txt
方法 2：使用 Visual Studio Code（VSCode）
  1. 在 VSCode 中打开文件。
  2. 在右下角，点击当前的换行符（如 CRLF）。
  3. 选择 LF（Unix 风格的换行符）。
  4. 保存文件，修改即生效。
方法 3：使用 .editorconfig 文件
  1. 在项目根目录创建一个 .editorconfig 文件，内容如下：
   [*]
   end_of_line = lf

这将强制所有文件使用 LF（Unix 风格的换行符）。

方法 4：使用其他编辑器
  • Sublime Text：从 View > Line Endings 中选择 Unix（LF）并保存。
  • Notepad++：选择 Edit > EOL Conversion > Unix (LF)。

通过上述方法，您可以轻松地解决换行符问题，确保在 WSL 或其他 Linux 环境下使用适当的 Unix 风格换行符。

整理md文件

格式整理与FAQ增加

重新整理文件

我正在重新整理Lumi_ONE部署指南的md文件，包括修复语言和格式问题，补充缺失的内容，并且增加几个常见问题的解答。这推动了整个文档的结构和清晰度。

创建Lumi_ONE指南

总览部署步骤

安排部署步骤已增加新FAQ条目：

3. 如何清理数据并重新部署？

如果您需要清理数据并重新部署 Lumi_ONE，请执行以下步骤：

  1. 在终端中运行以下命令：
   ./clear.sh

这将清理现有的部署数据，并准备系统进行重新部署。

  1. 然后，您可以按照原始的部署步骤重新执行部署脚本来重新部署系统。

更多常见问题请参考官方文档或联系我们的技术支持。

Lumi_ONE V0.6 部署指南

发布时间：2025-03-10

本文档将指导您在 Linux/macOS 和 Windows 系统上部署 Lumi_ONE。我们将详细介绍环境依赖、安装步骤以及常见问题的解决方案。

一、环境依赖

在开始部署 Lumi-ONE 之前，请确保您的环境符合以下要求：

  • Docker：要求版本 19.03.0 或更高。
  • 操作系统：
  • Linux：任何常见的 Linux 发行版（例如 Ubuntu、CentOS、Debian 等）。
  • macOS：macOS 版本 10.12 或更高。

二、安装步骤

2.1 加载 Docker 镜像到本地（如果下载的是离线版本）

首先，打开终端并进入 Lumi_ONE 项目的根目录。然后，执行 load 脚本，加载 Docker 镜像：

sh load_tar.sh

如果下载的是在线版本，则不需要执行此步骤，部署过程中会自动下载 Docker 镜像。

2.2 输入邮箱

在安装过程中，系统会要求您输入安装包时填写的邮箱地址。此邮箱必须与下载压缩包时填写的邮箱一致。如果您忘记了邮箱，可以重新进入下载页面并填写。

2.3 执行部署脚本

在终端中运行以下命令以启动部署过程：

sh start.sh

此时，系统会弹出一个选择菜单，提示您选择部署类别。您可以根据需要选择以下选项：

  • 1：选择单一部署产品。
  • 2：选择另一种部署产品。
  • all：选择同时部署所有产品。
  • 3：仅增加模型。

2.4 配置模型

部署完成后，系统将提示您进行模型配置。

系统内置了 deepseek:7b 模型，您可以选择使用该模型，也可以根据需要选择其他模型。如果您需要配置 Open-API 接口兼容模型，请提供以下信息：

  • API Key：用于验证 API 请求的密钥。
  • 模型名称：需要配置的目标模型名称。
  • 接口地址：API 请求的目标地址。

2.5 部署完成

一旦配置完成，部署就会成功。您可以根据需要进行后续操作。

三、添加新模型

如果您需要添加其他模型，请按照以下步骤操作：

3.1 执行部署脚本

再次执行以下命令启动配置过程：

sh start.sh

3.2 选择新增模型

在菜单中选择 3，进入新增模型配置界面。

3.3 配置模型信息

根据系统提示，按要求提供新增模型的相关配置信息。确保提供正确的模型名称、API 地址以及其他必要的参数。

四、Windows 环境下的部署

在 Windows 上部署 Lumi_ONE 需要使用 WSL（Windows Subsystem for Linux）。以下是详细步骤：

4.1 安装 Docker

首先，您需要在 Windows 上安装 Docker。请参考 Docker 官方文档 完成安装。

4.2 安装 WSL 虚拟机

使用以下命令安装 WSL，并选择合适的 Linux 发行版：

wsl --install -d Ubuntu-20.04

安装成功后，您可以在开始菜单中找到 Ubuntu-20.04 图标。

4.3 配置 Docker 使虚拟机中可运行 Docker

根据 微软官方文档 配置 Docker，使得 WSL 环境下也能使用 Docker。

完成配置后，您可以通过点击 Ubuntu-20.04 图标进入虚拟机，并执行 docker ps 命令来确认 Docker 是否正常运行。

4.4 将脚本放入 WSL 虚拟机内

确保将部署脚本传输到 WSL 虚拟机中，然后在虚拟机内执行相关的部署命令。

4.5 Windows 换行符问题

在 Windows 上执行脚本时，可能会遇到换行符异常的问题，现象可能有两种：

  1. 提示如下错误信息：./start_add_model.sh: line 2: $'\r': command not found
  2. 提示报错信息：换行符不兼容。下图显示了报错和正常执行的区别：

解决方案

Windows 和 Linux 系统使用不同的换行符。Windows 使用 \r\n（回车+换行），而 Linux 使用 \n（仅换行）。解决此问题的常见方法是使用 dos2unix 工具来转换文件中的换行符。

五、常见问题解答（FAQ）

1. 如何将文件从 Windows 拷贝到 WSL 虚拟机中？

在 Windows 中将文件拷贝到 WSL 中，可以使用以下几种方法：

方法 1：使用文件资源管理器
  1. 打开 文件资源管理器，在地址栏输入 \\wsl$。
  2. 找到并进入您所安装的 WSL 发行版（如 Ubuntu）。
  3. 找到您要拷贝到 WSL 的文件夹。
  4. 将文件从 Windows 中拖拽到 WSL 的文件夹中。
方法 2：使用 cp 命令
  1. 在 WSL 终端中执行以下命令，将文件从 Windows 拷贝到 WSL 中：
   cp /mnt/c/路径/文件名 /home/用户名/目标文件夹/

例如，将 Windows 桌面的文件拷贝到 WSL 的 /home/用户名/ 目录：

   cp /mnt/c/Users/你的用户名/Desktop/文件名 /home/用户名/
方法 3：通过 VS Code 的 Remote-WSL 扩展
  1. 在 VS Code 中安装 Remote – WSL 扩展。
  2. 使用 VS Code 打开 WSL 环境，然后直接将文件拖拽到 WSL 文件夹中。

2. Windows 换行符问题（WSL 中不兼容 Windows 换行符）

如果您在 WSL 环境中遇到换行符问题，可以使用以下方法解决：

方法 1：使用 dos2unix 工具
  1. 在 WSL 中，使用以下命令将 Windows 风格的换行符（CRLF）转换为 Unix 风格（LF）：
   dos2unix 文件名
  1. 如果需要批量转换多个文件，可以使用：
   dos2unix *.txt
方法 2：使用 Visual Studio Code（VSCode）
  1. 在 VSCode 中打开文件。
  2. 在右下角，点击当前的换行符（如 CRLF）。
  3. 选择 LF（Unix 风格的换行符）。
  4. 保存文件，修改即生效。
方法 3：使用 .editorconfig 文件
  1. 在项目根目录创建一个 .editorconfig 文件，内容如下：
   [*]
   end_of_line = lf

这将强制所有文件使用 LF（Unix 风格的换行符）。

方法 4：使用其他编辑器
  • Sublime Text：从 View > Line Endings 中选择 Unix（LF）并保存。
  • Notepad++：选择 Edit > EOL Conversion > Unix (LF)。

通过上述方法，您可以轻松地解决换行符问题，确保在 WSL 或其他 Linux 环境下使用适当的 Unix 风格换行符。

整理md文件

格式整理与FAQ增加

重新整理文件

我正在重新整理Lumi_ONE部署指南的md文件，包括修复语言和格式问题，补充缺失的内容，并且增加几个常见问题的解答。这推动了整个文档的结构和清晰度。

创建Lumi_ONE指南

总览部署步骤

安排部署步骤已增加新FAQ条目：

3. 如何清理数据并重新部署？

如果您需要清理数据并重新部署 Lumi_ONE，请执行以下步骤：

  1. 在终端中运行以下命令：
   ./clear.sh

这将清理现有的部署数据，并准备系统进行重新部署。

  1. 然后，您可以按照原始的部署步骤重新执行部署脚本来重新部署系统。

更多常见问题请参考官方文档或联系我们的技术支持。

Request a free trial

Help enterprises quickly realize Agentic AI intelligence upgrade

申请免费试用

助力企业迅速实现 Agentic AI 智能升级

Request a free trial

Help enterprises quickly realize Agentic AI intelligence upgrade

申请免费试用

助力企业迅速实现 Agentic AI 智能升级