让 AI 开口说话:plugins-for-claude-natives 的 say-summary 插件如何用 macOS TTS 自动播报 Claude 回答

原创2026-10-27 12:23:391,380 阅读

让 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 插件演示:Claude 回答结束后 macOS 自动语音播报

二、三步安装说人话: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。

登录后查看全文
plugins-for-claude-natives