@seasonkoh/webaz 0.1.29 → 0.1.30

package/dist/pwa/public/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "WebAZ Protocol API",
     "version": "0.4.14",
-    "description": "Auto-generated endpoint inventory (717 endpoints, 17 with full schema). See docs/ for design context."
+    "description": "Auto-generated endpoint inventory (776 endpoints, 17 with full schema). See docs/ for design context."
   },
   "servers": [
     {
@@ -349,6 +349,71 @@
         ]
       }
     },
+    "/api/admin/arbitrators": {
+      "get": {
+        "summary": "名册(admin 只读,无需 Passkey)。含 active/suspended/revoked 全量 + 状态。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/arbitrators/:user_id/reinstate": {
+      "post": {
+        "summary": "POST /api/admin/arbitrators/:user_id/reinstate",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/arbitrators/:user_id/revoke": {
+      "post": {
+        "summary": "POST /api/admin/arbitrators/:user_id/revoke",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/arbitrators/:user_id/suspend": {
+      "post": {
+        "summary": "POST /api/admin/arbitrators/:user_id/suspend",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/arbitrators/grant": {
+      "post": {
+        "summary": "POST /api/admin/arbitrators/grant",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/atomic/process-ledger": {
       "post": {
         "summary": "POST /api/admin/atomic/process-ledger",
@@ -631,6 +696,58 @@
         ]
       }
     },
+    "/api/admin/direct-receive/bond-slash": {
+      "get": {
+        "summary": "── B3:保证金罚没(人工铁律:仲裁裁定卖家责的直付争议 → 提案 → 冷静期 → ROOT+Passkey 执行;绝不自动)──",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/bond-slash/:id/cancel": {
+      "post": {
+        "summary": "POST /api/admin/direct-receive/bond-slash/:id/cancel",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/bond-slash/:id/execute": {
+      "post": {
+        "summary": "执行(ROOT + 真人 Passkey,purpose direct_pay_bond_slash 绑 proposal_id;冷静期由域内绝对截止校验)。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/bond-slash/propose": {
+      "post": {
+        "summary": "提案(ROOT,审计留痕,不 Passkey —— 提案不动任何东西;执行才是终局动作)。通知卖家(冷静期=申诉窗)。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/direct-receive/deferrals": {
       "get": {
         "summary": "GET /api/admin/direct-receive/deferrals?status=pending — ROOT 审批队列(默认全部;可按 status 过滤)。纯读。",
@@ -670,6 +787,19 @@
         ]
       }
     },
+    "/api/admin/direct-receive/deposits": {
+      "get": {
+        "summary": "GET /api/admin/direct-receive/deposits?status=pending — ROOT 只读:保证金申报队列(核对到账用)。B1。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/direct-receive/deposits/:id/confirm-production": {
       "post": {
         "summary": "当前恒 fail-closed(无 legal-cleared rail → assert 抛 → PRODUCTION_RAIL_NOT_CLEARED)。",
@@ -683,6 +813,32 @@
         ]
       }
     },
+    "/api/admin/direct-receive/deposits/:id/execute-refund": {
+      "post": {
+        "summary": "unlock blockers(冷静期内可能新增退货/欠费等责任 —— 有任一即拒)。凭据必填;真实退款发生在协议外,此处只记录。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/deposits/:id/reject": {
+      "post": {
+        "summary": "不 Passkey:驳回不授予/不移动任何东西(与缓交 reject 不同 —— 那是资格决定;这里只是\"到账核不上\"退回重报)。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/direct-receive/fee-account/:seller_id": {
       "get": {
         "summary": "只读诊断,不写、无 Passkey(读不授权能力);卖家私密财务,买家/卖家拿不到此 admin 视图。",
@@ -722,6 +878,45 @@
         ]
       }
     },
+    "/api/admin/direct-receive/fee-prepay-requests": {
+      "get": {
+        "summary": "GET /api/admin/direct-receive/fee-prepay-requests?status=pending — ROOT 只读:预充值申请队列(核对到账用)。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/fee-prepay-requests/:id/approve": {
+      "post": {
+        "summary": "purpose_data 绑 request_id + seller_id + amount_units + method(把入账金额/对象钉进 Passkey)。原子:approved + recordFeePrepay + 关联 payment。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/direct-receive/fee-prepay-requests/:id/reject": {
+      "post": {
+        "summary": "POST /api/admin/direct-receive/fee-prepay-requests/:id/reject — ROOT + Passkey(不动钱)。purpose_data 绑 request_id。",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/direct-receive/fee-refund": {
       "post": {
         "summary": "amount ≤ 当前 available(helper 同事务校验)。append-only + audit。purpose_data 绑 seller_id+amount_units+method+evidence_ref。",
@@ -1376,6 +1571,54 @@
         ]
       }
     },
+    "/api/admin/platform-receive-accounts": {
+      "get": {
+        "summary": "── list(ROOT 读;含 inactive + qr_data_uri)──",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      },
+      "post": {
+        "summary": "── add(ROOT + Passkey)──",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/admin/platform-receive-accounts/:id": {
+      "delete": {
+        "summary": "── deactivate(ROOT + Passkey + 存在性)──",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      },
+      "put": {
+        "summary": "── update(ROOT + Passkey + 存在性)──",
+        "tags": [
+          "admin"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/admin/products": {
       "get": {
         "summary": "─── 商品 列表 + 强制下架 ───────────────────────────────",
@@ -2323,7 +2566,7 @@
         ]
       },
       "post": {
-        "summary": "── Issue a grant (human-authenticated). Safe scopes only; risk/never-delegable rejected. ──",
+        "summary": "agent delegation\"的安全叙事。零消费方(前端/MCP/测试均不用),故降级为不可用,统一走 pairing。",
         "tags": [],
         "security": [
           {
@@ -2343,6 +2586,13 @@
         ]
       }
     },
+    "/api/agent-grants/my-permission-requests": {
+      "get": {
+        "summary": "grant_id: an agent sees ONLY its own requests, never the human's other agents'. Audited (fail-closed).",
+        "tags": [],
+        "security": []
+      }
+    },
     "/api/agent-grants/pair/:pairing_id/retrieve": {
       "post": {
         "summary": "(pair 4) Agent retrieves the credential ONCE via PKCE verifier — UNAUTHENTICATED (PKCE-gated).",
@@ -2372,6 +2622,17 @@
         ]
       }
     },
+    "/api/agent-grants/pair/:user_code/reject": {
+      "post": {
+        "summary": "拒绝是保护性动作,无需 Passkey(不签发任何凭证)。幂等:仅 pending 可拒。",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/agent-grants/pair/start": {
       "post": {
         "summary": "(pair 1) Agent starts a pairing — UNAUTHENTICATED (agent has no credential yet). Safe scopes only.",
@@ -2379,6 +2640,51 @@
         "security": []
       }
     },
+    "/api/agent-grants/permission-requests": {
+      "get": {
+        "summary": "GET list this human's PENDING permission requests (for #agent-approvals). Human-authed.",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      },
+      "post": {
+        "summary": "NOT grantable (they need a per-action live Passkey, not a persistent grant) → structured reject.",
+        "tags": [],
+        "security": []
+      }
+    },
+    "/api/agent-grants/permission-requests/:id/approve": {
+      "post": {
+        "summary": "POST approve — human-authed + live Passkey; expands the bound grant (union scopes + bundle + extend expiry). Audited.",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/agent-grants/permission-requests/:id/reject": {
+      "post": {
+        "summary": "POST reject — human-authed. Terminal 'rejected'; nothing is granted.",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/agent-grants/verify": {
+      "get": {
+        "summary": "Audited (acceptance #8: every grant use logs). Never returns the raw token/api_key.",
+        "tags": [],
+        "security": []
+      }
+    },
     "/api/agent-grants/whoami": {
       "get": {
         "summary": "end-to-end on a brand-new read-only endpoint that touches NO existing route and NO money path.",
@@ -2458,6 +2764,18 @@
         "security": []
       }
     },
+    "/api/agent/seller/products": {
+      "get": {
+        "summary": "The consumption (allow AND the permission_required deny) is audited by the middleware.",
+        "tags": [],
+        "security": [
+          {
+            "grantBearer": []
+          }
+        ],
+        "x-webaz-grant-scope": "seller_products_read"
+      }
+    },
     "/api/agent/verifiability": {
       "get": {
         "summary": "GET /api/agent/verifiability",
@@ -3476,7 +3794,7 @@
     },
     "/api/direct-pay/disclosure-acks": {
       "post": {
-        "summary": "POST — 记录一次 ack(D1 pre_select / D2 pre_confirm)。需现场真人(Passkey + gate token)。幂等(INSERT OR IGNORE)。",
+        "summary": "stage:'both' —— 单 stage token 冒充不了 both,both token 也重放不了单 stage(一次性消费 + validate 精确匹配)。",
         "tags": [],
         "security": [
           {
@@ -3556,18 +3874,106 @@
         ]
       }
     },
-    "/api/direct-receive/deferral": {
-      "get": {
-        "summary": "GET /api/direct-receive/deferral — 卖家本人缓交状态:最新一条申请(脱敏:不含 admin 身份)+ 是否当前生效(active)。",
+    "/api/direct-receive/bond-deposit": {
+      "post": {
+        "summary": "POST /api/direct-receive/bond-deposit",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/bond-deposit/:id/cancel": {
+      "post": {
+        "summary": "POST /api/direct-receive/bond-deposit/:id/cancel",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/bond-refund-request": {
+      "post": {
+        "summary": "── B2:退出退还 —— 申请(§5 blockers fail-closed)→ 冷静期 → admin 执行;申请期间直付资格暂停,可撤销 ──",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/bond-refund-request/cancel": {
+      "post": {
+        "summary": "POST /api/direct-receive/bond-refund-request/cancel",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/bond-status": {
+      "get": {
+        "summary": "GET /api/direct-receive/bond-status",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/deferral": {
+      "get": {
+        "summary": "GET /api/direct-receive/deferral — 卖家本人缓交状态:最新一条申请(脱敏:不含 admin 身份)+ 是否当前生效(active)。",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      },
+      "post": {
+        "summary": "POST /api/direct-receive/deferral — 卖家申请缓交。helper 强制:单一活跃、periodDays 正整数、id 唯一。",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/fee-prepay-request": {
+      "post": {
+        "summary": "── 提交预充值申请(不 Passkey;凭据必填)──",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/direct-receive/fee-prepay-request/:id/cancel": {
+      "post": {
+        "summary": "── 卖家撤销自己的 pending 申请 ──",
         "tags": [],
         "security": [
           {
             "bearerAuth": []
           }
         ]
-      },
-      "post": {
-        "summary": "POST /api/direct-receive/deferral — 卖家申请缓交。helper 强制:单一活跃、periodDays 正整数、id 唯一。",
+      }
+    },
+    "/api/direct-receive/fee-prepay-requests": {
+      "get": {
+        "summary": "── 卖家看自己的申请(全状态)──",
         "tags": [],
         "security": [
           {
@@ -3616,6 +4022,17 @@
         ]
       }
     },
+    "/api/direct-receive/platform-receive-accounts": {
+      "get": {
+        "summary": "── 卖家看平台收款方式(active;含 instruction + qr_data_uri —— 平台公开收款明细,据此付款)──",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/direct-receive/product-verification": {
       "post": {
         "summary": "POST /api/direct-receive/product-verification — 卖家为某产品申领验证码(单一活跃 per product)。",
@@ -4060,7 +4477,7 @@
     },
     "/api/external-anchors/:id/distribute-rewards": {
       "post": {
-        "summary": "手动 distribute（admin/arbitrator 补救：anchor 已 community 但 fee_paid_out=0）",
+        "summary": "白名单(isEligibleArbitrator),不认 legacy user.role(否则已 suspend/revoke 但 role 未同步的账号仍可触发放款)。",
         "tags": [],
         "security": [
           {
@@ -5280,9 +5697,87 @@
         ]
       }
     },
+    "/api/orders/:id/cancel-refund": {
+      "get": {
+        "summary": "GET /api/orders/:id/cancel-refund",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/cancel-refund/confirm": {
+      "post": {
+        "summary": "POST /api/orders/:id/cancel-refund/confirm",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/cancel-refund/decline": {
+      "post": {
+        "summary": "POST /api/orders/:id/cancel-refund/decline",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/cancel-refund/mark-refunded": {
+      "post": {
+        "summary": "POST /api/orders/:id/cancel-refund/mark-refunded",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/cancel-refund/request": {
+      "post": {
+        "summary": "POST /api/orders/:id/cancel-refund/request",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/cancel-refund/withdraw": {
+      "post": {
+        "summary": "POST /api/orders/:id/cancel-refund/withdraw",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/orders/:id/chain": {
       "get": {
-        "summary": "订单签名链 — 当事人 + arbitrator + admin 可查",
+        "summary": "订单签名链 — 当事人 + 白名单仲裁员(涉争议订单) + admin 可查",
         "tags": [
           "order"
         ],
@@ -5358,6 +5853,136 @@
         ]
       }
     },
+    "/api/orders/:id/mutual-cancel": {
+      "get": {
+        "summary": "GET /api/orders/:id/mutual-cancel",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/mutual-cancel/accept": {
+      "post": {
+        "summary": "POST /api/orders/:id/mutual-cancel/accept",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/mutual-cancel/decline": {
+      "post": {
+        "summary": "POST /api/orders/:id/mutual-cancel/decline",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/mutual-cancel/propose": {
+      "post": {
+        "summary": "POST /api/orders/:id/mutual-cancel/propose",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/mutual-cancel/withdraw": {
+      "post": {
+        "summary": "POST /api/orders/:id/mutual-cancel/withdraw",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/pending-accept/accept": {
+      "post": {
+        "summary": "卖家确认接单 → 开付款窗口(deadline 此刻起表;收款信息此刻起买家可见 —— orders-read 状态门放行)",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/pending-accept/cancel": {
+      "post": {
+        "summary": "买家撤单(接单前反悔)→ 无责取消 + 回补库存",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/pending-accept/confirm-quote": {
+      "post": {
+        "summary": "CAS:仅 pending_accept 且已报价;总额变更与状态转移同一 db.transaction(要么全生效要么全回滚)。",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/pending-accept/decline": {
+      "post": {
+        "summary": "卖家谢绝(无法发货/物流不可达等;理由可选,买家可见)→ 无责取消 + 回补库存",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/orders/:id/pending-accept/quote": {
+      "post": {
+        "summary": "可重复报价(买家确认前修正);每次报价重置响应窗(param direct_pay.quote_confirm_hours,默认 48h)。",
+        "tags": [
+          "order"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/orders/:order_id/buyer-rating": {
       "get": {
         "summary": "查 seller → buyer 评价（双盲遮蔽：buyer 看不到，除非自己也评过 OR 窗口到期）",
@@ -5914,6 +6539,13 @@
         "security": []
       }
     },
+    "/api/products/:id/shipping-options": {
+      "get": {
+        "summary": "公开读:买家下单前查配送范围。生效 = 单品覆盖 ?? 店铺默认;template=null → 不按地区计费(下单不要求选地区)。",
+        "tags": [],
+        "security": []
+      }
+    },
     "/api/products/:id/status": {
       "patch": {
         "summary": "状态切换（active / warehouse / deleted）",
@@ -6599,6 +7231,17 @@
         ]
       }
     },
+    "/api/return-requests/:id/confirm-refund": {
+      "post": {
+        "summary": "POST /api/return-requests/:id/confirm-refund",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/return-requests/:id/decide": {
       "post": {
         "summary": "POST /api/return-requests/:id/decide",
@@ -6621,6 +7264,17 @@
         ]
       }
     },
+    "/api/return-requests/:id/mark-refunded": {
+      "post": {
+        "summary": "POST /api/return-requests/:id/mark-refunded",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/return-requests/:id/messages": {
       "post": {
         "summary": "POST /api/return-requests/:id/messages",
@@ -6855,6 +7509,17 @@
         ]
       }
     },
+    "/api/seller/accept-mode": {
+      "post": {
+        "summary": "POST /api/seller/accept-mode",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/seller/apply-quota-increase": {
       "post": {
         "summary": "POST /api/seller/apply-quota-increase",
@@ -6888,6 +7553,28 @@
         ]
       }
     },
+    "/api/seller/shipping-settings": {
+      "get": {
+        "summary": "卖家读自己的店铺级设置(设置 UI 回显):接单模式 + 运费模板 + 询价开关。",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
+    "/api/seller/shipping-template": {
+      "post": {
+        "summary": "POST /api/seller/shipping-template",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/seller/withdraw-quota-application": {
       "post": {
         "summary": "POST /api/seller/withdraw-quota-application",
@@ -6917,6 +7604,17 @@
         ]
       }
     },
+    "/api/sellers/me/direct-pay-report": {
+      "get": {
+        "summary": "from/to 均可选(闭区间,按日期比较 substr(created_at,1,10));返回汇总 + 按月 + 逐单(含平台费明细)。",
+        "tags": [],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/sellers/me/flash-sales": {
       "get": {
         "summary": "seller 自己的 flash sales（全部状态）",