cbs-4px-merchant-cli 0.0.11 → 0.0.13

package/dist/types/index.d.ts

@@ -97,6 +97,51 @@ export interface BillingFeeItemDetailVO {
     currencyCode: string | null;
     billingSuccessDateStr: string | null;
 }
+/** 单条字段规则（长度/正则/必填等），来自规则库配置 */
+export interface FieldRule {
+    ruleType: string | null;
+    ruleTypeDesc: string | null;
+    ruleValue: string | null;
+}
+/** 某个下单字段的规则集合 */
+export interface OrderFieldRuleItem {
+    field: string | null;
+    /**
+     * 该字段在 order create/edit 的 JSON 里的路径，如 receiver.name、parcel.weight、
+     * declareItems[].qty。后端直接给出，不需要自己从 field 换算（两套命名不是驼峰转换）。
+     * null 表示该字段不能通过建单/改单接口设置。
+     */
+    requestPath: string | null;
+    fieldLabel: string | null;
+    fieldElabel: string | null;
+    required: boolean | null;
+    rules: FieldRule[];
+    placeholder: string[];
+    msg: string | null;
+}
+/**
+ * 跨字段联动约束。无法用「单字段必填」表达，必须单独判断。
+ */
+export interface FieldRuleLinkage {
+    iossOrVatEitherRequired: boolean | null;
+    hscodeRequiredWhenIoss: boolean | null;
+    idOrVatEitherRequired: boolean | null;
+    currencyCustoms: string | null;
+    currencyMustBeConsistent: boolean | null;
+}
+/**
+ * 下单字段规则全量清单。
+ *
+ * 必填性由规则库按 (产品, 目的国, 客户, 单据状态) 配置，不同产品结论不同 —— 这是
+ * 判断字段必填的唯一权威来源，不要在客户端另写一份清单。
+ */
+export interface OrderFieldRulesResp {
+    productCode: string | null;
+    country: string | null;
+    fields: OrderFieldRuleItem[];
+    linkage: FieldRuleLinkage | null;
+    chatReply: string | null;
+}
 export interface OrderDetailResp {
     orderDTO: OrderVO | null;
     shipperConsigneeDTO: ShipperConsigneeVO | null;
@@ -340,6 +385,9 @@ export interface ProblemListRequest {
     pageSize?: number;
 }
 export interface AbnormalProblem {
+    reasonCode: string | null;
+    abnId: number | null;
+    reasonId: number | null;
     abnormalTypeName: string | null;
     abnormalReasonName: string | null;
     abnormalDescription: string | null;
@@ -458,6 +506,42 @@ export interface ChangeProductResp {
     success: boolean;
     message: string | null;
 }
+/** 下达走货指令参数 */
+export interface ShipmentSubmitParams {
+    orderNo: string;
+    reasonCode: string;
+    solutionChildTypeNo: number;
+    newFpxTrackNo?: string;
+    remark?: string;
+    content?: string;
+}
+/** 下达退件指令参数 */
+export interface ReturnSubmitParams {
+    orderNo: string;
+    reasonCode: string;
+    returnAddressId?: number;
+}
+/** 下达销毁指令参数 */
+export interface DestroySubmitParams {
+    orderNo: string;
+    reasonCode: string;
+}
+/** 退件地址项 */
+export interface ReturnAddressItem {
+    id: number | null;
+    consigneeName: string | null;
+    consigneeTel: string | null;
+    province: string | null;
+    city: string | null;
+    district: string | null;
+    streetAddress: string | null;
+    returnType: string | null;
+    isDefault: string | null;
+}
+/** 退件地址库列表 */
+export interface ReturnAddressListResp {
+    list: ReturnAddressItem[];
+}
 export interface ServiceRepairOrderListRequest {
     orderCodeListString?: string;
     businessLineId?: number;
@@ -913,6 +997,24 @@ export interface PlatformOrderItem {
     createdTime: string | null;
     pushTime: string | null;
 }
+export interface PlatformOrderUpdateResp {
+    updatedIds: string[];
+    failed: {
+        id: string;
+        errMsg: string;
+    }[];
+}
+/**
+ * push 的失败明细（每个未能推送的订单一条）。
+ *
+ * 后端只回失败项：**空数组表示全部推送成功**。已推送的单会以
+ * "订单已推送…不能重复推送" 出现在这里 —— 后端按状态拒绝，防止重复建物流单。
+ */
+export interface PlatformOrderPushFailure {
+    id?: string | null;
+    customerOrderNo?: string | null;
+    errMsg?: string | null;
+}
 export interface PlatformOrderListResp {
     pageNum: number;
     pageSize: number;
@@ -950,6 +1052,31 @@ export interface PlatformOrderDetailResp {
     buyerId: string | null;
     buyerNote: string | null;
     createdTime: string | null;
+    receiverCompany: string | null;
+    addressLine1: string | null;
+    addressLine2: string | null;
+    countryCode: string | null;
+    countryName: string | null;
+    county: string | null;
+    buyerEmail: string | null;
+    sellerNote: string | null;
+    /** 寄件人整组：平台单 sync 回来必为空，push 前须补齐 */
+    senderName: string | null;
+    senderCompany: string | null;
+    senderTelephone: string | null;
+    senderAddress: string | null;
+    senderCity: string | null;
+    senderProvince: string | null;
+    senderPostcode: string | null;
+    senderId: string | null;
+    ioss: string | null;
+    vatNo: string | null;
+    eori: string | null;
+    tariffno: string | null;
+    hasBattery: string | null;
+    returnsign: string | null;
+    transactionId: string | null;
+    fulfillmentOrderId: string | null;
     items: PlatformOrderItemDetail[] | null;
 }
 export interface IndivAuthRequest {
@@ -1143,6 +1270,8 @@ export interface OrderParcelInfo {
     dutyPayMode?: string;
     batteryType?: string;
     iossNo?: string;
+    /** EORI 号（欧盟进口商登记号）。后端字段名为 tariffNo */
+    eoriNo?: string;
     orderNote?: string;
     salesPlatform?: string;
     warehouseCode?: string;
@@ -1162,12 +1291,19 @@ export interface OrderDeclareItemInfo {
     url?: string;
     brand?: string;
 }
-/** `P` = 预报（直接提交），`D` = 草稿（保存不提交）。后端默认 `P`。 */
+/**
+ * `P` = 预报（直接提交），`D` = 草稿（保存不提交）。后端默认 `P`。
+ *
+ * 后端已改用语义化的 `draft` 布尔，`status` 仅作兼容保留。订单 JSON 里两者都接受，
+ * CLI 会统一转成 `draft` 发出。
+ */
 export type OrderWriteStatus = 'P' | 'D';
 export interface CreateOrderRequest {
     productCode: string;
     destinationCountry: string;
     originCountry?: string;
+    /** 保存为草稿。与 status 二选一，同时存在时 draft 优先 */
+    draft?: boolean;
     status?: OrderWriteStatus;
     customerOrderNo?: string;
     pieces?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbs-4px-merchant-cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Cbs merchant CLI tool",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,12 @@
     "build:cainiao:test": "SITE=cainiao ENV=test npm run build",
     "build:cainiao:pre": "SITE=cainiao ENV=pre npm run build",
     "package:role-skills": "bash scripts/package-role-skills.sh",
+    "build:binary:4px": "node scripts/build-binary.mjs --site 4px --env prod",
+    "build:binary:cainiao": "node scripts/build-binary.mjs --site cainiao --env prod",
+    "build:binary:host": "node scripts/build-binary.mjs --site 4px --env prod --host",
+    "oss:upload": "node scripts/oss-upload.mjs",
+    "oss:upload:dry": "node scripts/oss-upload.mjs --dry-run",
+    "release:binary": "npm run build:binary:4px && npm run build:binary:cainiao && npm run oss:upload",
     "dev:4px:test": "SITE=4px ENV=test npm run build && node dist/index.js skill install",
     "dev:4px:pre": "SITE=4px ENV=pre npm run build && node dist/index.js skill install",
     "dev:cainiao:test": "SITE=cainiao ENV=test npm run build && node dist/index.js skill install",

package/skill/SKILL.md

@@ -42,7 +42,7 @@ description: >-
 | 产品推荐 | [`reference/product.md`](reference/product.md) | 参数多（国家/重量/电池/邮编等），必须确认 |
 | 理赔查询 | [`reference/service.md`](reference/service.md) | 参数多（单号/时间/状态/分页），必须确认 |
 | 异常件管理 | [`reference/problem.md`](reference/problem.md) | 确认子命令和参数格式 |
-| 异常托管（改带电/改产品） | [`reference/custody.md`](reference/custody.md) | 含写操作，必须确认参数和确认机制 |
+| 异常托管（改带电/改产品/走货/退件/销毁） | [`reference/custody.md`](reference/custody.md) | 含写操作（销毁不可逆），必须确认参数和确认机制 |
 | 服务中心 | [`reference/service.md`](reference/service.md) | 确认子命令和参数格式 |
 | 财务管理 | [`reference/finance.md`](reference/finance.md) | 确认子命令和参数格式 |
 | 揽收管理 | [`reference/pickup.md`](reference/pickup.md) | 确认参数格式 |
@@ -70,7 +70,7 @@ description: >-
 | `product` | 产品推荐：推荐产品、产品列表、产品详情、时效查询、搜索产品 | [`reference/product.md`](reference/product.md) |
 | `claim` | 理赔查询：按单号/时间/状态查询理赔列表（挂在 `service` 下，即 `fmc service claim ...`） | [`reference/service.md`](reference/service.md) |
 | `problem` | 异常件管理：问题件列表、AI处理建议、通知件、尾程异常、欠费件、拦截件 | [`reference/problem.md`](reference/problem.md) |
-| `custody` | 异常托管：改带电产品查询、AI推荐改产品、批量提交改产品（写操作） | [`reference/custody.md`](reference/custody.md) |
+| `custody` | 异常托管：改带电/改产品查询与提交、查可下达指令、走货/退件/销毁指令下达（写操作，销毁不可逆）、退件地址库查询 | [`reference/custody.md`](reference/custody.md) |
 | `service` | 服务中心：售后工单、查件、投诉、服务单详情、处理记录、理赔详情 | [`reference/service.md`](reference/service.md) |
 | `finance` | 财务管理：账户余额、账单、每日费用、未出账汇总及明细、充值记录（在线及线下）、计费明细 | [`reference/finance.md`](reference/finance.md) |
 | `pickup` | 揽收管理：物料申请单查询 | [`reference/pickup.md`](reference/pickup.md) |
@@ -106,6 +106,10 @@ description: >-
 用户提到"拦截/拦截件" → `fmc problem intercepted`
 用户提到"改带电/换带电产品" → `fmc custody electric`
 用户提到"改产品/换产品/推荐异常产品" → `fmc custody recommend`
+用户提到"这个异常能下哪些指令/可下达指令" → `fmc custody help`
+用户提到"走货/确认走货/换单号走货" → `fmc custody ship`（写操作，先确认）
+用户提到"退件/退回/退货" → `fmc custody return`（写操作，先确认）；查退件地址用 `custody address`
+用户提到"销毁/丢弃/不要了" → `fmc custody destroy`（写操作，不可逆，务必确认）
 用户提到"批量处理异常/托管处理" → 参考跟单助理角色 SOP
 用户提到"工单/售后/报修" → `fmc service repair`
 用户提到"查件/查件进度" → `fmc service check`
@@ -119,7 +123,8 @@ description: >-
 用户提到"计费明细" → `fmc finance fee-detail`
 用户提到"地址簿/地址列表" → `fmc order address-book`
 用户提到"目的国/国家查询/搜索国家" → `fmc order country`
-用户提到"下单/开单/建单/寄一个包裹" → `fmc order create --draft`（**写**，先建草稿让用户核对）
+用户提到"哪些字段必填/要填什么/这个字段怎么填" → `fmc order field-rules --product-code <code> --country <cc>`
+用户提到"下单/开单/建单/寄一个包裹" → 先 `fmc order field-rules --required-only` 查必填，再 `fmc order create --draft`（**写**，先建草稿让用户核对）
 用户提到"改单/修改订单/改地址改重量" → `fmc order edit`（**写**，仅草稿与已取消单可改）
 用户提到"提交预报/发出去/确认发货" → `fmc order forecast`（**写**）
 用户提到"取消订单/不寄了/作废" → `fmc order cancel`（**写**）
@@ -144,6 +149,7 @@ description: >-
 用户提到"对公打款/要不要打款" → 入驻流程已取消对公打款环节（`auth organ` 成功即认证完成），用 `fmc onboarding auth schedule` 佐证后告知"无需打款"
 用户提到"可开通品牌/有哪些品牌" → `fmc onboarding brand list`
 用户提到"开通品牌/申请合同" → `fmc onboarding brand open`（**写**）
+用户提到"重复入驻/账号重复注册/通知销售" → `fmc onboarding notify-saler`（**写**，仅在 `brand open` 报重复入驻时用，勿重复发送）
 用户提到"合同/我的合同" → `fmc onboarding contract list`
 用户提到"签合同/签署链接/下载合同" → `fmc onboarding contract url`（须带 `--status`，取自 `contract list`）
 用户提到"登录/配置key/认证" → `fmc auth login`
@@ -210,6 +216,7 @@ export BPORTAL_API_KEY=sk-xxxxx
 | `platform order push` | 订单进入物流履约流程 |
 | `onboarding auth indiv` / `auth code` / `auth organ` / `auth gat` | 提交实名认证资料 |
 | `onboarding brand open` | 开通品牌并发起合同申请 |
+| `onboarding notify-saler` | 重复入驻时通知对应销售（勿重复发送） |
 
 执行规则：
 
@@ -327,7 +334,7 @@ fmc config set baseUrl https://b.4px.com
 - [`reference/order.md`](reference/order.md) — 订单管理详细参数
 - [`reference/product.md`](reference/product.md) — 产品推荐与查询详细参数
 - [`reference/problem.md`](reference/problem.md) — 异常件管理详细参数
-- [`reference/custody.md`](reference/custody.md) — 异常托管（改带电/改产品）详细参数
+- [`reference/custody.md`](reference/custody.md) — 异常托管（改带电/改产品/走货/退件/销毁）详细参数
 - [`reference/service.md`](reference/service.md) — 服务中心与理赔查询详细参数
 - [`reference/finance.md`](reference/finance.md) — 财务管理详细参数
 - [`reference/pickup.md`](reference/pickup.md) — 揽收管理详细参数

package/skill/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbs-4px-merchant-cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "BPortal Merchant CLI (fmc) skill — BPortal",
   "files": [
     "SKILL.md",

package/skill/reference/custody.md

@@ -1,13 +1,19 @@
 # `fmc custody` command
 
-> 异常托管 — 改带电 / 改产品。配合 `fmc problem list` 使用。
+> 异常托管 — 改带电 / 改产品 / 走货 / 退件 / 销毁。配合 `fmc problem list` 使用。
 
 ## 背景
 
 当订单在仓库上架时出现异常（如内置电池、磁性物品、无渠道等），商家可通过以下命令将订单
-改换为支持带电的物流产品或替换为有渠道的产品，从而让异常单恢复正常走货。
+改换为支持带电的物流产品或替换为有渠道的产品，或直接对异常单下达走货/退件/销毁指令，
+从而让异常单闭环处理。
 
-### 异常原因编码速查
+### reasonCode 获取方式
+
+`problem list --output json` 返回的 `abnormalProblems[]` 中直接包含 `reasonCode`、`abnId`、
+`reasonId` 三个定位字段——**下达指令时的 `--reason` 直接取 `reasonCode`，无需再做中文名映射**。
+
+### 改带电/改产品异常原因编码速查
 
 | abnormalReasonName | reasonCode | 处理流程 |
 | --- | --- | --- |
@@ -15,7 +21,22 @@
 | 磁性物品 | CXW | 改带电 → `custody electric` |
 | 无渠道 | NC | 改产品 → `custody recommend` |
 
-`problem list --output json` 返回的 `abnormalProblems[].abnormalReasonName` 即为上表中文列。
+### 走货二级指令支持矩阵
+
+`custody ship` 仅支持**无附件、无复杂表单**的走货二级指令；其余指令请转页面处理。
+
+| 类别 | 二级指令编号 | 命令支持 | 备注 |
+| --- | --- | --- | --- |
+| 直接走货 | 1, 5, 23 | ✅ | 认可重量/认可费用/填充包装走货 |
+| 换单号走货 | 8, 13, 26 | ✅ | **必须** `--new-track-no` |
+| 带说明走货 | 24, 25, 27, 28 | ✅ | **必须** `--remark` |
+| 其他 | 17 | ✅ | **必须** `--content` |
+| 需上传附件 | 2, 9, 11, 12, 16 | ❌ | 转页面处理 |
+| 需填复杂表单 | 3, 6, 7, 15 | ❌ | 转页面处理 |
+| 改带电/改产品 | 32, 33 | ❌ | 改用 `custody change` |
+
+> 服务端在提交前会强制调 `get_abnormality_help` 校验该指令是否允许下达；若指令不可下达，
+> 命令会**原样输出服务端返回的可下达指令列表提示**，据此改用正确的二级指令编号重试。
 
 ---
 
@@ -167,6 +188,185 @@ fmc custody change --order-nos FPX12345678 --pk-code ECO-PKG-BAT --reason NZDC -
 
 ---
 
+### `fmc custody help`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `custody help` |
+| **Description** | 查询异常单当前可下达的一级/二级指令列表 |
+| **Usage** | `fmc custody help <orderNo> --reason <code> [flags]` |
+
+需要 API Key 认证。下达走货/退件/销毁指令前，先用它确认可下达的指令编号。
+
+#### Arguments
+
+| Argument | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<orderNo>` | string | yes | 物流单号 |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--reason <code>` | string | yes | 异常原因编码，取自 problem list 的 `abnormalProblems[].reasonCode` |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc custody help FPX12345678 --reason WD
+fmc custody help FPX12345678 --reason WD --output json
+```
+
+#### Output (text mode)
+
+```
+可下达指令
+──────────────────────────────────────────────────
+
+  走货(1)
+    → 认可重量，确认走货(1)
+    → 更换新单号走货(8)
+
+  退件(2)
+    无二级指令
+
+  销毁(3)
+    无二级指令
+```
+
+---
+
+### `fmc custody ship`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `custody ship` |
+| **Description** | 对异常单下达走货指令（写操作） |
+| **Usage** | `fmc custody ship --order-nos <nos> --reason <code> --child <no> [flags]` |
+
+需要 API Key 认证。**这是写操作**，默认二次确认；非交互环境须加 `-y`。走货支持矩阵见上方「走货二级指令支持矩阵」。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | yes | 物流单号，多个用逗号分隔 |
+| `--reason <code>` | string | yes | 异常原因编码 |
+| `--child <no>` | string | yes | 走货二级指令编号，取自 `custody help` 输出 |
+| `--new-track-no <no>` | string | no | 新物流单号（二级指令 8/13/26 必填） |
+| `--remark <text>` | string | no | 说明（二级指令 24/25/27/28 必填） |
+| `--content <text>` | string | no | 补充说明文本（二级指令 17 必填） |
+| `-y, --yes` | boolean | no | 跳过确认 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+# 认可重量走货
+fmc custody ship --order-nos FPX12345678 --reason WD --child 1
+# 换新单号走货（必带新单号）
+fmc custody ship --order-nos FPX001,FPX002 --reason WD --child 8 --new-track-no FPXNEW001 -y
+# 其他（必带说明文本）
+fmc custody ship --order-nos FPX12345678 --reason WD --child 17 --content "已与客户确认继续走货"
+```
+
+---
+
+### `fmc custody return`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `custody return` |
+| **Description** | 对异常单下达退件指令（写操作） |
+| **Usage** | `fmc custody return --order-nos <nos> --reason <code> [flags]` |
+
+需要 API Key 认证。**这是写操作**。退件地址取自商家退件地址库；未指定 `--address-id` 时使用默认退件地址（确认文案会提示）。可先用 `custody address` 查看可用地址。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | yes | 物流单号，多个用逗号分隔 |
+| `--reason <code>` | string | yes | 异常原因编码 |
+| `--address-id <id>` | string | no | 退件地址标识（取自 `custody address`，不传则使用默认退件地址） |
+| `-y, --yes` | boolean | no | 跳过确认 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+# 使用默认退件地址
+fmc custody return --order-nos FPX12345678 --reason WD
+# 指定退件地址
+fmc custody return --order-nos FPX001,FPX002 --reason WD --address-id 3 -y
+```
+
+---
+
+### `fmc custody destroy`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `custody destroy` |
+| **Description** | 对异常单下达销毁指令（写操作，**不可逆**） |
+| **Usage** | `fmc custody destroy --order-nos <nos> --reason <code> [flags]` |
+
+需要 API Key 认证。**这是不可逆写操作**，确认文案含销毁警示，下达前务必与用户确认。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | yes | 物流单号，多个用逗号分隔 |
+| `--reason <code>` | string | yes | 异常原因编码 |
+| `-y, --yes` | boolean | no | 跳过确认 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc custody destroy --order-nos FPX12345678 --reason WD
+```
+
+---
+
+### `fmc custody address`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `custody address` |
+| **Description** | 查询商家退件地址库列表 |
+| **Usage** | `fmc custody address [flags]` |
+
+需要 API Key 认证。下达退件指令前用它确认 `--address-id`，或核对默认地址。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc custody address
+fmc custody address --output json
+```
+
+#### Output (text mode)
+
+```
+退件地址库
+──────────────────────────────────────────────────
+
+  id=3 [默认]  张三  13800000000
+    广东省深圳市南山区科技园路1号
+    退件方式：快递退件
+```
+
+---
+
 ## 典型工作流
 
 ### A. 内电/磁性物品 → 改带电
@@ -191,3 +391,16 @@ fmc custody change --order-nos FPX12345678 --pk-code ECO-PKG-BAT --reason NZDC -
 4. 无渠道类 → 逐单 `custody recommend` 查推荐 → 汇总后一次 `custody change`
 5. 首次执行前向用户确认，确认后加 `-y` 批量执行
 6. 执行完毕后向用户报告成功/失败/差价
+
+### D. 走货 / 退件 / 销毁（通用异常处理闭环）
+
+1. `fmc problem list --abnormal-status unresolved --output json`
+   → 取每条异常问题的 `reasonCode`（直接来自 `abnormalProblems[].reasonCode`，无需中文名映射）
+2. `fmc custody help <orderNo> --reason <reasonCode>` → 列出可下达的一级/二级指令编号
+3. 根据用户诉求选择指令下达（写操作，`-y` 前须先向用户确认）：
+   - 走货：`custody ship --order-nos <no> --reason <code> --child <二级编号> [--new-track-no|--remark|--content]`
+   - 退件：先 `custody address` 确认地址 → `custody return --order-nos <no> --reason <code> [--address-id <id>]`
+   - 销毁（**不可逆**）：`custody destroy --order-nos <no> --reason <code>`（务必向用户强调不可逆）
+4. 若提交因前置校验未通过失败：命令会原样输出「可下达指令列表」提示，据此改用正确的二级指令编号重试
+5. 走货指令若命中不支持矩阵（附件类/复杂表单类/改带电改产品），提示用户转页面处理或改用 `custody change`
+6. 执行完毕后向用户报告成功/失败明细

package/skill/reference/index.md

@@ -41,6 +41,11 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `fmc custody electric` | 查询可改带电产品列表 | [custody.md](custody.md) |
 | `fmc custody recommend` | 获取 AI 推荐改产品方案 | [custody.md](custody.md) |
 | `fmc custody change` | 批量提交改带电/改产品（写） | [custody.md](custody.md) |
+| `fmc custody help` | 查询异常单可下达的指令列表 | [custody.md](custody.md) |
+| `fmc custody ship` | 下达走货指令（写） | [custody.md](custody.md) |
+| `fmc custody return` | 下达退件指令（写） | [custody.md](custody.md) |
+| `fmc custody destroy` | 下达销毁指令（写，不可逆） | [custody.md](custody.md) |
+| `fmc custody address` | 查询退件地址库 | [custody.md](custody.md) |
 | `fmc service repair list` | 查询售后工单列表 | [service.md](service.md) |
 | `fmc service check list` | 查询查件列表 | [service.md](service.md) |
 | `fmc service complaint list` | 查询投诉列表 | [service.md](service.md) |
@@ -85,6 +90,7 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `fmc onboarding auth gat` | 提交港澳台/海外实名资料（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding brand list` | 查询可开通品牌 | [onboarding.md](onboarding.md) |
 | `fmc onboarding brand open` | 开通品牌并申请合同（写） | [onboarding.md](onboarding.md) |
+| `fmc onboarding notify-saler` | 重复入驻时通知对应销售（写） | [onboarding.md](onboarding.md) |
 | `fmc onboarding contract list` | 查询合同列表 | [onboarding.md](onboarding.md) |
 | `fmc onboarding contract url` | 获取合同签署/下载链接 | [onboarding.md](onboarding.md) |
 | `fmc update` | 升级 CLI 及对应 skill 到最新版本 | [update.md](update.md) |
@@ -103,14 +109,14 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `order` | `get`, `list`, `address-book`, `country`, `create`, `edit`, `forecast`, `cancel`, `intercept` | [order.md](order.md) |
 | `product` | `recommend`, `list`, `detail`, `eta`, `search` | [product.md](product.md) |
 | `problem` | `list`, `suggest`, `notify list`, `notify type`, `lastmile list`, `arrear list`, `intercepted list` | [problem.md](problem.md) |
-| `custody` | `electric`, `recommend`, `change` | [custody.md](custody.md) |
+| `custody` | `electric`, `recommend`, `change`, `help`, `ship`, `return`, `destroy`, `address` | [custody.md](custody.md) |
 | `service` | `repair list`, `check list`, `complaint list`, `detail`, `record`, `claim list`, `claim detail`, `claim reason` | [service.md](service.md) |
 | `finance` | `balance`, `bill list`, `daily-fee list`, `unbilled list`, `recharge list`, `fee detail`, `frozen list` | [finance.md](finance.md) |
 | `pickup` | `material list`, `material detail`, `material quota`, `address list` | [pickup.md](pickup.md) |
 | `notice` | `list`, `detail`, `message list`, `message detail`, `message unread` | [notice.md](notice.md) |
 | `customs` | `cargo list`, `commodity list`, `commodity detail`, `hscode search`, `registration info` | [customs.md](customs.md) |
 | `platform` | `account list`, `sync`, `sync-record list`, `order list`, `order detail`, `order push` | [platform.md](platform.md) |
-| `onboarding` | `progress`, `customer-type`, `auth schedule`, `auth indiv`, `auth code`, `auth organ`, `auth gat`, `brand list`, `brand open`, `contract list`, `contract url` | [onboarding.md](onboarding.md) |
+| `onboarding` | `progress`, `customer-type`, `auth schedule`, `auth indiv`, `auth code`, `auth organ`, `auth gat`, `brand list`, `brand open`, `notify-saler`, `contract list`, `contract url` | [onboarding.md](onboarding.md) |
 | `update` | (no subcommand) | [update.md](update.md) |
 | `skill` | `install`, `status`, `uninstall` | [update.md](update.md) |
 
@@ -129,7 +135,7 @@ Command **details** are in sibling `<group>.md` files in this directory.
 - `track get` 命令无需认证即可使用。
 - 其余大部分命令需要先配置 API Key：`fmc auth login --api-key <key>`。Key 是控制台生成的原串（常见前缀 `SK_` 或 `sk-`），原样传入，不要校验或改写。
 - 新增的 `problem`、`service`、`finance`、`pickup`、`notice`、`customs`、`platform`、`onboarding` 模块均需要 API Key 认证。`order` 模块下的 `address-book`、`country` 子命令也需要认证。
-- **写操作**（`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open`）默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则命令会拒绝执行并以退出码 1 结束。先用 `--dry-run` 可查看将发送的请求。
+- **写操作**（`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open`、`onboarding notify-saler`）默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则命令会拒绝执行并以退出码 1 结束。先用 `--dry-run` 可查看将发送的请求。
 - 实名认证会提交身份证号、银行卡号、验证码、手机号等敏感信息。这些参数在 `--verbose` / `--dry-run` 的**打印**里被遮蔽为 `****`，但真实值仍会随请求发送。
 - 配置文件位于 `~/.bportal/config.json`；升级状态缓存位于 `~/.bportal/update-state.json`。
 - 当检测到新版本可用时，stderr 会输出 `{"_notice":{"type":"update",...}}`；设置环境变量 `BPORTAL_NO_UPDATE_NOTIFIER=1` 可关闭。

package/skill/reference/onboarding.md

@@ -495,6 +495,48 @@ fmc onboarding brand open --service-code DSS \
 
 ---
 
+### `fmc onboarding notify-saler`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `onboarding notify-saler` |
+| **Description** | 重复入驻场景下，向当前客户对应的销售推送钉钉通知 |
+| **Usage** | `fmc onboarding notify-saler [flags]` |
+
+需要 API Key 认证。**写操作**，默认二次确认。无业务参数：客户编码由
+服务端从 API Key 上下文自动取，通知标题与正文也由服务端写死（含企业名称与客户编码）。
+
+**仅在确认客户存在重复入驻时调用**：即 `brand open` 被拦且错误文案明确包含
+`账号存在重复申请，请等待人工审核通过后再发起申请服务`（底层业务码 50001）或
+`因您重复申请账号，审核未通过，不可继续申请服务`（底层业务码 50002）时才用。
+MCP 层可能将底层码包装成 `OPEN_BRAND_ERROR`，因此按错误文案判断，不要只匹配错误码。
+**请勿重复发送**；通知后销售需在四方钉—工作台—OA审批发起「GPN客户发起：客户账号重复注册审核申请」。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `-y, --yes` | boolean | no | 跳过交互确认（非交互环境必传） |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc onboarding notify-saler -y
+```
+
+#### Output (text mode)
+
+```
+  ✔ 已向该客户对应的销售推送重复入驻通知
+
+  通知含企业名称与客户编码，并指引销售走 OA「客户账号重复注册审核申请」
+  请勿重复发送；等销管审批通过后再重试 brand open
+```
+
+---
+
 ### `fmc onboarding contract list`
 
 | Field | Value |