开源社区治理：用 Node.js 写个 Issue 自动标签机器人

开源社区治理用 Node.js 写个 Issue 自动标签机器人最近帮一个开源项目维护 Issue 列表时发现每天要处理几十条新提交。有些是真正的 bug 报告有些只是用户没仔细看文档就问“为什么报错”。如果全靠人工分类打标签确实挺费时间。于是试着写了个简单的 Node.js 脚本自动给新 issue 打上标签顺便提醒用户补全信息。实际遇到的几个麻烦刚开始接手社区维护时最常碰到的问题大概是这些标签乱成一团有人把“怎么安装”这种问题标成 bug也有人在 feature request 里写报错截图。翻历史记录找同类问题特别费劲。描述太简略上周收到个“程序崩溃”的 issue点开一看正文就三个字“报错了”。连用的什么版本都没写只能来回追问。没人认领有个模块的负责人出差两周期间提交的 5 个 issue 一直悬着直到他回来才有人处理。怎么让机器人帮忙干活后来想到可以用 GitHub 的 webhook 功能。当有人提交 issue 时自动触发我们自己的服务检查内容。大概流程是这样的graph TD A[用户提交 issue] -- B[GitHub 发通知给我们的服务器] B -- C[解析内容看是不是 bug/功能请求] C -- D{判断是否需要补充信息} D --|信息不全| E[自动回复提示模板] D --|符合规范| F[打标签 分配负责人] F -- G[同步回 GitHub]试了两个月下来大概能拦下六成左右明显不符合规范的提问。比如上次有个用户直接粘贴了段错误日志机器人自动回复“请提供复现步骤和运行环境”结果对方乖乖补全了信息。用原生 Node.js 写了个小工具不想依赖 Probot 这类框架就自己搭了个 HTTP 服务器。核心逻辑其实就两步验证请求来源是否合法然后分析 issue 内容。// 简化版核心代码片段 const http require(http); const crypto require(crypto); const PORT 8080; const WEBHOOK_SECRET process.env.GITHUB_SECRET; // 实际部署时从环境变量读取 function analyzeIssue(title, body) { const text ${title} ${body}.toLowerCase(); if (body.length 20) { return { action: comment, message: ⚠️ 请补充问题描述参考模板https://xxx }; } if (/bug|error|crash/.test(text)) { return { labels: [bug], assignee: alice }; } if (/feat|proposal|suggest/.test(text)) { return { labels: [enhancement] }; } return { labels: [question] }; } http.createServer((req, res) { if (req.url /webhook req.method POST) { let body ; req.on(data, chunk body chunk); req.on(end, () { // 验证签名省略具体实现 const result analyzeIssue( JSON.parse(body).issue.title, JSON.parse(body).issue.body ); // 调用 GitHub API 执行操作省略 res.end(OK); }); } }).listen(PORT);重点注意两点一是必须校验 webhook 签名不然随便谁都能模拟请求二是关键词匹配不能太死板比如有人写 its broken 而不是 bug所以加了正则扩展。后续还能做啥现在这个脚本只能做基础分类但已经省下不少时间。接下来打算加几个功能自动关僵尸 issue超过一个月没动静的问题先标stale再过一周直接关闭。上个月清理了 37 个类似情况。查重提示新 issue 提交时搜索历史库如果发现半年前有类似问题已解决自动留言附上链接。最近两次帮用户省了重复提问的时间。CLA 检查合并 PR 前自动确认贡献者签过协议避免法律风险。最后说两句其实社区治理和写代码挺像的——前期多花点功夫搭好规则后面就能少救火。有个朋友的项目自从上了自动标签机器人维护者平均每天花在分类上的时间从 2 小时降到 15 分钟。当然初期调规则挺头疼比如第一次把 how to install 全标成 question后来发现其实应该归到 documentation 类别。如果你也在管开源项目不妨先从小功能开始试。哪怕只是自动回复个模板都比让用户干等着强。