# 🐟 闲鱼自动回复系统 [![GitHub](https://img.shields.io/badge/GitHub-zhinianboke%2Fxianyu--auto--reply-blue?logo=github)](https://github.com/zhinianboke/xianyu-auto-reply) [![Docker](https://img.shields.io/badge/Docker-一键部署-blue?logo=docker)](https://github.com/zhinianboke/xianyu-auto-reply#-快速开始) 一个功能完整的闲鱼自动回复和管理系统，支持多用户、多账号管理，具备智能回复、自动发货、商品管理等企业级功能。 ## ✨ 核心特性 ### 🔐 多用户系统 - **用户注册登录** - 支持邮箱验证码注册，图形验证码保护 - **数据完全隔离** - 每个用户的数据独立存储，互不干扰 - **权限管理** - 严格的用户权限控制和JWT认证 - **安全保护** - 防暴力破解、会话管理、安全日志 ### 📱 多账号管理 - **无限账号支持** - 每个用户可管理多个闲鱼账号 - **独立运行** - 每个账号独立监控，互不影响 - **实时状态** - 账号连接状态实时监控 - **批量操作** - 支持批量启动、停止账号任务 ### 🤖 智能回复系统 - **关键词匹配** - 支持精确关键词匹配回复 - **AI智能回复** - 集成OpenAI API，支持上下文理解 - **变量替换** - 回复内容支持动态变量（用户名、商品信息等） - **优先级策略** - 关键词回复优先，AI回复兜底 ### 🚚 自动发货功能 - **智能匹配** - 基于商品信息自动匹配发货规则 - **多种触发** - 支持付款消息、小刀消息等多种触发条件 - **防重复发货** - 智能防重复机制，避免重复发货 - **卡密发货** - 支持文本内容和卡密文件发货 ### 🛍️ 商品管理 - **自动收集** - 消息触发时自动收集商品信息 - **API获取** - 通过闲鱼API获取完整商品详情 - **批量管理** - 支持批量查看、编辑商品信息 - **智能去重** - 自动去重，避免重复存储 ### � 商品搜索功能 - **真实数据获取** - 基于Playwright技术获取真实闲鱼商品数据 - **智能排序** - 按"人想要"数量自动倒序排列 - **多页搜索** - 支持一次性获取多页商品数据 - **前端分页** - 灵活的前端分页显示 - **商品详情** - 支持查看完整商品详情信息 ### �📊 系统监控 - **实时日志** - 完整的操作日志记录和查看 - **性能监控** - 系统资源使用情况监控 - **健康检查** - 服务状态健康检查 - **数据备份** - 自动数据备份和恢复 ## 🚀 快速开始 ### 方式一：Docker 一键部署（最简单） ```bash # 创建数据目录 mkdir -p xianyu-auto-reply # 一键启动容器 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 # 访问系统 # http://localhost:8080 ``` ### 方式二：Docker Compose 部署（推荐） ```bash # 1. 克隆项目 git clone https://github.com/zhinianboke/xianyu-auto-reply.git cd xianyu-auto-reply # 2. 一键部署 ./docker-deploy.sh # 3. 访问系统 # http://localhost:8080 ``` ### 方式三：本地部署 ```bash # 1. 克隆项目 git clone https://github.com/zhinianboke/xianyu-auto-reply.git cd xianyu-auto-reply # 2. 安装依赖 pip install -r requirements.txt # 3. 安装Playwright浏览器（商品搜索功能需要） playwright install chromium # 4. 启动系统 python Start.py # 5. 访问系统 # http://localhost:8080 ``` ### 🐳 Docker 部署说明 #### 一键部署特点 - **无需配置** - 使用预构建镜像，开箱即用 - **数据持久化** - 自动挂载数据目录，数据不丢失 - **快速启动** - 30秒内完成部署 - **生产就绪** - 包含所有依赖和优化配置 #### 容器管理命令 ```bash # 查看容器状态 docker ps # 查看容器日志 docker logs -f xianyu-auto-reply # 停止容器 docker stop xianyu-auto-reply # 重启容器 docker restart xianyu-auto-reply # 删除容器 docker rm -f xianyu-auto-reply ``` ## 📋 系统使用 ### 1. 用户注册 - 访问 `http://localhost:8080/register.html` - 填写用户信息，完成邮箱验证 - 输入图形验证码完成注册 ### 2. 添加闲鱼账号 - 登录系统后进入主界面 - 点击"添加新账号" - 输入账号ID和完整的Cookie值 - 系统自动启动账号监控任务 ### 3. 配置自动回复 - **关键词回复**：设置关键词和对应回复内容 - **AI回复**：配置OpenAI API密钥启用智能回复 - **默认回复**：设置未匹配时的默认回复 ### 4. 设置自动发货 - 添加发货规则，设置商品关键词和发货内容 - 支持文本内容和卡密文件两种发货方式 - 系统检测到付款消息时自动发货 ### 5. 使用商品搜索功能 - 访问商品搜索页面（需要登录） - 输入搜索关键词和查询页数 - 系统自动获取真实闲鱼商品数据 - 商品按"人想要"数量自动排序 - 支持查看商品详情和跳转到闲鱼页面 ## 🏗️ 系统架构 ``` ┌─────────────────────────────────────┐ │ Web界面 (FastAPI) │ │ 用户管理 + 功能界面 │ └─────────────┬───────────────────────┘ │ ┌─────────────▼───────────────────────┐ │ CookieManager │ │ 多账号任务管理 │ └─────────────┬───────────────────────┘ │ ┌─────────────▼───────────────────────┐ │ XianyuLive (多实例) │ │ WebSocket连接 + 消息处理 │ └─────────────┬───────────────────────┘ │ ┌─────────────▼───────────────────────┐ │ SQLite数据库 │ │ 用户数据 + 商品信息 + 配置数据 │ └─────────────────────────────────────┘ ``` ## 📁 项目结构 ``` xianyu-auto-reply/ ├── Start.py # 主启动文件 ├── XianyuAutoAsync.py # 闲鱼WebSocket客户端核心 ├── reply_server.py # FastAPI Web服务器 ├── db_manager.py # 数据库管理模块 ├── cookie_manager.py # Cookie和任务管理 ├── ai_reply_engine.py # AI回复引擎 ├── config.py # 配置管理 ├── file_log_collector.py # 日志收集器 ├── global_config.yml # 全局配置文件 ├── requirements.txt # Python依赖 ├── docker-compose.yml # Docker编排配置 ├── Dockerfile # Docker镜像构建 ├── utils/ # 工具模块 │ ├── item_search.py # 商品搜索功能 │ └── ... # 其他工具模块 ├── static/ # 前端静态文件 │ ├── index.html # 主界面 │ ├── login.html # 登录页面 │ ├── register.html # 注册页面 │ ├── item_search.html # 商品搜索页面 │ ├── user_management.html # 用户管理页面 │ ├── data_management.html # 数据管理页面 │ ├── log_management.html # 日志管理页面 │ └── lib/ # 本地静态资源库 │ ├── bootstrap/ # Bootstrap框架 │ └── bootstrap-icons/ # Bootstrap图标 ├── logs/ # 日志文件目录 ├── data/ # 数据库文件目录 └── backups/ # 备份文件目录 ``` ## ⚙️ 配置说明 ### 管理员密码配置 **重要**：为了系统安全，强烈建议修改默认管理员密码！ #### 默认密码 - **用户名**：`admin` - **默认密码**：`admin123` - **初始化机制**：首次创建数据库时自动创建admin用户 #### 修改密码方式 **方式一：Web界面修改（推荐）** 1. 使用默认密码登录系统 2. 进入系统设置页面 3. 在"修改密码"区域输入当前密码和新密码 4. 点击"修改密码"按钮完成修改 **密码管理机制**： - 数据库初始化时创建admin用户，密码为 `admin123` - 重启时如果用户表已存在，不重新初始化 - 所有用户（包括admin）统一使用用户表验证 - 密码修改后立即生效，无需重启 ### 全局配置文件 `global_config.yml` 包含详细的系统配置，支持： - WebSocket连接参数 - API接口配置 - 自动回复设置 - 商品管理配置 - 日志配置等 ## 🔧 高级功能 ### AI回复配置 1. 在用户设置中配置OpenAI API密钥 2. 选择AI模型（支持GPT-3.5、GPT-4、通义千问等） 3. 设置回复策略和提示词 4. 启用AI回复功能 ### 自动发货规则 1. 进入发货管理页面 2. 添加发货规则，设置商品关键词 3. 上传卡密文件或输入发货内容 4. 系统自动匹配商品并发货 ### 商品信息管理 1. 系统自动收集消息中的商品信息 2. 通过API获取完整商品详情 3. 支持手动编辑商品信息 4. 为自动发货提供准确的商品数据 ## 📊 监控和维护 ### 日志管理 - **实时日志**：Web界面查看实时系统日志 - **日志文件**：`logs/` 目录下的按日期分割的日志文件 - **日志级别**：支持DEBUG、INFO、WARNING、ERROR级别 ### 数据备份 ```bash # 手动备份 ./docker-deploy.sh backup # 查看备份 ls backups/ ``` ### 健康检查 ```bash # 检查服务状态 curl http://localhost:8080/health # 查看系统状态 ./docker-deploy.sh status ``` ## 🔒 安全特性 - **JWT认证**：安全的用户认证机制 - **图形验证码**：防止自动化攻击 - **邮箱验证**：确保用户邮箱真实性 - **数据隔离**：用户数据完全隔离 - **会话管理**：安全的会话超时机制 - **操作日志**：完整的用户操作记录 ## 🤝 贡献指南 欢迎为项目做出贡献！您可以通过以下方式参与： ### 📝 提交问题 - 在 [GitHub Issues](https://github.com/zhinianboke/xianyu-auto-reply/issues) 中报告Bug - 提出新功能建议和改进意见 - 分享使用经验和最佳实践 ### 🔧 代码贡献 - Fork 项目到您的GitHub账号 - 创建功能分支：`git checkout -b feature/your-feature` - 提交更改：`git commit -am 'Add some feature'` - 推送分支：`git push origin feature/your-feature` - 提交 Pull Request ### 📖 文档贡献 - 改进现有文档 - 添加使用示例 - 翻译文档到其他语言 ## 📞 技术支持 ### 🔧 故障排除 #### 常见问题解决 **1. 商品搜索功能报错（Playwright浏览器问题）** ```bash # 错误信息：Executable doesn't exist at /root/.cache/ms-playwright/chromium... # 解决方案：重新构建镜像（推荐） docker-compose down docker-compose build --no-cache docker-compose up -d # 或者手动修复（临时方案） docker exec -it xianyu-auto-reply bash playwright install chromium exit docker restart xianyu-auto-reply ``` **2. 其他问题排查** 1. 查看日志：`docker-compose logs -f` 2. 检查状态：`./docker-deploy.sh status` 3. 健康检查：`curl http://localhost:8080/health` ### 💬 交流群组 欢迎加入我们的技术交流群，获取实时帮助和最新更新： #### 微信交流群 微信群二维码 #### QQ交流群 QQ群二维码 ### 📧 联系方式 - **技术支持**：遇到问题可在群内咨询 - **功能建议**：欢迎提出改进建议 - **Bug反馈**：发现问题请及时反馈 --- 🎉 **开始使用闲鱼自动回复系统，让您的闲鱼店铺管理更加智能高效！**