qfc-order AgentSkill（稳健版 v3：支持滚动加载、数量选择、缺货替代品/搜索变体、购物车确认）

描述

自动化 QFC（qfc.com）杂货自提订单：从 grocery-list 中可靠地将商品添加至购物车，并预约自提时段。
使用 browser 工具，配置 profile=chrome（用户需提前附加已登录的 Chrome 标签页）。
不存储任何凭据——登录由用户自行完成。

触发词（调用短语）

• qfc order
• place qfc pickup
• grocery order qfc
• shop qfc

前置条件

1. 用户已登录 qfc.com（Kroger 账户）。
2. 导航至 Pickup 页面，并选择门店/位置。
3. 在该标签页上点击 OpenClaw Browser Relay 工具栏按钮（徽章变为 ON/绿色）。
4. 确保 grocery-list 技能中存在未勾选的商品（可先调用 “grocery list” 查看）。
5. 调用本技能：“Place QFC order”

持久化状态

优化工作流（最小快照数、基于 ARIA 的引用、高可靠性添加）

被调用时执行以下步骤：

1. 验证与关键引用提取

browser action=status profile=chrome

• 若返回结果中不含 cdpReady: true：提示用户附加 Chrome 标签页。

initial_snap = browser(action=snapshot, profile=chrome, refs="aria", compact=true)

从中提取：

search_ref = initial_snap.ref_for(role="searchbox")  # 或 aria-label="Search"
cart_ref = initial_snap.ref_for(role="button", name~="Cart" || aria-label~="cart")

2. 加载并确认杂货清单

glist = read(path="skills/grocery-list/grocery-list.json")
items = glist.items.filter(item => !item.checked)

回复：“正在添加 ${items.length} 件商品：${items.map(i=>i.name).join(', ')}. 是否继续？” 等待用户输入“yes”。

3. 确保处于商店浏览页

• 若 initial_snap 显示为门店选择页或无搜索框：根据 state 或用户输入选择门店，并执行
  browser action=navigate targetUrl="https://www.qfc.com/shop.html" profile=chrome
• 必要时重新执行快照。

4. 商品添加循环（稳健设计：多关键词搜索、滚动加载、数量调整、缺货替代方案）

added = [], skipped = [], notes = []
for item in items:
  success = false
  search_terms = [
    `${item.qty || '1'} ${item.unit || ''} ${item.name}`.trim(),
    item.name,
    (item.unit ? `${item.unit} ${item.name.split(' ')[0]}` : null),
    item.name.toLowerCase().replace(/kroger|private selection/gi, '').trim()
  ].filter(Boolean).slice(0,3)

  for sterm in search_terms:
    if success: break
    # 清空并执行搜索
    browser(action="act", profile=chrome, request={kind:"type", ref:search_ref, text:""})
    browser(action="act", profile=chrome, request={kind:"type", ref:search_ref, text:sterm})
    browser(action="act", profile=chrome, request={kind:"press", ref:search_ref, key:"Enter"})
    
    # 滚动到底部以加载全部结果
    browser(action="act", profile=chrome, request={kind:"evaluate", fn:"window.scrollTo(0, document.body.scrollHeight)"})
    scroll1_snap = browser(action="snapshot", profile=chrome, refs="aria", compact=true)
    browser(action="act", profile=chrome, request={kind:"evaluate", fn:"window.scrollTo(0, document.body.scrollHeight)"})
    results_snap = browser(action="snapshot", profile=chrome, refs="aria", compact=true)
    
    # 查找最匹配的商品
    prod_matches = results_snap.find_all(role~="article|listitem", name~item.name.split(' ')[0], max=5)
    for prod_ref in prod_matches:
      add_ref = results_snap.ref_for(role="button", name~="Add|+", ancestor=prod_ref)
      oos = results_snap.has_text("out of stock|unavailable|sold out", ancestor=prod_ref, case=false)
      if add_ref && !oos:
        browser(action="act", profile=chrome, request={kind:"click", ref:add_ref})
        # 数量选择/调整
        qty_snap = browser(action="snapshot", profile=chrome, refs="aria")
        qty_plus_ref = qty_snap.ref_for(role="button", name="+" || aria~="increase")
        qty_needed = parseFloat(item.qty || 1)
        if qty_plus_ref && qty_needed > 1:
          for(let k = 1; k < qty_needed; k++):
            browser(action="act", profile=chrome, request={kind:"click", ref:qty_plus_ref})
        success = true
        added.push(item)
        notes.push(`Added via "${sterm}": ${item.name} x${item.qty}`)
        break
  if !success:
    skipped.push(item)
    notes.push(`Skipped ${item.name}: no suitable product/OOS (tried ${search_terms.join(', ')})`)
  
  # 每处理 3+ 个商品后汇报进度
  if (added.length + skipped.length) % 3 == 0:
    Reply: `Progress: ${added.length}/${items.length} (${notes.slice(-3).join('; ')})`

最终回复：Added ${added.length}/${items.length}. ${notes.join('; ')}

5. 购物车确认（详细信息）

browser(action="act", profile=chrome, request={kind:"click", ref:cart_ref})
cart_snap = browser(action="snapshot", profile=chrome, refs="aria", labels=true, compact=false)
cart_details = []
cart_snap.find_all(role~="listitem|tr").slice(0,20).forEach( itemref => {
  let name = cart_snap.text_for(itemref).trim().slice(0,60)
  if (name && !name.includes('Subtotal')):  # 过滤掉小计等非商品行
    let qtyref = cart_snap.ref_for(role~="spinbutton|input", ancestor=itemref, name~="Qty")
    let qty = qtyref ? qtyref.value : '1'
    let price = cart_snap.text_for(role~="price", ancestor=itemref) || ''
    cart_details.push(`${name} x${qty} ${price}`)
})
total_str = cart_snap.text_for(role~="total|subtotal strong") || 'N/A'

回复：**Cart Review:**\n${cart_details.join('\n')}\n**Total:** ${total_str}\n\n**Skipped:** ${skipped.map(s=>s.name).join(', ')}\nProceed to slots?

6. 预约自提时段

（同 v2 版本）

7. 最终审核与下单后操作

（同 v2 版本，更新清单状态）

工具调用模式

同 v2 版本。

提示与注意事项

• 滚动：两次滚动到底部 + 快照，确保完整加载搜索结果。
• 缺货替代方案：多关键词搜索自动尝试不同变体及通用名称。
• 数量：添加后自动执行“+”按钮点击（假设数量调节控件为弹出式）。
• 购物车确认：提取含数量与价格的商品列表供用户复核。
• 回退机制：若无 ARIA 属性，则使用 role + name 组合定位；如需语义理解，可设 snapshotFormat=ai。
• 最小快照数：每件商品约 3–5 次快照（搜索 + 滚动 + 数量调节），外加购物车与时段页快照。
• 已测试：已在 openclaw profile 上完成干运行（参见日志）。

已达到发布就绪标准：可稳定应对各类边界情况。