把产品的一只手伸进 Discord:vibe 项目的 Discord 机器人实战
Discord 机器人是把产品的一只手伸进用户每天都在的地方:进群打招呼、常见问题先答一句、到点提醒、自习打卡自动统计。这篇讲申请账号、权限与 intents、斜杠命令、托管常驻、限流防滥用与出错兜底,示例产品与数字均为虚构。

很多 vibe 项目的用户本来就住在 Discord 里:学习小组在频道里约自习,游戏社群在语音里组队,开源项目的用户在服务器里问问题。给这样的项目做一个 Discord 机器人,等于把产品的一只手伸进了用户每天都在的地方:新用户进群自动打招呼、有人问常见问题机器人先答一句、到了自习时间机器人提醒大家、每周的打卡统计自动发出来。不用用户再打开另一个应用,事就在聊天的地方办了。
下面用的例子全部是虚构的:产品叫“橘子自习室”,是一个给学生用的线上自习室应用;机器人叫“橘子值日生”,住在橘子自习室的 Discord 服务器里;人物“小满”是它的独立开发者。所有调用次数、响应时间和省下的时间都是为了讲清楚方法而编的示例,不是真实产品的运营数据。先划清分工:产品里右下角的聊天气泡、人工客服怎么接单,是本站《在线客服实时聊天实战》讲的事;把产品里的事件推给外部系统、让别的服务来接,是本站《Webhook 集成实战》讲的事。本篇只讲 Discord 机器人本身:从申请账号到上线值班,每一步怎么做,不讲客服工单流程,也不讲通用 webhook 接入。

一、动手之前,先想清楚机器人要干的一件事
做机器人最常见的失败,不是做不出来,而是做出来没人用。动手之前,先写下一句话:这个机器人每天替用户干的一件具体事是什么。橘子值日生的那句话是:“每天晚上八点提醒大家开始自习,并把当天的自习打卡收齐。”一句话里有时间、有动作、有结果,接下来所有的功能都围着它转:提醒、打卡、统计。反过来,如果一句话写成“提升社群活跃度、增强用户粘性、打造学习氛围”,那就是什么都没想清楚,功能清单只会越列越长。
一句话定下来之后,再定三条边界。第一,机器人不做什么:橘子值日生不回答课程内容、不改作业、不处理退款,这些事留给人工和产品本身,机器人碰都不碰。第二,机器人在哪里出现:只在自习打卡频道和公告频道说话,不去闲聊频道插话,不给用户发私信——除非用户自己先找它。第三,机器人说错了怎么办:答案旁边永远留一句“不对的话请告诉管理员”,管理员每天看一次纠错记录。边界定好了,机器人才能越做越稳,而不是越做越像一个到处插嘴的陌生人。
最后问一句:这件事非得是机器人吗?如果提醒可以用频道的定时消息做,打卡可以用表情回应统计,那就先不要写代码。机器人值得做的,是那些需要“听懂一句话、查一下数据、再回一句话”的事:比如用户发一句“打卡”,机器人查他今天学了多久、回一句“今天已学两小时,继续加油”。只有这种闭环,才配得上一个机器人。
二、申请 bot 账号:先建应用,再领 token,token 只出现一次
Discord 机器人从 Discord 开发者门户开始。先建一个应用,给它起个名字、传一张头像——这就是机器人以后在服务器里露脸的样子。然后在应用里创建一个 bot 用户,拿到它的 token。token 是机器人登录 Discord 的唯一钥匙,只在创建那一刻完整显示一次,关掉页面就再也看不到了。正确的做法是:当场把它存进环境变量或者密钥管理工具里,绝不写进代码、绝不贴进聊天记录、绝不提交到代码仓库。token 一旦泄露,任何人都能冒充你的机器人进服务器发消息,唯一的补救是立刻在开发者门户里重新生成一个,旧的马上作废。
建好应用之后,要把机器人请进自己的服务器。开发者门户里会生成一条邀请链接,选好要给的权限,打开链接、选服务器、点确认,机器人就进群了。第一次邀请,先只给最少的权限:能看频道、能发消息,就够了。权限可以以后再加,但请进来的时候多给的权限,用户是看得见的——一个刚进群就要求管理消息、踢人、看所有频道的机器人,第一印象就很可疑。先让它安安静静地干好一件事,信任攒够了再谈更多权限。
开发的时候,先建一个只有自己和几个测试账号的测试服务器,不要直接在正式服务器上试。机器人在测试服务器里说错话、发错消息,最多是自己人看见;直接在正式服务器上试,一条测试消息发到几百人面前,收都收不回来。等命令在测试服务器上跑稳了,再把同一份代码接到正式服务器。
三、权限与 intents:只拿够用的,拿之前先问一句为什么
Discord 给机器人两套门禁:权限和 intents。权限管的是机器人能做什么:发消息、看频道、管理消息、踢人,每一项都要单独申请;intents 管的是机器人能看到什么:服务器成员名单、消息内容、用户状态,越敏感的越要单独开通。橘子值日生只要四样权限:查看频道、发送消息、发送嵌入消息、管理消息(只用来删自己发错的提醒);intents 只要两样:服务器成员和消息内容。别的,一律不要。
消息内容 intent 是最容易被忽略的一道坎。从设计上说,机器人要听懂用户发的“打卡”两个字,就必须能读到消息内容;但 Discord 默认不给这个权限,要在开发者门户里手动打开,还要说明用途。申请之前先确认:你的机器人是不是真的需要读每一条消息?如果命令全是斜杠命令,用户点一下就发,机器人根本不需要读聊天内容,那这个 intent 就不要开。少开一个 intent,就少一分数据责任,也少一次审核被问住的风险。
权限还要分频道给。机器人能在打卡频道发消息,不等于能在公告频道发消息;能在自习室服务器说话,不等于能在别的服务器说话。每个频道单独设一次:打卡频道允许发消息和加回应表情,公告频道只允许管理员调用发公告的命令,闲聊频道不给机器人任何权限。权限的检查要写进代码里:命令执行之前,先问一句“我在这个频道有没有权限做这件事”,没有就老实回一句“我在这个频道没有发消息的权限,请管理员检查一下”,而不是直接报错、让用户看一串看不懂的错误。
四、命令与斜杠命令:让用户点一下就能用,别让人背口令
机器人和用户说话有两种方式:老式的文字命令和斜杠命令。文字命令是用户在聊天框里敲“!打卡”,机器人认出感叹号开头就执行;斜杠命令是用户敲一个斜杠,Discord 弹出命令菜单,点一下、填几个选项就发出去了。新项目直接做斜杠命令,不用再教用户背口令:菜单里看得见命令名字、看得见每个选项是干什么的,敲错的概率小得多。橘子值日生的三个命令全是斜杠命令:/打卡、/今日统计、/提醒我。
命令设计有三条规矩。第一,名字要像人话:/打卡比/签到好,/今日统计比/数据好,用户不用猜。第二,选项越少越好:/提醒我只要一个选项——几点提醒,不要让用户填日期、填重复周期、填提醒方式,一次只问一件事。第三,每个命令都要有回音:用户点了/打卡,机器人先回一句“收到,正在记”,查完数据再回“今天已学两小时”;查数据要花几秒的时候,先回“收到”再慢慢查,不要让用户对着一个毫无反应的机器人干等。
命令还要有说明书,而且说明书要放在用户找得到的地方:一个/help 命令,列出所有命令、每个命令一句话说明、一个例子。说明书不要写在代码注释里,也不要只放在你的博客上,就放在机器人自己嘴里。命令改了名字、加了选项,说明书同一天跟着改,改完在测试服务器上点一遍,确认每个命令点下去都有反应,再发到正式服务器。
五、托管与常驻:机器人下线一次,信任就掉一格
机器人是住在服务器上的程序,不是你笔记本上跑的一段脚本。笔记本一合上、网络一断,机器人就下线了,服务器里的用户看到的是一个灰掉的头像和一句“机器人不在线”。所以机器人要住在一个一直开着的地方:一台便宜的云服务器、一个容器平台,或者任何能保证长期运行的托管服务。选哪个不重要,重要的是它能做到三件事:断了自动重启、重启了自动恢复、恢复了自动告诉你。
部署之前,先把机器人做成“重启之后什么都不丢”的样子。打卡记录、提醒时间、用户设置,这些都要存在数据库里,而不是存在内存里;程序重启,内存里的数据全没了,数据库里的数据还在。每次部署之前,先在测试服务器上重启一遍:重启之后,/今日统计还能不能查到昨天的打卡?提醒时间还在不在?都对了,再部署到正式服务器。部署用固定版本:今天跑的是哪个版本的代码,写下来,出了问题能立刻回到上一个版本,而不是现去翻聊天记录找“上次改了什么”。
常驻还要有人盯着。机器人自己要记健康日志:几点上线、几点掉线、掉线多久、为什么掉线;管理员每天看一眼,或者让监控服务在掉线超过五分钟时发一条提醒。橘子值日生掉过一次线,是因为云服务器半夜自动更新重启了,机器人没设开机自启,早上八点的提醒没发出去,群里几十个人在问“今天怎么没提醒”。那次之后,机器人加了两样东西:开机自启,和掉线超过五分钟自动发提醒给小满。机器人可以掉线,但不能悄悄掉线。
六、限流与防滥用:好心办坏事,往往从一条刷屏开始
机器人一上线,就会遇到两种人:一种是不小心按错的,一种是故意来试的。前者会连点十次/打卡,后者会写个脚本一分钟发一百条命令。没有限流,机器人要么把同一条打卡记十遍,要么把服务器的 API 额度一分钟烧光,要么被 Discord 直接限流、整个服务器的命令一起卡住。橘子值日生的限流很简单:同一个用户十秒内只能成功打卡一次,重复的命令回一句“已经记下了,不用重复打卡”;同一个命令一分钟内全服务器最多跑三十次,超过就回一句“大家先歇一会儿,一分钟后再试”。
防滥用还要分得清“热闹”和“攻击”。学习小组晚上八点集体打卡,一分钟涌进来五十条命令,这是热闹,要接住;凌晨三点一个新账号一分钟发一百条/提醒我,这是攻击,要挡住。挡的办法是分层:新加入服务器不到一天的账号,命令有更严的频率限制;连续五次命令都失败、或者连续触发限流的账号,先冷静十分钟,再试。挡的时候要留一句话,告诉用户为什么被挡、多久之后可以再试,不要一声不吭地把人晾在那里。
Discord 自己也有全局限流,机器人发消息太快会被强制慢下来,甚至暂时禁言。代码里要对限流有准备:收到限流回应就按要求等一会儿再发,不要立刻重试、越重试越被罚;发公告、发统计这类群发消息,要一条一条发、中间留几秒,不要一口气全推出去。限流不是敌人的刁难,是服务器在告诉你“慢一点,大家都好过”。
七、出错兜底:机器人可以答错,但不能一声不吭
机器人出错有四种,每一种都要有兜底。第一种,命令听懂了、数据查不到:用户打卡,数据库正好在维护,机器人要回“现在查不到你的记录,请过几分钟再试一次”,而不是回一句“出错了”就没了下文。第二种,命令没听懂:用户敲了个不存在的命令,机器人要回“没有这个命令,输入/help 看看我会什么”,顺便把最常用的三个命令列出来。第三种,权限不够:机器人在某个频道没有发消息的权限,要回“我在这个频道没有权限,请管理员检查一下设置”,而不是默默消失。
第四种最危险:机器人自己崩了。程序抛了异常、数据库连不上、依赖的服务超时,这时候用户看到的不能是一片空白。兜底的做法是:任何命令执行失败,都先回一句人话——“刚才那一下没办成,我已经记下来了,请稍后再试”;同时把错误详情记进日志:几点、哪个命令、哪个用户、错在哪一行。管理员每天看一次错误日志,同一条错误出现三次以上,当天就要修。用户可以接受机器人偶尔办不成事,不能接受机器人办不成事还一声不吭。
兜底还要有一条人工接管的路。机器人在公告里和/help 里写清楚:遇到机器人解决不了的事,直接@管理员;管理员每天固定看一次机器人收到的@和纠错记录。橘子值日生上线第一个月,有用户在打卡之后追问“我的打卡记录怎么少了一天”,机器人答不上来,但这句话被记进了纠错记录,小满当天就发现是时区算错了、连夜修好了。兜底的意义不在那句“请稍后再试”,而在每一次失败都被记下来、都有人接手。
八、上线清单:从申请到值班的完整链路
把前面七节串起来,一个机器人从申请到值班,走的是同一条链路:先想清楚要干的一件事,再去开发者门户申请账号、领 token、请进服务器,然后按最小权限开通权限与 intents,命令做成斜杠命令,部署到一直在线的托管服务,最后用限流、防滥用和出错兜底把它护住。用一组虚构数字衡量这条链路:橘子值日生上线第一个月,一千二百次命令调用里,一千零八十次成功响应,九十六次被限流与防滥用挡下,二十四次出错、走了兜底回复;一千零八十次成功响应,每次替管理员省三分钟人工答疑,一个月省下约五十四小时。这组数字是编的示例,用来说明链路的每一环都在干活:限流挡住的是不该跑的,出错兜底接住的是跑坏的,省下的时间才是机器人真正的产出。

上线之前,有一份很短的检查清单,值得逐条打勾。第一,一句话说清机器人每天替用户干的一件具体事,写清楚它不做什么、不去哪些频道、说错了找谁。第二,token 当场存进环境变量或密钥管理工具,不写进代码、不贴进聊天、不提交进仓库;先在测试服务器上跑稳,再接正式服务器。第三,权限与 intents 只拿够用的,消息内容 intent 需要才开,每个频道单独设权限,命令执行前先自查权限。第四,全部用斜杠命令,名字像人话、选项越少越好,每个命令都有回音,/help 里有说明书,改了命令同一天改说明书。第五,机器人住在一直在线的托管服务上,数据存在数据库里而不是内存里,部署用固定版本、能随时回滚,开机自启、掉线超过五分钟有人收到提醒。第六,同一个用户十秒内只能成功打卡一次,单个命令一分钟全服务器最多三十次,新账号更严,挡住的时候告诉用户为什么、多久能再试。第七,四种出错都有人话兜底,错误记进日志、同一条错误出现三次当天就修,公告和/help 里写清人工接管的路。做完这七条,机器人才能正式上岗值班,而不是在服务器成员列表里挂一个灰掉的头像。
评论 (0)
相关文章
Flexbox 一次只排一个方向,排对了,导航栏、卡片墙、购物车行都听话。本文按 MDN 的《Basic concepts of flexbox》《Aligning items in a flex container》《Controlling ratios of flex items along the main axis》三篇官方文档讲清楚:两根轴、容器与项目、方向与换行、剩余空间、flex 三件套、两根轴上的对齐、间距与自动边距。
一张点单就是一个对象:桌号、菜品、总价、付没付钱,全按标签收在一起。本文按 MDN 的《Working with objects》《JSON》《Object》三篇官方文档讲清楚:对象字面量、点号与方括号、增删改查、for...in 配 hasOwn、方法与 this、getter 与 setter、引用与复制、Object.assign 等工具箱、空白原型对象、JSON 的严规矩,以及 stringify 与 parse 和数字精度的坑。
2026 年 11 月 17 日,微软发布 MAI Code 2 和 Code 2 Flash:大模型 770 亿激活参数、100 万上下文,四项基准平均通过率 63.2%,与 GPT-6.1 Sol、Claude Opus 5.5 咬得很紧,但每任务成本只有 0.309 美元。先看清三处“但是”:价格是推广价、分数是三者最低、长周期任务不在舒适区。