Skip to content

目录浏览 ​

目录浏览是 Nomu 在 Noon 卖家目录(catalog)里挂的「在售/隐藏商品一览」侧栏。它不是 Noon 后台的替代品,而是叠加在原页面上的浏览面板:保留原页面所有信息,旁边再加一块可搜索、可翻页、可改卖家状态的视图。

打开方式 ​

  • 任意页面按 Ctrl/⌘ + Shift + O(键盘快捷键)
  • 操作菜单(Action Sheet)里的「目录浏览」入口
  • popup 顶部「目录浏览」入口

打开后从屏幕侧边滑出抽屉,悬浮在原页面上方;关闭抽屉回到原页面,无导航跳转。

看什么 ​

每一行展示一个 CatalogOffer——也就是 offer/list/noon 接口返回的一条 offer:

  • 商品主图缩略图
  • 标题
  • PartnerSku
  • 货币 / 价格(若有)
  • 卖家状态 chip(在售 / 隐藏)
  • 优化建议提示(offer_issues)

按 partnerSku / 标题子串搜索;搜索框 300ms debounce 静默期后生效。

翻页与状态 ​

  • 每页 20 条
  • 抽屉打开且焦点不在输入框时,按 ← / → 翻页
  • 命中 limit 时底部显示「加载更早」按钮

状态机:

状态含义
idle初始态
no-active-store没有激活店铺 → 提示去侧边栏选
missing-store-code激活店铺缺 Noon Store Code → 提示补全
loading拉取中
ready拿到结果
error接口报错,可点「重试」

改卖家状态 ​

行内「在售 / 隐藏」开关走乐观更新——UI 立即翻转,请求失败回滚原态,请求成功重取当前页。响应里的 psku[].is_active 是权威值,写回 row 后与原 Noon 后台列表保持一致,避免状态偶尔不同步。

商品信息快速编辑 ​

每一行右侧有铅笔按钮,点开调出「商品信息快速编辑」弹窗——对单条 offer 直接改标题、价格、库存、类目、品牌等字段,提交后走 publishTask 走最小变更路径,不动其它字段。

同一能力也挂在 快捷搜索 浮层里。

与任务面板的关系 ​

目录浏览里改卖家状态是即时生效的(直接调 offer/upsert/is_active-plp),不进入 publishTask 步骤表——这是与「上架发布」不同的写路径。改了之后 100ms 之内 db.changed 推送回来,目录浏览与其它订阅同一资源的视图(如 任务面板)会同步刷新。

与复制商品的关系 ​

目录浏览只读 + 改卖家状态;要复制到当前店铺,去操作菜单里走 复制商品——独立表单、独立任务,不在目录浏览里串行。

常见问题 ​

列表是空的? ​

  • no-active-store → 还没选激活店铺
  • missing-store-code → 激活店铺的 Noon Store Code 没填,去 店铺管理 补
  • 接口报错 → 看错误提示,重试

改了卖家状态页面没变? ​

按 Cmd/⌘ + R 刷新原页面即可;Nomu 已经把变更写到 Noon,原页面只是没自动重取。