用途：通过一次 Metadata API 部署，在 Salesforce 组织中建立无头（headless）的经典 Omni-Channel Supervisor 配置（OmniSupervisorConfig）。该类型为完整 Metadata API 类型，其 XSD 将各伴随项作为可重复子元素内嵌，因此父配置与伴随项从单个 .omniSupervisorConfig-meta.xml 文件原子化落地，部分失败时 Salesforce 会一并回滚伴随项。默认按用户显式绑定主管并列出其监控的队列，profile 范围可选。
主要能力：脚本一次完成检测、部署与验证。用法：bash scripts/deploy-and-report.sh <org-alias> [supervisor_count] [additional_queues_csv] [profiles_csv] [skill_visibility] [config_developer_name]。org-alias 必填，需能通过 sf org display --target-org <alias> 解析；supervisor_count 默认 1，范围 1..5；additional_queues_csv 为队列 DeveloperName 列表，提供时以其为准，省略则用 CaseQueue、messagingqueue 默认值，且每个队列必须已存在；profiles_csv 可选，启用基于 profile 的回退范围，需提供元数据 profile fullName；skill_visibility 可选 AllSkills 或 AnySkill；config_developer_name 默认 Omni_Supervisor。
前置条件与安全：目标组织需经 sf CLI 认证、具备 Service Cloud 许可、sf CLI ≥ 2.139.6；存在活跃主管用户（其主管权限由 service-omni-supervisor-permset-assign 单独授予）；已启用 Omni-Channel 基础设置且被监控队列已存在。生产护栏：脚本计算 safe_to_write，仅当 IsSandbox 或 TrialExpirationDate 非空或 OrganizationType 属于 Developer Edition、Base Edition 时为真，否则直接阻断且无覆盖选项。任何未满足前置条件返回 status: blocked 并附 blocking_issue 与点击路径。
行为与限制：部署配置始终携带 omniSupervisorConfigUser（每主管一条）与 omniSupervisorConfigQueue（每队列一条）。profile 范围默认关闭，仅在传入 profiles_csv 时使用，且值须为元数据 fullName。状态遵循 Metadata 部署组件状态：Unchanged→reused、Changed→updated、Created→created，其他状态视为硬失败。更新现有父配置前会快照无引用的 Action 与 Tab 行并在部署后恢复重查；含自定义或带引用的表面会在部署前阻断。验证要求部署状态为 Succeeded（非 SucceededPartial），并重查子行数量。输出为单个 JSON 对象，含 status、config_developer_name、config_id、绑定计数、deploy_id、state、manual_actions、blocking_issue 等。限制：不创建主管用户，仅按 supervisor{N}.<suffix>@example.com 模式发现绑定；不改变 AgentWork 共享；不激活 Command Center V2 运行时；自定义 Action、FlexiPage、AWS 仪表盘与 AI 智能体行因需外部引用会阻断更新。