wquguru/cicada

项目介绍

知了是一款 macOS 菜单栏应用，直接读取 Mac 正在播放的系统声音，为任意会议或直播生成实时双语字幕、边听边整理的结构化纪要，并可选做同声传译。它不往会议里塞机器人，所以 Zoom、飞书、腾讯会议、X Spaces、YouTube 都能用。语音识别、语言识别和录音在 Apple SpeechAnalyzer/SpeechTranscriber 上本机完成，只有识别出的文字会发出去做翻译和生成纪要。

会议记录把双语文字记录、纪要和原始录音存在 ~/Library/Application Support/LiveSubs，可导出为 Markdown、Word 和 SRT。说话人识别是可选的实验功能，使用随 app 附带的 WeSpeaker ResNet34-LM Core ML 模型在本机运行。

快速使用

1. 确认设备：macOS 26 或更新版本、Apple 芯片的 Mac。
2. 从 Releases 页面 或 官网 下载 Cicada-<版本>-macOS-AppleSilicon.dmg，用 shasum -a 256 Cicada-*.dmg 对照下载页的 checksums.txt 核对后，把应用拖进应用程序文件夹。
3. 应用目前是本地签名、未公证，第一次打开被拦下时去系统设置的隐私与安全性里点仍要打开。
4. 跟着首次引导授予录制系统声音权限，播放内置的双人示例会议即可看到双语字幕，再决定是否接入 Ling key。
5. 要用同声传译时按提示安装 BlackHole 2ch 虚拟麦克风，之后按住键盘右边的 ⌥ 键说话，对方就能在会里听到翻译后的语音。

从源码构建不需要第三方依赖：装好 Xcode Command Line Tools 后运行 scripts/build.sh 编译出 build/Cicada.app，再 open build/Cicada.app 启动。

Ling API 与联网范围

实时纪要、一步语音翻译和声音克隆需要自己的 Ling API key，在 Ling 开放平台 创建后粘贴到设置里的 AI 服务。README 估算开会一小时约花 0.15 到 1 元人民币，Ling 每月赠送 10 元额度，约够 10 到 50 小时。不填 key 时，实时字幕、翻译（走 Google，退回 Apple 本机翻译）、会议记录和用 Mac 自带语音的同声传译仍然可用，只是没有纪要。

会联网的只有翻译、Ling/Ming 接口、BlackHole 驱动下载和每天一次检查 GitHub 新版本；应用没有统计、埋点或自建服务器。录制系统声音、麦克风、输入监控（只判断右 ⌥ 单独按下）和安装 BlackHole 所需的管理员密码这几项权限，README 说明按功能分别请求，拒绝一项不影响其他功能。

使用约束

• 仅支持 macOS 26 及以上、Apple 芯片。
• 当前版本未公证，首次启动需要在隐私与安全性里手动放行。
• 文字记录目前只包含按住说话键说的话，会上直接开口的部分尚未记录。
• 路线图包括记录自己的发言、支持 macOS 14.4 起、正式签名公证、声纹识别、无 key 的本机纪要和 Windows/Android；iPhone/iPad 因系统限制暂不计划。

HotRepo 点评

该项目在 2026-11-03 进入 HotRepo 新项目榜，在记录的 1 小时窗口内从 170 Star 增至 243，新增 73 Star、18 Fork，但没有记录到 GitHub 全部语言日榜名次。它值得注意的地方不是规模，而是具体的 macOS 原生路线：直接采集系统音频、把权限和隐私逐项列清、并明确说明不填 key 也能用哪些功能。读者需要自己权衡的是未公证分发和对 Ling 的依赖——这两点 README 都写进了路线图，而不是隐藏起来。