Usagi-org / ai-goofish-monitor
本项目基于 Playwright 和AI过滤的闲鱼多任务实时/定时监控与智能分析工具,配备了功能完善的后台管理界面。帮助用户节省闲鱼商品过滤,能及时找到心仪商品。
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing Usagi-org/ai-goofish-monitor in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
Preview闲鱼智能监控机器人
基于 Playwright 和 AI 的闲鱼多任务实时监控工具,提供完整的 Web 管理界面。
核心特性
- Web 可视化管理: 任务管理、账号管理、AI 标准编辑、运行日志、结果浏览
- AI 驱动: 自然语言创建任务,多模态模型深度分析商品
- 多任务并发: 独立配置关键词、价格、筛选条件和 AI Prompt
- 高级筛选: 包邮、新发布时间范围、省/市/区三级区域筛选
- 即时通知: 支持 ntfy.sh、企业微信、Bark、Telegram、Webhook
- 定时调度: Cron 表达式配置周期性任务
- 账号与代理轮换: 多账号管理、任务绑定账号、代理池轮换与失败重试
- Docker 部署: 一键容器化部署
截图

快速开始
环境准备
要求:
- Python 3.10+
- Node.js + npm(用于前端构建)
- Playwright 浏览器依赖(未安装时执行
playwright install chromium)
git clone https://github.com/Usagi-org/ai-goofish-monitor
cd ai-goofish-monitor
配置
- 创建配置文件
cp .env.example .env
- 核心配置项
| 变量 | 说明 | 必填 |
|---|---|---|
OPENAI_API_KEY | AI 模型 API Key | 是 |
OPENAI_BASE_URL | API 接口地址(兼容 OpenAI 格式) | 是 |
OPENAI_MODEL_NAME | 多模态模型名称(如 gpt-4o) | 是 |
WEB_USERNAME / WEB_PASSWORD | Web 界面登录凭据(默认 admin / admin123) | 否 |
NTFY_TOPIC_URL | ntfy.sh 通知地址 | 否 |
BARK_URL | Bark 推送地址 | 否 |
WX_BOT_URL | 企业微信 Webhook(需用双引号包围) | 否 |
完整配置项参考 .env.example
- 启动服务
chmod +x start.sh && ./start.sh
start.sh 会自动完成依赖安装、前端构建与后端启动。
- 访问 Web UI
访问
http://127.0.0.1:8000, 登录默认密码(admin/admin123) → 闲鱼账号管理,按提示使用 Chrome 扩展 提取并粘贴登录状态 JSON。 账号会保存到state/目录(例如state/acc_1.json)。随后在任务管理中选择绑定账号即可开始使用。
🐳 Docker 部署
使用 docker-compose.yaml 一键启动,镜像已预置前端构建与运行环境。
1) 准备(这一步可跳过,启动后在UI页面里也可以配置)
cp .env.example .env
vim .env
2) 启动
docker compose up -d
3) 访问与管理
- 访问 Web UI:
http://127.0.0.1:8000 - 查看日志:
docker compose logs -f app - 停止服务:
docker compose down账号状态默认保存在容器内/app/state,如需持久化可在 compose 中添加挂载./state:/app/state。
4) 更新镜像
docker compose pull
docker compose up -d
Web UI 功能一览
点击展开 Web UI 功能详情
- 任务管理:AI 创建、参数编辑、任务调度、账号绑定
- 闲鱼账号管理:添加/更新/删除账号,导入登录状态 JSON
- 结果查看:卡片浏览、筛选排序、详情查看
- 运行日志:按任务分组、增量加载、自动刷新
- 系统设置:状态检查、Prompt 编辑、代理轮换
🚀 工作流程
下图描述了单个监控任务从启动到完成的核心处理逻辑。在实际使用中,src.app 会作为主服务,根据用户操作或定时调度来启动一个或多个任务进程。
graph TD
A[启动监控任务] --> B[选择账号/代理配置];
B --> C[任务: 搜索商品];
C --> D{发现新商品?};
D -- 是 --> E[抓取商品详情 & 卖家信息];
E --> F[下载商品图片];
F --> G[调用AI进行分析];
G --> H{AI是否推荐?};
H -- 是 --> I[发送通知];
H -- 否 --> J[保存记录到 JSONL];
I --> J;
D -- 否 --> K[翻页/等待];
K --> C;
J --> C;
C --> L{触发风控/异常?};
L -- 是 --> M[账号/代理轮换并重试];
M --> C;
Web 界面认证
点击展开认证配置详情
认证配置
Web界面已启用Basic认证保护,确保只有授权用户才能访问管理界面和API。
配置方法
在 .env 文件中设置认证凭据:
# Web服务认证配置
WEB_USERNAME=admin
WEB_PASSWORD=admin123
默认凭据
如果未在 .env 文件中设置认证凭据,系统将使用以下默认值:
- 用户名:
admin - 密码:
admin123
⚠️ 重要:生产环境请务必修改默认密码!
认证范围
- 需要认证:所有API端点、Web界面、静态资源
- 无需认证:健康检查端点 (
/health)
使用方法
- 浏览器访问:访问Web界面时会弹出认证对话框
- API调用:需要在请求头中包含Basic认证信息
- 前端JavaScript:会自动处理认证,无需修改
安全建议
- 修改默认密码为强密码
- 生产环境使用HTTPS协议
- 定期更换认证凭据
- 通过防火墙限制访问IP范围
详细配置说明请参考 AUTH_README.md。
致谢
点击展开致谢内容
本项目在开发过程中参考了以下优秀项目,特此感谢:
以及感谢LinuxDo相关人员的脚本贡献
以及感谢 LinuxDo 社区。
以及感谢 ClaudeCode/Gemini/Codex 等模型工具,解放双手 体验Vibe Coding的快乐。
体会
点击展开项目体会
本项目 90%+ 的代码都由AI生成,包括 ISSUE 中涉及的 PR 。
Vibe Coding 的可怕之处在于如果不过多的参与项目建设,对AI生成的代码没有进行细致的review,没有思考过AI为什么这么写,盲目的通过跑测试用例验证功能可用性只会导致项目变成一个黑盒。
同样再用AI对AI生成的代码进行code review时,就像是用AI来验证另一个AI的回答是不是AI,陷入了自我证明的困境之中,所以AI可以辅助分析,但不应该成为真相的仲裁者。