CLI 生成器 | Fern Documentation

抢先体验

CLI 生成器处于抢先体验阶段。联系我们开始使用。

Fern 的 CLI 生成器从您已用于 SDK 的同一 API 规范生成功能完备的命令行工具。它与 Docs 和 SDK 一起发布，是一个无运行时依赖的单一二进制文件，同时服务于需要确定性输出和运行时可检查 schema 的 AI 代理，以及编写脚本、调试和探索的人类开发者。

手动构建 CLI 是一个多季度的项目 — 命令、身份验证、分页、重试、输出格式化、跨平台构建、shell 补全，以及随 API 演进保持同步。生成器自动处理这一切。

工作原理

支持的 API 定义

从 OpenAPI 规范或 GraphQL 内省 schema 生成 CLI。

CLI 生成器接入与 Docs 和 SDK 相同的 Fern 工作流。当规范发生变更时，Fern 会向 CLI 仓库发起包含生成源码的 PR。发布时，Fern 自动将 CLI 发布到 npm、Homebrew 和 GitHub Releases，用户可通过首选的包管理器安装。CLI 与 Docs 和 SDK 保持同步，无需手动编写 CLI 代码。

输出是一个静态链接的 Rust 二进制文件。用户将其放入 PATH 即可运行，无需语言运行时和依赖。

为代理和人类而构建

运行时内省

Schema 和帮助信息以结构化 JSON 形式提供。

输入验证

双重编码的 URL 和其他格式错误的输入在发送请求前被捕获。

交互式输出

彩色帮助信息、表格输出和 shell 补全。

Dry-run 模式

预览请求而不发送。

版本固定

每个发布版本映射到特定的 API 版本。