用途：在 Lightning 控制台应用中启用 Omni-Channel 侧边栏，即固定停靠在应用侧边的 Omni 实用工具区域。做法是把该应用 CustomApplication 元数据中的 isOmniPinnedViewEnabled 设为 true，并验证该标志正确回写。它通常由 service-omni-channel-setup-coordinate 在代表体验配置的最后一步调用。
主要能力：每个控制台应用执行一次；幂等且非破坏性，只翻转这一个布尔值，不改写选项卡、品牌或导航配置。字段缺失时按 XSD 顺序插入（紧邻 label 之前），已存在则就地替换。自动检测较保守：仅当组织内恰好只有一个 Lightning 控制台应用时才自动采用，存在零个或多个时返回 blocked。
使用方式：命令为 bash scripts/enable-and-report.sh <org-alias> [app_developer_name]。org-alias 必填；app_developer_name 可选，为控制台应用的 CustomApplication DeveloperName，省略时查询 AppDefinition。已为 true 则复用且不部署；为 false 或缺失则设为 true，通过一次原子 Metadata API 调用部署该单个 CustomApplication，使用显式 --metadata "CustomApplication:<name>"，随后重新检索确认再报告成功。
输出：单个 JSON 对象，含 status（enabled | reused | blocked）、app_developer_name、app_label、before、after、deploy_id、manual_actions、blocking_issue。blocked 时由 blocking_issue 说明原因、manual_actions 给出修复或前置技能。
前置条件：目标组织已通过 sf CLI 认证、具备 Service Cloud 许可、sf CLI 版本 ≥ 2.139.6；已启用 Omni-Channel 基础设置；目标须是可作为 CustomApplication 元数据部署的 Lightning 控制台应用，标准应用与 Aura 应用不适用；适用三方 safe_to_write 生产保护。
限制：每次调用仅处理一个应用，多个应用需分别运行；不创建或布局控制台应用、选项卡或 Omni 实用工具项；不适用于 Aura、标准应用或实用工具栏 Omni 组件。