cue 是一个开源 macOS 桌面 AI Copilot，基于 Electron/JavaScript 构建。它以悬浮透明面板形式覆盖在屏幕上，可读取屏幕内容、麦克风输入和会议系统音频，并调用用户自带的 OpenAI、Anthropic Claude 或 Google Gemini API，在会议、学习、编程题解答等场景中实时提供辅助。项目定位类似 Cluely 的自托管替代品，强调本地运行、无账号、无服务器、无遥测，但其“屏幕共享中隐藏”能力只是 macOS 内容保护机制的尽力而为，并不保证可靠。
适用领域
AI 桌面助手 / 会议辅助 / 实时语音转写 / 屏幕理解 / 编程题辅助 / Electron 桌面应用 / macOS 工具 / BYOK 自带 API Key 应用
配置难度
中等。普通用户可通过 Releases 安装，但需要处理 macOS 安全提示、麦克风/屏幕录制权限、AI API Key、Zoom 特定设置等问题。开发者运行源码较简单，只需 Node.js 18+、npm install 和 npm start；但若要理解或改造屏幕采集、系统音频捕获、实时转写和多模型流式调用，则需要熟悉 Electron、macOS 权限模型和 LLM API。
商业价值
该项目对个人效率、会议辅助、学习和开发者研究有较高价值，尤其适合探索“本地桌面 AI Copilot + BYOK + 多模态输入”的产品形态。对商业团队而言，它可作为快速原型或技术参考，用于验证屏幕理解、实时会议辅助、AI 编程助手等方向。但由于 GPL-3.0 许可证、隐私合规、潜在滥用场景以及屏幕隐藏能力不可靠，直接商业化或用于高合规行业需要谨慎评估。
01
技术亮点
- 开源且自托管，无账号、无后端服务、无遥测。
- 支持 OpenAI、Anthropic Claude、Google Gemini 多模型提供商。
- 支持屏幕、麦克风、系统会议音频三类输入，并将“你”和“对方”的音频通道区分处理。
- 提供会议实时辅助、总结、追问、自由问答和编程题求解等功能。
- Electron 架构简单，README 说明 main.js、renderer、src/providers 等结构，适合二次开发和学习。
- 悬浮面板支持透明、置顶、点击穿透，适合桌面实时辅助。
- 使用 macOS setContentProtection(true) / NSWindowSharingNone 尝试避免被屏幕共享捕获。
- BYOK 模式降低项目方数据风险，费用由用户直接支付给模型服务商。
02
目标用户
- 需要在会议中快速整理回答、总结和追问的知识工作者
- 希望使用自带模型 API 的开发者和技术用户
- 需要屏幕内容辅助理解、笔记、学习或无障碍支持的 macOS 用户
- 希望研究 Cluely、Interview Coder、Glass 类工具实现方式的开发者
- 需要开源、自托管 AI 桌面助手原型的团队
03
配置要求
- 操作系统：macOS，项目主要面向 macOS 桌面环境。
- 运行源码需要 Node.js 18+。
- 需要授予 macOS Microphone 权限，用于采集用户麦克风。
- 需要授予 macOS Screen Recording 权限，用于屏幕截图和会议系统音频采集。
- 需要配置至少一个 AI Provider API Key：OpenAI、Anthropic Claude 或 Google Gemini。
- 如需语音转写功能，OpenAI Key 必须具备 Whisper/audio 权限；Claude 不提供语音转文字能力，因此需要额外配置 OpenAI 或 Gemini。
- Google Gemini Key 可同时用于聊天和转写。
- Zoom 中如果希望尽量隐藏 cue，需要设置：Zoom Settings → Share Screen → Screen capture mode → Advanced capture with window filtering。
- API Key 存储在本地 cue-data.json 文件中，不经过项目自有服务器。
04
适用场景
- 在线会议中根据对方发言生成“我该怎么说”的建议
- 对会议内容进行实时转写、总结、生成 follow-up questions
- 截取当前屏幕中的编程题并生成解法、代码和复杂度分析
- 根据当前屏幕和最近对话回答用户临时问题
- 作为 macOS Electron 悬浮窗、屏幕采集、音频采集、LLM 调用的学习项目
- 用于个人学习、练习面试、整理笔记或无障碍辅助
05
部署与配置
- 方式 A：从 GitHub Releases 下载 cue-mac.zip。
- 解压后得到 cue.app，并拖入 Applications 文件夹。
- 首次打开时右键 cue.app，选择 Open，再确认 Open。
- 如果 macOS 提示“cue is damaged and can't be opened”，在终端执行：xattr -cr /Applications/cue.app，然后重新打开。
- 方式 B：开发者可从源码运行，要求 Node.js 18+。
- 执行：git clone https://github.com/Blueturboguy07/cue.git
- 进入目录：cd cue
- 安装依赖：npm install
- 启动开发版本：npm start
- 如需自行打包：npm run pack，生成 dist/mac-arm64/cue.app。
06
风险与注意事项
- 隐藏屏幕共享并不可靠，尤其在 macOS 15.4+ 或部分现代采集工具中可能失效；手机拍摄也无法避免。
- 在考试、面试、受监管会议或录制会议中使用可能违反平台规则、诚信要求或当地同意录音相关法律。
- 需要将屏幕截图和音频发送给第三方 AI Provider，虽然项目本身不收集数据，但仍存在供应商侧隐私与合规风险。
- 项目使用 GPL-3.0 许可证，企业集成或二次分发时需要注意开源合规义务。
- macOS 权限与 ad-hoc 签名可能导致用户体验问题；重新打包后权限可能需要重新授权。
- 依赖外部模型 API，成本、延迟、可用性和模型权限受供应商影响。
- 会议音频捕获、转写和实时响应链路较复杂，可能存在稳定性、延迟或权限失败问题。
- 项目明确提及 Cluely、Interview Coder 等场景，可能在部分组织或教育场景中被视为高风险工具。
2026-07-22
第8名
新收录 · github_search
2026-07-21
第8名
新收录 · github_search
2026-07-20
第12名
新收录 · github_search
2026-07-19
第16名
新收录 · github_search
2026-07-18
第16名
新收录 · github_search
