视频教程：
适合做闲鱼的小伙伴使用，实现自动发货，自动售卖，自动回复等功能。
闲鱼超级管家 · 自动发货系统与智能回复平台功能详解
🎯 系统适用对象
本系统面向以下场景与人群，帮助其降低闲鱼店铺运营的人力成本、提升发货效率与转化率：
- 闲鱼虚拟商品卖家：售卖卡密、会员、教程、激活码等可数字化交付的商品，需要买家付款后秒级自动发货。
- 多店铺矩阵运营者：同时管理多个闲鱼账号，希望统一面板集中监控消息、订单与发货状态。
- 高频议价场景卖家：每天收到大量”能不能便宜点”的咨询，希望由 AI 自动完成多轮议价并守住价格底线。
- 数字卡券/激活码分销商：需要按商品规格匹配不同卡券类型（文本、图片、API 动态取卡），并支持延时发货。
- 技术型卖家 / 独立开发者：希望基于开源代码二次开发，接入自定义大模型、自定义发货规则或对接外部 ERP。
- 追求 7×24 无人值守运营的卖家：希望在夜间或无人值守时，系统自动回复咨询、自动发货、自动同步订单状态。
📑 文档目录
1系统架构概述
系统采用前后端分离架构，后端以 FastAPI 提供 RESTful 接口，通过 WebSocket 长连接实时接收闲鱼消息，前端 React 单页应用负责运营面板渲染。
整套系统由 Start.py 统一启动：先迁移 SQLite 数据库文件到 data/ 目录，再检测并自动安装 Playwright Chromium 浏览器，随后在后台线程拉起 FastAPI 服务（端口 8080），主协程驱动 CookieManager 为每个闲鱼账号创建独立的 XianyuAutoAsync 异步任务，通过 WebSocket 长连接 wss://wss-goofish.dingtalk.com/ 实时接收消息并触发回复与发货流程。
2工作台与数据统计
登录后首屏即为工作台 Dashboard，聚合展示店铺关键运营指标，帮助运营人员一眼掌握全局动态。
工作台由前端 Dashboard.tsx 组件渲染，后端通过 /api/admin/stats 等接口聚合 SQLite 中 orders、cookies、ai_conversations 等表数据，输出：
- 订单总数、待发货数、已发货数、已取消数等状态分布；
- 账号在线状态、消息处理量、AI 议价触发次数；
- 近 7 天趋势图与活动流时间线；
- 快捷操作入口：添加账号、配置关键词、导入卡券等。
3智能回复引擎（关键词 + AI 计价）
系统提供四级回复策略：商品专属回复 → 关键词匹配 → AI 智能议价 → 默认回复，由 ai_reply_engine.py 统一调度。
关键词匹配回复
运营人员在 Keywords.tsx 面板配置”关键词 → 回复内容”映射，存入 keywords 表，支持文本与图片两种回复类型，并可绑定到具体商品 item_id 实现商品级关键词。系统启动时还会读取 回复关键字.txt 文件加载全局映射。
AI 智能议价
AI 引擎通过 OpenAI 兼容接口接入大模型（默认 qwen-plus，可切换 DeepSeek、Gemini 等），按账号独立配置以下参数：
| 参数 | 字段 | 说明 |
|---|---|---|
| 最大折扣比例 | max_discount_percent | 默认 10%，控制让利上限 |
| 最大让利金额 | max_discount_amount | 默认 100 元，绝对金额兜底 |
| 最大议价轮数 | max_bargain_rounds | 默认 3 轮，超过即坚持底线 |
| 自定义提示词 | custom_prompts | 覆盖默认议价/技术/客服 prompt |
引擎会根据议价次数递减优惠力度，接近最大轮数时强调商品价值并守住底线，对话历史持久化到 ai_conversations 表以支持多轮上下文。
默认回复与手动接管
当所有策略均未命中时，由 default_replies 表配置的默认回复兜底，支持”仅回复一次”模式。同时 AutoReplyPauseManager 会检测运营人员手动发出的消息，自动暂停该会话的自动回复（暂停时长按账号配置，默认 10 分钟），避免人机抢话。
4自动发货系统（卡券匹配 + 延时发货）
买家付款后，系统按发货规则匹配卡券，自动发送给买家并将闲鱼订单标记为已发货，支持多规格商品与延时发货。
发货规则匹配
delivery_rules 表配置”关键词 → 卡券”映射，订单进来后按商品标题/规格关键词命中规则，取出对应卡券发放。每条规则记录已发货次数 delivery_times 与发放数量 delivery_count，便于统计与限流。
多类型卡券
cards 表支持四种卡券类型：
text 文本卡image 图片卡data 数据卡api 动态取卡
其中 api 类型可调用外部接口实时取卡，适合对接卡密供应商；每张卡可配置 delay_seconds 实现延时发货。
多规格商品发货
商品信息表 item_info 标记 is_multi_spec 多规格 flag，卡券表 cards 同样有 spec_name/spec_value 字段。发货时系统会按买家下单的规格精确匹配对应卡券，避免发错货。multi_quantity_delivery 字段还支持多数量发货（买 N 件发 N 张卡）。
补发功能
针对”已给客户发过货但忘了改状态”或”既没发卡也没改状态”两种遗漏场景，订单列表提供”立即发货”按钮，弹出对话框让运营人员选择：
- 仅修改闲鱼发货状态：只调用闲鱼 API 标记已发货，不发卡券；
- 完整发货（匹配卡券并发送）：走完整规则匹配 → 取卡 → 发送 → 标记已发货流程。
5订单管理与补发功能
订单中心提供列表查看、批量刷新、详情侧边栏、状态筛选与单条操作，由 OrderList.tsx 与 order_status_handler.py 协同实现。
订单数据模型
orders 表核心字段：order_id、item_id、buyer_id、spec_name/spec_value（规格）、amount、order_status、cookie_id（归属账号）、is_bargain（小刀订单标记）、receiver_name/phone/address（收货人信息）、chat_id（用于手动发货发消息）、version（乐观锁）。
批量并发刷新
一键同步订单时使用 Playwright 实时获取最新状态，5 个订单并发处理，速度提升 5 倍。
状态码映射
完整映射闲鱼状态码（含 11 交易完成、12 交易关闭），稳定状态订单不再重复刷新。
单条操作
支持单条订单同步、删除（带确认框）、立即发货，固定列宽布局更合理。
6多账号管理与登录
系统支持同时托管多个闲鱼账号，每个账号独立维护 Cookie、AI 配置、关键词与发货规则，由 AccountList.tsx 与 cookie_manager.py 管理。
账号数据存于 cookies 表，关联 user_id 实现多用户隔离。每个账号可独立配置：auto_confirm（自动确认收货）、pause_duration（手动发消息后暂停时长）、show_browser（是否显示浏览器窗口）、enabled（启用/禁用）。cookie_status 表单独维护在线状态，risk_control_logs 表记录风控事件。
7卡券与发货规则配置
卡券管理（CardList.tsx）与发货规则（Rules.tsx）是自动发货的两块配置基石，前者定义”发什么”，后者定义”何时发、发几张”。
卡券库管理
支持新增、编辑、启停、批量导入导出（Excel）。api 类型卡券可配置外部取卡接口地址与参数，image 类型支持上传图片由 image_utils.py 统一管理。
发货规则
每条规则绑定一个卡券 card_id，设置匹配关键词与发放数量。规则命中后 delivery_times 自增，便于在面板查看每条规则的累计触发次数。
8核心业务流程说明
以下流程图描绘了从闲鱼消息到达至发货完成的完整自动化链路。
关键工程细节：WebSocket 通过 HEARTBEAT_INTERVAL=15s 心跳保活，TOKEN_REFRESH_INTERVAL=3600s 刷新 token；连接状态用 ConnectionState 枚举管理（断开/连接中/已连接/重连中/失败/已关闭），异常自动重连。发货时为避免跨异步上下文问题，会创建独立的 aiohttp.ClientSession 而非复用运行实例的 session。
9关键特性展示
以下特性是本系统区别于普通闲鱼挂机脚本的核心竞争力。
7×24 无人值守
WebSocket 长连接 + 异步任务，夜间自动回复与发货不断线。
多账号矩阵
单实例托管 N 个闲鱼账号，独立配置互不干扰。
AI 智能议价
OpenAI 兼容接口，多轮议价守住底线，按账号独立配置。
滑块验证破解
Playwright 集成反检测方案，登录滑块验证成功率 99%。
浏览器实例池
按账号复用浏览器实例（最多 3 个），启动次数减少 50%。
多类型卡券
文本/图片/数据/API 四类卡券，支持延时与多规格发货。
Excel 批量导入导出
卡券、订单支持 Excel 批量操作，pandas 驱动。
多用户权限
用户表 + Bearer 鉴权 + 账号归属隔离，支持团队协作。
消息通知渠道
notification_channels 表支持多渠道消息推送告警。
10技术栈与工程实现
从开发工程师视角，本系统选型兼顾性能、可维护性与部署便捷性。
后端
| 组件 | 用途 |
|---|---|
| FastAPI | 异步 Web 框架，提供 RESTful 接口 |
| Python 3.11+ / Asyncio | 异步事件循环驱动消息处理 |
| websockets | 闲鱼长连接消息监听 |
| Playwright | 浏览器自动化、扫码登录、滑块验证 |
| SQLite | 轻量存储，25 张表覆盖全业务 |
| OpenAI SDK | 大模型议价回复，兼容多家接口 |
| Loguru | 结构化日志，按天滚动保留 7 天 |
| pandas | Excel 批量导入导出 |
前端
| 组件 | 用途 |
|---|---|
| React 18 + TypeScript | 类型安全的单页应用 |
| Vite | 构建工具，产物输出到 static/ |
| Tailwind CSS | 原子化样式，商务专业风格 |
| Framer Motion | 交互动画 |
| Zustand | 轻量状态管理 |
| lucide-react | 图标库 |
部署
提供 Dockerfile / docker-compose.yml（含中文加速版 docker-compose-cn.yml）、Nginx 配置、CentOS9 部署教程，支持容器化与裸机两种部署形态。Start.py 启动时自动迁移数据库、检测并安装 Playwright 浏览器，开箱即用。
数据库表概览（25 张）
核心业务表：users（用户）、cookies（闲鱼账号）、cookie_status（账号状态）、keywords（关键词回复）、ai_reply_settings（AI 配置）、ai_conversations（AI 对话历史）、ai_item_cache（商品缓存）、cards（卡券）、orders（订单）、item_info（商品信息）、delivery_rules（发货规则）、default_replies（默认回复）、item_replay（商品专属回复）、notification_channels（通知渠道）、risk_control_logs（风控日志）等，覆盖账号、消息、订单、发货、风控全链路。
会员专属
暂无评论内容