Tolaria 知识库桌面应用

Tolaria 是什么

Tolaria 是一款面向 macOS、Windows 与 Linux 的桌面应用，用来管理 Markdown 知识库。它适合搭建第二大脑、整理公司文档作为 AI 上下文，或存放 AI 助手的记忆与操作流程。作者本人用它管理超过 10000 条笔记的个人工作区。

核心理念

• 文件优先：笔记就是普通 Markdown 文件，可移植、可用任意编辑器打开，无需导出。
• Git 优先：每个知识库都是一个 Git 仓库，拥有完整版本历史，可对接任意 Git 远端。
• 离线优先、零锁定：没有账号、订阅和云依赖，停止使用也不会丢失任何东西。
• 标准格式：Markdown + YAML frontmatter，不使用专有格式。
• 类型即透镜：类型是导航辅助而非强制约束，没有必填字段和校验。
• AI 友好但非强制：支持 Claude Code、Codex CLI、Gemini CLI 等配置路径，并提供 AGENTS 文件供 Agent 理解仓库。
• 键盘优先：编辑器与命令面板围绕重度用户设计。

安装方式

macOS 可通过 Homebrew 安装：

brew install --cask tolaria

也可以从官方发布页下载 macOS、Windows 或 Linux 的安装包。Windows 安装包已做 Authenticode 签名，但企业托管设备可能仍需 IT 审批。

快速上手

首次启动时，可以克隆官方的「getting started vault」，跟随引导了解整个应用。公开用户文档位于仓库的 site/ 目录并发布到 GitHub Pages，建议从安装与首次启动章节开始阅读。

本地开发

Tolaria 使用 Tauri、React 与 TypeScript 构建。本地运行需要：

• Node.js 20+
• pnpm 8+
• Rust stable
• macOS 或 Linux 开发环境

Linux 下 Tauri 2 需要 WebKit2GTK 4.1 与 GTK 3，不同发行版需安装对应系统依赖。安装完成后：

pnpm install
pnpm dev

浏览器 mock 模式可访问 http://localhost:5173，运行原生桌面应用则使用：

pnpm tauri dev

技术文档

仓库提供架构文档，涵盖系统设计、技术栈与数据流，适合想深入了解实现或参与贡献的开发者。