name: mac-tingting
description: 调用 macOS 系统内置的“听写与语音”功能中的“Ting-Ting”（中文）语音合成引擎，将文本实时转换为自然流畅的中文语音并播放。
version: 1.0.0
author: Skills Team
tags:
- tts
- voice
- macos
- accessibility
- chinese
- audio
category: system-integration
priority: 7

macOS Ting-Ting 语音合成技能

mac-tingting 是一个深度集成 macOS 系统能力的语音合成（Text-to-Speech, TTS）工具。它直接调用 Apple 原生的 Ting-Ting（中文）语音引擎，无需联网即可将任何文本内容转换为清晰、自然且富有表现力的中文语音，并通过系统扬声器即时播放。

🎯 核心功能

1. 高质量中文语音合成

• 原生系统引擎：利用 macOS 内置的 Ting-Ting 语音，发音标准，语调自然。
• 离线工作：完全依赖本地系统资源，无需网络连接，保障隐私与响应速度。
• 即时播放：文本提交后立即开始语音播报，延迟极低。

2. 简单易用的交互

• 纯文本输入：接受任意长度的中文或中英文混合文本。
• 一键播报：单次调用即可完成从文本到语音的完整流程。
• 无缝集成：作为系统级技能，可与其他工作流（如阅读、提醒、学习）完美结合。

3. 辅助与无障碍支持

• 视觉辅助：为视力障碍用户提供信息听取能力。
• 多任务助手：在用户进行其他操作（如编码、设计）时，通过听觉传递信息。
• 语言学习：帮助用户练习和校正中文发音。

📋 使用场景

信息播报

用户指令：“用Ting-Ting读出今天的待办事项。”
技能执行：将待办列表文本发送给Ting-Ting引擎并播放。

内容审阅

用户指令：“请朗读我刚写完的这份报告。”
技能执行：将报告全文转换为语音，让用户通过听觉进行校对。

无障碍访问

用户指令：“把屏幕上的通知念给我听。”
技能执行：提取通知文本并通过Ting-Ting语音播报。

语言学习

用户指令：“用标准中文读一遍‘你好，世界’。”
技能执行：使用Ting-Ting引擎清晰地朗读指定句子。

🔧 技术细节

系统要求

• 操作系统: macOS (需已安装并启用 “Ting-Ting” 中文语音)
• 依赖: 无外部依赖，纯调用系统 say 命令或 NSSpeechSynthesizer API。

调用方式

# 伪代码示例
mac_tingting(text="你好，这是由Ting-Ting朗读的内容。")

输入/输出

• 输入: text (str) - 需要朗读的文本内容。
• 输出: 无返回值（副作用为系统播放语音）。

🎓 最佳实践

DO - 应该这样做

✅ 用于朗读结构化信息

“朗读以下会议纪要：...”

✅ 作为多模态输出的一部分

在生成文本摘要后，自动调用此技能进行语音播报。

✅ 提供清晰的文本

确保输入文本语法正确，以获得最佳发音效果。

DON'T - 避免这样做

❌ 传入超长或格式混乱的文本

过长的文本可能导致播报时间过久；包含大量特殊符号的文本可能影响发音。

❌ 期望其处理非中文文本

虽然能处理中英文混合，但纯英文内容建议使用 Alex 或 Samantha 等英文引擎以获得更佳效果。

🛡️ 注意事项

• 语音可用性：请确保您的 macOS 系统已在 系统设置 > 辅助功能 > 语音 中下载并启用了 Ting-Ting 语音。
• 无网络依赖：此技能完全在本地运行，不收集或传输任何用户数据。
• 音量控制：语音播放音量由系统主音量控制。

🔗 与其他工具配合

技能组合建议

智能阅读助手：
1. Web Search：获取新闻或文章。
2. Summarizer：生成摘要。
3. mac-tingting：将摘要朗读给用户。

无障碍工作流：
1. OCR：从截图中提取文字。
2. mac-tingting：将提取的文字朗读出来。

🎉 总结

mac-tingting 技能将 macOS 强大的原生语音合成能力封装为一个简单易用的工具，让您能通过自然的中文语音与信息交互，极大地提升了信息消费的效率和无障碍体验。