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值
- **删除账号**：删除不需要的账号及其关键词
- **独立运行**：每个账号独立运行，互不干扰

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

### 回复优先级说明
系统按以下优先级处理回复：
1. **🔥 API回复** - 外部API接口回复（最高优先级）
2. **📝 关键词回复** - 精确关键词匹配回复
3. **🤖 AI智能回复** - AI模型生成的智能回复
4. **💬 默认回复** - 兜底的默认回复内容

### 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` 配置文件
- 备份自定义的关键词文件

## 🔧 高级功能

### AI回复配置
1. 在账号列表中点击"🤖 配置AI回复"
2. 开启AI回复功能
3. 配置API密钥和模型参数
4. 设置议价策略和优惠限制
5. 自定义提示词（可选）

### 自动发货设置
1. 进入"自动发货"页面
2. 添加发货规则和关键词匹配
3. 上传卡券文件或手动添加卡券
4. 配置发货模板和通知方式

### 商品管理
1. 进入"商品管理"页面
2. 查看自动收集的商品信息
3. 编辑商品详情和分类
4. 批量获取账号下所有商品

### 日志监控
1. 进入"日志管理"页面
2. 实时查看系统运行日志
3. 按级别和来源筛选日志
4. 查看系统统计信息

## 📊 数据管理

### 数据备份
1. 进入"系统设置"页面
2. 点击"导出备份"按钮
3. 下载备份文件到本地
4. 定期备份重要数据

### 数据恢复
1. 进入"系统设置"页面
2. 点击"导入备份"按钮
3. 选择备份文件上传
4. 确认恢复操作

### 数据清理
- 定期清理过期日志文件
- 删除无效的商品信息
- 清理过期的对话记录

## 📞 技术支持

### 系统健康检查
访问健康检查端点：
```
http://localhost:8080/health
```

### 查看系统状态
```bash
# 查看容器状态
docker-compose ps

# 查看系统资源使用
docker stats

# 查看实时日志
docker-compose logs -f
```

### 常见问题解决

**问题1：Cookie失效**
- 重新获取Cookie并更新
- 检查账号是否被限制
- 确认Cookie格式正确

**问题2：消息接收异常**
- 检查网络连接
- 重启WebSocket连接
- 查看错误日志

**问题3：AI回复失败**
- 检查API密钥是否正确
- 确认API服务可用
- 检查账户余额

## 🎯 最佳实践

### 安全建议
1. **定期更换密码**：修改默认管理员密码
2. **限制访问**：仅允许信任的IP访问
3. **备份数据**：定期备份重要配置和数据
4. **监控日志**：定期查看系统日志

### 性能优化
1. **合理设置**：根据实际需求配置参数
2. **定期清理**：清理过期数据和日志
3. **监控资源**：关注系统资源使用情况
4. **优化配置**：根据使用情况调整配置

### 使用技巧
1. **Cookie获取**：使用浏览器开发者工具获取完整Cookie
2. **关键词设置**：设置常用的咨询关键词和回复
3. **AI配置**：根据商品类型调整AI提示词
4. **发货规则**：设置精确的商品匹配规则

## 🔄 系统更新

### 更新步骤
1. 备份当前数据
2. 停止系统服务
3. 拉取最新代码
4. 重新构建镜像
5. 启动更新后的服务

### Docker更新
```bash
# 停止服务
docker-compose down

# 拉取最新代码
git pull

# 重新构建
./deploy.sh --update

# 检查状态
docker-compose ps
```

---

**注意**：本系统仅供学习交流使用，请遵守相关法律法规和平台规则。使用前请仔细阅读相关文档，确保正确配置和使用。