CodeBuddy支持从OpenAPI、TypeScript或REST清单自动生成GraphQL Schema。需确认官网“语言支持”页明确列出GraphQL Schema inference能力，再上传符合要求的结构化输入源，触发生成并校验SDL输出是否准确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让CodeBuddy根据已有代码或接口描述自动生成GraphQL Schema，而不是手动编写typeDefs和resolvers。这通常发生在后端服务已存在、你想快速构建GraphQL层对接前端时。
确认CodeBuddy支持GraphQL Schema生成能力
打开CodeBuddy官网或本地客户端，进入「模型能力」→「语言支持」页面，查找是否明确列出“GraphQL Schema inference”或“Auto-generate SDL from REST/OpenAPI/TypeScript”。【不支持OpenAPI或TypeScript解析的版本无法生成准确Schema】。若页面无相关说明，该功能尚未开放，后续步骤将无效。
准备可解析的输入源
CodeBuddy不能凭空生成Schema，必须依赖结构化输入。你有三种可用来源：
方法一：提供OpenAPI 3.0+ YAML/JSON文件
把项目根目录下的openapi.yaml或swagger.json拖入CodeBuddy上传区。确保paths中每个操作都有x-openapi-graphql: true注解（部分版本强制要求），否则字段映射可能丢失。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：粘贴TypeScript接口定义
复制包含interface、type alias及JSDoc描述的代码块，例如：
/** 用户基本信息 */<br>interface User {<br> id: string;<br> name?: string;<br> email: string;<br>}注意：必须含至少一个interface或type声明，纯函数签名无效。
方法三：输入REST API清单（仅限基础类型推导）
按行列出GET/POST路径及示例响应JSON片段，如：GET /api/users → {"data": [{"id": "1", "name": "Alice"}]}
此方式生成的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，再重新生成。
