smartcat999/xianyu-publish

xianyu-publish

依赖与环境

• 必需：browser 工具
• 必需：Chrome Browser Relay（已连接）
• 必需：闲鱼网页已登录
• 默认模式：MODE: safe

概览

用于在闲鱼网页端执行从发布到基础运营的闭环：发布、编辑、上下架、删除、消息汇总。 默认先做页面状态核验，再执行动作，最后回执结果。

能力边界（v1）

• ✅ 已支持：
  • 发布新商品
  • 编辑已发布商品（描述/价格/部分属性）
  • 上架/下架
  • 删除商品（需二次确认）
  • 打开消息并汇总未读咨询
• ⚠️ 受限：
  • OS 级文件选择器弹窗不可稳定自动操控
  • 发布认证拦截需用户扫码后继续

快速决策

• 用户要发新商品 → 走“发布工作流”。
• 用户说“改下这个宝贝价格/文案” → 走“编辑工作流”。
• 用户说“先下架/重新上架” → 走“状态切换工作流”。
• 用户说“删掉这条” → 走“删除工作流（强确认）”。
• 用户说“看下有没有人问价” → 走“消息汇总工作流”。

新手模式（MODE: safe，默认）

• 触发词示例：开始闲鱼托管 / 按风控模式跑。
• 行为：先执行 Preflight 自检，再进入可执行状态。
• 默认限制：
  • 禁止直接执行高风险动作（删除、批量改价、大批量发布）
  • 敏感动作必须二次确认（确认词）
  • 连续失败自动熔断并提示人工接管

Preflight（启动自检，执行任何动作前）

1. browser 工具可用。
2. Chrome Relay 已连接到当前标签页。
3. 当前可访问 goofish.com，且账号已登录。
4. 上传能力可用（可访问 /tmp/openclaw/uploads/，图片可注入）。
5. 风控状态正常（无验证码/登录异常/接口连续报错）。

自检结果分级：

• 绿灯：直接执行任务。
• 黄灯：可继续，但先提醒风险（如首图可能需手动）。
• 红灯：停止执行，并给最短修复步骤。

工作流 A：发布新商品

1. 打开 https://www.goofish.com/publish。
2. 填文案，再填价格与发货方式。
3. 填属性（分类、年龄、性别、品种等）。
4. 上传首图并核验页面已回显（如出现“添加细节图”或缩略图）。
5. 点击发布并核验跳转成功。
6. 输出回执：已填写字段、发布结果、异常项。

工作流 B：编辑已发布商品

1. 进入个人页/在架列表，定位目标商品（标题/价格/发布时间）。
2. 打开编辑页，修改目标字段（描述、售价、原价、发货方式等）。
3. 保存并返回详情页，核验新值已生效。
4. 输出回执：改了什么、前后值、是否生效。

工作流 C：上架/下架

1. 在个人商品列表定位目标商品。
2. 下架：直接点击“下架”并确认弹窗。
3. 重新上架优先级：
   • 优先：列表中的“重新上架”按钮（若存在）；
   • 兜底：进入编辑页 https://www.goofish.com/publish?itemId=<商品ID>，点击“发布”完成重新上架。
4. 刷新列表确认状态变化（“已下架”↔“下架”按钮）。
5. 输出回执：目标商品、当前状态、使用的是主路径还是兜底路径。

工作流 D：删除商品（高风险）

1. 第一次确认：说明影响范围与不可恢复。
2. 第二次确认：要求用户输入确认词：确认删除 <商品名>。
3. 执行删除并处理确认弹窗。
4. 刷新列表确认商品已不存在。
5. 输出回执：删除结果 + 不可恢复提示。

工作流 E：消息汇总

1. 打开消息页，按未读优先查看。
2. 按“商品维度”聚合咨询：问价、是否包邮、是否在售、是否可自提。
3. 输出精简摘要，不自动发送给买家（除非用户明确要求）。

图片上传规则（关键稳定性）

• 优先程序化上传，不走系统文件选择器。
• 上传文件先放：/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