xianyu-auto-reply-fix/docs/usage.md

使用指南

返回：README ｜ 相关：部署与运行指南 ｜ 配置说明 ｜ 常见问题

基本流程

1. 登录 Web 管理后台。
2. 添加闲鱼账号 Cookie 或登录信息。
3. 配置关键词回复、默认回复或 AI 回复。
4. 按需配置自动发货规则。
5. 启动账号监听，在日志和账号状态中观察运行情况。

用户注册

• 若系统已开启注册功能，可访问登录页或注册页（如本地运行使用 http://localhost:8090/register.html）。
• 填写用户信息，完成邮箱验证。
• 根据系统配置完成图形验证码校验。

添加闲鱼账号

• 登录系统后进入主界面。
• 进入账号管理，添加新账号。
• 输入账号 ID 和 Cookie 信息。
• 可按需配置用户名、密码、备注和显示浏览器。
• 保存后即可启用或刷新账号。

浏览器画像与滑块恢复说明

• token_refresh 命中滑块时，程序会优先复用 browser_data/user_<账号ID> 下的账号级浏览器画像和站点状态。
• 自动滑块反复失败时，可设置 XY_ENABLE_AUTO_SLIDER=0 启用人工接管；浏览器会保持可见，并在人工验证成功时立即保存 Cookie。等待时长可通过 XY_MANUAL_SLIDER_TIMEOUT 调整。
• 各账号各用各的 browser_data/user_<账号ID> 目录，不共享浏览器状态。
• 同账号如果同时撞上滑块，会按现有并发保护排队，不会自己跟自己抢 profile。
• 这套账号级 persistent profile 优先策略目前只挂在 token_refresh 的滑块恢复链上，不会把正常消息监听、订单处理、手动导入 Cookie 主链一锅端改掉。
• browser_data/ 属于运行期状态目录，不建议随意清空；旧 Cookie 的自动滑块恢复依赖这里面的持久化状态。
• 如果账号级 profile 因异常退出残留 Chromium SingletonLock，程序只会在确认它是“当前宿主机 + 已失效 PID”，或“Docker 容器 hostname 漂移导致的旧容器 ID 锁”时自动清理并重试；拿不准就继续走旧 fallback，不乱删锁。

使用商品擦亮

• 在账号管理页可直接执行一键擦亮，批量处理当前账号在售商品。
• 可按账号配置每日定时擦亮任务，支持执行时段和随机延迟。

配置自动回复

• 关键词回复：设置通用关键词和商品专属关键词。
• AI 回复：配置兼容模型接口启用智能回复。
• 默认回复：设置未匹配时的默认回复。
• 指定商品回复：为特定商品设置专门回复内容。

回复优先级：指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI 回复。

过滤 AI 准备发送的回复

消息过滤规则的“消息来源”可以选择 AI 准备发送的回复。AI 生成文本后、消息真正发送前，系统会再次使用这些规则检查回复内容：

• 仅启用“通知人工”时，系统执行通知动作，当前 AI 回复仍会发送。
• 启用“跳过自动回复”或“跳过 AI 回复”时，当前 AI 回复不会发送。
• 选择“全部消息”的规则也会匹配 AI 准备发送的回复。

该检查只作用于 AI 回复，不改变关键词回复、默认回复和指定商品回复的优先级。

设置自动发货

• 添加卡券和发货规则，配置商品与发货内容的匹配关系。
• 支持文本、批量数据、API、图片等发货方式。
• 系统检测到付款消息或小刀卡片后自动触发发货流程。