CodeBuddy支持基于 OpenAPI、TypeScript 或 REST 接口清单自动生成 GraphQL Schema。前提是先确认官方“语言支持”页面已明确列出 GraphQL Schema inference 能力，再上传符合规范的结构化输入源，触发生成流程并校验输出的 SDL 是否准确可用。

如果你想让CodeBuddy根据现有代码或接口定义自动生成GraphQL Schema，而不是手动编写typeDefs和resolvers，这种方式会更高效。它尤其适用于后端服务已经存在、你希望快速搭建GraphQL层并与前端完成对接的场景。

确认CodeBuddy支持GraphQL Schema生成能力

打开CodeBuddy正式版或本地客户端后，进入「模型能力」→「语言支持」页面，重点确认是否明确标注“GraphQL Schema inference”或“Auto-generate SDL from REST/OpenAPI/TypeScript”。【不支持OpenAPI或TypeScript解析的版本无法生成准确的GraphQL Schema】。如果页面中没有相关说明，通常可判断该功能暂未开放，继续执行后续步骤也不会生效。

准备可解析的输入源

CodeBuddy无法凭空推断Schema，必须依赖结构化、可解析的输入内容。通常有以下三种可用来源：

方法一：提供OpenAPI 3.0+ YAML/JSON文件
将项目根目录下的openapi.yaml或swagger.json拖入CodeBuddy上传区域。请确保paths中的每个操作都带有x-openapi-graphql: true注解（部分版本为强制要求），否则可能出现字段映射缺失或生成结果不完整的问题。

方法二：粘贴TypeScript接口定义
复制包含interface、type alias以及JSDoc注释说明的代码块，例如：

/** 用户基本信息 */
interface User {
  id: string;
  name?: string;
  email: string;
}

方法三：输入REST API清单（仅支持基础类型推导）
可按行填写GET/POST请求路径及对应的示例响应JSON片段，例如：
GET /api/users → {"data": [{"id": "1", "name": "Alice"}]}
通过这种方式生成的GraphQL Schema，通常不会包含字段描述，也不具备复杂嵌套关系识别能力，因此更适合用于临时验证或快速测试场景。

触发Schema生成并校验输出

第一步：在CodeBuddy主界面点击「New Project」→ 选择「GraphQL Schema Generator」模板。
第二步：粘贴或上传前面准备好的输入源，点击「Generate」按钮。
第三步：等待约3–8秒，右侧面板会显示自动生成的SDL（Schema Definition Language）代码。
第四步：重点检查以下三个位置：① Query类型中是否包含你预期的查询字段；② 所有ID字段是否被正确识别为ID!而不是String；③ nested对象是否已生成独立type，而不是被内联为Object。

如果你发现User.email被标记为String!，但业务上实际允许null，请返回输入源，在TS接口中改写为email?: string | null，然后重新生成GraphQL Schema。