用途:处理 Salesforce 元数据部署编排,包括 sf project deploy start/quick/report 与检索流程、跨对象与权限集、Apex、Flow 的发布顺序、CI/CD 门禁与测试级别选择、部署失败与依赖排序排查。
主要能力:先做 dry-run 校验再真实部署;支持 source-dir、metadata 列表或 manifest 范围;提供默认部署顺序(自定义对象/字段→权限集→Apex→Flow 草稿→Flow 激活与验证),以减少依赖与字段级安全(FLS)失败;支持 quick deploy、部署报告与失败模式定位(如 INVALID_CROSS_REFERENCE_KEY、FIELD_CUSTOM_VALIDATION_EXCEPTION、Flow 版本冲突等);提供 CI/CD 流水线形态建议,静态分析使用 Code Analyzer v5(sf code-analyzer)。
使用方式:仅使用 sf CLI v2。非源跟踪组织上部署/检索需显式范围(--source-dir、--metadata 或 --manifest)。建议先校验:sf project deploy start --dry-run --source-dir force-app --target-org <alias> --wait 30 --json;再按最小正确范围部署,如 sf project deploy start --manifest manifest/package.xml --target-org <alias> --test-level RunLocalTests --wait 30 --json,或校验成功后 sf project deploy quick --job-id <validation-job-id> --target-org <alias> --json;随后用 sf project deploy report --job-id <job-id> --target-org <alias> --json 验证。前置检查包括 sf --version、sf org list、sf org display --target-org <alias> --json、test -f sfdx-project.json。
适用场景:元数据部署与校验、发布顺序编排、CI/CD 部署门禁、scratch org/沙盒管理、部署失败排查。
限制与边界:Apex/LWC 编写交由 sf-apex、sf-lwc;元数据定义交由 sf-metadata;Flow 构建交由 sf-flow;组织数据操作交由 sf-data;Agent Script 逻辑交由 sf-ai-agentscript。Flow 应先以草稿部署,验证后再激活。测试数据创建在元数据校验或部署后交由 sf-data。具体收费、价格与平台支持信息暂未提供。