Tolaria:管理 Markdown 知识库的跨平台桌面应用
Tolaria 是一款面向 macOS、Windows 和 Linux 的桌面应用,用于管理 Markdown 知识库。它坚持文件优先、Git 优先、离线优先与开源原则,笔记为带 YAML frontmatter 的纯 Markdown 文件,每个 vault 都是 Git 仓库,支持 Claude Code、Codex CLI、Gemini CLI 等 AI 工具接入,适合构建第二大脑、整理公司文档与保存 AI 助手记忆。
社区作者 · zZz
它解决什么问题
Tolaria 是一款 macOS、Windows、Linux 通用桌面应用,用于管理 Markdown 知识库。作者 Luca(refactoringhq)用它运行自己的日常生活与工作,个人工作区有 10,000+ 条笔记,来源包括 Refactoring 工作内容以及大量个人日记和第二大脑笔记。
典型用途:
- 运营第二大脑与个人知识库;
- 把公司文档整理为 AI 可用的上下文;
- 保存 OpenClaw/助手类工具的记忆与操作流程。
赞助与生态:项目由一组用于保持项目健康、可测试并适配 AI 辅助开发的工具赞助支持,页面列出的赞助方包括 Codacy、CodeScene、CircleCI、Unblocked(见配图 2、配图 3、配图 4、配图 5)。
走查视频:页面提供若干 Loom 走查,分别为《How I Organize My Own Tolaria Workspace》《My Inbox Workflow》《How I Save Web Resources to Tolaria》,内容短小直接。
设计原则:
- 文件优先:笔记是纯 Markdown 文件,可移植、可用任意编辑器打开,无需导出步骤,数据属于用户而非某个应用。
Git 优先:每个 vault 都是 Git 仓库,具备完整版本历史,可使用任意 Git remote,不依赖 Tolaria 服务器。
- 离线优先、零锁定:无账号、无订阅、无云依赖,vault 完全离线可用;停止使用 Tolaria 也不会丢失任何东西。
- 开源:免费且开源,作者为自己构建并分享给他人。
- 基于标准:笔记是带 YAML frontmatter 的 Markdown 文件,无专有格式,可随时迁移到标准工具链。
- 类型是透镜而非 schema:类型是导航辅助而非强制约束,没有必填字段和校验,只是便于查找笔记的分类。
- AI 优先但不限于 AI:文件型 vault 很适合 AI agent;官方支持 Claude Code、Codex CLI 和 Gemini CLI 的配置路径,也可用任意 AI 编辑 vault,并提供 AGENTS 文件供 agent 自行理解。
- 键盘优先:面向希望尽量用键盘操作的高级用户设计,编辑器与命令面板大量基于这一理念。
- 源于真实使用:为管理作者本人 10,000+ 笔记的 vault 而创建,每天使用,每个功能都解决过真实问题。
技术栈与文档:项目使用 Tauri、React、TypeScript 构建。技术文档包括 ARCHITECTURE.md(系统设计、技术栈、数据流)、ABSTRACTIONS.md(核心抽象与模型)、GETTING-STARTED.md(代码库导航)、ADRs(架构决策记录)。公开用户文档位于 site/ 目录并发布到 GitHub Pages。
安全:如认为发现安全问题,请按 SECURITY.md 中的说明私下报告。
许可证:Tolaria 使用 AGPL-3.0-or-later 许可;Tolaria 名称与 logo 仍受项目商标政策约束。
适用对象:需要本地、可版本控制、可迁移的 Markdown 知识库的个人用户与团队;希望把文档作为 AI 上下文的工程团队;习惯键盘操作和 Git 工作流的高级用户与开发者。界面可参考配图 1(应用界面截图)。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、终端用户安装
- macOS 使用 Homebrew 安装:
brew install --cask tolaria- 或从 releases 页面下载最新版本,支持 macOS、Windows、Linux。Windows 安装包已做 Authenticode 签名;公司管理的设备在首次安装前可能仍需 IT 部门批准 Tolaria 发布者。
二、首次启动 首次打开 Tolaria 时可选择克隆 getting started vault,其中包含对整个应用的引导式走查。公开用户文档位于 site/ 并发布到 GitHub Pages,建议先阅读 Install Tolaria,再阅读 First Launch。
三、本地运行与贡献(源码方式) 项目使用 Tauri、React、TypeScript 构建,本地运行步骤如下。 前置要求:
- Node.js 20+
pnpm 8+- Rust stable
- 开发环境为 macOS 或 Linux
Linux 系统依赖(Tauri 2 在 Linux 上需要 WebKit2GTK 4.1 与 GTK 3):
sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev patchelf
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libappindicator-gtk3-devel librsvg2-devel 注意:Linux 上内置 MCP server 在运行时会启动系统 node 二进制;如需使用外部 AI 工具流程,请通过发行版包管理器安装 Node。
- Arch / Manjaro:
- Debian / Ubuntu(22.04+):
- Fedora 38+:
快速开始:
步骤 1
pnpm install步骤 2
pnpm dev然后打开 http://localhost:5173 进入浏览器 mock 模式;
- 或运行原生桌面应用:
pnpm tauri dev四、常见问题
- Windows 首次安装可能被公司设备策略拦截,需要 IT 批准发布者。
- Linux 编译或运行失败,通常与缺少 WebKit2GTK 4.1 / GTK 3 相关依赖有关,按上文对应发行版命令安装。
- 未安装系统 Node 时,MCP server 与外部 AI 工具流程可能不可用,请安装发行版 Node 包。
- 更多技术资料可查阅 ARCHITECTURE.md、ABSTRACTIONS.md、GETTING-STARTED.md 与 ADRs;安全问题请按 SECURITY.md 私下报告。