DSH Voice Chat — 语音输入 + 朗读回复插件
给 DeepSeek Harness Web 界面增加语音对话能力：
- 🎤 语音输入：说中文自动识别填入输入框（Web Speech API，零服务端/零密钥）
- 🔊 朗读回复：每条 AI 回复可朗读（TTS），并支持自动朗读（默认开启）
- ⚙️ 语音设置：人声选择、语速、语调，识别语言（普通话/粤语/台湾国语/英语）
纯 Client 插件，无服务端、无 API Key、无模型下载（浏览器自带语音引擎）。
功能
- 🎤 语音输入：点击输入框旁的 🎤，说出内容，识别文字自动填入（实时中间结果 + 可编辑后再发送）
- 🔊 朗读回复：每条 AI 回复旁有 🔊 按钮，点击朗读该条回复，再点停止
- 🔁 自动朗读：每条新回复生成后自动朗读（默认开），按会话消息序号判断新旧，历史消息/刷新页面不会重读；⚙️ 面板一键关闭
- 🗣️ 人声选择：从浏览器全部语音里选（默认中文优先，如 Microsoft Huihui）
- ⏩ 语速 / 🎼 语调：滑杆实时调节（0.5~2.0 / 0~2.0）
- 🌏 识别语言：普通话 zh-CN / 粤语 zh-HK / 台湾国语 zh-TW / 英语 en-US
- 🧹 朗读文本清理：自动剥掉 Markdown 标记（粗体、*斜体*、
代码、# 标题、列表、表格、链接等），避免 TTS 读出"星号星号"等噪音 - 💾 所有设置存 localStorage，刷新后保留
安装
一条命令（git 源，产物已入库，无需构建）：
dsh plugin --profile web add "github:lak321/dsh-voice-chat#<commit>&path:/"> <commit> 换成最新提交号（见仓库主页）。或本地目录：cd dsh-voice-chat && dsh plugin --profile web add .
装完重启 DSH（npx -y @deepseek-ai/dsh web），浏览器打开后输入框旁出现 🎤 和 ⚙️ 按钮，每条 AI 回复旁出现 🔊 按钮。
> 兼容 DSH Profile：web。 > 旧的手动复制 client/ 并注入 cordis.patch.yml 的方式已废弃，由 bundle 层栈安装替代。
使用
1. 🎤 语音输入：点 🎤 → 说话 → 文字自动填入输入框 → 编辑/直接发送 2. 🔊 朗读：点回复旁的 🔊 朗读该条；朗读中再点停止 3. ⚙️ 设置：自动朗读开关、人声、语速、语调、识别语言
工作原理
- Client 插件：通过
ctx.slots.inject注册两个 slot：
- conversation.input.left（🎤 voice-input order 5、⚙️ voice-settings order 8） - conversation.chat.assistant-actions（🔊 voice-speak order 5）
- 语音输入：
SpeechRecognition（zh-CN，interim 实时结果 + maxAlternatives 5），识别结果inputActions.setDraft() - 朗读：
speechSynthesis+ 中文语音；getVoices()异步 → 监听 voiceschanged 事件 + 500ms 轮询兜底（3s 上限） - 自动朗读去重：
localStorage记录每个会话已朗读到的最大消息 seq，只朗读比它新的回复 - 文本提取：从会话快照
snapshot.nodes找{kind:'assistant', messageId, blocks:[{kind:'text',text}]}节点
开发要点（踩坑记录）
props.useSession是 React Hook，必须在组件函数体顶层调用，绝不能在 onClick 里调用（否则报 React #321 Invalid hook call，点击无反应）。selector 需返回原语（字符串/数字），避免重渲染风暴。- client 插件必须导出
exports.inject（依赖列表，如["slots"]），否则ctx.slots不可用、apply 静默失效。 - client.js 是
window.__ModuleLoader__.load({id, factory})格式，factory 内require("react")，导出exports.apply/exports.inject。 - 改 client.js 后无需重建 Web 包：HTTP 拉取即新内容，浏览器 Ctrl+F5 刷新生效。
License
MIT