@besile/scm-cli 2026.3.29

package/src/cmd/auth/logout.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli auth logout command
+ */
+import { scmClient, createLogger } from '../../internal/index.js';
+
+/**
+ * Register auth logout subcommand
+ */
+export function logoutCommand(program) {
+    program
+        .command('logout')
+        .description('登出并清除 Token')
+        .requiredOption('--openId <openId>', '飞书用户 openId')
+        .option('-y, --yes', '跳过确认')
+        .action(async (opts) => {
+            if (!opts.yes) {
+                const readline = await import('node:readline/promises');
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const answer = await rl.question(`确认清除 openId=${opts.openId} 的 Token？(y/N) `);
+                rl.close();
+                if (answer.toLowerCase() !== 'y') {
+                    console.log('已取消');
+                    process.exit(0);
+                }
+            }
+
+            try {
+                await scmClient.clearUserToken(opts.openId);
+                console.log(`✅ 已清除 openId=${opts.openId} 的 Token`);
+            } catch (err) {
+                console.error('❌ 清除失败:', err.message);
+                process.exit(1);
+            }
+        });
+}

package/src/cmd/auth/status.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli auth status command
+ */
+import { checkToken, getCachedToken, createLogger } from '../../internal/index.js';
+
+/**
+ * Register auth status subcommand
+ */
+export function statusCommand(program) {
+    program
+        .command('status')
+        .description('检查 Token 状态')
+        .requiredOption('--openId <openId>', '飞书用户 openId')
+        .action(async (opts) => {
+            const result = await checkToken(opts.openId);
+
+            if (result.valid) {
+                console.log(`✅ Token 有效 — openId=${opts.openId}`);
+            } else {
+                console.log(`❌ Token 无效 — openId=${opts.openId}`);
+                console.log(`   ${result.message}`);
+                console.log('\n请先登录: scm-cli auth login --openId <openId> --mobile <手机号> --password <密码>');
+            }
+        });
+}

package/src/cmd/auth/token.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli auth token command — list/show/clear tokens
+ */
+import { TOKEN_FILE_PATH, loadConfig } from '../../internal/index.js';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+async function loadTokens() {
+    try {
+        const data = await readFile(TOKEN_FILE_PATH, 'utf-8');
+        return JSON.parse(data);
+    } catch {
+        return {};
+    }
+}
+
+async function listTokens() {
+    const tokens = await loadTokens();
+    const entries = Object.entries(tokens);
+
+    if (entries.length === 0) {
+        console.log('未找到缓存的 Token');
+        return;
+    }
+
+    console.log('\n┌─────────────────────────────────────────────────────────────────────────────┐');
+    console.log('│                           缓存的 Token 列表                                  │');
+    console.log('├─────────────────────────────────────────────────────────────────────────────┤');
+
+    for (const [openId, token] of entries) {
+        const now = Date.now() / 1000;
+        const isExpired = token.expires_at <= now;
+        const status = isExpired ? '❌ 已过期' : '✅ 有效';
+
+        console.log(`│ Open ID:  ${openId.padEnd(60)}  │`);
+        console.log(`│ 用户名:   ${(token.username || '-').padEnd(60)}  │`);
+        console.log(`│ 状态:     ${status.padEnd(60)}  │`);
+        console.log(`│ 过期时间: ${new Date(token.expires_at * 1000).toLocaleString('zh-CN').padEnd(60)}  │`);
+        console.log('├─────────────────────────────────────────────────────────────────────────────┤');
+    }
+    console.log(`\n共 ${entries.length} 个用户`);
+}
+
+async function showToken(openId) {
+    const tokens = await loadTokens();
+    const token = tokens[openId];
+
+    if (!token) {
+        console.log(`未找到 openId=${openId} 的 Token`);
+        return;
+    }
+
+    const now = Date.now() / 1000;
+    const remaining = Math.max(0, token.expires_at - now);
+    const isExpired = token.expires_at <= now;
+
+    console.log('\n┌─────────────────────────────────────────────────────────────────────────────┐');
+    console.log('│                           Token 详细信息                                      │');
+    console.log('├─────────────────────────────────────────────────────────────────────────────┤');
+    console.log(`│ Open ID:      ${openId.padEnd(56)}  │`);
+    console.log(`│ 用户名:       ${(token.username || '-').padEnd(56)}  │`);
+    console.log(`│ 状态:         ${(isExpired ? '已过期' : '有效').padEnd(56)}  │`);
+    console.log(`│ 剩余时间:     ${isExpired ? '已过期' : `${Math.round(remaining / 60)} 分钟`.padEnd(56)}  │`);
+    console.log(`│ 过期时间:     ${new Date(token.expires_at * 1000).toLocaleString('zh-CN').padEnd(56)}  │`);
+    console.log('└─────────────────────────────────────────────────────────────────────────────┘');
+}
+
+async function clearToken(openId) {
+    const tokens = await loadTokens();
+    if (!tokens[openId]) {
+        console.log(`未找到 openId=${openId} 的 Token`);
+        return;
+    }
+    delete tokens[openId];
+    const { writeFile } = await import('node:fs/promises');
+    await writeFile(TOKEN_FILE_PATH, JSON.stringify(tokens, null, 2), 'utf-8');
+    console.log(`✅ 已清除 openId=${openId} 的 Token`);
+}
+
+async function clearAllTokens() {
+    const { unlink } = await import('node:fs/promises');
+    try {
+        await unlink(TOKEN_FILE_PATH);
+        console.log('✅ 已清除所有 Token');
+    } catch {
+        console.log('未找到 Token 缓存');
+    }
+}
+
+export function tokenCommand(program) {
+    const tokenCmd = program.command('token').description('Token 管理');
+
+    tokenCmd
+        .command('list')
+        .alias('ls')
+        .description('列出所有缓存的 Token')
+        .action(async () => { await listTokens(); });
+
+    tokenCmd
+        .command('show <openId>')
+        .description('显示指定用户的 Token 详情')
+        .action(async (openId) => { await showToken(openId); });
+
+    tokenCmd
+        .command('clear <openId>')
+        .description('清除指定用户的 Token')
+        .action(async (openId) => { await clearToken(openId); });
+
+    tokenCmd
+        .command('clear-all')
+        .description('清除所有 Token')
+        .action(async () => { await clearAllTokens(); });
+}

package/src/cmd/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Register all CLI commands and shortcuts to the program
+ */
+import { loginCommand } from './auth/login.js';
+import { logoutCommand } from './auth/logout.js';
+import { statusCommand } from './auth/status.js';
+import { tokenCommand } from './auth/token.js';
+import { productionOrdersCommand } from './orders/production-orders.js';
+import { materialOrdersCommand } from './orders/material-orders.js';
+import { qcOrdersCommand } from './orders/qc-orders.js';
+import { getShortcutsMap } from '../shortcuts/index.js';
+import { registerShortcuts } from '../shortcuts/register.js';
+
+/**
+ * Register all subcommands to the program
+ *
+ * @param {Object} program - Commander program
+ * @param {Object} internalCtx - Internal context { log }
+ */
+export function registerCommands(program, internalCtx) {
+    // Auth subcommands
+    const authCmd = program.command('auth').description('认证管理');
+    loginCommand(authCmd);
+    logoutCommand(authCmd);
+    statusCommand(authCmd);
+    tokenCommand(authCmd);
+
+    // Orders subcommands
+    productionOrdersCommand(program);
+    materialOrdersCommand(program);
+    qcOrdersCommand(program);
+
+    // Shortcuts (registered under their domain commands)
+    const shortcutsMap = getShortcutsMap();
+    registerShortcuts(program, shortcutsMap, internalCtx);
+}

package/src/cmd/orders/material-orders.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli material-orders command
+ */
+import { loadConfig, getCachedToken, checkToken, promptLogin, createLogger } from '../../internal/index.js';
+import { doLogin } from '../auth/login.js';
+
+/**
+ * Query material orders via SCM API
+ *
+ * @param {string} openId - 飞书用户 openId
+ * @param {Object} opts - 命令行选项
+ * @param {Object} config - 配置对象
+ */
+async function queryMaterialOrders(openId, opts, config) {
+    const token = await getCachedToken(openId);
+    const url = `${config.baseUrl}/admin-api/api/ai-scm/execute`;
+
+    const filter = {
+        pageNo: parseInt(opts.pageNo) || 1,
+        pageSize: Math.min(parseInt(opts.pageSize) || 20, 100),
+    };
+
+    // 订单信息
+    if (opts.orderNo) filter.orderNo = opts.orderNo;
+    if (opts.status !== undefined) filter.status = parseInt(opts.status);
+    if (opts.cooperationMode !== undefined) filter.cooperationMode = parseInt(opts.cooperationMode);
+
+    // 商品信息
+    if (opts.goodsFullCode) filter.goodsFullCode = opts.goodsFullCode;
+    if (opts.goodsBatch) filter.goodsBatch = opts.goodsBatch;
+    if (opts.goodsType !== undefined) filter.goodsType = parseInt(opts.goodsType);
+
+    // 供应商
+    if (opts.supplierName) filter.supplierName = opts.supplierName;
+
+    // 人员
+    if (opts.purchaserIdList) filter.purchaserIdList = opts.purchaserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.pdUserIdList) filter.pdUserIdList = opts.pdUserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.designerName) filter.designerName = opts.designerName;
+
+    // 时间
+    if (opts.type !== undefined) filter.type = parseInt(opts.type);
+    if (opts.startTime) filter.startTime = opts.startTime;
+    if (opts.endTime) filter.endTime = opts.endTime;
+
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+        body: JSON.stringify({ domain: 'goods_material', action: 'query', filter }),
+    });
+
+    const data = await response.json();
+    if (!response.ok) {
+        if (response.status === 401) throw new Error('Token 无效或已过期，请重新登录');
+        throw new Error(`HTTP ${response.status}`);
+    }
+    if (data.code !== 0 && data.code !== 200 && data.success !== true) {
+        throw new Error(data.msg || `API 错误: ${data.code}`);
+    }
+
+    return data.data || data;
+}
+
+export function materialOrdersCommand(program) {
+    program
+        .command('material-orders')
+        .description('查询物料订单')
+        .requiredOption('--openId <openId>', '飞书用户 openId')
+        // 分页
+        .option('--pageNo <pageNo>', '页码', '1')
+        .option('--pageSize <pageSize>', '每页条数', '20')
+        // 订单信息
+        .option('--orderNo <orderNo>', '物料订单号')
+        .option('--status <status>', '物料订单状态: 0-待采购|1-采购中|2-部分到货|3-已到货|4-已取消')
+        .option('--cooperationMode <cooperationMode>', '合作模式: 0-CMT|1-FOB')
+        // 商品信息
+        .option('--goodsFullCode <goodsFullCode>', '大货款号')
+        .option('--goodsBatch <goodsBatch>', '大货批次')
+        .option('--goodsType <goodsType>', '大货类型: 0-首单|1-加单|2-翻单')
+        // 供应商
+        .option('--supplierName <supplierName>', '供应商名称')
+        // 人员
+        .option('--purchaserIdList <purchaserIdList>', '采购 ID 列表 (逗号分隔)')
+        .option('--pdUserIdList <pdUserIdList>', 'PD ID 列表 (逗号分隔)')
+        .option('--designerName <designerName>', '设计师名称')
+        // 时间
+        .option('--type <type>', '时间查询类型: 0-上市|1-下单|2-交期|3-调整|4-关单|5-生产下单|6-工厂接单|7-计划到货|8-实际到货|9-需求到货')
+        .option('--startTime <startTime>', '开始时间 (ISO 8601)')
+        .option('--endTime <endTime>', '结束时间 (ISO 8601)')
+        // 输出
+        .option('--format <format>', '输出格式: table|json|pretty', 'table')
+        .action(async (opts) => {
+            const config = loadConfig();
+
+            const tokenCheck = await checkToken(opts.openId);
+            if (!tokenCheck.valid) {
+                const loginResult = await promptLogin(opts.openId);
+                if (!loginResult.success) process.exit(1);
+                try {
+                    await doLogin(opts.openId, loginResult.mobile, loginResult.password);
+                    console.log('✅ 登录成功！\n');
+                } catch (err) {
+                    console.error('\n❌ 登录失败:', err.message);
+                    process.exit(1);
+                }
+            }
+
+            try {
+                console.log('正在查询物料订单...');
+                const result = await queryMaterialOrders(opts.openId, opts, config);
+                console.log(opts.format === 'json'
+                    ? JSON.stringify(result, null, 2)
+                    : JSON.stringify(result, null, 2));
+            } catch (err) {
+                console.error('\n❌ 查询失败:', err.message);
+                process.exit(1);
+            }
+        });
+}

package/src/cmd/orders/production-orders.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli production-orders command
+ */
+import { scmClient, loadConfig, createLogger, getCachedToken, checkToken, promptLogin } from '../../internal/index.js';
+import { doLogin } from '../auth/login.js';
+
+/**
+ * Query production orders via SCM API
+ *
+ * @param {string} openId - 飞书用户 openId
+ * @param {Object} opts - 命令行选项
+ * @param {Object} config - 配置对象
+ */
+async function queryProductionOrders(openId, opts, config) {
+    const token = await getCachedToken(openId);
+    const url = `${config.baseUrl}/admin-api/api/ai-scm/execute`;
+
+    const filter = {
+        pageNo: parseInt(opts.pageNo) || 1,
+        pageSize: Math.min(parseInt(opts.pageSize) || 20, 100),
+    };
+
+    // 商品信息
+    if (opts.goodsFullCode) filter.goodsFullCode = opts.goodsFullCode;
+    if (opts.goodsBatch) filter.goodsBatch = opts.goodsBatch;
+    if (opts.goodsType !== undefined) filter.goodsType = parseInt(opts.goodsType);
+
+    // 订单状态
+    if (opts.prodStatus !== undefined) filter.prodStatus = parseInt(opts.prodStatus);
+    if (opts.confirmSupplier !== undefined) filter.confirmSupplier = parseInt(opts.confirmSupplier);
+    if (opts.supplierOrderStatus !== undefined) filter.supplierOrderStatus = parseInt(opts.supplierOrderStatus);
+    if (opts.quotationStatus !== undefined) filter.quotationStatus = parseInt(opts.quotationStatus);
+    if (opts.washStatus !== undefined) filter.washStatus = parseInt(opts.washStatus);
+    if (opts.qcInspection !== undefined) filter.qcInspection = parseInt(opts.qcInspection);
+
+    // 供应商
+    if (opts.supplierName) filter.supplierName = opts.supplierName;
+    if (opts.cooperationMode !== undefined) filter.cooperationMode = parseInt(opts.cooperationMode);
+
+    // 人员
+    if (opts.pdUserIdList) filter.pdUserIdList = opts.pdUserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.purchaserIdList) filter.purchaserIdList = opts.purchaserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.designerName) filter.designerName = opts.designerName;
+
+    // 时间
+    if (opts.type !== undefined) filter.type = parseInt(opts.type);
+    if (opts.startTime) filter.startTime = opts.startTime;
+    if (opts.endTime) filter.endTime = opts.endTime;
+
+    // 分类
+    if (opts.saleArea) filter.saleArea = opts.saleArea.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+        body: JSON.stringify({ domain: 'production_order', action: 'query', filter }),
+    });
+
+    const data = await response.json();
+
+    if (!response.ok) {
+        if (response.status === 401) throw new Error('Token 无效或已过期，请重新登录');
+        throw new Error(`HTTP ${response.status}`);
+    }
+    if (data.code !== 0 && data.code !== 200 && data.success !== true) {
+        throw new Error(data.msg || `API 错误: ${data.code}`);
+    }
+
+    return data.data || data;
+}
+
+/**
+ * Register production-orders subcommand
+ */
+export function productionOrdersCommand(program) {
+    program
+        .command('production-orders')
+        .alias('orders')
+        .description('查询大货生产订单')
+        .requiredOption('--openId <openId>', '飞书用户 openId')
+        // 分页
+        .option('--pageNo <pageNo>', '页码', '1')
+        .option('--pageSize <pageSize>', '每页条数', '20')
+        // 商品信息
+        .option('--goodsFullCode <goodsFullCode>', '大货款号')
+        .option('--goodsBatch <goodsBatch>', '大货批次')
+        .option('--goodsType <goodsType>', '大货类型: 0-首单|1-加单|2-翻单')
+        // 订单状态
+        .option('--prodStatus <prodStatus>', '大货生产订单状态: -1-全部|0-待确定|1-待同步|2-在途中|3-已完成|100-已取消')
+        .option('--confirmSupplier <confirmSupplier>', '确认供应商: 0-未确认|1-已确认')
+        .option('--supplierOrderStatus <supplierOrderStatus>', '供应商生产订单状态: 0-待接单|1-生产中|2-已退单|3-已完成|4-已取消')
+        .option('--quotationStatus <quotationStatus>', '报价单状态: 0-确认中|1-已驳回|2-已确认|3-未提报')
+        .option('--washStatus <washStatus>', '洗唛订单状态: -1-无|0-未同步|1-已同步|2-未确认|3-生产中|4-已发货|5-已取消')
+        .option('--qcInspection <qcInspection>', 'QC 质检结果')
+        // 供应商
+        .option('--supplierName <supplierName>', '供应商名称')
+        .option('--cooperationMode <cooperationMode>', '合作模式: 0-CMT|1-FOB')
+        // 人员
+        .option('--pdUserIdList <pdUserIdList>', 'PD ID 列表 (逗号分隔)')
+        .option('--purchaserIdList <purchaserIdList>', '采购 ID 列表 (逗号分隔)')
+        .option('--designerName <designerName>', '设计师名称')
+        // 时间
+        .option('--type <type>', '时间查询类型: 0-上市|1-下单|2-交期|3-调整|4-关单|5-生产下单|6-工厂接单|7-计划到货|8-实际到货|9-需求到货')
+        .option('--startTime <startTime>', '开始时间 (ISO 8601)')
+        .option('--endTime <endTime>', '结束时间 (ISO 8601)')
+        // 分类
+        .option('--saleArea <saleArea>', '销售地区 ID 列表 (逗号分隔)')
+        // 输出
+        .option('--format <format>', '输出格式: table|json|pretty', 'table')
+        .action(async (opts) => {
+            const config = loadConfig();
+            const log = createLogger(opts.debug || config.debug);
+
+            const tokenCheck = await checkToken(opts.openId);
+            if (!tokenCheck.valid) {
+                const loginResult = await promptLogin(opts.openId);
+                if (!loginResult.success) process.exit(1);
+                try {
+                    await doLogin(opts.openId, loginResult.mobile, loginResult.password);
+                    console.log('✅ 登录成功！\n');
+                } catch (err) {
+                    console.error('\n❌ 登录失败:', err.message);
+                    process.exit(1);
+                }
+            }
+
+            try {
+                console.log('正在查询生产订单...');
+                const result = await queryProductionOrders(opts.openId, opts, config);
+                const data = opts.format === 'json'
+                    ? JSON.stringify(result, null, 2)
+                    : JSON.stringify(result, null, 2);
+                console.log(data);
+            } catch (err) {
+                console.error('\n❌ 查询失败:', err.message);
+                process.exit(1);
+            }
+        });
+}

package/src/cmd/orders/qc-orders.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli qc-orders command
+ */
+import { loadConfig, getCachedToken, checkToken, promptLogin } from '../../internal/index.js';
+import { doLogin } from '../auth/login.js';
+
+async function queryQcOrders(openId, opts, config) {
+    const token = await getCachedToken(openId);
+    const url = `${config.baseUrl}/admin-api/api/ai-scm/execute`;
+
+    const filter = {
+        pageNo: parseInt(opts.pageNo) || 1,
+        pageSize: Math.min(parseInt(opts.pageSize) || 20, 100),
+    };
+    if (opts.qcOrderStatus !== undefined) filter.qcOrderStatus = parseInt(opts.qcOrderStatus);
+    if (opts.goodsFullCode) filter.goodsFullCode = opts.goodsFullCode;
+    if (opts.goodsType !== undefined) filter.goodsType = parseInt(opts.goodsType);
+    if (opts.supplierName) filter.supplierName = opts.supplierName;
+    if (opts.goodsGradeList) filter.goodsGradeList = opts.goodsGradeList.split(',').map(s => s.trim());
+    if (opts.midManager) filter.midManager = opts.midManager;
+    if (opts.checkGoods) filter.checkGoods = opts.checkGoods;
+    if (opts.tailManager) filter.tailManager = opts.tailManager;
+    if (opts.qcUserIdList) filter.qcUserIdList = opts.qcUserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.prodManagerIdList) filter.prodManagerIdList = opts.prodManagerIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.purchaserIdList) filter.purchaserIdList = opts.purchaserIdList.split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+    if (opts.timeType !== undefined) filter.timeType = parseInt(opts.timeType);
+    if (opts.startTime) filter.startTime = opts.startTime;
+    if (opts.endTime) filter.endTime = opts.endTime;
+
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+        body: JSON.stringify({ domain: 'qc_order', action: 'query', filter }),
+    });
+
+    const data = await response.json();
+    if (!response.ok) {
+        if (response.status === 401) throw new Error('Token 无效或已过期，请重新登录');
+        throw new Error(`HTTP ${response.status}`);
+    }
+    if (data.code !== 0 && data.code !== 200 && data.success !== true) {
+        throw new Error(data.msg || `API 错误: ${data.code}`);
+    }
+
+    return data.data || data;
+}
+
+export function qcOrdersCommand(program) {
+    program
+        .command('qc-orders')
+        .alias('qc')
+        .description('查询 QC 质检订单')
+        .requiredOption('--openId <openId>', '飞书用户 openId')
+        // 分页
+        .option('--pageNo <pageNo>', '页码', '1')
+        .option('--pageSize <pageSize>', '每页条数', '20')
+        // 订单状态
+        .option('--qcOrderStatus <qcOrderStatus>', 'QC 订单状态: -1-全部|0-待分配|1-已分配|2-已完成|3-已取消')
+        // 商品信息
+        .option('--goodsFullCode <goodsFullCode>', '大货款号')
+        .option('--goodsType <goodsType>', '大货类型: 1-大货|2-翻单|3-补料')
+        .option('--goodsGradeList <goodsGradeList>', '商品分级列表 (逗号分隔)')
+        // 供应商
+        .option('--supplierName <supplierName>', '供应商名称')
+        // 人员
+        .option('--midManager <midManager>', '跟单员名称')
+        .option('--checkGoods <checkGoods>', 'QC 跟单员名称')
+        .option('--tailManager <tailManager>', '尾查员名称')
+        .option('--qcUserIdList <qcUserIdList>', 'QC 质检员 ID 列表 (逗号分隔)')
+        .option('--prodManagerIdList <prodManagerIdList>', '生产负责人 ID 列表 (逗号分隔)')
+        .option('--purchaserIdList <purchaserIdList>', '采购员 ID 列表 (逗号分隔)')
+        // 时间
+        .option('--timeType <timeType>', '时间类型: 0-预约验货|1-下单|2-接单|3-分配|4-完成|5-交期')
+        .option('--startTime <startTime>', '开始时间 (ISO 8601)')
+        .option('--endTime <endTime>', '结束时间 (ISO 8601)')
+        // 输出
+        .option('--format <format>', '输出格式: table|json|pretty', 'table')
+        .action(async (opts) => {
+            const config = loadConfig();
+
+            const tokenCheck = await checkToken(opts.openId);
+            if (!tokenCheck.valid) {
+                const loginResult = await promptLogin(opts.openId);
+                if (!loginResult.success) process.exit(1);
+                try {
+                    await doLogin(opts.openId, loginResult.mobile, loginResult.password);
+                    console.log('✅ 登录成功！\n');
+                } catch (err) {
+                    console.error('\n❌ 登录失败:', err.message);
+                    process.exit(1);
+                }
+            }
+
+            try {
+                console.log('正在查询 QC 订单...');
+                const result = await queryQcOrders(opts.openId, opts, config);
+                console.log(opts.format === 'json'
+                    ? JSON.stringify(result, null, 2)
+                    : JSON.stringify(result, null, 2));
+            } catch (err) {
+                console.error('\n❌ 查询失败:', err.message);
+                process.exit(1);
+            }
+        });
+}

package/src/cmd/root.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * scm-cli root command — creates the commander program with global flags
+ */
+import { Command } from 'commander';
+import { createLogger } from '../internal/index.js';
+
+/**
+ * Create the root commander program
+ *
+ * @param {Object} opts - Options { version, name }
+ * @returns {Command} Configured commander program
+ */
+export function createProgram(opts = {}) {
+    const { version = '1.0.0', name = 'scm-cli' } = opts;
+
+    const program = new Command();
+
+    program
+        .name(name)
+        .version(version)
+        .description('SCM CLI — 供应链管理命令行工具')
+        .option('--format <format>', '输出格式: table|json|pretty', 'table')
+        .option('--debug', '开启调试模式');
+
+    return program;
+}
+
+/**
+ * Build internal context for command execution
+ *
+ * @param {Object} opts - Global options from program
+ * @returns {Object} Internal context
+ */
+export function buildInternalContext(opts = {}) {
+    const log = createLogger(opts.debug || false);
+    return { log };
+}

package/src/core/scm-client.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * @deprecated Import from src/internal/client/scm-client.js instead
+ */
+export { scmClient, ScmClient } from '../internal/client/scm-client.js';