闲鱼客服机器人部署教程

下载Xianyu AutoAgent

Xianyu AutoAgent – 智能闲鱼客服机器人系统

专为闲鱼平台打造的AI值守解决方案，实现闲鱼平台7×24小时自动化值守，支持多专家协同决策、智能议价和上下文感知对话。

项目地址：https://github.com/shaxiu/XianyuAutoAgent

1. 环境准备

Python 3.8+
NodeJS 18+

请确保当前电脑中的环境是否满足上述要求（按照步骤查看本地版本，判断是否满足），如满足则跳转到2.项目部署步骤

否则请按照下面步骤安装环境

1.1 Python 环境安装

访问 Python 官网 https://www.python.org/downloads/
下载 Python 3.8 或更高版本（推荐 Python 3.8+）
1. Windows用户：https://www.python.org/ftp/python/3.9.10/python-3.9.10-amd64.exe
2. Mac用户：https://www.python.org/ftp/python/3.9.11/python-3.9.11-macos11.pkg
按照提示一路下一步运行安装程序，重要：如果有 “Add Python to PATH” 选项请勾选
完成安装后，打开命令提示符（windows为CMD，mac为终端），输入以下命令验证安装：

python --version
pip --version

注意：有可能存在当前电脑上已经有低版本的python，因此当输入python –version 时显示版本不为 python 3.x时，请输入python3 –version查看，如输出为python 3.x，则后续命令都采用 python3 xxxx，pip3 xxxx执行

1.2 Node.js 环境安装

访问 Node.js 官网 https://nodejs.org/
下载并安装 LTS（长期支持）版本：https://nodejs.org/zh-cn，下载后一路下一步，安装

完成安装后，打开命令提示符（windows为CMD，mac为终端），输入以下命令验证安装（有版本输出即可）：

node --version
npm --version

2. 项目部署步骤

2.1下载项目

2.1.1 方法一：github拉取项目（项目更新后会上传到github上）

浏览器打开项目地址
点击Code，点击Download ZIP 下载项目代码

解压项目
在终端中打开项目（windows直接右键）

  mac：在终端中打开文件夹教程：https://zhuanlan.zhihu.com/p/700711063

  方法一：

  windows右键，在终端中打开

方法二：

文件浏览器进入对应项目目录，路径栏输入 cmd 然后回车

2.1.2 方法二：网盘下载（每次项目更新，我会同步更新网盘内容）

https://www.alipan.com/s/sLS6zDkSN4x

提取码: 1c93

2.2 Python 依赖安装

在项目根目录下，打开命令提示符（windows为CMD，mac为终端）

项目目录下打开终端方式

2.直接安装项目依赖：

pip install -r requirements.txt

如安装显示网络错误等，请关闭梯子，通过python镜像安装

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

ps：前面说过如果 python3 –version输出的是python3.x，则pip3 install -r requirements.txt

2.3 项目环境变量配置

重命名已有的 .env.example 文件为.env，网盘上下载的不用重命名
使用记事本或其他文本编辑器打开 .env 文件，添加或修改以下内容：
1. ps:如果使用通义千问，则只需要修改API_KEY 和 COOKIES_STR

API_KEY=默认使用通义千问,apikey通过百炼模型平台获取
COOKIES_STR=你的闲鱼Cookie
MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
MODEL_NAME=qwen-max

环境变量说明：
1. API_KEY: 必须配置，项目默认使用通义千问
2. COOKIES_STR: 必须配置，闲鱼网页版的Cookie字符串，用于API调用鉴权
3. MODEL_BASE_URL:模型调用地址，默认使用通义千问
4. MODEL_NAME：模型名称，默认使用 qwen-max
获取API密钥的方式：
1. 阿里云通义千问API（默认）：访问 https://bailian.console.aliyun.com/?tab=model#/api-key 注册并获取

如需使用其他兼容OpenAI接口的模型：
- OpenAI API密钥：访问 https://platform.openai.com/ 注册并获取
- DeepSeek API密钥：访问 https://platform.deepseek.com/api_keys 注册并获取

获取闲鱼Cookie的方法：
1. 使用Chrome浏览器访问闲鱼网页版 https://www.goofish.com/
2. 登录你的闲鱼账号
3. 按F12打开开发者工具，切换到”网络/Network”标签页，选择Fetch/XHR

刷新页面，找到任意一个请求
在请求头中找到”Cookie”字段，复制其完整内容作为COOKIES_STR的值

最终.env文件，显示内容应该类似如下

2.4 提示词模板配置

项目使用4个提示词模板文件来指导AI回复不同类型的问题。这些文件位于 prompts 目录下：
1. classify_prompt.txt – 分类提示词，用于识别用户意图
2. price_prompt.txt – 价格相关提示词，用于回答价格问题
3. tech_prompt.txt – 技术相关提示词，用于回答技术问题
4. default_prompt.txt – 默认提示词，用于回答其他类型问题

第一次运行前，需要将示例提示词文件重命名为正式文件，网盘下载默认已修改：

直接重命名xxx_prompt_example.txt为xxx_prompt.txt

也可以通过执行下面的命令

cd prompts
copy classify_prompt_example.txt classify_prompt.txt
copy price_prompt_example.txt price_prompt.txt  
copy tech_prompt_example.txt tech_prompt.txt
copy default_prompt_example.txt default_prompt.txt

您可以根据需要修改这些提示词文件，调整AI的回复风格和策略

3. 运行项目

3.1 启动服务

确保所有依赖都已正确安装
在项目根目录下运行 main.py 文件：

python main.py

Windows也可以直接双击main.py运行

ps：如果 python3 –version输出的是python3.x，则python3 main.py

3.2 验证运行

检查控制台输出，确保没有错误信息
登录别的账号咨询机器人账号商品信息，查看是否正常回复

4. 常见问题解决

4.1 Python 相关

如果遇到 pip 安装包失败，可以尝试使用国内镜像源：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4.2 项目相关

Cookie存在有效期，因此可能需要每两三天重新更新一下cookie，cookie过期后控制台的日志会输出error告诉你是什么问题

5. 注意事项

确保所有环境变量都已正确配置
保持网络连接稳定(开启VPN可能导致项目运行错误)

6. 其他问题

如果遇到问题可以直接在群里面问，但请确保这些问题在文档中没有体现