# CNC 执行引擎使用“cnc” CLI 对构造性 API 执行原始 GraphQL 查询。与 kubectl 上下文类似，管理多个 API 上下文（端点 + 凭证）。 ## 何时申请在以下情况下使用此技能： * 针对构造性 API 执行 GraphQL 查询 * 设置API端点配置 * 管理 API 令牌以进行身份验证 * 在多个API环境（dev、staging、prod）之间切换 * 从命令行测试 GraphQL 查询 ## 快速入门 # 创建一个带有端点的上下文 cnc 上下文创建 my-api --endpoint https://api.example.com/graphql # 设置您的 API 令牌（输入被屏蔽） cnc 身份验证设置令牌 # 执行查询 cnc 执行 --query '查询 { __typename }' ## 上下文管理上下文存储端点 URL，类似于 kubectl 上下文。它们存储在“~/.cnc/config/contexts/”中。 ### 创建上下文 # 交互模式 CNC 上下文创建 # 带标志 cnc 上下文创建 my-api --endpoint https://api.example.com/graphql ### 列出上下文 CNC 上下文列表输出显示所有具有身份验证状态的上下文：上下文： * my-api [已验证] 端点：https://api.example.com/graphql 分期[无令牌] 端点：https://staging.example.com/graphql ### 切换上下文 cnc 上下文使用暂存 ### 显示当前上下文当前 CNC 上下文 ### 删除上下文 cnc 上下文删除旧 api ## 身份验证令牌安全地存储在“~/.cnc/config/credentials.json”中，并具有受限的文件权限（0o600）。 ### 设置令牌 # 交互式（用星号屏蔽的输入） cnc 身份验证设置令牌 # 以 token 作为参数 CNC 身份验证设置令牌 eyJhbGciOiJIUzI1NiIs... # 对于特定的上下文 cnc auth set-token --context staging # 已过期 cnc auth set-token --过期 2024-12-31T23:59:59Z ### 检查身份验证状态 CNC 验证状态输出：认证状态： * 我的API 状态：已验证代币：eyJhbG...s5Nw 到期时间: 2024-12-31T23:59:59Z 分期状态：未验证 ### 注销 CNC 验证注销 cnc auth 注销 --context staging ## 执行查询 ### 内联查询 cnc 执行 --query '查询 { 数据库 { 节点 { id 名称 } } }' ### 来自文件 cnc 执行 --file query.graphql ### 带变量 cnc 执行 --query '查询($id: UUID!) { 数据库(id: $id) { 名称 } }' \ --variables '{"id":"550e8400-e29b-41d4-a716-446655440000"}' ### 使用特定上下文 cnc 执行 --query 'query { __typename }' --context staging ## 输出格式成功查询返回 JSON：上下文：my-api 端点：https://api.example.com/graphql 成功了！ { “数据库”：{ “节点”：[ { "id": "...", "name": "我的数据库" } ] } } 失败的查询显示错误：失败了！ - 未找到“不存在”字段路径：query.nonexistent ## 常见工作流程 ### 设置新环境 # 创建生产环境 cnc 上下文创建 prod --endpoint https://api.constructive.io/graphql # 设置API令牌 cnc 身份验证设置令牌 # 验证连接 cnc 执行 --query '查询 { __typename }' ### 使用多个环境 # 为每个环境创建上下文 cnc 上下文创建 dev --endpoint https://dev-api.example.com/graphql cnc 上下文创建 staging --endpoint https://staging-api.example.com/graphql cnc 上下文创建 prod --endpoint https://api.example.com/graphql # 为每个设置标记 cnc auth set-token --context dev cnc auth set-token --context staging cnc auth set-token --context prod # 环境切换 cnc 上下文使用开发 cnc 执行 --query '查询 { 数据库 { 节点 { id } } }' cnc 上下文使用 prod cnc 执行 --query '查询 { 数据库 { 节点 { id } } }' ### 使用 CNC 编写脚本 #!/bin/bash # 示例：查询所有数据库并保存到文件 cnc 上下文使用 prod cnc 执行 --query '查询 { 数据库 { 节点 { id 名称创建位置 } } }' > 数据库.json ## CLI 参考 ### 数控上下文命令 |描述 ---|--- `cnc 上下文创建 <名称>` |创建新的上下文 `cnc 上下文列表` |列出所有上下文 `cnc 上下文使用 <名称>` |切换到上下文 `当前 CNC 上下文` |显示当前上下文详细信息 `cnc 上下文删除 <名称>` |删除上下文 **创建选项：** * `--endpoint ` \- GraphQL 端点 URL ### CNC 验证命令 |描述 ---|--- `cnc auth 设置令牌 [令牌]` |设置 API 令牌（如果未提供令牌则屏蔽输入） `cnc 身份验证状态` |显示所有上下文的身份验证状态 `cnc 身份验证注销` |删除当前上下文的凭据 **选项：** * `--context ` \- 定位特定上下文 * `--expires ` \- 令牌到期日期（ISO 格式） ### 数控执行选项 |描述 ---|--- `--query ` | GraphQL 查询/变异字符串 `--文件 <路径>` |包含 GraphQL 查询的文件的路径 `--变量 ` | JSON 字符串形式的变量 `--context <名称>` |要使用的上下文（默认为当前） ## 文件位置路径|目的 ---|--- `~/.cnc/config/contexts/` |上下文配置文件 `~/.cnc/config/settings.json` |全局设置（当前上下文） `~/.cnc/config/credentials.json` | API 令牌（模式 0o600） ## 故障排除问题 |解决方案 ---|--- “没有活动上下文” |运行“cnc context create”或“cnc context use” “没有有效的凭据” |运行“cnc auth set-token” “未找到上下文” |检查“cnc 上下文列表”以获取可用上下文令牌已过期 |运行 `cnc auth set-token` 以设置新令牌连接被拒绝 |使用“cnc context current”验证端点 URL ## 环境变量 CLI 尊重标准环境变量，但存储的上下文/凭证优先：变量|描述 ---|--- `CNC_ENDPOINT` |覆盖端点 URL `CNC_TOKEN` |覆盖 API 令牌 ## 参考文献 * CLI 源：constructive-io/constructive 中的 `packages/cli/` * 配置管理使用 `appstash` 进行目录解析 * 相关技能：用于生成类型化钩子/ORM的`constructive-graphql-codegen`

数控执行引擎

包含技能