---
slug: "xianyu-publish"
source_type: "skill_md"
source_url: "https://cdn.jsdelivr.net/gh/smartcat999/xianyu-publish@main/SKILL.md"
repo: "https://github.com/smartcat999/xianyu-publish"
source_file: "SKILL.md"
branch: "main"
---
---
name: xianyu-publish
description: 闲鱼（goofish.com）网页端运营自动化。用于“发闲置、编辑在架商品、上架/下架、删除宝贝、汇总买家消息、批量发布模板化”场景；重点处理表单填写、图片上传、发布与结果核验、失败重试与风控拦截提示。
---

# 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`