XianyuAutoAgent

环境要求

• Python 3.8 或更高版本
• 可用的 LLM API Key（README 默认使用通义千问，其他模型需自行改配置）
• 闲鱼网页端登录后的 Cookie 字符串
• 能运行 Python 脚本的本地环境（Windows/macOS/Linux 均可）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 XianyuAutoAgent 源码，并进入项目根目录，后续命令都在该目录执行。

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

   复制

2. 2安装 Python 依赖

   项目提供 requirements.txt，使用 pip 一次性安装全部依赖，建议在虚拟环境中执行。

   pip install -r requirements.txt

   复制

3. 3获取闲鱼 Cookie

   浏览器登录闲鱼网页端，F12 打开控制台 → Network → Fetch/XHR → 点任一请求 → 复制其中的 cookies。

4. 4配置环境变量

   在项目根目录创建 .env 文件（也可直接把 .env.example 重命名），填入 API Key、Cookie、模型地址与模型名称。

   cp .env.example .env

   复制

5. 5准备提示词文件

   在 prompts/ 目录下准备 *_prompt.txt 文件，或将模板文件名中的 _example 后缀去掉；不创建则默认读取四个内置提示词模板。

6. 6启动主程序

   运行入口脚本启动机器人，程序会按 .env 中的配置连接 LLM 并在闲鱼上自动值守回复。

   python main.py

   复制

关键配置

如何确认成功

执行 python main.py 后观察后台 log 正常输出、无配置报错，并能看到自动回复/议价等对话记录即表示启动成功。

常见问题

注意事项

• 新手可先阅读 README 中提供的保姆级教学文档链接，再按本文步骤操作。
• 务必在项目根目录执行 python main.py，否则可能读不到 .env 和 prompts 文件。
• Cookie 属于敏感凭证，不要提交到 Git 仓库或分享给他人。
• 议价、情感分析、RAG、钉钉集成、Web 管理界面等为 README 标注的规划中功能，当前版本可能尚未提供。