| name | xianyu-publish |
| description | 闲鱼（goofish.com）网页端运营自动化。用于“发闲置、编辑在架商品、上架/下架、删除宝贝、汇总买家消息、批量发布模板化”场景；重点处理表单填写、图片上传、发布与结果核验、失败重试与风控拦截提示。 |
xianyu-publish
依赖与环境
- 必需：
browser 工具
- 必需：Chrome Browser Relay（已连接）
- 必需：闲鱼网页已登录
- 默认模式：
MODE: safe
概览
用于在闲鱼网页端执行从发布到基础运营的闭环：发布、编辑、上下架、删除、消息汇总。
默认先做页面状态核验，再执行动作，最后回执结果。
能力边界（v1）
- ✅ 已支持：
- 发布新商品
- 编辑已发布商品（描述/价格/部分属性）
- 上架/下架
- 删除商品（需二次确认）
- 打开消息并汇总未读咨询
- ⚠️ 受限：
- OS 级文件选择器弹窗不可稳定自动操控
- 发布认证拦截需用户扫码后继续
快速决策
- 用户要发新商品 → 走“发布工作流”。
- 用户说“改下这个宝贝价格/文案” → 走“编辑工作流”。
- 用户说“先下架/重新上架” → 走“状态切换工作流”。
- 用户说“删掉这条” → 走“删除工作流（强确认）”。
- 用户说“看下有没有人问价” → 走“消息汇总工作流”。
新手模式（MODE: safe，默认）
- 触发词示例：
开始闲鱼托管 / 按风控模式跑。
- 行为：先执行 Preflight 自检，再进入可执行状态。
- 默认限制：
- 禁止直接执行高风险动作（删除、批量改价、大批量发布）
- 敏感动作必须二次确认（确认词）
- 连续失败自动熔断并提示人工接管
Preflight（启动自检，执行任何动作前）
- browser 工具可用。
- Chrome Relay 已连接到当前标签页。
- 当前可访问 goofish.com，且账号已登录。
- 上传能力可用（可访问
/tmp/openclaw/uploads/，图片可注入）。
- 风控状态正常（无验证码/登录异常/接口连续报错）。
自检结果分级：
- 绿灯：直接执行任务。
- 黄灯：可继续，但先提醒风险（如首图可能需手动）。
- 红灯：停止执行，并给最短修复步骤。
工作流 A：发布新商品
- 打开
https://www.goofish.com/publish。
- 填文案，再填价格与发货方式。
- 填属性（分类、年龄、性别、品种等）。
- 上传首图并核验页面已回显（如出现“添加细节图”或缩略图）。
- 点击发布并核验跳转成功。
- 输出回执：已填写字段、发布结果、异常项。
工作流 B：编辑已发布商品
- 进入个人页/在架列表，定位目标商品（标题/价格/发布时间）。
- 打开编辑页，修改目标字段（描述、售价、原价、发货方式等）。
- 保存并返回详情页，核验新值已生效。
- 输出回执：改了什么、前后值、是否生效。
工作流 C：上架/下架
- 在个人商品列表定位目标商品。
- 下架：直接点击“下架”并确认弹窗。
- 重新上架优先级：
- 优先：列表中的“重新上架”按钮（若存在）；
- 兜底：进入编辑页
https://www.goofish.com/publish?itemId=<商品ID>，点击“发布”完成重新上架。
- 刷新列表确认状态变化（“已下架”↔“下架”按钮）。
- 输出回执：目标商品、当前状态、使用的是主路径还是兜底路径。
工作流 D：删除商品（高风险）
- 第一次确认：说明影响范围与不可恢复。
- 第二次确认：要求用户输入确认词：
确认删除 <商品名>。
- 执行删除并处理确认弹窗。
- 刷新列表确认商品已不存在。
- 输出回执：删除结果 + 不可恢复提示。
工作流 E：消息汇总
- 打开消息页，按未读优先查看。
- 按“商品维度”聚合咨询：问价、是否包邮、是否在售、是否可自提。
- 输出精简摘要，不自动发送给买家（除非用户明确要求）。
图片上传规则（关键稳定性）
- 优先程序化上传，不走系统文件选择器。
- 上传文件先放：
/tmp/openclaw/uploads/。
- 若触发系统文件选择弹窗：让用户先取消，再重试程序化上传。
- 上传后必须做页面回显核验；仅
upload ok 不算成功。
失败处理
- 发布按钮无效/无跳转：检查必填项（图片、属性、价格）；若用于“重新上架”，优先改走
publish?itemId= 编辑页再发布。
- 属性被页面回写：发布前最后一步再核对并重填。
- 上传成功但未挂图：重试注入；仍失败则用户手动首图，自动化接管后续。
- 认证拦截：提示用户扫码认证，完成后继续。
风控守则（默认启用）
- 节奏控制：关键动作（发布/下架/重新上架/改价）之间至少间隔 15-30 秒。
- 频次上限（建议值）：
- 发布：≤ 5 次/小时
- 改价：≤ 8 次/小时
- 上下架：≤ 6 次/小时
- 连续失败熔断：同类动作连续失败 2 次即暂停自动化，改为人工确认后再继续。
- 文案去重：批量发布时，标题/描述至少做轻微差异化，避免高重复。
- 图片策略：避免短时间重复上传同一张首图到多条商品。
- 环境稳定：尽量固定登录环境（设备/IP/浏览器），避免频繁切换。
- 异常停手：出现验证码、登录异常、接口异常等风控信号时，立即停止高频重试。
对话规范
- 执行前一次性收集参数，减少来回确认。
- 高风险操作（删除、改价幅度大）必须确认。
- 结果回执必须短、准：已完成/未完成/阻塞项/下一步。
参考
- v1 功能路线：
references/feature-roadmap.md
- v1 实操清单：
references/v1-runbook.md
- 新手一键启动：
references/quickstart-safe-mode.md
