跳到主要内容

快麦 CLI

kuaimai-cli 面向人与 AI Agent，通过双通道授权操作快麦 ERP / 供应链：商品、铺货、仓储、交易、售后、报表等。

当前稳定版本：@kuaimai-cli/cli@0.2.27（以 npm latest 为准）

立即开始​

npx @kuaimai-cli/cli@latest install
kuaimai-cli --version
kuaimai-cli auth login system "<accessToken>"
kuaimai-cli auth check system --output json
kuaimai-cli erp-item +list --body '{"pageNo":1,"pageSize":10}' --output json

完整说明（成功/失败现象、是否写业务数据）见 5 分钟快速开始。

也可用 Agent 安装：把下面指令发给 Cursor / Claude Code 等：

帮我安装快麦 CLI：https://gitee.com/kuaimai-cli/kuaimai-cli/blob/main/docs/KUAIMAI_CLI_INSTALL_GUIDE_AGENT.md

选择授权通道​

两套通道分开登录、互不替代，由不同命令调用，不会自动改道。

通道是什么登录后怎么用典型场景
系统授权ERP 页面开放接口（与网页同一套后端能力）；Token 在 ERP「基础 → 权限管理 → 员工」生成（以界面为准）capabilities / schema / web call、erp-item、scm-item商品档案、可铺货商品、铺货、订单审核等
快麦开放平台官方开放平台 API（邮件下发凭证）open call、open-*仓库、商品、交易、售后、采购、报表、快麦通等
  • 只登系统 → 只能调系统侧命令
  • 只登开放平台 → 只能用 open call / open-*
  • 两边都登时：同类业务优先选用开放平台命令；系统侧能力仍走系统命令
  • 暂不支持多账号 / 多应用切换，也不提供 --via 强制切通道

详见 鉴权说明。

常见使用场景​

用户意图通道做法
登录 / 看授权状态—auth login / auth status / doctor
有哪些接口可用系统capabilities → schema → web call
查可铺货商品、铺货、铺货日志系统scm-item（见 Skill）
改 ERP 商品档案标题系统erp-item（明确「商品档案」时）
查仓库 / 拉开放接口订单开放平台open call 或 open-warehouse / open-trade 等

安全提醒​

  • 凭证写入 ~/.kuaimai-cli/config.yaml（权限 0600）；勿提交仓库、勿贴进工单或截图
  • 命令行传 token 可能进入 Shell 历史；用完可 auth logout
  • config get 默认脱敏；原文需 config get --reveal
  • 写操作：定位 → --dry-run 预览 → 用户确认 → 再正式执行（Agent 须遵循；CLI 不强制交互确认）

详见 安全说明。

下一步​