📌 项目地址：refactoringhq/tolaria | ⭐ 12,608 颗星 | 🔧 TypeScript | 📜 未标注
为什么需要 Tolaria？——笔记工具的普遍痛点
如果你用过 Notion、Obsidian、Roam Research 等现代笔记工具，大概率遇到过这些问题：
– 数据锁死在应用格式里，导出后失去结构和双向链接
– 必须登录账户、依赖云端同步，离线时部分功能不可用
– 应用停更或收费后，迁移成本极高
Tolaria 试图用一套极简原则解决这些痛点：你的知识库只是一堆 Markdown 文件 + 一个 Git 仓库，不依赖任何专有服务器或订阅服务。
Tolaria 的设计原则：真正属于用户的数据所有权
根据项目 README，Tolaria 有九个明确的设计原则，最核心的几条是：
- Files-first：笔记就是纯 Markdown 文件，可以任意编辑器打开、移动、备份。不需要导出步骤。
- Git-first：每个知识库（vault）是一个 Git 仓库，自带完整版本历史，可以 push 到任意 Git 远端（GitHub、GitLab、自建 Git 服务器）。即使 Tolaria 消失，你的版本历史也不会丢。
- Offline-first, zero lock-in：无需账户、无订阅、无云依赖。完全离线工作。停止使用 Tolaria 后，你只损失一个桌面客户端界面，而所有数据文件完好无损。
- Standards-based：笔记使用 Markdown + YAML frontmatter，没有自定义二进制格式。YAML 头字段就是标准元数据，其他工具也能解析。
- Types as lenses, not schemas：Tolaria 中的“类型”（types）只是导航辅助手段，不是强制 schema。没有必填字段，没有校验，只是帮助你按类别快速找到笔记。
- AI-first but not AI-only：Markdown 文件天然适合被 AI 消费。Tolaria 提供了一个
AGENTS文件，让 Claude Code、Codex CLI、Gemini CLI 等工具直接理解知识库结构。但你可以自由选择任何 AI 工具。
这些原则不是空话。项目作者 Luca 声称自己维护了 10,000+ 条笔记的 workspace，每天使用 Tolaria 管理个人工作和生活。
实际用法：安装、初始化、写作与 AI 集成
安装
目前官方推荐两种方式（以 macOS 为例）：
brew install --cask tolaria
或者从 GitHub Releases 页面 下载最新版本安装包（支持 macOS、Windows、Linux）。
创建知识库
安装后启动 Tolaria，你需要指定一个本地文件夹作为知识库。这个文件夹 必须是一个 Git 仓库（你可以用 git init 创建，或者克隆现有远程仓库）。这是 Tolaria 接入版本历史和远端同步的基础。
写笔记
笔记就是 .md 文件，文件头部写入 YAML frontmatter 标记元数据。例如：
---
title: 我的第一篇笔记
type: journal
created: 2025-04-09
tags: [思考, 个人]
---
这是一段笔记正文。
Tolaria 会读取 type 字段，在侧边栏等位置按类型分类显示。你不需要定义任何 schema，随意写就行。
利用 Types 导航
在 Tolaria 的搜索或浏览中，可以按 type 值快速过滤笔记。比如你的知识库里定义了 type: project、type: book-note、type: meeting 等，就可以一键查看所有项目笔记。这比文件夹分类更灵活，又不强制约束结构。
AI 协助
Tolaria 为 AI agent 提供了一个 AGENTS 文件（放在知识库根目录？ README 未指定，但根据描述你可以自行创建），里面说明知识库的结构、类型定义、目录组织方式。当你在 Claude Code 或 Gemini CLI 中打开这个文件夹时，AI 能自动理解如何读写笔记。这是 Tolaria 独有的“AI-first”设计：让 AI 替你搜索、整理、甚至生成笔记，而不是让笔记工具内置一个 AI 聊天框。
与同类工具的区别
| 特性 | Tolaria | Obsidian | Logseq | Notion |
|---|---|---|---|---|
| 文件格式 | Markdown + YAML | Markdown + 自己的内部链接语法 | Markdown + Org-mode | 专有格式 |
| Git 版本管理 | 强制每个 vault 是 Git 仓库 | 需要第三方插件或手动操作 | 可选但非原生 | 无 |
| 离线 | ✅ 完全离线 | ✅ 需手动同步 | ✅ | ❌ Web 版需网络 |
| 账户订阅 | 无 | 同步功能需订阅 | 同步功能需订阅 | 需订阅 |
| AI 集成 | 外部 AI 直接读文件 | 官方 Copilot（订阅） | AI 插件 | 内置 AI（付费） |
最大的区别在于：Tolaria 把“零锁定”推到了极致——你不用先学 Tolaria 的交互，只要会 Git 和 Markdown 就能用。而 Obsidian 虽然也基于 Markdown，但它的内部链接 [[ 语法是私有的；Logseq 则强绑定大纲模式。Tolaria 承诺没有专有语法，YAML 头也属于标准格式。
需要注意的事项
- 项目仍处早期：GitHub 上 12.6k 星不算少，但 Tolaria 可能缺少插件生态、富媒体嵌入等进阶功能。如果你需要实时协作、画布类图表、网页剪藏等，官方并未提及。
- Git 是硬依赖：如果你不熟悉 Git 或不想管理仓库，Tolaria 的“Git-first”可能成为负担。每个 vault 都必须是一个 Git 仓库，经常 commit 才能获得版本历史（自动提交？ README 未说明，需实测或看源码）。
- 文档和教程主要靠视频：目前 README 只给了几个 Loom walkthrough，文字文档比较简略。对于想深入了解“类型系统”和“AI 配置”的用户，可能需要自己看代码或等社区补充。
- 社区规模：项目是个人发起（作者 @lucaronin），目前没有大型公司背书。但因为是开源且数据格式标准，即使项目停止维护，你的数据依然可用。
总结
Tolaria 不是另一个“漂亮的笔记软件”，而是一套以数据自主为核心的知识库基础设施。它非常适合这样的人：
– 已经用 Git 管理 Markdown 文件，想要一个更友好的桌面客户端
– 担心笔记工具停止服务或改变商业模式，希望数据永远可迁移
– 喜欢用 AI 工具（Claude、Codex、Gemini CLI）来读写自己的笔记，而不是用工具内置的 AI 聊天
如果你只是想要一个花哨的富文本编辑器，Tolaria 可能太简陋。但如果你把“我的数据我做主”放在第一位，Tolaria 是目前最彻底的开源方案之一。
项目地址：https://github.com/refactoringhq/tolaria
安装文档：README 中除了 Homebrew 命令和 Releases 页面，其余用法建议参考官方 Loom walkthrough。