refactoringhq/tolaria 源码: https://github.com/refactoringhq/tolaria 最新稳定 CI (https://github.com/refactoringhq/tolaria/actions/workflows/ci.yml) Codecov (https://codecov.io/gh/refactoringhq/tolaria) CodeScene 热点代码健康度 (https://codescene.io/projects/76865) # 💧 Tolaria Tolaria 是一款适用于 macOS、Windows 和 Linux 的桌面应用，用于管理 markdown 知识库。人们将其用于多种场景：* 运行第二大脑和个人知识库 * 组织公司文档作为 AI 的上下文 * 存储 OpenClaw/助手的内存和流程 就我个人而言，我用它来 管理我的生活（嘿 👋 我是 Luca (http://x.com/lucaronin)）。我有一个包含 10000+ 条笔记的大型工作区，这些笔记来自我的 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 是为管理我个人 10000+ 条笔记的知识库而创建的，我每天都在使用它。每个功能的存在都是因为它解决了一个实际问题。 ## 安装 ### Homebrew 通过 Homebrew 在 macOS 上安装：batch brew install --cask tolaria ### 从发布版下载 从此处 (https://refactoringhq.github.io/tolaria/download/) 下载适用于 macOS、Windows 或 Linux 的最新发布版。Windows 安装程序已通过 Authenticode 签名；公司管理的设备可能仍需要 IT 批准 Tolaria 发布者才能首次安装。 ## 快速开始 当你首次打开 Tolaria 时，有机会克隆入门知识库 (https://github.com/refactoringhq/tolaria-getting-started) —— 它会带你浏览整个应用的教程。 公共用户文档位于 site/ 并发布到 GitHub Pages。从 安装 Tolaria 开始，然后查看 首次启动。 ## 开源与本地搭建 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 系统依赖 Tauri 2 在 Linux 上需要 WebKit2GTK 4.1 和 GTK 3：- Arch / Manjaro：bash sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl \ appmenu-gtk-module libappindicator-gtk3 librsvg - Debian / Ubuntu (22.04+)：bash 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+：bash sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \ libappindicator-gtk3-devel librsvg2-devel 捆绑的 MCP 服务器在 Linux 上运行时仍会调用系统中的 node 二进制文件，因此如果你需要使用外部 AI 工具流程，请通过发行版的包管理器安装 Node。 ### 快速启动 bash pnpm install pnpm dev 打开 http://localhost:5173 使用基于浏览器的模拟模式，或使用以下命令运行原生桌面应用：bash pnpm tauri dev ## 技术文档 - 📐 ARCHITECTURE.md — 系统设计、技术栈、数据流 - 🧩 ABSTRACTIONS.md — 核心抽象与模型 - 🚀 GETTING-STARTED.md — 如何浏览代码库 - 📚 ADRs — 架构决策记录 ## 安全 如果你认为发现了安全问题，请按照 SECURITY.md 中的描述私下报告。 ## 许可证 Tolaria 采用 AGPL-3.0-or-later 许可证。Tolaria 名称和标志仍受项目商标政策保护。