中文 | English
Note
XianyuBot 是基于 XianyuAutoAgent 重构的模块化闲鱼智能客服系统，提供了更完善的架构和更强大的功能。
Important
- 本项目仅供个人学习使用，不保证稳定性，请勿用于商业用途。
- 使用者必须在遵循闲鱼平台规则以及相关法律法规的情况下使用，不得用于非法用途。
| 模块化架构 | 智能对话引擎 |
|---|---|
|
|
- Python 3.8+
- Playwright (获取登录凭证)
# 1. 克隆仓库
git clone https://github.com/yourusername/xianyubot.git
cd xianyubot
# 2. 安装依赖
pip install -r requirements.txt
# 3. 安装Playwright浏览器
python -m playwright install firefox chromium
# 4. 配置环境变量
cp .env.example .env
# 编辑.env文件，填入必要的API密钥和配置XianyuBot支持通过环境变量配置不同的大模型，您可以在.env文件中设置以下参数：
# 主要模型 - 用于生成回复
LLM_MODEL=gpt-4-turbo
# 轻量级模型 - 用于分类等简单任务
LLM_MODEL_LIGHT=gpt-3.5-turbo
# 温度参数 - 控制回复的创意性 (0.0-2.0)
LLM_TEMPERATURE=0.7支持的模型类型包括：
- OpenAI API模型：
gpt-4o、gpt-4o-mini等 - 各类本地或开源模型API：
glm-4、qwen-max、deepseek等任何兼容OpenAI API格式的模型
XianyuBot会自动管理登录凭证，不需要手动设置cookies：
| 方式一：使用独立脚本获取 | 方式二：使用命令行参数强制刷新 |
|---|---|
# 运行自动获取脚本
python scripts/get_cookies.py |
# 使用--login参数强制刷新登录凭证
python run.py --login |
python run.pyXianyuBot 支持以下命令行参数：
| 参数 | 说明 |
|---|---|
--login |
强制重新获取闲鱼登录凭证，无论当前是否存在有效凭证 |
--debug |
启用调试模式，输出更详细的日志信息 |
示例：
# 启用调试模式并强制重新登录
python run.py --login --debugXianyuBot 目前支持以下操作系统：
| macOS支持 | Windows支持 |
|---|---|
|
|
xianyubot/
├── data/ # 数据存储目录（cookies、历史记录等）
├── src/ # 源代码目录
│ ├── api/ # API接口模块
│ │ ├── xianyu_api.py # 闲鱼API客户端
│ │ └── xianyu_websocket.py # WebSocket实时通信模块
│ ├── agents/ # 智能代理模块
│ │ ├── base.py # 代理基类
│ │ └── expert_agents.py # 专家代理实现
│ ├── core/ # 核心功能模块
│ │ └── context_manager.py # 对话上下文管理器
│ └── utils/ # 工具函数集
├── prompts/ # 提示词模板
├── scripts/ # 辅助脚本
│ └── get_cookies.py # 获取闲鱼登录凭证
├── run.py # 主程序入口
├── requirements.txt # 依赖列表
├── .env.example # 环境变量示例
└── README.md # 项目文档
XianyuBot 采用模块化分层架构设计：
| 层级 | 功能 |
|---|---|
| API层 |
|
| 核心层 |
|
| 代理层 |
|
| 工具层 |
|
| 指标 | 数值/说明 |
|---|---|
| 响应速度 | 平均回复时间 < 3秒 |
| 并发处理 | 单实例支持多会话并发 |
| 内存占用 | 约150-300MB（取决于活跃会话数量） |
| API额度 | 取决于您的OpenAI API Key限制 |
- 命令行自动登录（免浏览器获取凭证）
- 知识库管理（支持RAG增强回复质量）
- Web管理界面（可视化配置和监控）
- 兼容各种模型后端（欢迎提交issues建议）
- 添加更多专家代理类型
- 支持多账号同时在线
- 添加统计分析功能
欢迎提交Issue和Pull Request，共同改进XianyuBot！如有使用问题，请在GitHub上提交详细的错误报告。
本项目采用MIT许可证开源。
本项目基于以下开源项目重构：
- XianyuAutoAgent - 智能闲鱼客服机器人系统，由 @shaxiu 和 @cv-cat 开发