YonSuite CLI

要解决的问题

当业务数据散落在 YonSuite 的各个模块里，想快速拉一份销售订单汇总或库存现存量，通常只能打开 Web 界面手工筛选、导出，再拼进自己的分析流程。对工程师来说，这类重复操作既慢又难自动化。

核心能力与工作方式

yscli 通过环境变量读取 YonSuite 认证信息，包括 YONSUITE_APP_KEY、YONSUITE_APP_SECRET 与 YONSUITE_TENANT_ID，之后所有查询都直接走 YonSuite API。

指令体系分三层：

• 快捷命令：针对高频场景一键直达，适合日常快速取数。
• API 命令：元数据驱动，覆盖 YonSuite 全部标准接口。
• Raw API：万能兜底，直接调用 YonSuite OpenAPI，应对前两层未覆盖的需求。

拿到数据后可切换输出格式：表格适合人工核对，JSON 便于管道处理，CSV 方便导入其他工具，pretty 适合终端内直接阅读。除查询之外，它还支持数据分析并生成 HTML 报告，方便把结论直接分享给非技术同事。

适用边界与注意点

它只解决 YonSuite 平台上的数据问题，典型对象包括销售订单、采购订单、生产工单、库存现存量、商机列表，以及客户、供应商、物料、组织等基础档案。

以下场景不适用：

• 非 YonSuite 平台的数据查询。
• 纯财务凭证、账簿、总账等深度财务数据。
• YonSuite 的系统配置与权限管理。