バックアップ、エクスポート、インポート
Nowledge Memデータのポータブルなコピーを保持し、必要に応じて移動する
Nowledge Memはローカルファーストです。 データ転送は、その約束を実用的なものにする方法です。 ナレッジをエクスポートして自分で保管し、移動が必要なときに別のMemにインポートできます。
大きな変更の前のバックアップ、別のマシンへの一度きりの移行、後で確認できるオフラインコピーが必要なときに使用します。
エクスポートはポータブルです
Memのエクスポート自体は、不透明なバイナリデータベースのダンプではありません。
テキストベースのバンドルです。
JSONマニフェストファイル、メモリ、スレッド、ソース、エンティティ、スキル、グラフエッジのJSONLレコード、シークレットではないAIプロファイルとルール、そしてワーキングメモリ用のMarkdownが含まれます。
元のライブラリファイルや管理対象のスキルバンドルを含めることを選択した場合、それらのファイルは元の形式のまま保持されます。
.zipはパッケージングにすぎません。
データ転送を使用するタイミング
設定 -> データ転送 は、次のことをしたいときに使用します。
- 再インストールやアップグレードの前にナレッジをバックアップする
- あるコンピュータから別のコンピュータへ移動する
- デスクトップ、Linuxサーバー、ヘッドレスデプロイメントの間で移動する
- Memデータの人間が確認できるアーカイブを保持する
- 作成元のナレッジとともに再利用可能なスキルを保持する
- 以前のエクスポートを新しいMemインストールにインポートする
これはデバイス間の同期とは異なります。 同期は、常時稼働する1つのMemに多数のクライアントが接続することを意味します。 データ転送は、バックアップ、エクスポート、インポート、および一度きりの移行のためのものです。
また、オープンナレッジフォーマット (OKF)のエクスポートとも異なります。 データ転送はMemの完全で再インポート可能なバックアップであり、OKFエクスポートは、ナレッジを他のツールに渡すためのポータブルで読みやすいナレッジバンドルです。
データ転送と検索メンテナンス
ナレッジのコピーが必要なとき、または別の場所に移動したいときは データ転送 を使用します。
ローカルメンテナンスには 設定 -> メモリ処理 -> 検索 を使用します。
- 最適化 は、再構築可能な検索インデックスがディスク容量を使いすぎているときに圧縮します。
- インデックスを再構築 は、結果が古いか不完全に見えるときに、保存されたメモリ、ライブラリコンテンツ、メッセージストアから検索を再作成します。
どちらの操作もバックアップを作成しません。 また、エクスポート/インポートの代わりにもなりません。 大きなアップグレードの準備や別のマシンへの移動を行う場合は、まずエクスポートしてください。
アプリからのエクスポート
- 設定 を開きます。
- データ転送 に移動します。
- 含める内容を選択します。
- 単一ファイルが必要な場合は .zipとして圧縮 をオンにしたままにします。
- エクスポート をクリックします。
デスクトップでは、.zipファイルまたは展開されたフォルダーのいずれかをエクスポートできます。
Webまたはリモートクライアントモードでは、クライアントがサーバーのファイルシステムに直接書き込めないため、ブラウザーが.zipをダウンロードします。
エクスポートが成功すると、manifest.jsonファイルを含む.zipファイルまたはフォルダーが得られます。
そのファイルは、外部ドライブ、暗号化されたバックアップ、NAS、または通常のバックアップシステムなど、自分で管理する場所に保管してください。
別のMemへのインポート
- 移行先のMemで 設定 -> データ転送 を開きます。
- インポートモードを選択します。
- エクスポートした
.zipまたはフォルダーを選択します。 - インポートを開始し、完了するまで待ちます。
- タイムライン、ライブラリ、検索、ナレッジグラフを確認します。
インポートはバックグラウンドジョブとして実行されます。 Memはレコードを復元し、検索プロジェクションを再構築する必要があるため、大きなエクスポートには時間がかかることがあります。
インポートモード
エクスポートに、移行先にすでに存在するアイテムが含まれている場合にどうするかに基づいてモードを選択します。
| モード | 最適な用途 | 動作 |
|---|---|---|
| マージ | 通常の復元と移行 | 既存のレコードを保持し、可能な場合は不足している関連データを補完します。 |
| スキップ | アクティブなMemへのアーカイブのインポート | 同じアイテムがすでに存在する場合、移行先のレコードを変更しません。 |
| 上書き | テスト用または古い移行先の置き換え | 一致するレコードをエクスポートのコピーで置き換えます。エクスポートを優先すべき場合にのみ使用してください。 |
不明な場合は、マージ から始めてください。
エクスポートの内容
正確な内容は選択したオプションによって異なりますが、Memのエクスポートには次のものを含めることができます。
| パス | 目的 |
|---|---|
manifest.json | エクスポート形式、バージョン、件数、含まれるセクション。 |
nodes/*.jsonl | メモリ、スレッド、ソース、エンティティ、ラベル、コミュニティ、その他のグラフノード。 |
relationships/*.jsonl | それらのノード間のグラフ関係。 |
content_store/*.jsonl | 含まれる場合のスレッドメッセージとより大きなコンテンツペイロード。これはMemのメッセージストアのポータブルな形式です。 |
working_memory.md | Markdown形式の現在のワーキングメモリ。 |
working_memory_archive/ | 含まれる場合のアーカイブされたワーキングメモリスナップショット。 |
skills/ | SKILL.mdおよびバンドルされたファイルを含む、管理対象のスキルバンドル。 |
settings/*.json | シークレットではないAIプロファイルとルール。これにより、名前付きエージェントは移行後もそのアイデンティティと動作を維持します。 |
| 元のソースファイル | オプションのライブラリファイル。元の形式のまま保持されます。 |
この形式は、復元可能で検査可能であることを意図しています。 隠されたデスクトップ専用のデータベースファイルに縛られることはありません。
移動されないもの
データ転送はナレッジデータ用です。 アプリインストール全体の完全なクローンではありません。
新しいマシンに移動した後も、モデルプロバイダー、統合、リモートアクセス設定、ライセンス、またはOSレベルのアプリ設定を再接続する必要がある場合があります。 AIプロファイルとルールは含まれますが、APIキー、プロバイダー認証情報、ライセンストークンは含まれません。
検索インデックス、埋め込み、アクティブなスキルプロジェクションフォルダーはソースデータとして移動されません。 Memは、復元されたメモリ、メッセージ、ライブラリファイル、管理対象のスキルバンドルからそれらのプロジェクションを再構築します。
バックグラウンドタスクキュー、進行中のキャッチアップ計画、ローカルAI使用量台帳も移動されません。 インポート後、新しいMemは復元されたメモリからメンテナンスバックログを再計算します。 古いMemがまだキャッチアップ中だった場合は、新しいマシンでキャッチアップを再度開始してください。
セルフホストのDockerまたはLinuxサーバーの場合は、サーバーデプロイメントもお読みください。 サーバー運用者は、高速なボリュームレベルのスナップショットと、同じポータブルなMemデータ形式を使用するアプリケーションレベルのエクスポートのどちらかを選択できます。
同じフローを自動化する場合、APIリファレンスにはエクスポート、エクスポートのダウンロード、インポート、インポートのアップロードのエンドポイントが含まれています。
大規模なブラウザー/APIダウンロードの場合、Memは一時的なエクスポートファイルを、コンテナの小さな/tmp領域ではなく、アプリストレージボリュームにステージングします。
エクスポートワークスペースと最終的な.zipのために、Memのデータ/設定ボリュームに十分な空き容量を確保してください。
明示的に上書きを有効にしない限り、Memは既存のエクスポートファイルを上書きしません。
良いバックアップ習慣
- 大きなアップグレードやマシン移行の前にエクスポートします。
- Memを実行しているコンピュータの外に、少なくとも1つの最近のエクスポートを保管します。
- 単一のポータブルファイルが必要な場合は
.zipを使用します。 - ファイルを直接確認したい場合は、デスクトップでフォルダーエクスポートを使用します。
- 元のマシンを削除する前に、予備のMemへのインポートをテストします。
あなたのナレッジはあなたのものであるべきです。 データ転送は、それを実現し続けるための実用的な方法です。