用途:在 aliyun CLI 之上封装阿里云短信服务,供 Agent 执行短信发送与查询。主要能力包括:发送短信(验证码、通知、营销,SendSms);批量发送(每个号码可用不同签名/模板参数,SendBatchSms);签名与模板的审批状态及列表查询;发送详情与回执查询;按日期范围查询发送/成功/失败统计(QuerySendStatistics);短信资质记录与单条详情查询。
使用方式:需先安装 aliyun CLI(>=3.3.3),执行 aliyun version 校验,不足时用 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 安装或更新;安装 dysmsapi 插件:aliyun plugin install --names dysmsapi;配置凭证(推荐默认凭证链,环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET、ALIBABA_CLOUD_REGION_ID,勿硬编码 AK/SK);在控制台开通短信服务并创建已审批的签名与模板。执行前需启用 AI-Mode(aliyun configure ai-mode enable 并设置 user-agent),每条命令须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-sms-send-short-message,退出时必须执行 aliyun configure ai-mode disable。发送示例:aliyun dysmsapi send-sms --api-version 2017-05-25 --phone-numbers "13800138000" --sign-name "AliyunDemo" --template-code "SMS_123456" --template-param '{"code":"123456"}' --read-timeout 3。也可使用 scripts/send_sms.sh 包装脚本。
限制:发送前必须由用户明确提供签名、模板与手机号,不得猜测或复用示例号码,需用户确认后才发送;签名/模板须为已审批状态(SignStatus/TemplateStatus=1);send-sms 单次最多 1000 个号码,send-batch-sms 最多 100 个;返回 Code=OK 仅表示网关受理,最终送达需调用 query-send-details 查询。常见错误包括签名/模板非法、号码格式错误、余额不足、触发限流等。具体收费与价格资料未提供。