メインコンテンツまでスキップ

長期メモリ

長期メモリは、ノートから抽出した「好み・方針・事実・約束・パターン・エピソード」を レビューして承認し、生成処理の文脈として再利用する仕組みです。 新しいメモリは必ず候補として作られ、人間のレビューを経てから使われます。

候補を抽出する​

直近の完了した月〜日曜の週から候補を抽出します。

uv run -m obsidian_ai_hub --memory-extract
uv run -m obsidian_ai_hub --memory-extract --week 2026-07-13
  • 7 日分のデイリーノートと日次構造化レコードを対象にします。各ノートは ## AIによる要約 までを使い、活動ログは別途渡しません。
  • AIエージェント の Webチャット会話 も対象にします(Task Agent・ワークフローのセッションは対象外)。
    • 候補になるのは ユーザー自身の発話 だけです。エージェントの返答は文脈としてのみ渡され、根拠の検証で候補から除外されます。
    • この機能の導入前に作成されたセッションは対象外です(新規セッションから抽出します)。
    • 会話本文は抽出LLMプロバイダへ送信されます。扱いが気になる会話は送らないでください。
    • 週ごとの投入量は memory.agent_conversation で制限できます(設定)。
  • カテゴリ: preference / decision_policy / fact / commitment / pattern / episode。
  • 各候補は根拠・抽出信頼度・重複や置換の候補を持ちます。信頼度は承認推奨ではなく、根拠を確認してください。
  • pattern は 2 日以上異なる日の根拠を要求します。

インタビュー質問を生成する​

週のデイリーノートからパーソナライズされた質問を生成し、LINE または Web UI で回答を集めて候補化します。

uv run -m obsidian_ai_hub --memory-interview
uv run -m obsidian_ai_hub --memory-interview --memory-interview-week 2026-07-13

CLI でレビューする​

候補 ID を指定して承認・却下します。

uv run -m obsidian_ai_hub --memory-review --id mem_20260713_51609b --approve
uv run -m obsidian_ai_hub --memory-review --id mem_20260713_3907c3 --reject

内容を修正して承認する場合:

uv run -m obsidian_ai_hub --memory-review --id mem_20260713_f2ec1b \
--edit --content "Prefer concise Japanese responses."

完全に削除する場合(確認プロンプトあり、--yes で省略):

uv run -m obsidian_ai_hub --memory-delete --id mem_20260713_f2ec1b
uv run -m obsidian_ai_hub --memory-delete --id mem_20260713_f2ec1b --yes

Web UI でレビューする​

メモリ 画面(/memories)では次ができます。

  • ステータス(候補 / 承認済み / 却下済み / 期限切れ / 置換済み)・本文・種別・人物・トピックで絞り込む。
  • 候補のレビュー分類 (review_state):
    • ready (通常候補): 競合・重複提案がないクリーンな候補。即時承認・一括承認・却下が可能です。
    • merge_proposed (マージ提案): 既存記憶への統合が提案されています。「マージ」または「新規として保存」で解決します。
    • supersede_proposed (置換提案): 既存記憶の更新・終了が提案されています。「後継として保存」または「新規として保存」で解決します。
    • reassessment_required (再判定待ち): 対象記憶の変更・削除・指紋未保存により再判定が必要です。オンデマンド再判定ボタンや定期保守で最新化されます。
    • assessment_failed (自動判定失敗): LLM 重複判定に失敗した候補。手動で確認・再判定・レビューします。
  • 操作対象の制限:
    • 即時承認および一括承認は ready 状態の候補のみが対象です。マージ・置換提案や再判定待ちの候補、および承認済み・失効済みメモリの一括承認はスキップされます。
    • 一括却下は未処理候補のみが対象です。
  • 個別の 承認 / 却下、詳細パネルでの 編集して承認 / 削除。
  • 詳細パネルで根拠、重複・置換提案、各操作(新規保存・マージ・後継保存など)の効果解説、来歴を確認する。
  • 同一メモリ向け候補の自動統合: 週次抽出、インタビュー回答、エージェントからの候補作成(memory_propose)の実行直後に、同じ承認済み記憶を指す未処理候補が2件以上存在する場合、自動的に LLM が1件の最終統合候補(マージ・置換・新規判定)へと再構成します。元候補はシステム自動却下(consolidated 監査イベント付き)となり、詳細パネルで「統合候補(元候補 N件)」および統合元ID・全根拠を確認できます。
  • 候補のオンデマンド再判定 (reassess):
    • 提案中・再判定待ち・自動判定失敗の候補に対して、Web UI の「再判定実行」ボタン(または POST /api/v1/memories/{id}/reassess)からオンデマンドで LLM 再判定を実行できます。
    • 再判定は提案内容と対象記憶の指紋(fingerprint)を更新するのみで、自動マージや自動承認は行われません。
    • 保存直前に対象記憶の更新状態を検証し、処理中の競合が検知された場合は不一致理由を記録して再判定待ちを維持します。
  • 失効記憶の再有効化・再承認 (renew):
    • 期限切れ・鮮度低下で失効した記憶(status: expired)は、Web UI の「再有効化・再承認」フォーム(または POST /api/v1/memories/{id}/renew)からのみ復帰可能です。通常の編集や一括承認では復帰しません。
    • 失効理由(有効期限切れ valid_until / 定期確認期限切れ review_due_at / 根拠情報鮮度低下 evidence_stale)が区別して表示されます。
    • 再有効化には将来の review_due_at(定期確認予定日)の設定が必須です。根拠が古い場合でも再確認日を設定することで直後の再失効を防ぎ、valid_until は絶対期限として評価されます。
  • プロファイル生成 で Copilot プロファイル(Vault 内の 7 ファイル)を生成・上書きする。
一括削除は取り消せません

一括削除 と詳細の 削除 は完全削除で、取り消せません。

生成処理での利用​

承認済みメモリは、用途ごとの方針に従って小さな参照セクションとして生成プロンプトへ付加されます。 --memory-compile --for <purpose> で、実際に使われる文脈を確認できます。

uv run -m obsidian_ai_hub --memory-compile --for make-target

組み込みの用途:

--for使う種類
make-targetすべて。evidence 形式、ユーザースコープのみ
plannerすべて。evidence 形式、ユーザースコープのみ
review-draft好みと意思決定方針。Fenced 形式

日次・週次・月次の構造化要約には長期記憶を注入しません。対象期間の入力データだけを根拠に生成します。 config/config.yml に残っている memory.purposes.summarize-day / summarize-week / summarize-month の設定は要約生成では参照されないため、削除できます。

--for に未知の値を渡すと、既定(すべて・memory.context_max_tokens・evidence 形式・ユーザースコープのみ)にフォールバックします。 方針は config/config.yml の memory.purposes で上書きできます(全項目の例は 設定 を参照)。

AIエージェントへの注入​

AIエージェント(memory_search / memory_propose を使うもの)には、現在のユーザー発話(子エージェントでは委譲タスク)に意味的に近い承認済みメモリだけが自動注入されます。無関係な記憶は注入されません。

  • 明示的に「常に注入する」としたメモリ(injection_mode: always)が400 token枠へ先に入り、残り枠に類似度 0.45 以上の上位最大5件が入ります(類似度→信頼度→安定性→作成日時順)。件数上限は always には適用されず、枠超過分は優先順で省かれます。
  • always は承認済み・ユーザースコープのメモリにだけ設定できます。メモリ画面の編集フォームで切り替えます。
  • 検索索引が未構築・モデル変更後・障害時は語句検索へフォールバックします。
uv run -m obsidian_ai_hub --rebuild-retrieval-index

初回と埋め込みモデル変更後は上記で索引を再構築してください。通常の会話・検索で自動バックフィルは行いません。

メンテナンス​

承認済みメモリを診断し、キー・本文・ベクトル類似でグルーピングして、LLM がマージ・修正・失効のアクションを提案します。 提案は HITL の Run として登録され、確認待ち 画面でレビューします。

uv run -m obsidian_ai_hub --memory-maintain
  • 定期競合再判定: 実行開始時に「再判定待ち」の候補および旧形式の重複・置換候補を検出し、最新の承認済み記憶と照合して提案と指紋情報(fingerprint)を自動更新します。
  • 照合の結果、重複対象が存在しなくなった候補は新規候補(New)に戻り、再び通常の承認レビューが可能になります。
  • LLM 応答失敗時は「再判定待ち」を維持し、次回の実行時に再試行します。
  • 再判定は提案の更新のみであり、対象メモリのマージや置換が自動適用されることはありません(最終的な適用は常にユーザーが行います)。

Copilot プロファイルを生成する​

現在有効な承認済みメモリから、Copilot 用のプロファイル指示ファイルを生成または完全上書きします。

uv run -m obsidian_ai_hub --render-copilot-profile

上書きされるファイル(Vault 配下):

  • copilot/AI_README.md
  • copilot/core/values.md
  • copilot/core/response_style.md
  • copilot/core/decision_policy.md
  • copilot/core/risk_tolerance.md
  • copilot/core/memory_rules.md
  • copilot/core/current_projects.md
手書き内容は失われます

生成はこれら 7 ファイルを完全に上書きします。手書きの内容がある場合は退避してください。 承認済みメモリが無い場合でも、全 7 ファイルがフォールバック文言「現時点で承認済みメモリなし」で生成されます。

設定​

memory:
context_max_tokens: 800
agent_context_max_tokens: 400
agent_retrieval_threshold: 0.45 # エージェント注入・memory_search の類似度しきい値
agent_retrieval_top_k: 5 # クエリ関連で注入する最大件数
extractor:
provider: ollama
model: glm-4.7:cloud
# prompt_path: /Users/you/Documents/custom-memory-extract.md
renderer:
provider: openai
model: gpt-4o
prompt_path: /Users/you/Documents/custom-memory-render.md
retrieval:
chroma_path: /Users/you/.config/obsidian-ai-hub/retrieval/chroma
collection_name: retrieval_documents

extractor を省略すると、日次目標の LLM プロバイダ・モデルが使われます。 renderer は provider / model を省略すると extractor の設定を継承し、prompt_path は 既定で config/prompts/memory_render.md になります。

次に読む​