用途:fluent-wp-client CLI 连接在线 WordPress 站点,发现其 REST API schema,并生成所需的代码产物(Zod 校验器、JSON Schema 或 TypeScript 声明),供下游应用、校验器和 AI 工具使用。
主要能力:schemas 命令会为发现的每个 WordPress 资源(文章类型、分类法)生成规范化 schema。输出路径决定写入哪些产物;未提供输出路径时默认写入 wp-schemas.ts。Zod 输出为每个资源生成 JSON Schema 字面量、基于该 JSON Schema 的 Zod schema,以及推断出的 TypeScript 类型。
使用方式:基本命令为 npx fluent-wp-client schemas --url https://example.com;可用 --json-out 仅输出 JSON Schema,或用 --zod-out、--json-out、--types-out 同时输出多种产物。认证方面,访问写入 schema(创建/更新)需要认证发现,每次调用只能传一种认证标志:--username 加 --password(应用密码/Basic 认证)、--token(JWT bearer)或 --auth-header(预构建头)。可用 --include 或 --exclude 以逗号分隔的 slug 或 REST base 过滤资源。省略 --url 会进入交互模式,提示输入站点 URL 和认证方式。CI/构建集成时固定 URL、认证和输出路径即可非交互运行,失败时返回非零退出码。生成后可将 schema 导入并传给 fluent-wp-client 运行时客户端校验读写响应。
适用场景:构建期/CI 中生成静态类型、Zod 校验器和 AI 工具所需 schema;需要动态站点或插件发现时则使用运行时 .describe()/.explore()。
限制:写入 schema 需认证;同一次调用不可混用多种认证模式;--json-out 须以 .json 结尾,--types-out 须以 .d.ts 结尾;--out 与 --zod-out 接受 .ts 或 .mjs。其余细节暂未提供。