# xianyu-hunter Hermes Skill 便携包

这个包用于把「闲鱼采集助手 + Hermes 控制 Skill」安装到另一台 Hermes 环境里，让其他 Hermes 也能用自然语言执行闲鱼商品监测。

## 包内内容

```text
skill/xianyu-hunter-monitor/     Hermes Skill：告诉 Hermes 如何创建、运行、分析闲鱼监测任务
project/xianyu-hunter/           本地 Web/CLI 采集助手项目，不含登录 Cookie、历史任务、缓存、node_modules
install.sh                       一键安装脚本
README.md                        本说明
```

## 目标效果

安装后可以对 Hermes 说：

```text
帮我在闲鱼监测 27寸戴尔显示器，广州，250元以内，正常显示，只做筛选分析不要联系卖家
```

Hermes 会优先加载 `xianyu-hunter-monitor` skill，并使用项目里的统一 CLI：

```bash
node tools/xianyu_ops.mjs run ...
```

默认模式：**只采集 + 筛选 + Hermes 分析，不自动联系卖家，不下单，不付款。**

## 前置要求

- macOS / Linux / WSL 均可，推荐 macOS，因为登录窗口和扫码更方便。
- 已安装 Hermes Agent。
- Node.js >= 18。
- npm 可用。
- 能访问 `https://www.goofish.com/`。

检查：

```bash
node -v
npm -v
hermes --version
```

## 一键安装

在解压后的目录执行：

```bash
bash install.sh
```

默认安装到：

```text
~/.hermes/skills/social-media/xianyu-hunter-monitor/
~/xianyu-hunter/
```

如果你想改项目安装目录：

```bash
XIANHU_INSTALL_DIR="$HOME/apps/xianyu-hunter" bash install.sh
```

## 手动安装

```bash
# 1. 安装 skill
mkdir -p ~/.hermes/skills/social-media
cp -R skill/xianyu-hunter-monitor ~/.hermes/skills/social-media/

# 2. 安装项目
cp -R project/xianyu-hunter ~/xianyu-hunter
cd ~/xianyu-hunter
npm install
npx playwright install chromium
```

## 启动 Web 面板

```bash
cd ~/xianyu-hunter
node tools/xianyu_ops.mjs start --port 3000
```

打开：

```text
http://127.0.0.1:3000/
```

局域网访问可用本机 IP，例如：

```text
http://192.168.x.x:3000/
```

## 登录闲鱼/Goofish

Web 面板右上角点击：

```text
账号登录 / Cookie
```

然后：

1. 点击「获取/刷新登录二维码」。
2. 手机扫码登录。
3. 点击「刷新账号状态」。
4. Cookie 会保存在项目本地 `browser-data/`，不会包含在这个分享包里。

也可以用 CLI：

```bash
cd ~/xianyu-hunter
node tools/xianyu_ops.mjs login
```

如果出现验证码/滑块，需要人工完成，不要绕过。

## 运行一次监测任务

```bash
cd ~/xianyu-hunter
node tools/xianyu_ops.mjs run \
  --name '27寸戴尔显示器 广州 250以内' \
  --queries '27寸 戴尔 显示器,dell 27 显示器,戴尔 27寸 显示器' \
  --price-max 250 \
  --region 广州 \
  --pages 2 \
  --requirements '找27寸戴尔显示器，价格250元以内，广州市，可正常显示；优先个人闲置、本地自提；排除坏屏/花屏/暗病/碎屏/仅配件/维修机/求购/商家批量/外地不方便交易；只做筛选分析，不自动联系卖家' \
  --limit 30
```

生成报告：

```bash
node tools/xianyu_ops.mjs report --limit 30
```

报告在：

```text
reports/<task_id>-hermes-report.md
```

## 在 Hermes 里使用

重启 Hermes 会话或 `/reset` 后，直接说需求即可，例如：

```text
用闲鱼监测帮我找广州 250 元以内的 27 寸戴尔显示器，要求正常显示，只分析不要联系卖家
```

如果 Hermes 没有自动加载 skill，可以显式说：

```text
加载 xianyu-hunter-monitor skill，然后帮我跑这个闲鱼监测任务：...
```

## 最少配置原则

这个包故意不包含：

- 登录 Cookie / 浏览器资料：`browser-data/`
- 历史任务和商品数据：`data/tasks.json`
- 通知配置里的目标/密钥
- node_modules
- 运行报告缓存

所以其他 Hermes 只需要：

1. 安装依赖。
2. 扫码登录。
3. 直接用自然语言或 CLI 创建监测任务。

## 常见问题

### 1. 搜索结果为空

先确认是否真的登录。未登录时闲鱼搜索页可能显示「登录后可以更懂你」。在 Web 面板刷新账号状态，或执行：

```bash
node tools/xianyu_ops.mjs login
```

### 2. 浏览器提示验证码/滑块

需要人工完成。不要尝试绕过验证码。

### 3. 端口 3000 被占用

```bash
node tools/xianyu_ops.mjs start --port 3010
```

打开：

```text
http://127.0.0.1:3010/
```

### 4. Hermes 找不到 skill

确认目录：

```bash
ls ~/.hermes/skills/social-media/xianyu-hunter-monitor/SKILL.md
hermes skills list | grep -i xianyu
```

然后重启 Hermes 或 `/reset`。

### 5. 安全边界

默认不自动联系卖家、不下单、不付款。任何联系卖家/交易动作都应由用户明确授权并人工确认。