让 AI 开口说话:plugins-for-claude-natives 的 say-summary 插件如何用 macOS TTS 自动播报 Claude 回答
让 AI 开口说话:plugins-for-claude-natives 的 say-summary 插件如何用 macOS TTS 自动播报 Claude 回答
你是否还在逐字阅读终端里的长回答?plugins-for-claude-natives 仓库中的 say-summary 插件,利用 macOS 自带的 TTS(文本转语音)功能,在 Claude 每次回答结束后自动把结果总结成一句简短"标题"并大声播报出来。写代码时戴上耳机,无需切窗口、无需读屏幕,AI 的答案直接"说"给你听。
一、say-summary 是什么?
say-summary 是 plugins-for-claude-natives 项目里一个轻量级的 Claude Code 插件,核心能力有 4 个:
- 🎙️ 自动总结:调用 Claude Haiku 模型,把回答压缩成 3-10 个词的短标题
- 🔊 自动播报:调用 macOS 原生
say命令朗读总结 - 🌏 双语识别:自动检测韩文/英文,韩语用 Yuna 语音、英语用 Samantha 语音
- ⚡ 后台运行:不阻塞 Claude Code 的正常工作流
安装完成后,你只需要正常使用 Claude Code,每次回答结束时 Mac 就会自动"开口":
二、三步安装说人话:say-summary 插件安装教程
1. 添加插件市场
打开 Claude Code,执行:
/plugin marketplace add team-attention/plugins-for-claude-natives
2. 安装 say-summary 插件
/plugin install say-summary
3. 运行一次依赖安装脚本
插件需要一个 Python SDK 依赖,运行一次即可:
~/.claude/plugins/say-summary/scripts/setup.sh
该脚本(见 setup.sh)会检查 pip3 是否可用,并自动执行 pip3 install --user claude-agent-sdk。也可以手动安装:
pip3 install --user claude-agent-sdk
⚠️ 环境要求:macOS(依赖系统
say命令)、Python 3.10+、已安装 Claude Code CLI。Linux / Windows 用户暂不支持。
三、工作原理:Stop hook + Haiku 摘要 + say 命令
整个流程在 say-summary.py 中实现,由一个 Stop hook 触发——即"Claude 停止输出时"自动执行的钩子。流程如下:
Claude 回答结束 (Stop hook 触发)
│
▼
1. 定位当前项目的会话转录文件 (~/.claude/projects/xxx/*.jsonl)
│
▼
2. 提取最后一条 assistant 消息
│
├── 少于 10 词 ──→ 直接朗读
│
└── 超过 10 词 ──→ 调 Claude Haiku 生成 3-10 词标题
│
▼
3. 检测语言,选择 Yuna / Samantha 语音
│
▼
4. say -r 190 <总结> 后台朗读
hook 的注册配置在 hooks.json 中,超时时间设为 30 秒,且朗读通过 nohup 放入后台,因此不会卡住你的终端。
四、默认配置一览
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 语速 | 190 词/分钟 | 由 say -r 190 控制,语速自然 |
| 摘要模型 | Claude Haiku | 轻量快速,成本低 |
| 韩语语音 | Yuna | 检测到韩文字符时自动切换 |
| 英语语音 | Samantha | 默认语音 |
五、不响了吗?看这里
插件的所有运行日志都写在 /tmp/speak-hook.log,排查问题时直接查看:
tail -f /tmp/speak-hook.log
常见问题速查:
- 🔇 完全没声音:确认在 macOS 上运行,且系统"声音"设置中音量未静音
- 🐍 依赖报错:重新运行
setup.sh安装claude-agent-sdk - 🌐 中文内容:插件目前按"含韩文用 Yuna,否则用 Samantha"的策略选语音,中文回答会以英语语音朗读
六、总结
say-summary 用不到 100 行 Python,就实现了"Claude 答完自动播报"的体验升级:Stop hook 负责时机、Claude Haiku 负责总结、macOS say 负责发声,各司其职。如果你经常边写代码边听播客、或者更喜欢"听"而不是"读",这个插件值得一试——让 AI 的回答,真正"开口说话"。
更多插件详情可参阅 say-summary 插件文档 和 项目总览 README。
