# xianyu_pro

**Repository Path**: io123/xianyu_pro

## Basic Information

- **Project Name**: xianyu_pro
- **Description**: xianyu_pro
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Xianyu AI Automation

基于 **CDP + Playwright + FastAPI + Next.js SSR + Ant Design** 的咸鱼自动化工作台。浏览器保持可视、可人工接管；自动化负责登录状态检测、商品发布、消息回复、订单发货和人工确认通知。

> 使用前请确认账号行为符合咸鱼平台规则。验证码、风控校验和支付相关确认不会被绕过，系统会暂停并要求人工处理。

## 启动

```bash
cp .env.example .env
docker compose up --build
```

打开 `http://localhost:8080`。首次启动后在工作台点击“打开登录页”，通过页面右侧浏览器画面扫码/登录。容器内 Chromium 的 CDP 地址默认为 `http://browser:9222`。

## 主要能力

- 可视化 CDP 浏览器与实时截图、人工接管
- 商品草稿与自动发布任务
- 消息轮询、询价识别和 AI 自动回复
- 数字商品自动发货；需确认订单通知微信客服或飞书 Webhook
- OpenAI-compatible AI 接口，可接 OpenAI、通义、DeepSeek、Ollama 等
- `/skills` 下提供给 AI Agent 使用的技能说明与工具定义
- Next.js 服务端渲染，Nginx 单端口代理页面、API 与 WebSocket

## API

- `GET /api/status`：系统状态
- `POST /api/browser/login`：打开登录页
- `POST /api/products/publish`：创建发布任务
- `POST /api/automation/toggle`：启停消息/订单自动化
- `GET /api/events`：最近事件
- `WS /api/ws`：实时事件
- `GET/PUT /api/features`：读取或保存功能开关
- `GET /api/conversations`：卖家侧买家咨询/订单会话
- `POST /api/conversations/{id}/reply`：人工回复买家
- `WS /api/ws/messages`：脱敏后的实时消息与会话列表

消息中心直接监听咸鱼网页使用的 WebSocket，会话依据 `itemSellerId` 和工作台商品 ID 双重过滤；认证帧不会转发或落盘。CDP 主要用于维持登录、验证码处理和页面兼容回退。