LightNote 帮助

适用于 Windows 的轻量代码与笔记编辑器。侧边栏列出各章节，并跟随你正在阅读的位置。 窗口顶部的 首页 和 返回 按钮可回到开头，搜索 框可在本帮助的文本中查找（Enter 向前，F3 / Shift+F3 导航）。随时按 F1，本帮助会在与当前界面对应的章节处打开。

目录

编辑

• 概述
• 工作区与窗口
• 代码编辑器
• Markdown 与维基链接
• 连接图
• 表格（Parquet・CSV・JSON・Excel）
• PDF 与图像
• 图像：为截图添加标注
• 作为文件夹的 Zip（.zip）
• 块（.lnb）
• 任务（看板 / 甘特图）
• 自定义表格（.lnd）
• 基库（笔记的已保存查询）

工具

• 文件内搜索与待办项
• 版本控制（简易 Git）
• 快照与备份
• 审查更改（检查点）
• 文件比较（差异）
• 运行代码（F5）
• 终端与 AI CLI
• 对选区的 AI 助手（Ctrl+K / Ctrl+I）
• AI 会话
• AI 聊天
• HTTP API 测试
• 数据库（.lnc）
• SSH 连接（.lns）
• 安全: 安全口令・PIN・.lne
• 每日笔记・快速捕获・托盘
• 重新发现旧笔记
• 在手机上使用你的笔记
• 音频录制与转写
• 便签
• 日历
• 命令面板

自动化（AI / 脚本）

• MCP 服务器（AI 代理）
• 命令行（lnote）

参考

• 设置与主题
• 键盘快捷键
• 许可・版本・社区

概述

LightNote 将文件夹作为工作区打开，左侧是文件树， 右侧是编辑标签，底部是状态栏。通过侧边栏顶部的细条，可在 资源管理器（树）、搜索、版本控制（Git）、 文件历史、待办项（TODO/FIXME 和笔记中的任务）等各章节之间切换。

不仅是代码和笔记，你还可以在合适的位置打开并编辑各种格式: 表格（通过 DuckDB 的 Parquet/CSV/JSON 以及 Excel .xlsx）、PDF、图像 （包括动画 GIF）、作为文件夹的 .zip、块 笔记本（.lnb）、任务看板（.lnt）、 自定义表格（.lnd）、数据库连接 （.lnc）、SSH 连接（.lns）。它还具备集成终端、 全局搜索（ripgrep）、简化的 Git 版本控制、AI CLI 集成、 MCP 服务器以及用于自动化的命令行（lnote）。

初次使用？介绍材料（欢迎工作区）可随时通过帮助 → 重新打开欢迎导览再次查看。

工作区与窗口

你打开的根文件夹就是工作区。仅打开它不会创建任何内容。 关闭时，LightNote 只会写入一个小的会话文件（记录打开过的标签及其位置）。 只有当你在工具 → 工作区设置中启用版本控制（Git）或 MCP 时， 工作区才会变成拥有自身持久设置的“项目”。

常规设置适用于整个应用程序，而工作区设置仅适用于 当前打开的文件夹。设置和状态保存在中央数据库中，而不会散落在文件夹内。

LightNote 以单实例运行。打开第二个文件夹时会复用同一进程 （多窗口、省内存）。它带有一个列出工作区、含搜索框的启动器和一个托盘图标 （通过右键菜单可将常用项置顶）。 请参阅每日笔记与托盘。每个标签都可以通过 标签栏的右键菜单设置颜色标记。 对于反复使用的笔记，可创建一个含 .md 文件的 Modelos （或 Templates）文件夹，并使用 文件 → 从模板创建新笔记…。

新建文件并选择类型。 新建菜单（☰ 文件、活动栏的新建按钮，或文件夹右键菜单中的新建）提供新建笔记 (.md)、新建文本文件 (.txt)，以及包含常用语言的新建代码文件子菜单。三者都会立即以默认名称在磁盘上创建文件，并在文件树中打开名称编辑：只预选名称部分，因此输入标题不会把扩展名一起删掉。若接受建议的名称，只需点击编辑器开始书写。子菜单之外的扩展名，请先创建文件再重命名（F2）：更改扩展名即更改视图——把 .txt 改成 .md，同一个标签页会以笔记方式重新打开，带预览和大纲；反之则回到代码编辑器。LightNote 的专有扩展名（.lnc、.lne、.lnq、.lnh、.lns 以及各类 bundle）是例外：其扩展名声明了内容的格式，因此重命名会先询问确认，并在标签页打开期间被拒绝。

新文件创建在哪里。新建始终在资源管理器中已标记的文件夹内创建，并且始终恰好有一个被标记。树的顶部是根文件夹行，显示工作区名称：它和其他条目一样，点击它即可把目标恢复为根目录。选中某个文件夹会把标记移到该文件夹；选中文件则标记包含它的文件夹。在不显示文件夹的列表模式下，标记留在根行上，并由该行显示实际的目标。根行的右键菜单提供新建和新建文件夹。

若要打开单个文件而不将其变成工作区，请使用打开单个文件…（托盘菜单）: 独立窗口会显示文件树，但没有 Git、MCP 或主题覆盖。若在 设置 → 常规 → 功能中启用，LightNote 会集成到 Windows 资源管理器的菜单中 （按用户，无需管理员权限）：除了“打开方式”列表，右键菜单还会新增—— 任何文件上的“用 LightNote 打开”，以及文件夹上的“作为 LightNote 工作区打开”（在 Windows 11 中位于显示更多选项内）。文件在该独立 窗口中打开；文件夹则作为工作区打开。

在 Windows 资源管理器中一次选中多个文件时——即使它们位于不同的 文件夹——也会全部在同一个独立窗口中打开，一个标签页挨着一个标签页 （而不是每个文件各开一个窗口）。该窗口的标签页会被记住：关闭后再次打开， 同样的文件会回来。由于这里的重点是标签页，文件树默认是收起的——按 Ctrl+B（或活动栏顶部的按钮）即可显示。

回到某个会话。独立文件窗口在任何地方都叫独立文件——包括标题栏，也就是其他窗口显示工作区名称的位置，这样你可以在 Alt+Tab 中区分它们。在托盘菜单的打开下，当有已保存的标签页时，该项会加上（N 个标签页）后缀，点击即可全部找回。它也是启动器的第一行，与工作区并列。此外，重新打开 LightNote 时，会恢复退出时打开的全部内容：每个窗口回到各自的文件夹，独立窗口也一起回来。如果你更希望只打开上次使用的文件夹，请在设置 → 常规 → 界面 → 启动时打开中更改。退出前关闭的窗口不会恢复——关闭就是在说“我不再需要这个空间了”。

收藏夹：侧边栏有一个 收藏夹 区域，包含你固定的项目 （文件树或标签页的右键菜单 → 添加到收藏夹）以及最近打开的文件。固定项按 文件夹保存，并以相对路径存储，因此移动工作区后仍然保留。

在独立窗口中打开标签页：在标签页的右键菜单中，在新窗口中打开 会在独立窗口中重新打开该文件（便于将笔记放在代码旁边）。依赖工作区的类型 （.lnc、.lne、.lns 和捆绑包）无法分离。

多选。 在三种视图模式下，树都支持 Ctrl+单击（逐个）和 Shift+单击（范围）。选中多个项目后，右键菜单将作用于整个选择：剪切和复制（与 Windows 资源管理器互通）、删除（只确认一次）、复制副本、复制哈希、压缩为 .zip（只生成一个压缩包，每个项目以自己的名字放在顶层）、应用颜色、收藏、Git（add/restore）以及复制路径（每项一行）。只对单个项目有意义的操作——就地重命名、属性、打开方式、转换——会被禁用，原因显示在提示中。在选择之内右键单击会保留选择；在其外单击则只选中被点击的项目。同时选中一个文件夹和它里面的东西不会重复执行操作：内部项目会被丢弃。

不打开也能看。 单击文件本就会打开一个预览标签页（会被复用，在标签栏上以斜体显示）。用方向键浏览树时，空格键做同样的事，并把焦点交还给树，方便你继续往下看。

文件工具。 资源管理器的右键菜单中有 文件工具 子菜单：批量重命名（按扩展名/通配符/正则过滤 + 带实时预览和冲突检测的规则流水线）、拆分文件（按行、大小或正则分隔符）、合并文件（可选仅保留第 1 个 CSV 表头）、创建副本、复制哈希（MD5/SHA-256）以及 压缩为 .zip / 解压到此处。 选中多个项目时，批量重命名和合并文件接收的正是所选项目（而不是扫描整个文件夹）——合并会遵循选择的顺序。

独立窗口的导航。 树的上方有后退（Alt+←）、前进（Alt+→）和向上按钮，还有一条可点击的文件夹路径——点击任一段即可跳到该层级。鼠标侧键同样可以后退和前进。要输入路径，请单击该条的空白处或按 Ctrl+L；Esc 取消并恢复路径。切换标签也会移动显示的文件夹：由于独立窗口汇集了不同文件夹的标签，单击某个标签即可导航到该标签的文件夹。

菜单。活动栏顶部的 ☰ 按钮汇集了文件、编辑、视图、窗口、工具、AI 和帮助菜单。AI 操作有独立菜单（活动栏的魔杖按钮也可打开）。在工具中，各组收入子菜单：运行（F5/F6/F8、lint、发送到终端、宏）、捕获（今日笔记、快速捕获、快速任务、录音、便签）和工作区（配置、快照、导出副本、移动文件夹）——后者也在齿轮菜单中。新建菜单在出现的三处完全一致：☰ 文件、新建按钮，以及文件夹右键菜单中的新建。

代码编辑器

文本/代码文件会在带语法高亮的编辑器（Scintilla）中打开。 具有注释切换（Ctrl+/）、行的移动与复制、书签（Ctrl+F2）、 符号/函数列表、基于单词的自动补全、缩进参考线、自动换行、缩放， 以及对磁盘上文件变更的检测。启用版本控制后， 边距会标示自最新版本以来新增/更改的行。

还有宏（记录/回放一系列编辑。Ctrl+Shift+R / F4， 工具 → 宏）、格式化（美化）（Shift+Alt+F）、 用于插入字符或边框的标签工具栏 ASCII 表、拼写检查 （Hunspell）。pt-BR 和 en-US 已内置；其他语言可在设置 → 笔记与写作 → 拼写 的表格中按需下载（每种语言一行，带下载/移除按钮）。 要跟踪正在写入的日志文件，请使用标签专属工具栏上的 监视（tail -f）按钮。非常大的文件（约 1 MB 以上）会以 仅加载当前可见块的虚拟化轻量编辑器打开。 也可以从文件 → 在轻量编辑器中打开…手动强制使用。

格式化与检查（linter）: Shift+Alt+F 会在已安装时用该语言的 外部格式化工具（black、prettier、clang-format、gofmt、rustfmt 等）格式化文档， 离线时回退到内置格式化工具（JSON/XML）；F7 运行该语言的 linter （ruff、eslint、shellcheck、luacheck 等），并在编辑器和问题面板 （底部窗格，可导航）中以下划线标出问题。二者都在设置 → 格式化和 → Linter中提供带添加的目录，以及保存时格式化 / 保存时检查 选项。用 F6 在输出面板中运行文件（捕获退出码与耗时，可停止/重启）， 或用 F8 只运行一段。

更多编辑功能: 逐个匹配的多光标（Ctrl+D，全部用 Alt+F3）、 复制行（Ctrl+Shift+D）、合并行（Ctrl+Shift+J）、按作用域 扩大/缩小选区（Ctrl+Shift+Space / Ctrl+Alt+Space）、矩形选择 （Alt+拖动）、全部折叠/展开、代码片段（Ctrl+J，可在 设置 → 编辑器中编辑）、跳转到文件中的符号（命令面板中的 #） 与项目中的符号（Ctrl+T 或 ##）、导航历史（Alt+←/→）、 编辑器顶部的面包屑导航、列标尺、括号配对着色、自动闭合/包裹配对， 以及保存时清理（去除行尾空格、末尾换行）——都在设置 → 编辑器中。

本地历史与剪贴板: 每次保存时，LightNote 都会独立于 Git 保留文件的一个版本 （文件 → 本地历史…，可恢复）。Ctrl+Alt+V 打开剪贴板历史， 以粘贴之前复制的条目。Ctrl+Shift+T 重新打开最近关闭的标签；标签可以固定 （右键菜单），从而避免因闲置被释放。

转到定义：在标识符上按 F12 或 Ctrl+单击即可跳转到它在项目中的定义处；Shift+F12 查找其用法。

缩略图。 编辑器右侧边缘显示整个文档的缩略图：它呈现代码的“形状”（缩小后的语法高亮颜色），并标出当前可见区域。点击或拖动即可跳转到文件的任意位置。可在视图 → 缩略图或设置 → 编辑器中开启/关闭。 代码标签页自身工具栏上的缩略图按钮（位于 ASCII 旁边）可直接开关，无需离开编辑器。缩略图左侧边缘有一条标记条：蓝色表示有书签的行（与边栏上的圆点相同），琥珀色表示快速查找的匹配项——这样你可以一眼看出它们在整个文件中的分布，包括屏幕之外的部分。

文本操作。编辑菜单（以及编辑器的右键菜单）中有行（移动、复制、删除、排序、合并、反转、编号）和清理（去除空白、删除空行/重复行、制表符 ↔ 空格）子菜单。选中文本时，右键菜单还提供将选区另存为新文件…：把片段写入当前文件旁的新文件并在标签页中打开（原文件不变）。

Markdown 与维基链接

.md 笔记会以编辑器和预览并排的方式打开（可配置）。 在光标所在段落之外，标记会淡化显示，使页面看起来像一篇完成的文档。

快捷键：Ctrl+B/Ctrl+I 应用加粗/斜体，Ctrl+E 循环切换视图模式（编辑 → 分栏 → 阅读）。

维基链接: 输入 [[ 会从工作区的笔记中自动补全， 链接会以 ]] 自动闭合。按住 Ctrl 单击 [[笔记]] 会打开对应的笔记。 连接面板会显示笔记之间的关联。

丰富预览: 用围栏包起来的代码块会显示在带语言标签和复制链接的框中； ~~删除线~~ 和 ==高亮== 会被渲染；GitHub 风格的标注 （> [!NOTE]、[!TIP]、[!WARNING]、 [!IMPORTANT]、[!CAUTION]）会变成彩色框。#hashtag 标签会高亮，并可用 Ctrl+单击打开对该标签的搜索；顶部的 YAML frontmatter 块（---）也会高亮。标签工具栏上有一个按钮可将笔记导出为 PDF/HTML，还有居中且可切换的阅读栏，以及编辑器/两者/预览模式。 Zen 模式（F11）和打字机滚动有助于无干扰地写作。

预览的新功能: 除了 ~~删除线~~ 和 ==高亮==，还支持上标 ^x^、下标 ~x~、 快捷表情（:rocket:）、URL 自动链接、脚注 [^1]、可折叠块 <details>、定义列表、 任务 - [ ]/- [x]（⬜/✅）以及 [TOC] 标记（预览中可点击的目录）；还支持本地图片和行内 HTML （<kbd>、<mark>…）。大纲面板 （标签工具栏）会跟随光标浏览标题，插入按钮（或右键菜单 → 格式/插入）可应用任何标记。

固定标题（sticky scroll）：滚动时，包含顶部行的标题会固定在编辑器顶部的条带中；点击即可跳转到该章节（在设置 → Markdown 中开关）。在树中右键单击文件夹可创建/打开文件夹笔记（带 frontmatter 的 index.md），可用作索引。

文件夹笔记与文件列表：双击文件夹会打开其 index.md（若存在）。在任意笔记中，单独占一行的 [files]（或 [arquivos]）标记会在预览中被替换为该笔记所在文件夹的文件列表（可点击的链接）——即时生成，不向文件写入任何内容（与 [TOC] 相同）。

文本与行操作。 代码编辑器的操作在笔记中同样可用——通过标签栏的文本按钮、 右键菜单，以及编辑菜单的行与清理子菜单：把当前行（或选中的多行）上/下 移动（Ctrl+Shift+↑/↓）、复制（Ctrl+Shift+D）、删除 （Ctrl+Shift+L）、排序（A→Z / Z→A）、反转顺序、合并行、删除 重复行或空行、删除空格以及大小写（大写／小写／反转）。行编号…会打开 一个对话框，可设置起始值、步长、前导零和分隔符；使用默认值 （". "）即可得到有效的 Markdown 有序列表。有选区时只作用于选区（会扩展到整行）； 没有选区时作用于整个文档——始终只占一步撤销。标签栏还提供 AI 按钮（询问 / 用 AI 编辑）， 与代码中相同的 Ctrl+K / Ctrl+I。

可折叠标题：点击标题左侧的小箭头（或使用 Ctrl+Shift+[ / Ctrl+Shift+]）即可折叠或展开该小节；视图菜单中有折叠/展开所有标题。 折叠纯粹是视觉效果——绝不会写入文件——并且 LightNote 会在会话之间记住它。从大纲或搜索 跳转到已折叠小节内部时，会自动展开该小节。

笔记属性：属性侧栏把 YAML frontmatter 显示为带类型的字段 （文本、数字、日期、复选框），顶部有类型选择框。设置类型和属性，正是把笔记汇集到 基库的前提。

连接图

工具 › 连接图（Ctrl+Alt+G）将工作区中的 所有笔记显示为一张交互式图。每个节点是一个 .md 笔记，每条线是一个维基链接。节点会自动布局（物理动画）， 并可拖动。悬停时相邻节点会被强调，其余则淡化。 单击会打开笔记。滚动可缩放（靠近时显示名称）， 拖动背景可平移。

标签工具栏: 按名称筛选（淡化不匹配的笔记）、 切换孤立笔记（无链接的笔记，灰色显示）、力度滑块 （斥力・距离・引力）、使图形适应窗口、重新扫描笔记。 连接越多的笔记节点越大，并按第一层文件夹分别着色。

表格（Parquet・CSV・JSON・Excel）

.parquet 文件会作为表格打开。.csv、 .tsv、.json 会作为文本打开，并在树的右键菜单中 提供作为表格打开。读取通过 DuckDB 分页进行 （按需），排序（单击表头）和筛选都交给引擎处理。 结构按钮会显示列、类型、行数，对 Parquet 还会显示行组和压缩。 该视图为只读。

表格上方的自由 SQL 栏接受任意 DuckDB 查询。 视图 t 代表当前打开的文件。从树中文件夹的 右键菜单选择将文件夹作为表格打开，可将相同格式的 所有文件作为一个表格读取。可从表格菜单将当前视图 导出（CSV/Parquet/JSON），并可从树的菜单将表格文件 转换为另一种格式。自由形式的 SQL 也可通过命令行的 query 命令或 MCP 使用。

Excel 电子表格（.xlsx）会以带工作表选择器的 只读表格打开。使用轻量读取器，无需安装 Excel。

复制为。在 LightNote 任意表格（Parquet/CSV/JSON、Excel、SQL 结果、任务、基础库）的右键菜单中，复制为会把选区以已排版的形式放入剪贴板。带格式的表格 (Teams、Outlook…) 会在支持富文本的程序中（Teams、Outlook、Word、Excel）粘贴为真正的表格，带边框和表头（不支持富文本时自动回退为 TSV）。其余以纯文本粘贴：Markdown 表格（可直接放进笔记）、CSV（按 RFC 4180 加引号）、TSV（制表符分隔）、HTML（<table> 标记）、JSON、JSONL（每行一条记录）、YAML，以及代码子菜单——生成可直接粘贴到源文件的字面量：Python（字典列表）或 JavaScript / TypeScript（对象数组）。在 JSON、YAML 和代码中，数字单元格不加引号输出——但原始文本会被保留，因此像 007 这样的 ID 仍是文本。Ctrl+C 仍按 TSV 复制，与以前相同。

所有表格行为一致：Ctrl+F 聚焦快速筛选（“任意列包含”），计数器显示剩余行数，并提供导出为 CSV 的导出——.xlsx 表格、任务和基础库同样如此。网格的右键菜单依旧提供复制为。

结果图表。表格的侧边栏有一个图表按钮（柱状图、折线图或散点图）：聚合在 DuckDB 中执行（不会拉取原始行），并有一个添加到今日笔记按钮将图表保存为图像。结构面板还包含按列剖析——数值列的迷你直方图以及其他列的最常见值。

PDF 与图像

.pdf 文件在原生查看器（Qt6::Pdf，无重型依赖）中打开，由 CPU 渲染，不使用 WebEngine。图像在图像视图中打开；动画 GIF 在动画视图中播放。

标签页工具栏提供五个侧边面板，一次显示一个：目录（保存在文件本身中的目录——若 PDF 没有目录，按钮会被禁用并说明原因）、缩略图（随滚动渲染的页面一览）、搜索、链接和属性（标题、作者、日期、页面与文件大小）。

搜索（Ctrl+F）会遍历整个文档：匹配项在页面上高亮显示，并连同上下文列出，F3 / Shift+F3 在它们之间跳转。扫描是逐步进行的，因此列表会随着文档被遍历而增长。

页码输入框既接受编号也接受印刷页码：在前言部分使用罗马数字编号的文档中，输入 1 会跳到印刷的第“1”页，而不是第一张纸。页面模式按钮可在连续滚动与单页显示之间切换。

受密码保护的 PDF 在打开时会要求输入密码（最多三次）；取消则只是不打开该标签页。在同一次运行中不会再次询问：应用会在因闲置而释放标签页后自行重新打开它，那样等于是它自己制造了麻烦。在提示框中勾选“记住此文件的密码”，密码在以后的运行中同样有效：它由 Windows 保护（仅限本机的你），绝不会进入 Git 或云端，也不会随配置导出一起带走。要全部删除：设置 → 功能 → PDF 密码。受保护的 PDF 不会在启动时自动重新打开——与其在显示窗口之前排起一串密码提示，不如等你自己去打开。

在工具栏的操作菜单中：复制本页文本、导出整个文档的文本、将页面复制或另存为图像，以及将页面发送到今日笔记。链接面板之所以存在，是因为 Qt 的 PDF 组件会自动跳转内部链接，却忽略外部链接——网址正是从这里打开的，并会先行确认。

限制：无法用鼠标选择文本，因为 Qt 的 PDF 组件不提供该功能。要带走内容，请使用“复制此页文本”或导出文档。

图像：为截图添加标注

图像会在带有独立工具栏的标签页中打开：除了旋转、镜像和缩放，它还带来标注工具——从截图、指出重点，到把成果带进文档的完整路径。

初始工具是移动：拖动仍然移动图像，和以前一样。选择用来选取一部分——拖动创建，从内部拖动移动，用四角和四边的手柄调整大小；Esc 取消选择，Del 擦除该区域的内容。在移动模式下，Shift+拖动同样是选择。在任何工具下，鼠标中键都可以移动图像。

吸管从图像本身取色：左键送到边框颜色，右键送到填充颜色。它读取的是已标注后的图像，所以也能重复你刚做的那处标注的颜色。

其余工具用于绘制：矩形、椭圆、箭头、直线、高亮（半透明，像荧光笔）、画笔（自由绘制）、画刷、编号步骤（自动编号 1、2、3……）、文本、模糊和聚光（使所选区域以外的部分变暗）。绘制时按住 Shift 可锁定正方形／正圆和 45° 角。

颜色有两种，对应两个按钮：边框色（同时也是线条色和标签色）和填充色，后者可以是无。没有填充时，矩形和椭圆只画轮廓，编号步骤和文本以边框色作为背景，标签则用白色或黑色——取对比更强的那个。选择填充后，它成为形状的内部和标签的背景，而边框色成为文字的颜色。

画刷用填充色涂抹，大小等于线条粗细——通过粗细旁边的按钮切换圆形或方形。单击一次就会留下痕迹。把填充设为白色，它就是橡皮擦：盖住下面的东西。

粗细作用于线条、标签的大小以及模糊的块大小；在忽略它的工具中会变灰。颜色和粗细会在会话之间记住。Ctrl+Z 和 Ctrl+Y 撤销和重做标注，清除标注一次删除全部（同样可以撤销）。

模糊是用来隐藏的（令牌、电子邮件地址、路径等）。标签页打开期间标注是可逆的，但在保存或复制时，该区域的像素会被真正破坏：输出的文件不会在任何地方保留原始内容。

有三个名字相近、作用不同的操作。剪切（Ctrl+X）把所选区域复制到剪贴板并擦除该区域，用填充色涂上（没有填充色时为白色）——而选择框仍留在原处，因此紧接着粘贴会把这块内容原封不动地送回它出来的位置，处于浮动状态：这就是移动图像局部的做法。Del 就是不复制的剪切。而图像菜单中的仅保留所选区域正好相反：保留该区域、丢弃其余部分，并改变图像的尺寸。

这一家族的其余成员：复制带走标注后的图像或仅所选区域；粘贴把剪贴板中的图像作为浮动粘贴带进来——用同样的手柄移动和调整大小，然后在外面点击（或按回车）即可保留，Esc 则丢弃；Ctrl+A（或 Ctrl+T）选择整幅图像。此外还有保存（把标注写入文件本身）、另存为...，以及发送到今日笔记，它会把 PNG 保存到 Anexos/ 并在笔记中插入 ![]()。只要还有未保存的标注，标签页就带着星号，关闭时会询问是否保存。

图像按钮汇集了作用于整幅图的操作：旋转、镜像、按百分比调整大小、缩小到 1600 / 1200 / 800 px 宽（截图天生就比文档所需大得多）、裁掉纯色边框、添加边距、投影，以及将标注写入图像——最后这项当场把标注变成像素，这样就能在标注之上做模糊。调整大小会一并带走标注和线条粗细。

不离开 LightNote 就能截屏：托盘菜单中的捕获屏幕...（或 Ctrl+Alt+P）会冻结桌面，拖动选择区域（Esc 取消），截取的部分会在新标签页中打开，随时可以标注。

限制：已经画好的标注不能移动也不能编辑——用 Ctrl+Z 撤销后重画；动画 GIF 和 WebP 在动画视图中打开，没有标注功能；.svg 在读取时会被栅格化，因此保存时会询问 PNG 的目标位置。

作为文件夹的 Zip（.zip）

.zip 会在专用标签中打开。左侧是成员的树（名称・大小・日期）， 右侧是所选成员的内容（文本/代码、带预览的 Markdown、图像、PDF）， 它们都在内存中打开，不会向磁盘解压任何内容。文本和 Markdown 可编辑， 按 Ctrl+S 会改写 .zip 中的成员。

同一个标签页还能打开 .7z、.rar、.tar（含 .tar.gz、.tar.bz2 和 .tar.xz）、.cab 和 .iso——这些是只读的：可以浏览、查看和提取成员，但不能编辑。只有 .zip 可写，因为它是我们能够安全重写的唯一格式（.rar 是专有格式，连自由库也无法压缩它）。

图像和 PDF 为只读。非常大的成员（以及 .parquet） 仅提供解压到…。不支持创建、重命名或删除成员。

受密码保护的成员可以正常读取：打开其中一个时，LightNote 会要求输入密码（最多三次）；勾选“记住此文件的密码”后就不再询问——默认在同一次运行中有效，勾选后在以后的运行中同样有效（由 Windows 保护，仅限本机的你；在设置 → 功能中可全部删除）。请注意该格式与 PDF 的一个差别：.zip 的加密是按成员进行的，而目录保持明文，因此即使没有密码，文件列表也会完整显示——受保护的只有内容。含有加密成员的 .zip 不会在启动时自动重新打开。

块（.lnb）

块捆绑包是名称以 .lnb 结尾的文件夹，在树中被视为 一个单独的项目（双击打开）。每个块都是磁盘上的实际文件， 其顺序保存在捆绑包根目录的 blocks.json 中。它像笔记本一样工作， 由层叠的代码或文本单元格组成。

每个单元格都有名称、类型按钮（设置解释器/词法器）以及复制、插入、删除、 运行按钮。运行到此处会依次运行直到当前单元格的所有代码单元格。 输出（stdout+stderr）显示在单元格正下方的面板中。可从树（新建）或 文件 → 新建创建。

Ctrl+Enter 执行获得焦点的单元格 — 与 SQL 编辑器相同的操作。

结果会被保存（就像实验记录本）：运行结束后，每次执行都会成为捆绑包内 saida/<单元格>/ 下的一个 .md 文件 —— 包含时间、退出码、 耗时、命令以及输出本身。由于是 Markdown，可在任何编辑器中阅读，随笔记本一起在 Git 中版本管理， 并可被AI 聊天检索到。重新打开捆绑包时，面板上方会恢复 上次运行条：点击它即可查看结果，无需重新运行。

历史：该条旁边的历史按钮会列出该单元格之前的执行（时间和退出码）—— 便于比较同一单元格在不同时间返回的内容。每个单元格保留最近 10 条；如需更改，请编辑 捆绑包 blocks.json 中的 historyLimit 键（0 关闭保存）。 过大的输出会被截断（文件中标记 truncated: true）。重命名单元格或更改其类型时， 历史会一并带走；删除单元格会把其历史送入回收站。

让 SQL 单元格连接真实数据库：通过顶部的条（选择连接…）把笔记本指向一个 .lnc 连接，sql 类型的单元格就会在数据库中执行， 而不再走解释器。SELECT 的结果会成为输出文件中的表格（真正的 Markdown， 任何查看器都能格式化显示）；INSERT/UPDATE 等会报告改动了多少行， 数据库报错则中止脚本并记下失败的语句。每次查询最多取 100 行（若还有更多，文件会注明）—— 结果是一份记录，而不是整表的副本。

连接以相对路径保存在 blocks.json 中，因此移动或同步文件夹后笔记本仍可用。 若想要自包含的笔记本，可把 .lnc 本身放进捆绑包：它算配置，不会变成单元格。 它与数据库标签页是同一个连接——在一处连接对另一处同样生效，密码遵循 安全短语的规则。未指定连接时，sql 单元格仍像以前一样由所配置的解释器运行。

任务（看板 / 甘特图）

任务捆绑包（.lnt）会打开一个任务看板，具备看板（状态列，拖动卡片）、 甘特图（基于工作量的排程）和日历视图。 每个任务可以有标题、列（状态）、以小时为单位的工作量，以及关联的 .md 笔记。 任务也可通过 MCP 和 CLI 由 AI 处理 （创建・移动・更新・读写笔记）。

每个任务的字段: 除状态和工作量外，每个任务还有优先级 （为卡片边框着色并对表格排序）、截止日期（逾期时显示红色标记）、多个标签、 子任务清单（卡片上显示进度徽标）和重复（完成一个重复任务会生成下一次）。 可在右键菜单（表格/看板）和属性面板中编辑它们。

捕获与列表: 托盘的快速任务能理解自然语言 （例如 Pay bill tomorrow 5pm #home !high；表示日期、时间和优先级的词需用 英语或葡萄牙语书写）。模板按钮可保存/应用任务模板； 按截止日期分类可筛选今天/未来 7 天/逾期；已保存视图会保存 筛选与排序；托盘/启动器会为今天到期或已逾期的任务显示提醒。

看板: 可按状态、优先级或标签对列分组，创建泳道，为每列设置 WIP 上限（超出时列头变红），并对卡片排序。Linear 风格的键盘操作: ←/→ 移动焦点，Ctrl+←/→ 移动卡片，N 新建，Space 完成/重开， Delete 删除。还有日历视图（按截止日期）。

内嵌笔记: 选中一个任务会在各视图旁显示它的 .md 笔记 （切换任务时自动保存）；笔记按钮可切换编辑器，在标签中打开笔记会在 独立标签中打开它。归档一个任务会将其从所有视图中隐藏；显示已归档开关 可显示已归档的任务（淡化）。

在任务设置中可以设置完成的任务在 N 天后归档：打开看板时，停留在最后一列超过该天数的任务会被自动归档（0 = 关闭）。

笔记默认以内嵌方式打开（双击任务），并在输入时自动保存——任务在关闭时从不询问“保存吗?”。笔记内同样可用 AI 操作（Ctrl+K / Ctrl+I）。

标签栏。依赖所选任务的操作（删除、依赖、历史 (Git)）以及导出 CSV 都收进了 ⋮ 按钮。视图按钮汇集按到期日的列表、已保存视图和显示已归档——它们都作用于表格。Ctrl+F 聚焦快速筛选，右侧计数器显示筛选后剩下多少任务。

自定义表格（.lnd）

自定义表格（.lnd，文件 → 新建）是你的 小型数据库。你可在运行时定义列（文本・数值・日期・带颜色的固定列表・ 路径・标签・密码），并像电子表格一样录入行。还支持排序和 筛选。路径字段会把行整理成一棵树 （例如 家/办公室）。

密码单元格使用安全口令逐个加密， 在需要时显示。与任务一样，捆绑包以适合 Git 的文本（NDJSON）保存， 因此可进行版本控制，并在多台机器之间合并。

在文本列中，打开单元格会显示一个浮动的多行编辑器。 Enter 换行，Ctrl+Enter 确认。在网格中文本以单行显示 （带 …），完整内容显示在工具提示中。要更改列的类型， 请使用表头菜单。文本 → 密码的转换会用安全口令 加密值，密码 → 文本的转换会要求确认以及 PIN/安全口令后 将内容作为明文写入（不可撤销）。其他转换会保留值。

基库（笔记的已保存查询）

基库（.lnq，位于文件 → 新建 → 新建基库）是对笔记的 已保存查询：按类型和属性筛选，并以表格或看板查看结果。 基库不存储任何数据——行就是你的 .md 笔记，每个单元格的事实来源是笔记的 frontmatter。删除 .lnq 不会丢失任何笔记。

编辑单元格即写入笔记。 在表格中修改属性，只会重写该文件 frontmatter 的那一行。 在看板中把卡片从一列拖到另一列，会写入分组属性的新值（例如从在读改为 已读）。

每条笔记在 frontmatter 中声明自己的属性（type、status、 author 等）。使用笔记的属性侧栏，可以把它们作为带类型的字段 （文本、数字、日期、复选框）来编辑，而不是直接写 YAML——参见 Markdown 笔记。

.lnq 采用 NDJSON（每行一条记录），专为 Git 设计：两台机器可以 并行编辑同一个基库——一台新增列，另一台调整筛选条件——合并时会保留双方的修改且不产生 冲突。

声明的架构（可选）。 LightNote 默认会根据笔记实际使用的内容推断每个 类型的字段——你无需声明任何东西。若想固定架构，请打开工具 → 笔记类型...（或笔记 属性迷你栏上的齿轮按钮）：声明每个类型的字段、它们的数据类型（文本、 数字、日期、复选框、选项列表）以及默认模板。有了架构，选项列表字段会 变成只含允许值的下拉框；声明的字段即使还没有任何笔记使用，也会出现在 Base 的列与 筛选选择器中；应用类型模板按钮会插入笔记的骨架。架构位于 .lightnote/types.ndjson——可合并的 NDJSON，与笔记一起纳入 Git 版本管理； 删除它不会改动任何笔记，只是回到推断模式。

文件内搜索与待办项

要在侧边栏的搜索标签中进行全局搜索，请使用 Ctrl+Shift+F。 它使用 ripgrep，支持正则表达式・区分大小写・全字匹配・批量替换。 在当前文件内，用 Ctrl+F 查找，Ctrl+H 替换。

高亮与标记是两回事。快速查找（Ctrl+F）只是用琥珀色高亮匹配项： 这是临时的，关闭查找栏或清空输入框后就会消失。而编辑 → 高级查找…中的标记全部 则是你的主动决定——它把匹配项涂成红色，并在对应的行上添加书签（边栏上的蓝色圆点）， 直到你使用清除标记为止。两者互相独立：关闭快速查找不会抹掉你标记的内容， 清除标记也不会抹掉查找的高亮。二者都会显示在缩略图的标记条上，各用各的颜色。

侧边栏的待办项章节会把代码中的 TODO/FIXME 标记以及工作区 Markdown 笔记中的任务 （- [ ]）汇集到一处。单击即可直接跳转到对应行。

版本控制（简易 Git）

版本控制按工作区选择启用。在工具 → 工作区设置中 启用后，LightNote 会创建一个 Git 仓库（如果还没有），并显示 版本控制侧边栏（Ctrl+Shift+G）。

在自动模式下，LightNote 会在常规设置中选定的时机（保存时・关闭标签时・ 关闭窗口时）自动保存版本（提交）。在手动模式下， 你在面板中写一条消息来保存版本。状态栏的指示器会显示状态 （无更改、X 项更改…），单击会打开工作区设置。 你可以查看每个文件的差异，并还原（放弃）未保存的更改。

自动化按文件夹分为 3 个级别（在工作区设置中）:手动（不自动）、 自动提交（自动保存版本，但不同步）和全自动（提交并同步——提交后 推送＋定期拉取；需要无提示的 Git 凭据）。面板会显示相对于远程的↑ 待发送 / ↓ 待接收 状态行；当有待发送的版本时，主按钮会从提交变为同步——这样就能清楚地看出， 保存之后还需要同步。

Git 面板和树的 Git 菜单提供按文件的 添加 (git add) 和 还原 (git restore)，以及 并排比较（整个文件与上一版本比较）。

快照与备份

从版本控制面板的 ⋯ 菜单（或工具）:

• 创建快照: 为当前状态加上日期时间标签，以便日后回退。
• 还原快照: 选择一个快照和操作 — 在保留历史的同时取回文件（推荐）、 将历史回退到该时点，或作为独立副本打开。
• 导出副本（.zip）: 将整个工作区压缩为一个自包含文件 （嵌入项目标记），用于发送或在别处保存。
• 移动工作区文件夹…: 在磁盘上移动根目录，并调整会话和 注册表中的路径。

审查更改（检查点）

工具 → 审查更改…会在一个标签中显示自某个基准以来工作区中 所有更改的汇总差异。左侧是新增/更改/删除的文件列表，右侧是所选 文件的差异。它的设计目的是在接受工作前 审查 AI CLI 会话更改了什么。

基准可以是最新版本（HEAD）或检查点。在开始任务前 创建一个检查点（标签上的按钮），之后再比较。检查点不会 创建提交，也完全不触动历史。需要在文件夹中启用版本控制。

批量评论。在查看 AI 会话时，评论按钮（文件列表的右键菜单中也有）会为选中的文件记下一条评论，并锚定到你选择的片段。评论会积累在列表中，只有点击发送到会话时才会以一条消息一起发往 CLI 终端。这是故意的：逐条发送会让智能体修好一处又弄坏另一处，因为每一轮都看不到其他意见。修订后，评论仍留在列表中，便于你核对是否已处理；勾选已解决的条目，剩下的会进入下一次发送。若智能体重写了被评论的区域，评论会变淡而不是消失。 发送会在状态栏中确认，处于休眠的会话会自动恢复以接收这批评论。

文件比较（差异）

工具 → 比较两个文件…会将两者并排（两个编辑器）打开， 并逐行标出差异。比较为只读。

◀ / ▶ 按钮（或 F8 / Shift+F8）跳到上一处/下一处更改。通过 Git 面板还可将文件与已保存版本并排比较（HEAD 对 磁盘）。

运行代码（F5）

工具 → 运行文件（F5）会保存当前文件，并根据为该扩展名注册的 解释器在终端中运行它。默认覆盖 .py、.sh、 .bat、.cmd、.sql。解释器可在 设置 → 运行中编辑/添加。

命令是含有 {file}（文件）、{folder}（文件夹）、 {name}（名称）的模板。例如对于 Python 即为 python {file}。你也可以用 Ctrl+Shift+Enter 仅将选区/当前行 发送到终端。在块中，每个单元格都以同样的方式运行。

当打开多个终端时，运行按钮带有下拉箭头，用于选择并记住目标终端。

可点击的错误。 在输出面板（F6）中，文件:行号形式的引用会变成链接：Ctrl+点击或双击即可在该确切位置打开文件。支持 Python 回溯、Node 调用栈、编译器（gcc/clang/MSVC）错误以及 linter 输出。只有磁盘上确实存在的路径才会变成链接，其余仍是普通文本。

逐个查看错误。 在输出面板中，F8 跳到下一个错误，Shift+F8 跳到上一个（面板栏上也有按钮）。跳转是循环的：它会把输出滚动到该处、高亮该片段，并在准确位置打开文件。

终端与 AI CLI

逐命令状态圆点。 你运行的每条命令旁会出现一个圆点：成功为蓝色，失败为红色（工具提示显示时间、耗时和退出码）。LightNote 会在 PowerShell 和 Git Bash 中自动启用，无需更改你的配置——可在设置 → 终端 → Shell 集成中开关。其他 shell（cmd、WSL）或自定义命令不会显示圆点。

用 Ctrl+'（在美式键盘布局上也可用 Ctrl+`）打开集成终端（通过 ConPTY 的完整 VT 模拟器）。 它会成为一个标签，可在窗口的各区域之间移动。可用的 shell 以及在 PATH 中检测到的 AI CLI（例如 claude），可在设置 → 终端和 设置 → AI 助手中配置。在新建终端菜单中选择某个 AI CLI 时， 该 CLI 会作为终端打开 — TUI/颜色照常显示，退出时标签 关闭。

安排发送。在终端的右键菜单中，安排发送…可让你稍后发送一个 Enter（或一段文本）——非常适合在使用限额重置时继续某个 AI CLI， 无需一直盯着。可选择触发方式：在某个时间、经过若干分钟、每隔 一段时间（重复），或当终端空闲时。计算机会保持唤醒直到触发。 只要终端标签保持打开，该安排就有效。

你可以同时拥有多个安排。当存在安排时，菜单项会显示已安排的发送 (N)…， 并打开一个管理器: 一个列出终端、将发送的内容、时间，以及到下次触发的 实时倒计时的表格，带新建、编辑和移除按钮。只要存在安排， 状态栏就会出现一个带计数的时钟指示器（单击可打开管理器），并有一个小时钟 标记已就绪的终端标签。

AI 回合结束提示。 当某个 AI 命令行终端安静下来时——这表示智能体已经结束了本回合——LightNote 会提醒你：出现一个浮层提示（点击即可切换到该终端），标签页闪烁数次后保持高亮，直到你打开它。如果窗口在后台，任务栏按钮也会闪烁。该提示只对 AI 命令行终端生效，并且只在该标签页未获得焦点时出现。可在 设置 → 终端 → AI 回合结束提示 中开关并调整静默时长。

终端会随窗口一起回来。关闭并重新打开工作区时，普通 shell 的终端（命令提示符、PowerShell、Bash）会被重新打开，而且是在你当时所在的文件夹，不是终端最初打开的那个。屏幕内容不会回来，但命令历史属于 shell 本身，仍然保留：↑ 键照常可用。AI 助手会话不在其中，仍会单独询问，因为新终端并不是同一段对话。环境变量以及你在该会话中手动激活的环境（例如 venv）也不会回来：终端会在正确的文件夹打开，但它是一个全新的 shell。

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

默认 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 和模型。什么都没有删除，只是从初学者的路上挪开了。

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

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

逐块接受。 当结果以差异形式呈现时，你不必全部接受：每个更改的代码块都有一个复选框来决定是否包含，最终文本仅由你保留的代码块重新组合而成。提示还会带上文件的自动上下文（路径、语言以及选区周围的行），让 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 助手。

AI 会话

AI → AI 会话… 打开一个驾驶舱，以每个会话一张卡片的形式列出在任意 LightNote 窗口中打开的每个 AI CLI 终端——包括彩色状态圆点、CLI 名称、窗口，以及需要注意的事项徽章（已排定的发送、隔离副本）。双击可聚焦该终端；卡片的 ⋯ 菜单（或右键）提供查看该会话的更改（以会话开始时创建的检查点为基准打开审阅界面——参见 查看更改）以及排定一次发送。这是同时盯住多个“vibe coding”会话而不在窗口之间迷失的方式。

当你在 Git 仓库中将 AI CLI 作为终端打开时，LightNote 会自动保存一个检查点（标记为“会话 …”），以便你之后准确查看并还原该会话所做的更改。该功能可在设置 → 常规 → 功能中关闭。

隔离副本（worktree）：在 Git 文件夹中，LightNote 可以在文件夹的隔离副本（独立分支）中运行 AI 助手，而不改动你手动编辑的文件。首次会询问，之后自动进行（在工作区设置 → 集成中按文件夹开关）。隔离副本徽章标记该会话（分支和路径在提示中），合并…菜单项（把改动带入你的文件夹——若有未提交的改动会先询问）和丢弃…（丢掉副本和分支）负责收尾。

会话空闲提醒。当 AI CLI 空闲时（已完成或正在等你），LightNote 会显示通知；点击即可打开该会话更改的审查。这样你可以启动任务后就离开。可在设置 → 终端中关闭。

项目上下文文件。当你在没有上下文文件（CLAUDE.md 或 AGENTS.md）的文件夹中打开 AI CLI 时，LightNote 会提示生成一个——你也可随时通过工具 → 生成项目上下文文件…创建。好的上下文文件描述项目的结构和约定，帮助 AI 减少错误，无需你每次会话都重新解释。如果配置了 AI 提供商，则由它生成内容；否则你会得到一个供填写的骨架。

休眠空闲会话。闲置的 AI CLI 仍会占用内存（对话和模型客户端）。在设置 → 终端中可以设定一个静默时长，超时后 LightNote 会终止该进程，并在你回到该标签页时自动恢复——终端历史仍留在屏幕上。默认开启（30 分钟；实测中三个空闲的 Claude Code 会话占用超过 1 GB），且仅适用于运行在独立副本中、且其 CLI 知道如何恢复该文件夹对话的会话（目前为 Claude Code 和 Antigravity），否则恢复会带回另一个会话的对话。 设有定时发送的会话不会休眠。此外，恢复的是对话，而不是工具的界面：已输入但尚未发送的文本会丢失。

活动标签页。表格显示当前正在运行的内容；活动标签页保留历史：每次智能体完成本轮、在独立副本中开始或进入休眠，都会连同时间和最后一条回复的片段一起记录。未读项以粗体显示，计数也会出现在托盘菜单中——这样离开电脑的人也能看到自己错过了什么，因为通知是瞬间即逝的。打开该标签页会将全部标为已读；双击可返回该会话。 会话的结束同样会记录（包括 CLI 自行退出的情况），因此在你离开时结束的会话会留下痕迹，而不是直接消失。如果事件对应的会话已不再打开，双击会给出说明，而不是毫无反应。

AI 聊天

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

窗口布局。 选择器都在顶部的同一条栏里：AI、笔记文件夹，以及——当有文本编辑器活动时——上下文；右侧是两项权限（工具 和 允许修改）和 + 按钮（开始新对话）。在提出第一个问题前，界面会说明本窗口将针对什么作答，并提供如 总结此文件夹 的一键快捷方式。在提问框中，Enter 发送，Shift+Enter 换行；答案返回期间，发送按钮会变成 停止。

让 AI 使用工具。允许修改复选框会改变工作方式：模型不再只根据关键词检索取回的片段作答，而是可以自己去查——读取文件、搜索笔记、列出任务——然后再回答。打开时，LightNote 会立即测试所选模型是否会调用工具：许多服务商会接受请求却干脆忽略工具，若不检查就会得到一个看似查证过的编造答案。结论按“服务商+模型”组合记住七天。需要API 服务商（本地 CLI 无法接收工具）。回答末尾会列出实际用过的工具，便于你判断而不是盲信。 如果判定为否定——提供商可能只是当时无法访问——消息旁会出现重新检查按钮，忽略已保存的结果重新测试。

让 AI 修改你的东西。第二个复选框允许修改是单独的一步，默认关闭。打开后，AI 还能创建笔记和任务、修改属性并写入今天的笔记——但没有你的确认就什么都不会发生：更改会以清楚的措辞出现在对话中（“创建任务 买面包”），并附允许与拒绝。拒绝不会结束对话；模型会被告知并继续解释或提出别的办法。读取从不询问，只有修改才会。覆盖任意文件和访问网络被有意排除在外：只要 AI 仅仅读取，从外部同步进来的笔记中夹带的恶意文字就无法变成对你磁盘的改动。 如果改动是写入今日笔记，请求还会说明它会落到哪个文件夹——这是唯一一种目标文件不在 AI 请求内容中的写入。

笔记，还是打开的文件。 窗口顶部的 上下文： 下拉框决定对话的主题：Vault 笔记（默认，见下文）或 当前编辑器 —— 后者回答关于编辑器中打开的文件而非 vault，使用选区及其周围的行（或勾选 整个文件 使用整份文件）。这样同一个窗口既能谈你的笔记，也能谈你正在编辑的代码，可多轮进行。当前编辑器 仅在有活动文本编辑器时出现。此外，在快速助手（Ctrl+K）中，结果里有一个 在聊天中继续 → 按钮，它会以 当前编辑器 上下文重新打开本窗口，并带入那一轮的问题与回答 —— 无需重来即可深入。

问哪些笔记？ 该窗口只有一个，每次只针对一个文件夹作答——顶部栏中 AI 选择器旁的 笔记来自： 下拉框显示并选择目标。它打开时已指向你打开聊天的那个窗口的文件夹，并列出当前打开的文件夹，其后是最近使用的；选择文件夹… 可指向其他任意文件夹。切换后对之后的提问生效——你可以一边在某个项目中工作，一边询问另一个项目的笔记。手动选择的文件夹会一直有效，直到你再次更改（重新打开窗口不会把范围拉回去）。 提问处理期间（包括停下来等待你确认时），AI、上下文和文件夹选择器都会锁定：正在返回的答案属于你提问时的模型和文件夹。

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

更好的搜索、总结与改写。 检索使用带 BM25 排序的本地索引，忽略重音（“configuração”能找到“configuracao”），并且在没有词间空格的语言（日语、中文、韩语）中也有效——索引尚在构建时由 ripgrep 兜底。总结此文件夹 按钮会在你没有具体问题时生成所有笔记的概览。在 设置 → 常规 → 功能 中，用 AI 改写问题 选项会在搜索前把你的问题扩展为关键词（每个问题消耗一次 API 调用）。

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

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

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

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

HTTP API 测试（.lnh）

工具 → 新建 API 测试（.lnh）…会打开一个保存在 .lnh 文件中的 HTTP 客户端。一个文件代表一个端点（方法・URL・标头・ 正文），并在左侧列表中保存多个测试。每个测试都有用于 URL・标头・正文的 {名称} 变量的值，以及最后一次执行的结果（状态・时间・日期・响应 标头和正文）。它还会显示等效的 curl 命令。同样的单次操作也可通过 CLI（http）和 MCP（http_request）使用。

Ctrl+Enter 发送请求。

导入和导出 OpenAPI。 测试列表顶部的箭头按钮可打开导入 OpenAPI… 和导出 OpenAPI…。导入会读取 YAML 或 JSON 格式的规范，支持目前在用的三代 — Swagger 2.0、OpenAPI 3.0 和 3.1 — 并自动组装测试：路径中的 {参数} 与 .lnh 的 {名称} 变量语法完全一致，规范中声明的 示例会成为测试的取值，安全方案会变成 Authorization 请求头，而每个声明的服务器都会 成为一个独立的测试（预发布与生产并列）。由于一个 .lnh 只保存一个端点，包含 多个操作的规范会询问要导入哪一个 — 也可以一次全部保存，每个操作生成一个 .lnh 文件。

导出则走相反的方向，从文件生成一份 OpenAPI 3.0.3 规范：服务器、参数和请求体来自模板，示例 响应来自已记录的执行。它是一个骨架，而不是完整的契约 — .lnh 描述的是调用， 因此类型、描述和数据结构不会被重建。你的测试会保存在 x-lightnote-tests 字段中， 所以重新导入该文件时可以原样恢复。

导入 curl 命令。 在同一个按钮中，导入 curl 命令… 会打开一个粘贴框 —— 命令来自剪贴板而不是磁盘，若剪贴板中已有 curl，该框会自动填好。它能识别同一条命令流通的 三种方言：Chrome/Firefox 的复制为 cURL（单引号）、Windows 上的 Copy as cURL (cmd) （使用 ^），以及用 \ 换行的文档示例。方法取自 -X，未指定时 则推断：有请求体为 POST，没有则为 GET。

导入是逐字的：任何取值都不会自动变成 {名称} 变量，因为猜测哪个令牌是机密会出错。 有几种情况会给出提示而不是含糊其辞 —— 来自文件的请求体（-d @文件）无法读取，multipart 上传（-F）也无法忠实复现，因此这些字段会以文本形式放进请求体，供你调整。

数据库（.lnc）

连接是工作区内的 .lnc 文件（LightNote Connection）。 它可用 Git 进行版本控制，并可在机器间携带。可通过新建 → 新建连接创建， 或打开现有的 .lnc。这会打开数据库视图，显示连接状态 栏（连接 / 断开 / 重新连接 / 编辑）、架构树（架构 → 表 → 列， 按需加载）以及内部的 .sql 标签。打开过的 .sql 文件和最近项保存在 .lnc 内部，因此 视图会以之前的状态重新打开。如果之前什么都没打开，则会以一个可立即输入 SQL 的 空（无标题）查询开始。保存时（Ctrl+S），LightNote 只会询问名称， 并把文件写入项目文件夹内（没有“保存到任意位置”的对话框）。+ 标签 按钮会打开一个新的空查询，或打开文件（选择器在项目文件夹中打开）， 也可选择最近项或项目文件夹中的任意 .sql。

直接从树中打开的 .sql 仅是代码（SQL 高亮，无连接）。

驱动: SQLite 和 DuckDB（文件）为原生。PostgreSQL、MySQL/MariaDB、 SQL Server、通用类型通过 ODBC。原生 Oracle（不使用 ODBC）。 SQL Server 使用 Microsoft 的 msodbcsql 驱动（请在机器上安装）， 提供 Windows 身份验证或用户/密码，以及通道加密选项 （Encrypt / 信任证书）。对于 Oracle，请在常规设置 → 数据库中设置 Oracle Instant Client 文件夹 — 它在运行时加载， 无需安装。Oracle 连接有四种模式: 服务名 （主机/端口/服务）、SID（主机/端口/SID）、TNS 名称 （客户端文件夹中 tnsnames.ora 的别名）、完整的 TNS 描述符 （粘贴到文本框中）。

密码: 开启保存密码后，会在 .lnc 文件自身中 加密（采用可移植的加密，在其他机器上也能打开）。关闭时不保存密码， 并在每次连接时询问。加密使用按工作区的安全口令， 在帮助 → 配置安全口令中设置。请妥善保管 — 没有它， 在其他任何地方都无法打开密码。安全口令仅缓存在本地机器上 （绝不会发送到 Git）。

开启打开时连接后，打开 .lnc 时会自动建立连接。 自动连接为静默进行。如果需要输入密码（询问模式，或机器上 未缓存安全口令的加密），文件会以未连接状态打开，而不中断。

执行: Ctrl+Enter 执行光标处的语句，Alt+X 执行整个脚本。 结果会分页显示，每个结果标签都带有底部操作栏: 获取下一块或所有行、总计数、更改行上限、 刷新（重新执行）、查看/复制 SQL、导出...、从选中行 生成 SQL。

结果网格: NULL 以淡色斜体显示，区别于空字符串，数字右对齐；选择多个单元格时，页脚会 显示选择计数，当它们是数值时还显示合计与平均值。页脚栏的值面板按钮（或右键菜单的 在面板中查看值）会打开一个侧面板，完整显示所选单元格的完整值，不截断，并带有格式化 按钮，仅在显示时美化 JSON/XML。在单元格的右键菜单中，按此值筛选 / 排除此值会以该单元格 加上 WHERE 重新执行查询，而转到引用的记录会沿着该列的外键，按单元格的值查询父表。

执行计划: 工具栏的执行计划按钮显示光标处语句的 EXPLAIN（SQLite、DuckDB、 PostgreSQL 和 MySQL）；在不通过单条语句提供计划的数据库（SQL Server、Oracle）上，该按钮会被禁用，原因 显示在提示中。

对象属性: 在架构树中双击某个表（或按 F4，或在右键菜单中选择 属性），会打开一个标签页显示对象结构，分为四个子标签: 列（序号、名称、类型、是否可空、 默认值，主键列带有钥匙图标）、键（主键、外键、唯一和检查约束；双击外键会打开被引用的表）、 索引和 DDL — 对象的 CREATE TABLE，可复制、另存为 .sql 或在可编辑标签页中打开。当数据库不直接提供现成 DDL 时（PostgreSQL 和 SQL Server 没有该命令）， LightNote 会根据元数据重建（DDL 命令因权限不足被拒绝时同样如此），并在标签页中明确说明。 如果连列的目录都无法读取（没有权限，或目录不可用），就没有可重建的依据：标签页会给出说明，而不是 静默地留空。表的右键菜单还提供复制 DDL而无需打开 标签页。

架构树: 架构树将表与视图分开（各有自己的图标），并用钥匙图标标记属于 主键的列。筛选框只筛选已加载的对象（不会仅为筛选而强制按需加载）。

架构探索: 右键单击某个表可打开 在编辑器中插入 SELECT、查看数据、统计行数、 复制限定名，或 生成 SQL子菜单 → INSERT/UPDATE/MERGE。界面会列出表的列，你可以勾选包含和 键，查看实时预览并将命令插入到编辑器 （MERGE 以 ANSI 输出，驱动不支持时会显示警告）。 在结果网格上，底部栏的 生成 SQL 按钮会用选中行的值 生成 INSERT/UPDATE/DELETE（当查询为单表 SELECT 时可用）。 在树中浏览过的表名和列名也会开始出现在该连接 .sql 编辑器的 自动补全（Ctrl+Space）中（不会进行额外的数据库查询）。

导出结果: 右键单击结果网格并选择导出结果...，可写出 CSV（分隔符・引用符字符・始终加引号・标题行・NULL 的表示）、 JSON Lines、SQL（带表名的 INSERT 语句），并可设置可选的行数上限。 导出不仅限于屏幕上可见的部分，而是以流式（分页重新获取）遍历整个查询。

脚本变量: 在脚本的行中用 @set 名称 = 值 定义变量。 @ 前缀使其不会被发送到数据库（不会与 Postgres/DuckDB/SQL Server 实际的 SET 冲突）。形如 :名称 的引用会在执行前被替换 （在字符串和注释之外。::类型 的转换和 :1 的绑定 保持不变）。没有值的 :名称 会在执行前弹出提示。工具栏上的 变量按钮会打开已定义变量的界面（编辑/添加/删除）。

查询历史: 历史按钮会打开一个窗口，以 SQL / 时间 / 耗时 / 行数列显示此连接上最近成功执行的语句。你可以选中后重新执行、 插入到编辑器、复制（双击即插入），也可清除历史。 它仅保存在本地机器上（既不发送到 Git 也不写入 .lnc）。

事务: 工具栏上有自动提交按钮（默认开启）以及 Commit/Rollback 按钮。关闭自动提交时，更改会保留到你确认（Commit）或放弃 （Rollback）为止。在事务打开时断开连接，会询问你如何处理。

SSH 连接（.lns）

SSH 连接是工作区内的 .lns 文件 — 与 .lnc 一样可 版本控制并可携带。通过新建 → 新建 SSH 连接创建后，会在标签中打开集成的 SSH 终端（通过 Windows 的 ssh.exe）和远程文件迷你栏 （SFTP）。

文件浏览器一次显示一个文件夹（类似 MobaXterm/WinSCP）。 第一行始终是用于返回上层的 ..，双击文件夹即可进入其中。 在顶部的路径栏中输入远程路径并按 Enter 即可跳转到那里。 与终端同步按钮会让显示的文件夹跟随 SSH 会话的当前目录 （即终端中 cd 到的位置）。右键菜单包含在编辑器中打开 （下载文件，在标签中打开，并在保存时重新上传）、下载、 上传、新建文件夹、重命名、删除、权限（chmod）。 你可以从资源管理器拖动文件到该面板，以上传到当前文件夹。

密码可以用工作区的安全口令 加密保存在 .lns 内，或在每次连接时询问。连接使用 系统的 OpenSSH 客户端，因此 Windows 代理/配置中的 SSH 密钥 照常工作。

打开时连接选项（在连接对话框内）会在打开 .lns 时 自动启动 SSH 会话。如果未保存密码，连接时终端自身会询问。

安全: 安全口令・PIN・安全 Markdown

安全口令按工作区在 帮助 → 配置安全口令…中设置， 它是 LightNote 加密一切的密钥: 连接密码（.lnc/.lns）、 自定义表格的密码单元格、.lne 文件。 加密强大且可移植（Argon2id + XChaCha20-Poly1305）: 只要重新输入 相同的安全口令，加密文件在其他机器上也能打开。请妥善保管: 没有它，加密数据无法恢复。安全口令仅缓存在本地机器上 （绝不会发送到 Git）。

要更改安全口令，请打开同一界面并编辑安全口令字段 （会以当前口令预填）。确认后，LightNote 会把工作区中所有 安全数据 — .lnc/.lns 密码、.lne 文件的 内容、自定义表格（.lnd）的密码单元格 — 从旧安全口令 自动重新加密为新口令。解密为全有或全无: 只要有一个解密失败， 就不会更改任何内容，LightNote 会告诉你是哪一个。写入时，每个文件在被改写前 都会复制为备份。如果某个文件写入失败，会询问你是全部撤销（恢复备份） 还是跳过该文件并继续（保持旧口令，最后给出警告）。 （“询问”模式的密码没有需要重新加密的内容。）

PIN（4-8 位）是一个可选的本地锁: 无需每次输入安全口令即可 保护敏感的 UI 操作（显示密码、打开安全笔记）。它不加密任何内容， 并且仅适用于本机。

安全 Markdown 文件（.lne，新建 → 安全 Markdown 文件）是 磁盘上加密的笔记: 打开时，LightNote 会询问 PIN（如已设置）和 安全口令，仅在内存中解密，并在保存时（Ctrl+S）重新加密。 为安全起见，即使会话被恢复，它也不会自动重新打开。

每日笔记・快速捕获・托盘

今日笔记是每日笔记文件夹内每天一个的 .md。该文件夹 对整个 LightNote 只有一个，在设置 → 笔记与写作中指定。从托盘菜单: 今日笔记会打开当天的笔记。快速捕获… （Ctrl+Alt+N，全局 Windows 快捷键 — 或 中键单击托盘图标）会打开一个小窗口，输入内容并按 Ctrl+Enter 后: 文本会作为带时间戳的项目写入今日笔记，直接写到磁盘， 而不打开编辑器窗口。

托盘菜单还会显示打开的窗口和最近的工作区，并带有电源 开关: 保持计算机唤醒和保持屏幕常亮 （适用于长时间任务。LightNote 在运行一次性 AI、块单元格、SQL 脚本期间会 自动保持电源）。启动器（起始窗口）带有搜索、双击打开，以及 置顶・在资源管理器中打开・从列表中移除的右键菜单。

作用于整个 LightNote 的操作——而不仅是当前窗口——都在常规菜单中（☰ 常规，或活动栏中带应用图标的按钮），它与托盘菜单的结构完全一致：根级是今日笔记、快速捕获和日历；接着是子菜单捕获（快速任务、录音、重新发现旧笔记、便签）、打开（启动器、打开工作区、打开独立文件、独立文件）和电源；最后是常规设置。规则很简单：托盘菜单里有的，常规菜单里也有——而且只在那里。将鼠标悬停在某一项上会显示提示“全局功能：在任何窗口中都作用于整个 LightNote”。

捕获会保存到哪里。每日笔记和快速任务有唯一且可预测的目标：设置 → 笔记与写作中设定的文件夹，以及设置 → 常规中设定的看板，在任何窗口都一样。首次捕获时若尚未设定，LightNote 会询问保存位置并记住你的选择——而不是让你去翻设置。需要独立日志的项目（有保密要求的客户、必须留在仓库中的记录）可以在工作区配置 → 捕获中接管该窗口的捕获；托盘和全局快捷键仍写入常规目标。确认提示始终会说明文本去了哪里。

托盘菜单刻意保持简短：根级只保留已打开的窗口和三个每天都会用到的操作——今日笔记、快速捕获和日历。其余都收进与常规菜单相同的子菜单：捕获、打开（在托盘中还包含最近工作区列表）、AI（AI 会话、询问笔记——在窗口中这是完整的 AI 菜单）和电源。最后是设置和退出。

重新发现旧笔记

让“第二大脑”失败的最大原因不是缺少功能，而是从不重读的笔记。通过托盘菜单（捕获部分），LightNote 把旧笔记找回来：随机笔记随机打开工作区中的一条 .md 笔记（避开最近两周出现过的），历史上的今天列出创建周年为今天（往年的同月同日）的笔记。这两个操作也在窗口的常规 → 捕获菜单中。

创建日期取自 frontmatter 的 created/date 字段（若有）；否则取自文件日期。该功能绝不写入你的笔记——只是打开它们。可在设置 → 功能（“重新发现旧笔记”）中关闭。

在手机上使用你的笔记

你的工作区是文件夹中的纯 Markdown——开放格式，没有专有数据库，也不强制使用云。因此任何手机应用都能读取和编辑你的笔记，LightNote 无需为手机提供专门的应用：只需同步该文件夹到一个文件服务，然后在手机的 Markdown 编辑器中打开它即可。

步骤：将工作区文件夹通过 OneDrive、Google Drive、Dropbox 或 Syncthing 同步，然后在手机上用 Markdown 编辑器（例如 Obsidian Mobile、iA Writer、GitJournal 或 Markor）打开该文件夹。由于一切都是文本形式的 .md，两端看到并写入的是同一批笔记。

建议：在手机上只编辑 .md 文件——LightNote 自有的类型（安全的 .lne、.lnc、.lnt、.lnb、.lnd……）在应用之外无法打开，尤其 .lne 是加密的。如果两端都离线编辑并出现冲突，请通过 Inbox 文件夹来解决：把捕获内容（文本、音频或照片）放到那里，让 LightNote 把它并入当天的笔记，而不是直接覆盖。这样的定位是有意为之的——同步是通过文件/Git，而不是通过插件：你拥有自己的数据，并可以选择传输方式。若想直接写入当天的笔记，编辑 每日笔记/yyyy-mm-dd.md 文件即可——文件夹名称随界面语言而变化。

录制音频（语音、会议）并用 AI 转写

在托盘菜单中，录制音频… 会打开一个可拖动的浮动窗口（拖动标题栏即可移动），可从麦克风、系统音频（电脑正在播放的声音）或两者同时录制——选择的来源会记住，供下次使用。使用 ● 录制、‖ 暂停和 ■ 停止；文件会保存到工作区的 录音 文件夹，并在停止时压缩为 .m4a。

两种转录方式。 在 设置 → AI 助手 → 音频转录 中，如何转录 选择器可在专用转录模型（Whisper 式：OpenAI whisper-1、Groq whisper-large-v3（免费）或本地 Whisper）与音频进入聊天的通用模型之间选择 —— 后者将音频放入多模态模型的对话中，Google Gemini（gemini-2.0-flash，免费额度不错）就是这样转录的。切换提供商会预选合适的模式并建议模型；两种模式下长音频都会自动分段。建议的模型可以手动更改——即使是 LightNote 尚未识别的提供商，它也会采用你输入的模型 id。

一开始录制，窗口会自动收起为一个紧凑的药丸条（闪烁的红点、计时器、暂停/停止）——方便拖到角落，在长时间会议中几乎隐藏起来；标题栏上的最小化/展开按钮可手动切换，停止录制会自动展开回来。Ctrl+Alt+R（全局快捷键）用于快速语音笔记：按一下立即从麦克风开始录制，再按一下停止——无需用鼠标打开窗口。

如果配置了基于 API 的 AI 提供商（在设置 → AI 助手 → 音频转写），停止后会出现 转写 和 转写 + 摘要 按钮（音频压缩期间禁用）；停止后下拉菜单可以在录制结束后自动触发转写。LightNote 会把音频发送去转写（Whisper 类模型），并在音频旁写入一个 .md 笔记，包含文本以及可选的摘要。可在设置 → 常规 → 功能中开启/关闭该功能。

同一个窗口也是一个迷你播放器：在控件下方，文件夹中的录音列表会显示每个文件，若已存在则带有T（打开转录）和R（打开摘要）按钮，以及一个可就地播放的▶（带拖动的进度条）；每行的⋮菜单可播放、（重新）转录或打开笔记。重新生成转录不会覆盖之前的版本——而是在旁边创建新版本（note.md、note (2).md…），保留历史记录。采集来源是一个菜单按钮（麦克风／系统音频／两者），默认为两者。打开录音文件夹链接会在主窗口中打开该文件夹。

便签

便签是浮在桌面上的小型彩色纯文本框，风格类似 Windows 的便笺 应用。从托盘菜单: 新建便签（Ctrl+Alt+S， 全局快捷键）会创建一个框，显示便签（Ctrl+Alt+H）会 将所有便签一起显示/隐藏。每个便签都有用于再创建一个的 +，以及用于更改颜色・ 发送到当日笔记（把文本作为当日笔记的项目写入，并丢弃该框）・ 删除的 ☰ 菜单。拖动标题栏可移动，拖动角上的手柄可调整大小。 便签会自动保存，重新打开 LightNote 时会再次显示。

日历

常规 → 日历…会在一个窗口中打开一个日历，标出所有 已注册的 .lnt 看板中含有任务的日期。其旁边有当日 列表（所选日期的任务）和待办列表。当日笔记按钮会 打开该日期的每日笔记。单击任务会打开对应的看板。

在网格中，有任务的日期会显示看板状态颜色的圆点（最多三个），今天用圆环标记，选中的日期用实心圆标记；今天回到当前月份，点击月份名称可打开菜单，按月或按年跳转。待办按情况分组——已逾期、今天、未来 7 天、更晚和无日期——到期时间以相对标签显示（“昨天”“今天”“3 天前”）。双击某一天会打开已填好该日期的快速任务。

命令面板

Ctrl+Shift+P 会打开命令面板（各操作及其快捷键， 可通过输入筛选）。Ctrl+P 打开快速文件选择器，Ctrl+Shift+K 打开任务选择器。

MCP 服务器（AI 代理）

LightNote 包含一个无界面的 MCP（Model Context Protocol）服务器，可把你的 工作区变成一个供 AI 代理使用的工具（Claude Desktop、Claude Code、Cursor， 以及任何支持 MCP 的客户端）。代理可以读写文件、搜索、查询表格数据和数据库、 操作任务、使用 Git，并发起 HTTP 请求 — 全部限定在该文件夹内 （目录监狱：含 .. 或超出根目录的路径会被拒绝）。传输是基于 stdin/stdout 的 JSON-RPC 2.0；每个会话会启动一个轻量的 lnote.exe 进程，独立于编辑器窗口。

一键快捷方式： 通过 AI → 在此文件夹中启用 AI，LightNote 会一次性启用 MCP 并写入 .mcp.json（点击即表示同意）。如果该文件夹已启用 AI，该项会变为 配置此文件夹的 AI… 并打开 工作区设置。

两层安全:（1）只有当你为该文件夹启用了选择加入时，服务器才会 启动；（2）每个工具都锁定在工作区的根目录内。此外，每个工具都带有注解 （只读、破坏性、幂等、“触及外部世界”），使 AI 客户端在调用前能评估风险。

逐步配置

1. 为文件夹启用 MCP。在工具 → 工作区设置中勾选为此工作区启用 MCP。没有这一选择加入，服务器会拒绝启动（这是主要的关卡）。也可从命令行： lnote --mcp-enable "C:\Path\to\workspace" （关闭用 --mcp-disable）。
2. 找到 lnote.exe 的路径。它与 lightnote.exe 在同一文件夹（应用的安装文件夹）内。它是无界面的“精简”控制台可执行文件 — 代理运行的就是它。
3. 在你的 AI 客户端中注册该服务器，把命令指向 lnote.exe， 并传入 --mcp 后跟工作区文件夹。采用 Claude Desktop / Cursor 等 使用的格式：

{
  "mcpServers": {
    "lightnote": {
      "command": "C:\\Path\\to\\lnote.exe",
      "args": ["--mcp", "C:\\Path\\to\\workspace"]
    }
  }
}

配置提示：

• JSON 中的反斜杠必须写成双反斜杠（C:\\Users\\...\\lnote.exe）， 如示例所示。
• 要公开多个工作区，为每个文件夹添加一条名称不同的条目 （"lightnote-projectA"、"lightnote-projectB"），各自 指向自己的根目录。
• 保存配置后，重启 AI 客户端以让它启动服务器。连接后，代理应列出 lightnote_* 工具；让它“列出工作区的文件”来确认是否可用。
• 对于 Claude Code（CLI），可用以下命令注册同一服务器： claude mcp add lightnote -- "C:\Path\to\lnote.exe" --mcp "C:\Path\to\workspace"。

数据库密码（可选）。db_query 工具会打开一个 .lnc 连接。如果密码用安全短语加密，请在服务器块中通过环境变量 LNOTE_PASSPHRASE 传入短语（切勿放在命令行参数中）—— 密码为“询问” 模式的连接无法在无人值守下使用。

AI 查询按连接选择启用。在文件夹中启用 MCP 不会公开连接：只有在连接对话框中勾选“允许 AI 查询 (MCP)”时，相应的 .lnc 才会响应 db_query。访问为只读（SELECT）。

通过代理从数据库导出。 除了查询，代理还可以用 db_export 将 SELECT 实体化为文件（Parquet、CSV、JSON 或 .xlsx）—适用于大到无法放入回复的结果。同样的三道防线按此顺序生效：查询必须是只读的，连接需要勾选 “允许 AI 查询 (MCP)”（在解密密码之前检查），目标文件必须位于工作区内部。大型导出会使用系统临时文件夹作为中转区，大小约与结果相当—请预留磁盘空间。

可用的工具

代理会在客户端前缀下看到这些工具（例如 lightnote_read_file）。 按类别：

• 文件：read_file（可选行范围）、write_file、 edit_file（替换精确片段而不改写整个文件）、 append_file、list_files、move_file、 make_dir、delete_file（进回收站，非彻底删除）。
• 搜索与导航：search_files（ripgrep，带子文件夹/glob 筛选 和上限）、list_symbols（文件的函数/类大纲）、open_in_editor （若 LightNote 窗口已打开，则打开/聚焦文件）。
• 数据与 SQL：query（在 Parquet/CSV/JSON 上的 DuckDB SQL，tsv/json/markdown 输出）、describe_table（架构 + 统计，不输出 行）、export_query（用 COPY 把 SELECT 实体化为文件）、 sqlite_query（在 .sqlite/.db 上的 SQL）、 db_list_connections（列出工作区的 .lnc）、 db_query（在 .lnc 连接上的只读 SQL）。 若要将结果写入文件而非回复，使用 db_export（Parquet/CSV/JSON/.xlsx）。
• 还有：search_notes（针对一个问题检索最相关的笔记片段 —— 与AI 聊天相同的引擎）、list_links（一条笔记的出站链接，已解析或已失效）、audit_vault_links（整个知识库的失效链接和孤立笔记）、list_note_templates 以及 create_note 的 template 参数、list_due_tasks（所有项目中今天到期或已逾期的任务）、xlsx_read（把 .xlsx 工作表读取为 TSV）、data_diff（比较两个表格文件），以及数据库目录 db_list_objects/db_describe（表/视图，以及某个表的列、键和 DDL —— 与 db_query 要求相同）。
• 压缩包：zip_list（列出 .zip/.isx 的成员）和 zip_read（把某个成员作为文本读取）——无需 把压缩包解压到磁盘。
• 任务：list_task_projects（列出工作区的 .lnt 任务项目）、list_tasks、list_task_statuses （看板的列）、create_task、update_task、 update_task_status（在列间移动）、delete_task、 task_note（读写任务的 .md 笔记）。一个工作区可以有 多个 .lnt 项目：用 project 参数选择要操作哪个 （即 list_task_projects 返回的 name；只有一个时可省略）。 id/status_id 是会话内的标识符——不要直接读取 .lnt 的内部文件来获取它们，请使用任务工具。
• 笔记（PKM）：create_note（创建 .md 笔记）、 append_daily_note（向当天的日记追加一条捕获）、 list_backlinks（指向某条笔记的笔记）、list_note_tags 与 search_by_tag（vault 中的 #标签 及使用它们的笔记）， 以及 add_task（创建带截止日期/标签的任务，标题可用自然语言）。
• Git：git_status、git_log、 git_diff、git_restore。
• Web 与通知：http_request（发起 HTTP 请求并返回 状态/头部/正文）、notify（在已打开窗口的托盘显示通知 —— 便于代理 提示已完成）。
• AI 代理：list_ai_models 和 ask_ai（见下）。

服务器还会把工作区的文件作为 MCP 资源公开（resources/list 和 resources/read），供更愿意“附加”文件而非调用 read_file 的客户端使用。

你的提示词库（工作区的 Prompts/ 文件夹）会作为 MCP 提示词公开（prompts/list 与 prompts/get）。在 Claude Code 中，每个提示词都会变成斜杠命令 /mcp__lightnote__<名称>，可直接在 AI CLI 中使用。

写入安全网。在覆盖（write_file/edit_file）或删除（delete_file）文件之前，服务器会把旧版本保存到本地历史（与编辑器相同的安全网），这样即使不在 Git 仓库中，你也能撤销代理所做的更改。

每个工具都会声明它是读取还是写入：除了 MCP 注解 （readOnlyHint/destructiveHint）之外，描述开头还带有 [read-only]、[writes] 或 [destructive] 标记——便于安全地构建允许列表。

AI 代理（委托给另一个模型）

你用勾选 MCP 列注册的 API 提供商会通过两个工具向代理 开放：list_ai_models（列出允许的模型，含 id、名称和模型）和 ask_ai（{model, prompt}）。这样主代理就能把子任务 委托给更便宜或更专业的模型。调用由正在运行的 LightNote 中转（MCP 的 lnote.exe 通过内部桥把请求转发到应用窗口）：API 密钥绝不离开你的 本机，也绝不到达代理。如果 LightNote 未打开，该工具会返回一个提示你打开它的 错误。

命令行（lnote）

同样的 MCP 操作也存在于用于脚本和自动化的控制台可执行文件 lnote 中 （也可通过 lightnote cli <command> 访问）。所有操作都限定在根文件夹内， 用 --root 设置（默认: 当前文件夹）。

示例:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hello"
echo content | lnote write --path note.md --content -
lnote search --query TODO --regex
lnote query --sql "SELECT * FROM read_parquet('data.parquet') LIMIT 10"
lnote describe --path data.parquet
lnote search-notes --query "我在哪里写过预算的事"
lnote audit-links
lnote xlsx-read --path sheet.xlsx --sheet 0
lnote data-diff --a before.parquet --b after.parquet --mode changed --keys id
lnote db-describe --connection data.lnc --table customers
lnote db-export --connection dados.lnc --sql "SELECT * FROM clientes" --out clientes.parquet
lnote due-tasks
lnote export --sql "SELECT * FROM read_csv_auto('e.csv') WHERE state='NY'" --out ny.parquet
lnote zip-list --path export.isx
lnote zip-read --path export.isx --entry job/definition.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Review the text" --effort 2
lnote move-task --project Backlog --task-id 5 --status-id 2
lnote git-status
lnote http --url https://api.example.com --method GET
lnote notify --message "Processing finished"

全局选项: --root <folder>、--json （结构化的 {ok,data,error} 输出）、--help（或 lnote <command> --help）、--version。对未知命令会 给出建议（“did you mean…?”）。

批量更新旧数据：lnote upgrade <文件夹> 可一次性升级由旧版 LightNote 写入的文件——目前是旧扩展名 .lnsh 和 .lnsm，它们已改为 .lns 和 .lne。 应用在你打开每个文件时本来就会自动完成此操作；该命令适用于文件多达数十个、 不想逐个打开的情况。使用 --dry-run 可在不改动任何内容的前提下预览将要发生的变更。 这只是便利功能而非必需：不用它，旧文件照样能正常打开。

设置与主题

在工具 → 常规设置中，可按章节调整: 常规选项 （语言、自动保存、释放空闲标签、标签颜色调色板、窗口标题、 每日笔记、拼写检查）、应用程序主题、编辑器的字体和颜色、 Markdown 样式、 运行（解释器）、终端（shell）、AI 助手 （CLI 和默认 AI）、版本控制、数据库（分页、 Oracle Instant Client）。

章节列表顶部有一个搜索框，可按每页的选项进行筛选；功能章节汇集了可选功能的 开关——连接图谱、便签、AI 会话、AI 聊天、音频录制、找回旧笔记、保持计算机唤醒，以及 与 Windows 资源管理器菜单的集成。关闭某项功能后，它会从界面・托盘・快捷键中消失，并停止 消耗资源，但已创建的数据会保留；更改在重新启动后生效。

应用程序主题会更改程序的外观（菜单、标签页、面板、状态栏）。有多个现成主题 — 浅色（浅色、Solarized Light、Catppuccin Latte、Gruvbox Light、One Light、 Rosé Pine Dawn）和深色（深色、Tokyo Night、Dracula、Ayu Mirage、Nord、Gruvbox Dark） — 以及带强调色的自定义模式。新主题通过在线目录提供，无需更新应用程序。

代码编辑器和 Markdown 的颜色在各自的部分中单独选择，与应用程序主题 相互独立。每个部分都有一个主题:下拉框，提供现成的配色方案（Padrão、Dracula、 One、Nord、Gruvbox 和 Tokyo Night 的浅色和深色版本）、实时预览，以及 另存为…按钮，可将你自己的颜色保存为可重复使用的预设。

按窗口设置主题。每个文件夹（工作区）都可以有自己的主题，因此你可以同时 打开两个外观不同的窗口。在工作区设置 → 此文件夹的外观中，有用于选择此窗口 的主题（程序外观）、代码主题和 Markdown 主题的下拉框——每个都带有 跟随常规主题/保持默认选项以表示不覆盖。覆盖代码和 Markdown 主题非常 适合仅在该文件夹中让编辑器颜色搭配深色主题，而无需改动常规设置。这些选择只保存在 你的本机上（不会提交到 Git）。

安装向导。当你从目录中选择一个尚未安装在电脑上的工具（AI 助手、解释器、 格式化工具、linter 或数据库驱动），或尝试运行/格式化/检查一个缺少解释器的文件时， LightNote 会打开一个安装向导。当存在安全的命令（通过 winget）时， 向导会显示确切的命令，并在内嵌控制台中一键执行；如果该工具依赖于另一个工具 （例如，需要 Node.js 的 CLI），它会先提示安装先决条件。没有自动安装程序时，向导会打开 官方下载页面并附上分步说明。完成后，它会验证安装，并让该工具立即可用，无需重启程序。

格式化和 Linter 有各自的分区（按语言的外部格式化工具/linter， 可从目录中添加）。若要把你的偏好带到另一台机器，设置迁移组（常规分区） 提供导出/导入设置（一个 .lnconf 文件）: 常规选项和内容主题 会包含在内，但不包含 API 密钥或本地路径（请在目标机器上重新填写）。

窗口标题是一个自由格式的模板: 应用名称始终位于末尾，其余部分用 变量 {workspace}（工作区根文件夹）、{file} （打开的文件名）、{path}（完整路径）组合而成。围绕空变量的装饰 （例如 [ {workspace} ] 中的方括号）会自动消失。要使用默认的 [ {workspace} ] {file} — ，请将该字段留空。

窗口布局。在视图 → 窗口布局（或常规设置 → 常规 → 窗口布局）中，可以从三种预设—现代（默认）、经典和舒适—中选择一种，也可以单独调整每一项：在顶部显示菜单栏（启用后 ☰ 按钮会消失，因为两者打开的是同一批菜单）、在图标旁显示文字标签、把工具栏和侧边栏放在左侧或右侧，以及图标大小。选择预设只是把这些选项填好：之后单独改动任何一项都不会撤销什么，列表只是改为显示“(自定义)”。改动会立即在所有已打开的窗口生效。

键盘快捷键

• F1 — 本帮助（当前界面的对应章节）
• Ctrl+N / Ctrl+O — 新建文件 / 打开文件
• Ctrl+S / Ctrl+W — 保存 / 关闭标签
• Ctrl+Alt+Shift+S — 全部保存（所有已更改的标签）
• Ctrl+F / Ctrl+H — 在文件内查找 / 替换
• Ctrl+Shift+F — 全局搜索（ripgrep）
• Ctrl+Shift+G — 版本控制面板（Git）
• Ctrl+Shift+E / Ctrl+Shift+M — 资源管理器面板 / 待办项面板
• Ctrl+B — 显示/隐藏侧边栏
• Ctrl+' — 终端（美式布局上也可用 Ctrl+`）
• Ctrl+/ — 切换注释。Ctrl+Shift+D — 复制行
• F5 — 运行文件。Ctrl+Shift+Enter — 将选区发送到终端
• Ctrl+K / Ctrl+I — 向 AI 提问 / 用 AI 编辑
• Ctrl+B / Ctrl+I / Ctrl+E — 在 Markdown 笔记中：加粗 / 斜体 / 切换视图模式
• Ctrl+Enter — “就地执行”：SQL 语句、块单元格、API 请求
• Ctrl+Shift+R / F4 — 宏: 录制 / 回放
• Ctrl+P — 转到文件。Ctrl+Shift+P — 命令面板
• Ctrl+Shift+K — 转到任务。Ctrl+Shift+T — 重新打开已关闭的标签
• Ctrl+Alt+G — 连接图
• Ctrl+Alt+N — 快速捕获（全局。在 LightNote 之外也有效）
• Ctrl+Alt+D / Ctrl+Alt+T — 今日笔记 / 快速任务
• Ctrl+Alt+R — 录制/停止音频（全局，快速语音笔记）
• F11 — 禅模式（标签占据整个窗口）
• Ctrl++ / Ctrl+- / Ctrl+0 — 缩放

可筛选的完整列表在 帮助 → 键盘快捷键中。

许可・版本・社区

LightNote 以功能相同的多个版本提供，区别仅在于许可和分发方式:

• LightNote（免费，来自网站）: 用于个人・非商业用途。
• LightNote Core（Microsoft Store）: 作为对项目的贡献获取， 授予商业使用许可，并通过 Store 接收自动更新。
• LightNote Business（未来）: 面向批量/企业的许可。保留供未来 提供。

你所用副本的版本（即适用哪些条款）显示在 帮助 → 关于 中。完整条款在 帮助 → 关于 → 许可条款…中。

加入并参与贡献:

• 建议或问题: GitHub Discussions — github.com/nglczr/LightNote-Community/discussions
• 发现 bug？请在 GitHub Issues 报告 — github.com/nglczr/LightNote-Community/issues
• 在 Ko-fi 支持开发 — ko-fi.com/lightnote （或在 Store 获取 LightNote Core）
• 联系方式: contato@lightnote.com.br · 网站: lightnote.com.br