关于 Lanternote
Lanternote 是一款用于浏览、编辑、搜索和查询大型 Markdown 笔记文件夹的桌面应用。笔记保存在本地文件中,也可让 MCP 助手搜索和编辑,并保留版本历史。
主要功能
- 01搜索大型笔记集合
- 02实时 Dataview 查询与日历
- 03链接图谱和星系视图
- 04支持版本历史的 Markdown 编辑
- 05可选的 MCP 助手访问
适用场景
- 01在大型归档中查找笔记
- 02用 Markdown 跟踪任务和日期
- 03查看笔记集合中的链接
- 04让 MCP 助手搜索或编辑笔记
MCP 相关
Lanternote 可连接 Claude 和其他 MCP 助手,让它们搜索笔记,并在获准时编辑笔记。README 提到了 MCP 测试,但未说明公开的工具或服务传输方式。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Lanternote
一款快速、私密的桌面应用,专为超大型 Markdown 笔记文件夹打造。
在 Windows、macOS 或 Linux 上阅读、编辑、搜索、查询和映射 200,000 条笔记——无需账户、云服务或显卡。
在一个虚构的、包含 139,434 条笔记的文件夹上,20 秒即可体验:快速打开 · 全文搜索 · Command Center · 星系 · 链接图谱
为什么选择 Lanternote
- 为海量笔记打造。 在包含 190,000 多条笔记和 250 万个链接的真实库中测试:重新打开只需 1–2 秒,搜索只需几毫秒。
- 适用于任何 PC。 链接图谱和星系无需显卡即可绘制。便携:一个
.exe文件,无需安装,也不需要管理员权限。 - 文件始终归你所有。 笔记是你所选文件夹中的纯
.md文件。不会上传任何内容,也不会向外发送数据;所有功能均可离线使用。 - 不只是阅读器。 实时查询、任务列表、日历、看板、画布和 Command Center 页面——全部以普通 Markdown 格式存储。
- 可与 AI 助手协作。 Claude 和其他 MCP 助手可以搜索笔记;如果你允许,还可以编辑笔记——每次 AI 修改都会保留旧文本。
功能
Command Center在一个页面查看今日要事——项目、截止日期、未完成任务、日历和最近的笔记。页面由一条普通笔记生成,你可以对其进行编辑。
|
让你的笔记化作星系每颗星星都是一条笔记,每条旋臂代表一个文件夹,本周编辑过的笔记会闪闪发光。放大即可阅读名称,点击星星即可打开笔记。
|
适用于任何 PC 的链接图谱Map 引擎会在后台一次性为数十万条笔记布局,并将它们绘制成数字地图——无需 GPU。如果你的设备配有 GPU,也可以使用 Live GPU 引擎。
|
保护你作品的编辑功能实时预览(Markdown 标记会在光标移开时隐藏;编写时可使用复选框、图片和链接)、标签页,以及可在编写一条笔记时阅读另一条笔记的右侧窗格。自动保存、单条笔记撤销、
|
即时搜索所有内容跨所有笔记进行全文搜索,不区分重音符号:
|
实时查询通过
|
### 任务和日历
从每篇笔记中收集任务,按截止日期排序,并直接在结果中勾选——笔记会立即更新。
|
看板在列之间拖动卡片。看板是采用通用看板格式的纯 Markdown 笔记,因此在任何地方都能轻松阅读。
|
阅读时无需离开页面将鼠标悬停在链接上,即可在卡片中预览笔记(或链接指向的标题),并可在其中滚动和点击。脚注可跳转到对应文本,也能返回;书签则会将你最常用的笔记置于文件列表上方。
|
未链接提及查看所有写到这篇笔记名称(或其别名)却未添加链接的笔记,只需单击一下,即可将提及转换为链接,同时保留原有文字。
|
画布在无限画布上排列笔记、文本和链接。画布采用开放的 JSON Canvas 格式。
|
连接 AI 助手内置 MCP 服务:搜索、阅读、运行查询、列出任务,并在引用前对照笔记核验引文及其数字(
|
**还包括:**带标题、块和别名的 wiki 链接 · 脚注 · 在编辑器中折叠标题、列表和代码 · 嵌入(![[note]]、图片、音频、视频)· 反向链接和大纲 · front-matter 属性 · 标签和嵌套标签 · 提示框 · 高亮和评论 · Mermaid 图表 · 笔记模板 · 每日笔记 · 图片查看器 · 命令面板 · 打印为 PDF · 浅色和深色主题。
在一个包含 190,522 条笔记、249 万条链接(728 MB) 的真实资料库,以及一个虚构的 139,000 条笔记文件夹上测得;本 README 中的所有图片均使用该文件夹。
| 任务 | 时间 |
|---|---|
| 首次打开(无缓存) | ≈ 17–19 秒 |
| 再次打开(有缓存) | ≈ 1–2 秒 — 在后台检查更改 |
| 全文搜索 | 20–130 毫秒 |
| 按名称快速打开 | ≈ 25 毫秒 |
| 在整个资料库中进行实时查询 | ≈ 0.1 秒 |
| Galaxy — 单帧 | ≈ 1 毫秒 |
| 链接图 — 构建 | ≈ 0.15 秒 |
它如何保持快速
- 工作线程负责索引(
indexer.js):它读取并解析每条笔记,维护精简的搜索索引(不区分重音符号;上述资料库的索引为 50 MB),并处理搜索和查询。窗口只保留较小的索引——路径以及一个Uint32Array类型的链接数组——并在打开笔记时读取其文本。 - 磁盘缓存(
index-cache):缓存已解析的笔记和解析后的链接图,因此再次打开时会立即显示文件夹,并仅在后台对文件执行stat。 - 增量更新:编辑、新增或删除文件时,只会重新读取该文件。其他应用或同步工具所做的更改通常会在约一秒内显示。
- 图谱“Map”引擎(
layout-worker.js、src/atlas.js):布局只计算一次(Pivot MDS 加邻居平滑处理)并缓存;绘制使用 2D 画布上的细节层次,因此闲置的图谱不会占用 CPU。 - 图谱“Live”引擎:cosmos.gl 使用 GPU 同时运行力导向布局和绘制。默认隐藏链接数超过 1,000 的“枢纽”笔记的链接——仅一条拥有 72,000 个反向链接的笔记,就会使帧率从约 120 FPS 降至约 19 FPS。
- 限制:1,000,000 个文件;最多保留 1.5 GB 文本用于搜索(超过后,搜索只覆盖文件夹的一部分,并会说明这一点)。
从 最新版本 下载适用于你系统的文件:
| 系统 | 文件 | 运行方式 |
|---|---|---|
| Windows 10/11 | Lanternote-<version>-portable.exe | 直接运行即可,无需安装,也无需管理员权限。若要更快启动,请使用 Lanternote-<version>-win.zip,并运行其中的 Lanternote.exe。 |
| macOS(Apple 芯片) | Lanternote-<version>-arm64-mac.zip | 解压后将 Lanternote.app 移至 Applications。 |
| Linux(x64) | Lanternote-<version>.AppImage | 运行 chmod +x Lanternote-*.AppImage,然后启动它。 |
然后点击 打开文件夹,选择你的笔记。下次启动 Lanternote 时,它会重新打开同一个文件夹和笔记。
只想让 AI 助手读取你的笔记? 从同一版本下载 lanternote-<version>.mcpb 并双击:Claude Desktop 会安装扩展,并询问你的笔记文件夹。除非你开启 允许 AI 编辑笔记,否则它仅可读取;并且可在 Windows、macOS 和 Linux 上运行。
说明
应用尚未进行代码签名,因此系统首次运行时可能会发出警告:
- Windows SmartScreen:点击 更多信息 → 仍要运行。
- macOS:右键点击
Lanternote.app→ 打开 → 打开。如果 macOS 提示应用“已损坏”,请运行一次xattr -cr /Applications/Lanternote.app。- Linux:在 Ubuntu 24.04 及更高版本中,如果 AppImage 无法启动,请使用
--no-sandbox运行。macOS 和 Linux 版本刚刚推出:CI 已在这两个系统上测试每项功能,但如果发现任何异常,请反馈。 设置、索引缓存和恢复副本均保存在各自的计算机上(Windows 上为
%APPDATA%\Lanternote)。
在应用中按 F1 查看内置指南,或阅读配有插图的用户指南。
键盘快捷键
| 按键 | 操作 |
|---|---|
F1 | 应用内指南 |
Ctrl+O | 快速打开 |
Ctrl+Shift+F | 搜索所有笔记(使用 tag:#name 筛选) |
Ctrl+Shift+H | 命令中心 |
Ctrl+G / Ctrl+Shift+G | 所有笔记的关系图 / 当前笔记周围的关系图 |
Ctrl+N | 新建笔记 |
Ctrl+E | 阅读 ⇄ 编辑 |
Alt+E | 插入模板 |
Ctrl+P | 命令面板 |
Ctrl+, | 设置 |
Ctrl+Shift+D | 浅色 / 深色 |
Alt+← / Alt+→ | 后退 / 前进 |
Ctrl+− / Ctrl+= / Ctrl+0 | 缩小 / 放大 / 重置 |
Esc | 关闭对话框,退出星系视图 |
隐私
Lanternote 只会读取和写入你打开的文件夹及其自身的设置文件夹。它没有账户、不会收集遥测数据,也不会检查更新;所有库均已捆绑,因此无需网络连接即可运行。除非你点击图片,或开启“设置 → 文件与链接 → 从互联网加载图片”,否则不会获取来自互联网的图片(),因为获取图片会让 Web 服务知道笔记何时被打开。笔记链接到这台电脑上文件夹之外的图片()会显示出来;指向其中文档(PDF、图片、文本)的链接会在各自的应用中打开。只有这些文件类型会以这种方式读取或打开,绝不会运行程序;你也可以在“设置 → 文件与链接”中关闭此功能。
唯一的例外是你主动开启的功能:连接 AI 助手后,它读取的笔记会发送给该助手的服务提供商。你可以将连接设为只读,并将其限制在指定文件夹内。
从源代码构建
需要 Node.js 22 或更高版本以及 Git。请在 OneDrive 或 Dropbox 同步文件夹之外构建——node_modules 和构建产物都很大。
git clone https://github.com/ericthai-labs/lanternote.git
cd lanternote
npm ci # installs dependencies and bundles the editor into src/vendor
npm start # run from source
npm run dist:win # portable .exe and .zip in dist/
项目结构和测试
| 路径 | 用途 |
|---|---|
main.js、preload.js | 主进程:文件访问、文件夹监视、IPC,以及用于附件的 vault:// 协议(路径不能越出文件夹) |
indexer.js、search-index.js | 工作线程:解析、磁盘缓存、搜索、查询 |
layout-worker.js、src/atlas.js | 图谱“Map”引擎 |
src/graph.js | 图谱“Live”引擎(cosmos.gl) |
src/app.js、src/edit.js、editor/ | 阅读器和编辑器(CodeMirror 6,实时预览位于 editor/live-preview.js) |
src/panes.js | 标签页和右侧窗格 |
src/command.js、src/dataview.js、src/dvview.js、src/kanban.js、src/canvas.js | 命令中心、查询、看板、画布 |
mcp/lanternote-mcp.js | 面向 AI 助手的 MCP 服务(无额外依赖);scripts/make-mcpb.js 会将其打包为 Claude Desktop 扩展 |
tests/、scripts/drive.js | 自动化测试,通过 DevTools 驱动应用 |
node tests/mcp.js # AI connection, 35 checks
node scripts/drive.js <test-folder> tests/editing.js # UI scenarios — see tests/README.md
node scripts/bench-index.js <folder> <words> # index and search timings
npm run media -- <work-folder> # rebuild guide, adverts and README pictures
每次升级版本,都需要在 CHANGELOG.md 中添加一个 ## x.y.z 条目;否则 npm run dist:* 会停止运行。推送 vx.y.z 标签即可发布:CI 会在 Windows、macOS 和 Linux 上运行测试并构建,随后发布 GitHub 版本(通过 scripts/release-notes.js 根据变更日志生成说明)和 MCP Registry 条目。UI 测试只能在临时文件夹中运行——这些测试会创建、重命名和删除文件。
贡献
欢迎在 Issues 中提交 Bug 报告和建议,也欢迎提交拉取请求;贡献内容遵循 Apache License 2.0。
许可证
Lanternote 根据 Apache License 2.0 开源:
- ✅ 可免费用于任何用途,包括个人、教育、非营利和商业用途,也包括公司内部使用。
- ✅ 您可以修改代码并重新分发,但必须保留许可证和 NOTICE 文件,并标明您修改过的文件。
截至 1.18.0 的版本采用 PolyForm Noncommercial License 1.0.0 发布;从 1.18.1 起,Lanternote 采用 Apache 2.0 许可证。
捆绑的开源库各自保留其许可证,详见 THIRD-PARTY-NOTICES.txt。
致谢
Lanternote 的构建离不开许多优秀的开源项目,包括 Electron、CodeMirror、cosmos.gl、marked、DOMPurify 和 Mermaid。
© 2026 Eric Thai - Thai Ba Hoa · 本 README 中的图片取自一个虚构的笔记文件夹。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。