Notarium文档

开源

一个知识库,让 AI 带着上下文开工

你的智能体、Markdown 和编辑器,都在一个容器里。

一条命令跑起来

引擎就跑在进程内:不用外部数据库,不用消息队列,也不用单独的搜索服务。

shell
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

等上几秒,然后打开 http://localhost:3000。

一个 /data 数据卷装下全部状态:你的笔记、元数据库和各类索引。

一个浑然一体的产品,而不是插件拼出来的。

Markdown 即事实来源

笔记就是普通的 .md 文件。索引、图谱和版本历史都由它们派生:离开 Notarium,这些文件照样是完整的笔记,导入导出都不丢东西。

Web 编辑器,不是阅读器

装得下几万篇笔记的目录树、基于 CodeMirror 的编辑器、维基链接、知识图谱。每天的正经活儿都能在浏览器里干完,换什么设备都一样。

人与智能体共用一个知识库

内置 MCP 端点:智能体写进你的知识库,走的是和你同一条路径、受同一套访问权限约束。空间和项目圈出作用域——智能体接手的是它该管的那个项目,而不是整个库。

自托管,只要一个容器

一个容器,省掉一整套服务的堆叠。认证、空间和搜索都在里面;朝外露出来的只有一个端口。

搜索在内核,不在付费墙后

全文搜索始终可用,语义搜索按需开启,两路结果由 RRF 融合。既不是高级版特权,也不是另收的一份订阅。

版本历史与溯源

每一次改动都写进这篇笔记的修订日志,并署上作者:哪些是人改的、哪些是智能体改的,一目了然。任意版本都能和当前版本对比,也能还原回去。

智能体不必从零开始

一个装满 Markdown 文件的文件夹,给智能体的只是文本。知识库给的是结构——链接、图谱、搜索:它按需取到该用的上下文,而不是把所有东西一股脑倒进上下文窗口。

检索,而不是整屏文本

全文搜索与语义搜索覆盖整个知识库——进入上下文窗口的是该进的那部分,而不是全部。

链接,而不是平铺列表

维基链接和图谱把知识的结构一并交给智能体:站在任何一篇笔记上,都看得见它和什么相连。

意图工具

职责收窄、面向意图的工具,而不是裸的 CRUD。网关是一条信任边界,不是图省事的包装层。

把进入上下文的路径写进智能体的规则文件,它上手最快:会话一开始就落在项目上,而不是先摸索一圈。

CLAUDE.md · AGENTS.md · .cursor/rules
## Notarium- 会话开始时先调用: start_session(project: "acme/website")- 读取项目约定: get_note("nHk2VqA0es")- 写入之前,先搜一遍相关笔记: search("<主题>", project: "acme/website")

第一次调用会带回什么

  • 你的个人档案,以及为这个项目固定的笔记
  • 项目索引,以及已经在用的分类词表
  • 上次来过之后有哪些改动
智能体规则 →

边界摆在明处

这里说的是两件不同的事:Notarium 想清楚了不做的,和眼下确实还没做的。

定了,就不会变

不做端到端加密

搜索、语义、历史和智能体都得读得到你的正文。这里的隐私靠的是文件归你、机器也归你,而不是靠 E2EE。如果你要的是零知识存储,Notarium 不是那个选择。

不是块编辑器

数据的单位是一篇文件笔记,而不是别人数据库里的一个块。这是可移植性的代价,我们是想清楚了才付的。

眼下还没有

这些是发展方向,不是欠账——都是刻意留到后面的部分:

  • 实时协同编辑
  • 插件与扩展
  • 完整的所见即所得(WYSIWYG)编辑器
  • 桌面端与移动端应用
  • 离线状态下处理数据
  • 笔记级访问权限
  • 跨空间的图谱
  • 外部存储适配器

现在是 0.1.0,公开测试版。

许可协议

AGPL-3.0。所有功能都开放且免费——包括在公司里当作内部工具使用。只有把 Notarium 本身当作产品去变现的人,才需要另外的商业许可。

查看完整许可条款 →

在自己的机器上跑起来

一条命令就能在本地把知识库拉起来。接下来:接上你的智能体,把笔记搬进来。