返回资讯中心
外部精选
软件工程
#开发者实时流

Jot笔记应用不用数据库,仅靠Markdown文件夹和MCP服务器

来源标题:My notes app has no database, just a folder of Markdown and an MCP server

Mac应用Jot放弃SQLite和同步服务器,全部存储仅为~/Documents/Jot文件夹,每条笔记是一个带YAML头的Markdown文件。文件名以日期加6位随机ID命名,图片和音频存放在attachments子目录,删除的笔记移入.trash目录以便撤销。作者称AI agent是这一设计的最佳理由。

Hacker News 最新mohakbajaj2026/11/10 · 8 天前8 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

我做了一个小 Mac 应用,叫 Jot。你在任何地方选中文字,连按两下 Shift,它就会存下一条笔记。刚开始做的时候,我考虑过 SQLite、同步服务器和账号系统。这些我一个都没做。Jot 的全部存储就是一个文件夹:~/Documents/Jot。

这篇文章讲这个文件夹怎么运作、出过哪些问题,以及为什么 AI agent 反倒成了它最好的理由。

每条笔记都是一个带 YAML front matter 的 Markdown 文件: ~/Documents/Jot/ 2026-11-09-6tjhzv.md 2026-11-09-gnump0.md INDEX.md SKILL.md attachments/6tjhzv/ .trash/

archived: false created: 2026-11-09T09:12:04.511Z done: false id: 6tjhzv images: [] pin: false section: '' source: Safari url: https://example.com/article tags: [reading] updated: 2026-11-09T09:12:04.511Z

A line I selected and wanted to keep.

文件名是 YYYY-MM-DD-<id>.md。id 是从 [0-9a-z] 里随机取的 6 个字符。前面的日期让 ls 天然按天排序。如果文件丢了 created 字段,Jot 会退回用文件名里的日期,所以顺序保持稳定。

图片和音频放在 attachments/<id>/ 里。删除的笔记移到 .trash/<id>/,所以撤销就是把它重命名回来。

写到一半的文件。如果应用在写入中途崩溃,这条笔记就没了。所以每次写入都先写到正式文件旁边的一个临时文件(.name.<16 hex>.tmp),然后再重命名就位。重命名在同一个文件系统上是原子的。重命名发生在目录项上,所以 Jot 也会同步这个文件夹,否则一次断电就能把它撤销。Jot 打开 vault 时,会删掉崩溃留下的临时文件。

每次都读全部文件。每个操作都会重新列一遍文件夹。每次按键都用 YAML 解析几百个文件太慢。Jot 维护一个以 inode、mtime 和大小作键的缓存。原子写入会给文件新的 inode,所以任何改动都会错过缓存,而没变的文件不会被重新解析。

别人弄坏的文件。你可以在 Vim、Obsidian 或脚本里编辑这些文件。如果 front matter 解析不了了,Jot 就把那一个文件排除在列表之外,记一次日志说明原因,然后继续。它不会崩溃,也不会去“修”你的文件。

外部改动。Jot 监视这个文件夹。如果别的程序新增或编辑了文件,收件箱会自己更新。

这就是整个存储层,大约 600 行 TypeScript。

我先加了一个 CLI(jot list、jot search、jot add、jot tag、jot done、jot archive)。然后 jot mcp 在 stdio 上启动了一个 MCP server,这样 Claude Code、Codex 和 Cursor 都能用同一个 vault。

故意没有删除工具。agent 可以新增、打标签、完成和归档。它不能删任何东西。agent 最坏也只能留下一堆你在 Finder 里看得见的乱。

这个 server 做的事也很少。它读文件,改 front matter,再用同样的原子写入写回去。应用通过文件夹监视器看到变化。server 和应用之间没有 IPC,应用也不需要开着。

所以大多数 agent 的配置就这一句:“我的笔记在 ~/Documents/Jot,读 SKILL.md。”类似“我上周在想什么”这样的问题,就变成了一次 grep 加一次读取。

对一个捕捉收件箱来说,这些取舍是值得的。你的笔记比应用活得久,你已经在用的每个工具都能打开它们,而 ls ~/Documents/Jot 就是管理面板。

Jot 是一个用于捕捉和听写的 Mac 应用。免费 3 天,之后按发布价一次性 $9。sayjot.xyz

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →