@seasonkoh/webaz 0.1.28 → 0.1.30

package/dist/pwa/public/app-direct-pay.js

@@ -0,0 +1,226 @@
+// Direct Pay (Rail 1) — bilingual UI wiring (PR-4f-b / 5c)。UI ONLY;直付(direct_p2p)可用性 per-seller/product 实时数据驱动(见 GET /api/direct-pay/availability);注:escrow 轨仍模拟 WAZ(独立开关 _wazSimulated,非直付)。
+//   WebAZ【不托管本金】、不担保、不退款/维权,也不验证/路由卖家付款方式或币种;不做 USDC/fiat/PSP/链上、不碰
+//   wallet/escrow/settlement/refund/订单钱路。真实强制全在后端(#92/#93 两次披露 + 现场真人 Passkey 硬门控;前端只带输入)。
+//   只把已合并后端能力(#96 收款说明、#94 建单、#92/#93 ack+Passkey、#98+ 控制面/可用性)接到 PWA。
+//   面向用户中文文案走 t(),英文在 i18n.js _EN(双语 parity 由 test-direct-pay-ui.ts 守)。
+
+// ── 错误码 → 双语文案(后端返回的 error_code → 清楚的中英文提示)──────────────────────────────
+window.dpErrorText = (code, fallback) => {
+  const M = {
+    DIRECT_PAY_DISABLED: t('直付当前未开放'),
+    DIRECT_PAY_RAIL_BREAKER: t('直付暂停受理(运营维护中),请稍后再试'),
+    DIRECT_PAY_REGION_UNSUPPORTED: t('直付在你所在地区暂未开放'),
+    DIRECT_PAY_CAP_EXCEEDED: t('超出直付单笔上限(按 WebAZ 记录的订单金额计;不涉及你与卖家场外实际付款金额)'),
+    DIRECT_PAY_SELLER_NOT_ELIGIBLE: t('该卖家暂不支持直付'),
+    DIRECT_PAY_SELLER_SUSPENDED: t('该卖家直付已被暂停'),
+    DISCLOSURE_NOT_ACKED: t('需先完成两次风险披露确认(D1 + D2)'),
+    HUMAN_PRESENCE_REQUIRED: t('需现场真人 Passkey 确认'),
+    PASSKEY_REQUIRED_FOR_DIRECT_PAY: t('直付需要先注册 Passkey'),
+    NO_PAYMENT_INSTRUCTION: t('卖家尚未设置收款说明,暂不可直付'),
+    DIRECT_PAY_NOT_AVAILABLE: t('该卖家暂不支持直付'),
+    DIRECT_PAY_KYC_REQUIRED: t('该卖家暂不支持直付'),  // 对买家脱敏:不暴露卖家 KYC/制裁具体状态
+    ORDER_NOT_DELIVERED: t('订单尚未送达,暂不可确认收货'),
+    DIRECT_PAY_SIMPLE_PRODUCT_ONLY: t('直付当前仅支持简单商品(无规格)'),
+    DIRECT_PAY_UNSUPPORTED_OPTION: t('直付当前不支持该下单选项'),
+  }
+  return M[code] || (window.orderErrorLookup && window.orderErrorLookup(code)) || fallback || t('操作失败,请重试')  // 回退查订单错误码表(NOT_ORDER_BUYER 等披露/动作码)
+}
+
+// ── 买家结算:支付方式(rail)选择。escrow 默认;direct_p2p 可选,选中先查可用性(见 dpOnRailChange);D1/D2 ack 在建单后用 Passkey 完成。
+window.dpRailSelectorHtml = (productId, priceUsdc) => `
+  <details style="margin-top:10px" id="dp-rail-block" data-product="${productId || ''}" data-amt="${priceUsdc != null && isFinite(Number(priceUsdc)) ? Number(priceUsdc) : ''}">
+    <summary style="font-size:13px;font-weight:600;color:#374151;cursor:pointer">${t('支付方式')}</summary>
+    <div style="padding:8px 2px 2px">
+      <label style="display:flex;gap:8px;align-items:flex-start;font-size:13px;margin-bottom:6px;cursor:pointer">
+        <input type="radio" name="dp-rail" value="escrow" ${window._wazSimulated ? '' : 'checked'} onchange="dpOnRailChange('${productId || ''}')">
+        <span><b>${window._wazSimulated ? t('托管(Escrow,模拟测试币)') : t('托管(Escrow,默认)')}</b><br><span style="font-size:11px;color:#6b7280">${t('本金由协议托管,确认收货后释放给卖家')}</span></span>
+      </label>
+      <label style="display:flex;gap:8px;align-items:flex-start;font-size:13px;cursor:pointer">
+        <input type="radio" name="dp-rail" value="direct_p2p" onchange="dpOnRailChange('${productId || ''}')">
+        <span><b>${t('直付(Direct Pay · 非托管)')}</b><br><span style="font-size:11px;color:#6b7280">${t('你直接付款给卖家(场外),本金不经 WebAZ')}</span></span>
+      </label>
+      <div id="dp-rail-note" style="display:none;margin-top:8px;font-size:11px;line-height:1.6;color:#92400e;background:#fffbeb;border:1px solid #fde68a;border-radius:8px;padding:8px 10px">
+        ⚠️ ${t('直付风险提醒:非担保交易 —— WebAZ 不托管本金、无退款能力、不代维权,也不验证卖家的付款方式或币种,仅对卖家有信誉处罚权。下单后需用 Passkey 完成两次风险确认,再标记付款。')}
+        <div style="margin-top:6px">${t('需要 Passkey。')}<a href="#me" style="color:#854d0e;font-weight:600;text-decoration:underline">${t('前往「我的 → 安全与存储」注册 →')}</a></div>
+      </div>
+      <div id="dp-rail-unavailable" style="display:none;margin-top:8px;font-size:11px;line-height:1.6;color:#991b1b;background:#fef2f2;border:1px solid #fecaca;border-radius:8px;padding:8px 10px"></div><div id="dp-account-picker"></div>
+    </div>
+  </details>`
+
+// 选直付先查 /direct-pay/availability(与建单门同源):available=true 才展示风险提醒+允许继续;否则用 dpErrorText 显示明确不可用原因(非系统错误/不裸露 JSON)并退回托管轨,阻止进入直付建单。
+window.dpOnRailChange = async (productId) => {
+  const note = document.getElementById('dp-rail-note'); window._dpDirectAvailable = false  // 进入即 pending:确认前 dpSelectedRail 只输出 escrow(防"选直付后立刻点确认"竞态)
+  const un = document.getElementById('dp-rail-unavailable')
+  if (note) note.style.display = 'none'
+  if (un) un.style.display = 'none'; { const _pk = document.getElementById('dp-account-picker'); if (_pk) _pk.innerHTML = '' }  // D3:切轨/不可用即清空账号选择器
+  const _sel = document.querySelector('input[name="dp-rail"]:checked')?.value; if (window.wazEscrowRailNote) window.wazEscrowRailNote(_sel); if (_sel !== 'direct_p2p') return  // [PRELAUNCH-WAZ-SIM] 选 escrow→测试币提醒
+  let av = null
+  try { av = await GET('/direct-pay/availability?product_id=' + encodeURIComponent(productId || '')) } catch { av = null }
+  if (av && av.available === true) { window._dpDirectAvailable = true; if (note) note.style.display = ''; if (window.dpLoadBuyerAccounts) window.dpLoadBuyerAccounts(productId); return }  // D3:可用时加载卖家可选收款账号
+  if (un) { un.textContent = '⚠️ ' + window.dpErrorText(av && av.error_code, av && av.reason) ; un.style.display = '' }  // 不可用:明确原因 + 退回 escrow
+  const esc = document.querySelector('input[name="dp-rail"][value="escrow"]')
+  if (esc) { esc.checked = true; if (window.wazEscrowRailNote) window.wazEscrowRailNote('escrow') }  // [PRELAUNCH-WAZ-SIM] 直付不可用退回 escrow 时也提醒测试币
+}
+
+// 只有 availability 已确认 available:true(window._dpDirectAvailable)才输出 direct_p2p;pending/unavailable → escrow(竞态下确认只会下 escrow 单,绝不发 direct_p2p create)。
+window.dpSelectedRail = () => { const c = document.querySelector('input[name="dp-rail"]:checked')?.value; if (c === 'direct_p2p') return window._dpDirectAvailable === true ? 'direct_p2p' : ''; return c === 'escrow' ? 'escrow' : (window._wazSimulated ? '' : 'escrow') }  // #28 直付选中但未确认→''(永不静默回退 escrow,不分模拟);[PRELAUNCH-WAZ-SIM] 模拟期未选→''
+
+// ── 建单成功后(direct_p2p):D1/D2 披露 ack(各一次 Passkey)→ ack 后才展示快照收款说明 → 跳订单页。res=POST /orders 返回;有错则双语提示并停。
+window.dpAfterCreate = async (res) => {
+  if (!res || res.error || res.error_code) {
+    const m = window.dpErrorText(res?.error_code, res?.error)
+    if (typeof toast$ === 'function') toast$(m, 'error'); else alert(m)
+    return
+  }
+  const orderId = res.order_id
+  // 边界:必须【先】完成 D1/D2 + Passkey,之后【才】展示卖家收款说明(快照)。未完成则不展示,留到订单页继续。
+  const acked = await window.dpEnsureAcks(orderId)
+  if (!acked) {
+    if (typeof toast$ === 'function') toast$(t('需完成 D1/D2 Passkey 风险确认后才显示收款说明 · 可在订单页继续'), 'info')
+    setTimeout(() => navigate(`#order/${orderId}`), 600)
+    return
+  }
+  // 两次披露已 ack —— 收款说明【不】来自 create 响应(后端在 both-acked 前不下发);现在才 GET 订单读取 redaction-gated 快照。
+  //   【先落订单页,融合付款弹窗叠在其上】:订单页本身有收款信息+对账卡+自动隐藏倒计时,所以无论用户点按钮、点遮罩还是
+  //   按 ESC 关掉弹窗,都留在订单页而非产品页 —— 杜绝"关弹窗后失联→重复下单"(审计:弹窗被 overlay/ESC 关会 strand)。
+  const o = await GET(`/orders/${orderId}`)
+  navigate(`#order/${orderId}`)
+  if (o && o.order && window.dpShowPaymentModal) setTimeout(() => window.dpShowPaymentModal(o.order), 120)   // 等订单页渲染后叠弹窗
+}
+// ── 确保两次披露都已 ack。两屏文本各自展示确认(证据不减);缺两个 → 一次 Passkey ceremony 覆盖(stage:'both',首单
+//    3→2,2026-07-04 决策),缺一个 → 单独 ceremony。会话缓存 _dpAcked:both 过的单热路径(mark_paid/confirm)不再重复 2 GET;
+//    后端 requireBothDisclosuresAcked 仍硬门。懒取金额:仅 D2 将展示才 GET 订单。──
+window.dpEnsureAcks = async (orderId) => {
+  if (window._dpAcked && window._dpAcked[orderId]) return true
+  const st = await GET(`/direct-pay/disclosure-acks/${orderId}`)
+  if (st.error) { if (typeof toast$ === 'function') toast$(window.dpErrorText(st.error_code, st.error), 'error'); return false }
+  const cache = () => { (window._dpAcked = window._dpAcked || {})[orderId] = true; return true }
+  if (st.both === true) return cache()
+  const disc = st.disclosures || {}
+  const missing = ['pre_select', 'pre_confirm'].filter(k => !(st.acked && st.acked[k]))
+  let _pay = ''
+  if (missing.includes('pre_confirm')) { try { const _od = await GET(`/orders/${orderId}`); if (_od && _od.order) _pay = window.dpPayAmountText(_od.order) } catch {} }
+  for (let i = 0; i < missing.length; i++) {
+    const key = missing[i], tx = key === 'pre_select' ? disc.pre_select : disc.pre_confirm
+    const body = (tx ? (window._lang === 'en' ? tx.en : tx.zh) : t('风险披露')) + (key === 'pre_confirm' && _pay ? `\n\n💸 ${_pay}` : '')
+    const go = await confirmModal(`${body}\n\n${t('我已阅读并理解上述风险')}`, i === missing.length - 1 ? t('了解直接付款(需 Passkey)') : t('下一步'), { danger: true })
+    if (!go) return false
+  }
+  const ok = await window.dpDoAck(orderId, missing.length === 2 ? 'both' : missing[0])
+  return ok ? cache() : false
+}
+// Passkey 门失败:仅【确实未注册】(后端 NO_PASSKEY_REGISTERED,由 requestPasskeyGate 透传到 err.code)才引导注册;
+//   已注册但取消/设备不支持/超时(含 navigator DOMException,其 .code 是 legacy 数字非本值)→ 仅本地化"请重试",
+//   不导注册(修用户反馈:已注册者被重复提醒)、不把英文 DOMException 文案 toast 给中文用户(bilingual)。全部 5 调用点传 err 对象。
+window.dpPromptRegisterPasskey = async (err) => {
+  if (!(err && typeof err === 'object' && err.code === 'NO_PASSKEY_REGISTERED')) { if (typeof toast$ === 'function') toast$(t('验证未完成,请重试'), 'info'); return }
+  if (await confirmModal(t('直付的风险确认与付款标记需要 Passkey。你还没有注册 Passkey,前往「我的 → 安全与存储」注册一个?'), t('前往注册 Passkey'), {})) navigate('#me')
+}
+// 单次披露 ack:Passkey ceremony(purpose=direct_pay_disclosure_ack,order+stage 绑 purpose_data)→ POST ack。
+window.dpDoAck = async (orderId, stage) => {
+  let token
+  try { token = await requestPasskeyGate('direct_pay_disclosure_ack', { order_id: orderId, stage }) }
+  catch (e) { await window.dpPromptRegisterPasskey(e); return false }
+  const r = await POST('/direct-pay/disclosure-acks', { order_id: orderId, stage, webauthn_token: token })
+  if (r.error) { if (typeof toast$ === 'function') toast$(window.dpErrorText(r.error_code, r.error), 'error'); return false }
+  return true
+}
+// ── 订单详情:direct_p2p 诚实边界始终显示;卖家收款说明快照【不】内联进 HTML,由 dpHydrateOrderDisclosure 在 both-acked 后才另取渲染(未 ack 时 DOM 里也没有快照)。
+window.dpOrderDisclosureHtml = (order) => `
+  <div class="card" style="border:1px solid #fde68a;background:linear-gradient(135deg,#fffbeb,#fef3c7)">
+    <div style="font-size:13px;font-weight:700;color:#92400e;margin-bottom:8px">💸 ${t('直付订单(非托管)')}</div>
+    <ul style="margin:0 0 8px;padding-left:18px;font-size:12px;line-height:1.7;color:#374151">
+      <li>${t('本金不经 WebAZ —— 你直接付款给卖家(场外)')}</li>
+      <li>${t('非担保交易:WebAZ 不托管本金、无退款能力,仅对卖家有信誉处罚权')}</li>
+      <li>${t('卖家收款说明来自卖家自填,WebAZ 不验证付款方式或币种')}</li>
+    </ul>
+    <div id="dp-order-instr" data-order-id="${escHtml(String(order && order.id || ''))}">${loading$()}</div>
+  </div>`
+// ack-gated 收款说明:both-acked → 另取订单快照并展示;否则只显示"先完成 D1/D2 Passkey"的门(快照不入 DOM)。
+window.dpHydrateOrderDisclosure = async (orderId) => {
+  if (!window.dpInstrBox(orderId)) return
+  const st = await GET(`/direct-pay/disclosure-acks/${orderId}`)
+  const box = window.dpInstrBox(orderId); if (!box) return   // async 回包后再确认当前页仍是该订单(切页后旧回包不得写 DOM)
+  if (st.error) { box.innerHTML = `<div style="font-size:12px;color:#dc2626">${window.dpErrorText(st.error_code, st.error)}</div>`; return }
+  if (!st.both) {
+    box.innerHTML = `<div style="font-size:12px;color:#92400e;background:#fff;border:1px solid #fde68a;border-radius:8px;padding:8px 10px">
+      ${t('需先完成 D1/D2 Passkey 风险确认,确认后才显示卖家收款说明。')}
+      <div style="margin-top:6px"><button class="btn btn-outline btn-sm" onclick="dpCompleteAcksThenReveal('${orderId}')">${t('完成风险确认')}</button></div></div>`
+    return
+  }
+  const o = await GET(`/orders/${orderId}`)
+  if (window.dpRenderPaymentInfo) window.dpRenderPaymentInfo(box, o && o.order ? o.order : null, orderId)  // PR-2:按订单状态渲染收款信息可见性(待支付=5min 自动窗口 / 其它状态=默认隐藏,需 Passkey 二次验证+风险提示)
+}
+window.dpCompleteAcksThenReveal = async (orderId) => {
+  const ok = await window.dpEnsureAcks(orderId)
+  if (ok) window.dpHydrateOrderDisclosure(orderId)
+}
+
+// ── 订单动作(mark_paid/confirm/confirm_in_person):前端先确保披露 ack,再取一次性 Passkey token 带进 order-action 端点;后端(#93)仍强制两次披露+Passkey。
+window.dpHandleAction = async (orderId, action) => {
+  const msgEl = document.getElementById('action-msg')
+  const show = (type, m) => { if (msgEl) msgEl.innerHTML = alert$(type, m); else if (typeof toast$ === 'function') toast$(m, type) }
+  // mark_paid 前必须两次披露都 ack(confirm/confirm_in_person 通常已在 mark_paid 阶段 ack 过,这里兜底再查)。
+  const acked = await window.dpEnsureAcks(orderId)
+  if (!acked) { show('error', window.dpErrorText('DISCLOSURE_NOT_ACKED')); return }
+  let token
+  try { token = await requestPasskeyGate('direct_pay_order_action', { order_id: orderId, action }) }
+  catch (e) { await window.dpPromptRegisterPasskey(e); return }
+  show('info', `<span class="spinner"></span>${t('处理中...')}`)
+  const path = action === 'confirm_in_person' ? `/orders/${orderId}/confirm-in-person` : `/orders/${orderId}/action`
+  const body = action === 'confirm_in_person' ? { webauthn_token: token } : { action, webauthn_token: token, ...(action === 'mark_paid' && window.dpReadMemo ? { notes: window.dpReadMemo(orderId) } : {}) }
+  const r = await POST(path, body)
+  if (r.error) { show('error', window.dpErrorText(r.error_code, r.error)); return }
+  show('success', t('操作成功'))
+  setTimeout(() => renderOrderDetail(document.getElementById('app'), orderId), 1000)
+}
+
+// ── 卖家:收款说明设置(GET / PUT / DELETE,仅展示文本)─────────────────────────────────────────
+window.dpSellerInstructionSection = () => `
+  <div class="card" style="margin-bottom:12px">
+    <div style="font-size:14px;font-weight:700;margin-bottom:6px">💳 ${t('直付收款说明')}</div>
+    <div style="font-size:12px;color:#6b7280;line-height:1.6;margin-bottom:10px">${t('这是你自填的收款展示文本(场外结算用);WebAZ 不验证付款方式或币种,不路由支付,不托管资金。')}</div>
+    <div id="dp-instr-box">${loading$()}</div>
+  </div>`
+
+window.dpHydrateInstruction = async () => {
+  const box = document.getElementById('dp-instr-box')
+  if (!box) return
+  const r = await GET('/direct-receive/payment-instruction')
+  if (r.error) { box.innerHTML = alert$('error', window.dpErrorText(r.error_code, r.error)); return }
+  const cur = r.instruction
+  box.innerHTML = `
+    ${cur ? `<div style="font-size:12px;color:#374151;background:#f9fafb;border:1px solid #e5e7eb;border-radius:8px;padding:8px 10px;margin-bottom:10px">
+      <div style="font-size:11px;color:#9ca3af;margin-bottom:2px">${t('当前生效')}${cur.label ? ` · ${escHtml(cur.label)}` : ''}</div>${escHtml(cur.instruction)}</div>` :
+      `<div style="font-size:12px;color:#9ca3af;margin-bottom:10px">${t('尚未设置收款说明')}</div>`}
+    <div id="dp-instr-msg"></div>
+    <div class="form-group"><label class="form-label">${t('收款说明')} <span style="font-size:11px;color:#9ca3af">${t('(展示给买家,如 PayNow / 银行转账 等)')}</span></label>
+      <textarea class="form-control" id="dp-instr-text" rows="3" maxlength="500" placeholder="${t('例:PayNow +65 9xxx(场外结算)')}">${cur ? escHtml(cur.instruction) : ''}</textarea></div>
+    <div class="form-group"><label class="form-label">${t('标签(可选)')}</label>
+      <input class="form-control" id="dp-instr-label" maxlength="40" value="${cur && cur.label ? escHtml(cur.label) : ''}" placeholder="${t('如 PayNow')}"></div>
+    <div style="display:flex;gap:8px">
+      <button class="btn btn-primary btn-sm" onclick="dpSaveInstruction()">${t('保存')}</button>
+      ${cur ? `<button class="btn btn-outline btn-sm" style="color:#dc2626;border-color:#dc2626" onclick="dpDeleteInstruction()">${t('停用')}</button>` : ''}
+    </div>`
+}
+
+window.dpSaveInstruction = async () => {
+  const msg = document.getElementById('dp-instr-msg')
+  const instruction = document.getElementById('dp-instr-text')?.value?.trim() || ''
+  const label = document.getElementById('dp-instr-label')?.value?.trim() || ''
+  if (!instruction) { if (msg) msg.innerHTML = alert$('error', t('收款说明不能为空')); return }
+  if (msg) msg.innerHTML = `<div class="alert alert-info"><span class="spinner"></span>${t('保存中...')}</div>`
+  const r = await PUT('/direct-receive/payment-instruction', { instruction, label })
+  if (r.error) { if (msg) msg.innerHTML = alert$('error', window.dpErrorText(r.error_code, r.error)); return }
+  if (typeof toast$ === 'function') toast$(t('已保存'), 'success')
+  window.dpHydrateInstruction()
+}
+
+window.dpDeleteInstruction = async () => {
+  const go = await confirmModal(t('停用后买家将无法对你发起直付订单,确定停用?'), t('停用'), { danger: true })
+  if (!go) return
+  const r = await api('DELETE', '/direct-receive/payment-instruction')
+  if (r.error) { if (typeof toast$ === 'function') toast$(window.dpErrorText(r.error_code, r.error), 'error'); return }
+  if (typeof toast$ === 'function') toast$(t('已停用'), 'success')
+  window.dpHydrateInstruction()
+}

package/dist/pwa/public/app-discover.js

@@ -32,7 +32,7 @@ async function renderShop(app, opts = {}) {
             <div class="product-img">${getCategoryIcon(p.category)}</div>
             <div class="product-body">
               <div class="product-name">${escHtml(p.title)}</div>
-              <div class="product-price">${p.price} <span style="font-size:11px;font-weight:400">WAZ</span></div>
+              <div class="product-price">${window.fmtPrice(p.price)}</div>
               <div class="product-seller">${repBadge(p.rep_level)}@${escHtml(p.seller_name)}</div>
             </div>
           </div>`).join('')}
@@ -553,7 +553,7 @@ function renderAgentBuyResultInto(container, res) {
   const bestCard = res.best_product ? `
     <div style="background:#f0fdf4;border:1px solid #bbf7d0;border-radius:10px;padding:12px;margin:12px 0">
       <div style="font-weight:600;font-size:14px;margin-bottom:4px">${escHtml(res.best_product.title)}</div>
-      <div style="font-size:18px;font-weight:700;color:#16a34a;margin-bottom:4px">${res.best_product.price} WAZ</div>
+      <div style="font-size:18px;font-weight:700;color:#16a34a;margin-bottom:4px">${window.fmtPrice(res.best_product.price)}</div>
       <div style="font-size:12px;color:#6b7280;margin-bottom:8px">${escHtml(res.best_product.agent_summary || '')}</div>
       ${!res.auto_bought ? `<button class="btn btn-primary btn-sm" style="width:auto" onclick="navigate('#order-product/${res.best_product.id}')">${t('查看并下单')}</button>` : ''}
     </div>` : ''
@@ -571,7 +571,7 @@ function renderAgentBuyResultInto(container, res) {
             <div style="font-size:13px;font-weight:500">${p.url_match ? '🎯 ' : ''}${escHtml(p.title)}</div>
             <div style="font-size:11px;color:#6b7280">${escHtml(p.agent_summary || '')}${p.url_match ? ` · <span style="color:#16a34a">${t('同款商品')}</span>` : ''}</div>
           </div>
-          <div style="font-weight:700;color:#1d4ed8;white-space:nowrap;margin-left:8px">${p.price} WAZ</div>
+          <div style="font-weight:700;color:#1d4ed8;white-space:nowrap;margin-left:8px">${window.fmtPrice(p.price)}</div>
         </div>`).join('')}
     </div>` : ''
   container.innerHTML = `
@@ -675,7 +675,7 @@ function buyResultCardHtml(p) {
           <div style="font-size:14px;font-weight:600;color:#111827;line-height:1.4;margin-bottom:4px">${escHtml(p.title)}${typeBadge}${valueBadgeChip}${lowStockChip}</div>
           <div style="display:flex;align-items:baseline;gap:6px;margin-bottom:4px">
             <span style="font-size:20px;font-weight:700;color:#4f46e5">${p.price}</span>
-            <span style="font-size:11px;color:#6b7280">WAZ</span>
+            <span style="font-size:11px;color:#6b7280" data-usdc-local="${p.price}">USDC${window._fxLocal(p.price) ? ' ≈ ' + window._fxLocal(p.price) : ''}</span>
           </div>
           <div style="font-size:11px;color:#6b7280">
             ${repBadge(p.rep_level)} @${escHtml(p.seller_name)} · ${p.sales_count || 0} ${t('单完成')}
@@ -768,8 +768,8 @@ async function renderDiscover(app) {
   const sectionStrip = ''
 
   // sort + type 合并为可折叠 filter（默认折叠，sort 名 + type 名作摘要）
-  const sortLabel = ({trending:'🔥 热门', recommended:'📣 推荐多', seller_win_rate:'⚖️ 胜诉率', newest:'🆕 最新', rating:'⭐ 信誉', price_asc:'💰 价格 ↑', random:'🎲 随机'}[sort]) || sort
-  const typeLabel = ({retail:'🛍️ 零售', wholesale:'📦 批发', service:'🛠️ 服务', digital:'💾 数字'}[ptype]) || ptype
+  const sortLabel = ({trending:'🔥 '+t('热门'), recommended:'📣 '+t('推荐多'), seller_win_rate:'⚖️ '+t('胜诉率'), newest:'🆕 '+t('最新'), rating:'⭐ '+t('信誉'), price_asc:'💰 '+t('价格 ↑'), random:'🎲 '+t('随机')}[sort]) || sort
+  const typeLabel = ({retail:'🛍️ '+t('零售'), wholesale:'📦 '+t('批发'), service:'🛠️ '+t('服务'), digital:'💾 '+t('数字')}[ptype]) || ptype
   const filterPanel = `
     <details style="margin-bottom:10px;background:#fff;border:1px solid #e5e7eb;border-radius:8px">
       <summary style="padding:8px 12px;cursor:pointer;font-size:12px;color:#374151;display:flex;justify-content:space-between;align-items:center">
@@ -824,7 +824,7 @@ async function renderDiscover(app) {
             name: nameField,
             url: location.origin + '/#order-product/' + pp.id,
             ...(img ? { image: img } : {}),
-            offers: { '@type': 'Offer', price: pp.price, priceCurrency: pp.currency || 'WAZ' },
+            offers: { '@type': 'Offer', price: pp.price, priceCurrency: 'USDC' },  // machine-readable price matches the USDC display (no human/agent drift); WAZ was simulated
           },
         }
       }),
@@ -945,7 +945,7 @@ function productCardHtml(p, showSales) {
     <div class="product-img">${getCategoryIcon(p.category)}</div>
     <div class="product-body">
       <div class="product-name">${escHtml(p.title)}${typeBadge}</div>
-      <div class="product-price">${p.price} <span style="font-size:11px;font-weight:400">WAZ</span></div>
+      <div class="product-price">${window.fmtPrice(p.price)}</div>
       <div class="product-seller">${t('卖家')}：@${escHtml(p.seller_name)}</div>
       ${p.seller_created_at ? `<div style="font-size:10px;color:#9ca3af;margin-top:1px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis">${t('入驻时长')}：${joinDuration(p.seller_created_at)}</div>` : ''}
       ${trust ? `<div style="font-size:10px;color:#6b7280;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis">${trust}</div>` : ''}
@@ -1062,7 +1062,7 @@ async function renderFeedView() {
     const actor = `<button onclick="toggleFollow('${e.actor_id}', this)" class="feed-actor" style="background:none;border:none;color:#4f46e5;font-weight:600;cursor:pointer;padding:0">${escHtml(e.actor_name || '—')}</button>`
     let body = ''
     if (e.kind === 'purchase') {
-      body = `${actor} ${t('购买了')} <a href="#order-product/${e.product_id}" style="color:#111">${escHtml(e.product_title)}</a> · ${e.price} WAZ`
+      body = `${actor} ${t('购买了')} <a href="#order-product/${e.product_id}" style="color:#111">${escHtml(e.product_title)}</a> · ${window.fmtPrice(e.price)}`
     } else if (e.kind === 'commission') {
       const amount = Number(extra.amount || 0).toFixed(2)
       body = `${actor} ${t('因推广')} <a href="#order-product/${e.product_id}" style="color:#111">${escHtml(e.product_title)}</a> ${t('获得 L')}${extra.level} ${t('佣金')} <strong style="color:#059669">+${amount} WAZ</strong>`
@@ -1093,7 +1093,7 @@ async function renderFeedRanks() {
     GET('/leaderboard?kind=buyers&limit=5').catch(() => ({ items: [] })),
   ])
   const rankLine = (rank, label, sub, hash) => `
-    <div onclick="location.hash='${hash}'" style="display:flex;gap:8px;align-items:center;padding:6px 0;cursor:pointer;border-bottom:1px solid #f3f4f6">
+    <div ${hash ? `onclick="location.hash='${hash}'"` : ''} style="display:flex;gap:8px;align-items:center;padding:6px 0;${hash ? 'cursor:pointer;' : ''}border-bottom:1px solid #f3f4f6">
       <div style="font-size:11px;font-weight:700;color:${rank <= 3 ? '#dc2626' : '#9ca3af'};width:18px;text-align:center;flex-shrink:0">${rank}</div>
       <div style="flex:1;min-width:0">
         <div style="font-size:12px;font-weight:600;color:#1f2937;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">${escHtml(label)}</div>
@@ -1111,13 +1111,13 @@ async function renderFeedRanks() {
 
   body.innerHTML = ''
     + miniCard('🔥', t('热门商品'), 'products', products.items || [], (it, r) =>
-        rankLine(r, it.title, `${Number(it.completion_count||0)} ${t('单')} · ${Number(it.recommend_count||0)} ${t('人推荐')} · ${it.price} WAZ`, `#order-product/${it.id}`))
+        rankLine(r, it.title, `${Number(it.completion_count||0)} ${t('单')} · ${Number(it.recommend_count||0)} ${t('人推荐')} · ${window.fmtPrice(it.price)}`, `#order-product/${it.id}`))
     + miniCard('🏪', t('卖家榜'), 'sellers', sellers.items || [], (it, r) =>
-        rankLine(r, '@' + (it.handle || it.name || ''), `${it.rating_count > 0 ? '⭐ ' + Number(it.avg_rating).toFixed(1) + ' (' + it.rating_count + ')' : t('暂无评价')} · ${Number(it.orders_count||0)} ${t('单')}`, `#shop/${it.id}`))
+        rankLine(r, '@' + (it.handle || it.name || ''), `${it.rating_count > 0 ? '⭐ ' + Number(it.avg_rating).toFixed(1) + ' (' + it.rating_count + ')' : t('暂无评价')} · ${Number(it.orders_count||0)} ${t('单')}`, it.handle ? `#shop/${it.handle}` : ''))
     + miniCard('📣', t('创作者榜'), 'creators', creators.items || [], (it, r) =>
-        rankLine(r, '@' + (it.handle || it.name || ''), `${Number(it.products_shared||0)} ${t('个商品')} · ${Number(it.total_likes||0)} ${t('赞')}`, `#u/${it.id}`))
+        rankLine(r, '@' + (it.handle || it.name || ''), `${Number(it.products_shared||0)} ${t('个商品')} · ${Number(it.total_likes||0)} ${t('赞')}`, it.handle ? `#u/${it.handle}` : ''))
     + miniCard('🛍', t('买家榜'), 'buyers', buyers.items || [], (it, r) =>
-        rankLine(r, '@' + (it.handle || it.name || ''), `${Number(it.orders_count||0)} ${t('单')}`, `#u/${it.id}`))
+        rankLine(r, '@' + (it.handle || it.name || ''), `${Number(it.orders_count||0)} ${t('单')}`, it.handle ? `#u/${it.handle}` : ''))
 }
 
 window.setFeedScope = (k) => {
@@ -1176,7 +1176,7 @@ async function renderNewArrivals(app) {
             <div class="product-img">${getCategoryIcon(p.category)}</div>
             <div class="product-body">
               <div class="product-name">${escHtml(p.title)}</div>
-              <div class="product-price">${p.price} <span style="font-size:11px;font-weight:400">WAZ</span></div>
+              <div class="product-price">${window.fmtPrice(p.price)}</div>
               <div class="product-seller">${repBadge(p.rep_level)}@${escHtml(p.seller_name)}</div>
               ${p.trial_quota_remaining > 0
                 ? `<div style="font-size:11px;color:#9333ea;margin-top:4px;font-weight:600">🎁 ${t('测评免单 剩')} ${p.trial_quota_remaining} ${t('名额')}</div>`
@@ -1205,14 +1205,14 @@ async function renderNewArrivalsFeed(app) {
     ? feedEmpty('🆕', t('暂无新品动态'), t('看看 推荐好物'), '#discover')
     : products.map(p => {
         const ts = fmtTime(p.created_at)
-        const img = (() => { try { const i = typeof p.images === 'string' ? JSON.parse(p.images) : p.images; return Array.isArray(i) && i[0] ? i[0] : '' } catch { return '' } })()
+        const img = window.productThumbSrc(p.images)
         return `<div class="card" style="margin-bottom:8px;padding:12px;display:flex;gap:10px;align-items:flex-start;cursor:pointer" onclick="navigate('#order-product/${p.id}')">
-          ${img ? `<img src="${escAttr(img)}" style="width:56px;height:56px;border-radius:6px;object-fit:cover;flex-shrink:0">` : `<div style="width:56px;height:56px;border-radius:6px;background:#f3f4f6;display:flex;align-items:center;justify-content:center;font-size:24px;flex-shrink:0">${getCategoryIcon(p.category)}</div>`}
+          ${img ? `<img src="${escAttr(img)}" onerror="this.outerHTML='📦'" style="width:56px;height:56px;border-radius:6px;object-fit:cover;flex-shrink:0">` : `<div style="width:56px;height:56px;border-radius:6px;background:#f3f4f6;display:flex;align-items:center;justify-content:center;font-size:24px;flex-shrink:0">${getCategoryIcon(p.category)}</div>`}
           <div style="flex:1;min-width:0">
             <div style="font-size:13px;line-height:1.5">
               ${feedActor(p.seller_id, p.seller_name, p.seller_handle)} ${t('上架了')} <strong>${escHtml(p.title)}</strong>
             </div>
-            <div style="font-size:11px;color:#9ca3af;margin-top:4px">${p.price} WAZ · ${ts}</div>
+            <div style="font-size:11px;color:#9ca3af;margin-top:4px">${window.fmtPrice(p.price)} · ${ts}</div>
           </div>
         </div>`
       }).join('')
@@ -1249,7 +1249,7 @@ function renderSearchResults(products, banner, q) {
             <div class="product-img">${getCategoryIcon(p.category)}</div>
             <div class="product-body">
               <div class="product-name">${escHtml(p.title)}</div>
-              <div class="product-price">${p.price} WAZ</div>
+              <div class="product-price">${window.fmtPrice(p.price)}</div>
               <div class="product-seller">${repBadge(p.rep_level)}@${escHtml(p.seller_name)}</div>
             </div>
           </div>`).join('')}
@@ -1267,7 +1267,7 @@ window.doSearch = async () => {
   const products = resp.products || []
   const m   = resp.matched_by
   const ext = resp.extracted || {}
-  const plat = ext.platform ? `${ext.platform}` : '外部平台'
+  const plat = ext.platform ? `${ext.platform}` : t('外部平台')
   let banner = ''
   if (m === 'external_id')               banner = `<div class="alert alert-success" style="margin-bottom:12px">✓ ${t('通过')} ${plat} ${t('商品 ID 精确匹配到')} ${products.length} ${t('件')}</div>`
   else if (m === 'external_title_exact') banner = `<div class="alert alert-success" style="margin-bottom:12px">✓ ${t('通过外链标题完全匹配到')} ${products.length} ${t('件')}</div>`

package/dist/pwa/public/app-dispute-close-ui.js

@@ -0,0 +1,38 @@
+// 争议协商收口·买家侧 —— "我已收到货 · 撤诉并确认收货"。UI ONLY(权威门在 orders-action dispute_withdraw_confirm:
+//   delivered 来源履约争议 + 发起人本人 + 裁定前;dp 轨 D1/D2+Passkey)。可达性来自订单 DTO can_confirm_receipt_close_dispute。
+//   注入:包装 mutualCancelCard(协商取消卡下追加;卖家侧收口=协商取消全额退款,买家侧=本卡),app.js 净零行。
+;(function () {
+  const S = window._notifSub
+  Object.assign(window.NOTIF_TEMPLATES, {
+    dispute_withdrawn_confirmed: (p) => ({ title: '✅ ' + t('买家已撤诉并确认收货'), body: S(t('买家撤回争议并确认收货,订单已完成结算,双方信誉不受影响。'), p) }),
+  })
+
+  const closeCard = (order) => {
+    if (!order || !order.can_confirm_receipt_close_dispute) return ''
+    const settleNote = order.payment_rail === 'direct_p2p'
+      ? t('确认后订单完成:货款你已线下支付,平台服务费照常计提。需 Passkey 确认。')
+      : t('确认后订单完成:托管货款将释放给卖家。')
+    return `<div class="card" style="border:1px solid #bbf7d0;background:linear-gradient(135deg,#f0fdf4,#dcfce7)">
+      <div style="font-size:13px;font-weight:700;color:#166534;margin-bottom:4px">📦 ${t('后来收到货了?')}</div>
+      <div style="font-size:12px;color:#4b5563;line-height:1.7;margin-bottom:8px">${t('包裹晚到/在代收点找到了?你可以撤回这条争议并确认收货,订单正常完成,双方信誉都不受影响。')}${settleNote}</div>
+      <button class="btn btn-primary btn-sm" style="width:auto" onclick="dcWithdrawConfirm('${order.id}','${order.payment_rail === 'direct_p2p' ? 1 : ''}')">${t('我已收到货 · 撤诉并确认收货')}</button>
+    </div>`
+  }
+
+  window.dcWithdrawConfirm = async (oid, isDp) => {
+    if (typeof confirmModal === 'function' && !(await confirmModal(t('确认撤回争议并确认收货?争议将关闭(不可恢复),订单立即完成结算。'), t('撤诉并确认收货'), { danger: true }))) return
+    const body = { action: 'dispute_withdraw_confirm' }
+    if (isDp) {
+      try { body.webauthn_token = await requestPasskeyGate('direct_pay_order_action', { order_id: oid, action: 'dispute_withdraw_confirm' }) }
+      catch (e) { if (window.dpPromptRegisterPasskey) await window.dpPromptRegisterPasskey(e); return }
+    }
+    const r = await POST('/orders/' + oid + '/action', body)
+    if (r.error) return void toast$(r.error, 'error')
+    toast$(t('已撤诉并确认收货,订单完成'), 'success')
+    renderOrderDetail(document.getElementById('app'), oid)
+  }
+
+  // 包装协商取消卡:disputed 订单页在其后追加买家收口卡(app.js 调用点不变,净零行)
+  const _origMcCard = window.mutualCancelCard
+  window.mutualCancelCard = (order, isBuyer, isSeller) => (_origMcCard ? _origMcCard(order, isBuyer, isSeller) : '') + (isBuyer ? closeCard(order) : '')
+})()

package/dist/pwa/public/app-external-links.js

@@ -0,0 +1,32 @@
+// External source-platform links on the product detail page (renderBuyPage in app.js). UI ONLY.
+//   Shows a "前往源平台查看详情" jump button. Verified links only; unverified links are hidden until verified.
+//   SECURITY: only http/https URLs are ever made clickable (blocks javascript:/data:/relative); the target
+//   domain is shown so the buyer sees where they go; links open with target=_blank rel="noopener noreferrer".
+//   Data: GET /api/products/:id/external-links (buyer-facing; NOT owner-gated; returns { links } already
+//   filtered to verified + non-revoked). Read-only; no writes.
+
+// Return a URL object only for http/https, else null (blocks javascript:/data:/mailto:/relative).
+window.safeExternalUrl = (u) => {
+  try { const url = new URL(String(u)); return (url.protocol === 'http:' || url.protocol === 'https:') ? url : null } catch { return null }
+}
+
+// Placeholder + self-scheduled hydrate (mirrors productImageGallery's setTimeout pattern in app.js).
+window.extLinksBarHtml = (productId) => {
+  setTimeout(() => { if (window.hydrateExtLinks) window.hydrateExtLinks(productId) }, 0)
+  return `<div id="ext-links-${productId}"></div>`
+}
+
+window.hydrateExtLinks = async (productId) => {
+  const box = document.getElementById('ext-links-' + productId)
+  if (!box) return
+  // Buyer-facing endpoint returns { links } = VERIFIED + non-revoked only (server-enforced, public-safe subset).
+  const r = await GET(`/products/${productId}/external-links`).catch(() => null)
+  const links = (r && r.links) || []
+  const rows = links.map(l => {
+    const url = window.safeExternalUrl(l.url)
+    if (!url) return ''                                  // non-http(s) → never render as a link
+    const host = escHtml(url.hostname)
+    return `<a href="${escHtml(url.href)}" target="_blank" rel="noopener noreferrer" style="display:inline-flex;align-items:center;gap:6px;font-size:12px;color:#2563eb;background:#eff6ff;border:1px solid #bfdbfe;border-radius:8px;padding:6px 10px;text-decoration:none">🔗 ${t('前往源平台查看详情')} · ${host}</a>`
+  }).filter(Boolean)
+  if (rows.length) box.innerHTML = `<div style="display:flex;flex-wrap:wrap;gap:6px;margin:8px 0">${rows.join('')}</div>`
+}

package/dist/pwa/public/app-free-shipping-ui.js

@@ -0,0 +1,29 @@
+// 满额免邮 UI(营销域,S2 返工)。UI ONLY —— 校验/判免全在后端(free-shipping.ts,建单 gate 应用)。入口:卖家后台「营销」tab 卡(app.js 净零 hook);点开就地 sheet 配店铺阈值,单品覆盖走 API。语义:促销非运费结构,券后货款≥阈值运费商家承担;供应商报价期规则不搬家。
+;(function () {
+  window.freeShippingMarketingCard = () => `
+      <div onclick="fsOpenSheet()" class="card" style="padding:14px;cursor:pointer;background:linear-gradient(135deg,#ecfeff,#cffafe);border-color:#67e8f9">
+        <div style="font-size:24px">🚚</div>
+        <div style="font-weight:600;font-size:13px;color:#155e75;margin-top:6px">${t('满额免邮')}</div>
+        <div style="font-size:10px;color:#0e7490;margin-top:2px">${t('拉客单价 · 运费你承担')}</div>
+      </div>`
+  window.fsOpenSheet = async () => {
+    const s = await GET('/seller/shipping-settings').catch(() => null)
+    const cur = s && s.store_free_shipping_threshold
+    const html = `
+      <div style="font-size:14px;font-weight:700;margin-bottom:6px">🚚 ${t('满额免邮(店铺默认)')}</div>
+      <div style="font-size:12px;color:#6b7280;margin-bottom:10px">${t('买家券后货款(不含保险/捐赠)达到阈值时,本单运费免收、由你承担。人工询价订单不适用;单品可经接口单独覆盖;只影响之后的新订单。')}</div>
+      <input class="form-control" id="fs-threshold" type="number" min="0" step="0.01" placeholder="${t('阈值金额(留空=关闭)')}" value="${cur ?? ''}" style="margin-bottom:10px">
+      <button class="btn btn-primary btn-sm" style="width:auto" onclick="fsSave()">${t('保存免邮设置')}</button>
+      <div id="fs-msg" style="margin-top:6px;font-size:11px"></div>`
+    if (typeof openSheet === 'function') openSheet(html)
+    else { const d = document.createElement('div'); d.className = 'card js-sheet'; d.style.cssText = 'position:fixed;left:50%;top:20%;transform:translateX(-50%);z-index:120;max-width:360px;width:92%'; d.innerHTML = html + `<button class="btn btn-outline btn-sm" style="width:auto;margin-top:8px" onclick="this.closest('.js-sheet').remove()">${t('关闭')}</button>`; document.body.appendChild(d) }
+  }
+  window.fsSave = async () => {
+    const raw = (document.getElementById('fs-threshold')?.value || '').trim()
+    const msg = document.getElementById('fs-msg')
+    if (raw !== '' && !(Number.isFinite(Number(raw)) && Number(raw) > 0)) { if (msg) msg.innerHTML = `<span style="color:#dc2626">${t('阈值必须是正数')}</span>`; return }   // 审计 P3:1e999→Infinity→JSON null→静默清除,前端就地拒
+    const r = await POST('/seller/shipping-template', { store_free_shipping_threshold: raw === '' ? null : Number(raw) })
+    if (r.error) { if (msg) msg.innerHTML = `<span style="color:#dc2626">${escHtml(r.error)}</span>`; return }
+    if (msg) msg.innerHTML = `<span style="color:#16a34a">✓ ${t('已保存')}${raw === '' ? ' · ' + t('已关闭') : ''}</span>`
+  }
+})()

package/dist/pwa/public/app-gmv-rail-split.js

@@ -0,0 +1,12 @@
+// GMV 按支付轨拆分小注(卖家仪表盘共用)。UI ONLY。
+//   托管(escrow)= 平台真实托管收入;直接收款(direct_p2p)= 场外收款,平台不经手 —— 二者不同性质,不该混成一个 GMV。
+//   仅当【有直接收款】时显示(纯托管卖家不打扰);金额沿用调用方的计价显示。
+;(function () {
+  window.gmvRailSplitHtml = (escrow, directPay, fmt) => {
+    const d = Number(directPay) || 0
+    if (d <= 0) return ''                                   // 无直接收款 → 不显示,GMV 就是纯托管
+    const e = Number(escrow) || 0
+    const f = typeof fmt === 'function' ? fmt : (n) => Number(n || 0).toFixed(0)
+    return `<div style="font-size:10px;color:#6b7280;margin-top:3px;line-height:1.5" title="${t('托管=平台托管收入;直接收款=场外收款,平台不经手')}">🏦 ${t('托管')} ${f(e)} · 🤝 ${t('直接收款')} ${f(d)}</div>`
+  }
+})()

package/dist/pwa/public/app-listing-commerce-ui.js

@@ -0,0 +1,72 @@
+// 单链接商务覆盖(S4)—— 上架/编辑表单里按【单个商品】覆盖店铺默认:接单/运费/询价/可售区/满额免邮/税费进口责任/清关字段。
+//   UI ONLY,写全部复用已验证端点(POST /seller/accept-mode + /seller/shipping-template + PUT /products/:id)。
+//   "留空=继承店铺默认"(值 null 清除该商品覆盖);编辑态从已取到的 product 行(formatProductForAgent 透传各覆盖列)回填。
+//   app.js 净零:add/edit 表单各注入一个 section hook + 保存时调 window.listingCommerceSave(productId)。
+;(function () {
+  const J = (x) => { try { return typeof x === 'string' ? JSON.parse(x) : (x || null) } catch { return null } }
+  const tplText = (arr) => (Array.isArray(arr) ? arr : []).map(e => `${e.region} ${e.fee}${e.est_days ? ' ' + e.est_days : ''}`).join('\n')
+  const taxText = (arr) => (Array.isArray(arr) ? arr : []).map(l => `${l.region} ${l.label}${l.rate_pct != null ? ' ' + l.rate_pct : ''}`).join('\n')
+  const srCodes = (r) => r ? (r.mode === 'list' ? (r.include || []) : (r.exclude || [])).join(' ') : ''
+
+  // p = 商品对象(编辑)或 null(新建)。所有字段 id 前缀 lc-。
+  window.listingCommerceSectionHtml = (p) => {
+    p = p || {}
+    const sr = J(p.sale_regions)
+    const sel = (id, cur, opts) => `<select class="form-control" id="${id}" style="font-size:13px">${opts.map(([v, lbl]) => `<option value="${v}" ${String(cur ?? '') === v ? 'selected' : ''}>${lbl}</option>`).join('')}</select>`
+    return `<details style="margin-bottom:16px">
+      <summary style="font-size:13px;color:#6b7280;cursor:pointer;padding:4px 0">🌍 ${t('本商品:接单 / 运费 / 可售区 / 税费(留空=用店铺默认)')}</summary>
+      <div style="margin-top:12px;display:flex;flex-direction:column;gap:10px">
+        <div><label class="form-label" style="font-size:12px">${t('接单模式')}</label>${sel('lc-accept', p.accept_mode, [['', t('继承店铺默认')], ['auto', t('自动接单')], ['manual', t('手动接单')]])}</div>
+        <div><label class="form-label" style="font-size:12px">${t('运费模板(每行:地区码 运费 [时效];* 兜底;留空=继承)')}</label><textarea class="form-control" id="lc-tpl" rows="2" style="font-size:12px;font-family:monospace" placeholder="SG 5 3-5&#10;* 25 10-20">${escHtml(tplText(J(p.shipping_template)))}</textarea></div>
+        <div><label class="form-label" style="font-size:12px">${t('模板外地区询价(直付)')}</label>${sel('lc-quote', p.shipping_quote_ok == null ? '' : (Number(p.shipping_quote_ok) === 1 ? '1' : '0'), [['', t('继承店铺默认')], ['1', t('开')], ['0', t('关')]])}</div>
+        <div style="display:flex;gap:8px">
+          <div style="flex:1"><label class="form-label" style="font-size:12px">${t('可售区域')}</label>${sel('lc-sr-mode', sr ? sr.mode : '', [['', t('继承/不限')], ['list', t('仅允许')], ['all', t('全球除外')]])}</div>
+          <div style="flex:1"><label class="form-label" style="font-size:12px">${t('地区码(空格分隔)')}</label><input class="form-control" id="lc-sr-codes" style="font-size:12px;font-family:monospace" value="${escHtml(srCodes(sr))}"></div>
+        </div>
+        <div style="display:flex;gap:8px">
+          <div style="flex:1"><label class="form-label" style="font-size:12px">${t('满额免邮阈值')}</label><input class="form-control" id="lc-free" type="number" min="0" step="0.01" placeholder="${t('继承')}" value="${p.free_shipping_threshold ?? ''}"></div>
+          <div style="flex:1"><label class="form-label" style="font-size:12px">${t('进口责任')}</label>${sel('lc-duty', p.import_duty_terms, [['', t('继承/不声明')], ['ddu', 'DDU'], ['ddp', 'DDP']])}</div>
+        </div>
+        <div><label class="form-label" style="font-size:12px">${t('价内已含税(每行:地区码 税名 [税率%];留空=继承)')}</label><textarea class="form-control" id="lc-tax" rows="2" style="font-size:12px;font-family:monospace" placeholder="SG GST 9">${escHtml(taxText(J(p.tax_lines)))}</textarea></div>
+        <div style="border-top:1px dashed #e5e7eb;padding-top:8px;font-size:11px;color:#9ca3af">${t('跨境清关字段(证据用,可选)')}</div>
+        <div style="display:flex;gap:8px">
+          <input class="form-control" id="lc-weight" type="number" min="0" step="0.01" placeholder="${t('重量 kg')}" value="${p.weight_kg ?? ''}" style="font-size:12px">
+          <input class="form-control" id="lc-pkg" placeholder="${t('尺寸 长x宽x高cm')}" value="${escHtml(p.package_size || '')}" style="font-size:12px">
+        </div>
+        <div style="display:flex;gap:8px">
+          <input class="form-control" id="lc-origin" placeholder="${t('发货国码')}" value="${escHtml(p.origin_country || '')}" style="font-size:12px;text-transform:uppercase">
+          <input class="form-control" id="lc-coo" placeholder="${t('原产国码')}" value="${escHtml(p.country_of_origin || '')}" style="font-size:12px;text-transform:uppercase">
+          <input class="form-control" id="lc-hs" placeholder="${t('HS 编码')}" value="${escHtml(p.hs_code || '')}" style="font-size:12px">
+        </div>
+        <input class="form-control" id="lc-customs-desc" placeholder="${t('报关英文品名')}" value="${escHtml(p.customs_description || '')}" style="font-size:12px">
+      </div></details>`
+  }
+
+  const LC_FIELDS = ['lc-accept', 'lc-tpl', 'lc-quote', 'lc-sr-mode', 'lc-free', 'lc-duty', 'lc-tax', 'lc-weight', 'lc-pkg', 'lc-origin', 'lc-coo', 'lc-hs', 'lc-customs-desc']
+  window.listingCommerceHasOverrides = () => LC_FIELDS.some(id => ((document.getElementById(id)?.value) || '').trim() !== '')   // 新建时据此决定"仓库优先"(有覆盖→先落仓库,全落定再激活)
+  // 收集并保存(新建/编辑同用;productId 必须已存在)。留空=null=清除该商品覆盖。复用已验证端点,任一报错即冒泡。opts.activate=全成功后激活(仓库优先新品的收尾)。
+  window.listingCommerceSave = async (productId, opts) => {
+    if (!productId || !document.getElementById('lc-accept')) return { ok: true }   // section 未渲染 → 跳过
+    const v = (id) => (document.getElementById(id)?.value || '').trim()
+    const parseTpl = (txt) => txt.split('\n').map(l => l.trim()).filter(Boolean).map(l => { const m = l.split(/\s+/); const est = m.slice(2).join(' '); return { region: m[0], fee: Number(m[1]), ...(est ? { est_days: est } : {}) } })
+    const parseTax = (txt) => txt.split('\n').map(l => l.trim()).filter(Boolean).map(l => { const m = l.split(/\s+/); const region = m[0]; const last = m[m.length - 1]; const hasRate = m.length > 2 && /^[0-9.]+$/.test(last); const label = m.slice(1, hasRate ? -1 : undefined).join(' '); return { region, label, ...(hasRate ? { rate_pct: Number(last) } : {}), kind: 'included' } })   // 空格安全:label 可含空格(如 Sales Tax);末 token 为数字才当税率
+    const srMode = v('lc-sr-mode'); const srCodesArr = v('lc-sr-codes').split(/\s+/).filter(Boolean)
+    const tplTxt = v('lc-tpl'); const taxTxt = v('lc-tax'); const q = v('lc-quote'); const fr = v('lc-free')
+    const steps = [   // 顺序 fail-fast:校验最重的运费/税费 body 先行 → 它被拒时接单/清关都还没写,避免部分保存(各字段独立无跨字段不变量)
+      () => POST('/seller/shipping-template', {
+        product_id: productId,
+        template: tplTxt ? parseTpl(tplTxt) : null,
+        quote_ok: q === '' ? null : q === '1',
+        sale_regions: srMode ? { mode: srMode, ...(srMode === 'list' ? { include: srCodesArr } : { exclude: srCodesArr }) } : null,
+        free_shipping_threshold: fr === '' ? null : Number(fr),
+        import_duty_terms: v('lc-duty') || null,
+        tax_lines: taxTxt ? parseTax(taxTxt) : null,
+      }),
+      () => POST('/seller/accept-mode', { product_id: productId, accept_mode: v('lc-accept') || null }),
+      () => PUT(`/products/${productId}`, { weight_kg: v('lc-weight') ? Number(v('lc-weight')) : null, package_size: v('lc-pkg') || null, origin_country: v('lc-origin') || null, country_of_origin: v('lc-coo') || null, customs_description: v('lc-customs-desc') || null, hs_code: v('lc-hs') || null }),
+    ]
+    for (const step of steps) { const r = await step(); if (r && r.error) return { ok: false, error: r.error } }
+    if (opts && opts.activate) { const a = await PATCH(`/products/${productId}/status`, { status: 'active' }); if (a && a.error) return { ok: false, error: a.error } }   // 仓库优先新品:覆盖全落定 → 激活;激活失败也算失败(商品留仓库=不可售,安全)
+    return { ok: true }
+  }
+})()