对选区的 AI 助手（Ctrl+K / Ctrl+I）

用 AI 提问与编辑

默认 AI。 在 设置 → AI 助手 顶部，默认 AI 决定 Ctrl+K/Ctrl+I、AI 聊天 聊天（可按会话更改）以及自动任务（改写问题、总结、音频摘要、生成上下文）所用的助手。它同时列出 CLI 和 API 提供商。音频转录 和 embeddings 有各自的提供商，LightNote 会根据所选提供商 建议一个模型。

在编辑器中，无论有无选区，按 Ctrl+K（向 AI 提问）或 Ctrl+I（用 AI 编辑） 都会打开一个浮动的内联聊天式弹窗。提示框中已在一个空行下方预先填入选区。 你在其上方输入指令，并按 Ctrl+Enter 发送。在弹窗中可选择 AI（默认 AI 已预选）和结果模式: 用差异替换选区 （原文 × 建议，带应用 / 复制 / 放弃），或仅以文本显示回答。

LightNote 以“一次性”模式运行 AI CLI（不打开终端）。 CLI 和默认 AI 在 设置 → AI 助手中。

连接一个模型

通过 API 的模型。除本地 CLI 外，您还可以在设置 → AI 助手中通过兼容 OpenAI 的 API（OpenAI、Groq、DeepSeek、OpenRouter、Gemini、Anthropic，以及 Ollama／LM Studio 等本地实例…）注册 LLM 模型。从目录中选择提供商（基础 URL 已就绪），粘贴密钥（仅在本机以编码形式保存），使用获取模型…和测试。已注册的模型会出现在 Ctrl+K 的同一选择器中，与 CLI 并列。

一步完成连接。通常的做法不是填写表格：在设置 → AI 助手中点击连接 AI…，选择提供商（列表会标出有免费方案的以及在你的电脑上，无需密钥运行的），按三个步骤操作，用按钮打开密钥页面并粘贴密钥。LightNote 会自动填好地址和模型，并在保存前测试连接 — 密钥有误当场就能看到，而不是在对话进行到一半时。上方的列表显示已连接的项目，以及尚未完成的项缺少什么（“尚未粘贴密钥”“尚未选择模型”）；双击即可在该提供商上重新打开连接向导。

精细调整。地址、模型、MCP 权限、CLI 命令、音频转写和嵌入仍然都在页面末尾的高级中 — 在向导本身的高级选项里，也可以在连接前更改基础 URL 和模型。什么都没有删除，只是从初学者的路上挪开了。 嵌入还有一个可选的维度字段：有些模型可以返回更小的向量（512 而不是 1536），几乎不损失质量却能把缓存减半。不确定就保留（模型默认）——并非所有提供方都接受这个参数。改动这个值会使缓存失效：维度不同的向量无法比较，缓存会被丢弃并在下一次搜索时重建，那要花新的调用。

并非所有失败都一样。它们需要的处理恰好相反，所以 LightNote 把它们分开对待。提供商过载和调用频率限制会自行恢复：应用会自动重试，并遵守提供商要求的等待时间；只有这样仍不行时你才会看到错误。余额或消费上限重试多少次都无济于事——消息会直说，免得你一直尝试。对话太长需要的是新建会话，而不是换模型。而模型本身的问题——已淘汰、不在你的账户内、不在你的套餐内，或者接了调用却不作答——才是换模型能解决的那一类。 当要求的等待时间长到不值得干等时，消息会告诉你它要求了多少秒，而不是让窗口一直卡着。

让它自己换模型。勾选当前模型失败时自动更换模型，LightNote 就会按那里显示的顺序，尝试该提供商的推荐模型。默认不勾选是有意为之：每一次尝试都是一次计入你账户的调用。替代模型绝不会比你选的那个更贵——列表按由贵到便宜发布，应用只会沿着它往下走；不在列表中的自定义模型，会直接落到最便宜的那个。只有确定性的失败才会写入提供商配置；如果是网络出了问题，这次更换只对那一次调用有效，你的选择依然保留。更换从不悄悄进行：通知会说明是哪个模型作答，以及这次更改是否被保存。

还有一条比失败更早到的提醒。自动更换只在调用失败之后才动作，但 LightNote 自己会查询的模型目录，通常在那之前就知道了淘汰的事。当由 LightNote 自己登记的某个模型从目录中消失时，会有一条提醒说明，并在设置 → AI 助手中出现一个按钮，可改用它的后继——按照同一条规则，后继绝不会更贵。这条提醒只针对应用自己选定、而你从未改动过的模型：你亲手输入的模型是你的选择，LightNote 不去插手。

当谁都不作答时。LightNote 会说明发生了什么，并提供更换模型、改用其他助手或先停用该提供商三种选择。被停用的提供商（高级中表格的启用列）只是从列表中消失，密钥和其余配置都不会丢失。在助手列表里，每一项都会标明自己是本地还是云端——选择云端的，发送的文本就会离开你的机器。

设置 AI。连接任何 AI 的引导方式是按钮设置 AI…，位于设置 → AI 助手顶部（空白聊天中的连接 AI…以及未连接任何 AI 时 Ctrl+K 的提示，打开的也是它）。它会询问你想设置什么，并通过五条路径一步步引导：云端 AI、通过 Ollama 或 LM Studio 在你电脑上运行的 AI、直接通过 LightNote 在你电脑上运行的 AI、命令行助手，以及按含义搜索。按钮旁边的各功能使用什么表格显示由哪个 AI 负责聊天、Ctrl+K、块 AI、自动任务和按含义搜索。详情见你电脑上的 AI。

无需密钥：本地 LLM

还没有连接 AI？ 在没有连接任何助手时按 Ctrl+K，LightNote 会说明情况并提供当场连接；连接完成后，你请求的操作会继续执行，无需再次按下快捷键。

本地 LLM（无需密钥）。本地提供方——Ollama、LM Studio、llama.cpp——无需 API 密钥：在添加中选择其一（选择器会显示服务器是否正在运行），再用获取模型…从你已下载的模型中挑选。若未安装 Ollama，LightNote 会主动帮你安装。首次运行时它已预先登记，你只需选择模型。由于本地模型的响应可能慢得多（尤其是首次生成、加载模型时），LightNote 对它的等待时间远长于云服务。你的文本不会离开本机。

无需任何其他程序即可运行模型。除了 Ollama 和 LM Studio，LightNote 还能借助 llama.cpp 的官方程序自行下载并运行模型：设置 AI向导会事先显示它占用多少磁盘和内存，并在你的电脑上测量速度。参见你电脑上的 AI。

接受、提示词与操作在哪里

逐块接受。 当结果以差异形式呈现时，你不必全部接受：每个更改的代码块都有一个复选框来决定是否包含，最终文本仅由你保留的代码块重新组合而成。提示还会带上文件的自动上下文（路径、语言以及选区周围的行），让 AI 无需你粘贴任何内容即可更精准地回答。

提示词库。 AI → 提示词库… 把可复用的提示词保存为工作区 Prompts/ 文件夹下的 .md 文件——开放格式，可用 Git 版本管理，也是你第二大脑的一部分。选择器提供搜索、预览，以及新建提示词的按钮。选中一条后，{selection}、{file}、{folder}、{name}、{language} 等字段会用当前编辑器的上下文填充（你自定义的变量会被保留），正文随后被填入 Ctrl+K 的输入框，或发送到当前的 AI 终端（不会直接提交）。

不仅限于代码编辑器。 AI 操作（Ctrl+K / Ctrl+I 以及右键菜单）在 Markdown 编辑器、任务的内嵌笔记和数据库的 SQL 查询编辑器中同样可用——在每一处，弹窗都会在光标处打开并就地应用结果。

所有 AI 操作都在 AI 菜单中（☰ 按钮以及活动栏的魔杖按钮）：询问 AI（Ctrl+K）、用 AI 编辑（Ctrl+I）、AI 会话、询问笔记、提示词库、生成工作区上下文文件、在此文件夹启用 AI 和配置 AI 助手。

输入过程中窗口不会关闭。在编辑器里点击也不会关掉它 —— 你可以回头再读代码或选中另一段，而不会丢失已经输入的指令。关闭它的是 Esc、窗口自身的 ✕ 以及结果操作（接受／拒绝）。切换标签页时它会收起并保留已写的内容：回到同一个文件按 Ctrl+K，指令会从原处回来。