术语表
Notarium 核心术语的简短定义。每个术语都链接到对其详尽说明的页面。
存储与身份
file-first（文件优先） — 一条原则：唯一可信来源就是磁盘上的 Markdown 文件本身。搜索索引、链接图谱以及一切派生内容都可以从这些文件重建；你随时都能拷走整个文件夹一走了之。详见 文件优先。
空间（space） — 一个隔离的知识库，拥有独立的索引、图谱、搜索、树形结构、修订日志和成员名册。每位用户都有一个不可删除的个人空间（在面向智能体的页面上称为个人域）。详见 空间与项目。
项目（project） — 一个轻量、可选的实体：空间内一个被标记、具备稳定身份的文件夹（标记为文件夹根目录下的一个 dot 文件）。智能体通过句柄 space/slug 来寻址它。详见 空间与项目。
notarium-id — frontmatter 中一个稳定的 12 字符笔记标识符。它能在文件被移动和重命名后依然保留，因此链接和历史永不断裂。详见 版本历史。
笔记类别（note class） — 一组可见性与索引策略，由笔记的存储位置推导得出（并非一个自由填写的字段）：user-doc（用户笔记，处处可见）、agent-memory（智能体记忆，会被索引并可通过 recall 访问，但对面向用户的界面隐藏），外加内部的 attachment、derived 和 profile。详见 笔记类型。
访问与智能体
主体（principal） — 一个泛化的访问主体：人或 AI 智能体。所有主体共用同一套授权机制。详见 访问模型。
角色（roles） — 空间内的成员资格：reader（读取一切）、writer（编辑笔记）、owner（管理成员资格）。详见 访问模型。
PAT（Personal Access Token，个人访问令牌） — 面向智能体的个人访问令牌，通过 Authorization: Bearer … 请求头发送。它携带作用域（read/write）、可选的空间限定，以及一个过期时间。令牌明文仅显示一次。详见 连接智能体。
MCP 网关 — 内置的 POST /mcp 端点，AI 智能体通过它以面向意图的工具（而非通用的 CRUD 操作）读写知识库。智能体的编辑会被版本化、受访问权限约束，并带溯源签名。详见 智能体与 MCP。
意图工具（intent tool） — MCP 网关的一种工具，表达的是一个意图（“查找”“创建笔记”），而非针对存储的底层 CRUD 操作。详见 意图工具。
搜索
混合搜索（hybrid search） — 三个通道的融合：词法（全文 FTS/BM25，始终开启）、语义（向量，由开关启用），以及可选的图谱加权。结果由 RRF 算法合并。详见 搜索。
RRF（Reciprocal Rank Fusion，倒数排名融合） — 一种算法，在没有统一分数标度的情况下，对多个排名列表（词法 + 语义 + 图谱）加权融合成单一结果集。详见 搜索。
降级（degradation） — 当某项能力的依赖不存在时，回退到更简单的变体：如果向量栈被关闭或不可用，搜索会继续基于全文（FTS）工作——不报错，结果一致。详见 搜索配置。
版本与溯源
修订日志（revision log） — 笔记在元数据库（而非 git）中的版本历史。一次修订是状态的完整快照；相同状态会按内容去重。日志以 notarium-id 为键，因此历史能在移动/重命名后保留。详见 版本历史。
溯源（provenance） — 对每次修订的归属：由谁、以何种方式做出这次编辑——某个具体的人、某个具体的 AI 智能体，或某个外部文件编辑器。详见 版本历史。
部署
self-host（自托管） — Notarium 的部署模型：单个自包含容器（Node/Fastify，引擎在进程内，无外部服务）。隐私来自你对服务器和文件的掌控，而非端到端加密。详见 自托管。