@seasonkoh/webaz 0.1.29 → 0.1.31

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

@@ -0,0 +1,14 @@
+// Direct Pay — 可验证付款附言(参考号)。UI ONLY;不碰钱路。
+//   每单从订单号派生【确定性唯一参考号】,提示买家付款时填入收款附言/备注 → mark_paid 的 note 回填订单时间线
+//   (买卖双方可见),相同金额也能靠参考号区分付款方。协议不验证,仅辅助对账。
+//   参考号【只读 + 一键复制】:锁定派生值买家不可改 —— 防"两单复用同一参考号"骗卖家重复确认;中文 t()/英文 i18n.js _EN。
+window.dpPayRef = (orderId) => 'WAZ-' + String(orderId || '').replace(/[^a-zA-Z0-9]/g, '').slice(-8).toUpperCase()
+window.dpMemoInputHtml = (orderId) => {
+  const ref = window.dpPayRef(orderId)
+  return `<div style="margin-top:8px;border-top:1px dashed #fde68a;padding-top:8px">
+    <div style="font-size:11px;color:#92400e;font-weight:600;margin-bottom:3px">${t('付款时请在附言/备注填入(便于卖家核对)')}</div>
+    <div style="display:flex;align-items:center;gap:6px"><code id="dp-buyer-memo" style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;font-size:13px;font-weight:700;letter-spacing:0.5px;background:#fffbeb;border:1px solid #fde68a;border-radius:6px;padding:6px 8px">${escHtml(ref)}</code>${window.dpCopyBtn ? window.dpCopyBtn(ref) : ''}</div>
+    <div style="font-size:10px;color:#9ca3af;margin-top:2px">${t('此参考号系统生成、不可修改;相同金额时卖家靠它区分付款方,标记"我已付款"时自动记入订单流程。')}</div></div>`
+}
+// "我已付款"时:note 恒为【派生参考号】(不再读可改输入框)—— 卖家对账口径唯一,买家无法用别单参考号冒充。
+window.dpReadMemo = (orderId) => `${t('付款参考')}: ${window.dpPayRef(orderId)}`

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

@@ -0,0 +1,35 @@
+// Direct Pay 货款协商(payment_query)+ 付款窗过期(direct_expired_unconfirmed)前端 —— 标签/动作/说明卡。UI ONLY。
+//   payment_query = 双方【协商】非仲裁;expired = 窗口超时未标记付款(宽限期内买家仍可主张已付或确认关单,审计项 H:
+//   此前该状态零 UI 动作=死角)。动作走通用 /orders/:id/action;非托管无退款语义。中文 t()/英文 i18n.js _EN。
+window.dpNegotiationBadge = (status) => status === 'payment_query' ? ['yellow', t('货款协商中')] : null
+window.dpNegotiationLabel = (status) => status === 'payment_query' ? t('货款协商中(非仲裁)') : null
+
+// 订单页按状态/角色返回协商动作(仅 direct_p2p 调用)。返回数组=接管;null=交回默认。
+window.dpNegotiationActions = (order, isBuyer, isSeller) => {
+  const s = order.status
+  if (s === 'payment_query') {
+    if (isSeller) return [
+      { action: 'confirm_received', label: '确认已收到货款(恢复订单)', style: 'success' },
+      { action: 'request_cancel', label: '申请取消订单(买家未回应时)', style: 'secondary' },
+    ]
+    if (isBuyer) return [
+      { action: 'pq_escalate', label: '我已付款 · 提交凭证升级举证', style: 'primary', needsEvidence: true, noteLabel: '付款凭证 / 参考号', evidencePlaceholder: '链上 tx / 银行回执 / 付款参考号(与下单时附言一致)' },
+      { action: 'cancel', label: '我未付款 · 取消订单', style: 'secondary' },
+    ]
+  }
+  // 审计项 H:付款窗过期(宽限期)买家双出口 —— 卡点付款的主张已付(证据升级争议),没付的即刻关单(免等 48h 自动取消)
+  if (s === 'direct_expired_unconfirmed' && isBuyer) return [
+    { action: 'dispute', label: '我已付款 · 提交凭证发起争议', style: 'primary', needsEvidence: true, noteLabel: '付款凭证 / 参考号', evidencePlaceholder: '链上 tx / 银行回执 / 付款参考号(与下单时附言一致)' },
+    { action: 'cancel', label: '我未付款 · 关闭订单', style: 'secondary' },
+  ]
+  // 撤回仲裁【仅限货款协商升级】:后端 DTO can_withdraw_payment_query_dispute 判定;履约类争议拿不到此按钮。
+  if (s === 'disputed' && (isBuyer || isSeller) && order.can_withdraw_payment_query_dispute) return [
+    { action: 'pq_withdraw', label: '撤回仲裁 · 回到协商', style: 'secondary' },
+  ]
+  return null
+}
+
+// 协商说明卡(payment_query 时展示):解释状态 + 提示买家复述付款参考。
+window.dpNegotiationCard = (order) => (!order || order.status !== 'payment_query') ? '' : `
+  <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:6px">🔎 ${t('货款协商中(非仲裁)')}</div>
+    <div style="font-size:12px;color:#374151;line-height:1.7">${t('卖家报告未收到货款。这是买卖双方【协商】阶段,不是仲裁:若你确已付款,请提交付款凭证升级举证;若未付款,可取消订单。谈不拢再进举证仲裁。直付非托管,WebAZ 不代收/不退款。')}</div></div>`

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

@@ -0,0 +1,15 @@
+// Direct Pay (Rail 1) — 付款时刻 UI 辅助。UI ONLY;不碰钱路。dpPayAmountText(order):应付金额纯文本,
+//   用于 D2 弹窗/风险确认弹窗/订单收款说明框。审计项 E:优先【下单时冻结的应付参考换算】(snapshot payable_* —
+//   买家/卖家/时间线同一稳定数字,不随实时汇率漂移;标注"下单时参考,以卖家收款说明为准");旧单无快照 → 回落
+//   实时换算(dpFxInCurrency);再无 → 仅 USDC。USDC/USD 账户:另附买家本地法币参考(_fxLocal)。中英 i18n parity。
+window.dpPayAmountText = (order) => {
+  if (!order) return ''
+  const usdc = Number(order.total_amount)
+  const s = Number.isFinite(usdc) ? (Number.isInteger(usdc) ? String(usdc) : usdc.toFixed(2)) : '—'
+  let snap = {}; try { snap = JSON.parse(order.direct_pay_account_snapshot || '{}') || {} } catch {}
+  const cur = String(snap.currency || '').toUpperCase()
+  if (!cur || cur === 'USDC' || cur === 'USD') { const loc = window._fxLocal ? window._fxLocal(usdc) : ''; return `${t('应付')} ${s} USDC${loc ? ' ≈ ' + loc : ''}` }
+  if (Number.isFinite(Number(snap.payable_approx))) return `${t('应付')} ≈ ${cur} ${Number(snap.payable_approx).toFixed(2)}（${s} USDC · ${t('下单时参考价,以卖家收款说明为准')}）`
+  const fx = window.dpFxInCurrency ? window.dpFxInCurrency(usdc, cur) : ''
+  return (fx && fx !== cur) ? `${t('应付')} ≈ ${fx}（${s} USDC）` : `${t('应付')} ${s} USDC · ${cur}`
+}

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

@@ -0,0 +1,32 @@
+// Direct Pay (Rail 1) — 融合付款弹窗。UI ONLY;不碰钱路(mark_paid 仍走 dpHandleAction 的 Passkey 门)。
+//   两次风险披露完成后弹出:把【收款账号/说明 · 应付金额 · 付款附言(参考号)】三要素融合展示,每项一键复制
+//   (买家直接抄进银行/收款App),付款后就地点"我已付款"→ dpHandleAction('mark_paid')(不新增 Passkey 次数,
+//   省掉"回订单页找按钮"一步)。也可"稍后处理"→ 订单页(同样能标记付款)。中文 t(),英文 i18n.js _EN。
+// 复制用【纯数字+币种】(避免抄进 "应付 ≈ …" 整句):有下单冻结 payable 用其币种+值,否则 USDC 总额。
+window.dpPayModalCopyAmount = (order) => {
+  try { const s = JSON.parse(order.direct_pay_account_snapshot || '{}'); if (Number.isFinite(Number(s.payable_approx)) && s.payable_currency) return s.payable_currency + ' ' + Number(s.payable_approx).toFixed(2) } catch {} return String(order.total_amount) + ' USDC'
+}
+window.dpShowPaymentModal = (order) => {
+  if (!order || !order.id) return
+  const oid = order.id
+  const instr = order.direct_pay_instruction_snapshot || ''
+  const amtText = window.dpPayAmountText ? window.dpPayAmountText(order) : (String(order.total_amount) + ' USDC')  // 展示串:复用 #225 唯一真相(含 ≈/下单参考价 caveat/FX 回落),防三处漂移
+  const amtCopy = window.dpPayModalCopyAmount(order)
+  const ref = window.dpPayRef ? window.dpPayRef(oid) : ''
+  const row = (label, valueHtml, copyText) => `<div style="margin-bottom:10px">
+    <div style="font-size:11px;color:#6b7280;margin-bottom:3px">${label}${window.dpCopyBtn ? window.dpCopyBtn(copyText) : ''}</div>
+    <div style="font-size:13px;color:#111827;background:#f9fafb;border:1px solid #e5e7eb;border-radius:8px;padding:8px 10px;white-space:pre-wrap;word-break:break-word">${valueHtml}</div></div>`
+  window._openModal(`
+    <h2 style="font-size:16px;font-weight:700;margin:0 0 4px">💸 ${t('请按以下信息付款')}</h2>
+    <div style="font-size:12px;color:#92400e;background:#fffbeb;border:1px solid #fde68a;border-radius:8px;padding:8px 10px;margin-bottom:12px">${t('风险确认已完成。这是卖家收款信息(下单时快照,WebAZ 不验证也不经手)。请【场外】完成付款后回来标记。')}</div>
+    ${instr ? row(t('收款账号 / 说明'), escHtml(instr), instr) : ''}
+    ${row(t('应付金额'), escHtml(amtText), amtCopy)}
+    ${row(t('付款附言(务必填写,用于卖家核对)'), '<b>' + escHtml(ref) + '</b>', ref)}
+    <div style="font-size:11px;color:#9ca3af;margin:6px 0 12px">${t('付款时请在银行/收款App的附言/备注里填入上面的参考号;完成付款后点下方按钮(需 Passkey)。')}</div>
+    <div style="display:flex;gap:8px">
+      <button class="btn btn-outline" style="flex:1" onclick="dpPayModalLater('${escHtml(oid)}')">${t('稍后在订单页处理')}</button>
+      <button class="btn btn-primary" style="flex:1;background:#16a34a;border-color:#16a34a" onclick="dpPayModalMarkPaid('${escHtml(oid)}')">${t('我已付款')}</button>
+    </div>`)
+}
+window.dpPayModalLater = (oid) => { if (typeof closeModal === 'function') closeModal(); navigate('#order/' + oid) }
+window.dpPayModalMarkPaid = async (oid) => { if (typeof closeModal === 'function') closeModal(); await window.dpHandleAction(oid, 'mark_paid') }  // mark_paid 自带 Passkey 门 + 成功后跳订单页

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

@@ -0,0 +1,19 @@
+// 直付卖家对账卡(审计项 F)。UI ONLY;不碰钱路。买家 mark_paid 后(accepted,发货前)在卖家视角显性化
+//   对账三要素:①期望参考号(dpPayRef 派生,银行流水附言应恰为此值,一键复制便于流水搜索)②应付金额
+//   (E 冻结的 payable 快照,与买家所见同一数字)③同买家同金额在途多单告警(DTO duplicate_amount_alert,
+//   与 mark_paid D2 时间线预警同口径 —— 防一笔转账冒充两单)。买家声称的参考在时间线(mark_paid note)可见。
+//   发货即确认收款(D4 弹窗把关),此卡把核对动作前置到打开订单页的每一刻。中文 t(),英文 i18n.js _EN。
+window.dpReconcileCard = (order, isSeller) => {
+  if (!order || !isSeller || order.payment_rail !== 'direct_p2p' || order.status !== 'accepted') return ''
+  const ref = window.dpPayRef ? window.dpPayRef(order.id) : ''
+  const pay = window.dpPayAmountText ? window.dpPayAmountText(order) : ''
+  const dup = Number(order.duplicate_amount_alert) || 0
+  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:#374151;line-height:1.9">
+      <div>${t('银行/收款App流水附言应为')} <code style="font-size:13px;font-weight:700;background:#fff;border:1px solid #bbf7d0;border-radius:6px;padding:2px 6px">${escHtml(ref)}</code>${window.dpCopyBtn ? window.dpCopyBtn(ref) : ''}</div>
+      ${pay ? `<div>💸 ${escHtml(pay)}</div>` : ''}
+      ${dup > 0 ? `<div style="color:#b91c1c;font-weight:600">⚠️ ${t('同买家另有')} ${dup} ${t('笔同金额直付订单在途 —— 每笔转账只能核销一个订单,请逐单核对参考号,谨防一笔款冒充多单。')}</div>` : ''}
+      <div style="font-size:11px;color:#6b7280">${t('请核实款项【已到账】且附言/金额与本单一致再发货;发货即视为确认收款。未收到请点"未收到货款"。')}</div>
+    </div></div>`
+}

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

@@ -0,0 +1,56 @@
+// 直付(direct_p2p)送达后退货·场外退款握手前端 —— 退货骨架 UI 在 app.js renderReturnWidgetForOrder,
+//   本模块只提供直付分支的 hooks(状态标签/握手动作块/升级判定与文案)。UI ONLY,真正边界在后端
+//   routes/direct-pay-returns.ts + 域模块。中文 t(),英文 i18n.js _EN。库存绝不自动恢复(退货验收上架)。
+
+window.dpReturnStatusLabels = () => ({ await_refund: t('待卖家场外退款'), refund_marked: t('卖家已声明退款 · 待你确认') })
+window.dpReturnStatusColors = () => ({ await_refund: '#d97706', refund_marked: '#2563eb', accepted_pickup_pending: '#16a34a', picked_up: '#2563eb' })
+
+// 握手动作块:卖家在 await_refund 声明退款;买家在 refund_marked 确认(Passkey)。其余状态返回 ''。
+window.dpReturnHandshake = (item, isBuyer, isSellerView, order) => {
+  if (!order || order.payment_rail !== 'direct_p2p') return ''
+  const note = `<div style="font-size:11px;color:#92400e;background:#fffbeb;border:1px solid #fde68a;border-radius:6px;padding:6px 8px;margin-bottom:8px">${t('直付非托管:退款由卖家在协议外完成,平台只记录握手,不经手货款。')}</div>`
+  if (isSellerView && item.status === 'await_refund') {
+    return `${note}<div style="font-size:12px;color:#374151;margin-bottom:6px">${t('你已同意退货。请在协议外向买家退款,然后声明;买家确认后退货完成。')}</div>
+      <input id="dp-ret-ref-${item.id}" class="form-control" maxlength="200" placeholder="${t('退款参考(转账单号等,可选,买家可见)')}" style="margin-bottom:8px;font-size:12px">
+      <button class="btn btn-primary btn-sm" style="width:auto;font-size:12px" onclick="dpReturnMarkRefunded('${item.id}','${order.id}')">${t('我已退款')}</button>`
+  }
+  if (isBuyer && item.status === 'await_refund') {
+    return `${note}<div style="font-size:12px;color:#6b7280;margin-bottom:8px">⏳ ${t('卖家已同意退货,等待其在协议外向你退款并声明。超期未退款可升级争议。')}</div>`
+  }
+  if (isBuyer && item.status === 'refund_marked') {
+    return `${note}<div style="font-size:12px;color:#374151;margin-bottom:8px">💸 ${t('卖家已声明退款')}${item.refund_reference ? '「' + escHtml(item.refund_reference) + '」' : ''}。${t('请先核实退款已到账;未收到请勿确认,可发起争议。')}</div>
+      <button class="btn btn-primary btn-sm" style="width:auto;font-size:12px" onclick="dpReturnConfirmRefund('${item.id}','${order.id}')">${t('已收到退款,完成退货(需 Passkey)')}</button>`
+  }
+  if (isSellerView && item.status === 'refund_marked') {
+    return `${note}<div style="font-size:12px;color:#6b7280">⏳ ${t('你已声明退款,等待买家确认收到。提示:退回货物须验收后手动上架,库存不会自动恢复。')}</div>`
+  }
+  return ''
+}
+
+// 升级争议判定(与后端 directPayReturnEscalatable 同口径;窗口天数由后端最终裁决,前端只做展示预判)
+window.dpReturnCanEscalate = (item, order) => {
+  if (!order || order.payment_rail !== 'direct_p2p') return false
+  if (item.status === 'refund_marked') return true
+  if (item.status === 'await_refund' && item.await_refund_since) return (Date.now() - new Date(String(item.await_refund_since).replace(' ', 'T') + 'Z').getTime()) >= 5 * 86400 * 1000
+  return false
+}
+window.dpReturnEscalateHint = (item) => item.status === 'refund_marked'
+  ? t('若卖家声明退款但你并未收到,可升级至平台仲裁(直付为信誉裁决)')
+  : t('卖家同意退货后超期未退款 — 可升级至平台仲裁(直付为信誉裁决)')
+
+window.dpReturnMarkRefunded = async (rid, oid) => {
+  if (typeof confirmModal === 'function' && !(await confirmModal(t('确认你已在协议外向买家完成退货退款?声明后买家确认即完成;虚假声明将留痕并可被追责。'), t('我已退款'), { danger: true }))) return
+  const el = document.getElementById('dp-ret-ref-' + rid)
+  const r = await POST('/return-requests/' + rid + '/mark-refunded', { refund_reference: (el && el.value || '').trim() })
+  if (r.error) return void toast$(r.error, 'error')
+  toast$(t('已声明退款,等待买家确认'), 'success'); renderOrderDetail(document.getElementById('app'), oid)
+}
+window.dpReturnConfirmRefund = async (rid, oid) => {
+  if (typeof confirmModal === 'function' && !(await confirmModal(t('确认已收到卖家退款?确认后退货完成,不可撤销。若尚未到账请勿确认。'), t('已收到,完成退货'), { danger: true }))) return
+  let token
+  try { token = await requestPasskeyGate('direct_pay_order_action', { order_id: oid, action: 'return_refund_confirm' }) }
+  catch (e) { if (window.dpPromptRegisterPasskey) await window.dpPromptRegisterPasskey(e); return }
+  const r = await POST('/return-requests/' + rid + '/confirm-refund', { webauthn_token: token })
+  if (r.error) return void toast$(window.dpErrorText ? window.dpErrorText(r.error_code, r.error) : r.error, 'error')
+  toast$(t('退货已完成'), 'success'); renderOrderDetail(document.getElementById('app'), oid)
+}

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

@@ -0,0 +1,82 @@
+// Direct Pay (Rail 1) — 收款信息可见性生命周期 (PR-2)。UI ONLY。
+//   模型:待支付(direct_pay_window)→ 自动展示卖家收款说明+QR 一个【30 分钟窗口】,超时自动隐藏,可【轻量】重新显示(重置窗口);
+//   其它所有状态(已付/完成/取消/过期/争议/退款…)→ 默认隐藏,需【二次验证:现场 Passkey + 风险提示】才临时展示(同样 30 分钟窗口)。
+//   金额(应付)非敏感,任何状态都常显。
+//   诚实边界:这是【客户端展示/同意】控制 —— 防误付空单 + 不长留敏感收款信息在屏 + 现场在场二次同意;
+//   【并非】新的服务器机密边界(收款目标对 both-acked 的订单买家经订单 API 仍可得,后端授权门仍是 both-acked 归属)。
+//   订单隔离(P1):所有 DOM 写入只经 dpInstrBox(orderId) 取容器 —— 容器 data-order-id 必须仍等于该 orderId,
+//   否则(已切到别的订单页)一律 bail。切换订单渲染时先清掉所有旧 timer,杜绝旧订单 timer/重看改写当前订单面板。
+window._dpRevealTimers = window._dpRevealTimers || {}
+window.DP_REVEAL_MS = 30 * 60 * 1000
+
+// 终态/无效单(不应再付款)——重看时给强风险提示。
+window.dpIsVoidOrder = (status) => ['cancelled', 'expired', 'direct_expired_unconfirmed', 'disputed', 'dispute_dismissed', 'refunded_full', 'refunded_partial', 'fault_seller', 'fault_buyer', 'fault_logistics'].includes(status)
+
+// 订单隔离守卫:仅当当前 #dp-order-instr 容器仍属于 orderId 才返回它;否则 null(已切换订单 → 任何写入都不得落到别的订单页)。
+window.dpInstrBox = (orderId) => { const b = document.getElementById('dp-order-instr'); return (b && b.getAttribute('data-order-id') === String(orderId)) ? b : null }
+window.dpClearRevealTimer = (orderId) => { const tmr = window._dpRevealTimers[orderId]; if (tmr) { clearTimeout(tmr.to); clearInterval(tmr.iv); delete window._dpRevealTimers[orderId] } }
+window.dpClearAllRevealTimers = () => { for (const k of Object.keys(window._dpRevealTimers)) window.dpClearRevealTimer(k) }
+
+// 收款说明+QR 展示块(含倒计时);到点 → 隐藏。lightweight=true:重新显示无需 Passkey(待支付轨)。
+window.dpShowPaymentInfo = (order, orderId, lightweight) => {
+  const box = window.dpInstrBox(orderId); if (!box) return   // 已切到别的订单页 → 不写
+  window.dpClearRevealTimer(orderId)
+  const snap = order && order.direct_pay_instruction_snapshot ? order.direct_pay_instruction_snapshot : ''
+  const pay = window.dpPayAmountText ? window.dpPayAmountText(order) : ''
+  if (!snap) { box.innerHTML = `<div style="font-size:12px;color:#9ca3af">${t('卖家尚未设置收款说明,暂不可直付')}</div>`; return }
+  box.innerHTML = `<div style="font-size:12px;color:#374151;background:#fff;border:1px solid #fde68a;border-radius:8px;padding:8px 10px">
+    ${pay ? `<div style="font-size:13px;font-weight:700;color:#92400e;margin-bottom:4px">💸 ${escHtml(pay)}</div>` : ''}
+    <div style="font-size:11px;color:#9ca3af;margin-bottom:2px">${t('卖家收款说明(下单时快照)')}${window.dpCopyBtn ? window.dpCopyBtn(snap, t('复制收款说明')) : ''}</div><div style="white-space:pre-wrap;word-break:break-word">${escHtml(snap)}</div><div id="dp-order-qr"></div>${lightweight && window.dpMemoInputHtml ? window.dpMemoInputHtml(orderId) : ''}
+    <div style="font-size:10px;color:#9ca3af;margin-top:6px">${t('自动隐藏倒计时')}: <span id="dp-reveal-countdown">30:00</span></div></div>`
+  if (window.dpLoadOrderQr) window.dpLoadOrderQr(orderId)
+  const end = Date.now() + window.DP_REVEAL_MS
+  const tick = () => { const b = window.dpInstrBox(orderId); if (!b) return window.dpClearRevealTimer(orderId); const el = b.querySelector('#dp-reveal-countdown'); if (!el) return; const s = Math.max(0, Math.round((end - Date.now()) / 1000)); el.textContent = `${Math.floor(s / 60)}:${String(s % 60).padStart(2, '0')}` }
+  tick()
+  window._dpRevealTimers[orderId] = { iv: setInterval(tick, 1000), to: setTimeout(() => window.dpHidePaymentInfo(order, orderId, lightweight), window.DP_REVEAL_MS) }
+}
+
+// 隐藏收款信息 → 显示重看入口。lightweight:待支付轨点一下即可;否则需 Passkey+风险提示。
+window.dpHidePaymentInfo = (order, orderId, lightweight) => {
+  window.dpClearRevealTimer(orderId)
+  const box = window.dpInstrBox(orderId); if (!box) return   // 已切到别的订单页 → 不写
+  const pay = window.dpPayAmountText ? window.dpPayAmountText(order) : ''
+  const hint = lightweight ? t('为保护你的收款信息,已隐藏。') : t('订单已不在待支付阶段,收款信息默认隐藏。')
+  const btn = lightweight
+    ? `<button class="btn btn-outline btn-sm" onclick="dpReShowPaymentInfo('${orderId}')">${t('重新显示')}</button>`
+    : `<button class="btn btn-outline btn-sm" onclick="dpGatedRevealPaymentInfo('${orderId}')">${t('查看收款信息(需 Passkey 验证)')}</button>`
+  box.innerHTML = `<div style="font-size:12px;color:#374151;background:#fff;border:1px solid #fde68a;border-radius:8px;padding:8px 10px">
+    ${pay ? `<div style="font-size:13px;font-weight:700;color:#92400e;margin-bottom:4px">💸 ${escHtml(pay)}</div>` : ''}
+    <div style="font-size:11px;color:#9ca3af;margin-bottom:6px">${escHtml(hint)}</div>${btn}</div>`
+}
+
+// 轻量重新显示:GET【最新】订单后按【当前状态】重新分派 —— 仍待支付才轻量重显;若期间已取消/过期/争议等,
+//   dpRenderPaymentInfo 会走隐藏+Passkey 二次验证路径(绝不用旧按钮 lightweight 展示一个已失效订单的收款信息)。
+window.dpReShowPaymentInfo = async (orderId) => {
+  if (!window.dpInstrBox(orderId)) return
+  const o = await GET(`/orders/${orderId}`); const ord = o && o.order ? o.order : null
+  const box = window.dpInstrBox(orderId); if (ord && box) window.dpRenderPaymentInfo(box, ord, orderId)
+}
+
+// 非待支付:二次验证(风险提示 + 现场 Passkey)后临时展示一个 30 分钟窗口。
+window.dpGatedRevealPaymentInfo = async (orderId) => {
+  if (!window.dpInstrBox(orderId)) return
+  const o = await GET(`/orders/${orderId}`); const ord = o && o.order ? o.order : null
+  if (!ord) return
+  const warn = window.dpIsVoidOrder(ord.status)
+    ? t('⚠️ 此订单已取消/终止,请【勿再付款】。收款信息仅供对账/存证查看。')
+    : t('⚠️ 你已完成付款。收款信息仅供对账/维权查看,请勿重复付款。')
+  const go = await confirmModal(`${warn}\n\n${t('继续查看需现场 Passkey 验证。')}`, t('继续(需 Passkey)'), { danger: true })
+  if (!go || !window.dpInstrBox(orderId)) return
+  try { await requestPasskeyGate('direct_pay_payment_info_reveal', { order_id: orderId }) }
+  catch (e) { if (window.dpPromptRegisterPasskey) await window.dpPromptRegisterPasskey(e); return }
+  window.dpShowPaymentInfo(ord, orderId, false)
+}
+
+// 订单详情:按状态渲染收款信息可见性。【先确认当前容器仍属于该 orderId,再清 timer】——否则旧订单 stale hydrate 回包
+//   会把当前订单的自动隐藏 timer 一并清掉(敏感收款信息永不隐藏)。both-acked 由调用方(dpHydrateOrderDisclosure)先保证。
+window.dpRenderPaymentInfo = (_box, order, orderId) => {
+  if (!order || !window.dpInstrBox(orderId)) return   // 当前页已不是该订单 → 不动任何 timer/DOM
+  window.dpClearAllRevealTimers()
+  if (order.payment_rail === 'direct_p2p' && order.status === 'direct_pay_window') window.dpShowPaymentInfo(order, orderId, true)
+  else window.dpHidePaymentInfo(order, orderId, false)
+}

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

@@ -0,0 +1,70 @@
+// Direct Pay 卖家【直接收款销售统计 + 对账 + 逐单平台费明细】section。UI ONLY,只读。
+//   数据:GET /api/sellers/me/direct-pay-report(requireSeller,仅本人)。直付=非托管,货款买家直付卖家,平台不经手 →
+//   钱包/收入视图看不到直付销售,故此处按订单聚合销售额 + 逐单平台服务费,便于对账(可选日期区间 + 客户端 CSV 导出)。
+//   销售额=下单计价币(买家应付金额);平台服务费=USDC。两者不同币种,分列不混加。
+;(function () {
+  const _n = (v) => (Number(v) || 0)
+  const _amt = (v) => _n(v).toLocaleString(undefined, { maximumFractionDigits: 2 })                 // 销售额(计价币)
+  const _fee = (v) => v == null ? '—' : (_n(v).toFixed(6).replace(/\.?0+$/, '') || '0') + ' USDC'   // 平台费(USDC)
+  let _last = null
+
+  window.dpSalesReportSection = () => {
+    setTimeout(() => window.dpHydrateSalesReport(), 60)
+    return `<div class="card" style="margin-bottom:12px;border:1px solid #e5e7eb">
+      <div style="font-size:14px;font-weight:700;margin-bottom:4px">🧾 ${t('直接收款销售统计 + 对账(仅你可见)')}</div>
+      <div style="font-size:12px;color:#6b7280;line-height:1.6;margin-bottom:10px">${t('直付为非托管:货款由买家直接付给你,平台不经手。此处按你的订单聚合销售额与逐单平台服务费,便于对账。')}</div>
+      <div style="display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin-bottom:10px">
+        <input type="date" id="dpsr-from" style="font-size:12px;padding:4px 6px;border:1px solid #e5e7eb;border-radius:6px">
+        <span style="color:#9ca3af">→</span>
+        <input type="date" id="dpsr-to" style="font-size:12px;padding:4px 6px;border:1px solid #e5e7eb;border-radius:6px">
+        <button class="btn btn-outline btn-sm" style="font-size:11px;padding:4px 10px" onclick="dpHydrateSalesReport(document.getElementById('dpsr-from').value, document.getElementById('dpsr-to').value)">${t('查询')}</button>
+        <button class="btn btn-outline btn-sm" style="font-size:11px;padding:4px 10px" onclick="dpSalesReportExport()">📥 ${t('导出对账 CSV')}</button>
+      </div>
+      <div id="dpsr-body">${typeof loading$ === 'function' ? loading$() : ''}</div>
+    </div>`
+  }
+
+  window.dpHydrateSalesReport = async (from, to) => {
+    const box = document.getElementById('dpsr-body'); if (!box) return
+    const q = []
+    if (from && /^\d{4}-\d{2}-\d{2}$/.test(from)) q.push('from=' + from)
+    if (to && /^\d{4}-\d{2}-\d{2}$/.test(to)) q.push('to=' + to)
+    const r = await GET('/sellers/me/direct-pay-report' + (q.length ? '?' + q.join('&') : '')).catch(() => null)
+    if (!r || r.error) { box.innerHTML = `<div style="font-size:12px;color:#dc2626">${t('操作失败,请重试')}</div>`; return }
+    _last = r
+    const s = r.summary
+    if (!s || s.order_count === 0) { box.innerHTML = `<div style="font-size:12px;color:#9ca3af;padding:8px 0">${t('该区间暂无直接收款订单')}</div>`; return }
+    const tile = (label, val, sub) => `<div style="flex:1;min-width:96px;background:#faf5ff;border:1px solid #ede9fe;border-radius:8px;padding:8px 10px"><div style="font-size:11px;color:#7c3aed">${label}</div><div style="font-size:16px;font-weight:700;color:#5b21b6">${val}</div>${sub ? `<div style="font-size:10px;color:#9ca3af">${sub}</div>` : ''}</div>`
+    const tiles = `<div style="display:flex;gap:6px;flex-wrap:wrap;margin-bottom:10px">
+      ${tile(t('已完成销售额'), _amt(s.completed_sales), t('已完成') + ' ' + s.completed_count + ' ' + t('单'))}
+      ${tile(t('订单总额'), _amt(s.gross_order_total), t('含在途/已关闭') + ' · ' + s.order_count + ' ' + t('单'))}
+      ${tile(t('已计提平台费'), _fee(s.fee_accrued_total), s.fee_order_count + ' ' + t('单'))}
+      ${tile(t('在途 / 已关闭'), s.in_flight_count + ' / ' + s.closed_count, t('单'))}
+    </div>`
+    const byMonth = (r.by_month && r.by_month.length > 1) ? `<div style="margin-bottom:10px"><div style="font-size:12px;color:#6b7280;margin-bottom:4px">${t('按月(已完成 / 订单总额)')}</div>${r.by_month.map(m => `<div style="display:flex;justify-content:space-between;font-size:12px;padding:2px 0;border-bottom:1px solid #f3f4f6"><span>${escHtml(m.month)}</span><span>${_amt(m.completed_sales)} <span style="color:#9ca3af">/ ${_amt(m.gross_order_total)}</span></span></div>`).join('')}</div>` : ''
+    const th = (txt, right) => `<th style="text-align:${right ? 'right' : 'left'};padding:5px 4px;font-size:11px;color:#9ca3af;white-space:nowrap">${txt}</th>`
+    const rowsHtml = r.orders.map(o => `<tr style="border-bottom:1px solid #f3f4f6">
+      <td style="padding:5px 4px;font-size:11px"><a href="#order/${o.id}" style="color:#6366f1;text-decoration:none">${escHtml(String(o.id).slice(0, 10))}</a></td>
+      <td style="padding:5px 4px;font-size:11px;color:#6b7280;white-space:nowrap">${typeof fmtTime === 'function' ? fmtTime(o.created_at) : escHtml(o.created_at)}</td>
+      <td style="padding:5px 4px;font-size:11px">${typeof statusBadge === 'function' ? statusBadge(o.status, 'direct_p2p') : escHtml(o.status)}</td>
+      <td style="padding:5px 4px;font-size:11px;text-align:right;font-weight:600">${_amt(o.total_amount)}</td>
+      <td style="padding:5px 4px;font-size:11px;text-align:right;color:#7c3aed">${_fee(o.fee_amount)}</td>
+    </tr>`).join('')
+    const table = `<div style="overflow-x:auto"><table style="width:100%;border-collapse:collapse">
+      <thead><tr style="border-bottom:1px solid #e5e7eb">${th(t('订单'))}${th(t('时间'))}${th(t('状态'))}${th(t('销售额'), true)}${th(t('平台费'), true)}</tr></thead>
+      <tbody>${rowsHtml}</tbody></table></div>${r.truncated ? `<div style="font-size:11px;color:#b45309;margin-top:6px">${t('仅显示最近 500 单,请用日期区间缩小范围')}</div>` : ''}`
+    box.innerHTML = tiles + byMonth + table
+  }
+
+  // 客户端 CSV 导出(对账用:逐单销售额 + 平台费一张表,对银行流水)。
+  window.dpSalesReportExport = () => {
+    if (!_last || !_last.orders || !_last.orders.length) { (window.toast$ || window.alert)(t('暂无数据可导出')); return }
+    const esc = (v) => { const x = v == null ? '' : String(v); return /[",\n]/.test(x) ? '"' + x.replace(/"/g, '""') + '"' : x }
+    const lines = [['order_id', 'created_at', 'status', 'sales_amount', 'platform_fee_usdc', 'fee_accrued_at', 'ship_to_region', 'product'].join(',')]
+    for (const o of _last.orders) lines.push([o.id, o.created_at, o.status, o.total_amount, o.fee_amount == null ? '' : o.fee_amount, o.fee_accrued_at || '', o.ship_to_region || '', o.product_title || ''].map(esc).join(','))
+    const a = document.createElement('a'); a.href = URL.createObjectURL(new Blob(['' + lines.join('\n')], { type: 'text/csv;charset=utf-8' }))
+    a.download = 'webaz-directpay-reconcile-' + new Date().toISOString().slice(0, 10) + '.csv'
+    document.body.appendChild(a); a.click(); a.remove(); URL.revokeObjectURL(a.href)
+    if (window.toast$) window.toast$(t('导出完成'))
+  }
+})()

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

@@ -23,7 +23,7 @@ window.dpErrorText = (code, fallback) => {
     DIRECT_PAY_SIMPLE_PRODUCT_ONLY: t('直付当前仅支持简单商品(无规格)'),
     DIRECT_PAY_UNSUPPORTED_OPTION: t('直付当前不支持该下单选项'),
   }
-  return M[code] || fallback || t('操作失败,请重试')
+  return M[code] || (window.orderErrorLookup && window.orderErrorLookup(code)) || fallback || t('操作失败,请重试')  // 回退查订单错误码表(NOT_ORDER_BUYER 等披露/动作码)
 }
 
 // ── 买家结算:支付方式(rail)选择。escrow 默认;direct_p2p 可选,选中先查可用性(见 dpOnRailChange);D1/D2 ack 在建单后用 Passkey 完成。
@@ -40,7 +40,7 @@ window.dpRailSelectorHtml = (productId, priceUsdc) => `
         <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 完成两次风险确认,再标记付款。')}
+        ⚠️ ${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>
@@ -81,64 +81,66 @@ window.dpAfterCreate = async (res) => {
     return
   }
   // 两次披露已 ack —— 收款说明【不】来自 create 响应(后端在 both-acked 前不下发);现在才 GET 订单读取 redaction-gated 快照。
+  //   【先落订单页,融合付款弹窗叠在其上】:订单页本身有收款信息+对账卡+自动隐藏倒计时,所以无论用户点按钮、点遮罩还是
+  //   按 ESC 关掉弹窗,都留在订单页而非产品页 —— 杜绝"关弹窗后失联→重复下单"(审计:弹窗被 overlay/ESC 关会 strand)。
   const o = await GET(`/orders/${orderId}`)
-  const instr = o && o.order ? (o.order.direct_pay_instruction_snapshot || '') : ''
-  await confirmModal(
-    `${t('风险确认完成 · 这是卖家的收款说明(下单时快照,WebAZ 不验证)')}\n\n${instr}\n\n${t('请按此付款,然后在订单页标记"我已付款"')}`,
-    t('我知道了'), {})
-  setTimeout(() => navigate(`#order/${orderId}`), 300)
+  navigate(`#order/${orderId}`)
+  if (o && o.order && window.dpShowPaymentModal) setTimeout(() => window.dpShowPaymentModal(o.order), 120)   // 等订单页渲染后叠弹窗
 }
-// ── 确保两次披露都已 ack(缺哪个补哪个;每次都需现场真人 Passkey)。返回 both-acked 与否。 ──────────
+// ── 确保两次披露都已 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 stages = [
-    { key: 'pre_select', acked: st.acked?.pre_select, text: disc.pre_select },
-    { key: 'pre_confirm', acked: st.acked?.pre_confirm, text: disc.pre_confirm },
-  ]
-  for (const s of stages) {
-    if (s.acked) continue
-    const body = s.text ? (window._lang === 'en' ? s.text.en : s.text.zh) : t('风险披露')
-    const go = await confirmModal(`${body}\n\n${t('我已阅读并理解上述风险')}`, t('确认(需 Passkey)'), { danger: true })
+  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, s.key)
-    if (!ok) return false
   }
-  return true
+  const ok = await window.dpDoAck(orderId, missing.length === 2 ? 'both' : missing[0])
+  return ok ? cache() : false
 }
-// Passkey 门失败(无 Passkey / 设备不支持 / 用户取消)→ 给出明确的【注册 Passkey 入口】(前往「我的 → 安全与存储」)。
-window.dpPromptRegisterPasskey = async (reason) => {
-  const go = await confirmModal(
-    `${reason ? reason + '\n\n' : ''}${t('直付的风险确认与付款标记需要 Passkey。前往「我的 → 安全与存储」注册一个?')}`,
-    t('前往注册 Passkey'), {})
-  if (go) navigate('#me')
+// 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 && e.message); return false }
+  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) => `
+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>
       <li>${t('卖家收款说明来自卖家自填,WebAZ 不验证付款方式或币种')}</li>
     </ul>
-    <div id="dp-order-instr">${loading$()}</div>
+    <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) => {
-  const box = document.getElementById('dp-order-instr')
-  if (!box) return
+  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">
@@ -147,10 +149,7 @@ window.dpHydrateOrderDisclosure = async (orderId) => {
     return
   }
   const o = await GET(`/orders/${orderId}`)
-  const snap = o && o.order ? (o.order.direct_pay_instruction_snapshot || '') : ''
-  box.innerHTML = snap ? `<div style="font-size:12px;color:#374151;background:#fff;border:1px solid #fde68a;border-radius:8px;padding:8px 10px">
-    <div style="font-size:11px;color:#9ca3af;margin-bottom:2px">${t('卖家收款说明(下单时快照)')}</div>${escHtml(snap)}<div id="dp-order-qr"></div></div>`
-    : `<div style="font-size:12px;color:#9ca3af">${t('卖家尚未设置收款说明,暂不可直付')}</div>`; if (snap && window.dpLoadOrderQr) window.dpLoadOrderQr(orderId)  // D3:ack 门后取所选账号的收款二维码(若有)
+  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)
@@ -166,10 +165,10 @@ window.dpHandleAction = async (orderId, action) => {
   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 && e.message); return }
+  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 }
+  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('操作成功'))

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-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>`
+  }
+})()