social
dsh-xiaomi-tts
为 DSH Web 添加 Xiaomi MiMo TTS 语音朗读。
基于 Xiaomi MiMo TTS，将文字转为流畅、清晰的自然语音。MiMo TTS 当前为限时免费服务，具体政策请关注官方平台。
English README →
🎨 预览
🧐 Preview Pages 预览本插件
✨ 功能
- 一键播报：在对话操作栏中显示“朗读”按钮（默认开启）。
- 内置音色：使用
mimo-v2.5-tts 输出流畅、清晰的音频，并支持流式播放。
- 倍速播放：支持 0.5×–2.0× 调整播放语速，设置会作用于 MiMo 和浏览器本地语音。
- 自定义音色：使用
mimo-v2.5-tts-voicedesign 通过文字描述创造你想要的声音。
- 浏览器本地音色：使用浏览器宿主提供的离线或在线音色。
- 自动清洗文本：移除网址、文件路径、代码块、表情符号、图标和控制字符等。
- 音效库：提供全局语义点击音效，以及当前任务开始、成功、失败和待处理提醒音效。
📋 环境要求
@deepseek-ai/dsh 0.1.5-rc.1（当前插件仅适配此版本）- Node.js 22+
- Xiaomi MiMo API Key
- 官方 TTS API 文档
🚀 安装与使用
dsh plugin --profile web add dsh-xiaomi-tts
打开 设置 → 插件市场，搜索 xiaomi-mimo-tts 并点击安装。
- 让 DSH 或 任意AI Agent 帮你装——把下面这段提示词发给AI
帮我给此电脑上的dsh安装 dsh-xiaomi-tts 插件。
1. 优先通过命令安装 dsh plugin --profile web add dsh-xiaomi-tts@latest
2. 如果失败，请尝试源码 https://github.com/ppy-web/dsh-plugin-xiaomi-mimo-tts
dsh plugin --profile web add github:ppy-web/dsh-plugin-xiaomi-mimo-tts
- 从 GitHub Release 下载
.tgz 后安装：
dsh plugin --profile web add "<下载路径>\dsh-xiaomi-tts-<版本>.tgz"
Release tgz 已包含构建产物，无需执行 pnpm approve-builds。
安装后重启 dsh web，打开 设置 → 插件 → 插件配置 → 语音朗读(Xiaomi MiMo)
获取并填写 API Key 。支持标准API Key / Token Plan 专属 API key
修改任意设置后需要点击 保存 生效。
音效库
在语音设置卡的 演播厅 下方，可以控制音效开关、音量、音色包、点击音效和任务音效，并试听常用提示音。音效由浏览器 Web Audio 合成，不会请求网络或保存音频文件。
⚙️ 配置
官方内置音色（mimo-v2.5-tts）：
- 中文女声：
冰糖、茉莉
- 中文男声：
苏打、白桦
- 英文女声：
Mia、Chloe
- 英文男声：
Milo、Dean
自定义音色（mimo-v2.5-tts-voicedesign）
提供了常用音色描述模板；用户可以直接修改并保存描述。
青年女性，声线清亮、亲切自然，吐字清楚，语速适中，情绪温柔克制。
浏览器本地兜底语音
支持三种策略：“MiMo 优先”在 MiMo 失败时改用浏览器语音；“本地优先”优先使用浏览器语音；“关闭本地语音”仅使用 MiMo。
可选音色来自浏览器 Web Speech API，是否离线及实际可用范围取决于浏览器、操作系统和网络服务。
朗读范围
- 智能选择：自动播报优先朗读回复的首个语义段；手动点击“朗读”时播放全文。短回复没有可拆分的段落时会完整播放。
- 全文模式：自动播报和手动朗读都播放全文。
- 首段模式：自动播报和手动朗读都只播放首个语义段。
设置面板支持键盘操作：按 Tab 在控件间移动，使用方向键调整滑块或切换选项，按空格确认当前操作。
🔌 三方插件联动
whale-girls
我们对外暴露了PCM流式播放能力。
Web 插件可以直接调用本插件的服务进行流式播放。可直接在需要播放的位置写一行：
ctx.get('xiaomiMimoTts')?.play('欢迎回来')
建议通过 ctx.get() 动态获取这项能力，不必声明为必需的 inject 服务。插件未安装或未就绪时调用会安全跳过；play() 使用用户已保存的 MiMo 设置播放 PCM 流，stop() 可主动停止。新播放会自动打断当前朗读。
需要 TypeScript 类型提示时可仅导入类型：
import type { XiaomiMimoTtsService } from 'dsh-xiaomi-tts/client-api'
const tts = ctx.get('xiaomiMimoTts') as XiaomiMimoTtsService | undefined
tts?.play('欢迎回来')
🔒 隐私
- API Key 保存在 DSH Host，不会发送给浏览器。
- 生成语音时，正文会被发送给 Xiaomi MiMo 服务。
- 音频在浏览器内存中通过 Web Audio 或临时 Blob URL 播放，不会持久化到磁盘。
- 音效核心移植自 uisfx 0.4.0，遵循 MIT License，详见
NOTICE。
🏗️ 架构
- 共享层：统一配置、文本清理、分段和 SSE 契约。
- Host 插件：管理设置与静态资源，并代理 MiMo 完整音频和 PCM 流式请求。
- Web Client：提供设置与朗读入口，负责播放状态、浏览器语音兜底和第三方播放服务。
flowchart LR
DSH["DSH Web"] --> CLIENT["Web Client<br/>设置与播放"]
THIRD["第三方 Web 插件"] -. "ctx.get('xiaomiMimoTts')" .-> CLIENT
CLIENT -->|"完整音频 / PCM 流"| HOST["Host 插件<br/>设置与 API 代理"]
HOST --> MIMO["Xiaomi MiMo API"]
CLIENT -->|"本地语音兜底"| SPEECH["浏览器 Web Speech API"]
SHARED["共享层<br/>配置、文本处理、SSE"] -.-> CLIENT
SHARED -.-> HOST
🛠️ 开发
修改设置面板时运行：
pnpm dev
命令会打开本地 UI 预览壳，直接渲染 src/client/settings-card.tsx 并热更新。
pnpm install
pnpm typecheck
pnpm test
pnpm pack:check
日常构建使用 pnpm build。
排查 PCM 流式链路时使用 pnpm build:debug。
windows用户从本地开发版切换到 npm 版时，请先停止 DSH Web，避免 Windows Junction 被运行中的 Node 进程占用：
.\start\dsh-plugin-reinstall.bat 3.0.3
🤝 推荐
本插件的鲸鱼娘形象参考 dsh-deep-whale dsh-whale-musume由GPT生成。本插件的uisfx音效参考 dsh-plugin-uisfx实现
