xianyu-auto-reply/使用说明.md

# 闲鱼自动回复管理系统 - 使用说明

## 🎉 系统功能概述

本系统已完全实现您要求的所有功能：

### ✅ 已实现功能
1. **多Cookies支持** - 支持同时管理多个闲鱼账号
2. **美观前端界面** - 响应式设计，支持Cookies和关键词的CRUD操作
3. **SQLite数据库存储** - 持久化存储Cookies和关键词数据
4. **关键词管理** - 每个账号独立的关键词回复设置
5. **API接口** - 完整实现 `/xianyu/reply` 接口
6. **智能回复** - 根据Cookie ID匹配对应关键词进行回复
7. **用户认证** - 安全的登录认证系统

## 🚀 快速开始

### 1. 安装依赖
```bash
pip install -r requirements.txt
```

### 2. 启动系统
```bash
python Start.py
```

### 3. 访问系统
- 打开浏览器访问：`http://localhost:8080`
- 默认登录账号：
  - **用户名**：`admin`
  - **密码**：`admin123`

## 📋 系统使用流程

### 步骤1：登录系统
1. 访问 `http://localhost:8080`
2. 输入用户名和密码登录
3. 成功登录后进入管理界面

### 步骤2：添加闲鱼账号
1. 在"添加新账号"区域填写：
   - **账号ID**：唯一标识（如：account1, 主账号等）
   - **Cookie值**：完整的闲鱼Cookie字符串
2. 点击"添加账号"按钮

### 步骤3：设置关键词回复
1. 在账号列表中点击"关键词"按钮
2. 添加关键词和对应的回复内容
3. 支持变量替换：
   - `{send_user_name}` - 发送者昵称
   - `{send_user_id}` - 发送者ID
   - `{send_message}` - 发送的消息内容
4. 点击"保存更改"

### 步骤4：系统自动运行
- 系统会自动监控闲鱼消息
- 根据关键词匹配自动回复
- 所有操作都有详细日志记录

## 🔧 功能详解

### 多账号管理
- **添加账号**：支持添加无限数量的闲鱼账号
- **修改Cookie**：可以随时更新账号的Cookie值
- **删除账号**：删除不需要的账号及其关键词
- **独立运行**：每个账号独立运行，互不干扰

### 关键词回复系统
- **精确匹配**：支持关键词精确匹配
- **变量替换**：回复内容支持动态变量
- **优先级**：账号级关键词优先于全局关键词
- **默认回复**：未匹配关键词时使用默认回复

### API接口
- **接口地址**：`POST http://localhost:8080/xianyu/reply`
- **功能**：根据cookie_id和消息内容返回回复内容
- **自动调用**：系统收到消息时自动调用此接口

## 📊 系统架构

```
用户界面 (Web) ←→ FastAPI服务器 ←→ SQLite数据库
                      ↓
                 CookieManager
                      ↓
                 XianyuLive (多实例)
                      ↓
                 闲鱼WebSocket连接
```

## 🔐 安全说明

### 登录认证
- 所有管理功能都需要登录认证
- Session token有效期24小时
- 自动登录状态检查

### 数据安全
- Cookie数据加密存储在SQLite数据库
- 界面上不显示完整Cookie值
- 支持安全的Cookie更新机制

## 📝 日志系统

### 日志文件位置
- 日志目录：`logs/`
- 文件格式：`xianyu_YYYY-MM-DD.log`
- 自动轮转：每天一个文件，保留7天

### 日志内容
- 系统启动和关闭
- 账号添加、修改、删除
- 消息接收和发送
- 错误和异常信息

## 🛠️ 故障排除

### 常见问题

#### 1. Cookie过期
**现象**：日志显示"Session过期"
**解决**：在Web界面更新对应账号的Cookie值

#### 2. 无法连接闲鱼
**现象**：WebSocket连接失败
**解决**：检查网络连接和Cookie是否有效

#### 3. 关键词不匹配
**现象**：收到消息但没有自动回复
**解决**：检查关键词设置，确保关键词包含在消息中

#### 4. 登录失败
**现象**：无法登录管理界面
**解决**：确认用户名密码正确（admin/admin123）

### 系统要求
- Python 3.7+
- Windows/Linux/macOS
- 网络连接
- 有效的闲鱼账号Cookie

## 🔄 更新和维护

### 配置文件
- 主配置：`global_config.yml`
- 数据库：`xianyu_data.db`
- 静态文件：`static/` 目录

### 备份建议
- 定期备份 `xianyu_data.db` 文件
- 备份 `global_config.yml` 配置文件
- 备份自定义的关键词文件

## 📞 技术支持

### 测试系统
运行测试脚本检查系统状态：
```bash
python test_system.py
```

### 重新创建配置
如果配置文件损坏，运行：
```bash
python create_config.py
```

## 🎯 使用建议

1. **Cookie获取**：使用浏览器开发者工具获取完整Cookie
2. **关键词设置**：设置常用的咨询关键词和回复
3. **定期检查**：定期查看日志确保系统正常运行
4. **备份数据**：重要数据请及时备份

---

**注意**：本系统仅供学习交流使用，请遵守相关法律法规和平台规则。