SuperAPI AI 工具集

external-consumers

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:这是 forcedotcom/salesforcedx-vscode 单体仓库中扩展 API 的外部消费者清单,供修改公开 API 表面(activate 返回类型、导出类型、服务等)时评估影响范围。

主要能力:列出直接消费 SalesforceVSCodeCoreApi(经 vscode.extensions.getExtension('salesforce.salesforcedx-vscode-core').exports)的仓库,如 vscode-agents、metadata-visualizer、code-analyzer、einstein-gpt;列出消费 SalesforceVSCodeServicesApi 的仓库;列出 @salesforce/vscode-service-provider 消费者;以及仅依赖 extensionDependency、无 API 消费的仓库和仓库内消费者。

使用方式:通过 gh CLI 按需验证。搜索指定仓库:gh api -X GET "search/code?q=SYMBOL+repo:forcedotcom/REPO&per_page=20" --jq '.items[] | "(.path)"';读取私有仓库文件:gh api repos/forcedotcom/REPO/contents/PATH --jq '.content' | base64 -d;也可搜索 org:forcedotcom 与 org:salesforcecli。

限制:导出扩展 API 即公开契约,删除或修改字段、方法、行为属破坏性变更,新增字段为非破坏性;消费者用 semver.satisfies 做版本门控,仅升主版本号不够。搜索 API 限速约 30 次/分钟,定向读取用 contents API。代码搜索只索引默认分支,非默认分支(如 einstein-gpt 从 afv-v3.0-iac 发布)可能零命中,零命中不等于无消费者,需确认发布分支后直接遍历该分支文件。仓库内消费者有两种访问模式:coreExtensionUtils.ts 包装函数与散落的 .exports.MEMBER() 直接调用,应全仓库 grep .exports.\w+。资料未提供官方文档链接与更多细节。