对话

打开 AI

AI 默认关闭，需要你手动打开。打开设置（⌘,），选择 AI，然后在 Availability 下打开 AI features。打开后，面板的其余部分会按以下顺序出现：Connection、你所选连接的设置、Behaviour、Finding sources 和 Advanced。

关闭 AI features 后，对话、对话的快捷键以及 MindLake 菜单中的 AI 项目都会隐藏或变灰，Advanced 中介绍的后台功能也会停止，无论是在你的 Mac 上还是在云端：笔记不会被命名、归档或总结，已在等候的任务也不会发送任何内容。Find sources 仍然可用，但只是普通搜索。你的笔记和录音不受影响，转录仍在你的 Mac 上运行。

选择连接方式

Connection 有三个选项块。选择其一，然后在它下方出现的卡片中完成设置。

首次打开 MindLake 时的设置步骤会用三张卡片问同样的问题：On this Mac（Local）、Your AI subscription（CLI Agents）和 Your own API key（API）。你可以随时在这里更改。

CLI Agents

MindLake 会查找你 Mac 上的智能体，为每个它能驱动的智能体显示一张卡片：正在使用的排在最前，其次是已安装的，然后是其余的。安装新智能体后，点按标题旁的箭头可以重新查找。

后五个通过 Agent Client Protocol 连接。每个都使用自己账户所用的模型；当编辑设为需要审阅时，MindLake 会在它每次想做更改前先询问你。每个智能体还会获得 MindLake 的排序笔记搜索（参见 MCP 服务器），无需任何设置。

如果 Claude Code 的 Test connection 提示 Claude 未登录，请在终端中运行 claude，登录后再测试一次。

对话由智能体运行。使用 Claude Code 时，Advanced 中的后台功能，以及 Find sources 中负责撰写搜索和理由的部分，都通过同一个 claude 程序运行，使用它已登录的账户，费用也记在那个账户上，所以无需再做任何设置。其他智能体只运行对话：后台功能会通过 Anthropic 的 API 交给 Claude，使用 API 下 Anthropic 卡片上保存的 Claude 登录或密钥。如果两者都没有，MindLake 会询问改在哪里运行它们（参见 Features）。

API

共有八张服务商卡片，每张都有各自的密钥和模型。在已有密钥的卡片上点按 Use，或在没有密钥的卡片上点按 Set up，就会让对话改用该服务商运行，并打开它的密钥栏。粘贴密钥后按下 Save，MindLake 会立即检查。密钥保存在你 Mac 的钥匙串中，每张卡片都链接到该服务商签发密钥的页面。

Test connection 会向服务商查询你的密钥可用的模型。这样无需发送消息就能验证密钥，因此不产生费用，还会用服务商自己的列表填充 Model 菜单。在此之前，你可以手动输入模型名称。你选择的任何模型都必须支持工具调用，因为助手正是靠它来读取和编辑你的笔记。正在使用的卡片会显示“In use”及其模型；在添加密钥之前显示“In use · add an API key”。Remove 会删除已保存的密钥。

如果你的 Anthropic 账户是通过 Claude 订阅而不是密钥登录的，Anthropic 卡片会显示“Signed in with your subscription”，并使用该订阅。

Local

Local 在 MindLake 内部、用你 Mac 的图形处理器运行模型，无需另外安装任何东西。This Mac 卡片会显示你的芯片、内存和可用磁盘空间，以及最适合的模型。下方的 Models on this Mac 列出了 Apple Intelligence 和四个 Gemma 4 模型：

• 你 Mac 内存能容纳的最大模型，卡片上会显示 Recommended for this Mac。超出内存的模型会显示“Needs a Mac with N GB of memory”，且无法下载。
• 已下载但未在使用的模型会显示“Downloaded · N GB · not in use”，按下 Use 即可改用它。Apple Intelligence 卡片上的 Use 会切换回 Apple Intelligence。
• Download 会从 Hugging Face 获取模型，完成后将其设为正在使用的模型。Cancel 会停止下载；再次按下 Download 会从中断处继续。MindLake 会保留 2 GB 磁盘余量，空间不足时会提示你。
• 模型存储在 ~/Library/Application Support/Mindlake/Models，位于资料库（vault）之外，因此永远不会同步。正在使用的卡片展开后有 Show in Finder、Test speed（载入所需时间以及每秒写出多少个词）和 Remove。
• 模型在需要时才载入，闲置五分钟后释放，因此只在工作时占用内存。

每个 Gemma 模型都能运行对话，拥有与云端方式相同的搜索、读取和编辑笔记的工具，也能运行后台功能。模型越大，写得越好，需要的内存也越多。

Behaviour

有两项设置决定助手可以更改什么：

Finding sources

这一部分选择 Find sources 在查找与笔记主题相关的阅读材料时所用的搜索索引。Wikipedia、Papers（OpenAlex）、Hacker News 和 Stack Overflow 已内置，无需账户。SearXNG（你自己服务器的地址）、Brave Search、Tavily、Exa、Kagi 和 Google Programmable Search 用你自己的密钥提供通用网页结果，每一项都附有获取密钥的分步说明。Find sources 还会用一个模型来撰写搜索、挑选值得阅读的内容，并说明每个网页为什么合适。它在后台功能运行的地方运行（参见 Features）；没有可用的模型，或者关闭了 AI features 时，它就是普通搜索。参见 Sources。

Advanced

大多数人从不打开这里。点按 Advanced 即可展开。

Features

每项功能都有一个菜单，列出它可以使用的模型：On this Mac 下是你的 Gemma 模型（如有正在使用的）和 Apple Intelligence；Cloud 下是 Claude Opus、Sonnet 或 Haiku；如果 API 使用的是其他服务商，则是该服务商以及在其卡片上选择的模型。使用 Local 连接时只提供第一组。使用 CLI Agents 或 API 时只提供第二组，但 Transcript summaries 例外：它的菜单两组都提供，并显示摘要实际在哪里生成，也就是在你的 Mac 上，除非你选择了云端模型。

Transcript summaries 使用 Apple Intelligence（macOS 26 上），除非有正在使用的 Gemma 模型；只有当你为它选择云端模型时才会交给云端。使用 Local 连接时，其他所有后台功能也都在你的 Mac 上运行。使用 CLI Agents 或 API 时，云端功能交给谁取决于连接方式：

使用 CLI Agents，或使用其他服务商的 API 时，列表下方的说明也会这样写。当它们本应交给 Anthropic 的 API，却没有保存 Claude 登录或密钥时，它们就无法运行，这时一个标题为 Without a Claude account 的部分会询问改在哪里运行，并为你的 Mac 上的每个可选项提供一个按钮：你的 Gemma 模型（如有正在使用的）、Apple Intelligence（macOS 26 上），或已保存密钥的其他服务商。选好后，它会显示它们在哪里运行，Change 可以重新选择或停止它们。如果你选的那一项在这台 Mac 上已不再可用（密钥被移除，或模型被删除），就视为没有选择，这一部分会再次询问。使用 CLI Agents 时，在你选好之前，对话上方的胶囊标签会显示一个琥珀色圆点（参见 打开对话）。以后保存了 Claude 登录或密钥，它们就会回到 Claude。

Understanding

这是助手搜索笔记时所用的搜索索引。Find notes by meaning 默认关闭；打开后，助手还能找到用不同说法表达同一意思的笔记。它使用 macOS 内置的句子模型，因此不会上传任何内容，也无需下载任何东西。这一部分显示 Notes indexed、首次处理期间有多少篇已 Understood，以及一个 Rebuild index 按钮。索引只存在于你的 Mac 上，它是一份缓存，不会更改资料库中的任何内容，也从不包含锁定的笔记。

打开对话

对话位于右侧的抽屉中。可以用以下任一方式打开：

• 页面标题栏右侧的抽屉按钮。
• ⌘/（View ▸ Show AI Panel），再按一次即关闭。
• ⇧⌘A（File ▸ Ask Claude），总是针对你正在查看的内容打开。
• 在命令栏中使用 Ask the AI，或在那里输入 /ask，会打开对话并把你的问题填好。参见 搜索与命令栏。
• 任务上的 Send to Chat，会把任务引用到你的消息中，但不会发送。
• 任务上的 Talk about it，会开始一段已经在聆听的新对话（参见 谈论一项任务）。

按下 ⏎ 发送，按下 ⇧⏎ 换行。助手工作时，小小的胶囊标签会显示每一步，Send 会变成 Stop，它会结束本次回复，但保留对话。抽屉标题栏中的新对话按钮会重新开始。抽屉的标题也是一个菜单，可以切换到 Calendar、Sources、Preview 或 Terminal。在标题上用两指向上或向下滑动，无需打开菜单即可逐个切换，没有内容可显示的会被跳过。

对话上方有一个小胶囊标签，显示正在回答的是什么，并附上它的标志：对话在你的 Mac 上运行时，是你的 Gemma 模型，标注 On this Mac；使用 API 时，是服务商卡片上选择的模型；使用 Claude Code 时，是 Claude 模型；使用其他任何智能体时，则是智能体本身，它使用自己的模型运行。你一切换其中任何一项，它就会随之更新。点按它，可以在 Chat 和 Background jobs 下查看对话和后台功能分别在什么上运行；AI Settings… 会打开 Settings ▸ AI。胶囊标签上的琥珀色圆点表示后台功能无处可运行：使用 Claude Code 以外的智能体时，没有保存 Claude 登录或密钥，也没有选择其他地方来运行它们。详细信息会指出哪些功能卡住了，Choose a Model… 会打开 Settings ▸ AI ▸ Advanced 中的 Without a Claude account（参见 Features）。

Terminal 是你 Mac 上一个真正的登录 shell。它从你打开的笔记或画布所在的文件夹启动，或者从你正在查看的文件夹启动，否则就从资料库的文件夹启动。它与助手相互独立：无论你用哪个智能体，它都能用，而助手不会使用它。

助手能看到什么

抽屉标题栏中的范围菜单提供 Whole vault，屏幕上有对应内容时，还提供 This folder、This note、This canvas 或 This list。在你发出第一条消息之前，它会跟随你正在查看的内容；之后再更改会开始新的对话。

• 打开的笔记。在 This note 中，助手一开始就知道笔记的文件夹、日期、标签和人员，以及哪些笔记与它最相近。你要求的工作（例如摘要）会写进这篇笔记，除非你另有说明。它还能读取笔记中勾选用于对话的来源。
• 资料库的其余部分。它会搜索 MindLake 为你的资料库建立的索引，结果按相关度从高到低排列，并可按标签、人员、文件夹或日期缩小范围。打开 Find notes by meaning 后，它还能找到用不同说法表达同一意思的笔记。
• 任务和联系人。你的未完成任务（默认打开）和 Apple 通讯录（默认关闭），在 Advanced 中设置。
• 记忆。它学到的长期偏好会写入资料库中的 memory.txt，每次对话都会读取。在 Settings ▸ Brain ▸ Open memory file 中可以查看。
• 锁定的笔记除外。锁定的笔记永远不会提供给助手，即使它们正在屏幕上处于解锁状态。

让助手编辑你的笔记

打开 Let the AI take actions 后，助手可以创建和编辑笔记。当回复更改了某篇笔记时，回复下方会出现一张卡片，写明笔记名称并统计增加和删除的行数；几秒后它会收起，点按即可重新展开。屏幕上打开的笔记在更改时会闪一下。选择 Review each change first 时，每项更改都会在卡片上等待，直到你按下 Approve 或 Decline。

内容丢失检查

MindLake 会把每次 AI 编辑与编辑前的笔记进行比较，检查是否删掉了标题、丢失了任务、转录文本被删减超过十分之一，或者超过十分之一的文字不见了。使用 API 服务商或 Gemma 模型时，这样的编辑会在写入前被拒绝。使用 CLI 智能体时，编辑会照常生效（因为删减可能正是你要求的），同时会弹出提醒，说明删掉了什么。

编辑历史

在接受任何 AI 编辑之前，MindLake 会保留笔记原来的样子。每篇笔记最近的 20 个版本存放在 ~/Library/Application Support/Mindlake/EditHistory，每篇笔记一个文件夹，位于资料库之外，因此永远不会同步。画布也以同样方式保留。目前还没有恢复按钮：在访达中打开该文件夹，把旧版本拷贝回去即可。

Clean Up 与 Retag & Link

笔记的 ⋯ 菜单中有两项一步完成的工作，在 AI features 打开时显示：

两者都只作用于当前笔记。如果结果会丢失内容，笔记会被还原，并告诉你原因；否则会提供 10 秒的 Undo。无论你选择哪种连接，这两项始终通过 Claude Code 运行，因此你的 Mac 上必须安装并登录 Claude Code。

Chats 部分

每次对话都会以 Markdown 文件的形式保存在资料库的 Chats 文件夹中，因此会随资料库同步，但永远不会显示为笔记。边栏中的 Chats（对话）（⌃5）按时间从新到旧列出对话，分为 Today、Yesterday、This Week 和 Earlier 几组。每个对话都在抽屉中打开，发送新消息即可接着聊。重新打开的对话会显示消息，但不显示步骤胶囊标签或编辑卡片。

• 标题。每一行以你的第一条消息作为标题。针对某项内容的对话会带有一个颜色较淡的前缀：Note:、Task:、Calendar:、Canvas:、List: 或 Folder:。以引用任务开始的对话，以该任务作为标题。
• 长度条。每行旁边的五格显示对话进行了多长，按你的消息数计算：一格都没填满表示只开了个头（没有真正的回答），一格表示一问一答，两格表示追问过一次，三格表示 3 到 4 条消息，四格表示 5 到 7 条，五格表示 8 条或更多。如果对话在没有回复的情况下结束，长度条会变成橙色。
• 标题下方。最新的回复，以及对话读取或编辑过的笔记。

标题栏中的筛选按钮可以缩小列表范围；搜索框会匹配标题和回复。

选择和删除

单个对话会直接移到废纸篓。多个对话则会先询问，确认按钮为 Move to Trash。无论哪种情况，按下 ⌘Z（Edit ▸ Undo）都能恢复。右键点按某一行，或使用它的 ⋯ 按钮，可以选择 Open 和 Delete。

哪些内容会离开你的 Mac

在你连接 AI 服务商之前，不会向任何服务商发送任何内容。连接之后，取决于所用的方式：