闲鱼自动化管理系统

📸 截图展示

消息管理

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

首页-数据面板

功能截图

连接管理   |   商品管理

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

自动发货配置   |   发货记录

自动回复   |   系统配置

📋 功能特性

🎯 核心功能

🤖 自动化功能

⚙️ 系统功能

✨ 高级特性

• 🔄 Token自动刷新 - 智能维护登录状态，随机间隔避免检测
• 🔐 滑块验证处理 - 智能检测验证需求，提供详细操作指引
• 🤖 AI智能客服 - 集成通义千问大模型，智能回复买家问题
• 🧠 RAG知识库 - 按商品维度构建向量知识库，提升AI回复准确性
• 🔌 自定义发货API - 支持外部系统对接发货流程
• 📱 响应式设计 - 完美适配桌面、平板、手机三种设备模式

🚀 部署方式

方式一：Docker部署（推荐）

环境要求

• Docker 20.10+

一键部署脚本

Linux/Mac:

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:

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

自定义配置

通过环境变量自定义配置：

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

配置项说明:

数据目录说明: - dbdata/xianyu_assistant.db - SQLite数据库（账号、商品、订单、配置等） - dbdata/vectorstore.json - 向量数据库（AI知识库向量数据） - logs/xianyu-assistant.log - 应用运行日志

⚠️ 重要提示: - 容器内路径（/app/dbdata 和 /app/logs）不能修改 - 物理机路径一旦设置不要随意更改，否则会导致数据丢失 - 升级版本时请使用相同的物理机路径，确保数据正确迁移

常用命令

# 启动服务
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包

# 克隆项目
git clone https://github.com/IAMLZY2018/XianYuAssistant.git
cd XianYuAssistant

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

# 构建后端
cd ..
./mvnw clean package -DskipTests

启动服务

java -jar target/XianYuAssistant-1.1.0.jar

自定义配置

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秒随机

🛠️ 技术栈

后端

前端

响应式设计

系统支持三种设备模式的自适应布局：

❓ 常见问题

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 文件了解详情

⚠️ 免责声明

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

💬 交流群

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

⭐ Star History