xianyu-hunter-hermes-skill/skill/xianyu-hunter-monitor/references/hermes-main-control-refactor-2026-05.md

Hermes 主控重构记录（2026-05）

背景

BOSS 明确希望闲鱼采集项目由 Hermes 直接操作：登录检查、创建任务、分析结果、定时执行；Web UI 仅作为备用渠道。

当前本地项目定位

工作目录：

/Users/chick/.Hermes/workspace/research/xianyu-hunter

当前模式：

• Hermes 是主控入口。
• Web UI 仅备用查看。
• 项目不需要配置 AI API / API Key / 模型。
• 项目不会自动联系卖家、不会聊天、不会询价。
• 项目只负责：搜索采集、详情采集、本地保守预筛、持久化结果。
• 深度判断由 Hermes 根据 data/tasks.json 或报告完成。

新增/主要入口

统一 CLI：

node tools/xianyu_ops.mjs <command>

命令：

node tools/xianyu_ops.mjs status --port 3000
node tools/xianyu_ops.mjs start --port 3000
node tools/xianyu_ops.mjs stop
node tools/xianyu_ops.mjs login
node tools/xianyu_ops.mjs create --name '<任务名>' --queries '<关键词1,关键词2>' --requirements '<需求>'
node tools/xianyu_ops.mjs run --name '<任务名>' --queries '<关键词1,关键词2>' --requirements '<需求>' --limit 30
node tools/xianyu_ops.mjs report --task <task_id> --limit 30

run 会：检查/启动服务 → 创建任务 → 等待完成 → 生成报告。

报告与定时

报告脚本：

node tools/hermes_report.mjs --task <task_id> --limit 30

报告输出：

reports/<task_id>-hermes-report.md

定时任务提示模板：

tools/cron_prompt_template.md

定时任务要显式声明：不联系卖家、不下单、不承诺交易；如遇登录/验证码，报告需要人工处理，不绕过验证。

已验证

已做语法检查：

node --check server.mjs
node --check lib/task.mjs
node --check lib/filter.mjs
node --check public/app.js
node --check tools/xianyu_ops.mjs
node --check tools/hermes_report.mjs

已验证服务可启动：

node tools/xianyu_ops.mjs start --port 3000
node tools/xianyu_ops.mjs status --port 3000

注意：真实闲鱼端到端采集仍取决于账号登录状态、验证码和 Goofish DOM 选择器是否仍有效。

未来会话触发语

用户说以下任意内容时，应加载 xianyu-hunter-monitor：

• “帮我监测闲鱼 …”
• “蹲一下闲鱼 …”
• “分析最新闲鱼采集结果”
• “检查闲鱼登录状态”
• “启动闲鱼助手”
• “每 X 小时监测 …”

优先用 tools/xianyu_ops.mjs，不要让 BOSS 手动打开 Web 除非需要查看或排错。