用途:检查 Salesforce org 何时到期、还剩多少天,或是否已过期,可针对单个 org、默认 org 或全部已认证 org,输出按紧急程度排序(已过期与最快到期在前)并附一行摘要。适用于试用版、Developer Edition(含 TrialExpirationDate 的 org)以及 scratch org。不适用于沙箱刷新、创建删除切换 org,也不适用于非 Salesforce 试用。
用法:需在 PATH 中安装 Salesforce CLI(sf)与 jq,并至少有一个已认证 org(sf org login web)。脚本须用技能目录的绝对路径调用,不要用相对路径 ./scripts/。示例:bash "<skill_dir>/scripts/check_expiration.sh" <alias-or-username>(单个 org);不加参数查默认 org;--all 查全部;--all --within 30 只查 30 天内到期。
主要能力与选项:--all 查全部;--within <days> 仅显示 N 天内到期(含已过期,排除付费/生产 org);--json / --csv 输出机器可读记录;--preserve 打印备份命令;--renew 打印试用/DE 延期与恢复指引;--fail-if-expiring[=N] 若有 org 在 N 天内到期则退出码 3;--no-scratch 排除 scratch org。标志可组合。
判定方式:试用/DE org 读取 SOQL 的 Organization.TrialExpirationDate(付费/生产为 null,属正常);scratch org 用 sf org list 的 expirationDate。
限制与说明:org 未认证时脚本会打印 sf org login web 登录命令再重跑;退出码 0 成功、1 查询失败、2 用法错误或缺依赖、3 触发到期告警阈值(优先于 1)。脚本顺序查询以避免 CLI 并发缓慢。--preserve 仅打印命令,需自行审阅执行。续期指引需以官方最新信息为准。