查看聊天记录，支持快速回复和消息筛选：
首页-数据面板
连接管理 | 商品管理
消息快速回复 | 卡密仓库配置
自动发货配置 | 发货记录
自动回复 | 系统配置
| 功能 | 说明 |
|---|---|
| 📊 数据面板 | 实时统计账号、商品、订单、消息等核心数据 |
| 👤 闲鱼账号 | 多账号管理，支持扫码登录，统一管理Cookie和Token |
| 🔗 连接管理 | WebSocket连接管理，实时监听闲鱼消息，支持Token自动刷新 |
| 📦 商品管理 | 同步闲鱼商品，配置自动发货、自动回复等功能 |
| 💬 消息管理 | 查看聊天记录，支持快速回复、发送图片、消息筛选 |
| 功能 | 说明 |
|---|---|
| 🔑 卡密仓库 | 管理虚拟商品卡密，支持批量导入、自动发货 |
| 🤖 自动发货 | 买家付款后自动发送发货信息，支持文本、链接、卡密等 |
| 📋 发货记录 | 查看自动发货历史记录，支持手动重发 |
| 💭 自动回复 | 智能匹配关键词自动回复，支持精确/模糊/正则匹配 |
| 功能 | 说明 |
|---|---|
| 📜 操作日志 | 详细记录所有操作，方便追踪和排查 |
| ⚙️ 系统设置 | 配置AI模型、滑块验证、自定义参数等 |
- 🔄 Token自动刷新 - 智能维护登录状态，随机间隔避免检测
- 🔐 滑块验证处理 - 智能检测验证需求，提供详细操作指引
- 🤖 AI智能客服 - 集成通义千问大模型，智能回复买家问题
- 🧠 RAG知识库 - 按商品维度构建向量知识库，提升AI回复准确性
- 🔌 自定义发货API - 支持外部系统对接发货流程
- 📱 响应式设计 - 完美适配桌面、平板、手机三种设备模式
- 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:latestWindows 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配置项说明:
| 参数 | 默认值 | 说明 |
|---|---|---|
-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）不能修改- 物理机路径一旦设置不要随意更改，否则会导致数据丢失
- 升级版本时请使用相同的物理机路径，确保数据正确迁移
# 启动服务
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
- Java 21+
- SQLite 3.42.0+
# 克隆项目
git clone https://github.com/IAMLZY2018/XianYuAssistant.git
cd XianYuAssistant
# 构建前端
cd vue-code
npm install
npm run build
# 构建后端
cd ..
./mvnw clean package -DskipTestsjava -jar target/XianYuAssistant-1.1.0.jarjava -Xms256m -Xmx512m -Dserver.port=12400 -jar target/XianYuAssistant-1.1.0.jar部署成功后，在浏览器中访问：http://localhost:12400 或 http://你的服务器IP:12400
- 进入"闲鱼账号"页面
- 点击"扫码登录"按钮
- 使用闲鱼APP扫描二维码
- 等待登录成功
- 进入"连接管理"页面
- 选择要连接的账号
- 点击"启动连接"按钮
- 等待连接成功
⚠️ 注意: 如果遇到滑块验证，请按照弹窗提示操作：
- 访问闲鱼IM页面完成验证
- 点击"❓ 如何获取？"按钮查看教程
- 手动更新Cookie和Token
- 进入"商品管理"页面
- 选择已连接的账号
- 点击"刷新商品"按钮
- 等待商品同步完成
- 在商品列表中找到目标商品
- 开启"自动发货"或"自动回复"
- 配置发货内容或回复规则
- 保存配置，自动化开始工作
当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。
配置步骤:
- 进入"自动发货"页面
- 选择商品
- 切换到"自动发货"标签页
- 开启自动发货开关
- 输入发货内容（支持文本、链接、卡密等）
- 可选：开启"自动确认发货"
- 保存配置
智能匹配买家消息中的关键词，自动发送预设的回复内容。
配置步骤:
- 进入"自动回复"页面
- 选择商品，点击"添加规则"
- 设置关键词和回复内容
- 选择匹配方式（精确/模糊/正则）
- 保存规则
集成通义千问大模型，通过RAG知识库实现智能回复。
配置步骤:
- 在系统设置页面配置阿里云 API Key
- 在AI对话页面上传商品知识库数据
- 开启AI自动回复
系统采用随机间隔刷新策略，避免被检测为机器人：
- 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 | 抽屉式菜单 | 顶部导航栏 + 全屏抽屉菜单 |
解决方案:
- 检查Cookie是否有效
- 尝试手动更新Token
- 如果提示需要滑块验证，访问 https://www.goofish.com/im 完成验证后手动更新Cookie和Token
点击连接管理页面中Cookie和Token区域的"❓ 如何获取？"按钮，查看详细的图文教程。
当买家付款后，系统会自动检测到"已付款待发货"消息，并根据配置自动发送发货信息。
系统会自动刷新Token（1.5-2.5小时刷新一次），也可以在连接管理页面手动更新。
频繁操作容易触发闲鱼的人机验证，导致账号暂时不可用。建议保持连接稳定。
- 在系统设置页面配置阿里云 API Key
- 在AI对话页面上传商品知识库数据
- 系统将自动使用RAG检索相关知识并生成智能回复
默认存储在容器的 /app/dbdata 和 /app/logs 目录，通过数据卷映射到物理机。
重要提示:
⚠️ 容器内路径（/app/dbdata和/app/logs）不能修改⚠️ 物理机路径一旦设置不要随意更改，否则会导致数据丢失⚠️ 升级版本时请使用相同的物理机路径，确保数据正确迁移
🎉 新功能
- 商品详情异步同步，支持进度显示
- 固定资料功能，每次AI回复自动携带
- AI回答测试功能，与自动回复流程一致
- Cookie过期邮件通知
- 通知开关表格化展示
🎨 UI优化
- 商品详情弹窗左右布局
- 同步按钮loading动画
- 回复延时配置一行显示
- 通知开关表格形式
🎨 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 支持一下！
Made with ❤️