discord-voice-memo-upgrade

🎙️ 语音备忘录TTS自动修复方案

Clawdbot核心补丁,精准修复语音备忘录TTS自动回复失效问题,恢复Discord语音消息的自动语音合成功能。

收藏
4.1k
安装
1k
版本
v1.0.0
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

Discord Voice Memo Upgrades 是针对 Clawdbot(亦称 Moltbot)的专用核心补丁,旨在解决语音备忘录无法触发 TTS(文本转语音)自动回复的技术故障。该 Skill 并非传统意义上的插件扩展,而是一套包含详细文档和补丁文件的修复方案,通过精准修改核心模块的流式传输逻辑,确保语音消息能够正常触发语音合成响应。

核心用法方面,用户需要将补丁文件手动部署至 Clawdbot 安装目录,替换 dispatch-from-config.jstts.js 两个核心文件。补丁通过检测入站消息是否包含音频附件、TTS 自动模式配置状态以及 API 密钥有效性,智能判断是否临时禁用块流式传输(block streaming)。当检测到语音消息且满足 TTS 触发条件时,系统会确保最终完整的文本 payload 能够送达 TTS 合成管道,而非被流式优化机制截断。

显著优点包括:精准定位并修复了块流式传输与 TTS 管道的兼容性问题;提供了详尽的调试日志,便于开发者追踪 [TTS-DEBUG][TTS-APPLY][TTS-SPEECH] 等关键节点的执行状态;补丁逻辑非侵入式,仅在必要时禁用流式传输,不影响常规文本消息的流式响应体验;同时提供了完整的备份和回滚脚本,降低了操作风险。

潜在缺点与局限性不容忽视:首先,该方案需要直接修改 Clawdbot 的编译后核心文件(dist 目录),属于"硬补丁",在官方更新后需要手动重新应用,维护成本较高。其次,补丁内置了大量 console.log 调试语句,虽然便于排查问题,但在生产环境中会产生冗余日志,需要手动清理。此外,作为社区个人开发者(T3 来源)提供的非官方补丁,缺乏长期维护承诺和自动化更新机制。

适合的目标群体主要包括:正在使用 Clawdbot 搭建 Discord 机器人且依赖语音交互功能的开发者;需要实现"语音入、语音出"全双工对话场景的智能助手项目;以及具备一定 Node.js 和命令行操作能力,能够承担手动补丁维护工作的技术团队。

使用风险方面,除常规的 API 密钥配置错误风险外,还需关注:补丁修改核心文件可能导致未来版本更新时的合并冲突;禁用块流式传输在极端高并发场景下可能对内存占用产生轻微影响;调试日志若未清理可能泄露消息内容的片段信息(尽管已实现 80 字符截断);以及依赖特定 TTS 提供商(OpenAI、ElevenLabs 或 Edge)的 API 稳定性。

安全解读

核心用法

该 Skill 是 Clawdbot/Moltbot 的核心补丁,用于修复语音备忘录无法触发 TTS 自动回复的 bug。当启用 block streaming(流式分块传输)时,系统会丢弃 final payload 以优化性能,但这导致 TTS 合成管道无法接收到完整的文本内容。

工作原理:补丁在 dispatch-from-config.js 中增加智能检测逻辑——当识别到入站消息包含音频附件且 TTS 自动模式为 "inbound" 或 "always" 时,临时禁用该回复的 block streaming,确保 final payload 到达 TTS 管道完成语音合成。

显著优点

  • 精准修复:针对性强,直击 block streaming 与 TTS 的冲突根源
  • 配置零侵入:无需额外配置,沿用现有 TTS 设置
  • 详细调试:内置 [TTS-DEBUG] / [TTS-APPLY] / [TTS-SPEECH] 三级日志,便于排查
  • 完全可逆:提供完整回滚脚本,备份机制健全

潜在缺点与局限性

  • dist 文件补丁:直接修改编译后的产物,非源码级修复,Clawdbot 更新后需重新应用
  • 调试日志冗余:生产环境需手动清理 console.log 语句
  • T3 来源风险:个人开发者维护,无企业级 SLA 保障
  • 平台依赖:仅适用于 Clawdbot 生态,无法独立运行

适合人群

  • 使用 Clawdbot 搭建 Discord 机器人的开发者
  • 需要语音消息自动语音回复功能的社区运营者
  • 具备 Node.js 基础、能执行手动补丁操作的技术用户

常规风险

1. 更新失效风险:Clawdbot 升级后补丁被覆盖,需重新部署
2. 性能影响:禁用 block streaming 可能轻微影响大文本回复的流式体验

3. API 密钥泄露:TTS 调用需配置 OpenAI/ElevenLabs 密钥,需确保环境变量安全

4. 兼容性问题:未来 Clawdbot 架构变更可能导致补丁失效

---

安全评估

| 维度 | 结果 |
|------|------|
| 静态分析 | 无危险函数、无混淆代码 |
| 动态行为 | 无可疑运行时行为 |
| 依赖审计 | 零第三方依赖 |
| 网络流量 | 仅用户配置的 TTS API 调用 |
| 隐私合规 | 无敏感数据收集,符合 GDPR/CCPA |

总体评价:低风险补丁型 Skill,代码透明,无隐蔽行为,建议审查后使用。

discord-voice-memo-upgrade 内容

patch文件夹
手动下载zip · 23.7 kB
dispatch-from-config.jstext/javascript
请选择文件