---
title: "术语表"
description: "Notarium 术语：空间、项目、notarium-id、笔记类别、主体、PAT、修订日志、RRF 等。"
---

# 术语表

Notarium 核心术语的简短定义。每个术语都链接到对其详尽说明的页面。

## 存储与身份

**file-first（文件优先）** — 一条原则：唯一可信来源就是磁盘上的 Markdown 文件本身。搜索索引、链接图谱以及一切派生内容都可以从这些文件重建；你随时都能拷走整个文件夹一走了之。详见 [文件优先](/docs/concepts/file-first/)。

**空间（space）** — 一个隔离的知识库，拥有独立的索引、图谱、搜索、树形结构、修订日志和成员名册。每位用户都有一个不可删除的个人空间（在面向智能体的页面上称为**个人域**）。详见 [空间与项目](/docs/concepts/spaces-and-projects/)。

**项目（project）** — 一个轻量、可选的实体：空间内一个被标记、具备稳定身份的文件夹（标记为文件夹根目录下的一个 dot 文件）。智能体通过句柄 `space/slug` 来寻址它。详见 [空间与项目](/docs/concepts/spaces-and-projects/)。

**`notarium-id`** — frontmatter 中一个稳定的 12 字符笔记标识符。它能在文件被移动和重命名后依然保留，因此链接和历史永不断裂。详见 [版本历史](/docs/concepts/versioning/)。

**笔记类别（note class）** — 一组可见性与索引策略，由笔记的存储位置推导得出（并非一个自由填写的字段）：`user-doc`（用户笔记，处处可见）、`agent-memory`（智能体记忆，会被索引并可通过 `recall` 访问，但对面向用户的界面隐藏），外加内部的 `attachment`、`derived` 和 `profile`。详见 [笔记类型](/docs/concepts/note-types/)。

## 访问与智能体

**主体（principal）** — 一个泛化的访问主体：人或 AI 智能体。所有主体共用同一套授权机制。详见 [访问模型](/docs/concepts/access-model/)。

**角色（roles）** — 空间内的成员资格：`reader`（读取一切）、`writer`（编辑笔记）、`owner`（管理成员资格）。详见 [访问模型](/docs/concepts/access-model/)。

**PAT（Personal Access Token，个人访问令牌）** — 面向智能体的个人访问令牌，通过 `Authorization: Bearer …` 请求头发送。它携带作用域（`read`/`write`）、可选的空间限定，以及一个过期时间。令牌明文仅显示一次。详见 [连接智能体](/docs/agents/connect/)。

**MCP 网关** — 内置的 `POST /mcp` 端点，AI 智能体通过它以面向意图的工具（而非通用的 CRUD 操作）读写知识库。智能体的编辑会被版本化、受访问权限约束，并带溯源签名。详见 [智能体与 MCP](/docs/agents/)。

**意图工具（intent tool）** — MCP 网关的一种工具，表达的是一个意图（“查找”“创建笔记”），而非针对存储的底层 CRUD 操作。详见 [意图工具](/docs/agents/intent-tools/)。

## 搜索

**混合搜索（hybrid search）** — 三个通道的融合：词法（全文 FTS/BM25，始终开启）、语义（向量，由开关启用），以及可选的图谱加权。结果由 RRF 算法合并。详见 [搜索](/docs/concepts/search/)。

**RRF（Reciprocal Rank Fusion，倒数排名融合）** — 一种算法，在没有统一分数标度的情况下，对多个排名列表（词法 + 语义 + 图谱）加权融合成单一结果集。详见 [搜索](/docs/concepts/search/)。

**降级（degradation）** — 当某项能力的依赖不存在时，回退到更简单的变体：如果向量栈被关闭或不可用，搜索会继续基于全文（FTS）工作——不报错，结果一致。详见 [搜索配置](/docs/self-hosting/search-setup/)。

## 版本与溯源

**修订日志（revision log）** — 笔记在元数据库（而非 git）中的版本历史。一次修订是状态的完整快照；相同状态会按内容去重。日志以 `notarium-id` 为键，因此历史能在移动/重命名后保留。详见 [版本历史](/docs/concepts/versioning/)。

**溯源（provenance）** — 对每次修订的归属：由谁、以何种方式做出这次编辑——某个具体的人、某个具体的 AI 智能体，或某个外部文件编辑器。详见 [版本历史](/docs/concepts/versioning/)。

## 部署

**self-host（自托管）** — Notarium 的部署模型：单个自包含容器（Node/Fastify，引擎在进程内，无外部服务）。隐私来自你对服务器和文件的掌控，而非端到端加密。详见 [自托管](/docs/self-hosting/)。

## 另见

- [环境变量](/docs/reference/environment-variables/) — 完整的配置表。
- [快捷键参考](/docs/reference/keyboard-shortcuts/) — 布局与预设。
- [概念](/docs/concepts/) — Notarium 的构建原理。
</content>
</invoke>