用途
该技能用于构建 Discord 机器人,适用于创建 Discord bot、斜杠命令(slash commands)和审核(moderation)机器人等场景。触发词包括 "discord"、"discord bot"、"serenity" 等。
项目保护前置步骤
资料要求在任何代码编写前完成项目保护配置:创建 .gitignore,忽略构建产物(target/、node_modules/、pycache/、dist/)、密钥文件(.env、.env.*、bot_token.txt、含 token 的 config.json,但保留 .env.example)以及 IDE 目录(.idea/、.vscode/、.DS_Store);同时配置 pre-commit 钩子,使用 pre-commit-hooks(v5.0.0,检测私钥、检查大文件)与 gitleaks(v8.21.2),并执行 pre-commit install。资料说明原因是 Discord bot token 拥有完全访问权限,泄露会导致机器人被攻破、可向用户发送垃圾信息。
技术栈选择
资料列出三种可选组合:Rust 使用 serenity + poise,适合性能与类型安全;Python 使用 discord.py 或 nextcord,适合快速开发;Node 使用 discord.js,适合 JS 生态与最大社区。
主要能力与示例
资料提供各技术栈的快速开始代码:Rust 的 Cargo.toml 依赖与 poise 框架的 hello 斜杠命令、全局注册、从环境变量读取 DISCORD_TOKEN;Python 的 requirements.txt、CommandTree 与 on_ready 中 tree.sync();Node 的 discord.js v14 客户端、REST 注册命令与 interactionCreate 处理。
命令能力覆盖:带参数与权限的 ban 命令(Rust 使用 required_permissions,Python 使用默认权限与参数描述);嵌入消息(CreateEmbed / discord.Embed,含标题、描述、字段、颜色、缩略图);按钮与组件(Rust 的 CreateButton 与 ActionRow,Python 的 View 与 Button);事件处理(on_message 响应 !ping、on_member_join 发送欢迎消息);权限控制(如 clear 命令要求 MANAGE_MESSAGES);以及面向 2500+ 服务器的分片(start_autosharded 或 AutoShardedClient)。
环境与安全
使用 .env 存放 DISCORD_TOKEN 与开发用 GUILD_ID,并将 .env 加入 .gitignore。资料列出常见问题及对应解决:命令不显示需同步/注册命令;缺少 intents 需在开发者门户和代码中启用;速率限制需缓存与批量操作;特权 intents 需在门户启用;token 泄露需用环境变量且绝不提交。另附常见功能所需 intents(MESSAGE_CONTENT、GUILD_MEMBERS、GUILD_PRESENCES 为特权)与邀请链接 URL 格式。
测试
资料给出 Rust(#[cfg(test)] 与 tokio 异步测试)、Python(pytest、AsyncMock、MagicMock 模拟交互与权限)、Node(vitest 模拟交互对象)的测试示例,并描述 TDD 工作流:先由测试编写任务产出失败测试(RED),再由开发任务实现使测试通过(GREEN),循环处理每个命令,最后进行安全、权限与速率限制的代码审查。
安全清单与项目结构
安全清单包括:token 存于环境变量、.env 在 .gitignore 中、使用 gitleaks 的 pre-commit 钩子、所有审核命令做权限检查、用户命令限流、输入清理(防嵌入注入)、按需启用特权 intents、记录审核操作的审计日志。项目结构示例展示 Rust 项目的 src(main.rs、commands/、events.rs)、tests、Cargo.toml、.env.example、.env(不提交)与 .gitignore 布局。
限制
资料未提供各框架的版本兼容性说明、部署与托管方式、收费信息或具体平台上线步骤。