SuperAPI AI 工具集

discord-notify

办公与效率

查看项目

更新于 10-15 09:44

技能介绍

用途

discord-notify 用于通过 Discord 向用户手机发送实时通知。当用户表达“完成后通知我”“有结果了发消息给我”“帮我监控这个,有问题告诉我”“跑完了告诉我一声”“达成 xxx 条件后通知我”“发个提醒/通知到我手机”等意图时,可使用此技能。

典型场景包括:

  • 任务完成通知(脚本跑完、构建完成等)
  • 状态监控(网站恢复、服务异常等)
  • 定时提醒(到点提醒我 xxx)
  • 结果汇报(数据处理完了告诉你)

主要能力

  • 通过 Discord 向指定用户发送通知消息。
  • 支持超长消息:超过 2000 字符会自动分割发送。
  • 提供环境检测脚本,检查环境变量是否配置、依赖是否安装、Bot Token 是否有效、User ID 是否有效。
  • 返回结构化的执行结果,包含成功/失败状态、消息发送情况、分割条数等信息。

使用方式

环境检测

首次使用时,运行检测脚本检查环境配置:

cd discord-notify && node check.js

根据检测结果完成配置。

发送通知

node discord-notify/send.js "通知内容"

环境变量

变量 必填 说明
DISCORD_BOT_TOKEN 是 机器人 Token
DISCORD_USER_ID 是 目标用户 ID
HTTPS_PROXY / HTTP_PROXY / ALL_PROXY 否 代理地址(可选)

配置步骤

  1. 创建 Discord Bot:访问 https://discord.com/developers/applications ,创建 Application → Bot → 复制 Token。
  2. 邀请 Bot 到服务器:使用 Bot 的 OAuth2 URL 邀请到你的 Discord 服务器。
  3. 获取 User ID:Discord 设置 → 高级 → 开启开发者模式,右键点击你的头像 → 复制 ID。
  4. 配置环境变量:
export DISCORD_BOT_TOKEN="你的Token"
export DISCORD_USER_ID="你的ID"
export HTTPS_PROXY="http://127.0.0.1:1080"  # 可选

返回值

成功时返回:

{
  "success": true,
  "message": "消息发送成功",
  "chunks": 1,
  "sent": 1
}

超长消息会显示分割信息:

{
  "success": true,
  "message": "消息发送成功",
  "chunks": 2,
  "sent": 2,
  "note": "消息已分割为 2 条发送"
}

失败时返回:

{
  "success": false,
  "error": "无法创建私聊频道: 请求参数错误: Invalid Recipient(s)"
}

AI 使用示例

当用户说“帮我跑这个脚本,跑完了告诉我”时,AI 应:

  1. 开始执行脚本。
  2. 等待完成。
  3. 调用 node discord-notify/send.js "✅ 脚本执行完成!"。
  4. 告诉用户“已通知”。

目录结构

discord-notify/
├── SKILL.md          # Skill 说明文档
├── check.js          # 环境检测脚本
├── send.js           # 发送通知脚本
└── package.json      # 依赖配置

适用场景

适用于需要将任务执行结果、状态变化或定时提醒推送到用户 Discord 的场景,尤其适合脚本运行、构建完成、服务监控等自动化流程中的通知需求。

限制

  • 需要用户自行创建 Discord Bot 并获取 Token 与 User ID。
  • 需要配置 DISCORD_BOT_TOKEN 和 DISCORD_USER_ID 两个必填环境变量。
  • 消息超过 2000 字符会自动分割发送。
  • 若网络环境受限,可能需要配置代理地址。
  • 其他功能、收费、价格、平台支持范围等信息暂未提供。