cbs-4px-merchant-cli 0.0.1

package/dist/utils/output.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Unified output formatting.
+ *
+ * TTY  → default "text" (human-readable, chalk-colored)
+ * Pipe → default "json" (machine-parsable)
+ *
+ * IMPORTANT: printJson writes to stdout — the ONLY function allowed to do so.
+ * All other output (progress, warnings, errors) must go to stderr via logger.
+ */
+export type OutputFormat = 'text' | 'json';
+export declare function detectOutputFormat(flagValue?: string): OutputFormat;
+/** Write JSON data to stdout. Never use console.log directly for data output. */
+export declare function printJson(data: unknown): void;

package/dist/utils/output.js

@@ -0,0 +1,19 @@
+/**
+ * Unified output formatting.
+ *
+ * TTY  → default "text" (human-readable, chalk-colored)
+ * Pipe → default "json" (machine-parsable)
+ *
+ * IMPORTANT: printJson writes to stdout — the ONLY function allowed to do so.
+ * All other output (progress, warnings, errors) must go to stderr via logger.
+ */
+export function detectOutputFormat(flagValue) {
+    if (flagValue === 'json' || flagValue === 'text')
+        return flagValue;
+    return process.stdout.isTTY ? 'text' : 'json';
+}
+/** Write JSON data to stdout. Never use console.log directly for data output. */
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,UAAU,kBAAkB,CAAC,SAAkB;IACnD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "cbs-4px-merchant-cli",
+  "version": "0.0.1",
+  "description": "Cbs merchant CLI tool",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "fmc": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skill/SKILL.md",
+    "skill/reference",
+    "site-meta.json",
+    "scripts/postinstall.js"
+  ],
+  "scripts": {
+    "build": "node scripts/build.js",
+    "tsc": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "build:4px:test": "SITE=4px ENV=test npm run build",
+    "build:4px:pre": "SITE=4px ENV=pre npm run build",
+    "build:cainiao:test": "SITE=cainiao ENV=test npm run build",
+    "build:cainiao:pre": "SITE=cainiao ENV=pre npm run build",
+    "dev:4px:test": "SITE=4px ENV=test npm run build && node scripts/postinstall.js",
+    "dev:4px:pre": "SITE=4px ENV=pre npm run build && node scripts/postinstall.js",
+    "dev:cainiao:test": "SITE=cainiao ENV=test npm run build && node scripts/postinstall.js",
+    "dev:cainiao:pre": "SITE=cainiao ENV=pre npm run build && node scripts/postinstall.js",
+    "release": "npm run build && node scripts/publish.js",
+    "release:4px": "SITE=4px ENV=prod npm run release",
+    "release:cainiao": "SITE=cainiao ENV=prod npm run release",
+    "prepublishOnly": "node scripts/guard-publish.js",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "axios": "^1.7.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^9.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script: automatically install SKILL.md to all detected AI coding tools.
+ *
+ * For each tool whose root dir exists, writes SKILL.md + reference/ to
+ * <root>/skills/cbs-merchant-cli/.
+ *
+ * Inspired by bailian-cli's postinstall approach.
+ */
+
+import {
+  existsSync,
+  mkdirSync,
+  copyFileSync,
+  cpSync,
+  openSync,
+  writeSync,
+  writeFileSync,
+  closeSync,
+  readFileSync,
+} from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const skillSource = join(__dirname, '..', 'skill', 'SKILL.md');
+const referenceDirSource = join(__dirname, '..', 'skill', 'reference');
+
+if (!existsSync(skillSource)) {
+  process.exit(0);
+}
+
+// ── Site metadata (generated at build time by scripts/build.js) ──
+// Falls back to safe defaults so a source checkout without a build still runs.
+const siteMeta = (() => {
+  const defaults = {
+    siteId: '4px',
+    env: 'prod',
+    baseUrl: 'https://b.4px.com',
+    akUrl: 'https://b.4px.com/site/ak-manage',
+    packageName: 'cbs-merchant-cli',
+    binName: 'mc',
+  };
+  try {
+    const metaPath = join(__dirname, '..', 'site-meta.json');
+    const parsed = JSON.parse(readFileSync(metaPath, 'utf-8'));
+    return { ...defaults, ...parsed };
+  } catch {
+    return defaults;
+  }
+})();
+
+// Skill install dir name derived from package name (e.g. cbs-4px-merchant-cli).
+const skillDirName = siteMeta.packageName.replace(/^@[^/]+\//, '');
+
+// Site-specific CLI command name (e.g. fmc / cmc); falls back to mc.
+const bin = siteMeta.binName || 'mc';
+
+const home = homedir();
+
+const targets = [
+  { root: join(home, '.qoder'), label: 'Qoder' },
+  { root: join(home, '.claude'), label: 'Claude Code' },
+  { root: join(home, '.cline'), label: 'Cline' },
+  { root: join(home, '.qwen'), label: 'QwenCode' },
+  { root: join(home, '.cursor'), label: 'Cursor' },
+  { root: join(home, '.qoderwork'), label: 'QoderWork' },
+  { root: join(home, '.codex'), label: 'Codex' },
+  { root: join(home, '.kilo'), label: 'Kilo Code' },
+  { root: join(home, '.openclaw'), label: 'OpenCLaw' },
+  { root: join(home, '.config', 'opencode'), label: 'OpenCode' },
+];
+
+const available = targets.filter(({ root }) => existsSync(root));
+
+if (available.length === 0) {
+  process.exit(0);
+}
+
+// Write to /dev/tty to bypass npm output suppression
+let ttyFd;
+try {
+  ttyFd = openSync('/dev/tty', 'w');
+} catch {
+  ttyFd = null;
+}
+
+function ttyPrint(msg) {
+  if (ttyFd != null) {
+    writeSync(ttyFd, msg + '\n');
+  } else {
+    // Fallback for environments without /dev/tty (e.g. Claude Code, CI agents)
+    console.log(msg);
+  }
+}
+
+ttyPrint(
+  `\n🚀 Installing BPortal Merchant CLI skill to ${available.length} AI coding tool(s):`,
+);
+
+for (const { root, label } of available) {
+  try {
+    const targetDir = join(root, 'skills', skillDirName);
+    mkdirSync(targetDir, { recursive: true });
+    copyFileSync(skillSource, join(targetDir, 'SKILL.md'));
+    if (existsSync(referenceDirSource)) {
+      cpSync(referenceDirSource, join(targetDir, 'reference'), {
+        recursive: true,
+      });
+    }
+    // Write version marker for drift detection at CLI runtime
+    const pkgJsonPath = join(__dirname, '..', 'package.json');
+    let skillVersion = 'unknown';
+    try {
+      const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+      if (typeof pkg.version === 'string') skillVersion = pkg.version;
+    } catch { /* fallback to unknown */ }
+    writeFileSync(join(targetDir, '.skill-version'), skillVersion);
+    ttyPrint(`  ✓ ${label} (v${skillVersion})`);
+  } catch {
+    // Silent fail — don't block npm install
+  }
+}
+
+// ── API Key detection ──
+const configPath = join(home, '.bportal', 'config.json');
+let hasApiKey = false;
+
+if (process.env.BPORTAL_API_KEY) {
+  hasApiKey = true;
+}
+if (!hasApiKey && existsSync(configPath)) {
+  try {
+    const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (typeof cfg.apiKey === 'string' && cfg.apiKey.length > 0) hasApiKey = true;
+  } catch {
+    /* ignore */
+  }
+}
+
+if (hasApiKey) {
+  ttyPrint('');
+  ttyPrint('🎯 Try these commands:');
+  ttyPrint('');
+  ttyPrint(`   ${bin} track get <orderNo>        查询物流轨迹`);
+  ttyPrint(`   ${bin} label get <orderNo>        获取面单 PDF`);
+  ttyPrint(`   ${bin} order get <orderNo>        查看订单详情`);
+  ttyPrint(`   ${bin} order get <orderNo> --output json`);
+  ttyPrint('');
+} else {
+  ttyPrint('');
+  ttyPrint('💡 Set up your API Key to get started:');
+  ttyPrint('');
+  ttyPrint('   1️⃣  Get an API Key:');
+  ttyPrint(`      ${siteMeta.akUrl}`);
+  ttyPrint('');
+  ttyPrint('   2️⃣  Sign in:');
+  ttyPrint(`      ${bin} auth login --api-key SK_xxxxx`);
+  ttyPrint('');
+  ttyPrint('   3️⃣  Then try:');
+  ttyPrint(`      ${bin} track get <orderNo>`);
+  ttyPrint(`      ${bin} order get <orderNo>`);
+  ttyPrint('');
+}
+
+// ── PATH check ──
+try {
+  execSync(`which ${bin}`, { stdio: 'ignore' });
+} catch {
+  ttyPrint(`⚠️  Command "${bin}" not found in PATH.`);
+  ttyPrint('   Your npm global bin directory may not be on PATH.');
+  ttyPrint('   Run `npm config get prefix` and add its `bin/` to your PATH,');
+  ttyPrint('   or reinstall with:');
+  ttyPrint('');
+  ttyPrint(`   npm install -g ${siteMeta.packageName}`);
+  ttyPrint('');
+}
+
+if (ttyFd != null) {
+  closeSync(ttyFd);
+}

package/site-meta.json

@@ -0,0 +1,9 @@
+{
+  "siteId": "4px",
+  "env": "prod",
+  "baseUrl": "https://b.4px.com",
+  "akUrl": "https://b.4px.com/site/ak-manage",
+  "packageName": "cbs-4px-merchant-cli",
+  "binName": "fmc",
+  "registry": "https://registry.npmjs.org"
+}

package/skill/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: cbs-4px-merchant-cli
+description: >-
+  BPortal Merchant CLI (`fmc`) — 跨境物流商家命令行工具。
+  支持物流轨迹查询、面单打印、订单详情查询、产品推荐、理赔查询。
+  当用户需要查询物流信息、获取面单、查看订单详情、获取产品推荐报价、查询理赔状态时，使用 `fmc` 命令。
+  完整命令参考: `reference/index.md` + `reference/<group>.md`。
+---
+
+# BPortal Merchant CLI (`fmc`)
+
+> 跨境物流商家命令行工具，提供物流轨迹查询、面单打印、订单详情、产品推荐、理赔查询等功能。
+
+## 严格禁止 (NEVER DO)
+
+- 不要编造单号、API Key 等标识符，必须从用户输入或命令返回中获取
+- 不要猜测参数值，不确定时先查阅对应 reference 文件或执行 `fmc <command> --help`
+- 参数名不确定时禁止编造 flag，必须先确认
+
+## 核心流程（每次请求必须执行）
+
+1. **意图识别**：将用户请求匹配到下方「意图判断决策树」
+2. **前置加载**：匹配到命令后，MUST 先 Read 对应的 `reference/<module>.md` 获取详细参数（见下方「前置条件」）
+3. **认证检查**：需要 API Key 的命令，先确认已配置；未配置时引导用户执行 `fmc auth login`
+4. **执行命令**：按 reference 中的参数格式和示例执行
+5. **错误处理**：失败时加 `--verbose` 重试一次；仍失败则报告完整错误信息
+
+## 前置条件 — 执行操作前必读
+
+**CRITICAL — 执行对应操作前，MUST 先用 Read 工具读取以下 reference 文件：**
+
+| 操作场景 | 必读文件 | 原因 |
+|---------|---------|------|
+| 查询物流轨迹 | [`reference/track.md`](reference/track.md) | 确认参数格式 |
+| 获取面单 | [`reference/label.md`](reference/label.md) | 确认参数格式 |
+| 查看订单详情 | [`reference/order.md`](reference/order.md) | 确认参数和输出字段 |
+| 产品推荐 | [`reference/product.md`](reference/product.md) | 参数多（国家/重量/电池/邮编等），必须确认 |
+| 理赔查询 | [`reference/claim.md`](reference/claim.md) | 参数多（单号/时间/状态/分页），必须确认 |
+| 认证相关 / 首次使用 | [`reference/auth.md`](reference/auth.md) | 了解认证方式和 API Key 获取地址 |
+| 配置管理 | [`reference/config.md`](reference/config.md) | 了解可配置项 |
+| 升级 CLI / skill | [`reference/update.md`](reference/update.md) | 了解升级流程和选项 |
+
+**未读对应 reference 就执行命令可能导致参数错误或遗漏关键选项。**
+
+---
+
+## 命令总览
+
+| 模块 | 用途 | 参考文件 |
+|------|------|----------|
+| `auth` | 认证管理：配置 API Key、查看认证状态 | [`reference/auth.md`](reference/auth.md) |
+| `config` | 配置管理：查看/设置配置项、导出 tool schema | [`reference/config.md`](reference/config.md) |
+| `track` | 物流轨迹：按单号查询物流全程轨迹 | [`reference/track.md`](reference/track.md) |
+| `label` | 面单打印：获取面单 PDF 链接 | [`reference/label.md`](reference/label.md) |
+| `order` | 订单详情：查看收件人、费用、状态等完整信息 | [`reference/order.md`](reference/order.md) |
+| `product` | 产品推荐：根据目的地/重量等条件获取推荐物流产品及报价 | [`reference/product.md`](reference/product.md) |
+| `claim` | 理赔查询：按单号/时间/状态查询理赔列表 | [`reference/claim.md`](reference/claim.md) |
+| `update` | 升级：检查并升级 CLI 及 skill 到最新版本 | [`reference/update.md`](reference/update.md) |
+
+运行 `fmc <command> --help` 查看命令帮助。
+
+---
+
+## 意图判断决策树
+
+用户提到"包裹到哪了/物流状态/轨迹/在途" → `fmc track get`
+用户提到"面单/运单/打印/标签/label" → `fmc label get`
+用户提到"订单详情/收件人/费用明细/订单信息" → `fmc order get`
+用户提到"推荐产品/选什么物流/报价/寄到XX国" → `fmc product recommend`
+用户提到"理赔/索赔/赔偿/丢件赔付" → `fmc claim list`
+用户提到"登录/配置key/认证" → `fmc auth login`
+用户提到"升级/更新/新版本" → `fmc update`
+
+### 消歧规则
+
+| 易混淆场景 | 正确路由 | 不要用 | 理由 |
+|-----------|---------|--------|------|
+| "查一下这个单号" | `track get`（默认） | — | 无额外上下文时默认查轨迹；若用户要费用/收件人则走 `order get` |
+| "这个包裹的详情" | `order get` | `track get` | "详情"含收件人/费用等结构化信息 |
+| "我的包裹丢了" | `claim list` | `track get` | 用户意图是理赔而非查轨迹 |
+| "寄快递/发货选什么" | `product recommend` | — | 发货前选品，需要国家参数 |
+| "运费多少" | `product recommend` | `order get` | 发货前询价用 product；已发货查费用用 order |
+
+---
+
+## Authentication
+
+```bash
+# 配置 API Key（持久化到 ~/.bportal/config.json）
+fmc auth login --api-key SK_xxxxx
+
+# 或通过环境变量
+export BPORTAL_API_KEY=SK_xxxxx
+```
+
+获取 API Key: https://b.4px.com/site/ak-manage
+
+---
+
+## Global flags
+
+所有命令都支持以下全局选项：
+
+| Flag | Description |
+| --- | --- |
+| `--output <format>` | 输出格式: text（默认 TTY）/ json（默认管道） |
+| `--verbose` | 打印请求详情（URL、Headers、状态码） |
+| `--dry-run` | 仅打印请求信息，不实际发送 |
+| `--help` | 查看帮助 |
+| `--version` | 打印版本号 |
+
+---
+
+## Quick examples
+
+```bash
+# 查询物流轨迹
+fmc track get FPX12345678
+
+# 获取面单 PDF 链接
+fmc label get FPX12345678
+
+# 查看订单详情
+fmc order get FPX12345678
+
+# 获取推荐产品（寄美国）
+fmc product recommend --country US
+
+# 查询理赔列表（按单号）
+fmc claim list --biz-no FPX12345678
+
+# JSON 格式输出
+fmc track get FPX12345678 --output json
+```
+
+---
+
+## Configuration
+
+- **配置文件**: `~/.bportal/config.json`
+- **环境变量**: `BPORTAL_API_KEY`, `BPORTAL_BASE_URL`
+
+```bash
+fmc config list
+fmc config set baseUrl https://b.4px.com
+```
+
+---
+
+## 错误处理
+
+1. 命令失败 → 加 `--verbose` 重试一次查看详细错误
+2. 认证失败 → 引导用户执行 `fmc auth login --api-key <key>`
+3. 参数错误 → 读取对应 reference 文件确认正确参数格式
+4. 仍然失败 → 停止并报告完整错误信息，禁止反复重试
+
+## 详细参考（按需读取）
+
+- [`reference/index.md`](reference/index.md) — 命令完整索引、全局选项
+- [`reference/auth.md`](reference/auth.md) — 认证管理详细参数
+- [`reference/config.md`](reference/config.md) — 配置管理详细参数
+- [`reference/track.md`](reference/track.md) — 物流轨迹查询详细参数
+- [`reference/label.md`](reference/label.md) — 面单打印详细参数
+- [`reference/order.md`](reference/order.md) — 订单详情详细参数
+- [`reference/product.md`](reference/product.md) — 产品推荐详细参数
+- [`reference/claim.md`](reference/claim.md) — 理赔查询详细参数
+- [`reference/update.md`](reference/update.md) — CLI / skill 升级详细参数

package/skill/reference/auth.md

@@ -0,0 +1,62 @@
+# `fmc auth` commands
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `fmc auth login` | 配置 API Key |
+| `fmc auth status` | 查看当前认证状态 |
+
+## Command details
+
+### `fmc auth login`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth login` |
+| **Description** | 配置 API Key，持久化到 ~/.bportal/config.json |
+| **Usage** | `fmc auth login --api-key <key>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--api-key <key>` | string | yes | API Key（格式：SK_xxx） |
+
+获取 API Key: https://b.4px.com/site/ak-manage
+
+#### Examples
+
+```bash
+fmc auth login --api-key SK_xxxxx
+```
+
+### `fmc auth status`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `auth status` |
+| **Description** | 查看当前认证状态（Key 来源、Base URL） |
+| **Usage** | `fmc auth status` |
+
+支持全局选项: `--output`
+
+#### Examples
+
+```bash
+fmc auth status
+```
+
+```bash
+fmc auth status --output json
+```
+
+#### Output (text mode)
+
+```
+Authentication Status:
+  Status:   ✔ 已认证
+  Source:   ~/.bportal/config.json
+  Key:      SK_1***3456
+  Base URL: https://b.4px.com
+```

package/skill/reference/claim.md

@@ -0,0 +1,66 @@
+# `fmc claim` command
+
+## Command details
+
+### `fmc claim list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `claim list` |
+| **Description** | 查询理赔列表 |
+| **Usage** | `fmc claim list [flags]` |
+
+需要 API Key 认证。`--biz-no` 与时间范围至少传一项。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-no <nos>` | string | no | 业务单号，多个用英文逗号分隔 |
+| `--start-time <time>` | string | no | 起始创建时间，格式 yyyy-MM-dd HH:mm:ss |
+| `--end-time <time>` | string | no | 结束创建时间，格式 yyyy-MM-dd HH:mm:ss |
+| `--status <code>` | string | no | 理赔状态：0 全部、1 待处理、2 受理中、3 已解决、4 已退回 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10，最大 100 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc claim list --biz-no FPX12345678
+```
+
+```bash
+fmc claim list --start-time "2024-01-01 00:00:00" --end-time "2024-12-31 23:59:59"
+```
+
+```bash
+fmc claim list --status 1 --page 1 --size 20
+```
+
+```bash
+fmc claim list --biz-no FPX111,FPX222 --output json
+```
+
+#### Output (text mode)
+
+```
+理赔列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  CLM20240115001  受理中
+    业务单号    FPX12345678
+    索赔原因    包裹丢失
+    货值赔偿    150.00 USD
+    最新反馈    正在核实物流信息
+    创建时间    2024-01-15 10:30:00
+
+  CLM20240110002  已解决
+    业务单号    FPX87654321
+    索赔原因    包裹破损
+    货值赔偿    50.00 USD
+    服务赔偿    20.00 USD
+    创建时间    2024-01-10 08:00:00
+```

package/skill/reference/config.md

@@ -0,0 +1,71 @@
+# `fmc config` commands
+
+## Commands in this group
+
+| Command | Description |
+| --- | --- |
+| `fmc config set` | 设置配置项 |
+| `fmc config list` | 查看当前配置 |
+| `fmc config export-schema` | 导出命令的 JSON tool schema（供 AI Agent 使用） |
+
+## Command details
+
+### `fmc config set`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config set` |
+| **Description** | 设置配置项 |
+| **Usage** | `fmc config set <key> <value>` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<key>` | string | yes | 配置项名称（可选: baseUrl, apiKey） |
+| `<value>` | string | yes | 配置项值 |
+
+#### Examples
+
+```bash
+fmc config set baseUrl https://b.4px.com
+fmc config set apiKey SK_xxxxx
+```
+
+### `fmc config list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config list` |
+| **Description** | 查看当前配置 |
+| **Usage** | `fmc config list` |
+
+#### Examples
+
+```bash
+fmc config list
+```
+
+### `fmc config export-schema`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `config export-schema` |
+| **Description** | 导出所有（或指定）CLI 命令的 JSON tool schema，兼容 OpenAI / Anthropic 格式 |
+| **Usage** | `fmc config export-schema [--command "<name>"]` |
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--command <name>` | string | no | 仅导出指定命令的 schema（如 "track"） |
+
+#### Examples
+
+```bash
+fmc config export-schema
+```
+
+```bash
+fmc config export-schema --command "track"
+```