新的介绍内容：

VS Code GraphQL Notebooks 扩展为开发者提供了一个在 VS Code 环境中运行和执行 GraphQL 查询和变更的强大工具。通过直观的笔记本界面，您可以轻松地创建、执行并查看 GraphQL 操作的结果。

主要功能：

• 创建笔记本：通过文件菜单或使用 GraphQL: Create New GraphQL Notebook 命令，快速创建新的 VS Code 笔记本。
• 选择控制器：从项目中的 graphql-config 文件中选择配置的端点作为笔记本控制器。
• 执行操作：对选定的控制器端点执行查询和变更，并在笔记本输出中查看执行结果。

使用方法：

要开始使用 VS Code GraphQL Notebooks，您需要安装 VS Code GraphQL Notebooks 扩展和 VS Code GraphQL 扩展。请注意，该扩展需要 graphql-config 文件来正常工作。目前支持 graphql-config@3，并通过 cosmicconfig 提供了多种加载配置文件的方式，包括：

• graphql.config.json
• graphql.config.js
• graphql.config.yaml
• graphql.config.yml
• .graphqlrc (YAML或JSON)
• .graphqlrc.json
• .graphqlrc.yaml
• .graphqlrc.yml
• .graphqlrc.js
• package.json 中的 graphql 属性

默认情况下，配置文件应放置在项目根目录，但您可以为每个项目配置不同的路径。有关详细信息，请查看下面的常见问题解答。

配置示例：

• 简单示例：

  # .graphqlrc.yml
  schema: "schema.graphql"
  documents: "src/**/*.{gqlnb}"

• 高级示例：

  // graphql.config.js
  module.exports = {
    projects: {
      app: {
        schema: ["src/schema.graphql", "directives.graphql"],
        documents: ["**/*.{graphql,js,ts,jsx,tsx,gqlnb}", "my/fragments.graphql"],
        extensions: {
          endpoints: {
            default: {
              url: "http://localhost:8000",
              headers: { Authorization: `Bearer ${process.env.API_TOKEN}` },
            },
          },
        },
      },
      db: {
        schema: "src/generated/db.graphql",
        documents: ["src/db/**/*.gqlnb", "my/fragments.graphql"],
        extensions: {
          codegen: [
            {
              generator: "graphql-binding",
              language: "typescript",
              output: {
                binding: "src/generated/db.ts",
              },
            },
          ],
          endpoints: {
            default: {
              url: "http://localhost:8080",
              headers: { Authorization: `Bearer ${process.env.API_TOKEN}` },
            },
          },
        },
      },
    },
  }

常见问题解答：

• 无法加载 .graphqlconfig 文件：启用 graphql-config 的旧模式，即可使用旧版配置文件。
• 扩展显示重复类型错误：确保不在 documents 中包含 schema 文件。
• 扩展显示缺少标量、指令等错误：确保 schema 指针指向完整的 schema。
• 执行查询/变更/订阅总是失败：添加 endpoints 配置到全局或项目配置文件中。
• GraphQL 配置文件不在根目录：可以配置搜索特定文件夹或文件路径来加载配置文件。

开发指南：

1. 克隆仓库 - https://github.com/joyceerhl/vscode-graphql-notebook
2. 运行 npm install
3. 在 VS Code 中打开项目
4. 在调试部分运行 "Extension" 启动程序
5. 这将打开另一个启用了扩展的 VS Code 实例
6. 创建或打开一个 GraphQL 笔记本
7. 在输出部分的 GraphQL Notebooks 下查看日志

许可证：

MIT