Notarium文档
文档版本: latest

笔记类型

每条笔记都有一个类别——它决定这条笔记在哪里可见、以何种方式被索引。类别不是 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/ 中,因而不会与你的目录树混在一起,也不会与你的文件夹发生冲突。

记忆对你可见,但它属于智能体

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

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

profile——「关于你」

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

类别根据存储位置推断,并由系统设定——智能体既不挑选文件夹,也不挑选类别。要了解这与隔离和寻址的关系,参见空间与项目