后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载导读本文以 packages/discord.js/CHANGELOG.md 为绝对主体系统梳理 discord.js 主包在 v14 系列14.0.0 → 14.16.32022-07 至 2024-09两年多的全部版本演进涵盖大版本重构、Discord 新 API 的持续跟进论坛频道、Auto Moderation、投票、应用内嵌付费、用户可安装应用、类型系统与工程化演进以及伴随每个版本的缺陷修复清单。读完本文你将能够按版本回溯 discord.js v14 的能力边界理解关键特性在 packages/discord.js/src 中的落地位置并把这份 CHANGELOG 当作排查升级兼容性问题的第一手档案。一、CHANGELOG 是一份什么样的技术档案packages/discord.js/CHANGELOG.md共记录 29 个版本按时间倒序排列每个版本条目由Bug Fixes缺陷修复、Documentation文档、Features新功能、Performance性能、Refactor重构、Styling样式、Typings类型定义等分组构成并标注 PR 编号、提交哈希与贡献者。这份文件并非手写而是由仓库的发布流水线自动生成。在 packages/discord.js/cliff.toml 中定义了完整的生成规则提交信息必须遵循 Conventional Commits 规范conventional_commits true并按commit_parsers分组^feat→ Features、^fix→ Bug Fixes、^docs→ Documentation、^perf→ Performance、^refactor→ Refactor、^typings/^types→ Typings、含deprecated关键字 → Deprecation^revert、^chore、^ci、^build则被过滤跳过protect_breaking_commits true保证破坏性变更BREAKING CHANGE会被显式保留在 packages/discord.js/package.json 中通过pnpm run changelog执行git cliff --prepend ./CHANGELOG.md由cliff-jumper负责发布时追加版本条目。理解了生成机制就能读懂每条记录的粒度与可信度每一行都对应一次真实合并的提交既是开发者的沟通记录也是可追溯的实现索引。二、14.0.0一次面向 Discord API v10 的大版本重构14.0.02022-07-17是 v14 系列的起点也是从 v9 时代9.3.1直接跳跃而来的重大重构CHANGELOG 中它拥有最长的条目。核心变迁包括API 版本升级Gateway 与 REST 全面切换到 Discord APIv10gateway: Use version 10、Add API v10 support这是后续一切新能力的基础由于依赖discordjs/rest与discord-api-types大量内部枚举被替换为discord-api-types的等价物Use enums from discord-api-types、Use GuildFeature enum、Make constants enums top level and PascalCase这消除了 discord.js 自维护枚举与官方 API 类型的重复维护成本。错误体系重构内部Error统一更名为DiscordjsError体系Rename Error to DiscordjsError internally并实现了错误码校验DJSError: Error code validation错误码定义位于 packages/discord.js/src/errorsTOKEN_INVALID error not thrown at login with invalid token等认证类错误行为被修正。类型系统重建Events常量被转换为枚举Convert Events to an enum事件名类型得以强约束可在 packages/discord.js/src/util/Events.js 看到GuildAuditLogEntryCreate、GuildAvailable、WebhooksUpdate等 180 余个事件成员的枚举定义移除大量废弃类型守卫Remove renamed typeguardsCacheType泛型推断得到修正Fix cache types resolving to never并改用discord-api-types的Locale、ThreadAutoArchiveDuration等类型。删除与清理破坏性变更移除 store 频道Remove store channels移除deleted字段Remove deleted fieldv13 时代对象上的deleted布尔标记被彻底废弃移除Util.removeMentions()、RoleManager#comparePositions()、ApplicationCommandInteractionOptionResolver、Message#activity的部分冗余字段InteractionCreate、MessageCreate内部的旧事件发射路径被移除改为由 actions 系统统一分发。同时 14.0.0 也带来一批基础能力GuildBanManager支持分页packages/discord.js/src/managers/GuildBanManager.js、Message#bulkDelete返回被删消息、Modal 与文本输入组件Add Modals and Text Inputs、awaitModalSubmit、isRepliable类型守卫、CategoryChannelChildManager、应用命令 Attachment 选项类型等。三、稳定化补丁期14.1 ~ 14.3细节修复与基础能力补齐大版本发布后的三个月内v14 通过 14.1.x、14.2.0、14.3.0 快速稳定14.1.0 / 14.1.22022-07GuildChannelManager允许清空rtcRegionApplicationCommandManager允许向defaultMemberPermissions传0n新增频道与消息 URL 格式化函数channelURL/messageLink等GuildMember#dmChannelgetter 回归错误码统一修正。14.2.02022-08频道创建支持videoQualityModeGuild新增max_video_channel_users修复MessageMentions#parsedUsers死循环、Transformers不再误转换Date对象、ModalSubmitInteraction支持deferUpdate。14.3.02022-08WebSocketShard支持 Discord 新的 resume urlSupport new resume url为断线恢复机制奠定基础Client#deleteWebhook方法ClientPresence支持设置活动stateRole与Attachment新增flags属性Node.js 最低版本要求更新到16.11.0Update Node.js requirement to 16.11.0。14.4.02022-09论坛频道落地这是功能密度很高的一个版本Guild 论坛频道全面支持Add support for guild forumsForumChannel属性、GuildForumThreadManager、欢迎频道支持论坛、webhook 更新事件纳入论坛频道GuildBanManager#create新增deleteMessageSeconds替代被弃用的deleteMessageDaysBaseInteraction#isRepliable类型守卫chatInputApplicationCommandMention格式化函数Integration#scopesThreadChannel#fetchStarterMessage在论坛帖子中可用messageCount/totalMessageSent随消息事件正确更新。四、消息与组件体系完善14.5 ~ 14.614.5.02022-09GuildChannelManager支持创建/编辑频道flags修复flags属性名拼写错误ThreadChannel支持编辑flags、可编辑父频道为论坛频道GuildBanManager为deleteMessageDays增加弃用警告。14.6.02022-10新增discordjs/util包Add discordjs/util工具函数开始从主包外迁ForumChannel#defaultSortOrder、频道创建时的defaultAutoArchiveDurationUtil的 markdown 转义覆盖更多字符内部错误全面切换为DiscordjsError。五、Auto Moderation 与消息能力跃升14.7 ~ 14.814.7.02022-11Auto Moderation 完整支持Auto Moderation规则管理、触发元数据、动作执行等模块化落地新一代 Select MenuNew select menus字符串、用户、角色、频道、Mentionable 五种菜单类型SelectMenuInteractions#valuesMessage#bulkDeletable、Webhook#channel属性、GuildChannelManager#addFollower()、resume urls 支持安全与体验修复调试输出中隐藏 tokenCensor token in debug output、escapeMarkdown双重转义修复、MessageMentions增加InGuild泛型。14.8.02023-03新增guildAuditLogEntryCreate事件在 packages/discord.js/src/util/Events.js 中定义为枚举成员并在 packages/discord.js/src/client/websocket/handlers/GUILD_AUDIT_LOG_ENTRY_CREATE.js 落地角色订阅Role subscriptions与角色订阅数据、ClientApplication角色连接role connectionsGuildAuditLogs支持after分页GuildMember#flagsInteractionResponse新增方法与createdTimestamp论坛频道defaultForumLayoutNSFW 命令支持Guild#disableInvitesThreadMemberManager分页拉取gif 贴纸支持escapeX()系列函数迁移到discordjs/formattersMoved the escapeX functions from discord.js to discordjs/formatters主包开始瘦身。六、WebSocket 与 REST 架构重构14.9 ~ 14.1214.9.02023-04新增Guild#max_stage_video_channel_usersGuildBasedTextChannelTypes类型Channel#positiongetter 提速。14.10.02023-05语音消息附件支持Attachment: Voice messagesBaseInteraction支持新的频道 payloadRoleTagData#guildConnectionsWebSocketManager 内部改用 discordjs/ws 包WebSocketManager: Use /ws package internally主包与 WebSocket 实现解耦对应 packages/ws 独立包Client#generateInvite()的 scope 校验14.10.2与错误拼写修复14.10.1。14.11.02023-05Guild支持安全提醒频道与 everyone 提及防刷Safety alerts channel and mention raid protectionRole#positiongetter 再次线性化提速。14.12.02023-07REST 层大改与 breaking changesREST 全面切换到 fetch-like API 并提供策略strategiesrest: Switch api to fetch-like and provide strategies并随之声明多条BREAKING CHANGENode.js v18 为必要条件使用全局fetchREST 的raw方法现在返回 Web 兼容的Response对象parseResponse工具方法基于 Web 兼容Response重新实现DefaultRestOptions中默认agent改为null不再默认携带自定义 agent大量底层内部实现变更部分曾导出的内部模块不再可用。新增guildAvailable事件、buildIdentifyThrottlerws 选项、ShardingManager的silent选项、EmbedBuilder#length、Guild Onboarding新手引导支持新用户名系统Support new username system适配 Discord 去重用户名如username而非username#discriminator改革用户头像装饰avatar decorations、presence 多平台图片解析、分片 resume 事件。七、贴近新 API 的持续跟进14.13 ~ 14.1414.13.02023-08ClientApplication近似公会长数量与新GET路由Client#webhooksUpdate事件枚举见 packages/discord.js/src/util/Events.js 第 87/178 行Role#flags、Attachment#flagsCachedManager允许覆盖构造函数以配合makeCache。14.14.02023-11Select Menu 默认值Default select menu valuesdefaultValues支持在发送/编辑时预设媒体频道media channelsGuildMediaChannel及isMediaChannel()类型守卫BaseChannel#isThreadOnly()Guild Onboarding 模式与编辑方法、应用属性 patch 端点支持、StageInstanceManager#create支持关联guildScheduledEvent、GuildAuditLogsEntry暴露integrationType、Emoji#imageURL()、cleanContent支持斜杠命令与 emoji、widget 图片 URL、teams update 支持、Activity#sync_id发布节奏上 14.14.0 与 14.14.1 同日发布后者修复Emoji#id边界置undefined与BaseClient默认对象合并问题。八、投票、订阅与商业化能力14.15 ~ 14.1614.15.02024-05——Polls 与订阅体系投票Polls完整支持MessageManager轮询方法Poll methods、Message#poll、Poll/PollAnswer结构见 packages/discord.js/src/structures/Poll.js 及 packages/discord.js/src/index.js 的导出同时修复含投票消息不可交叉发布crosspost、论坛起始消息不支持投票等边界Premium 应用订阅Premium application subscriptions与可消耗型权利Consumable entitlements对应 packages/discord.js/src/structures/Entitlement.js 等订阅/权利结构GuildBanManager#bulkCreate()批量封禁packages/discord.js/src/managers/GuildBanManager.jsClientUser支持设置机器人 bannerMessageCreateOptions#enforceNonceWebhook#send支持appliedTags支持using关键字Add support for using keyword on discord.js Client and WebSocketManager即using client new Client(...)的显式资源管理语法类型系统MessageEditOptions修正attachments类型、InteractionReplyOptions允许MessageFlags.SuppressNotifications、interface merging 全面替代旧 Mixin 模式Replace Mixins with interface merging、导出ReadonlyCollection、ESM 场景下导出 ESM 类型Export ESM types。14.16.02024-09——用户可安装应用与 Super Reactions用户可安装应用User-installable apps支持integration_types、contexts等应用安装上下文ApplicationCommand可同时面向公国与用户维度安装Super Reactions超级反应MessageReaction支持burst属性与burstColors数据对应 API 的 burst 字段应用 EmojiApplication emojis新增ApplicationEmojiManagerpackages/discord.js/src/managers/ApplicationEmojiManager.js应用级 emoji 的增删改查Application#emojis属性VoiceState新增获取语音状态的多个方法对应 packages/discord.js/src/managers/VoiceStateManager.jsAttachment#titleUser#avatarDecorationDataMessage#call语音通话消息Invite#type自动化消息 nonce 处理Add support for Automated Message nonce handling、Premium 按钮Premium buttons、贴纸包 GET 端点、GuildAuditLogsEntryOnboarding 事件、公国角色 GET 端点重构同批修复MessagePayload解析崩溃、worker 分片传递env/execArgv/argv、GuildAuditLogsEntry映射AuditLogChange修正、GuildMemberManager#add()数据类型检查。14.16.1 ~ 14.16.32024-09收尾修复Message#react()返回undefined、Transformers 递归调用未传 client、BaseInteraction缺失属性、GuildChannel#guildId未补丁为undefined、ApplicationCommand#equals比较错误、发送型文本频道类型守卫、MessageEditOptions遗漏poll字段类型等。九、贯穿 v14 的类型系统与工程化演进纵览整个 CHANGELOGTypings分组几乎在每个版本都出现这是 v14 区别于早期版本的重要特征枚举化Events、GuildFeature、Status、AuditLogEvent、ThreadAutoArchiveDuration等全面枚举化并从discord-api-types复用字符串字面量也被允许传入GuildFeature: Allow feature strings to be passed可空性精确化大量null/undefined语义修正如BaseInteraction#appPermissions在公国内不为null、GuildScheduledEvent#scheduledStartAt可为空、UserContextMenuCommandInteraction#targetMember归零等泛型深化CacheType泛型贯穿交互、消息、频道体系Client#isReady窄化、Partials支持toString()、MessageManager重新允许消息比较只读性与不可变性用户输入统一采用readonly数组/集合类型Use readonly array / collection types for user input工程化主包类型文件typings/index.d.ts与 ESM 的typings/index.d.mts双轨导出见 packages/discord.js/package.json 的exports字段ESM 场景自动使用 ESM 类型api-extractor生成文档模型docs:new脚本。性能层面v14 中期开始系统性地对热路径 getter 做线性化Role#position14.9、14.11 两次优化、Channel#position、RoleManager避免重复取位置、Presence优先做布尔状态比较。这些优化方向可在对应结构的 getter 实现中印证。十、如何把这份 CHANGELOG 用起来升级排雷升大版本前先在本文件中检索目标版本区间的BREAKING CHANGE最显著的是 14.12.0 的 REST fetch-like 改造与 Node 18 要求与Deprecation分组确认自己用到的 API 是否受影响回溯行为变更遇到某个接口行为变了的疑问可按版本倒序查找对应结构的 Bug Fixes 条目再跳转到 packages/discord.js/src 对应文件structures/与managers/目录核实当前实现验证能力边界每个 Features 条目都可对应到源码导出例如应用 emoji 可在 packages/discord.js/src/index.js 中找到exports.ApplicationEmojiManager事件名可在 packages/discord.js/src/util/Events.js 枚举中核对了解发布机制若想复现这份 CHANGELOG可在仓库根目录执行pnpm --filter discord.js changelog对应git cliff --prepend ./CHANGELOG.md它会依据 packages/discord.js/cliff.toml 的分组规则重新生成。总而言之packages/discord.js/CHANGELOG.md记录的不仅是版本号更是 discord.js 在两年内跟随 Discord API 演进、持续重构内部架构API v10 → /ws 包 → fetch-like REST、并在类型体系上不断自我强化的完整轨迹。对使用 v14 的开发者而言它既是升级指南也是排查问题的索引更是理解当前 packages/discord.js/src 代码形态为何如此组织的背景档案。赞分享后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载相关推荐superfile 版本演进全览从 0.1.0 Beta 到 v1.6.0 的功能迭代、修复与架构变迁superfile 版本演进全览从 0.1.0 Beta 到 v1.6.0 的功能迭代、修复与架构变迁 superfile 是一款用 Go 编写的现代终端文件CLI开发工具Kimi Code CLI 版本演进全解析从 0.8 到 1.49 的功能迭代与技术架构变迁Kimi Code CLI 版本演进全解析从 0.8 到 1.49 的功能迭代与技术架构变迁 导读 本文以仓库根目录的 CHANGELOG.md https:人工智能AI Agent代码智能体交互助手CLI工具调用xiaomusic 版本演进全解读从 v0.1.1 到 v0.6.1 的功能迭代、架构重构与安全修复记录xiaomusic 版本演进全解读从 v0.1.1 到 v0.6.1 的功能迭代、架构重构与安全修复记录 本文以仓库内 docs/issues/changel后端智能硬件音视频上一篇终极指南深入理解ZLIB数据压缩库及其应用下一篇解决Obtainium中Shizuku/Root模式更新失败的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考