xianyu-hunter Hermes Skill 便携包

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

包内内容

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

目标效果

安装后可以对 Hermes 说：

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

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

node tools/xianyu_ops.mjs run ...

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

前置要求

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

检查：

node -v
npm -v
hermes --version

一键安装

在解压后的目录执行：

bash install.sh

默认安装到：

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

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

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

手动安装

# 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 面板

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

打开：

http://127.0.0.1:3000/

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

http://192.168.x.x:3000/

登录闲鱼/Goofish

Web 面板右上角点击：

账号登录 / Cookie

然后：

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

也可以用 CLI：

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

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

运行一次监测任务

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

生成报告：

node tools/xianyu_ops.mjs report --limit 30

报告在：

reports/<task_id>-hermes-report.md

在 Hermes 里使用

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

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

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

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

最少配置原则

这个包故意不包含：

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

所以其他 Hermes 只需要：

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

常见问题

1. 搜索结果为空

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

node tools/xianyu_ops.mjs login

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

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

3. 端口 3000 被占用

node tools/xianyu_ops.mjs start --port 3010

打开：

http://127.0.0.1:3010/

4. Hermes 找不到 skill

确认目录：

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

然后重启 Hermes 或 /reset。

5. 安全边界

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