feat: publish xianyu hunter hermes skill package

README.md

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