cbs-4px-merchant-cli 0.0.7 → 0.0.9

package/README.4px.md

@@ -1,6 +1,6 @@
 # cbs-4px-merchant-cli
 
-> 跨境物流商家命令行工具（4PX 站点），支持物流轨迹查询、面单获取、订单详情查询、产品推荐、理赔查询。
+> 跨境物流商家命令行工具（4PX 站点），支持物流轨迹查询、面单获取、普通下单与订单管理、产品推荐、理赔查询、平台拉单、商家入驻。
 
 ## 安装
 
@@ -25,11 +25,17 @@ fmc track get 4PX3000002316090CN
 # 4. 查看订单详情
 fmc order get 4PX3000002316090CN
 
-# 5. 产品推荐
+# 5. 创建订单草稿（JSON 字段见 skill/reference/order.md）
+fmc order create --file ./order.json --draft -y
+
+# 6. 用户确认后提交预报
+fmc order forecast --ids 1001 -y
+
+# 7. 产品推荐
 fmc product recommend --country US
 
-# 6. 查询理赔
-fmc claim list --biz-no 4PX3000002316090CN
+# 8. 查询理赔
+fmc service claim list --biz-no 4PX3000002316090CN
 ```
 
 ## 命令列表
@@ -43,11 +49,38 @@ fmc claim list --biz-no 4PX3000002316090CN
 | `fmc track get <orderNo>` | 查询物流轨迹 |
 | `fmc label get <orderNo>` | 获取面单打印信息（PDF 链接） |
 | `fmc order get <orderNo>` | 获取订单详情 |
+| `fmc order create --file <json> --draft -y` | 创建物流订单草稿（写操作） |
+| `fmc order edit --order-id <id> --file <json> --draft -y` | 编辑草稿/已取消订单（写操作） |
+| `fmc order forecast --ids <ids> -y` | 草稿提交预报（写操作） |
+| `fmc order cancel --ids <ids> --reason <text> -y` | 取消订单（写操作） |
+| `fmc order intercept --ids <ids> -y` | 申请拦截订单（写操作） |
 | `fmc product recommend --country <code>` | 产品推荐（按目的国查询） |
-| `fmc claim list` | 查询理赔列表 |
+| `fmc problem list` | 查询异常件 / 问题件列表 |
+| `fmc service claim list` | 查询理赔列表 |
+| `fmc service repair list` | 查询售后工单列表 |
+| `fmc finance balance` | 查询账户余额 |
+| `fmc finance bill list` | 查询账单列表 |
+| `fmc pickup material list` | 查询物料申请单列表 |
+| `fmc notice list` | 查询系统公告列表 |
+| `fmc customs commodity list` | 查询商品备案列表 |
+| `fmc customs hscode search` | 查询海关编码 |
+| `fmc platform account list` | 查询已授权的卖家账号 |
+| `fmc platform order list` | 查询平台订单列表 |
+| `fmc platform sync` | 从卖家账号拉取平台订单（写操作） |
+| `fmc platform order push` | 推送平台订单履约（写操作） |
+| `fmc onboarding progress` | 查询入驻进度 |
+| `fmc onboarding auth indiv` | 发起个人实名认证（写操作） |
+| `fmc onboarding brand open` | 开通物流品牌并申请合同（写操作） |
+| `fmc onboarding contract list` | 查询合同列表 |
 | `fmc update` | 更新到最新版本 |
 | `fmc update --check` | 检查是否有新版本 |
 
+完整命令清单见 `fmc --help` 或 skill 中的 `reference/index.md`。
+
+### 写操作
+
+`order create/edit/forecast/cancel/intercept`、`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open` 会真实改变数据，默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则会拒绝执行。先用 `--dry-run` 可查看将发送的请求。普通下单默认先用 `order create --draft` 保存草稿，用户核对后再 `order forecast`。
+
 ## 全局选项
 
 | 选项 | 说明 |

package/README.cainiao.md

@@ -1,6 +1,6 @@
 # cbs-cainiao-merchant-cli
 
-> 跨境物流商家命令行工具（菜鸟站点），支持物流轨迹查询、面单获取、订单详情查询、产品推荐、理赔查询。
+> 跨境物流商家命令行工具（菜鸟站点），支持物流轨迹查询、面单获取、普通下单与订单管理、产品推荐、理赔查询、平台拉单、商家入驻。
 
 ## 安装
 
@@ -25,11 +25,17 @@ cmc track get 4PX3000002316090CN
 # 4. 查看订单详情
 cmc order get 4PX3000002316090CN
 
-# 5. 产品推荐
+# 5. 创建订单草稿（JSON 字段见 skill/reference/order.md）
+cmc order create --file ./order.json --draft -y
+
+# 6. 用户确认后提交预报
+cmc order forecast --ids 1001 -y
+
+# 7. 产品推荐
 cmc product recommend --country US
 
-# 6. 查询理赔
-cmc claim list --biz-no 4PX3000002316090CN
+# 8. 查询理赔
+cmc service claim list --biz-no 4PX3000002316090CN
 ```
 
 ## 命令列表
@@ -43,11 +49,38 @@ cmc claim list --biz-no 4PX3000002316090CN
 | `cmc track get <orderNo>` | 查询物流轨迹 |
 | `cmc label get <orderNo>` | 获取面单打印信息（PDF 链接） |
 | `cmc order get <orderNo>` | 获取订单详情 |
+| `cmc order create --file <json> --draft -y` | 创建物流订单草稿（写操作） |
+| `cmc order edit --order-id <id> --file <json> --draft -y` | 编辑草稿/已取消订单（写操作） |
+| `cmc order forecast --ids <ids> -y` | 草稿提交预报（写操作） |
+| `cmc order cancel --ids <ids> --reason <text> -y` | 取消订单（写操作） |
+| `cmc order intercept --ids <ids> -y` | 申请拦截订单（写操作） |
 | `cmc product recommend --country <code>` | 产品推荐（按目的国查询） |
-| `cmc claim list` | 查询理赔列表 |
+| `cmc problem list` | 查询异常件 / 问题件列表 |
+| `cmc service claim list` | 查询理赔列表 |
+| `cmc service repair list` | 查询售后工单列表 |
+| `cmc finance balance` | 查询账户余额 |
+| `cmc finance bill list` | 查询账单列表 |
+| `cmc pickup material list` | 查询物料申请单列表 |
+| `cmc notice list` | 查询系统公告列表 |
+| `cmc customs commodity list` | 查询商品备案列表 |
+| `cmc customs hscode search` | 查询海关编码 |
+| `cmc platform account list` | 查询已授权的卖家账号 |
+| `cmc platform order list` | 查询平台订单列表 |
+| `cmc platform sync` | 从卖家账号拉取平台订单（写操作） |
+| `cmc platform order push` | 推送平台订单履约（写操作） |
+| `cmc onboarding progress` | 查询入驻进度 |
+| `cmc onboarding auth indiv` | 发起个人实名认证（写操作） |
+| `cmc onboarding brand open` | 开通物流品牌并申请合同（写操作） |
+| `cmc onboarding contract list` | 查询合同列表 |
 | `cmc update` | 更新到最新版本 |
 | `cmc update --check` | 检查是否有新版本 |
 
+完整命令清单见 `cmc --help` 或 skill 中的 `reference/index.md`。
+
+### 写操作
+
+`order create/edit/forecast/cancel/intercept`、`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open` 会真实改变数据，默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则会拒绝执行。先用 `--dry-run` 可查看将发送的请求。普通下单默认先用 `order create --draft` 保存草稿，用户核对后再 `order forecast`。
+
 ## 全局选项
 
 | 选项 | 说明 |

package/README.md

@@ -1,6 +1,6 @@
 # cbs-4px-merchant-cli
 
-> 跨境物流商家命令行工具（4PX 站点），支持物流轨迹查询、面单获取、订单详情查询、产品推荐、理赔查询。
+> 跨境物流商家命令行工具（4PX 站点），支持物流轨迹查询、面单获取、普通下单与订单管理、产品推荐、理赔查询、平台拉单、商家入驻。
 
 ## 安装
 
@@ -25,11 +25,17 @@ fmc track get 4PX3000002316090CN
 # 4. 查看订单详情
 fmc order get 4PX3000002316090CN
 
-# 5. 产品推荐
+# 5. 创建订单草稿（JSON 字段见 skill/reference/order.md）
+fmc order create --file ./order.json --draft -y
+
+# 6. 用户确认后提交预报
+fmc order forecast --ids 1001 -y
+
+# 7. 产品推荐
 fmc product recommend --country US
 
-# 6. 查询理赔
-fmc claim list --biz-no 4PX3000002316090CN
+# 8. 查询理赔
+fmc service claim list --biz-no 4PX3000002316090CN
 ```
 
 ## 命令列表
@@ -43,11 +49,38 @@ fmc claim list --biz-no 4PX3000002316090CN
 | `fmc track get <orderNo>` | 查询物流轨迹 |
 | `fmc label get <orderNo>` | 获取面单打印信息（PDF 链接） |
 | `fmc order get <orderNo>` | 获取订单详情 |
+| `fmc order create --file <json> --draft -y` | 创建物流订单草稿（写操作） |
+| `fmc order edit --order-id <id> --file <json> --draft -y` | 编辑草稿/已取消订单（写操作） |
+| `fmc order forecast --ids <ids> -y` | 草稿提交预报（写操作） |
+| `fmc order cancel --ids <ids> --reason <text> -y` | 取消订单（写操作） |
+| `fmc order intercept --ids <ids> -y` | 申请拦截订单（写操作） |
 | `fmc product recommend --country <code>` | 产品推荐（按目的国查询） |
-| `fmc claim list` | 查询理赔列表 |
+| `fmc problem list` | 查询异常件 / 问题件列表 |
+| `fmc service claim list` | 查询理赔列表 |
+| `fmc service repair list` | 查询售后工单列表 |
+| `fmc finance balance` | 查询账户余额 |
+| `fmc finance bill list` | 查询账单列表 |
+| `fmc pickup material list` | 查询物料申请单列表 |
+| `fmc notice list` | 查询系统公告列表 |
+| `fmc customs commodity list` | 查询商品备案列表 |
+| `fmc customs hscode search` | 查询海关编码 |
+| `fmc platform account list` | 查询已授权的卖家账号 |
+| `fmc platform order list` | 查询平台订单列表 |
+| `fmc platform sync` | 从卖家账号拉取平台订单（写操作） |
+| `fmc platform order push` | 推送平台订单履约（写操作） |
+| `fmc onboarding progress` | 查询入驻进度 |
+| `fmc onboarding auth indiv` | 发起个人实名认证（写操作） |
+| `fmc onboarding brand open` | 开通物流品牌并申请合同（写操作） |
+| `fmc onboarding contract list` | 查询合同列表 |
 | `fmc update` | 更新到最新版本 |
 | `fmc update --check` | 检查是否有新版本 |
 
+完整命令清单见 `fmc --help` 或 skill 中的 `reference/index.md`。
+
+### 写操作
+
+`order create/edit/forecast/cancel/intercept`、`platform sync`、`platform order push`、`onboarding auth *`、`onboarding brand open` 会真实改变数据，默认在终端二次确认；非交互环境（管道、CI、AI Agent）必须显式加 `-y`，否则会拒绝执行。先用 `--dry-run` 可查看将发送的请求。普通下单默认先用 `order create --draft` 保存草稿，用户核对后再 `order forecast`。
+
 ## 全局选项
 
 | 选项 | 说明 |

package/dist/cli.js

@@ -5,10 +5,11 @@ import { authLogin, authStatus } from './commands/auth.js';
 import { configSet, configList, configExportSchema } from './commands/config.js';
 import { trackCommand, trackSubscriptionOrderCommand, trackSubscriptionProductCommand } from './commands/track.js';
 import { labelCommand } from './commands/label.js';
-import { orderCommand, orderListCommand } from './commands/order.js';
+import { orderCommand, orderListCommand, orderCreateCommand, orderEditCommand, orderForecastCommand, orderCancelCommand, orderInterceptCommand, } from './commands/order.js';
 import { productCommand, productListCommand, productDetailCommand, productDeliveryTimeCommand, productSearchCommand } from './commands/product.js';
 import { claimCommand } from './commands/claim.js'; // re-homed under `service`
 import { problemListCommand, problemSuggestCommand, problemNotifyCommand, problemLastmileCommand, problemArrearCommand, problemInterceptedCommand, problemNotifyTypeCommand } from './commands/problem.js';
+import { custodyElectricCommand, custodyRecommendCommand, custodyChangeCommand } from './commands/custody.js';
 import { serviceRepairCommand, serviceCheckCommand, serviceComplaintCommand, serviceDetailCommand, serviceRecordCommand, serviceClaimDetailCommand, serviceClaimReasonCommand } from './commands/service.js';
 import { financeBalanceCommand, financeBillCommand, financeDailyFeeCommand, financeUnbilledDetailCommand, financeUnbilledCommand, financeRechargeCommand, financeRechargeOfflineCommand, financeFeeDetailCommand, financeFrozenCommand } from './commands/finance.js';
 import { addressListCommand } from './commands/address.js';
@@ -19,6 +20,8 @@ import { buildUpdateCommand } from './commands/update.js';
 import { buildSkillCommand } from './commands/skill.js';
 import { buildCompletionCommand } from './commands/completion.js';
 import { customsCargoListCommand, customsCommodityListCommand, customsCommodityDetailCommand, customsHsCodeCommand, customsRegistrationInfoCommand } from './commands/customs.js';
+import { platformAccountListCommand, platformSyncCommand, platformSyncRecordListCommand, platformOrderListCommand, platformOrderDetailCommand, platformOrderPushCommand } from './commands/platform.js';
+import { onboardingProgressCommand, onboardingAuthScheduleCommand, onboardingAuthIndivCommand, onboardingAuthCodeCommand, onboardingAuthOrganCommand, onboardingAuthGatCommand, onboardingAuthRemitCommand, onboardingCustomerTypeCommand, onboardingBrandListCommand, onboardingBrandOpenCommand, onboardingContractListCommand, onboardingContractUrlCommand } from './commands/onboarding.js';
 import { checkCachedSync, refreshCache } from './services/update-checker.js';
 import { listSkillDirs, readInstalledVersion } from './services/skill-installer.js';
 import { PACKAGE_NAME, BIN_NAME } from './generated/site.js';
@@ -285,6 +288,50 @@ export function buildProgram() {
         .action(async (keyword, opts, cmd) => {
         await countrySearchCommand(keyword, { ...globals(cmd), ...opts });
     });
+    order
+        .command('create')
+        .description('创建物流订单（写）—— 订单字段从 JSON 文件读取')
+        .requiredOption('--file <path>', '订单 JSON 文件路径，- 表示从标准输入读取')
+        .option('--draft', '保存为草稿（status=D），不直接提交预报')
+        .option('-y, --yes', '跳过交互确认（非交互环境必传）')
+        .action(async (opts, cmd) => {
+        await orderCreateCommand({ ...globals(cmd), ...opts });
+    });
+    order
+        .command('edit')
+        .description('编辑草稿或已取消订单（写）')
+        .requiredOption('--order-id <id>', '要编辑的订单 ID')
+        .requiredOption('--file <path>', '订单 JSON 文件路径，- 表示从标准输入读取')
+        .option('--draft', '保持草稿状态（status=D）')
+        .option('-y, --yes', '跳过交互确认（非交互环境必传）')
+        .action(async (opts, cmd) => {
+        await orderEditCommand({ ...globals(cmd), ...opts });
+    });
+    order
+        .command('forecast')
+        .description('将草稿订单提交为预报（写）')
+        .requiredOption('--ids <ids>', '草稿订单 ID，多个用逗号分隔')
+        .option('-y, --yes', '跳过交互确认（非交互环境必传）')
+        .action(async (opts, cmd) => {
+        await orderForecastCommand({ ...globals(cmd), ...opts });
+    });
+    order
+        .command('cancel')
+        .description('取消已预报或草稿订单（写）')
+        .requiredOption('--ids <ids>', '订单 ID，多个用逗号分隔')
+        .requiredOption('--reason <text>', '取消原因')
+        .option('-y, --yes', '跳过交互确认（非交互环境必传）')
+        .action(async (opts, cmd) => {
+        await orderCancelCommand({ ...globals(cmd), ...opts });
+    });
+    order
+        .command('intercept')
+        .description('对已预报订单申请拦截（写）')
+        .requiredOption('--ids <ids>', '订单 ID，多个用逗号分隔')
+        .option('-y, --yes', '跳过交互确认（非交互环境必传）')
+        .action(async (opts, cmd) => {
+        await orderInterceptCommand({ ...globals(cmd), ...opts });
+    });
     program.addCommand(order);
     // mc product recommend / list / detail / fee / delivery-time / search
     const product = new Command('product').description('产品与报价');
@@ -406,6 +453,32 @@ export function buildProgram() {
     });
     problem.addCommand(problemIntercepted);
     program.addCommand(problem);
+    // mc custody electric / recommend / change
+    const custody = new Command('custody').description('异常托管（改带电/改产品）');
+    custody
+        .command('electric <orderNo>')
+        .description('查询可改带电产品列表及差价')
+        .action(async (orderNo, opts, cmd) => {
+        await custodyElectricCommand(orderNo, globals(cmd));
+    });
+    custody
+        .command('recommend <orderNo>')
+        .description('获取 AI 推荐改产品方案')
+        .requiredOption('--reason <code>', '异常原因编码，如 NC(无渠道)')
+        .action(async (orderNo, opts, cmd) => {
+        await custodyRecommendCommand(orderNo, { ...globals(cmd), ...opts });
+    });
+    custody
+        .command('change')
+        .description('批量提交改带电/改产品（写操作）')
+        .requiredOption('--order-nos <nos>', '物流单号，多个用逗号分隔')
+        .requiredOption('--pk-code <code>', '目标产品编码')
+        .requiredOption('--reason <code>', '异常原因编码：NZDC(内电)/CXW(磁性物品)/NC(无渠道)')
+        .option('-y, --yes', '跳过确认')
+        .action(async (opts, cmd) => {
+        await custodyChangeCommand({ ...globals(cmd), ...opts });
+    });
+    program.addCommand(custody);
     // mc service repair list / check list / complaint list / detail / record / claim list|detail|reason
     const service = new Command('service').description('服务中心');
     const serviceRepair = new Command('repair').description('售后工单');
@@ -733,6 +806,201 @@ export function buildProgram() {
     });
     customs.addCommand(registration);
     program.addCommand(customs);
+    // mc platform account list / sync / sync-record list / order list|detail|push
+    const platform = new Command('platform').description('平台拉单');
+    const platformAccount = new Command('account').description('卖家账号');
+    platformAccount
+        .command('list')
+        .description('查询已授权的卖家账号列表')
+        .option('--page <num>', '页码，默认 1')
+        .option('--size <num>', '每页数量，默认 10，最大 100')
+        .action(async (opts, cmd) => {
+        await platformAccountListCommand({ ...globals(cmd), ...opts });
+    });
+    platform.addCommand(platformAccount);
+    platform
+        .command('sync')
+        .description('从卖家账号拉取平台订单（异步，写操作）')
+        .requiredOption('--seller-account-id <id>', '卖家账号 ID（从 account list 获取）')
+        .requiredOption('--time-from <time>', '订单起始时间 (yyyy-MM-dd HH:mm:ss)')
+        .requiredOption('--time-to <time>', '订单截止时间 (yyyy-MM-dd HH:mm:ss)')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await platformSyncCommand({ ...globals(cmd), ...opts });
+    });
+    const platformSyncRecord = new Command('sync-record').description('拉单记录');
+    platformSyncRecord
+        .command('list')
+        .description('查询平台订单拉取/同步记录（用于轮询拉单结果）')
+        .option('--page <num>', '页码，默认 1')
+        .option('--size <num>', '每页数量，默认 10，最大 100')
+        .action(async (opts, cmd) => {
+        await platformSyncRecordListCommand({ ...globals(cmd), ...opts });
+    });
+    platform.addCommand(platformSyncRecord);
+    const platformOrder = new Command('order').description('平台订单');
+    platformOrder
+        .command('list')
+        .description('查询已拉取的平台订单列表')
+        .option('--status <code>', '订单状态：0 待推送、1 已推送，不传查全部')
+        .option('--keyword <word>', '关键字（平台订单号/客户订单号）')
+        .option('--page <num>', '页码，默认 1')
+        .option('--size <num>', '每页数量，默认 10，最大 100')
+        .action(async (opts, cmd) => {
+        await platformOrderListCommand({ ...globals(cmd), ...opts });
+    });
+    platformOrder
+        .command('detail <id>')
+        .description('查询平台订单详情（含收件人、报关物品）')
+        .action(async (id, _opts, cmd) => {
+        await platformOrderDetailCommand(id, globals(cmd));
+    });
+    platformOrder
+        .command('push')
+        .description('将待推送的平台订单推送到物流服务商（写操作）')
+        .requiredOption('--ids <ids>', '订单 ID，多个用逗号分隔')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await platformOrderPushCommand({ ...globals(cmd), ...opts });
+    });
+    platform.addCommand(platformOrder);
+    program.addCommand(platform);
+    // mc onboarding progress / customer-type / auth ... / brand ... / contract ...
+    const onboarding = new Command('onboarding').description('商家入驻');
+    onboarding
+        .command('progress')
+        .description('查询入驻进度（实名/合同申请/合同签署/品牌开通）')
+        .action(async (_opts, cmd) => {
+        await onboardingProgressCommand(globals(cmd));
+    });
+    onboarding
+        .command('customer-type')
+        .description('查询可选客户类型（0 大陆、1 港澳台、2 海外）')
+        .action(async (_opts, cmd) => {
+        await onboardingCustomerTypeCommand(globals(cmd));
+    });
+    const onboardingAuth = new Command('auth').description('实名认证');
+    onboardingAuth
+        .command('schedule')
+        .description('查询实名认证进度')
+        .action(async (_opts, cmd) => {
+        await onboardingAuthScheduleCommand(globals(cmd));
+    });
+    onboardingAuth
+        .command('indiv')
+        .description('发起个人实名认证（写操作，返回 flowId）')
+        .requiredOption('--name <name>', '姓名')
+        .requiredOption('--cert-number <no>', '身份证号')
+        .requiredOption('--mobile <mobile>', '手机号')
+        .requiredOption('--auth-type <type>', '认证方式：0 手机号验证、1 银行卡验证')
+        .option('--bank-card <no>', '银行卡号（--auth-type 1 时必填）')
+        .option('--agent', '作为企业认证中的经办人实名认证')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingAuthIndivCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingAuth
+        .command('code')
+        .description('提交短信/银行卡验证码完成个人实名认证（写操作）')
+        .requiredOption('--auth-code <code>', '验证码')
+        .requiredOption('--flow-id <id>', 'auth indiv 返回的 flowId')
+        .option('--auth-type <type>', '认证方式：0 手机号、1 银行卡')
+        .option('--agent', '经办人认证')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingAuthCodeCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingAuth
+        .command('organ')
+        .description('发起企业实名认证（写操作，需经办人已完成个人实名）')
+        .requiredOption('--name <name>', '企业名称')
+        .requiredOption('--cert-number <no>', '统一社会信用代码')
+        .option('--cert-type <type>', '证件类型')
+        .option('--agent-account-id <id>', '经办人账号 ID')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingAuthOrganCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingAuth
+        .command('gat')
+        .description('提交港澳台/海外客户实名资料（写操作，人工审核）')
+        .requiredOption('--customer-profile <code>', '客户类型：1 港澳台、2 海外（大陆客户用 auth indiv）')
+        .requiredOption('--entity <code>', '经济主体：1 个人、2 企业')
+        .requiredOption('--name <name>', '个人姓名或企业名称')
+        .requiredOption('--mobile <mobile>', '手机号')
+        .requiredOption('--email <email>', '邮箱')
+        .option('--contact-name <name>', '联系人姓名（企业）')
+        .option('--legal-person <name>', '法人姓名（企业）')
+        .option('--cert-number <no>', '企业证件号（企业）')
+        .option('--country <name>', '国家名称')
+        .option('--country-code <code>', '国家编码')
+        .option('--alpha2-code <code>', '国家二字码')
+        .option('--state <name>', '省')
+        .option('--state-code <code>', '省编码')
+        .option('--city <name>', '市')
+        .option('--city-code <code>', '市编码')
+        .option('--county <name>', '区/县')
+        .option('--county-code <code>', '区/县编码')
+        .option('--address <address>', '详细地址')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingAuthGatCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingAuth
+        .command('remit')
+        .description('校验企业对公打款金额（写操作，有重试次数限制）')
+        .requiredOption('--flow-id <id>', '认证流程 ID')
+        .requiredOption('--amount <cents>', '打款金额（单位：分）')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingAuthRemitCommand({ ...globals(cmd), ...opts });
+    });
+    onboarding.addCommand(onboardingAuth);
+    const onboardingBrand = new Command('brand').description('品牌开通');
+    onboardingBrand
+        .command('list')
+        .description('查询可开通品牌及支持的认证方式')
+        .option('--customer-type <code>', '客户类型（0 大陆、1 港澳台、2 海外），默认当前客户类型')
+        .action(async (opts, cmd) => {
+        await onboardingBrandListCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingBrand
+        .command('open')
+        .description('开通物流品牌并申请合同（写操作，仅大陆已实名客户）')
+        .requiredOption('--service-code <code>', '品牌编码（如 DSS，从 brand list 获取）')
+        .requiredOption('--country <name>', '国家（如：中国）')
+        .requiredOption('--address <address>', '详细地址')
+        .requiredOption('--customer-name <name>', '客户名称')
+        .requiredOption('--contact-name <name>', '联系人姓名')
+        .requiredOption('--mobile <mobile>', '手机号')
+        .requiredOption('--email <email>', '邮箱')
+        .option('--customer-type <code>', '客户类型')
+        .option('--state <name>', '省')
+        .option('--city <name>', '市')
+        .option('--county <name>', '区/县')
+        .option('--legal-name <name>', '企业法人姓名（企业客户必填）')
+        .option('-y, --yes', '跳过交互式确认')
+        .action(async (opts, cmd) => {
+        await onboardingBrandOpenCommand({ ...globals(cmd), ...opts });
+    });
+    onboarding.addCommand(onboardingBrand);
+    const onboardingContract = new Command('contract').description('合同管理');
+    onboardingContract
+        .command('list')
+        .description('查询 DSS 直发品牌的合同列表')
+        .option('--page <num>', '页码，默认 1')
+        .option('--size <num>', '每页数量，默认 10，最大 100')
+        .action(async (opts, cmd) => {
+        await onboardingContractListCommand({ ...globals(cmd), ...opts });
+    });
+    onboardingContract
+        .command('url <contractCode>')
+        .description('获取合同签署链接或下载链接（请勿频繁调用）')
+        .action(async (contractCode, _opts, cmd) => {
+        await onboardingContractUrlCommand(contractCode, globals(cmd));
+    });
+    onboarding.addCommand(onboardingContract);
+    program.addCommand(onboarding);
     // mc update [--check] [--tag] [--force] [-y] [--output json]
     program.addCommand(buildUpdateCommand());
     // mc skill install | status | uninstall (roadmap ext-1)