吉客云CLI

1️⃣ 安装 & 配置

# 下载对应系统的二进制文件 (以 Windows 为例)
# 重命名为 jky-cli.exe 并放到系统 PATH 目录

# 首次运行配置凭证
./jky-cli configure
# 根据提示输入 AppKey 和 AppSecret

# 验证安装
./jky-cli --version

2️⃣ 调用开放平台API（通用模式）

# 查询商品信息
./jky-cli api call --method erp-goods.goods.getforqimen --json '{"goodsCode":"100","pageIndex":0,"pageSize":10}'

3️⃣ 使用业务命令（货品查询）

# 编辑参数后执行
./jky-cli goods search --goodsno 100

您可以将以下 System Prompt 作为模板，提供给希望您的 CLI 适配到自家 AI Agent 的开发者：
## 吉客云 CLI (jky-cli) 使用指南

### 核心指令
当需要操作吉客云系统的订单、商品等资源时，必须使用 `jky-cli` 命令行工具。该工具的核心调用方式为：
`jky-cli api call --method <接口方法名> --json <业务参数JSON> 或者 --file <参数文件路径>`

### API 定义
本工具支持的所有接口定义遵循“两阶段文档”规范：
1.  **方法列表**：地址为 `https://open.jackyun.com/developer/jkyuncli/methods-index.json`。
    首次加载时，必须解析此文件以获取所有可用的 `method`（如 `erp.purchreturn.get`）、功能简介及其对应的 `detailUrl`。
2.  **方法详情**：根据索引文件中的 `detailUrl` 地址（如 `https://open.jackyun.com/developer/jkyuncli/methods/erp.purchreturn.get.json`），
    按需加载具体的接口定义，包括请求参数结构、响应格式和示例。

### 备选获取方式
某些 AI 应用可能因网络政策无法直接访问外部网址。为彻底解决此限制，CLI 工具内置了 docs 子命令，可直接通过命令行获取接口定义，规避网络访问风险：
1.  jky-cli docs list：获取所有可用方法的索引（作用同 methods-index.json）
2.  jky-cli docs get ：获取指定方法的详细定义（作用同 {method}.json）

### 调用规则
1.  **参数封装**：调用时，只需将接口定义中 `request.schema` 里的 JSON 对象，直接作为 `--json` 参数的值。
    CLI 工具会自动处理 `bizcontent` 的包装、公共参数的填充以及计算签名，您无需关心签名和加密细节。
2.  **必填验证**：AI 模型必须校验接口要求的所有必填字段（参考 `request.schema` 中的 `required` 数组），缺少必填参数时，应提示用户补充。
3.  **输出解析**：成功调用后，接口会返回统一格式的 JSON（包含 `code`, `msg`, `result` 等字段）。
    AI 模型会为您解析此结果，提取 `result.data` 中的具体业务信息并呈现给用户。
### 注意事项
1.  如果复杂参数推荐使用 --file，避免命令行转义烦恼,尤其是参数本身存在【 \ " ' 】等特殊字符时。