refactoringhq/tolaria

Overview

项目介绍

Technical Route

技术路线

Tolaria 采用「Tauri（跨桌面应用框架）+ React + TypeScript」技术栈，围绕「文件优先、Git优先」核心原则构建Markdown知识库管理体系。主线为：通过Tauri实现跨桌面原生能力，React负责UI交互，TypeScript保障类型安全；核心模块包括Git版本管理、Markdown编辑器、AI集成、本地文件系统操作，各模块协作实现离线可用、用户完全掌控数据的知识库管理能力，理解此路线可清晰把握其无锁、跨端、可扩展的特性。

1. 1跨桌面容器层：基于Tauri（跨桌面应用框架）构建，依托Rust后端实现原生系统资源访问，前端使用React+TypeScript开发UI，既保证跨macOS、Windows、Linux的兼容性，又具备原生应用的性能与系统集成能力，同时支持浏览器Mock模式用于开发调试。
2. 2Git版本管理层：将每个知识库（Vault）作为Git仓库，自动处理版本记录、远程同步逻辑，无需依赖Tolaria服务器，用户可通过标准Git工具操作数据，实现数据完全可控、可迁移，同时支持离线环境下的版本追溯。
3. 3Markdown编辑层：集成Blocknote（开源富文本Markdown编辑器），支持带YAML前置元数据的标准Markdown格式，提供键盘优先的操作逻辑，同时实现标题与文件名自动关联、Wiki链接路径修复等知识库专属编辑能力，兼容第三方Markdown工具。
4. 4AI协作层：内置Anthropic Claude、Gemini等AI工具的集成路径，通过MCP服务器（模型控制协议服务器）实现AI与知识库的交互，提供AGENTS配置文件供AI识别知识库结构，支持将知识库作为AI上下文数据源，同时允许用户自由替换AI工具。
5. 5本地文件操作层：遵循「文件优先」原则，直接操作本地文件系统中的Markdown文件，无中间数据存储层，支持离线使用，数据完全由用户掌控，无需账户与订阅，同时实现文件自动保存、多标签页切换时的前置保存校验等逻辑。
6. 6测试保障层：采用Playwright（浏览器自动化测试框架）实现端到端测试，包含冒烟测试、回归测试、集成测试三类场景，覆盖自动保存、知识库创建、AI交互等核心流程，同时通过Vitest实现单元测试，配合Codecov保障代码覆盖率。

Why Trending

为什么它会上榜

结合增长、最近更新与社区关注，给出一个更接近“决策参考”的上榜解读。

• 社区关注度上升：近期新增 +821 Stars（today），讨论热度明显提高。
• 维护活跃：最近更新于 2026/06/09，更可能持续迭代与补齐文档/生态。
• 定位清晰：一款桌面应用，专为管理Markdown格式知识库设计，支持分类检索、编辑，帮你高效整理和查阅知识内容

Quick Start

怎么开始

1. 前往仓库Release页面下载对应系统安装包；2. 打开安装包完成安装；3. 启动应用即可创建知识库

使用前注意事项

• 项目采用AGPL-3.0许可证，商用二次开发需遵守开源协议条款
• Linux系统部署需额外安装WebKit2GTK 4.1、GTK 3等依赖库，否则无法正常运行
• 无团队协作功能，仅适合单人使用，若需多人协同需自行配置Git远程仓库

Related

相关项目