用途:在 Salesforce LDS 场景生成经 schema 校验的 GraphQL 查询或变更,支持独立输出或接入 Lightning Web Component。适用于提及 GraphQL、lightning/uiGraphQLApi、@wire(graphql, ...) 或 gql 模板标签的 LWC 需求,也用于写查询前对 org schema 做自省并端到端验证。不适用于基于 REST 的 UI API、Apex 回调或自定义 GraphQL 端点,也不负责数据需求发现。
主要能力:内置 scripts/fetch-lds-graphql-schema.sh 做 schema 自省(写入 schema.graphql,不进入对话上下文),scripts/test-lds-graphql-query.sh 在真实 org 上验证查询。坚持 schema 为唯一事实来源,禁止凭常识假设字段类型,分步执行、失败硬停、逐步汇报。
使用方式:需已连接的 Salesforce org(用户名或别名,必须确认)、可用的 Salesforce CLI/sf,并先决定命名空间(uiapi 或 setup)、查询类型(read 或 mutation)与输出格式(standalone 或 LWC 集成)。工作流从收集信息、获取 schema、识别实体、迭代自省(最多 3 轮)到生成读取或变更查询,最后运行测试脚本验证。可用命令:scripts/fetch-lds-graphql-schema.sh USERNAME_OR_ALIAS [OUTPUT_PATH] [API_VERSION],scripts/test-lds-graphql-query.sh USERNAME_OR_ALIAS 'QUERY' '<VARIABLES_JSON>'。
限制:schema 文件达 26.5 万行以上,禁止整读,只能用定向 grep,每实体最多 4–5 次。自省迭代上限 3 轮,超限硬停。须确认 org 后才可获取 schema,不得假设默认值。错误需分类汇报,不得直接回显原始输出。其他未在资料中说明的功能、费用或平台暂未提供。