loyalchiiina/dsh-voice-alert ↗★ 0
dsh-voice-alert
DSH 对话语音播报插件：每个 turn 结束自动播报「完成」，出现错误/工具失败播报「失败」；并在 DSH 原生设置页提供「语音播报」分区。**开箱即用**：默认「音效」模式内置 20 个音效（提醒 10 + 大自然 10），不需要任何 Key 或音频文件；想用自己的声音则到火山「声音复刻」克隆音色、填进音色库并一键生成三条语音（克隆/预设双路由、批量导入、试合验证）。v0.3.1 移除朗读面板；v0.3.2 设置页傻瓜化（中文优先字体、卡片分区、高级项折叠）；v0.3.3 音效提醒；v0.3.4 去具体人名（音色名由使用者备注）、音效可勾选列表、生成进度与成功提示、克隆入口网址；v0.3.5 修「第一声没声音」（实测根因=蓝牙 A2DP 挂起）：播放前静音预热 + 检查 MCI play 返回码；v0.3.6 界面常驻「没声音怎么办」提示；v0.3.7 强制重新生成改一次性；v0.3.8 预热与打开文件并行 + 毫秒级阶段日志；v0.3.9 备选 waveOut/WAV 播放内核（playerEngine=wav）；v0.4.0 开源准备：默认音色库为空、个人路径全部中性化、默认音效模式。winmm/MCI 原样播放，绝不改动系统音量或静音状态；播放进程经隐藏 powershell → Start-Process 独立拉起。 适合在AI运行长任务时离开屏幕，需要声音提醒任务状态的用户。
Other repositories with this package name
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:loyalchiiina/dsh-voice-alertREADME
Read the full README ↗5. 配置
\.dsh\data\dsh-voice-alert\config.json（首次启动自动写入默认值；不存在则用内置默认值，默认开启）。
优先级：内置默认值 \sfx| 内置音效目录（v0.3.3） | |playOnTurnEnd|true| 每个 turn 结束播一次 | |playFailOnError|true| 出错当下立即播失败（受节流约束） | |turnEndPlaysFailWhenErrored|true| 该 turn 已出错 → turn 结束只播失败 | |errorMinIntervalMs|5000| 错误播报最短间隔（fail 自身节流） | |suppressCompleteAfterFailMs|3000 | fail 播出后 N ms 内的 complete 一律抑制（断连声）；0关闭 | |abortPlays|"none" | 用户中断的 turn：none/complete/fail| |skipSubagentSessions|true| 子代理会话不播 | |countSubagentErrors|false| 子代理错误是否计入父会话 | |preferLoudAudio|true| 优先播放增益版（音量不低的那一档） | |loudSuffix/audioDir/originalsDir|-loud/\audio/ 原始目录 | 音频定位 | |pythonPath/playerScript/bundledPlayer| 见文件 | 播放器路径 | |fallbackBeep|true| 播不了时蜂鸣降级 | |controlFile/controlResultFile/statusFile|\control.txt/control-result.txt/status.json| 免凭据文件控制通道 | |controlPollMs|2000| 控制文件轮询间隔 | |logPath/logMaxBytes|\voice-alert.log/ 1MB | 插件日志 | |voices|[]（空库） | 音色库（完整数组，可被 /voices/save整体覆盖，手工添加重启不丢） | |selectedVoiceId|""| 当前选中音色（生成缺省用它；为空时需先在音色库点「设为当前」） | |presetApiKey|"" | 预设音色用的 Agent Plan Key（ark-…）；未配置时预设音色合成拒绝返回 preset-key-missing` |
环境变量覆盖：DSH_VOICE_ALERT_PYTHON / DSH_VOICE_ALERT_PLAYER / DSH_VOICE_ALERT_LOG / DSH_VOICE_ALERT_DISABLED=1。