cbs-4px-merchant-cli 0.0.1 → 0.0.3

package/skill/reference/finance.md

@@ -0,0 +1,337 @@
+# `fmc finance` command
+
+## Command details
+
+### `fmc finance balance`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance balance` |
+| **Description** | 查询账户余额 |
+| **Usage** | `fmc finance balance [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 DSS |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance balance
+```
+
+```bash
+fmc finance balance --output json
+```
+
+#### Output (text mode)
+
+```
+账户余额
+──────────────────────────────────────────────────
+  付费类型        预付费
+  授信额度        50,000.00
+  可用授信额度    41,800.00
+  可用余额        12,580.50
+  欠费金额        0.00
+
+  账户余额明细
+  ────────────────────────────────────────
+  CNY (DSS)
+    现金余额      10,000.00
+    信用余额      2,580.50
+    账户余额      12,580.50
+```
+
+---
+
+### `fmc finance bill list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance bill list` |
+| **Description** | 查询已出账单列表 |
+| **Usage** | `fmc finance bill list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--bill-no <no>` | string | no | 账单编号 |
+| `--bill-month <month>` | string | no | 账单月份 (yyyy-MM) |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance bill list
+```
+
+```bash
+fmc finance bill list --bill-month 2024-01
+```
+
+```bash
+fmc finance bill list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+账单列表
+──────────────────────────────────────────────────
+  共 25 条
+
+  BILL-202401  已结算
+    业务系统    GRS
+    应收金额    5,280.50 CNY
+    账单周期    2024-01-01~2024-01-31
+    还款截止    2024-02-15
+```
+
+---
+
+### `fmc finance daily-fee list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance daily-fee list` |
+| **Description** | 查询每日充值/消费费用 |
+| **Usage** | `fmc finance daily-fee list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--currency-code <code>` | string | no | 币种编码 |
+| `--start-date <date>` | string | no | 起始日期 (yyyy-MM-dd) |
+| `--end-date <date>` | string | no | 结束日期 (yyyy-MM-dd) |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance daily-fee list
+```
+
+```bash
+fmc finance daily-fee list --start-date 2024-01-01 --end-date 2024-01-07
+```
+
+```bash
+fmc finance daily-fee list --output json
+```
+
+#### Output (text mode)
+
+```
+每日费用
+──────────────────────────────────────────────────
+  页码 1/1  共 7 条
+
+  2024-01-07
+    费用金额    680.50
+    收款金额    520.00
+    业务系统    GRS
+```
+
+---
+
+### `fmc finance unbilled list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance unbilled list` |
+| **Description** | 查询未出账单（传 `--business-no` 查明细，不传查列表） |
+| **Usage** | `fmc finance unbilled list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-no <no>` | string | no | 业务单号（传入则查该单计费明细） |
+| `--currency-code <code>` | string | no | 币种编码（查明细时必填） |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--bill-no <no>` | string | no | 账单编号（查列表时筛选） |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance unbilled list
+```
+
+```bash
+fmc finance unbilled list --business-no FPX12345678 --currency-code CNY
+```
+
+```bash
+fmc finance unbilled list --output json
+```
+
+---
+
+### `fmc finance recharge list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance recharge list` |
+| **Description** | 查询充值记录（加 `--offline` 查线下水单） |
+| **Usage** | `fmc finance recharge list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--offline` | boolean | no | 查询线下充值记录（水单） |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 DSS |
+| `--start-date <date>` | string | no | 起始日期 (yyyy-MM-dd) |
+| `--end-date <date>` | string | no | 结束日期 (yyyy-MM-dd) |
+| `--currency <code>` | string | no | 币种（仅线下） |
+| `--trade-no <no>` | string | no | 付款凭证号（仅线下） |
+| `--status <code>` | string | no | 水单状态（仅线下） |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance recharge list
+```
+
+```bash
+fmc finance recharge list --offline
+```
+
+```bash
+fmc finance recharge list --start-date 2024-01-01 --end-date 2024-06-30
+```
+
+```bash
+fmc finance recharge list --output json
+```
+
+---
+
+### `fmc finance fee detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance fee detail` |
+| **Description** | 查询计费明细 |
+| **Usage** | `fmc finance fee detail <businessNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<businessNo>` | string | yes | 业务单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance fee detail FPX12345678
+```
+
+```bash
+fmc finance fee detail FPX12345678 --output json
+```
+
+#### Output (text mode)
+
+```
+费用明细
+──────────────────────────────────────────────────
+  运费
+    计费单号    BIL001
+    应付金额    25.00 CNY
+    计费状态    已计费
+
+  燃油附加费
+    计费单号    BIL002
+    应付金额    5.00 CNY
+    计费状态    已计费
+```
+
+---
+
+### `fmc finance frozen list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance frozen list` |
+| **Description** | 查询冻结流水 |
+| **Usage** | `fmc finance frozen list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--brand <brand>` | string | no | 品牌（业务系统） |
+| `--currency <code>` | string | no | 币种编码 |
+| `--business-no <no>` | string | no | 业务单号 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance frozen list
+```
+
+```bash
+fmc finance frozen list --currency CNY
+```
+
+```bash
+fmc finance frozen list --business-no FPX12345678 --output json
+```
+
+#### Output (text mode)
+
+```
+冻结流水列表
+────────────────────────────────────────────────────────────
+  FPX12345678
+    品牌        DSS
+    冻结金额    25.00 CNY
+    冻结时间    2024-01-15 10:30:00
+    解冻时间    2024-01-20 09:00:00
+
+  共 1 条
+```

package/skill/reference/index.md

@@ -14,11 +14,58 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `fmc config list` | 查看当前配置 | [config.md](config.md) |
 | `fmc config export-schema` | 导出命令的 JSON tool schema | [config.md](config.md) |
 | `fmc track get` | 查询物流轨迹 | [track.md](track.md) |
+| `fmc track sub order` | 查询轨迹订阅订单 | [track.md](track.md) |
+| `fmc track sub product` | 查询轨迹订阅产品 | [track.md](track.md) |
 | `fmc label get` | 获取面单打印信息（PDF 链接） | [label.md](label.md) |
 | `fmc order get` | 获取订单详情 | [order.md](order.md) |
+| `fmc order list` | 查询订单列表 | [order.md](order.md) |
+| `fmc order address-book` | 查询地址簿列表 | [order.md](order.md) |
+| `fmc order country` | 模糊搜索目的国家 | [order.md](order.md) |
 | `fmc product recommend` | 获取推荐物流产品及报价 | [product.md](product.md) |
-| `fmc claim list` | 查询理赔列表 | [claim.md](claim.md) |
+| `fmc product list` | 查询可用产品列表 | [product.md](product.md) |
+| `fmc product detail` | 查询产品详情 | [product.md](product.md) |
+| `fmc product eta` | 查询预估时效 | [product.md](product.md) |
+| `fmc product search` | 搜索产品 | [product.md](product.md) |
+| `fmc problem list` | 查询问题件列表 | [problem.md](problem.md) |
+| `fmc problem suggest` | 获取异常件 AI 处理建议 | [problem.md](problem.md) |
+| `fmc problem notify list` | 查询通知件列表 | [problem.md](problem.md) |
+| `fmc problem notify type` | 查询尾程异常类型枚举 | [problem.md](problem.md) |
+| `fmc problem lastmile list` | 查询尾程异常列表 | [problem.md](problem.md) |
+| `fmc problem arrear list` | 查询欠费件列表 | [problem.md](problem.md) |
+| `fmc problem intercepted list` | 查询拦截件列表 | [problem.md](problem.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) |
+| `fmc service detail` | 查询服务单详情 | [service.md](service.md) |
+| `fmc service record` | 查询服务单处理记录 | [service.md](service.md) |
+| `fmc service claim list` | 查询理赔列表 | [service.md](service.md) |
+| `fmc service claim detail` | 查询理赔详情 | [service.md](service.md) |
+| `fmc service claim reason` | 查询理赔原因列表 | [service.md](service.md) |
+| `fmc finance balance` | 查询账户余额 | [finance.md](finance.md) |
+| `fmc finance bill list` | 查询账单列表 | [finance.md](finance.md) |
+| `fmc finance daily-fee list` | 查询每日费用 | [finance.md](finance.md) |
+| `fmc finance unbilled list` | 查询未出账汇总及明细 | [finance.md](finance.md) |
+| `fmc finance recharge list` | 查询充值记录（在线及线下） | [finance.md](finance.md) |
+| `fmc finance fee detail` | 查询计费明细 | [finance.md](finance.md) |
+| `fmc finance frozen list` | 查询冻结流水 | [finance.md](finance.md) |
+| `fmc pickup material list` | 查询物料申请单列表 | [pickup.md](pickup.md) |
+| `fmc pickup material detail` | 查询物料申请单详情 | [pickup.md](pickup.md) |
+| `fmc pickup material quota` | 查询本月物料申请额度 | [pickup.md](pickup.md) |
+| `fmc pickup address list` | 查询揽收地址列表 | [pickup.md](pickup.md) |
+| `fmc notice list` | 查询系统公告列表 | [notice.md](notice.md) |
+| `fmc notice detail` | 查询公告详情 | [notice.md](notice.md) |
+| `fmc notice message list` | 查询站内消息列表 | [notice.md](notice.md) |
+| `fmc notice message detail` | 查询站内消息详情 | [notice.md](notice.md) |
+| `fmc notice message unread` | 查询未读消息数量 | [notice.md](notice.md) |
+| `fmc customs cargo list` | 查询申报品列表 | [customs.md](customs.md) |
+| `fmc customs commodity list` | 查询商品备案列表 | [customs.md](customs.md) |
+| `fmc customs commodity detail` | 查询商品备案详情 | [customs.md](customs.md) |
+| `fmc customs hscode search` | 查询海关编码 | [customs.md](customs.md) |
+| `fmc customs registration info` | 查询客户备案信息 | [customs.md](customs.md) |
 | `fmc update` | 升级 CLI 及对应 skill 到最新版本 | [update.md](update.md) |
+| `fmc skill install` | 把当前版本的 skill 同步到本机 AI 工具 | [update.md](update.md) |
+| `fmc skill status` | 查看各 AI 工具的 skill 安装与版本状态 | [update.md](update.md) |
+| `fmc skill uninstall` | 移除本 CLI 安装的 skill | [update.md](update.md) |
 
 ## By group
 
@@ -26,12 +73,18 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | --- | --- | --- |
 | `auth` | `login`, `status` | [auth.md](auth.md) |
 | `config` | `set`, `list`, `export-schema` | [config.md](config.md) |
-| `track` | `get` | [track.md](track.md) |
+| `track` | `get`, `sub order`, `sub product` | [track.md](track.md) |
 | `label` | `get` | [label.md](label.md) |
-| `order` | `get` | [order.md](order.md) |
-| `product` | `recommend` | [product.md](product.md) |
-| `claim` | `list` | [claim.md](claim.md) |
+| `order` | `get`, `list`, `address-book`, `country` | [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) |
+| `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) |
 | `update` | (no subcommand) | [update.md](update.md) |
+| `skill` | `install`, `status`, `uninstall` | [update.md](update.md) |
 
 ## Global flags
 
@@ -46,6 +99,9 @@ Command **details** are in sibling `<group>.md` files in this directory.
 ## Notes
 
 - `track get` 命令无需认证即可使用。
-- `label get`、`order get`、`product recommend`、`claim list` 命令需要先配置 API Key：`fmc auth login --api-key <SK_xxx>`。
+- 其余大部分命令需要先配置 API Key：`fmc auth login --api-key <SK_xxx>`。
+- 新增的 `problem`、`service`、`finance`、`pickup`、`notice`、`customs` 模块均需要 API Key 认证。`order` 模块下的 `address-book`、`country` 子命令也需要认证。
 - 配置文件位于 `~/.bportal/config.json`；升级状态缓存位于 `~/.bportal/update-state.json`。
 - 当检测到新版本可用时，stderr 会输出 `{"_notice":{"type":"update",...}}`；设置环境变量 `BPORTAL_NO_UPDATE_NOTIFIER=1` 可关闭。
+- 当已安装的 skill 版本与 CLI 不一致时，stderr 会输出 `{"_notice":{"type":"skills",...}}`；执行 `fmc skill install` 即可同步。
+- `npm install -g cbs-4px-merchant-cli` **不保证**会自动注册 skill（npm 11 默认拦截安装期脚本，且仍退出 0），安装后应显式执行 `fmc skill install`。

package/skill/reference/notice.md

@@ -0,0 +1,238 @@
+# `fmc notice` command
+
+## Command details
+
+### `fmc notice list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice list` |
+| **Description** | 查询系统公告列表 |
+| **Usage** | `fmc notice list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--category <cat>` | string | no | 公告分类筛选 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice list
+```
+
+```bash
+fmc notice list --category 系统维护
+```
+
+```bash
+fmc notice list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+公告列表
+──────────────────────────────────────────────────
+
+  NTC20240115001
+    公告名称    春节假期运营时间调整通知
+    分类        运营通知
+    发布时间    2024-01-15 10:00:00
+
+  NTC20240110001
+    公告名称    系统升级维护公告
+    分类        系统维护
+    发布时间    2024-01-10 09:00:00
+```
+
+---
+
+### `fmc notice detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice detail` |
+| **Description** | 查询公告详情 |
+| **Usage** | `fmc notice detail <code> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<code>` | string | yes | 公告编号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice detail NTC20240115001
+```
+
+```bash
+fmc notice detail NTC20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+公告详情
+──────────────────────────────────────────────────
+  公告编码    NTC20240115001
+  公告名称    春节假期运营时间调整通知
+  分类        运营通知
+  发布时间    2024-01-15 10:00:00
+
+  公告内容
+  ────────────────────────────────────────
+  尊敬的客户，春节假期期间物流时效可能有所延长，请提前安排发货。
+```
+
+---
+
+### `fmc notice message list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message list` |
+| **Description** | 查询站内消息列表 |
+| **Usage** | `fmc notice message list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-code <code>` | string | no | 业务编码 |
+| `--read <bool>` | string | no | 是否已读：true / false |
+| `--keyword <word>` | string | no | 搜索关键词 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message list
+```
+
+```bash
+fmc notice message list --read false
+```
+
+```bash
+fmc notice message list --keyword 运费 --page 1 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+站内消息列表
+────────────────────────────────────────────────────────────
+  [未读] MSG001
+    标题        您的包裹 FPX12345678 已签收
+    业务类型    轨迹通知
+    分类        物流消息
+    发送时间    2024-01-15 10:30:00
+
+  [已读] MSG002
+    标题        账单 BILL-202401 已生成
+    业务类型    财务通知
+    分类        账务消息
+    发送时间    2024-01-10 09:00:00
+
+  共 2 条
+```
+
+---
+
+### `fmc notice message detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message detail` |
+| **Description** | 查询站内消息详情 |
+| **Usage** | `fmc notice message detail <recordId> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<recordId>` | string | yes | 消息记录ID |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message detail MSG001
+```
+
+```bash
+fmc notice message detail MSG001 --output json
+```
+
+#### Output (text mode)
+
+```
+消息详情
+──────────────────────────────────────────────────
+  记录ID      MSG001
+  标题        您的包裹 FPX12345678 已签收
+  业务类型    轨迹通知
+  分类        物流消息
+  发送时间    2024-01-15 10:30:00
+  状态        未读
+
+  消息内容
+  ────────────────────────────────────────
+  您好，您的包裹 FPX12345678 已于 2024-01-15 10:30 签收。
+```
+
+---
+
+### `fmc notice message unread`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message unread` |
+| **Description** | 查询未读消息数量 |
+| **Usage** | `fmc notice message unread [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+无额外参数。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message unread
+```
+
+```bash
+fmc notice message unread --output json
+```
+
+#### Output (text mode)
+
+```
+  未读消息数量: 5
+```