Logue

macOS 上隐私优先的 AI 会议笔记与写作助手。
设备端语音转录、Smart Minutes 以及 60 多种写作模式 —— 全部由 Apple Silicon 驱动。数据绝不离开你的 Mac。

下载 macOS 版  •  从源码构建  •  贡献指南  •  功能请求

## 简介 Logue 是 macOS 上的一款隐私优先的 AI 会议笔记和写作助手。它结合了实时音频转录、说话人分离（speaker diarization）和智能文档编辑 —— 所有这些功能完全**由 Apple Silicon 上的 MLX 在设备端驱动**。默认情况下，你的会议、笔记和对话都会保留在你的 Mac 上 —— 唯一的网络调用仅用于设备端模型下载、更新检查，以及你明确启用的可选功能（如网页搜索和外部 AI 提供商）。 本仓库包含完整的 Logue 应用源代码：LLM 引擎、录制 pipeline、Agentic AI 聊天、写作编辑器以及测试套件。[Bitwize](https://bitwize.ai) 开发 Logue，旨在为希望在享受 AI 全部强大功能的同时兼顾隐私的专业人士和学生提供服务。 ## 目录 - [✨ 功能](#-features) - [🖼 截图](#-screenshots) - [📥 安装（普通用户）](#-install-users) - [🚀 从源码构建](#-build-from-source) - [⚙️ 配置](#-configuration) - [📚 文档](#-documentation) - [🗺 项目布局](#-project-layout) - [👏 贡献](#-contributing) - [❓ 常见问题](#-faq) - [📄 许可证](#-license) ## ✨ 功能 ### 🎙 会议智能 - **实时转录** —— 由 Apple 的 `SpeechTranscriber` (macOS 26+) 驱动，直接流式传输音频，无缓冲延迟 - **说话人分离** —— 使用 FluidAudio 的 Sortformer 模型识别并标记各个说话人，并带有批处理回退机制以确保准确性 - **系统音频捕获** —— 通过 ScreenCaptureKit 同时录制麦克风和系统音频；无需会议机器人加入你的通话 - **Smart Minutes** —— 生成包含关键决策、主题和后续事项的结构化摘要 - **智能转录高亮** —— AI 自动提取最重要的时刻；手动书签将始终保留 - **待办事项提取** —— 自动从转录文本中提取任务、负责人和截止日期 - **会议准备简报** —— 会议开始前，基于链接的文档和以前的笔记，由 AI 生成上下文简报 - **会议 ↔ 文档链接** —— 会议与相关文档之间的双向链接，并在编辑器中显示反向链接标记 ### ✍️ AI 写作编辑器 - **基于块的富文本编辑器** —— 基于 `NSTextView` 构建并完全集成 SwiftUI - **语法与清晰度建议** —— AI 驱动的内联建议，一键即可采纳 - **语气分析** —— 检测并调整所选文本的语气 - **词汇增强** —— 建议更丰富的替换词，并根据实际文档内容进行验证 - **重写与审阅面板** —— 重写所选段落，或获取对整个文档的结构性反馈 - **事实核查** —— 标记可能需要来源支持的声明 - **表格支持** —— 在编辑器内实现完整的表格创建、编辑和上下文菜单 - **写作目标** —— 设置并跟踪字数、阅读难度级别和语气目标 ### 🤖 询问 Logue —— Agentic AI 聊天 - **多步骤 Agentic 推理** —— 由 LangGraph-Swift 驱动；负责规划、推理并执行多步骤工作流 - **流式响应** —— 实时逐 token 输出，并带有动画指示器 - **内联图表与 LaTeX** —— 直接在聊天线程中渲染 Mermaid 图表和数学表达式 - **深度研究模式** —— 追踪长时间运行的多源研究任务的进度 - **工具执行 UI** —— 准确显示 Agent 正在执行的操作，并提供批准控制 - **来源面板** —— 列出 Agent 参考过的所有文档和会议记录 - **持久记忆与历史记录** —— Agent 能够记住跨对话的上下文，且全部内容均可搜索 ### 🔍 搜索、任务与发现 - **统一的 ⌘K 搜索** —— 一次按键即可搜索所有文档、会议和待办事项，并提供以关键词为中心的片段 - **全文搜索 (FTS5)** —— 对所有会议转录和文档正文进行快速、带排名的全文搜索 - **待办事项面板** —— 将每次会议中的所有任务集中在一处，配备智能过滤器（全部 / 待处理 / 已逾期 / 今天 / 本周 / 已完成）、排序、搜索以及侧边栏实时逾期徽章 ### 🔒 隐私与安全 - **默认开启设备端 AI** —— 推理、转录和说话人分离均通过 Apple Silicon 上的 MLX 在本地运行；除非你主动选择使用网页搜索或外部 AI 提供商，否则不会向任何云服务发送任何内容 - **静态 AES-256-GCM 加密** —— 磁盘上的所有会议数据和文档均已加密 - **无需账号** —— 下载即可开始工作；无需注册，不受遥测门控限制，不依赖云端 - **沙盒化发布构建** —— 生产环境已启用 App Sandbox，并且每一项 entitlement 例外都有文档记录 ## 🖼 截图 | 会议转录 + 询问 Logue | Smart Minutes | | :---: | :---: | |  |  | | 带有事实核查的 AI 写作编辑器 | 设备端 PII 检测 | | :---: | :---: | |  |  | ## 📥 安装（普通用户） **要求：** 搭载 Apple Silicon（M1 或更新机型）的 macOS 26.0 (Tahoe) 或更高版本。 1. 从 [**Releases**](https://github.com/bitwize-ai/Logue/releases/latest) 页面下载最新的 `Logue-.dmg`。 2. 打开 DMG 文件并将 **Logue** 拖入你的 **应用程序 (Applications)** 文件夹。 3. 启动它。首次运行时，macOS Gatekeeper 可能会弹出提示 —— 右键点击该应用 → **打开**。 **更新** 通过 Sparkle 在应用内交付：Logue 会在启动时检查 GitHub 上托管的更新源，并提示你安装新版本。更新操作只会替换应用本身 —— 你的会议、文档和下载的模型是分开存储的，绝不会受到干扰。如果需要手动更新，请下载最新的 DMG 并将其拖放覆盖旧应用即可。 ## 🚀 从源码构建 **前提条件：** 搭载 Apple Silicon 的 macOS 26.0+ (Tahoe)、Xcode 26+（其中内置了 `SpeechTranscriber` 所需的 macOS 26 SDK），以及 [XcodeGen](https://github.com/yonaskolb/XcodeGen)。 **1. 使用子模块克隆**（第三方依赖位于 `Vendor/` 目录下）： ``` git clone --recurse-submodules https://github.com/bitwize-ai/Logue.git cd Logue ``` **2. 下载 Metal 工具链**（只需一次；MLX 需要）： ``` xcodebuild -downloadComponent MetalToolchain ``` **3. 安装工具并生成 Xcode 项目：** ``` brew install xcodegen swiftformat swiftlint xcodegen generate ``` **4. 构建并运行** —— 在 Xcode 中打开并点击 **Run (运行)**，或者通过 CLI 执行： ``` # signing flags 允许您在没有 Apple Developer 账户的情况下进行构建。 xcodebuild build -project Logue.xcodeproj -scheme Logue -destination 'platform=macOS' \ CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO open Logue.xcodeproj ``` 开发构建使用 ad-hoc 签名并关闭了沙盒 —— 只是为了构建和运行的话，不需要 Apple Developer 账号。（在 Xcode 中，如果构建在签名环节停止，请在 **Signing & Capabilities** 下选择你的团队，或使用上述 CLI 命令参数。）完整的代码检查和 git-hook 设置请参阅 [`docs/dev-setup.md`](docs/dev-setup.md)。 ## ⚙️ 配置 Logue 开箱即用，完全在设备端运行 —— 构建或运行、使用它**都不需要任何密钥或账号**。以下所有内容均为可选，仅在你 fork 本项目或制作自己的签名发布版本时相关。没有任何内容被硬编码为机密：所有凭证均从你自己的环境 / GitHub Actions 密钥中读取。 **可选的外部 AI 提供商。** 除了设备端的 MLX 模型外，你还可以在 **Settings → Models** 下添加兼容 OpenAI/Anthropic 的接口，或 OpenRouter/Ollama/LM Studio 等 endpoint。密钥在应用内输入并存储在你的 macOS Keychain 中 —— 绝不会保存在代码仓库中。 **运行你自己的签名构建 / 发布版本。** 要以你自己的身份发布公证版本，请将这些内容设置为 **GitHub Actions repository secrets**（发布工作流会读取它们 —— 没有任何机密会被提交到代码中）： | Secret | 用途 | | --- | --- | | `APPLE_TEAM_ID` | Apple Developer Team ID | | `APPLE_CERTIFICATE_BASE64` / `APPLE_CERTIFICATE_PASSWORD` | "Developer ID Application" 证书 (base64 `.p12` + 密码) | | `APPLE_ID` / `APPLE_APP_PASSWORD` | 用于公证的 Apple ID + app-specific password | | `SPARKLE_PRIVATE_KEY` | 用于签署自动更新 ZIP 包的 EdDSA 密钥 | 对于你自己的签名 fork 版本，你可能还需要在 [`project.yml`](project.yml) 中更改以下内容： - **bundle identifier** (`PRODUCT_BUNDLE_IDENTIFIER`，默认为 `com.bitwize.logue`)； - [`Logue.entitlements`](Logue/Resources/Logue.entitlements) 中的 **iCloud container identifiers** (`iCloud.com.bitwize.logue`) —— 这些与你的 Apple Developer 账户绑定，因此如果你需要 iCloud 同步功能，请将它们指向你拥有的 container（或者直接删除它们）。官方发布的 **release** entitlements 中不包含 iCloud，因此签名发布版本的构建不会受此影响； - 要运行你自己的更新频道，请修改 `SUFeedURL` + `SUPublicEDKey`。 构建和运行未签名的开发版本不需要上述任何内容。请参阅 [`docs/dev-setup.md`](docs/dev-setup.md) 和 [`docs/SPARKLE_UPDATE_FLOW.md`](docs/SPARKLE_UPDATE_FLOW.md)。 ## 📚 文档 - [开发者设置](docs/dev-setup.md) - [贡献指南](CONTRIBUTING.md) - [Sparkle 更新流程](docs/SPARKLE_UPDATE_FLOW.md) - [脚本参考](scripts/README.md) - [安全政策](SECURITY.md) ## 🗺 项目布局 - [`Logue/`](/Logue) —— 主要 Swift 源码；SwiftUI + AppKit 应用程序 target。 - [`Logue/Engine/`](/Logue/Engine) —— LLM 推理 actor、prompt 构建器和重试辅助工具。所有 AI 逻辑均位于此处。 - [`Logue/Services/`](/Logue/Services) —— 录制 pipeline、转录、说话人分离、加密和调度服务。 - [`Logue/Views/`](/Logue/Views) —— 所有 SwiftUI 视图：Meeting 工作区、写作编辑器、询问 Logue 聊天、待办事项、设置等。 - [`LogueTests/`](/LogueTests) —— Swift Testing 套件（`@Suite`, `@Test`），包括真实推理的 LLM 集成测试。 - [`Vendor/`](/Vendor) —— 第三方 git submodule 依赖 —— 构建时无需远程访问。 - [`docs/`](/docs) —— 开发者设置和发布文档。 - [`scripts/`](/scripts) —— 发布构建脚本、Sparkle appcast 更新器和 export options plist。 ## ❓ 常见问题 对使用 Logue 有疑问吗？请查看[我们网站上的 FAQ](https://bitwize.ai/#faq)， 或发送电子邮件至 [support@bitwize.ai](mailto:support@bitwize.ai)。 ## 📄 许可证 Logue 是基于 [MIT License](LICENSE) 的开源项目 © 2026 [Bitwize](https://bitwize.ai)。 [`Vendor/`](/Vendor) 下的某些第三方依赖使用单独的开源协议（MIT、BSD、 Apache-2.0）；详情请参阅各个软件包。

标签：AI写作助手, Apple Silicon, 会议记录, 端侧AI, 语音转写