Nexent开发环境搭建

最近在尝试本地搭建nexent环境，也是遇到了非常多的问题，总结一下方便大家自己搭建开发环境：

开发指南简述命令：

开发环境搭建：

开发主要依赖python和nodejs。

python：

版本：

项目使用的 Python版本为： 3.10.x

python官方下载地址：https://www.python.org/downloads/windows/

我之前使用了3.13版本过高可能会报这种找不到配套包的错误。

python 环境变量配置：

打开环境变量-Path-添加python配置：

修改pip下载源：

由于国内网络受限，从官方源下载可能存在网络问题，一般将下载源切换为国内的镜像。

打开%AppData%\pip (如果不存在自己新建文件夹即可)

新建pip.ini文件，输入如下配置切换至清华源(如果还是有网络问题可以尝试切换阿里，南京大学，豆瓣等镜像,总有能用的)：

global

index-url = https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

打开cmd，输入命令：pip install uv

安装uv

修改uv下载源：

安装uv完成后，打开%AppData%\uv (如果不存在自己新建文件夹即可)

新建文件 uv.toml，输入如下配置切换至清华源(如果还是有网络问题可以尝试切换阿里，南京大学，豆瓣等镜像,总有能用的)：

python-install-mirror = "https://pypi.tuna.tsinghua.edu.cn/simple/"

输入命令：uv sync && uv pip install -e ../sdk 下载后端依赖

下载其他依赖

按文档依次执行如下命令运行后端服务，此时会报缺少一些依赖的错误：

形如：No module named 'xxx'

如果缺少的是常见的工具包，可自行使用pip下载缺少的包

pip install 'xxx'

python backend/data_process_service.py # 数据处理服务

python backend/main_service.py # 主服务

python backend/nexent_mcp_service.py # MCP 服务

下载sdk依赖

缺少nexent的包时会报这个异常：

此时可切换到sdk目录执行pip install命令：

cd sdk

pip install .

环境变量缺失：

所有依赖包下载完成后运行mcp server就没有问题了。运行其他两个服务可能会遇到环境变量缺失的问题，可尝试将docker中的环境变量复制到启动路径下的 .env文件中。

这个问题预计下周会优化，在此也不展开了。

node

版本：

node我个人建议使用nvm管理,可以参考此文档下载备份(官方地址可能存在网络问题)：

https://blog.csdn.net/zgphacker2010/article/details/139558876

我用的是22.16.0

指定npm镜像源：

打开cmd执行命令，选用淘宝的npm镜像：

npm config set registry https://registry.npmmirror.com

进入front工程目录执行命令：

cd frontend

npm install

npm run dev

Failed to load SWC binary for win32/64

npm run dev 时如果遇到此问题，可参考此文档解决：https://cloud.tencent.com/developer/article/2428871