Tolaria 如何从 Portent 模板知识库起步并完成类型与关系初始化？

Tolaria 如何从 Portent 模板知识库起步并完成类型与关系初始化？

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria

如果你的知识库是空文件夹，第一件事往往不是记笔记，而是决定"一条笔记是什么"。Tolaria 提供了一个现成的起步方案：Portent 模板。它给 Tolaria vault 一组开箱默认的约定——八种类型、两种关系字段和"捕获 → 整理 → 归档"的生命周期——你不需要先设计一套私有分类法就能开始使用。这篇文章讲清楚三件事：如何拿到并打开 Portent 模板 vault、如何完成类型（Type）初始化、以及如何把belongs_to/related_to两个关系字段用起来并验证生效。

前提只有一个：一个 Tolaria vault 就是磁盘上的一个文件夹，包含 Markdown 笔记、附件、类型定义和保存的视图，文件系统是唯一事实来源（vault 概念说明）。Git 是推荐项而非必需项：普通 Markdown 文件夹就能直接打开，需要历史、diff、远端同步时再初始化 Git。

Portent 模板给了什么

Portent 是一个开放规范加模板，核心是三个问题："这是什么？用来做什么？是捕获、整理还是归档？"这三个问题直接对应 Tolaria 的类型文档、关系字段、Inbox 和归档行为。模板默认提供：

• 八种类型，分两组：
  • PORT（可执行）：Project、Operation、Responsibility、Task
  • ENTP（非可执行的知识记录）：Event、Note、Topic、Person
• 两个默认关系字段：
  • belongs_to：主归属、组成或上下文
  • related_to：较松的语义连接
• 一个生命周期：快速捕获 → 赋予类型和关系完成整理 → 不再需要时归档

模板的使用方式文档给出了三种：原样使用、按自己的语言重命名各部分、或者当作自己 Tolaria 配置的参考模型。本文章按"原样起步"来写。

模板仓库的入口链接在 site/templates/portent.md 中（指向 refactoringhq/portent-vault-template），用git clone把该模板克隆到本地，得到一个含类型文档和示例笔记的文件夹，作为下一步要打开的 vault。

打开模板 vault 并确认类型加载

1. 在 Tolaria 中打开克隆好的模板文件夹。选择已有文件夹时，Tolaria 会扫描其中的.md文件并在存在 frontmatter 时使用它（打开或创建 vault）。
2. 打开后先检查侧边栏的 Types 区域：八种默认类型应当已经按类型文档加载，各自带有图标、颜色、侧边栏顺序和标签。

模板的八份类型文档就是 vault 根目录下type: Type的 Markdown 文件，可以在本仓库的演示 vault 中对照查看实际形态：type/note.md、type/project.md、type/person.md、type/topic.md、type/event.md、type/area.md、type/measure.md、type/responsibility.md。

类型由type:字段决定，Tolaria 不会根据文件所在的文件夹推断类型——把文件移动到别的文件夹不会改变它的类型。类型文档控制的是：侧边栏分组、类型图标与颜色、侧边栏顺序与标签、置顶属性、新建笔记模板（类型概念）。

初始化类型：确认或新增一个 Type 文档

模板自带类型文档时，这一步主要是核对；如果你想新增类型（比如模板没有的Procedure），操作路径是：

1. 从命令面板运行New Type，或点击侧边栏 Types 标题处的+（创建类型指南）。
2. 给类型起一个明确的名称。
3. 按需添加图标、颜色、侧边栏顺序、侧边栏标签、置顶属性、建议字段、默认值或新建笔记模板。

类型文档的标准形态如下（来自文档示例）：

--- type: Type _icon: folder _color: blue _sidebar_label: Projects _order: 10 --- # Project

其中_icon使用 kebab-case 的 Phosphor 图标名，例如folder或briefcase。两个容易忽略的初始化细节：

• 模板内容：类型文档可以在templatefrontmatter 字段里放新笔记模板；手写编辑类型文档正文时，# TypeName标题之后的模板化结构（字段标签、二级标题、清单起点）也会被用作新笔记模板，纯描述性文字则只作为文档保留。
• 默认值 vs 占位符：类型文档中定义为空的属性和关系，会在该类型的新笔记里显示为占位符，从 Properties 面板填写即可；如果某个属性带了值（例如 Project 类型写了status: Active），这个值就变成该类型所有新笔记的默认值。

初始化关系字段：belongs_to 与 related_to

Portent 把知识建成一张图，关系可以写在 YAML frontmatter 里、用 wikilink 指向其他笔记，这样图在应用外依然可读、可搜索、可移植。关系字段的写法（frontmatter 示例，来自 relationships 概念文档）：

belongs_to: - "[[product-work]]" related_to: - "[[documentation]]" - "[[editor-research]]"

Tolaria 开箱支持三个默认关系字段：belongs_to、has、related_to；frontmatter 里任何包含 wikilink 的字段都会被动态识别为关系字段，所以blocked_by这类自定义字段同样生效。关系字段可以指向一条笔记，也可以指向一组笔记（数组）。

两个不必手写的行为：

• 自动逆关系：belongs_to有自动计算的逆关系has。一条笔记声明自己属于某个 project 后，该 project 会在has关系下显示这条笔记，不需要手写反向链接。related_to是横向关系，双向生效。
• 展示位置：出向关系和逆关系会出现在 Properties 面板和 Neighborhood 模式中——Neighborhood 模式下笔记列表会变成围绕所选笔记的图视图。

正文链接与关系字段的分工：如果关系在行文中自然出现，用正文链接即可；如果这个连接重要到需要在导航、过滤、Neighborhood 模式或 Properties 面板中显示，就写进 frontmatter 关系字段。

验证初始化是否生效

按 Inbox 整理流程 走一遍完整闭环来验证：

1. 新建一条捕获笔记（或直接把 Inbox 中的笔记整理出来），给它一个清晰的 H1。

2. 设置它的type字段为某个已初始化类型，例如Project：

   type: Project

3. 在 Properties 面板确认类型文档定义的空属性以占位符出现、带值的属性已经填好默认值——这是类型初始化的直接证据。

4. 在 frontmatter 中给这条笔记加一条belongs_towikilink 指向某条项目笔记，然后打开该项目的 Properties 面板，确认它出现在对方的has逆关系里。

5. 切换到 Neighborhood 模式，确认两条笔记之间的边出现在图视图中。

另外两个可用的核对点：类型在侧边栏按_sidebar_label和_order分组排序；Inbox 工作流本身是可选的，如果你希望每条笔记默认就是整理好的状态，可以在 Settings > Workflow 中关掉它。

边界与限制

• Portent 模板是起步词汇表，不是强制规范：文档明确建议先用默认词汇表，之后再按需添加自定义类型。
• 类型与文件夹解耦：移动文件不改变类型，也不要依赖文件夹位置做语义分组。
• 模板仓库地址、图标名和字段名请以 site/templates/portent.md 和 site/concepts/types.md 中的原文为准；模板内容可整体重命名以匹配你的语言。
• 多 vault 场景下（Settings -> Vaults ->Use multiple vaults at the same time），搜索、快速打开、backlink 和 wikilink 导航可以跨 vault，但 Git 操作始终绑定各自 vault 的仓库——模板 vault 与正式 vault 并存试用时这一点对提交行为有影响。

完成以上步骤后，vault 里应当是：八份类型文档在根目录加载、新笔记按类型带默认值和占位符、belongs_to/related_to在 Properties 面板与 Neighborhood 模式中可见。这就是 Portent 起步的完整终态，后续再按需扩展自定义类型或视图。

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria