refactoringhq/tolaria
GitHub: refactoringhq/tolaria
一款开源的跨平台桌面应用，以纯 Markdown 文件和 Git 仓库的方式管理知识库，强调数据自主、离线可用和 AI 友好。
Stars: 9508 | Forks: 681
 [](https://github.com/refactoringhq/tolaria/actions/workflows/ci.yml) [](https://github.com/refactoringhq/tolaria/actions/workflows/release.yml) [](https://codecov.io/gh/refactoringhq/tolaria) [](https://codescene.io/projects/76865)
# 💧 Tolaria
Tolaria 是一款适用于 macOS、Windows 和 Linux 的桌面应用程序，用于管理 **Markdown 知识库**。人们将其用于各种用例：
* 运营第二大脑和个人知识
* 将公司文档整理为 AI 的上下文
* 存储 OpenClaw/助手的记忆和流程
就我个人而言，我用它来**管理我的生活**（嗨 👋 [我是 Luca](http://x.com/lucaronin)）。我拥有一个包含 10,000 多条笔记的庞大工作区，这是我从事 [Refactoring](https://refactoring.fm/) 工作的成果 + 大量的个人日记和*第二大脑*记录。
## 演示视频
您可以在下面找到一些 Loom 演示视频 —— 它们简短且切中要害：
- [我如何组织我自己的 Tolaria 工作区](https://www.loom.com/share/bb3aaffa238b4be0bd62e4464bca2528)
- [我的收件箱工作流](https://www.loom.com/share/dffda263317b4fa8b47b59cdf9330571)
- [我如何将网络资源保存到 Tolaria](https://www.loom.com/share/8a3c1776f801402ebbf4d7b0f31e9882)
## 原则
- 📑 **文件优先** — 您的笔记是纯 Markdown 文件。它们是可移植的，适用于任何编辑器，并且不需要导出步骤。您的数据属于您自己，而不属于任何应用程序。
- 🔌 **Git 优先** — 每个知识库都是一个 Git 仓库。您可以获得完整的版本历史记录，能够使用任何 Git 远程仓库，并且完全不依赖于 Tolaria 服务器。
- 🛜 **离线优先，零锁定** — 无需账户，无需订阅，无云依赖。您的知识库完全可以离线工作，并且将始终如此。如果您停止使用 Tolaria，您不会丢失任何东西。
- 🔬 **开源** — Tolaria 是免费且开源的。我为自己(https://x.com/lucaronin)构建了这个工具，同时也为了与他人分享。
- 📋 **基于标准** — 笔记是带有 YAML frontmatter 的 Markdown 文件。没有专有格式，没有数据锁定。如果您决定不再使用 Tolaria，一切都可以与标准工具配合使用。
- 🔍 **类型作为透镜，而非模式** — Tolaria 中的类型是导航辅助工具，而非强制执行机制。没有必填字段，没有验证，只有用于查找笔记的有用类别。
- 🪄**AI 优先但非仅限 AI** — 由文件组成的知识库与 AI 代理配合得非常好，但您可以自由使用任何您想要的工具。我们支持 Claude Code、Codex CLI 和 Gemini CLI 的设置路径，但您可以使用任何 AI 来编辑知识库。我们提供了一个 AGENTS 文件，以便您的代理进行识别。
- ⌨️ **键盘优先** — Tolaria 专为希望尽可能多使用键盘的高级用户而设计。我们设计编辑器和命令面板的很多地方都是基于这一理念。
- 💪 **源于真实使用** — Tolaria 的创建是为了管理我个人的包含 10,000 多条笔记的知识库，并且我每天都在使用它。每一项功能的存在都是因为它解决了一个实际问题。
## 安装
### Homebrew
在 macOS 上通过 Homebrew 安装：
```
brew install --cask tolaria
```
### 从发布版本下载
在[此处下载最新版本](https://refactoringhq.github.io/tolaria/download/)，适用于 macOS、Windows 或 Linux。
## 入门指南
当您首次打开 Tolaria 时，您将有机会克隆[入门知识库](https://github.com/refactoringhq/tolaria-getting-started) —— 它将为您提供一个整个应用程序的演练。
## 开源与本地设置
Tolaria 是开源的，并使用 Tauri、React 和 TypeScript 构建。如果您想在本地运行该应用程序或为其做出贡献，这里是[如何开始](https://github.com/refactoringhq/tolaria/blob/main/docs/GETTING-STARTED.md)。您也可以在下面找到要点 👇
### 前置条件
- Node.js 20+
- pnpm 8+
- Rust stable
- macOS 或 Linux 用于开发
#### Linux 系统依赖
Linux 上的 Tauri 2 需要 WebKit2GTK 4.1 和 GTK 3：
- Arch / Manjaro:
sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl \
appmenu-gtk-module libappindicator-gtk3 librsvg
- Debian / Ubuntu (22.04+):
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
- Fedora 38+:
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \
libappindicator-gtk3-devel librsvg2-devel
打包的 MCP 服务器在运行时仍会在 Linux 上生成系统 `node` 二进制文件，因此如果您希望使用外部 AI 工具流程，请从您的发行版包管理器安装 Node。
### 快速开始
```
pnpm install
pnpm dev
```
打开 `http://localhost:5173` 以进入基于浏览器的模拟模式，或者运行原生桌面应用程序：
```
pnpm tauri dev
```
## 技术文档
- 📐 [ARCHITECTURE.md](docs/ARCHITECTURE.md) — 系统设计、技术栈、数据流
- 🧩 [ABSTRACTIONS.md](docs/ABSTRACTIONS.md) — 核心抽象和模型
- 🚀 [GETTING-STARTED.md](docs/GETTING-STARTED.md) — 如何浏览代码库
- 📚 [ADRs](docs/adr) — 架构决策记录
## 安全性
如果您认为自己发现了安全问题，请按照 [SECURITY.md](./SECURITY.md) 中的说明进行私下报告。
## 许可证
Tolaria 根据 AGPL-3.0-or-later 获得许可。Tolaria 的名称和徽标仍受项目的商标政策保护。
## 演示视频
您可以在下面找到一些 Loom 演示视频 —— 它们简短且切中要害：
- [我如何组织我自己的 Tolaria 工作区](https://www.loom.com/share/bb3aaffa238b4be0bd62e4464bca2528)
- [我的收件箱工作流](https://www.loom.com/share/dffda263317b4fa8b47b59cdf9330571)
- [我如何将网络资源保存到 Tolaria](https://www.loom.com/share/8a3c1776f801402ebbf4d7b0f31e9882)
## 原则
- 📑 **文件优先** — 您的笔记是纯 Markdown 文件。它们是可移植的，适用于任何编辑器，并且不需要导出步骤。您的数据属于您自己，而不属于任何应用程序。
- 🔌 **Git 优先** — 每个知识库都是一个 Git 仓库。您可以获得完整的版本历史记录，能够使用任何 Git 远程仓库，并且完全不依赖于 Tolaria 服务器。
- 🛜 **离线优先，零锁定** — 无需账户，无需订阅，无云依赖。您的知识库完全可以离线工作，并且将始终如此。如果您停止使用 Tolaria，您不会丢失任何东西。
- 🔬 **开源** — Tolaria 是免费且开源的。我为自己(https://x.com/lucaronin)构建了这个工具，同时也为了与他人分享。
- 📋 **基于标准** — 笔记是带有 YAML frontmatter 的 Markdown 文件。没有专有格式，没有数据锁定。如果您决定不再使用 Tolaria，一切都可以与标准工具配合使用。
- 🔍 **类型作为透镜，而非模式** — Tolaria 中的类型是导航辅助工具，而非强制执行机制。没有必填字段，没有验证，只有用于查找笔记的有用类别。
- 🪄**AI 优先但非仅限 AI** — 由文件组成的知识库与 AI 代理配合得非常好，但您可以自由使用任何您想要的工具。我们支持 Claude Code、Codex CLI 和 Gemini CLI 的设置路径，但您可以使用任何 AI 来编辑知识库。我们提供了一个 AGENTS 文件，以便您的代理进行识别。
- ⌨️ **键盘优先** — Tolaria 专为希望尽可能多使用键盘的高级用户而设计。我们设计编辑器和命令面板的很多地方都是基于这一理念。
- 💪 **源于真实使用** — Tolaria 的创建是为了管理我个人的包含 10,000 多条笔记的知识库，并且我每天都在使用它。每一项功能的存在都是因为它解决了一个实际问题。
## 安装
### Homebrew
在 macOS 上通过 Homebrew 安装：
```
brew install --cask tolaria
```
### 从发布版本下载
在[此处下载最新版本](https://refactoringhq.github.io/tolaria/download/)，适用于 macOS、Windows 或 Linux。
## 入门指南
当您首次打开 Tolaria 时，您将有机会克隆[入门知识库](https://github.com/refactoringhq/tolaria-getting-started) —— 它将为您提供一个整个应用程序的演练。
## 开源与本地设置
Tolaria 是开源的，并使用 Tauri、React 和 TypeScript 构建。如果您想在本地运行该应用程序或为其做出贡献，这里是[如何开始](https://github.com/refactoringhq/tolaria/blob/main/docs/GETTING-STARTED.md)。您也可以在下面找到要点 👇
### 前置条件
- Node.js 20+
- pnpm 8+
- Rust stable
- macOS 或 Linux 用于开发
#### Linux 系统依赖
Linux 上的 Tauri 2 需要 WebKit2GTK 4.1 和 GTK 3：
- Arch / Manjaro:
sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl \
appmenu-gtk-module libappindicator-gtk3 librsvg
- Debian / Ubuntu (22.04+):
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
- Fedora 38+:
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \
libappindicator-gtk3-devel librsvg2-devel
打包的 MCP 服务器在运行时仍会在 Linux 上生成系统 `node` 二进制文件，因此如果您希望使用外部 AI 工具流程，请从您的发行版包管理器安装 Node。
### 快速开始
```
pnpm install
pnpm dev
```
打开 `http://localhost:5173` 以进入基于浏览器的模拟模式，或者运行原生桌面应用程序：
```
pnpm tauri dev
```
## 技术文档
- 📐 [ARCHITECTURE.md](docs/ARCHITECTURE.md) — 系统设计、技术栈、数据流
- 🧩 [ABSTRACTIONS.md](docs/ABSTRACTIONS.md) — 核心抽象和模型
- 🚀 [GETTING-STARTED.md](docs/GETTING-STARTED.md) — 如何浏览代码库
- 📚 [ADRs](docs/adr) — 架构决策记录
## 安全性
如果您认为自己发现了安全问题，请按照 [SECURITY.md](./SECURITY.md) 中的说明进行私下报告。
## 许可证
Tolaria 根据 AGPL-3.0-or-later 获得许可。Tolaria 的名称和徽标仍受项目的商标政策保护。标签：AI上下文, Markdown, PKM, Refactoring, Tolaria, 个人知识管理, 企业文档, 可视化界面, 开源, 效率工具, 文件管理, 日记, 桌面应用, 知识库管理, 笔记软件, 第二大脑, 网络安全研究, 自动化攻击, 防御加固