Mac TTS

核心用法

mac-tts 封装了 macOS 原生 say 命令，提供离线文本转语音能力。基础用法为 say "文本内容"，可通过 -v 参数指定语音角色（如台湾中文 Meijia、简体 Tingting、英文 Samantha）。支持异步执行（加 & 后缀）避免阻塞，配合 AppleScript 可实现系统音量检测与调节。

显著优点

1. 零依赖离线运行：完全基于系统内置组件，无需安装额外软件或联网
2. 多语言原生支持：涵盖中文（台湾/简体）、英文、日文等，中文语音自然度优于多数免费 TTS 方案
3. 系统集成度高：可直接控制 Mac 扬声器输出，与通知系统无缝衔接
4. 极低资源占用：命令行工具轻量，适合脚本自动化与后台任务

潜在局限

• 平台锁定：仅限 macOS，跨平台迁移需重写
• 同步阻塞默认：未加 & 时脚本会等待语音结束，批量播报需注意性能
• 语音质量上限：虽自然度尚可，但逊于专业级 TTS（如 Azure、ElevenLabs）
• 无音频导出：纯播放功能，如需生成音频文件需配合 say -o 输出再处理

适合人群

Mac 开发者、自动化脚本用户、需要本地语音提醒的办公场景，尤其适合对隐私敏感（数据不出本地）、快速搭建通知系统的用户。

常规风险

• 音量突变惊吓：未预设音量时可能因系统音量过高/过低导致体验问题
• 误触多语言混读：文本语言与选定语音不匹配时发音怪异
• 异步进程管理：& 后台运行需自行控制，避免重复叠加播放

核心功能与用法

mac-tts 是一个极简的文档型 Skill，封装了 macOS 系统内置的 say 命令，用于本地文本转语音（TTS）输出。用户可通过指定语音包（如台湾中文「Meijia」、简体中文「Tingting」、英文「Samantha」等），将文字消息转化为语音播报，适用于通知提醒、会议倒计时、外卖送达等场景。

基础用法示例：

• 简单播报：say "Hello, this is a test"
• 指定语音：say -v "Meijia" "你好，這是測試"
• 查询可用语音：say -v "?" | grep zh_TW
• 后台异步执行：say "message" &

音量控制：配合 AppleScript 可实现静音检测、解除静音及音量调节（0-100）。

显著优点

1. 原生系统集成：直接调用 macOS 底层语音引擎，无需安装第三方 TTS 服务，延迟极低、音质稳定。
2. 多语言支持：内置中文（繁体/简体）、英文、日文等多国语音，切换便捷。
3. 零隐私风险：纯本地处理，无网络传输、无数据收集，符合 GDPR/CCPA 要求。
4. 零依赖负担：仅 Markdown 文档说明，无额外库或运行时依赖。
5. 开发友好：同步阻塞模式适合脚本编排，后台异步模式（&）适合非阻塞通知。

局限性与潜在缺点

• 平台锁定：仅限 macOS 系统，Linux/Windows 用户无法使用，跨平台项目需额外适配。
• 语音资源受限：依赖系统预装语音包，无法自定义声线或接入云端高质量神经网络语音。
• 阻塞执行默认：默认同步执行，未添加 & 时可能拖慢自动化流程。
• 缺乏状态反馈：say 命令无返回值，脚本难以确认语音是否实际播放（如静音状态下）。

适合人群

• macOS 重度用户，需为自动化脚本（如快捷指令、Alfred、Hammerspoon）添加语音反馈
• 开发者构建本地通知系统，偏好离线、隐私优先的方案
• 无障碍需求用户，希望快速实现屏幕文本朗读
• 智能家居爱好者，将 Mac 作为家庭中枢进行语音播报

常规风险与注意事项

• 环境误判：在非 macOS 环境执行会导致命令失败，建议先检测 uname 或 sw_vers。
• 音量与静音：系统静音时语音无输出，需配合 AppleScript 预检或强制解除静音。
• 并发冲突：频繁异步调用可能导致语音队列堆积，建议控制调用频率或等待前次完成。
• 来源可信度：维护者为个人开发者标识符（T3 级），建议通过可信渠道获取并审查更新。

安全认证摘要

CLS-Certify 六维扫描获得 S+ 顶级安全评级，静态/动态分析、依赖审计、网络分析、隐私合规、威胁情报均通过，无恶意代码、无外部网络调用、无第三方依赖。