本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-omi-voice

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-omi-voice

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 🔊 点读；播放中再点 = 暂停，再点 = 从暂停处继续；点其它消息的 🔊 = 打断并读新的。
• 只读最终回答：工具执行日志、思考过程不会读；代码围栏、表格、纯图形（盒绘/ASCII）在请求前过滤，回复若只有这些内容，按钮呈禁用态并提示"没有可朗读的内容"。
• 引擎未启动 / 未配置 Key 时，点击会给出明确提示（含去哪打开 Omi）。
• 只有手动点 🔊 才合成，不自动朗读；
• 引擎对相同文本 3 秒内去重，且进程内 LRU 缓存最近 3 条（≤5MB、纯内存、退出即清），重复朗读不重复计费；

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

点击 🔊 提示"未检测到 Omi DSH 引擎"怎么办？

Omi 引擎未启动或被关闭。请打开应用「Omi DSH」（位于应用程序文件夹或 ⌘空格 搜索「Omi」），并建议在设置里开启「开机启动」。引擎未运行时按钮本身可以显示，但任何朗读请求都会因为连接失败而提示。

提示"请先在 Omi 设置页配置豆包 API Key"如何处理？

引擎已运行但尚未写入豆包 API Key。打开「Omi DSH」设置页的「API Key」项，按 README「获取豆包 API Key」三步拿 Key 并保存到 Keychain；插件自身没有任何 Key 输入入口。

按钮变灰、点击没反应是为什么？

该回复经引擎清洗后没有可朗读的有效内容，例如纯代码围栏、纯表格或盒绘/ASCII 图形。v0.1.1 起该状态显示为禁用态而非隐藏，并提示「这条回复没有可朗读的内容」。

能否切换豆包音色？插件里有音色 UI 吗？

引擎设置页提供「音色 ID」字段（默认 zh_female_shuangkuaisisi_moon_bigtts），v1 协议下插件侧不提供音色选择 UI，需到 Omi 引擎设置里改。/v1/voices 音色列表接口在协议文档中标记为 v1.1 预留。

支持 Windows 或 Linux 吗？

不支持。引擎仅面向 macOS 13+ 的 Apple Silicon Mac，从源码构建；插件（JS 端）虽然能在任意 dsh web 里加载，但失去 macOS 引擎后无法合成语音。

和 dsh-voice-chat 之类的零配置朗读插件有什么差别？

零配置类插件用系统自带语音合成，不需要任何 Key、音色偏机械且通常按整段读；本插件用豆包 TTS 自然音色并按清洗后的最终回答朗读，代价是 BYOK、按字符计费、需要本地常驻一个 macOS 引擎。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则