Obsidian TTS

中文|English 将 Obsidian 笔记内容转换为语音，支持 MiniMax 和 小米 MiMo 两大 TTS 引擎。

功能特性

TTS 引擎

引擎	模型	音色	特色功能
MiniMax	speech-2.8-hd / 2.8-turbo / 2.6-hd / 2.6-turbo	10 种预置音色 + 自定义克隆音色	情感控制（9 种）、音调调节、音量控制
小米 MiMo	mimo-v2-tts	3 种预置音色	方言风格（东北话、四川话、粤语等 10 种）

播放控制

• 朗读选中文本 / 朗读整个文档
• 播放、暂停、停止、跳转进度
• 可拖拽的浮动播放器，显示进度条和时间
• 状态栏快捷按钮
• 长文本自动分段朗读

音频导出

• 导出为 MP3 文件保存到库中
• 在笔记中插入 ![[audio.mp3]] 音频嵌入
• 自定义导出目录和文件名格式（支持 noteName、timestamp 变量）

文本处理

• 自动跳过代码块、LaTeX 公式、HTML 标签
• Markdown 标记自动清理
• 智能分段（按段落、句子、字符数）

MiniMax 音色克隆

• 上传 10 秒 ~ 5 分钟的音频文件克隆音色
• 克隆音色自动出现在音色选择列表中
• 支持删除已克隆音色

右键菜单

在编辑器中右键可快速访问：

• TTS: 朗读选中文本
• TTS: 朗读整个文档
• TTS: 插入音频到笔记

安装

1. 手动安装：将 main.js、manifest.json、styles.css 复制到 .obsidian/plugins/obsidian-tts-plugin/ 目录

配置

MiniMax

1. 在 MiniMax 平台 获取 API Key
2. 在插件设置中填入 API Key
3. 选择模型、音色、语速等参数

小米 MiMo

1. 在小米MIMO平台获取API Key
2. 在插件设置中选择「小米 TTS」引擎
3. 填入 API Key 和 Base URL
4. 选择音色和风格

快捷命令

通过命令面板（Ctrl/Cmd + P）可使用以下命令：

命令	说明
朗读选中文本	朗读当前选中的文本
朗读整个文档	朗读当前笔记的全部内容
播放/暂停	切换播放状态
停止播放	停止当前播放
显示/隐藏浮动播放器	切换播放器面板
导出音频文件	生成音频并保存到库中
插入音频到笔记	生成音频并在笔记中插入嵌入引用