实战指南：基于AI的闲鱼智能监控机器人（ai-goofish-monitor）

这是一篇基于 ai-goofish-monitor 项目文档整理的部署演示文章，涵盖了最推荐的 Docker 部署方式以及本地源码部署方式，并重点说明了关键的配置与登录步骤。

实战指南：部署基于 AI 的闲鱼智能监控机器人 (ai-goofish-monitor)

在这个“捡漏”靠手速和运气的时代，ai-goofish-monitor 提供了一种全新的解决方案。这是一个基于 Playwright 和 AI（多模态模型）的闲鱼多任务实时监控工具，它不仅能帮你盯着商品，还能通过 AI 帮你“看图说话”，过滤掉不符合要求的商品。

以下是将该项目部署到你本地环境的详细步骤演示。

使用 Docker 可以避免繁杂的 Python 环境依赖问题，是官方推荐的部署方式。

确保你的服务器或电脑上已经安装了 Docker Engine 和 Docker Compose。

在终端执行以下命令，将项目克隆到本地：

git clone https://github.com/Usagi-org/ai-goofish-monitor
cd ai-goofish-monitor

这是项目运行的大脑。你需要复制示例配置文件并填入你的 AI 模型密钥。

# 复制配置文件
cp .env.example .env

使用文本编辑器修改 .env 文件，填入以下必填项：

在项目根目录下，一条命令即可启动所有服务：

docker-compose up --build -d

该命令会自动读取配置并后来台模式启动容器。

实战指南：基于AI的闲鱼智能监控机器人（ai-goofish-monitor）

如果你熟悉 Python 开发环境，也可以选择直接在本地运行。

确保你的系统满足以下要求：

# 进入项目目录
cd ai-goofish-monitor

# 安装 Python 依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器内核
playwright install chromium

配置好 .env 文件（步骤同 Docker 部署）后，赋予启动脚本执行权限并运行：

chmod +x start.sh
./start.sh

实战指南：基于AI的闲鱼智能监控机器人（ai-goofish-monitor）

无论是 Docker 还是本地部署，最关键的一步是解决闲鱼的登录验证。由于 Docker 容器内无法直接扫码，你需要通过 Web 界面来注入登录凭证。

访问 Web UI: 服务启动后，浏览器打开 http://127.0.0.1:8000。
登录后台: 输入你在 .env 中设置的账号密码（默认 admin/admin123）。
进入设置: 点击侧边栏的 “系统设置”，找到 “手动更新” 登录状态按钮。
提取 Cookie: 在你的电脑浏览器（Chrome）上安装项目提供的“闲鱼登录状态提取扩展”。在浏览器中登录闲鱼官网。点击扩展图标，选择“提取登录状态”并“复制到剪贴板”。
保存凭证: 回到监控系统的 Web UI 弹窗中，粘贴刚才复制的内容并保存。

实战指南：基于AI的闲鱼智能监控机器人（ai-goofish-monitor）

部署完成并登录后，你可以开始体验以下功能：

创建任务: 可以直接用自然语言描述需求（例如：“帮我盯着价格在 500 到 800 之间的 iPhone 11，不要屏幕碎的”），AI 会自动生成关键词和筛选标准。
实时监控: 在“运行日志”页面查看爬虫的实时动态。
结果分析: 系统会以卡片形式展示抓取到的商品，并附带 AI 的分析结果（推荐或不推荐及其理由）。