# 命令行工具 (Beta)

把接口包成终端里能敲的命令：程序员试接口、脚本进管道、AI 编程助手不用配 MCP 就能用。它只是把命令翻译成对网关的调用，**认证、授权、限流全在网关那一处**。

> CLI 处于 Beta: 命令随能力目录变化，可能还会调整；用着不对劲告诉对接人。

## 安装

macOS / Linux：

```bash
curl -fsSL https://connect.everugg.net.au/cli/install.sh | sh
```

Windows（PowerShell）：

```powershell
irm https://connect.everugg.net.au/cli/install.ps1 | iex
```

单文件二进制，不需要 Node 或 Python。装完运行 `ever --help`。网关地址已写进本地配置，用 `ever config base <url>` 可改。

## 三步跑通

先用公共沙箱（演示数据，动不了真库存）：

```bash
ever login --sandbox
ever whoami
ever stock changes AU --since 0
```

换成自己的渠道（口令只在换 token 时发出，默认保存在本机 0600 权限的配置文件里，`--no-save-secret` 可不存）：

```bash
ever login --channel 100780
ever stock sku AU OB0021611
ever order create --file order.json --confirm
ever stock changes AU --since 51204 --json | jq '.data | length'
```

写操作（下单等）默认只预览，加 `--confirm` 才真发，且**永远只建草稿**，由人在 ERP 确认。`--json` 原样输出信封，方便 `jq` 与脚本。

## 给 AI 编程助手用

Claude Code、Cursor 这类助手本来就会用终端：装上 `ever`，它就能自己查库存、读文档。`ever tools --json` 列出能调的工具（按你的权限裁剪，和 MCP 同一套名字），`ever docs <tool>` 打印那条接口的 Markdown 文档。

```bash
ever tools --json
ever docs stock_changes
ever call stock_changes --warehouse_code AU --since 0 --json
```

## 命令清单

命令来自网关的**能力目录**（`/tools.json`），启动时拉取、本地缓存 1 小时——目录一改，CLI 不用重发。`ever call <tool> --参数 值`；常用的有快捷写法：`ever stock changes AU --since 0`、`ever stock sku AU OB0021611`、`ever order get <单号>`。

- `ever call warehouse_list` — 仓库清单：仓码、名称、国家、所属公司、是否合计视图、能否发货、币种
- `ever call stock_list` — 查某仓库存（含批发价 / 零售价 / 可用量）
- `ever call stock_changes` — 所选仓库存变更（增量）：传 since=上次拿到的 version，只返回之后变了的行；has_more=true 就带新 version 再调；needs_full_sync=true 表示 since 太旧要重做一次全量
- `ever call product_list` — 某仓的产品列表（按款号去重，含价格；search 按款号 / 品名搜）
- `ever call product_get` — 按款号查产品详情：图片 / 描述 / 材质 / 价格，以及这一款的全部变体（skus）
- `ever call sku_get` — 按 SKU 查单个变体详情（单对象）
- `ever call dropship_product_list` — 查代发系统在售产品列表（分页）
- `ever call price_list` — 查本渠道的产品价格（分页）
- `ever call shipping_method_list` — 你这个账号可用的发货方式（自取 / 自送 / 快递…）
- `ever call carrier_list` — 你这个账号可选的物流公司
- `ever call address_list` — 你在 OMS 里存的收货地址簿
- `ever call order_create` (写操作) — 创建批发订单
- `ever call feed_products` — 取商品 feed（Google Merchant 规格，同时就是批量导出）：一次产出 csv / xml / json 三份，并缓存，供定时抓取下载
- `ever call feed_status` — 看商品 feed 拼到哪了：在拼 / 好了 / 失败（**带失败原因**），以及最新一份的行数、拼于什么时候、会被平台挑什么毛病
- `ever call order_list` — 按日期区间查本渠道批发订单
- `ever call order_get` — 按单号查批发订单详情（仅本渠道）
- `ever call order_cancel` (写操作) — 作废批发订单（连同它占住的配货一起释放）
- `ever call dropship_order_cancel` (写操作) — 作废代发明细（连同它占住的配货一起释放）
- `ever call order_allocation_preview` (写操作) — 批发订单配货预览：逐行告诉你能配多少、缺多少（quantity_owed）、预售批次几时到货，以及应付金额和余额够不够
- `ever call order_submit` (写操作) — 提交批发订单（提交后不能再改明细）
- `ever call dropship_order_allocation_preview` (写操作) — 代发预配：一次交一批流水号，逐条告诉你能不能配齐、缺货的缺多少、要付多少
- `ever call dropship_order_submit` (写操作) — 提交代发（提交后不能改）
- `ever call dropship_order_allocation_cancel` (写操作) — 释放这条代发明细占住的预配库存（预配之后决定不提交时用）
- `ever call dropship_order_create` (写操作) — 创建代发订单（一单一个 SKU）
- `ever call dropship_order_list` — 查本渠道代发订单：按仓 + 日期区间；或按 client_order_number / serial_number 直接找一张
- `ever call dropship_order_summary` — 代发订单汇总列表（分页）
- `ever call dropship_order_get` — 按单号查代发订单详情（仅本渠道）
- `ever call shipment_list` — 查本渠道发货单列表
- `ever call shipment_get` — 按单号查发货单详情（仅本渠道）
- `ever call shipment_tracking` — 物流轨迹（澳邮 Auexpress）
- `ever call reservation_list` — 查本渠道锁单 / 预留库存列表（默认含锁定中和已作废的；status=reserved 只看锁定中）
- `ever call reservation_get` — 按单号查锁单详情（仅本渠道）
- `ever call balance_list` — 你的账户余额（澳洲 / 中国 / 新西兰，开了哪个给哪个）
- `ever call transaction_list` — 交易流水（充值 / 扣款 / 退款），每笔带之后的账户余额；amount_total 是这批的合计
- `ever call bill_list` — 月度账单（按仓、按月，含是否已付）
- `ever call refund_list` — 退款单（批发 / 代发，含审核状态与退款原因）
- `ever call freight_bill_list` — 运费单（承运商、运单号、箱数、金额）
- `ever call cart_get` — 查某账号购物车
- `ever call cart_put_items` (写操作) — 添加 / 更新购物车条目（幂等）
- `ever call cart_delete_item` (写操作) — 按 SKU 移除购物车条目
- `ever call cart_delete_product` (写操作) — 按款号移除购物车里这一款的全部 SKU

任何端点都能 `ever api <METHOD> <path> --query k=v --body <json>` 原样调；`ever whoami` 看身份与权限；`ever login --sandbox` 切回沙箱。

## 手动下载

- https://connect.everugg.net.au/cli/dl/ever-linux-x64
- https://connect.everugg.net.au/cli/dl/ever-darwin-arm64
- https://connect.everugg.net.au/cli/dl/ever-linux-arm64
- https://connect.everugg.net.au/cli/dl/ever-windows-x64.exe
- https://connect.everugg.net.au/cli/dl/ever-darwin-x64

---
Markdown 源: https://connect.everugg.net.au/cli.md?lang=zh · 网页版: https://connect.everugg.net.au/cli?lang=zh