需完成模型适配、插件注册与语音服务配置三步：一、在.env中配置deepseek v4的custom openai兼容api；二、创建tts-deepseek插件并热加载；三、配置coqui或azure等tts引擎及音色参数，重启后验证联动效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 LobeChat 中接入 DeepSeek V4 模型并同时启用插件系统与 TTS 语音合成功能，则需分别完成模型适配、插件注册与语音服务配置三个关键环节。以下是实现该目标的具体步骤：
一、配置 DeepSeek V4 为可用模型
DeepSeek V4 尚未被 LobeChat 官方默认支持，需通过自定义模型配置方式接入。LobeChat 使用 OpenAI 兼容 API 协议对接大模型，因此需确保 DeepSeek 提供符合该协议的 API 端点（如通过官方 API 或本地部署的 vLLM/Ollama 封装服务）。
1、确认 DeepSeek V4 的 API 接入地址已就绪，格式应为 https://api.deepseek.com/v1/chat/completions 或本地代理地址（如 http://localhost:8000/v1/chat/completions）。
2、编辑 LobeChat 项目根目录下的 .env 文件，在末尾新增以下字段：
MODEL_PROVIDER=custom
CUSTOM_MODEL_API_BASE=https://api.deepseek.com/v1
CUSTOM_MODEL_API_KEY=sk-xxx（替换为您的 DeepSeek API Key）
3、在 LobeChat 管理后台的“模型设置”页面中，选择模型类型为 Custom OpenAI-Compatible API，并手动输入模型名称 deepseek-v4。
4、保存配置后重启 LobeChat 服务，进入聊天界面，点击右上角模型切换器，确认 deepseek-v4 已出现在可选列表中。
二、启用插件系统并加载 TTS 插件
LobeChat 的插件系统默认启用，但需显式安装并激活 TTS 类插件才能触发语音合成行为。插件可通过 npm 包或本地目录两种方式加载，推荐使用本地开发模式以保障兼容性与调试能力。
1、在 LobeChat 项目根目录下创建 plugins/tts-deepseek 子目录。
2、在该目录中新建 plugin.json，内容如下：
{ "name": "tts-deepseek", "displayName": "DeepSeek 语音朗读", "description": "适配 DeepSeek V4 回复内容的 TTS 播放", "icon": "?", "type": "tts" }
3、在同一目录下创建 index.ts，导出符合 LobeChat 插件规范的 TTS 处理逻辑，重点监听 onMessage 事件并过滤 role 为 assistant 且 content 非空的消息。
4、运行 npm run plugin:dev 启动插件热加载模式，确认控制台输出 Plugin 'tts-deepseek' loaded successfully。
三、配置 TTS 引擎与音色参数
TTS 插件需绑定具体语音合成后端。LobeChat 支持 Web Speech API、Azure Cognitive Services、Coqui TTS 与 @lobehub/tts 四类引擎。针对 DeepSeek V4 输出的中文长文本，建议优先选用 Coqui 或 Azure 以保障语义连贯性与发音准确性。
1、若使用 Coqui TTS，请确保已在服务器部署 coqui-tts 服务，并监听 http://localhost:5002。
2、在 .env 中添加 TTS 配置段：
TTS_ENGINE=coqui
TTS_COQUI_URL=http://localhost:5002/tts
TTS_VOICE=zh-CN-Xiaoyan
3、若改用 Azure，请填写以下三项：
TTS_ENGINE=azure
TTS_AZURE_REGION=eastasia
TTS_AZURE_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
4、保存后重启服务，在设置页“语音”标签中勾选 启用语音回复，并确认音色下拉菜单中已出现所配置的 voice 值。
四、验证 DeepSeek V4 与 TTS 联动效果
联动验证需确保消息流完整经过模型推理 → 插件拦截 → TTS 请求 → 浏览器播放四个阶段。此过程依赖于 LobeChat 内部事件总线与插件生命周期钩子，任何环节中断均会导致无声。
1、在聊天窗口发送一条测试问题，例如：请用中文写一段关于春天的短文。
2、观察浏览器开发者工具 Network 面板，筛选 /tts 请求，确认其 payload 中 text 字段包含 DeepSeek V4 返回的完整中文响应内容。
3、检查 Response Headers 中是否存在 Content-Type: audio/wav 或类似音频 MIME 类型。
4、若请求成功但无声音，检查浏览器标签页右上角扬声器图标是否高亮，以及系统音量与麦克风权限是否已授予 LobeChat 页面。
五、故障排查：常见无声/报错场景
当 DeepSeek V4 接入成功但 TTS 无响应时，可能由模型响应格式异常、插件未挂载、TTS 服务不可达或跨域限制导致。以下为三类独立排查路径：
1、检查模型返回结构：DeepSeek V4 的 JSON 响应必须包含 choices[0].message.content 字段，且值为字符串。若返回为 null、空数组或含 markdown 标签未清洗，TTS 插件将跳过处理。
2、强制重载插件：在终端执行 rm -rf node_modules/.cache/lobechat/plugins，再运行 npm run plugin:dev 重建插件缓存。
3、绕过服务端 TTS：临时将 TTS_ENGINE 改为 web-speech，并移除所有 TTS_* 自定义变量，验证是否为后端服务问题。
