SuperAPI AI 工具集

discord

智能体与模型

查看项目

更新于 10-16 03:11

技能介绍

用途:在实现或自动化 Discord 集成时使用,覆盖单向通知、双向机器人和用户触发的斜杠命令三类场景。

主要能力与选型:

  1. 传入 Webhook,适合 CI 通知、告警、构建状态等单向发布,无需机器人用户,参考 https://discord.com/developers/docs/resources/webhook#execute-webhook。
  2. 机器人令牌 + REST API,适合以机器人身份发帖、管理频道、读取历史、审核等,API 基址 https://discord.com/api/v10,多数调用使用 Authorization: Bot <token>。
  3. 交互/斜杠命令,使用应用命令与交互 Webhook,通常需运行 Web 服务器接收交互并快速响应。

用法要点:令牌不得硬编码,使用环境变量 DISCORD_WEBHOOK_URL 与 DISCORD_BOT_TOKEN;Webhook URL 含令牌,应视为机密。示例:curl -sS -X POST -H 'Content-Type: application/json' -d '{"content":"Hello from OpenHands","allowed_mentions":{"parse":[]}}' "$DISCORD_WEBHOOK_URL"。机器人发消息端点 POST /channels/{channel_id}/messages。随附脚本仅用 Python 标准库:python3 -m skills.discord.scripts.post_webhook --content "Build finished" --wait;python3 -m skills.discord.scripts.send_message --channel-id "$CHANNEL_ID" --content "Hello"。

限制与安全:默认提及有风险,应设置严格的 allowed_mentions(如 {"parse": []});避免在日志、异常、CI 输出中泄露 Webhook URL;遇 HTTP 429 按 retry_after/Retry-After 等待并有限重试,勿硬编码限速;不要自动化普通用户账号(self-bots),应使用官方机器人/OAuth 流程。斜杠命令可用公会命令快速迭代,全局命令传播较慢。更多 OAuth2、命令注册与排错见 references/REFERENCE.md。