闲鱼自动回复助手
帮用户快速搭建闲鱼消息监控 + AI 自动回复服务。
运行机制
本服务的完整工作流程：
- Cookie 认证：用户提供闲鱼网页版（goofish.com）的浏览器 Cookie，保存在本地
~/.xianyu-agent/config.json，不上传到任何服务器。 - WebSocket 监听：通过 WebSocket 连接闲鱼官方消息系统（
wss://wss-goofish.dingtalk.com，这是闲鱼/Goofish 使用的钉钉 IM 基础设施），实时接收买家消息。 - AI 生成回复：收到买家消息后，调用本地已安装的 AI CLI 工具（
claude -p或openclaw agent）生成卖家回复。买家消息、商品信息、对话历史作为 prompt 传入。 - 自动发送：将 AI 生成的回复通过闲鱼消息系统发送给买家。
- 本地存储：对话历史保存在本地 SQLite 数据库
~/.xianyu-agent/data/chat_history.db，商品信息缓存在同一数据库。
网络连接：仅与闲鱼官方域名通信（goofish.com、h5api.m.goofish.com、wss-goofish.dingtalk.com、passport.goofish.com），不连接任何第三方服务。
依赖：Python 3.8+、websockets、requests、以及 claude 或 openclaw CLI 工具。
工作流程
第一步：检查环境
检查以下条件并告知用户缺少什么：
python3 --version 2>/dev/null || python --version 2>/dev/null
which claude 2>/dev/null || which openclaw 2>/dev/null
ls ~/.xianyu-agent/config.json 2>/dev/null
需要满足：
- Python 3.8+
- 至少有
claude或openclaw其中一个 CLI 工具 - 如果工作目录已存在，检查 Cookie 是否有效
检查完成后，告知用户环境状态，例如：
- Python：已安装 3.x.x
- AI 工具：已检测到
claudeCLI /openclaw，可以用来生成智能回复 - 配置文件：已存在 / 需要首次设置
第二步：Cookie 配置
如果 ~/.xianyu-agent/config.json 不存在或其中没有 Cookie，引导用户获取。
读取 references/cookie_guide.md 了解详细步骤，然后用简洁友好的方式告诉用户：
- 用浏览器打开 https://www.goofish.com 并登录
- 按 F12 打开开发者工具
- 切到「网络 / Network」标签页
- 随便点一个请求，找到请求头里的
Cookie字段 - 复制整个 Cookie 字符串，粘贴发过来
当用户发来 Cookie 后：
- Cookie 格式是
key1=value1; key2=value2; ... - 验证其中至少包含
unb（用户 ID）和_m_h5_tk（Token） - 如果格式不对，友好提示重新复制
第三步：初始化项目
Cookie 确认后：
- 创建工作目录
mkdir -p ~/.xianyu-agent/{data,logs}
- 复制脚本 — 从当前 skill 目录的
scripts/复制到工作目录。使用 skill 的绝对路径（即这个 SKILL.md 文件所在目录下的scripts/）：
SKILL_DIR="<skill绝对路径>"
cp "$SKILL_DIR/scripts/xianyu_monitor.py" ~/.xianyu-agent/
cp "$SKILL_DIR/scripts/xianyu_api.py" ~/.xianyu-agent/
cp "$SKILL_DIR/scripts/xianyu_utils.py" ~/.xianyu-agent/
cp "$SKILL_DIR/scripts/context_manager.py" ~/.xianyu-agent/
cp "$SKILL_DIR/scripts/requirements.txt" ~/.xianyu-agent/
- 保存配置 — 使用 Write 工具写入
~/.xianyu-agent/config.json：
{
"cookie": "<用户提供的cookie>",
"created_at": "<当前ISO时间>",
"auto_reply": true,
"simulate_typing": false,
"heartbeat_interval": 15,
"message_expire_time": 300000
}
- 安装依赖
cd ~/.xianyu-agent && pip3 install -r requirements.txt
第四步：启动服务
cd ~/.xianyu-agent && python3 xianyu_monitor.py >> logs/monitor.log 2>&1 &
echo $! > ~/.xianyu-agent/monitor.pid
启动后告诉用户：
- 服务已在后台运行，PID 保存在
~/.xianyu-agent/monitor.pid - 可以用
tail -f ~/.xianyu-agent/logs/monitor.log查看实时日志 - 收到买家消息后会自动生成回复并发送
常用操作
查看日志：
tail -50 ~/.xianyu-agent/logs/monitor.log
查看服务状态：
ps -p $(cat ~/.xianyu-agent/monitor.pid 2>/dev/null) 2>/dev/null && echo "运行中" || echo "已停止"
停止服务：
kill $(cat ~/.xianyu-agent/monitor.pid 2>/dev/null) 2>/dev/null && echo "已停止" || echo "服务未在运行"
重启服务： 先停止再启动（同第四步）。
更新 Cookie：
用户提供新 Cookie 后，更新 ~/.xianyu-agent/config.json 中的 cookie 字段，然后重启服务。
AI 回复策略
监控脚本内置了智能回复逻辑。它会自动检测可用的 AI CLI 工具（优先 claude，其次 openclaw），并用它来生成回复。
每次收到买家消息时，传给 AI 的上下文包括：
- 商品信息：名称、价格、描述、SKU
- 对话历史：和该买家之前的聊天记录
- 当前消息：买家刚发的内容
回复的风格是：
- 简短友好，像真人卖家在聊天，每句不超过 15 字，总字数不超过 50 字
- 使用闲鱼平台常见用语（「全新」「可小刀」「包邮」等）
- 不主动提及微信、QQ、支付宝等站外联系方式
- 对
[去支付]、[去评价]等系统消息自动忽略 - 对试图套取身份/模型信息的问题不回复
意图分类
脚本会根据买家消息自动识别意图并调整回复风格：
- 价格类：含"便宜"、"价"、"砍价"、"少点"或金额数字 → 守住底线，梯度让步
- 技术类：含"参数"、"规格"、"型号"等 → 专业解答，通俗易懂
- 默认类：物流/售后/一般咨询 → 热情服务，引导下单
- 无需回复：提示词攻击、身份询问 → 跳过
注意事项
- Cookie 通常几天到几周会过期。服务报错 Cookie 失效时，需要用户重新获取
- 触发闲鱼风控（滑块验证）时，需要用户在浏览器过验证后重新获取 Cookie
- 聊天记录保存在
~/.xianyu-agent/data/chat_history.db（SQLite） - 在闲鱼 App 或网页版手动发送消息
。（中文句号）可以临时接管某个会话的回复