# xianyu-butler-plus

**Repository Path**: zhang-gongming/xianyu-butler-plus

## Basic Information

- **Project Name**: xianyu-butler-plus
- **Description**: 咸鱼自动发货（plus升级版）
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 4
- **Created**: 2026-01-25
- **Last Updated**: 2026-03-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🐟 闲鱼超级管家

<div align="center">

**现代化的闲鱼自动回复与管理平台 - 商务专业风格 UI**

[![GitHub](https://img.shields.io/badge/GitHub-23Star%2Fxianyu--super--butler-blue?logo=github)](https://github.com/23Star/xianyu-super-butler)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)
[![React](https://img.shields.io/badge/React-18-blue.svg)](https://reactjs.org/)

基于 [zhinianboke/xianyu-auto-reply](https://github.com/zhinianboke/xianyu-auto-reply) 二次开发 · 全新 UI · 持续更新

</div>

---

## 📸 界面预览

### 工作台 Dashboard

![Dashboard 界面](static/uploads/images/1.png)

### 订单管理 Orders

![订单管理](static/uploads/images/2.png)

---

## 📖 简介

闲鱼超级管家是在 [xianyu-auto-reply](https://github.com/zhinianboke/xianyu-auto-reply) 基础上的二次开发版本，采用商务专业风格的全新 UI 设计，让闲鱼店铺管理更加高效便捷。

---

## ⭐ 核心功能

### 智能回复
- 🤖 关键词匹配回复
- 🧠 AI 智能议价（支持自定义折扣规则）
- 📝 默认回复配置
- 🛍️ 商品专属回复

### 自动发货
- 🚚 支持多规格商品
- ⏰ 延时发货设置
- 🎫 卡券管理
- 📋 发货规则配置

### 订单管理
- 📦 订单列表查看
- 🔄 批量刷新（并发处理）
- 🔍 订单详情查看
- 📮 收货人信息管理
- ✅ 订单状态更新

### 账号管理
- 📱 多账号支持
- 🔐 扫码/密码登录
- 🍪 Cookie 手动输入
- ⚡ 账号启用/禁用
- 🤖 AI 议价配置

### 其他功能
- 📊 数据统计与趋势分析
- 📄 Excel 批量导入导出
- 🔍 商品搜索
- 👥 多用户权限管理
- ✨ 基本解决滑块验证失败问题，成功率 99%

---

## 🚀 使用方法

### 快速启动

```bash
# 1. 克隆项目
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler

# 2. 安装依赖
pip install -r requirements.txt

# 3. 构建前端
cd frontend
npm install
npm run build

# 4. 启动服务（返回项目根目录）
cd ..
python Start.py

# 5. 访问应用
# 浏览器打开 http://localhost:8080
```

**说明：**
- `npm run build` 会将前端打包到 `static/` 目录
- `Start.py` 启动后端服务（端口 8080），同时提供前端静态文件
- 前端已构建，无需单独运行前端开发服务器

### 前端开发模式

如需修改前端代码（支持热更新）：

```bash
# 终端1：启动后端
python Start.py

# 终端2：启动前端开发服务器
cd frontend
npm run dev

# 访问 http://localhost:3000
```

### 首次使用

1. **注册账号** - 访问 http://localhost:8080/register 创建管理员账号
2. **添加闲鱼账号** - 支持扫码登录、密码登录、手动输入Cookie
3. **配置关键词** - 为每个账号配置自动回复关键词和AI智能议价
4. **开始使用** - 系统会自动监听闲鱼消息并自动回复、自动发货

---

## 🏗️ 技术栈

**后端：** FastAPI · Python 3.11+ · SQLite · Playwright · WebSocket · Asyncio

**前端：** React 18 · TypeScript · Vite · Tailwind CSS · Framer Motion · Zustand

**性能优化：** 浏览器实例池 · 并发处理 · 智能缓存

---

## 🔄 更新日志

### 🐛 修复前端加载路径问题 (2026-01-19)
- 修复 Vite 构建资源路径错误导致的白屏问题
- 修改 `frontend/vite.config.ts` 配置

### 🎨 前端UI全面重构 - 商务专业风格 (2026-01-18)
- **UI组件库重构** - Button、Card、Badge、Input、Textarea 等基础组件
- **Dashboard 2.0** - 数据统计卡片、快捷操作面板、活动流、账号概览表格
- **Orders 2.0** - 侧边详情面板设计、搜索筛选、内联编辑、批量刷新
- **Accounts 2.0** - 卡片网格布局、AI议价状态可视化、快速切换
- **配色系统** - 品牌黄 #f59e0b + 商务灰度系列

### ⚡ 性能优化 - 减少浏览器启动次数 (2026-01-17)
- **浏览器实例池** - 按账号复用浏览器实例，最多3个实例自动管理
- **合并函数优化** - 一次访问获取所有订单数据，启动次数减少50%
- **并发批量处理** - 支持5个订单并发处理，处理速度提升5倍

### 订单数据刷新功能优化 (2026-01-16)
- 智能订单刷新自动获取完整收货人信息
- 修正订单状态映射逻辑（退款成功、系统关闭）
- 数据完整性检查优化

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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](https://opensource.org/licenses/MIT)

> ⚠️ **免责声明**
>
> 本项目仅供学习研究使用，严禁用于商业用途！
>
> 使用本项目时请遵守相关法律法规，因使用本项目而产生的一切后果由使用者自行承担。

---

## 📊 Star History

[![Star History Chart](https://api.star-history.com/svg?repos=23Star/xianyu-super-butler&type=Date)](https://star-history.com/#23Star/xianyu-super-butler&Date)

---

<div align="center">

**如果对您有帮助，请给个 Star ⭐**

Made with ❤️ by [23Star](https://github.com/23Star)

基于 [xianyu-auto-reply](https://github.com/zhinianboke/xianyu-auto-reply) 开发

</div>