若WorkBuddy短信发送失败，首要排查腾讯云SMS签名未通过审核或已过期、模板ID配置错误或未启用、SDK密钥无效或地域不匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy安装后配置短信网关，但无法成功发送短信，则很可能是由于腾讯云SMS签名或模板ID未通过审核、配置错误或未与当前环境匹配。以下是排查与校验的关键步骤：
一、确认短信签名已通过腾讯云审核并处于生效状态
腾讯云短信服务要求所有外发短信必须绑定已实名认证且审核通过的签名，未审核、审核驳回或已过期的签名将导致网关调用直接失败。
1、登录腾讯云短信控制台，进入「国内短信」→「签名管理」页面。
2、查找WorkBuddy所配置的签名名称，核对其「审核状态」是否为已通过，且「生效状态」显示为已生效。
3、若状态为「审核中」或「已驳回」，点击该签名右侧「编辑」，检查是否满足全部要求：企业需上传营业执照扫描件、网站备案截图；个人需提供身份证正反面及手持声明照；签名内容不得含“官方”“国家”“政府”等敏感词，且须与WorkBuddy实际运营主体一致。
4、若签名已过期（有效期为1年），需重新提交更新材料并等待人工复审，不可直接复用旧版。
二、验证短信模板ID与模板内容严格匹配且已启用
短信模板ID是腾讯云分配的唯一字符串标识，WorkBuddy配置中填写的ID必须与控制台中该模板的ID完全一致（区分大小写、无空格、无换行），且模板内容需与签名所属主体、用途场景完全吻合。
1、在短信控制台「模板管理」中，定位到WorkBuddy所用模板，确认其「审核状态」为已通过、「启用状态」为已启用。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、点击该模板右侧「详情」，复制页面顶部显示的模板ID（如：1234567），而非模板名称或编号；将其与WorkBuddy配置文件（如config.yaml）中sms.template_id字段值逐字符比对。
3、检查模板内容是否包含占位符{1}、{2}等，且数量、顺序与WorkBuddy代码中传入的参数数组严格一致；例如模板为“您的验证码是{1}，5分钟内有效”，则调用时必须传入且仅传入一个字符串参数。
4、确认模板申请时选择的「使用场景」与WorkBuddy实际用途一致：如用于登录验证，应选“验证码”类；用于通知提醒，应选“通知”类；混用将触发审核拦截。
三、检查WorkBuddy服务端SDK配置与权限密钥有效性
WorkBuddy依赖腾讯云SDK v3.x调用SMS API，若SecretId、SecretKey错误、过期，或未授予SMS权限，将返回AuthFailure或UnauthorizedOperation错误，导致网关静默中断。
1、在腾讯云访问管理CAM控制台，进入「用户」→「API密钥管理」，确认WorkBuddy所用子用户密钥状态为启用，且未被轮换或禁用。
2、进入该子用户「授权策略」页，确认已绑定含
3、在WorkBuddy配置中，核对region字段是否与短信服务开通地域一致（中国大陆地区必须为ap-guangzhou）；若误填为ap-beijing或ap-shanghai，将返回InvalidRegion错误。
4、检查SDK初始化代码中是否显式设置Endpoint为https://sms.tencentcloudapi.com，而非旧版sms.cloud.tencent.com或缺失协议头。
