斐讯 N1 搭建闲鱼监控¶

一、前置准备¶

1. 环境要求¶

• 操作系统：Windows / Linux / macOS（推荐 Linux / macOS，稳定性更好）
• 已安装：Docker + Docker Compose（必须）
• 安装教程：https://docs.docker.com/get-docker/（官方教程，各系统都有）
• 网络：能正常访问 GitHub 和闲鱼网站
• 可选：一个 OpenAI API Key（用于 AI 分析，无 Key 也可使用基础监控功能）

2. 检查 Docker 是否安装成功¶

打开终端 / 命令行，执行以下命令，能正常输出版本即代表安装成功：

docker --version
docker-compose --version

二、完整部署步骤¶

步骤 1：克隆项目代码¶

克隆仓库到本地：

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

进入项目目录（后续所有操作都在这个目录下）：

cd ai-goofish-monitor

步骤 2：配置环境变量（核心）¶

2.1 复制示例配置文件¶

cp .env.example .env

2.2 编辑 .env 文件（关键）¶

根据你的系统选择编辑方式：

nano .env

• Windows：直接用记事本打开项目目录下的 .env 文件

核心配置项解释（只改必填项即可）：

# ===================== 基础配置（必填） =====================
# 服务端口（默认8000，若被占用可改，如8001）
PORT=8000
# 时区（固定为Asia/Shanghai，避免时间错乱）
TZ=Asia/Shanghai

# ===================== AI配置（可选，无则注释掉） =====================
# OpenAI API Key（用于AI分析商品，没有就留空）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
# AI模型（默认gpt-4o，无4o权限可改用gpt-3.5-turbo）
OPENAI_MODEL=deepseek-chat
# 模型的API接口地址。这里需要填写服务商提供的、兼容OpenAI格式的API地址
OPENAI_BASE_URL=https://api.deepseek.com

# ===================== 通知配置（选填，至少配一个） =====================
# 方式2：企业微信Webhook
WECHAT_WEBHOOK=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxxxxxxxxxx
# 方式4：ntfy.sh通知（跨平台）
NTFY_TOPIC=https://ntfy.sh/your_topic

配置说明：

• 通知方式至少配置 1 个（推荐 Bark，iOS 用户直接在 App Store 下载 Bark，复制自己的 API 地址即可）
• 无 OpenAI API Key 也能监控，只是没有 AI 分析功能，基础的关键词 / 价格监控不受影响
• 所有不需要的配置项直接留空即可

步骤 3：启动 Docker 容器¶

构建并启动容器（第一次启动会下载镜像，可能需要几分钟）：

docker-compose up --build -d

查看容器状态（显示 Up 即代表启动成功）：

docker-compose ps

步骤 4：访问 Web 管理界面¶

打开浏览器，访问：http://你的服务器IP:8000（本地部署就是 http://localhost:8000）。

三、首次使用：创建监控任务¶

步骤 1：登录闲鱼账号¶

1. 打开 Web 界面后，点击左侧「账号管理」→「添加账号」
2. 扫描页面上的二维码，登录你的闲鱼账号（仅用于获取会话，项目不会存储密码）
3. 登录成功后，会显示账号昵称，代表账号已绑定

步骤 2：创建监控任务¶

1. 点击左侧「监控任务」→「新建任务」
2. 填写任务信息（关键项）：

1. 勾选「启用 AI 分析」（若配置了 OpenAI Key）
2. 选择通知方式（如 Bark）
3. 点击「保存并启动」，任务就会开始运行