技能介绍

解决什么问题

团队用 Discord 协作时，常需要把脚本运行结果、CI/CD 流水线状态、系统告警自动推送到频道。但要实现这个，传统方式得先搭建 Discord bot：申请应用、管理 OAuth token、维护权限配置，还得处理依赖和重连逻辑，对于简单通知来说太重了。这个技能就是为了省去 bot 的繁琐搭建，用最轻量的方式把消息送进频道。

如何工作

它的核心是直接调用 Discord Webhook——一种无需认证的 HTTP 端点，你只需要从 Discord 服务器的「集成- Webhooks」里创建一条，复制 URL 就能开始用。流程很直接：先设置 DISCORD_WEBHOOK_URL 环境变量，然后把消息内容写成 JSON payload（比如简单文本、自定义用户名头像、带颜色的富嵌入），再通过 curl 发送到 webhook URL，消息就会出现在目标频道。

支持的场景覆盖日常需求：比如给 CI 流水线加个失败提醒、分享带结构化信息的项目更新、上传日志文件，甚至能发静默消息不打扰人。比如要发带红色嵌入的错误提醒，只要在 JSON 里配好 "embeds" 字段的 "color" 值（红色的十进制是 15548997），剩下的交给 curl 就行。

适用边界与注意点

不是所有场景都适合用它：如果需要 @全体成员这类高权限操作，或者要接收用户消息，还是得用 bot。用的时候要注意几个限制：单个 webhook 每 60 秒最多 30 次请求，消息正文不超过 2000 字符，嵌入最多 10 个且总字符不超 6000，文件附件默认最大 8MB（有 Nitro 能到 50MB）。另外，webhook URL 相当于密码——拿到的人都能往频道发消息，绝对不能公开暴露，比如别写进代码仓库的环境变量或公开文档里。