AI 聊天

工作方式

AI → AI 聊天… 在窗口右侧窗格的一个标签页中打开聊天，它使用你自己的笔记作为上下文来回答。LightNote 不会把所有内容发送到云端，而是在本地从你的知识库中检索最相关的片段（使用 ripgrep，无需嵌入向量，也无需外部服务），用这些片段组织问题，并发送给你已注册的 API AI 提供商。回答会附上可点击的来源笔记引用——点击即可打开该笔记。非常适合“与你的第二大脑对话”，找回你已经记录过的内容。对话按文件夹保存，之后可以回到它们（见下文）；该功能可在设置 → 常规 → 功能中关闭。

标签页与窗口。 聊天在你正在阅读的内容旁边打开，位于右侧窗格的标签页中——每个窗口一个，每个窗口有自己的对话。在标签页中，笔记来自该窗口的文件夹，当前编辑器 上下文会跟随活动标签页（见下文）。选择器位于顶部：AI、上下文和 模式（AI 可以做什么），以及附加文件和开始新对话的按钮；在较窄的标签页中它们会分成两行。在提出第一个问题前，界面会说明聊天将针对什么作答，并提供如 总结此文件夹 的一键快捷方式。在提问框中，Enter 发送，Shift+Enter 换行；答案返回期间，发送按钮会变成 停止。关闭标签页会像 新对话 一样把对话保存在列表中。

移动、分离与重新附加。 这个标签页可以像其他标签页一样拖动：拖到主区域、下方区域，或者拖回右侧。重新打开文件夹时，它会回到你上次放置的区域。对话操作 中或角落按钮上的 分离为窗口 会把同一个对话——连同其文件夹、附件、帮助章节以及你在其中允许的操作——移到一个独立窗口，标签页随之关闭。在独立窗口中，重新附加到窗口 会把它送回原来那个窗口的标签页（或另一个打开同一文件夹的窗口）。一个对话只在一个地方打开，AI 回答期间不能移动。托盘图标的 AI → AI 聊天… 会打开独立窗口，其中有用于选择文件夹的 笔记来自： 选择器。

谁回答的，以及比较回答。每个回答下方会低调地显示写出它的助手和模型 — 当对话中途换了助手，或列表中的第一个模型失败时很有用。聊天会按窗口和文件夹记住最后选择的助手。要把同一问题发给多个助手，请在聊天菜单中使用比较回答…，或在问题前输入/compare：参见比较回答。

工具与权限

模式：AI 可以做什么。 顶部栏的 模式 选择器有三个值。仅笔记 只用按词检索找到的摘录作答，不执行任何操作。读取 让模型在回答前自己查找——读取文件、搜索笔记、列出任务、查阅本帮助——但不做任何修改。经批准后修改 在此基础上还能创建笔记和任务、更改属性、在今天的笔记中追加内容，每次都要你确认。从未选择过时，默认从 读取 开始，因为读取是安全的。回答末尾会列出用到的工具，方便你判断回答，而不是盲目相信。

模型测试。 读取 和 经批准后修改 需要 API 提供商（本地 CLI 无法接收工具）。选择它们时，LightNote 会当场测试模型能否调用工具：许多提供商接受请求后会直接忽略工具，没有这一检查，就会得到看似查过、实则编造的回答。测试结果按提供商+模型的组合保存七天。如果测试未通过，只剩 仅笔记 可用；消息旁的 重新检查 按钮会忽略已保存的结果重新测试——当时提供商可能只是暂时不可用。

每次修改都要你确认。 修改会以清楚的语言显示在对话中（“创建任务 买面包”），并提供三种回应：允许，仅此一次；在此对话中允许，在对话结束前同一工具不再询问（对话每次都会提示：已在此对话中允许）；拒绝 不会结束对话——模型会收到通知，继续解释或提出别的办法。删除永远不会获得这种许可：每次删除都会询问。对话操作 中的 重置此对话的权限 会让一切重新询问，新对话或换一个文件夹也一样。覆盖任意文件和访问网络被有意排除在外。修改写入今天的笔记时，请求会说明会落在哪个文件夹。

AI 提问或停下时。 如果回答所依赖的信息缺失——哪个看板、两篇笔记中的哪一篇——AI 可以向你提问：问题会出现在对话中，每个选项是一个链接，必要时还有 其他回答… 输入框；选择 不回答 时，模型会在没有该信息的情况下继续。回答之后，问题会变成文字，旧问题的选项不再起作用。经过多个步骤仍未完成时，对话会停下并显示 继续，为同一项工作再给出更多步骤；如果模型连续三次重复同一查询而没有进展，对话会停下并说明是哪一个。每一步的文字会随着模型书写逐步显示。

它依据什么回答

笔记，还是打开的文件。 聊天顶部的 上下文： 下拉框决定对话的主题：Vault 笔记（默认，见下文）或 当前编辑器 —— 后者回答关于编辑器中打开的文件而非 vault，使用选区及其周围的行（或勾选 整个文件 使用整份文件）。在标签页中，当前编辑器 会跟随窗口的活动标签页：切换标签页就会切换文件，聊天自身的标签页不计入；当活动标签页不是文本编辑器时，该项会变为不可用，但不会改变你的选择。在独立窗口中，它是你打开聊天时的那个编辑器。此外，在快速助手（Ctrl+K）中，结果里有一个 在聊天中继续 → 按钮，它会以 当前编辑器 上下文打开聊天，并带入那一轮的问题与回答 —— 无需重来即可深入。

问哪些笔记？ 在标签页中，是该窗口文件夹中的笔记：切换窗口的文件夹也会切换聊天的文件夹，正在进行的对话会存入列表。独立窗口每次只针对一个文件夹作答，在 笔记来自： 下拉框中选择，其中列出当前打开的文件夹，其后是最近使用的；选择文件夹… 可指向其他任意文件夹——这样你可以一边在某个项目中工作，一边询问另一个项目的笔记。手动选择的文件夹会一直有效，直到你再次更改。提问处理期间（包括停下来等待你确认时），AI、上下文和文件夹选择器都会锁定：正在返回的答案属于你提问时的模型和文件夹。

如何提问。 检索按主题而非指令进行：LightNote 取出你问题中的词，查找包含这些词的笔记。请指出笔记中出现的主题（“我记过关于 Postgres 的什么？”），而不是笼统的请求（“做个总结”）——后者没有可供检索的内容词，因此不会检索到任何内容，聊天会提示回答未使用你的笔记。只读取 .md/.markdown 笔记；在没有任何此类文件的文件夹中，聊天会告知并且不消耗一次 AI 调用。

更好的搜索、总结与改写。 检索使用带 BM25 排序的本地索引，忽略重音（“configuração”能找到“configuracao”），并且在没有词间空格的语言（日语、中文、韩语）中也有效——索引尚在构建时由 ripgrep 兜底。总结此文件夹 按钮，以及资源管理器中任意文件夹右键菜单里的 用 AI 总结…，会分批读取笔记并返回一份文档。在 设置 → 常规 → 功能 中，用 AI 改写问题 选项会在搜索前把你的问题扩展为关键词（每个问题消耗一次 API 调用）。

密钥与对话

只需一个密钥。 首次运行时，LightNote 已在 设置 → AI 助手 中预先登记 OpenAI、Google Gemini 和 Anthropic (Claude)——您只需把 API 密钥粘贴到所用的提供商即可。如果没有任何提供商拥有密钥，窗口会显示 立即配置 按钮，直接打开该界面。

对话会被保留。 顶部的时钟按钮会打开该文件夹的以前的对话列表：点击其中一条即可回到它。新对话会归档当前对话而不是删除它，在列表中右键则可彻底删除一条（需确认）。对话按文件夹保存——切换笔记文件夹就会切换列表。重新打开该文件夹时，聊天标签页会带着之前打开的对话一起回来。

拿到回答之后

如何处理一个回答。 每个回答下方都有复制（将 Markdown 文本放入剪贴板，保留格式）和采集到笔记（连同引用笔记的链接一起送到今天的笔记）。对话操作菜单中有复制对话、将对话保存为笔记…（在所查询的文件夹写入一个 .md）、重新生成上一个回答和编辑上一个问题。

附加文件。 当搜索找不到你心里想的内容时，用 + 按钮附加一个文件：它总是会进入提问，不参与搜索排名。笔记、代码、文本和 PDF 都可以（PDF 会提取文本）；二进制文件会被当场拒绝，而不会成为上下文里的噪音。附件以胶囊形式显示（点击可取消附加），开始新对话时会消失。在支持的提供商上，回答也会随着模型书写逐步出现。

助手记忆。顶部 ☰ 按钮的对话操作菜单中，助手记忆…会打开所选文件夹根目录下的 记忆.md 笔记（首次会创建）。其中的内容会进入关于该文件夹的每一个提问，并排在检索到的片段之前：你的偏好、你已经做出的决定、你排除了什么以及为什么。它就是一个普通的 .md——随时编辑、用 Git 版本管理、删除即可关闭记忆。启用写入工具后，助手还可以提议把某条事实存进去，并且和所有写入一样等待你的批准。

总结一个文件夹。整个工作区可以，任意子文件夹也可以：在资源管理器中右键点击它，选择用 AI 总结…。在花钱之前，LightNote 会告诉你将读取多少条笔记、会产生多少次 AI 调用（每次都由你的提供商计费），并让你选择形式：概览是连贯的文字，整合知识则带固定小节（决定、待办、想法、矛盾之处和悬而未决的问题；没有内容的小节会被省略，而不是用编造的内容填满）。如果文件夹里的笔记超出费用上限，回答会说明有多少条未纳入。最后，保存为笔记会把总结写进被总结的那个文件夹里，标题区记录日期和笔记数量，并且绝不覆盖此前的总结。

命令、帮助和链接

助手了解 LightNote。 除了你的笔记，它还知道自己运行在 LightNote 中：它会收到本帮助的目录、应用 Markdown 的摘要（维基链接、标注框、图表、公式、日历），并在每次提问时收到所查询的文件夹、当前标签页和日期。像问笔记一样问它“怎么创建任务看板？”即可。

以 / 开头的命令。 在空输入框开头输入 / 会打开命令列表，并随输入筛选；Enter 选择，Esc 关闭。/help 后接主题（/help 表格）会把本帮助中标题与主题相符的章节附加到对话中；没有主题时，附加的是你打开聊天时所在界面的章节。如果用问题代替主题（/help 怎么创建表格），列表会显示可能回答它的章节：选中的章节会被附加，问题也会一起发送。

附加的章节。 章节以 帮助：… 胶囊显示在附件旁边，每次提问时都放在笔记片段之前；点击它或开始新对话即可移除。在空白界面上，聊天如何使用？ 会用本章节完成这一步并直接提问。

其他命令。 /summarize 总结文件夹，/new 开始新对话。Prompts 文件夹中的提示词也出现在同一列表中：选择一个会把其文本放进输入框，方便你在发送前检查。

用 [[ 或 @ 添加笔记。 在输入框中键入 [[ 或 @ 会打开该文件夹的笔记列表，并随输入过滤（是否带重音都可以）。按 Enter 选择后，笔记会作为附件加入——与 + 按钮相同的标签，每次提问都会重新读取，且不参与搜索排序；你为查找它而键入的内容会从输入框中移除。按 Esc、空格或在别处单击会关闭列表，不附加任何内容。

作为工具的帮助和 Markdown。 在 读取 和 经批准后修改 模式下，模型会自行查阅本帮助（help_lookup）以及 LightNote 所渲染语法的参考（markdown_reference）——这样它才能写对菜单路径和图表的围栏——信息不足时还会向你提问（ask_user）。前两个也在 MCP 服务器中，供 AI CLI 使用；提问只在聊天中可用，因为它需要屏幕前有人。

指向界面的链接。 当回答需要应用的某个界面时，它会给出链接而不是描述菜单：lightnote://settings/ai 打开设置中的 AI 助手部分，lightnote://help/… 打开本帮助的某一章节，lightnote://wizard/clone 打开克隆向导，lightnote://open?file=… 打开文件夹中的文件，lightnote://new?type=lnt 新建文件。

不会自动打开。 点击就是你的同意。指向文件夹之外、已关闭的功能或不存在目标的链接不会打开任何东西，状态栏会说明原因。同样的链接在笔记中也能使用。

配置应用并创建连接

更改设置。 在 经批准后修改 模式下，像请人帮忙那样提出：“换成深色主题”“把编辑器字体调到 14”“关闭缩略图”。请求会以 修改前 → 修改后 的形式显示（“主题：浅色 → 深色”），并附有指向设置中同一选项所在部分的链接，只有在 允许 之后才生效；随后对话会显示 已应用 和新值。

每次修改都会询问。 在此对话中允许 不适用于设置。解释器和 AI CLI 也能这样添加、修改或删除，程序始终按名称指定，绝不按文件夹指定。Shell（pwsh、bash）只能作为打开文件的解释器，例如 pwsh -File {file}，绝不能带有直接写在这一行里的命令。

不在范围内的内容。 只能访问一份固定的选项列表：主题、语言、编辑器字体、Markdown 的打开方式、功能、每日笔记和 AI 选项等。API 密钥、提供商地址、程序路径和终端永远不会通过聊天更改，助手会回复正确部分的链接。这是有意的：笔记的文字会进入对话，来自外部的笔记不能把你的 AI 引向另一个地址。

创建 HTTP 测试或连接。 提出“为 GET https://… 创建一个测试”“保存到 deploy@server 的 SSH 连接”或“连接销售数据库”：在 允许 之后，助手会以应用写入的相同格式创建 .lnh、.lns 或 .lnc，对话中显示 已创建 和打开文件的链接。它从不覆盖文件，只在文件夹内创建，也不会创建在设置的 功能 部分中已关闭的类型。

缺少信息时会询问。 缺少会改变结果的信息（数据库、服务器、认证方式）时，它会在创建前带着选项提问。

密码不经过聊天。 数据库连接和 SSH 连接创建时没有密码：连接时才会询问，AI 对数据库连接的访问在你允许之前保持关闭。在 HTTP 测试中，令牌或密码会变成一个空变量（{token}），由你在测试或 http-client.private.env.json 中填写；直接写出的密钥会被拒绝。这三个创建工具也在 MCP 服务器中供 AI CLI 使用；更改设置只能在聊天中进行。