闲鱼自动回复系统：闲鱼智能客服与商品自动发货工具

闲鱼自动回复系统是一个专为闲鱼平台设计的自动化客服与管理工具，基于Python和FastAPI开发，托管于GitHub。系统通过WebSocket实时连接闲鱼服务器，自动处理买家消息、发货和商品管理。支持多用户、多账号管理，提供关键词匹配、AI智能回复、自动发货等功能，适合需要高效管理闲鱼店铺的卖家。项目开源，仅限学习研究，严禁商业用途。

功能列表

• 多用户管理：支持用户注册登录，数据隔离，权限控制。
• 多账号支持：管理多个闲鱼账号，独立监控和批量操作。
• 智能回复：支持关键词匹配、商品专用回复、AI智能回复（需配置OpenAI API）。
• 自动发货：基于商品信息匹配规则，自动发送卡券或文本，支持延时发货。
• 商品管理：自动收集商品信息，支持多规格管理，批量编辑。
• 商品搜索：通过Playwright获取真实闲鱼商品数据，按“人想要”排序。
• 系统监控：提供实时日志、性能监控和服务健康检查。
• 数据管理：支持Excel格式关键词导入导出，自动备份数据。

使用帮助

安装流程

根据官方说明，系统支持三种部署方式：Docker一键部署、Docker Compose部署和本地部署。以下为详细步骤：

方式一：Docker一键部署（推荐新手）

1. 创建数据目录：

   mkdir -p xianyu-auto-reply
   

2. **启动容器**：
```bash
docker run -d -p 8080:8080 -v $PWD/xianyu-auto-reply/:/app/data/ --name xianyu-auto-reply --privileged=true registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0

3. 访问系统：打开浏览器，访问http://localhost:8080。
4. 故障排除：
   • 若遇到端口冲突，修改8080为其他端口。
   • 确保Docker Desktop运行，Linux系统下可能需用sudo。

方式二：Docker Compose部署（推荐）

1. 克隆项目：

   git clone https://github.com/zhinianboke/xianyu-auto-reply.git
   cd xianyu-auto-reply
   

2. 运行部署脚本：

   ./docker-deploy.sh
   

3. 访问系统：打开http://localhost:8080。
4. 故障排除：参考DOCKER_FIX.md，检查docker-compose.yml端口配置。

方式三：本地部署

1. 克隆项目：

   git clone https://github.com/zhinianboke/xianyu-auto-reply.git
   cd xianyu-auto-reply
   

2. 安装依赖：

   pip install -r requirements.txt
   

   确保Python 3.11+已安装。

3. 安装Playwright（商品搜索功能需要）：

   playwright install chromium
   

4. 启动系统：

   python Start.py
   

5. 访问系统：打开http://localhost:8080。

配置管理员密码

• 默认管理员账号：用户名admin，密码admin123。
• 修改密码：首次登录后在用户管理页面更改，建议立即修改以确保安全。
• 配置存储在global_config.yml，支持WebSocket、API、回复规则等设置。

功能操作流程

1. 用户注册与登录

• 操作步骤：
  1. 访问http://localhost:8080/register.html。
  2. 填写邮箱，完成验证码验证。
  3. 输入图形验证码，完成注册。
  4. 登录http://localhost:8080/login.html，使用注册的邮箱和密码。
• 安全特性：系统使用JWT认证，数据隔离，防止暴力破解。

2. 添加闲鱼账号

• 操作步骤：
  1. 登录后进入主界面，点击“添加新账号”。
  2. 输入闲鱼账号ID和Cookie值（可通过扫码登录获取）。
  3. 系统自动启动账号监控，显示连接状态。
• 批量操作：支持批量启动或停止多个账号任务。
• 注意：定期更新Cookie，避免失效。

3. 配置自动回复

• 关键词匹配：
  1. 进入“数据管理”页面，添加关键词和回复内容。
  2. 示例：关键词“价格”，回复“商品价格为XX元”。
  3. 支持商品专用关键词和全局通用关键词，优先级为专用>通用>AI回复。
• AI智能回复：
  1. 在设置页面输入OpenAI API密钥，选择模型（如GPT-3.5）。
  2. 配置提示词，启用AI回复。
  3. 系统根据上下文生成智能回复，支持动态变量（如用户名）。
• Excel导入导出：
  1. 下载系统提供的Excel模板。
  2. 填入关键词和回复，上传至“数据管理”页面。
  3. 系统验证数据格式，自动导入。

4. 设置自动发货

• 操作步骤：
  1. 进入“发货管理”页面，添加发货规则。
  2. 设置商品关键词和发货内容（文本或卡密文件）。
  3. 配置延时发货时间（0-3600秒）。
  4. 系统检测付款消息后自动匹配规则并发货。
• 多规格支持：自动匹配商品规格，失败时降级到普通卡券。
• 防重复机制：避免重复发货和确认。
• 发货统计：查看发货记录和统计数据。

5. 商品管理

• 操作步骤：
  1. 系统自动收集消息中的商品信息。
  2. 通过闲鱼API获取完整商品详情。
  3. 在“商品管理”页面编辑或批量管理商品。
• 多规格支持：管理不同规格的商品信息。
• 智能去重：避免重复存储商品数据。

6. 商品搜索

• 操作步骤：
  1. 登录后访问“商品搜索”页面。
  2. 输入关键词和页数，系统通过Playwright获取真实数据。
  3. 商品按“人想要”数量排序，支持查看详情。
• 前端分页：灵活显示多页商品数据。

7. 系统监控

• 实时日志：在“日志管理”页面查看操作日志。
• 性能监控：检查系统资源使用情况。
• 健康检查：确保服务正常运行。

注意事项

• 安全性：勿将Cookie或密码硬编码，建议使用.env文件存储。
• 合规性：遵守闲鱼平台规则，避免频繁操作导致账号限制。
• 日志管理：定期清理logs/目录下的日志文件，释放空间。
• 数据备份：系统自动备份数据至挂载目录，定期检查。

应用场景

1. 个人闲鱼卖家
   小型卖家可通过自动回复和发货功能，快速响应买家咨询，提升成交率。
2. 多账号运营者
   管理多个闲鱼账号的用户可统一监控消息和商品，简化操作流程。
3. 夜间客服需求
   系统支持24小时自动回复，适合夜间无法手动回复的卖家。
4. 批量商品管理
   销售多规格商品的卖家可通过商品管理和自动发货功能，高效处理订单。
5. 数据分析需求
   卖家可通过商品搜索和日志统计功能，分析市场需求和销售情况。

QA

1. 工具是否免费？
   项目开源，免费用于学习和研究，严禁商业用途。
2. 支持哪些AI模型？
   支持OpenAI的GPT-3.5、GPT-4及通义千问，需配置API密钥。
3. 如何避免账号被封？
   设置合理回复间隔，遵守闲鱼规则，定期更新Cookie。
4. 商品搜索功能是否需要额外配置？
   需要安装Playwright和Chromium，Docker部署已包含。
5. 如何查看系统日志？
   在“日志管理”页面查看实时日志，或检查logs/目录文件。