KI-Kundendienst-Bots, die automatisch rund um die Uhr von Idle-Fish-Verkäufern besetzt werden

Allgemeine Einführung

XianyuAutoAgent 是一个专为闲鱼平台设计的智能客服机器人系统，由开发者 shaxiu 在 GitHub 上开源。它通过 AI 技术实现 7×24 小时自动值守，帮助闲鱼卖家回复消息、处理议价和技术咨询。核心功能包括上下文感知对话、智能阶梯式议价和多专家协同决策。项目面向想提升店铺效率的卖家和对 AI 技术感兴趣的开发者，代码免费开放，用户可下载、修改和部署。安装简单，适合个人或小团队使用。

Funktionsliste

• 7×24小时自动值守：全天候在线，实时响应买家消息。
• Kontextsensitiver Dialog：记住对话历史，提供连贯回复。
• 智能议价：基于阶梯降价策略，自动给出合理价格。
• 多专家协同：多个 AI 模型分工合作，处理不同场景。
• 网络搜索整合：技术支持模块可联网查找答案。
• 基础日志监控：记录运行状态，便于排查问题。

Hilfe verwenden

Ablauf der Installation

要使用 XianyuAutoAgent，需要在电脑上完成以下步骤：

1. Klon-Lager
   打开终端（Windows 用 CMD 或 PowerShell，Mac 用 Terminal），输入命令下载代码：

 git clone https://github.com/shaxiu/XianyuAutoAgent.git

下载后进入项目目录：

 cd XianyuAutoAgent

2. 检查环境要求

• 确保电脑安装了 Python 3.8 或更高版本。可在终端输入  python --version  检查。
• 安装 NodeJS 18 或更高版本（部分功能可能需要）。从 NodeJS 官网 下载安装。

3. Installation von Abhängigkeiten
   在终端输入以下命令，安装所需工具包：

 pip install -r anforderungen.txt

如果网络不佳，可用国内镜像源：

 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4. Umgebungsvariablen konfigurieren
   在项目文件夹中新建  .env  文件，用文本编辑器（如记事本或 VS Code）输入：

 OPENAI_API_KEY=你的API密钥
COOKIES_STR=你的闲鱼Cookies

• OPENAI_API_KEY：注册 OpenAI 官网 获取密钥。
• COOKIES_STR：登录闲鱼网页版（xianyu.com），按 F12 打开开发者工具，找到 Cookies，复制完整字符串。保存文件。

5. 准备提示词文件
   项目自带  prompts  文件夹，包含四个默认模板：

• classify_prompt.txt ：意图分类提示词。
• price_prompt.txt ：议价专家提示词。
• tech_prompt.txt ：技术专家提示词。
• default_prompt.txt ：默认回复提示词。
  可直接使用，或根据需要编辑这些文件。

6. laufendes Programm
   配置完成后，输入命令启动：

 python main.py

终端显示“启动成功”后，机器人开始工作。若失败，检查环境变量或依赖。

Hauptfunktionen

1. 7×24小时自动值守

• 如何开启：程序运行后自动监听闲鱼消息，无需手动干预。
• Verfahren：买家发送消息，机器人立即回复。例如，买家问“在吗？”，机器人可能回“在的，有什么可以帮您？”。
• caveat：保持电脑开机、网络稳定，Cookies 有效。

2. 上下文感知对话

• Wie zu verwenden：机器人存储对话历史，确保回复连贯。
• Verfahren：买家问“这款包有黑色吗？”，机器人回“有黑色，库存充足”。买家再问“价格呢？”，机器人会接着回答“黑色这款 120 元”。无需用户操作，AI 自动处理。
• Verfahren zur Inbetriebnahme：若回复不连贯，可检查  classify_prompt.txt  或更换更强模型。

3. 智能议价

• Wie zu verwenden：买家出价时，机器人按阶梯降价策略回应。
• Verfahren：商品标价 150 元，买家出 100 元，机器人可能回“最低 130 元，您看行吗？”。策略在代码中预设，无需手动调整。
• Benutzerdefinierte Einstellungen：编辑  price_prompt.txt ，修改降价幅度或最低价。

Ausgewählte Funktionen Bedienung Ablauf

多专家协同

• 如何开启: Standardmäßig aktiviert. Das Programm verteilt die Aufgaben durch Absichtserkennung an verschiedene Experten.
• VerfahrenDie Käufer fragen nach dem Preis, die Preisexperten antworten; fragen sie nach technischen Details, übernehmen die technischen Experten. Der Nutzer braucht nicht einzugreifen.
• Methode der AnpassungÄndern Sie die Expertenansagen im Prompts-Ordner, oder fügen Sie neue Expertentypen hinzu.

网络搜索整合

• Wie zu verwendenDas technische Unterstützungsmodul kann vernetzt werden, um nach Antworten zu suchen.
• VerfahrenKäufer fragen: "Unterstützt dieses Mobiltelefon 5G?". Nach der Suche antwortet der Roboter: "Es unterstützt 5G, das spezifische Modell ist XX". Die Funktion wird automatisch ausgeführt.
• OptimierungsempfehlungenVergewissern Sie sich, dass Ihr Netzwerk offen ist, um Timeouts bei der Suche zu vermeiden.

基础日志监控

• Wie man dieProtokolldateien werden bei der Ausführung des Programms erstellt.
• VerfahrenÖffnen Sie die Protokolldatei (normalerweise log.txt) im Projektverzeichnis und sehen Sie sich das Laufzeitprotokoll an. Zum Beispiel: "2025-03-18 10:00: Erfolgreiche Antwort auf Nachricht".
• verwenden.Wird bei der Fehlersuche verwendet, z. B. bei der Suche nach verpassten Nachrichten.

Häufig gestellte Fragen

• Fehler beim Start des VerfahrensÜberprüfen Sie die Python- und NodeJS-Versionen und stellen Sie sicher, dass die Abhängigkeiten vollständig sind.
• Ungenaue AntwortenErsetzen Sie den OPENAI_API_KEY durch einen stärkeren, oder passen Sie die Prompt-Word-Datei an.
• Idlefish-KontoanomalieLoggen Sie sich wieder in die Webversion ein, um die Cookies zu aktualisieren.
• LaufzeitunterbrechungÜberprüfen Sie die Netzwerkverbindung oder führen Sie es stattdessen lokal mit einem Cloud-Server aus.

Anwendungsszenario

1. Beschäftigter Fischverkäufer im Leerlauf
   Szenariobeschreibung: Sie erhalten täglich viele Anfragen, aber Sie haben keine Zeit, sie alle zu beantworten. XianyuAutoAgent bewacht automatisch den Shop, bearbeitet die Nachrichten und Schnäppchen, und Sie müssen nur noch das Geschäft bestätigen.
2. AI-Technologie Lernen
   SCHAUSPIELBESCHREIBUNG: Sie sind neu in der Programmierung und möchten sich mit KI-Anwendungen vertraut machen. Laden Sie dieses Projekt herunter und studieren Sie den Code und die Stichwörter, um schnell zu lernen, wie man einen intelligenten Kundenservice entwickelt.
3. Multi-Collaboration Store
   Szenariobeschreibung: Das Team betreibt das Geschäft mit dem ruhenden Fisch. Die Roboter reagieren einheitlich, um eine gleichbleibende Qualität des Kundendienstes zu gewährleisten und die Kosten für die manuelle Koordination zu senken.

QA

1. Muss ich bezahlen?
   Antwort: Das Projekt ist kostenlos und quelloffen und kann direkt von GitHub heruntergeladen werden. Für die Nutzung der OpenAI-API müssen Sie jedoch eine geringe Gebühr entrichten.
2. War es schwer zu installieren?
   Antwort: Das ist nicht schwer. Solange Sie wissen, wie man ein Terminal benutzt, um Befehle einzugeben und die Schritte zu befolgen, können Sie es tun. Es funktioniert auch, wenn Sie keine Ahnung vom Programmieren haben.
3. Werde ich von Idle Fish blockiert werden?
   Antwort: Offiziell ist dies nicht ausdrücklich verboten, aber der Hochfrequenzbetrieb kann riskant sein. Es wird empfohlen, die Geschwindigkeit der Antwort zu kontrollieren und die Regeln der Plattform einzuhalten.