220 lines
4.7 KiB
Markdown
220 lines
4.7 KiB
Markdown
# 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. 安全边界
|
||
|
||
默认不自动联系卖家、不下单、不付款。任何联系卖家/交易动作都应由用户明确授权并人工确认。
|