# XianYuAssistant **Repository Path**: LeftJson/xian-yu-assistant ## Basic Information - **Project Name**: XianYuAssistant - **Description**: 一个闲鱼小助手,最新代码进入主页Github地址⬇️ - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://github.com/IAMLZY2018/XianYuAssistant - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 15 - **Created**: 2026-05-15 - **Last Updated**: 2026-05-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 闲鱼自动化管理系统
![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg) ![Java](https://img.shields.io/badge/Java-21-orange.svg) ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.7-brightgreen.svg) ![Vue](https://img.shields.io/badge/Vue-3.5-green.svg) 一个功能强大的闲鱼店铺自动化管理工具，支持自动发货、自动回复、消息管理等功能。 [功能特性](#功能特性) • [部署方式](#部署方式) • [使用指南](#使用指南) • [技术栈](#技术栈) • [常见问题](#常见问题)
--- ## 📸 截图展示 ### 消息管理 查看聊天记录，支持快速回复和消息筛选：
消息管理

首页-数据面板

### 功能截图
连接管理 商品管理

连接管理   |   商品管理

消息快速回复 卡密仓库配置

消息快速回复   |   卡密仓库配置

自动发货配置 发货记录

自动发货配置   |   发货记录

自动回复 系统配置

自动回复   |   系统配置

--- ## 📋 功能特性 ### 🎯 核心功能 | 功能 | 说明 | |------|------| | 📊 **数据面板** | 实时统计账号、商品、订单、消息等核心数据 | | 👤 **闲鱼账号** | 多账号管理，支持扫码登录，统一管理Cookie和Token | | 🔗 **连接管理** | WebSocket连接管理，实时监听闲鱼消息，支持Token自动刷新 | | 📦 **商品管理** | 同步闲鱼商品，配置自动发货、自动回复等功能 | | 💬 **消息管理** | 查看聊天记录，支持快速回复、发送图片、消息筛选 | ### 🤖 自动化功能 | 功能 | 说明 | |------|------| | 🔑 **卡密仓库** | 管理虚拟商品卡密，支持批量导入、自动发货 | | 🤖 **自动发货** | 买家付款后自动发送发货信息，支持文本、链接、卡密等 | | 📋 **发货记录** | 查看自动发货历史记录，支持手动重发 | | 💭 **自动回复** | 智能匹配关键词自动回复，支持精确/模糊/正则匹配 | ### ⚙️ 系统功能 | 功能 | 说明 | |------|------| | 📜 **操作日志** | 详细记录所有操作，方便追踪和排查 | | ⚙️ **系统设置** | 配置AI模型、滑块验证、自定义参数等 | ### ✨ 高级特性 - 🔄 **Token自动刷新** - 智能维护登录状态，随机间隔避免检测 - 🔐 **滑块验证处理** - 智能检测验证需求，提供详细操作指引 - 🤖 **AI智能客服** - 集成通义千问大模型，智能回复买家问题 - 🧠 **RAG知识库** - 按商品维度构建向量知识库，提升AI回复准确性 - 🔌 **自定义发货API** - 支持外部系统对接发货流程 - 📱 **响应式设计** - 完美适配桌面、平板、手机三种设备模式 --- ## 🚀 部署方式 ### 方式一：Docker部署（推荐） #### 环境要求 - Docker 20.10+ #### 一键部署脚本 **Linux/Mac**: ```bash docker run -d \ --name xianyu-assistant \ -p 12400:12400 \ -v $(pwd)/data/dbdata:/app/dbdata \ -v $(pwd)/data/logs:/app/logs \ --restart unless-stopped \ iamlzy/xianyuassistant:latest ``` **Windows PowerShell**: ```powershell docker run -d ` --name xianyu-assistant ` -p 12400:12400 ` -v ${PWD}/data/dbdata:/app/dbdata ` -v ${PWD}/data/logs:/app/logs ` --restart unless-stopped ` iamlzy/xianyuassistant:latest ``` #### 自定义配置 通过环境变量自定义配置： ```bash docker run -d \ --name xianyu-assistant \ -p 12400:12400 \ -e JAVA_OPTS="-Xms256m -Xmx512m" \ -v /your/path/dbdata:/app/dbdata \ -v /your/path/logs:/app/logs \ --restart unless-stopped \ iamlzy/xianyuassistant:latest ``` **配置项说明**: | 参数 | 默认值 | 说明 | |------|--------|------| | `-p 12400:12400` | 12400:12400 | 端口映射（物理机端口:容器端口） | | `-v /app/dbdata` | - | 数据库数据目录（SQLite + 向量数据库） | | `-v /app/logs` | - | 应用日志目录 | | `-e JAVA_OPTS` | -Xms256m -Xmx512m | JVM内存参数 | | `-e SERVER_PORT` | 12400 | Spring Boot服务端口（容器内部） | > **数据目录说明**: > - `dbdata/xianyu_assistant.db` - SQLite数据库（账号、商品、订单、配置等） > - `dbdata/vectorstore.json` - 向量数据库（AI知识库向量数据） > - `logs/xianyu-assistant.log` - 应用运行日志 > ⚠️ **重要提示**: > - 容器内路径（`/app/dbdata` 和 `/app/logs`）不能修改 > - 物理机路径一旦设置不要随意更改，否则会导致数据丢失 > - 升级版本时请使用相同的物理机路径，确保数据正确迁移 #### 常用命令 ```bash # 启动服务 docker start xianyu-assistant # 停止服务 docker stop xianyu-assistant # 查看日志 docker logs -f xianyu-assistant # 重启服务 docker restart xianyu-assistant # 更新到最新版本 docker pull iamlzy/xianyuassistant:latest docker stop xianyu-assistant docker rm xianyu-assistant # 然后重新执行 docker run 命令 ``` #### 访问系统 部署成功后，在浏览器中访问：`http://localhost:12400` 或 `http://你的服务器IP:12400` --- ### 方式二：JAR包部署 #### 环境要求 - Java 21+ - SQLite 3.42.0+ #### 构建JAR包 ```bash # 克隆项目 git clone https://github.com/IAMLZY2018/XianYuAssistant.git cd XianYuAssistant # 构建前端 cd vue-code npm install npm run build # 构建后端 cd .. ./mvnw clean package -DskipTests ``` #### 启动服务 ```bash java -jar target/XianYuAssistant-1.1.0.jar ``` #### 自定义配置 ```bash java -Xms256m -Xmx512m -Dserver.port=12400 -jar target/XianYuAssistant-1.1.0.jar ``` #### 访问系统 部署成功后，在浏览器中访问：`http://localhost:12400` 或 `http://你的服务器IP:12400` --- ## 📖 使用指南 ### 快速上手 #### 1️⃣ 添加闲鱼账号 - 进入"闲鱼账号"页面 - 点击"扫码登录"按钮 - 使用闲鱼APP扫描二维码 - 等待登录成功 #### 2️⃣ 启动WebSocket连接 - 进入"连接管理"页面 - 选择要连接的账号 - 点击"启动连接"按钮 - 等待连接成功 > ⚠️ **注意**: 如果遇到滑块验证，请按照弹窗提示操作： > 1. 访问闲鱼IM页面完成验证 > 2. 点击"❓ 如何获取？"按钮查看教程 > 3. 手动更新Cookie和Token #### 3️⃣ 同步商品信息 - 进入"商品管理"页面 - 选择已连接的账号 - 点击"刷新商品"按钮 - 等待商品同步完成 #### 4️⃣ 配置自动化功能 - 在商品列表中找到目标商品 - 开启"自动发货"或"自动回复" - 配置发货内容或回复规则 - 保存配置，自动化开始工作 ### 功能说明 #### 自动发货 当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。 **配置步骤**: 1. 进入"自动发货"页面 2. 选择商品 3. 切换到"自动发货"标签页 4. 开启自动发货开关 5. 输入发货内容（支持文本、链接、卡密等） 6. 可选：开启"自动确认发货" 7. 保存配置 #### 自动回复 智能匹配买家消息中的关键词，自动发送预设的回复内容。 **配置步骤**: 1. 进入"自动回复"页面 2. 选择商品，点击"添加规则" 3. 设置关键词和回复内容 4. 选择匹配方式（精确/模糊/正则） 5. 保存规则 #### AI智能客服 集成通义千问大模型，通过RAG知识库实现智能回复。 **配置步骤**: 1. 在系统设置页面配置阿里云 API Key 2. 在AI对话页面上传商品知识库数据 3. 开启AI自动回复 #### Token刷新策略 系统采用随机间隔刷新策略，避免被检测为机器人： - **Cookie保活**: 每30分钟调用hasLogin接口 - **_m_h5_tk**: 1.5-2.5小时随机刷新 - **websocket_token**: 10-14小时随机刷新 - **账号间隔**: 2-5秒随机 --- ## 🛠️ 技术栈 ### 后端 | 技术 | 版本 | 用途 | |------|------|------| | Java | 21 | 编程语言 | | Spring Boot | 3.5.7 | 应用框架 | | MyBatis-Plus | 3.5.5 | ORM框架 | | SQLite | 3.42.0 | 嵌入式数据库 | | Java-WebSocket | 1.5.4 | WebSocket客户端 | | OkHttp | 4.12.0 | HTTP客户端 | | Gson | 2.10.1 | JSON处理 | | MessagePack | 0.9.8 | 消息解密 | | Playwright | 1.40.0 | 浏览器自动化(扫码登录) | | ZXing | 3.5.3 | 二维码生成 | | Spring AI | 1.1.4 | AI集成(通义千问+RAG) | ### 前端 | 技术 | 版本 | 用途 | |------|------|------| | Vue | 3.5 | 渐进式框架 | | TypeScript | 5.x | 类型安全 | | Element Plus | 2.11 | UI组件库 | | Vite | 7.x | 构建工具 | | Axios | 1.13 | HTTP客户端 | | Pinia | 3.0 | 状态管理 | | Vue Router | 4.6 | 路由管理 | ### 响应式设计 系统支持三种设备模式的自适应布局： | 设备模式 | 屏幕宽度 | 导航方式 | 特性 | |---------|---------|---------|------| | 桌面模式 | > 1024px | 固定侧边栏 | 完整功能展示，侧边栏常驻显示 | | 平板模式 | 768px - 1024px | 可折叠侧边栏 | 自动折叠侧边栏，点击按钮展开/收起 | | 手机模式 | < 768px | 抽屉式菜单 | 顶部导航栏 + 全屏抽屉菜单 | --- ## ❓ 常见问题 ### 1. WebSocket连接失败怎么办？ **解决方案**: 1. 检查Cookie是否有效 2. 尝试手动更新Token 3. 如果提示需要滑块验证，访问 https://www.goofish.com/im 完成验证后手动更新Cookie和Token ### 2. 如何获取Cookie和Token？ 点击连接管理页面中Cookie和Token区域的"❓ 如何获取？"按钮，查看详细的图文教程。 ### 3. 自动发货什么时候触发？ 当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。 ### 4. Token过期了怎么办？ 系统会自动刷新Token（1.5-2.5小时刷新一次），也可以在连接管理页面手动更新。 ### 5. 为什么不建议频繁启动/断开连接？ 频繁操作容易触发闲鱼的人机验证，导致账号暂时不可用。建议保持连接稳定。 ### 6. AI智能客服如何配置？ 1. 在系统设置页面配置阿里云 API Key 2. 在AI对话页面上传商品知识库数据 3. 系统将自动使用RAG检索相关知识并生成智能回复 ### 7. Docker部署数据存在哪里？ 默认存储在容器的 `/app/dbdata` 和 `/app/logs` 目录，通过数据卷映射到物理机。 **重要提示**: - ⚠️ 容器内路径（`/app/dbdata` 和 `/app/logs`）不能修改 - ⚠️ 物理机路径一旦设置不要随意更改，否则会导致数据丢失 - ⚠️ 升级版本时请使用相同的物理机路径，确保数据正确迁移 --- ## 📝 更新日志 ### v1.1.0 (2026-04-28) **🎉 新功能** - 商品详情异步同步，支持进度显示 - 固定资料功能，每次AI回复自动携带 - AI回答测试功能，与自动回复流程一致 - Cookie过期邮件通知 - 通知开关表格化展示 **🎨 UI优化** - 商品详情弹窗左右布局 - 同步按钮loading动画 - 回复延时配置一行显示 - 通知开关表格形式 --- ### v1.0.10 (2026-04-28) **🎨 UI优化** - 优化连接详情页按钮样式，符合iOS 18设计规范 - 按钮默认可见，使用浅灰背景色，无需悬停才显示 - 启动按钮：绿色 #34c759，断开按钮：红色 #ff3b30，扫码按钮：蓝色 #007aff - 统一圆角为8px，字重600，移除边框设计 - 优化hover效果，移除@media限制，所有设备均支持悬停反馈 **📱 手机端优化** - 修复连接详情页手机端按钮布局问题 - 按钮横向排列，均分宽度，自适应容器 - 精简手机端按钮文字：启动、断开、扫码、刷新 - 修复启动/断开连接按钮不可见问题，使用严格布尔值判断 - 手机端补充刷新按钮，与桌面端保持一致 - 隐藏滚动条但不影响滚动功能 - 优化按钮间距和padding，确保一行优雅显示 --- ## 🤝 贡献指南 感谢Python版本提供的参考： https://github.com/zhinianboke/xianyu-auto-reply 欢迎提交Issue和Pull Request！ **仓库地址**: - 🇨🇳 Gitee: https://gitee.com/lzy2018cn/xian-yu-assistant - 🌍 GitHub: https://github.com/IAMLZY2018/XianYuAssistant --- ## 📄 许可证 本项目采用 Apache License 2.0 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情 --- ## ⚠️ 免责声明 本项目仅供学习交流使用，请勿用于商业用途。使用本工具产生的任何后果由使用者自行承担。 --- ## 💬 交流群
微信交流群 微信好友

扫码加入微信交流群   |   群二维码失效可加好友拉进群

---
**如果这个项目对你有帮助，请给个 ⭐️ Star 支持一下！** Made with ❤️
## ⭐ Star History [![Star History Chart](https://api.star-history.com/svg?repos=IAMLZY2018/XianYuAssistant&type=Date)](https://star-history.com/#IAMLZY2018/XianYuAssistant)