后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载discordjs/voice是 discord.js 官方对 Discord Voice API 的 TypeScript 实现承载了机器人加入语音频道、播放与接收音频的核心能力。本文以 packages/voice/CHANGELOG.md 为骨架结合仓库源码逐版梳理 0.8.0 → 0.19.2 之间影响最大的一批变更——包括加密后端迁移、DAVE 端到端加密落地、Voice Gateway v8 升级与 Node.js 版本门槛变化——帮助你在升级依赖时准确评估破坏性变更并理解底层实现原理。版本演进总览该包当前版本为0.19.2见 package.jsonCHANGELOG 记录的主要里程碑如下版本发布时间核心主题0.19.22026-03-13剥离 RTP 包填充字节并增加守卫0.19.12026-03-09DAVE 成为必需、修复负超时与多转换并发、移除 builders/formatters 再导出0.19.02025-08-17实现 DAVE 端到端加密、升级 Voice Gateway v8、Node.js 门槛提升0.18.02024-11-17移除 tweetnacl迁移到新一代加密库破坏性变更0.17.02024-05-04TransformerGraph 修复、FFmpeg 优化检测改为懒加载0.15.02023-03-12心跳保活不再等待响应0.11.02022-07-17VoiceReceiver 数据包解析修复、恢复类型化事件下文按「加密体系」「连接与网络」「音频处理」「工程化」四条主线展开说明。加密体系的两次大变革语音包加密是 voice 包演进的主线先后经历了两次方向性调整0.18.0淘汰 tweetnacl0.19.0引入 DAVE 协议。0.18.0告别 tweetnacl迁移到新加密库0.18.0是一次带有BREAKING CHANGE的版本由于 Discord 官方废弃了 tweetnacl 所支持的旧加密算法xsalsa20-poly1305系列该库不再支持以tweetnacl作为加密后端。受影响用户需迁移到以下任一方案sodium-nativesodiumstablelib/xchacha20poly1305noble/cipherslibsodium-wrappers如果系统本身支持aes-256-gcm则无需安装任何加密库。可以通过如下命令验证require(node:crypto).getCiphers().includes(aes-256-gcm);这一设计在源码中有完整印证packages/voice/src/util/Secretbox.ts 定义了统一的Methods接口crypto_aead_xchacha20poly1305_ietf_encrypt/decrypt并为五个候选库逐一提供适配器加载时通过动态import依次尝试只要有一个库能成功导入就立即使用。若全部缺失则会抛出提示安装加密库的明确错误Cannot play audio as no valid encryption package is installed. - Install one of: - sodium - libsodium-wrappers - stablelib/xchacha20poly1305 - noble/ciphers. - Use the generateDependencyReport() function for more information.注意libsodium-wrappers需要先等待其ready标记再使用源码中if (libName libsodium-wrappers lib.ready) await lib.ready;这是它异步初始化 WASM 导致的。从 packages/voice/src/networking/Networking.ts 可以看到加密模式的实际选择逻辑SUPPORTED_ENCRYPTION_MODES默认只含AeadXChaCha20Poly1305RtpSize只有当crypto.getCiphers()包含aes-256-gcm时才把AeadAes256GcmRtpSize置于列表首位优先协商。0.19.0DAVE 端到端加密落地0.19.0实现了DAVEDiscord Audio Video End-to-End Encryption协议PR #10921语音数据在传输前即完成加密服务端不再能看到明文音频。配套变更还包括Voice Gateway 升级到 v8PR #10918承载 DAVE 握手相关的新消息类型原生aes-256-gcm支持检测PR #10764运行时打印系统是否支持该密码套件首个贡献者 Snazzah 正是 DAVE 实现的主要作者。0.19.1进一步将 DAVE 升级为必需依赖PR #11385snazzah/davey是当前唯一受支持的 DAVE 协议库且随包预装无需用户手动安装。这一点在 package.json 的 dependencies 中可以看到snazzah/davey: ^0.1.11。底层实现位于 packages/voice/src/networking/DAVESession.ts它包装了 davey 的会话对象负责协议版本协商protocolVersion为 0 表示未启用 DAVEgetMaxProtocolVersion()直接取自Davey.DAVE_PROTOCOL_VERSION过渡Transition管理prepareTransition/executeTransition配合pendingTransitionsMap 处理升级与降级。降级到 v0 时先进入 passthrough 模式TRANSITION_EXPIRY_PENDING_DOWNGRADE24 秒为连接延迟留出缓冲0.19.1修复的同时处理多个转换PR #11100正对应这套并发逻辑解密容错自愈连续解密失败次数超过decryptionFailureTolerance默认DEFAULT_DECRYPTION_FAILURE_TOLERANCE 36后recoverFromInvalidTransition会重新初始化会话对静音帧放行encrypt/decrypt对SILENCE_FRAME直接透传避免无谓的加解密开销。0.19.1的另一处修复是负超时处理PR #11362防止在abortAfter等场景传入负数导致行为异常同版本还移除了对 builders 与 formatters 的再导出PR #11361依赖这些符号的外部代码需要改为直接从对应包导入。0.19.2剥离 RTP 填充并增加守卫0.19.2修复了接收端 RTP 数据包中携带填充字节padding时解析不正确的问题现在会先剥离填充并增加边界守卫PR #11449提升与其他客户端互操作时的健壮性。RTP 载荷类型常量RTP_OPUS_PAYLOAD_TYPE 0x78定义在 packages/voice/src/util/constants.ts。连接层Gateway v8 与心跳保活Voice Gateway v80.19.0网络层状态机NetworkingStatusCodeOpeningWs → Identifying → UdpHandshaking → SelectingProtocol → Ready → Resuming → Closed定义在 packages/voice/src/networking/Networking.ts消息类型使用discord-api-types/voice/v8NetworkingReadyState中新增了可选的dave会话字段。心跳不再等待响应0.15.0PR #9202 让 keep-alive 发送后不阻塞等待应答降低了网络抖动对连接状态机的干扰。Buffer#slice()→Buffer#subarray()0.19.1全局替换避免了slice复制内存的开销subarray共享底层内存在高频语音包处理场景下减少 GC 压力。音频处理与接收端的稳定性修复TransformerGraph0.17.0 / 0.16.1修复了可读输入场景下输入参数未显式传入的问题PR #9793确保 FFmpeg/Opus 转换图在各类输入源下参数传递一致。FFmpeg 优化检测懒加载0.17.0getNode/canEnableFFmpegOptimizations被移入懒加载调用PR #9918避免在模块加载阶段就执行昂贵的环境探测。VoiceReceiver0.11.0修复parsePacket对 RTP 头的解析PR #8277SpeakingMap修正事件名以兼容 docgenPR #82360.11.0 还恢复了类型化事件PR #8109。本地/预览检测0.17.0新增 local 与 preview 环境的探测能力便于在非生产网关环境下调试。Node.js 版本门槛的持续提升CHANGELOG 中记录了两次 Build 级别的BREAKING CHANGE版本最低 Node.js说明0.19.022.12.0PR #10726配合 DAVE 与新版工具链0.19.0 内20PR #10616先升到 20再进一步升到 22.12当前24.17.0见 package.jsonengines字段升级时务必先确认运行环境的 Node.js 满足要求否则engines检查会直接失败。如何快速验证依赖环境CHANGELOG 多次提到依赖安装问题实际排查时可使用包内自带的依赖报告工具 packages/voice/src/util/generateDependencyReport.tsgenerateDependencyReport()会汇总 Corediscordjs/voice、prism-media、Opusdiscordjs/opus、opusscript、Encryptionaes-256-gcm支持情况及五个候选库、DAVEsnazzah/davey与 FFmpeg版本及--enable-libopus的安装情况是定位无法播放音频类问题最快的手段。小结与升级建议纵观0.8.0至0.19.2discordjs/voice的演进主线十分清晰从兼容多加密后端Secretbox 适配器体系到跟随 Discord 官方废弃旧算法再到主动实现 DAVE 端到端加密并强制要求 davey同时持续收紧 Node.js 版本门槛、优化包处理性能。升级路径上的关键动作有三确认 Node.js ≥ 24.17.0若系统不支持aes-256-gcm从五个候选加密库中任选其一安装若用到 builders/formatters 的再导出改为从discordjs/builders、discordjs/formatters直接导入。如需深入验证上述行为可直接阅读 DAVESession.ts、Secretbox.ts 与 Networking.ts 的对应实现以及tests目录下覆盖这些逻辑的单元测试。赞分享后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载相关推荐SQLCipher数据库迁移从普通SQLite到加密版本SQLCipher数据库迁移从普通SQLite到加密版本 引言为什么需要数据库加密 在当今数字化时代数据安全已成为重中之重。SQLite作为一款轻量级嵌数据库关系型数据库嵌入式数据库密码学Dify.AI数据加密端到端加密Dify.AI数据加密端到端加密 概述 在人工智能应用开发领域数据安全是至关重要的考量因素。Dify.AI作为一个开源的大型语言模型应用开发平台采用了先进人工智能大模型LLMOpsAI 应用RAGAI Agent低代码Joplin 端到端加密同步快照深度解析从 JED 密文格式到 Sync Version 3 迁移测试Joplin 端到端加密同步快照深度解析从 JED 密文格式到 Sync Version 3 迁移测试 Joplin 以隐私优先的笔记同步为核心能力其端知识管理跨平台插件系统上一篇构建语言学习选择器downshift与语言API集成下一篇如何快速搭建OpenHaystack开发环境从源码到调试的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 @discordjs/voice 版本演进全解析：从加密库迁移到 DAVE 端到端加密
后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载discordjs/voice是 discord.js 官方对 Discord Voice API 的 TypeScript 实现承载了机器人加入语音频道、播放与接收音频的核心能力。本文以 packages/voice/CHANGELOG.md 为骨架结合仓库源码逐版梳理 0.8.0 → 0.19.2 之间影响最大的一批变更——包括加密后端迁移、DAVE 端到端加密落地、Voice Gateway v8 升级与 Node.js 版本门槛变化——帮助你在升级依赖时准确评估破坏性变更并理解底层实现原理。版本演进总览该包当前版本为0.19.2见 package.jsonCHANGELOG 记录的主要里程碑如下版本发布时间核心主题0.19.22026-03-13剥离 RTP 包填充字节并增加守卫0.19.12026-03-09DAVE 成为必需、修复负超时与多转换并发、移除 builders/formatters 再导出0.19.02025-08-17实现 DAVE 端到端加密、升级 Voice Gateway v8、Node.js 门槛提升0.18.02024-11-17移除 tweetnacl迁移到新一代加密库破坏性变更0.17.02024-05-04TransformerGraph 修复、FFmpeg 优化检测改为懒加载0.15.02023-03-12心跳保活不再等待响应0.11.02022-07-17VoiceReceiver 数据包解析修复、恢复类型化事件下文按「加密体系」「连接与网络」「音频处理」「工程化」四条主线展开说明。加密体系的两次大变革语音包加密是 voice 包演进的主线先后经历了两次方向性调整0.18.0淘汰 tweetnacl0.19.0引入 DAVE 协议。0.18.0告别 tweetnacl迁移到新加密库0.18.0是一次带有BREAKING CHANGE的版本由于 Discord 官方废弃了 tweetnacl 所支持的旧加密算法xsalsa20-poly1305系列该库不再支持以tweetnacl作为加密后端。受影响用户需迁移到以下任一方案sodium-nativesodiumstablelib/xchacha20poly1305noble/cipherslibsodium-wrappers如果系统本身支持aes-256-gcm则无需安装任何加密库。可以通过如下命令验证require(node:crypto).getCiphers().includes(aes-256-gcm);这一设计在源码中有完整印证packages/voice/src/util/Secretbox.ts 定义了统一的Methods接口crypto_aead_xchacha20poly1305_ietf_encrypt/decrypt并为五个候选库逐一提供适配器加载时通过动态import依次尝试只要有一个库能成功导入就立即使用。若全部缺失则会抛出提示安装加密库的明确错误Cannot play audio as no valid encryption package is installed. - Install one of: - sodium - libsodium-wrappers - stablelib/xchacha20poly1305 - noble/ciphers. - Use the generateDependencyReport() function for more information.注意libsodium-wrappers需要先等待其ready标记再使用源码中if (libName libsodium-wrappers lib.ready) await lib.ready;这是它异步初始化 WASM 导致的。从 packages/voice/src/networking/Networking.ts 可以看到加密模式的实际选择逻辑SUPPORTED_ENCRYPTION_MODES默认只含AeadXChaCha20Poly1305RtpSize只有当crypto.getCiphers()包含aes-256-gcm时才把AeadAes256GcmRtpSize置于列表首位优先协商。0.19.0DAVE 端到端加密落地0.19.0实现了DAVEDiscord Audio Video End-to-End Encryption协议PR #10921语音数据在传输前即完成加密服务端不再能看到明文音频。配套变更还包括Voice Gateway 升级到 v8PR #10918承载 DAVE 握手相关的新消息类型原生aes-256-gcm支持检测PR #10764运行时打印系统是否支持该密码套件首个贡献者 Snazzah 正是 DAVE 实现的主要作者。0.19.1进一步将 DAVE 升级为必需依赖PR #11385snazzah/davey是当前唯一受支持的 DAVE 协议库且随包预装无需用户手动安装。这一点在 package.json 的 dependencies 中可以看到snazzah/davey: ^0.1.11。底层实现位于 packages/voice/src/networking/DAVESession.ts它包装了 davey 的会话对象负责协议版本协商protocolVersion为 0 表示未启用 DAVEgetMaxProtocolVersion()直接取自Davey.DAVE_PROTOCOL_VERSION过渡Transition管理prepareTransition/executeTransition配合pendingTransitionsMap 处理升级与降级。降级到 v0 时先进入 passthrough 模式TRANSITION_EXPIRY_PENDING_DOWNGRADE24 秒为连接延迟留出缓冲0.19.1修复的同时处理多个转换PR #11100正对应这套并发逻辑解密容错自愈连续解密失败次数超过decryptionFailureTolerance默认DEFAULT_DECRYPTION_FAILURE_TOLERANCE 36后recoverFromInvalidTransition会重新初始化会话对静音帧放行encrypt/decrypt对SILENCE_FRAME直接透传避免无谓的加解密开销。0.19.1的另一处修复是负超时处理PR #11362防止在abortAfter等场景传入负数导致行为异常同版本还移除了对 builders 与 formatters 的再导出PR #11361依赖这些符号的外部代码需要改为直接从对应包导入。0.19.2剥离 RTP 填充并增加守卫0.19.2修复了接收端 RTP 数据包中携带填充字节padding时解析不正确的问题现在会先剥离填充并增加边界守卫PR #11449提升与其他客户端互操作时的健壮性。RTP 载荷类型常量RTP_OPUS_PAYLOAD_TYPE 0x78定义在 packages/voice/src/util/constants.ts。连接层Gateway v8 与心跳保活Voice Gateway v80.19.0网络层状态机NetworkingStatusCodeOpeningWs → Identifying → UdpHandshaking → SelectingProtocol → Ready → Resuming → Closed定义在 packages/voice/src/networking/Networking.ts消息类型使用discord-api-types/voice/v8NetworkingReadyState中新增了可选的dave会话字段。心跳不再等待响应0.15.0PR #9202 让 keep-alive 发送后不阻塞等待应答降低了网络抖动对连接状态机的干扰。Buffer#slice()→Buffer#subarray()0.19.1全局替换避免了slice复制内存的开销subarray共享底层内存在高频语音包处理场景下减少 GC 压力。音频处理与接收端的稳定性修复TransformerGraph0.17.0 / 0.16.1修复了可读输入场景下输入参数未显式传入的问题PR #9793确保 FFmpeg/Opus 转换图在各类输入源下参数传递一致。FFmpeg 优化检测懒加载0.17.0getNode/canEnableFFmpegOptimizations被移入懒加载调用PR #9918避免在模块加载阶段就执行昂贵的环境探测。VoiceReceiver0.11.0修复parsePacket对 RTP 头的解析PR #8277SpeakingMap修正事件名以兼容 docgenPR #82360.11.0 还恢复了类型化事件PR #8109。本地/预览检测0.17.0新增 local 与 preview 环境的探测能力便于在非生产网关环境下调试。Node.js 版本门槛的持续提升CHANGELOG 中记录了两次 Build 级别的BREAKING CHANGE版本最低 Node.js说明0.19.022.12.0PR #10726配合 DAVE 与新版工具链0.19.0 内20PR #10616先升到 20再进一步升到 22.12当前24.17.0见 package.jsonengines字段升级时务必先确认运行环境的 Node.js 满足要求否则engines检查会直接失败。如何快速验证依赖环境CHANGELOG 多次提到依赖安装问题实际排查时可使用包内自带的依赖报告工具 packages/voice/src/util/generateDependencyReport.tsgenerateDependencyReport()会汇总 Corediscordjs/voice、prism-media、Opusdiscordjs/opus、opusscript、Encryptionaes-256-gcm支持情况及五个候选库、DAVEsnazzah/davey与 FFmpeg版本及--enable-libopus的安装情况是定位无法播放音频类问题最快的手段。小结与升级建议纵观0.8.0至0.19.2discordjs/voice的演进主线十分清晰从兼容多加密后端Secretbox 适配器体系到跟随 Discord 官方废弃旧算法再到主动实现 DAVE 端到端加密并强制要求 davey同时持续收紧 Node.js 版本门槛、优化包处理性能。升级路径上的关键动作有三确认 Node.js ≥ 24.17.0若系统不支持aes-256-gcm从五个候选加密库中任选其一安装若用到 builders/formatters 的再导出改为从discordjs/builders、discordjs/formatters直接导入。如需深入验证上述行为可直接阅读 DAVESession.ts、Secretbox.ts 与 Networking.ts 的对应实现以及tests目录下覆盖这些逻辑的单元测试。赞分享后端【免费下载链接】discord.jsA powerful JavaScript library for interacting with the Discord API项目地址https://gitcode.com/gh_mirrors/di/discord.js点击查看免费下载相关推荐SQLCipher数据库迁移从普通SQLite到加密版本SQLCipher数据库迁移从普通SQLite到加密版本 引言为什么需要数据库加密 在当今数字化时代数据安全已成为重中之重。SQLite作为一款轻量级嵌数据库关系型数据库嵌入式数据库密码学Dify.AI数据加密端到端加密Dify.AI数据加密端到端加密 概述 在人工智能应用开发领域数据安全是至关重要的考量因素。Dify.AI作为一个开源的大型语言模型应用开发平台采用了先进人工智能大模型LLMOpsAI 应用RAGAI Agent低代码Joplin 端到端加密同步快照深度解析从 JED 密文格式到 Sync Version 3 迁移测试Joplin 端到端加密同步快照深度解析从 JED 密文格式到 Sync Version 3 迁移测试 Joplin 以隐私优先的笔记同步为核心能力其端知识管理跨平台插件系统上一篇构建语言学习选择器downshift与语言API集成下一篇如何快速搭建OpenHaystack开发环境从源码到调试的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考