// 01 Tolaria 是什么
面向 AI 时代的本地 Markdown 知识库
Tolaria 来自 RefactoringHQ 维护的开源项目，GitHub 仓库显示其定位是用于管理 Markdown 知识库的桌面应用。官网将它称为“AI 时代的第二大脑”，强调本地优先、Git 优先、Markdown 文件优先，而不是把笔记锁进专有数据库。公开资料中可以看到 RefactoringHQ、Luca Rossi 与 Refactoring 社区相关信息，但官网没有以传统公司介绍形式披露完整商业主体背景。
它面向的用户比较明确：长期写笔记、维护知识库、管理项目资料、使用 AI 编程助手或本地 Agent 的开发者和知识工作者。Tolaria 解决的问题不是简单“写一篇笔记”，而是让大量 Markdown 文件在本地可管理、可链接、可版本控制，并且能被 AI 工具直接读取和改写。
它解决的问题
很多知识库工具要么云端优先，要么使用专有格式，要么 AI 功能被绑定在平台内部。Tolaria 的思路相反：所有笔记都是磁盘上的 Markdown 文件，并带有 YAML frontmatter。用户可以用任何编辑器打开，也可以用命令行搜索、用 Git 管理历史、用外部 AI Agent 理解整个 vault。这对担心数据锁定、长期归档和跨工具迁移的用户很有吸引力。
它更适合已经习惯 Markdown、Git、命令行和 AI 工具链的人。如果只是想找一个极简云笔记，或者需要多人在线协作的企业知识库，Tolaria 可能不是最直接的选择。
核心能力
- 笔记以 Markdown 文件保存，结构信息通过 YAML frontmatter 表达，不依赖专有数据库。
- 支持富文本块编辑，同时保留原始 Markdown 模式，适合在易写性和源码控制之间切换。
- 编辑器支持 slash commands、wikilinks、表格、代码块、图片、Mermaid 图表、LaTeX 风格数学和白板。
- 内置 Git 客户端，可在应用内提交、推送和浏览历史，并查看单篇笔记的版本变化。
- 支持 macOS、Windows 和 Linux 桌面端，发布记录中包含 AppImage、deb、Windows 安装包以及 macOS Intel 和 Apple Silicon 版本。
- AI 集成不是强制功能，可连接 Claude Code、Codex、OpenCode、Gemini 等 CLI 类助手，也支持本地或 API 模型提供方围绕笔记上下文聊天。
- GitHub 仓库显示项目采用 AGPL-3.0-or-later License，官网则强调免费、开源、无需账号。
如何使用
Tolaria 的真实形态是桌面应用，不是网页 SaaS。普通用户可以从官网下载对应系统版本，打开后创建或导入自己的 Markdown vault。开发者也可以从 GitHub 克隆仓库，本地安装依赖后运行浏览器 mock 模式或 Tauri 桌面应用。
- 访问官网下载安装 macOS、Windows 或 Linux 版本。
- 创建一个新的 vault，或打开已有 Markdown 文件夹。
- 用富文本编辑器写笔记，也可以切换到 Raw Mode 直接编辑 Markdown 源码。
- 通过 wikilinks 建立笔记之间的关系，形成可导航的知识网络。
- 启用 Git 工作流，在应用内提交、查看历史并同步到远程仓库。
- 如需 AI 能力，可连接已有的 CLI Agent 或模型提供方，让 AI 基于本地笔记上下文工作。
典型使用场景
开发者可以把项目笔记、架构决策、代码研究、待办事项和调试记录放在同一个 vault 中。每次修改都进入 Git 历史，AI Agent 也能读取这些 Markdown 文件来理解项目背景。
内容创作者或研究人员可以用 Tolaria 管理选题、资料、人物、项目和长期研究笔记。通过 wikilinks 和属性字段，笔记不再只是孤立文本，而可以形成主题关系网。
对于习惯 Obsidian、Logseq 或 VS Code 管理知识库的人，Tolaria 更适合那些希望保留 Markdown 可迁移性，同时又想要 Git、桌面应用和 AI Agent 工作流整合的人。
与同类工具的差异
Tolaria 与 Notion 的差异在于本地文件和开放格式；与 Obsidian 的差异在于更强调内置 Git、AI Agent 工作流和桌面应用一体化；与普通 Markdown 编辑器相比，它提供了关系、属性、富编辑和版本历史等知识库能力。
如果用户需要团队协同、权限管理和云端数据库，Notion 类工具更合适。如果用户重视数据主权、离线可用、Git 历史和 AI 工具可读性，Tolaria 的设计更有优势。
价格与使用成本
官网明确写明免费、开源、无需账号，GitHub 仓库也公开代码。实际成本主要来自使用门槛：用户需要理解 Markdown 文件、Git 同步、vault 结构和本地 AI 工具接入。对于熟悉开发者工作流的人，这些是优势；对于非技术用户，则可能需要适应。
真实优势与局限
Tolaria 的优势是清晰的本地优先路线：Markdown 文件、Git 历史、开放源码、离线可用、AI Agent 友好，适合长期知识资产管理。它不是把用户困在平台里，而是尽量让数据能被任何工具继续使用。
局限也很明显。Tolaria 仍是快速迭代中的开源桌面项目，GitHub 发布频率很高，但这也意味着功能和稳定性可能持续变化。它不适合完全不想碰文件系统、Git 或本地配置的用户，也不适合直接替代成熟企业协作知识库。对于个人开发者、研究者和 AI 工作流重度用户，它才是更值得关注的选择。
