Tolaria 的 Vault 使用指南：打开、创建与多 Vault 统一图谱实践

Tolaria 的 Vault 使用指南打开、创建与多 Vault 统一图谱实践【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria一篇关于 TolariaMarkdown 知识库桌面应用中 Vault库生命周期的实战指南讲解 Vault 的文件本质、如何打开现有 Markdown 文件夹或新建 Vault、如何启用多 Vault 统一图谱unified graph以及 Git 为何是推荐而非必需。读完本文你能独立完成 Vault 的注册、多库挂载与跨库 wikilink 配置并理解其背后的文件系统优先filesystem-first设计。一、Vault 的本质磁盘上的一个文件夹Tolaria 的 Vault 不是一个数据库而是磁盘上的一个普通文件夹。这个文件夹可以包含Markdown 笔记.md文件附件普通文件类型定义文件type definitions已保存的视图saved viewsGit 元数据.git目录可选。这与 Tolaria 的架构决策一致文件系统是唯一的真实来源source of truth应用状态和缓存都由文件派生。在 Vaults 概念文档 中这一原则被明确列为核心规则Notes are Markdown files. YAML frontmatter provides structure. Attachments are normal files inside the vault. Type definitions and saved views are also files.这种本地文件优先的设计带来直接的好处你的笔记始终可用其他编辑器打开、用命令行工具检索、用自有系统备份也可以用 Git 做版本管理。换句话说Tolaria 永远不是读取你数据的唯一途径。二、打开一个现有文件夹作为 Vault如果你已经拥有一批 Markdown 笔记直接选择现有文件夹即可。Tolaria 会扫描其中的.md文件并在存在 YAML frontmatter 时解析其结构化信息如type、tags等属性。文档推荐了四类适合起步的文件夹形态纯 Markdown 文件文件夹—— 没有任何特殊结构最简起步方式Obsidian 风格的 Vault—— Obsidian 的 Vault 本质上也是文件夹加.md文件Tolaria 可以直接打开包含笔记的 Git 仓库—— 打开后即可使用历史、提交、同步等 Git 能力Getting Started Vault 的副本—— 复制 Tolaria 提供的示例库获得开箱即用的类型定义和示例笔记对应仓库中的 demo-vault 与 Getting Started 文档。三、创建一个新 Vault如果你希望从一开始就遵循 Tolaria 的约定conventions选择一个全新的空文件夹作为 Vault。Tolaria 会在其中创建新笔记Markdown 文件标题与文件名保持同步可选的类型定义文件type definitions用于为笔记建立type属性等结构化元数据。所有产物都是普通 Markdown 文件因此可以随时用任何编辑器处理也方便纳入 Git 版本控制。四、多 Vault 同时使用统一图谱Unified Graph当笔记分布在多个本地文件夹时不必把所有内容合并进一个大目录。推荐做法是把每个本地文件夹分别注册为独立 Vault然后在Settings→Vaults中开启Use multiple vaults at the same time同时使用多个 Vault开关。4.1 开关与设置界面该开关在设置面板中由 WorkspaceSettingsSection 组件渲染对应多语言文案键为settings.workspaces.enable其英文描述见 en.json为Experimental: load included vaults into one graph. Leave this off to use one vault at a time.即这是一个实验性功能把被包含included的 Vault 加载进同一个图谱关闭它则每次只使用一个 Vault。开启后设置区会进一步展示各 Vault 的排序、移除、默认工作区设置等行WorkspaceSettingsRows可以重命名 Vault、设置颜色、选择新建笔记的默认落点。4.2 启用后的行为图谱统一Git 按库隔离开启该选项后左下角的 Vault 菜单会为每个 Vault 提供Include {vault} in the unified graph将该 Vault 纳入统一图谱的复选框该行为在 StatusBar 测试 中有覆盖。被包含的 Vault 会一起出现在笔记列表note lists搜索search与快速打开quick open反向链接backlinks与 wikilink 导航。而Git 状态、提交、同步、文件夹导航、已保存视图和 Vault 修复操作仍然限定在当前选中的 Vault当前仓库范围内——每个 Vault 的 Git 历史和提交只与其自身仓库绑定互不干扰。4.3 跨库 Wikilink目标 Vault 别名前缀跨 Vault 的 wikilink 使用目标 Vault 的稳定别名stable alias作为前缀例如[[team/projects/alpha]]其中team即目标 Vault 的别名同一 Vault 内部的链接保持普通的库相对vault-relative形式不带任何机器相关路径。4.4 源码级实现vaults.json 与挂载工作区从源码结构看这一能力的核心数据模型在 vault_list.rs 中定义VaultEntry结构体持久化每个 Vault 的label、path、稳定alias、color、icon以及mounted挂载标志VaultList则额外记录active_vault当前活动 Vault和default_workspace_path新建笔记的默认落点。这些身份数据保存在应用配置目录的vaults.json中机器本地状态不随 Vault 文件夹走。架构层面的决策记录见 ADR-0114Mounted workspaces unified graph其中明确了五条原则vaults.json持久化工作区身份label、稳定 alias、颜色、挂载标志和新建笔记的默认工作区路径useVaultLoader从所有可用的挂载工作区加载条目并在 React 消费合并图谱前为每个VaultEntry附加WorkspaceIdentity活动 Vault 切换仍是 Git、文件夹树、已保存视图、文件监视、修复等按仓库操作的焦点控制Wikilink 保持 Markdown 优先同库链接保持库相对路径跨库链接前缀目标库别名在后端 Tauri 边界上当未显式提供vaultPath时绝对路径的读写可解析到最深的已注册 Vault 根目录且所有磁盘操作仍按注册根做路径包含校验——多 Vault 挂载不会放宽文件系统访问边界。ADR 同时解释了为何不采用把多个仓库合并成一个 Vault会强迫用户折叠无关的 Git 历史或在 wikilink 中写绝对路径会让笔记不可移植并泄露机器路径等替代方案。五、Git推荐但非必需Tolaria 对纯 Markdown 文件夹工作得很好即使 Vault 不是 Git 仓库你也可以正常打开、编辑、整理和搜索笔记。当你需要本地历史、diff 视图、恢复、pull/push 以及不依赖专有后端的远程同步时Git 才被推荐。如果 Vault 尚不是仓库Tolaria 可以在你明确要求时为其初始化一个 Git 仓库。这一行为在 ADR-0085Non-git vaults open with explicit later Git initialization 中有完整定义打开非 Git 文件夹后Tolaria 会询问是否初始化 Git若你忽略提示应用继续正常工作状态栏会持续显示Git disabled警告。点击该警告或从命令面板运行Initialize Git for Current Vault都可以重新打开初始化动作非 Git 期间Git 历史、变更、提交、同步、冲突与远程操作被隐藏或禁用后台自动同步与 AutoGit 检查点不运行而 Markdown 扫描、浏览、编辑和搜索照常进行避免对 Desktop、Documents、Downloads 这类宽泛的个人目录做隐式初始化除非它明显是专用 Vault 文件夹。后端初始化统一走init_git_repo这一条命令链路入口如 commands/git.rs 中调用的crate::git::init_repo(...)实际实现见 git/mod.rs 的init_repo函数约 L470。它会创建仓库、写入 Tolaria 默认.gitignore、暂存整个 Vault 并创建初始提交。六、小结Vault 状态与 App 状态的边界在管理 Vault 时一个值得记住的分层原则见 site/concepts/vaults.md随 Vault 文件夹走Vault 状态随应用安装走App 状态类型图标与颜色编辑器缩放已保存视图窗口大小固定的属性pinned properties最近 Vault 列表vaults.json关系约定本地缓存Vault AI 指导文件AI 目标选择掌握这条边界你就能在多 Vault、多 Git 仓库的场景下清楚地知道哪些约定会随文件夹迁移和共享哪些偏好只属于本机应用。参考资料本仓库内路径打开或创建 Vault源文档打开或创建 Vault站点文档Vaults 概念ADR-0114 挂载工作区统一图谱ADR-0085 非 Git Vault 支持vaults.json 数据模型Git 初始化实现多 Vault 设置组件【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考