查看聊天记录，支持快速回复和消息筛选：

消息管理 - 聊天记录查看与快速回复

配置商品自动发货规则，支持自动确认收货：

自动发货 - 配置发货内容与规则

管理多个闲鱼账号，支持扫码登录：

账号管理 - 多账号统一管理

同步和管理闲鱼商品，配置自动化功能：

商品管理 - 商品列表与配置

• 🔐 多账号管理 - 支持同时管理多个闲鱼账号，轻松切换
• 🔗 WebSocket连接 - 实时监听闲鱼消息，及时响应买家
• 🚀 自动发货 - 买家付款后自动发送发货信息，节省时间
• 💬 自动回复 - 智能匹配关键词，自动回复买家消息
• 📦 商品管理 - 同步商品信息，统一管理在售商品
• 📋 订单管理 - 查看订单列表，支持一键确认收货
• 💌 消息管理 - 查看聊天记录，支持快速回复

• 🔄 Token自动刷新 - 智能维护登录状态，随机间隔避免检测
• 📊 数据统计 - 实时查看账号、商品、订单等数据统计
• 📜 操作日志 - 详细记录所有操作，方便追踪和排查
• 🎯 消息过滤 - 支持按商品、账号筛选消息
• 🔐 滑块验证处理 - 智能检测验证需求，提供详细操作指引

适合快速体验和生产环境使用，无需安装开发环境。

• Java: 21 或更高版本

1. 下载JAR包

   前往 Releases 页面下载最新版本的 xianyu-assistant.jar

2. 启动应用

   java -jar xianyu-assistant.jar

3. 访问应用

   打开浏览器访问: http://localhost:12400

Windows:

start /b java -jar xianyu-assistant.jar

Linux/Mac:

nohup java -jar xianyu-assistant.jar &

适合容器化部署和服务器环境，自动完成所有构建步骤。

• Docker: 20.10+
• Docker Compose: 2.0+ (可选)

1. 克隆项目

   # Gitee (国内推荐)
   git clone https://gitee.com/lzy2018cn/xian-yu-assistant.git
   
   # 或 GitHub
   git clone https://github.com/IAMLZY2018/-XianYuAssistant.git
   
   cd xian-yu-assistant

2. 启动服务

   docker-compose up -d

3. 查看日志

   docker-compose logs -f

4. 访问应用

   打开浏览器访问: http://localhost:12400

1. SSH连接到服务器

   ssh username@your-server-ip

2. 安装Docker（如未安装）

   curl -fsSL https://get.docker.com | sh
   sudo systemctl start docker
   sudo systemctl enable docker

3. 克隆并启动

   cd /opt
   
   # Gitee (国内推荐)
   git clone https://gitee.com/lzy2018cn/xian-yu-assistant.git
   
   # 或 GitHub
   git clone https://github.com/IAMLZY2018/-XianYuAssistant.git
   
   cd xian-yu-assistant
   docker compose up -d

4. 访问应用

   打开浏览器访问: http://your-server-ip:12400

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

# 更新服务
git pull
docker-compose up -d --build

• 完整Docker部署指南 - 详细的Docker配置和故障排查
• 服务器部署指南 - 生产环境部署、Nginx配置、HTTPS等

• 进入"闲鱼账号"页面
• 点击"扫码登录"按钮
• 使用闲鱼APP扫描二维码
• 等待登录成功

• 进入"连接管理"页面
• 选择要连接的账号
• 点击"启动连接"按钮
• 等待连接成功

⚠️ 注意: 如果遇到滑块验证，请按照弹窗提示操作：

1. 访问闲鱼IM页面完成验证
2. 点击"❓ 如何获取？"按钮查看教程
3. 手动更新Cookie和Token

• 进入"商品管理"页面
• 选择已连接的账号
• 点击"刷新商品"按钮
• 等待商品同步完成

• 在商品列表中找到目标商品
• 开启"自动发货"或"自动回复"
• 配置发货内容或回复规则
• 保存配置，自动化开始工作

当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。

配置步骤:

1. 进入"自动发货"页面
2. 选择商品，点击"配置"
3. 输入发货内容（支持文本）
4. 可选：开启"自动确认收货"
5. 保存配置

智能匹配买家消息中的关键词，自动发送预设的回复内容。

配置步骤:

1. 进入"自动回复"页面
2. 选择商品，点击"添加规则"
3. 设置关键词和回复内容
4. 选择匹配方式（精确/模糊）
5. 保存规则

系统采用随机间隔刷新策略，避免被检测为机器人：

• _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 - 嵌入式数据库
• WebSocket - 实时通信
• OkHttp - HTTP客户端
• Lombok - 简化代码

• Vue 3.5 - 渐进式框架
• TypeScript 5.x - 类型安全
• Element Plus - UI组件库
• Vite 7.x - 构建工具
• Axios - HTTP客户端
• Pinia - 状态管理

xianyu-assistant/
├── src/main/java/                    # Java源代码
│   └── com/feijimiao/xianyuassistant/
│       ├── controller/                # 控制器层
│       ├── service/                   # 服务层
│       ├── mapper/                    # 数据访问层
│       ├── entity/                    # 实体类
│       ├── websocket/                 # WebSocket处理
│       ├── event/                     # 事件监听
│       └── exception/                 # 异常处理
├── src/main/resources/
│   ├── static/                        # 前端构建产物
│   └── application.yml                # 配置文件
├── vue-code/                          # 前端源代码
│   ├── src/
│   │   ├── views/                     # 页面组件
│   │   ├── components/                # 公共组件
│   │   ├── api/                       # API接口
│   │   ├── utils/                     # 工具函数
│   │   └── types/                     # 类型定义
│   └── public/                        # 静态资源
├── dbdata/                            # 数据库文件
└── logs/                              # 日志文件

如果你想从源码构建项目（开发者模式）：

• Java: 21 或更高版本
• Node.js: 20.19.0 或更高版本
• Maven: 3.6+ (可选，项目包含 Maven Wrapper)

1. 克隆项目

   # Gitee (国内推荐)
   git clone https://gitee.com/lzy2018cn/xian-yu-assistant.git
   
   # 或 GitHub
   git clone https://github.com/IAMLZY2018/-XianYuAssistant.git
   
   cd xian-yu-assistant

2. 构建前端

   cd vue-code
   npm install
   npm run build
   cd ..

3. 启动后端

   # Windows
   mvnw.cmd spring-boot:run
   
   # Linux/Mac
   ./mvnw spring-boot:run

4. 访问应用

   打开浏览器访问: http://localhost:12400

cd vue-code
npm install
npm run dev

访问: http://localhost:5173

# 构建前端
cd vue-code
npm run build

# 构建后端JAR包
cd ..
mvn clean package

生成的JAR包位于: target/xianyu-assistant.jar

解决方案:

1. 检查Cookie是否有效
2. 尝试手动更新Token
3. 如果提示需要滑块验证，访问 https://www.goofish.com/im 完成验证后手动更新Cookie和Token

点击连接管理页面中Cookie和Token区域的"❓ 如何获取？"按钮，查看详细的图文教程。

当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。

系统会自动刷新Token（1.5-2.5小时刷新一次），也可以在连接管理页面手动更新。

频繁操作容易触发闲鱼的人机验证，导致账号暂时不可用。建议保持连接稳定。

感谢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

贡献步骤:

1. Fork本项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交Pull Request

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

本项目仅供学习交流使用，请勿用于商业用途。使用本工具产生的任何后果由使用者自行承担。

如有问题或建议，欢迎通过以下方式联系：

• 提交 Issue
• 联系作者: https://www.feijimiao.cn/contact