Notariumドキュメント
ドキュメントのバージョン: latest
日

用語集

Notarium の主要な用語の簡潔な定義集です。各用語は、それが詳しく解説されているページにリンクしています。

ストレージとアイデンティティ

file-first — 真実の源はディスク上の Markdown ファイルそのものである、という原則。検索インデックス、リンクグラフ、そのほか派生するものはすべてファイルから再構築できます。いつでもフォルダを持ち出して立ち去ることができます。詳しくは File-first を参照。

スペース (space) — 独自のインデックス、グラフ、検索、ツリー、リビジョンログ、メンバー名簿を持つ、隔離されたナレッジベース。すべてのユーザーは削除できない個人スペースを持ちます(エージェント向けのページでは個人ドメインと呼ばれます)。詳しくは スペースとプロジェクト を参照。

プロジェクト (project) — 軽量でオプショナルなエンティティ。スペース内で安定したアイデンティティを持つ、マークされたフォルダです(マークはフォルダ直下の dot ファイル)。エージェントは space/slug というハンドルでこれを指定します。詳しくは スペースとプロジェクト を参照。

notarium-id — frontmatter に記録される、12 文字の安定したノート識別子。ファイルの移動やリネームを経ても変わらないため、リンクや履歴が途切れることはありません。詳しくは バージョン履歴 を参照。

ノートクラス (note class) — ノートの保存場所から導かれる、可視性とインデックスに関するポリシーの集合(自由入力のフィールドではありません)。user-doc(ユーザーノート、どこからでも見える)、agent-memory(エージェントメモリ、インデックスされ recall から到達できるが、ユーザー向けの画面からは隠される)、加えて内部用の attachment・derived・profile があります。詳しくは ノートの種類 を参照。

アクセスとエージェント

プリンシパル (principal) — 一般化されたアクセス主体。人間または AI エージェントを指します。すべてに対して単一の付与の仕組みが使われます。詳しくは アクセスモデル を参照。

ロール (role) — スペースにおけるメンバーシップ。reader(すべてを読む)、writer(ノートを編集する)、owner(メンバーシップを管理する)。詳しくは アクセスモデル を参照。

PAT (Personal Access Token) — エージェント向けの個人アクセストークン。Authorization: Bearer … ヘッダーで送信されます。スコープ(read/write)、任意のスペース単位のスコープ指定、有効期限を持ちます。シークレットは一度だけ表示されます。詳しくは エージェントを接続する を参照。

MCPゲートウェイ (MCP gateway) — 組み込みの POST /mcp エンドポイント。AI エージェントはこれを通じて、(汎用的な CRUD 操作ではなく)インテント指向のツールでナレッジベースを読み書きします。エージェントの編集はバージョン管理され、アクセス権で制限され、来歴とともに署名されます。詳しくは エージェントと MCP を参照。

インテントツール (intent tool) — ストレージに対する低レベルの CRUD 操作ではなく、意図(「探す」「ノートを作る」)を表現する MCPゲートウェイのツール。詳しくは インテントツール を参照。

検索

ハイブリッド検索 (hybrid search) — 3 つのチャネルを融合したもの。全文検索(字句検索。FTS/BM25、常時有効)、セマンティック検索(ベクトル、フラグで有効化)、そして任意のグラフブースト。結果は RRF アルゴリズムで統合されます。詳しくは 検索 を参照。

RRF (Reciprocal Rank Fusion) — 順位付けされた複数のリスト(字句 + セマンティック + グラフ)を、共通のスコア尺度なしに重み付けして単一の結果セットへと融合するアルゴリズム。詳しくは 検索 を参照。

デグラデーション (degradation) — 依存関係が揃っていないときに、機能がより単純な形態へフォールバックすること。ベクトルスタックがオフまたは利用できない場合でも、検索は全文(FTS)上で動き続けます — エラーなく、同じ結果を返します。詳しくは 検索のセットアップ を参照。

バージョンと来歴

リビジョンログ (revision log) — メタデータデータベース(git ではありません)に記録されるノートのバージョン履歴。リビジョンは状態の完全なスナップショットで、同一の状態は内容によって重複排除されます。ログは notarium-id をキーとするため、移動やリネームを経ても履歴は残ります。詳しくは バージョン履歴 を参照。

来歴 (provenance) — 各リビジョンの帰属情報。誰がどのように編集したか — 特定の人間、特定の AI エージェント、あるいは外部のファイルエディタ。詳しくは バージョン履歴 を参照。

デプロイ

セルフホスト (self-host) — Notarium のデプロイモデル。単一の自己完結したコンテナ(Node/Fastify、エンジンはプロセス内、外部サービスなし)です。プライバシーは、エンドツーエンド暗号化ではなく、サーバーとファイルを自分で所有することから生まれます。詳しくは セルフホスト を参照。

関連項目