huangdejie/dsh-speech-plugin
huangdejie★ 1TypeScriptLast synced: 2026-08-16
Speech plugin for DeepSeek Harness: per-message voice playback, auto-announce, and dictation via mic — cloud TTS/ASR on Alibaba DashScope or Volcengine (freely combinable), with Web Speech API fallback.
README excerpt
dsh-speech-plugin DeepSeek Harness 的语音插件:为每条助手消息提供「播报」、会话级「自动播报」开关,以及输入框的「语音输入」麦克风。云端 TTS/ASR 支持阿里百炼与火山豆包,播报与输入可各选一家;云端不可用时播报自动回退浏览器系统音色。以独立插件安装,不修改 harness 仓库任何源代码。 功能 - 🔊 每条消息播报 :点消息操作条的喇叭即朗读该条回复正文(自动剥离 markdown 与表情符号、跳过代码块和图片);朗读中再点即停止。 - 📣 自动播报 :会话头部的喇叭开关,开启后新完成的回复自动朗读,历史消息不播;偏好按浏览器本地存储,默认关闭。 - 🎤 语音输入 :点麦克风开始说话,识别结果实时写入输入框草稿;再点一次结束并发送,或直接点发送(发送即终止收音,不留尾巴、不继续消耗额度)。 - ☁️ 双引擎任意组合 :播报与语音输入各自独立选阿里百炼或火山豆包,也可都走同一家。 - 🔇 优雅回退 :云端凭据缺失、失效或失败时,播报自动回退浏览器系统音色,语音输入按钮禁用并提示原因,控制台均有日志。 快速开始 ① 安装 (任选其一): ② 取一个云端 key (二选一,见下方「凭据获取」): ③ 配置并重启 : 重启 dsh,打开 http://127.0.0.1:3080:点 🔊 播报消息;点 🎤 授权麦克风后说话。 只配一个 key、不写任何配置文件即可使用——引擎默认 auto ,按已有凭据自动选择(两家都有时百炼优先)。 凭据获取 家 入口 要点 阿里百炼 百炼控制台 → API-KEY sk- 开头; 一个 key 同时用于 TTS 与 ASR ;欠费(Arrearage)会拒一切调用 火山豆包 语音控制台 → API Key 管理 必须是控制台 API Key, 不是 应用级 Access Token(也无须 APP ID);开通的服务须与资源 ID 对应 配置 环境变量(共 2 个) 放哪都行:harness 仓库根目录 .env (源码运行,与 DEEPSEEK API KEY 同处)、 /.dsh/.env (全局安装)、或启动 dsh 的 shell 环境。注意变量名不要写成 DSH 开头(如 DSH SPEECH ):harness 启动层把 DSH 前缀保留为自举命名空间, .env 里出现任何 DSH 都会启动报错。 引擎组合(可选, /.dsh/profiles/web/cordis.patch.yml ) engine 与 asrEngine 完全独立。常用组合: 想要的效果 engine asrEngine 需要的 key 全自动(默认,零配置) auto auto 任一家的 播报阿里 + 输入火山 dashscope volcengine 两家的 播报火山 + 输入阿里 v…
View full README on GitHub →