---
title: "笔记类型"
description: "笔记的类别是一组可见性与索引策略，由系统根据笔记的存储位置推断并自动应用，而不是一个可以随手填写的字段。"
---

# 笔记类型

每条笔记都有一个**类别**——它决定这条笔记在哪里可见、以何种方式被索引。类别不是 frontmatter 里可以手动填写的自由标签：它是一组策略，由系统**根据存储位置推断并自动应用**。在 API 响应中，类别是只读的。

## 类别是一组策略

每个类别背后都是一组策略——逐项作出是/否的判定：笔记是否被索引，是否出现在知识图谱、文档流、目录树、面向用户的搜索中，是否可供智能体的 `recall` 使用，是否纳入版本管理，是否被复制。关键在于：可见性只在一处统一校验，而不是靠一个你得记着往每次查询里加的过滤条件。「在结果中隐藏」和「排除出索引」是两回事，Notarium 从不把二者混为一谈。

笔记的身份是它的 `notarium-id`，而不是路径。正因如此，移动或重命名它绝不会悄悄改变类别，也不会弄坏索引。

## 类别登记表

| 类别 | 状态 | 可见性 |
|---|---|---|
| `user-doc` | 活跃 | 处处可见：目录树、文档流、知识图谱、搜索。所有用户内容的默认类别。 |
| `agent-memory` | 活跃 | 被索引并可供智能体的 `recall` 使用，但对面向用户的界面隐藏；对所有者以独立区块可见。 |
| `attachment` | 承载策略 | 附件是完整的数据，但作为知识不被索引：只有 `.md` 文件可被搜索。 |
| `derived` | 承载策略 | 可再生成的产物（预览、渲染件）；不会进入索引。 |
| `profile` | 活跃 | 在你搜索和浏览笔记的所有地方都被隐藏；只能通过 Settings → Profile 以及智能体在 `start_session` 中访问。 |

## 你实际打交道的两个类别

在实践中，有两个类别持续活跃并不断被填充。

**`user-doc`**——你的笔记。默认类别：在目录树中自由组织，汇入搜索、知识图谱和文档流。无论是人（通过编辑器）还是智能体（通过 `create_note`），写入的正是这里。

**`agent-memory`**——智能体的记忆。这些是可读的笔记，而非隐藏的存储：智能体把观察追加到每类一个文件里，而不是滋生一堆微小文件。记忆存放在独立的服务目录 `.notarium/memory/` 中，因而不会与你的目录树混在一起，也不会与你的文件夹发生冲突。

> [!note] 记忆对你可见，但它属于智能体
> 你可以**读取、编辑和删除**记忆的内容——这正是你审计和把控哪些东西可能进入过上下文的方式（历史会显示谁写了什么）。但你不去**重新组织**它：其布局归智能体所有（一组扁平的类别加上一份派生索引）。移动在技术上是安全的——禁止重新组织是一项产品决策，为的是让记忆模型保持可预测。

记忆索引是派生的：它从每个 memory 文件的 `summary` 字段汇集而成，并通过完整重扫来重建。它在 `start_session` 中立即加载，而文件本身则通过 `recall` 按需拉取。详见[智能体记忆](/docs/agents/memory/)。

## `profile`——「关于你」

一个专用于个人档案笔记的类别：关于你的、由人撰写的内容（由你本人所写，而非智能体）。它在你搜索和浏览笔记的所有地方都被隐藏，只有两条途径可以抵达——通过 Settings → Profile，以及由 `start_session` 按标识符把它加载进智能体的上下文。这不是智能体的记忆，而是一张由你策展的上下文卡片。

类别根据存储位置推断，并由系统设定——智能体既不挑选文件夹，也不挑选类别。要了解这与隔离和寻址的关系，参见[空间与项目](/docs/concepts/spaces-and-projects/)。