用途
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 | 否 | 代理地址(可选) |
配置步骤
- 创建 Discord Bot:访问 https://discord.com/developers/applications ,创建 Application → Bot → 复制 Token。
- 邀请 Bot 到服务器:使用 Bot 的 OAuth2 URL 邀请到你的 Discord 服务器。
- 获取 User ID:Discord 设置 → 高级 → 开启开发者模式,右键点击你的头像 → 复制 ID。
- 配置环境变量:
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 应:
- 开始执行脚本。
- 等待完成。
- 调用
node discord-notify/send.js "✅ 脚本执行完成!"。 - 告诉用户“已通知”。
目录结构
discord-notify/
├── SKILL.md # Skill 说明文档
├── check.js # 环境检测脚本
├── send.js # 发送通知脚本
└── package.json # 依赖配置
适用场景
适用于需要将任务执行结果、状态变化或定时提醒推送到用户 Discord 的场景,尤其适合脚本运行、构建完成、服务监控等自动化流程中的通知需求。
限制
- 需要用户自行创建 Discord Bot 并获取 Token 与 User ID。
- 需要配置 DISCORD_BOT_TOKEN 和 DISCORD_USER_ID 两个必填环境变量。
- 消息超过 2000 字符会自动分割发送。
- 若网络环境受限,可能需要配置代理地址。
- 其他功能、收费、价格、平台支持范围等信息暂未提供。