火山引擎短信
始终通过 python3 -B <skill目录>/scripts/sms_cli.py 执行业务,不绕过脚本调用写
Action。默认客户不会使用终端:Agent 负责安装、登录、命令和清理,客户只操作浏览器
并确认业务写入。除非客户询问,不展示命令、JSON、CLI、Profile、HOME、AK/SK 或沙箱。
入口流程
- 首次调用或鉴权失败时读取 auth-setup.md,执行
auth-doctor并严格跟随唯一error.remediation;auth_ready后恢复原任务。 - 首次业务调用执行只读
list-message-groups。只有RE:0001才读取 service-onboarding.md;空列表和资源缺失不代表服务 未开通。 - 按任务读取下面最小参考集合,再执行 CLI。
按任务读取
- 所有任务先读公共 Action 配置与错误规则:actions.md。
- 资质、签名、模板申请读 application-contracts.md。
- 资质材料和本机表单再读
qualification-materials.md;展示方式由其中链接的
qualification-display.md决定。 - 单发、群发、回执和分析读 delivery-contracts.md。
- 需要完整编排顺序时读 workflows.md。
- 写操作授权、脱敏、重试和对账统一读 rules.md。
CLI 工作流
- 查询:
list-message-groups、message-group-detail、list-qualifications、list-signatures、list-templates。 - 资质:先尝试 MCP App 右侧面板;调用
open_qualification_application后紧接着调用ensure_qualification_application_visible。面板不可见时按 qualification-display.md 改用宿主内置浏览器, 宿主不支持时才使用系统浏览器。 - 申请:
*-preview→ 客户确认 →*-submit。 - 单发:
match-template→send-preview→ 客户授权 →send-submit→send-status。 - 群发:
batch-template-demo/batch-precheck→batch-create→batch-launch-preview→ 指定任务授权 →batch-launch-submit;管理使用batch-detail、batch-list、batch-cancel。 - 分析:
analytics;只有需要消息级证据时增加--include-logs。
不可变边界
- 鉴权只执行 remediation;同一时间一个登录会话。其他登录方式不索取登录入口链接,AK/SK
只在客户主动选择时提示一套
VOLCENGINE_*变量。 - 资质敏感材料只在本机向导填写。Agent 读取掩码后的
QUALIFICATION_EXCHANGE和QUALIFICATION_FAILURE排查,不要求客户复制字段或上传到对话。 - 申请、发送和任务启动都基于当前预览授权;字段变化后重新预览。
- 可能已发出的写请求不重试、不切换调用路径,返回
outcome_unknown并按契约对账。 - 创建或启动群发不代表送达;只有公开发送日志是消息级证据。
- 最终输出不包含完整个人信息、图片、文件地址、凭证、ticket、Authorization 或签名 URL 查询参数;保留公开 Request ID 和错误码,不推断内部原因。