Memory 記憶管理システム

本ドキュメントでは、Qwen Code の Managed Auto-Memory（マネージド自動記憶）における記憶管理の仕組み、トリガーのタイミング、および実装の詳細について説明します。

目次

1. 概要
2. ストレージ構造
3. 記憶タイプ
4. 記憶エントリ形式
5. コアライフサイクル
6. Extract — 抽出
7. Dream — 統合
8. Recall — 検索
9. Forget — 削除
10. インデックス再構築
11. テレメトリ

概要

Managed Auto-Memory は、AI セッション中にユーザー関連の知識を自動で蓄積・統合・検索する永続的な記憶システムです。以下の 4 つのコア操作を通じて、記憶のライフサイクルを管理します。

ストレージ構造

ディレクトリ構成

~/.qwen/                                      ← グローバルベースディレクトリ（デフォルト）
└── projects/
    └── <sanitized-git-root>/                 ← プロジェクト識別子（Git ルートパスに基づく）
        ├── meta.json                         ← メタデータ（抽出/統合のタイムスタンプ、ステータス）
        ├── extract-cursor.json               ← 抽出カーソル（処理済みの会話オフセット）
        ├── consolidation.lock                ← Dream プロセスの相互排他ロック
        └── memory/                           ← 記憶メインディレクトリ
            ├── MEMORY.md                     ← インデックスファイル（自動生成、全エントリの要約）
            ├── user.md                       ← ユーザー設定記憶（例）
            ├── feedback.md                   ← フィードバック規範記憶（例）
            ├── project/
            │   └── milestone.md              ← プロジェクト記憶（サブディレクトリ対応）
            └── reference/
                └── grafana.md                ← 外部リソース記憶

環境変数による上書き：

• QWEN_CODE_MEMORY_BASE_DIR：グローバルベースディレクトリを置き換える
• QWEN_CODE_MEMORY_LOCAL=1：プロジェクト内パス .qwen/memory/ を使用する

主要ファイルの説明

記憶タイプ

システムは 4 つの組み込み記憶タイプをサポートしており、それぞれ異なる情報次元に対応します。

記憶に保存すべきでない内容：コードパターン/規約、Git 履歴、デバッグ手順、一時的なタスクステータス、QWEN.md / AGENTS.md に既に記録されている内容。

記憶エントリ形式

各トピックファイルは YAML フロントマター + Markdown ボディ 形式を使用します。

---
name: 記憶名称
description: 一行説明（検索関連性の判断に使用するため、具体的であること）
type: user|feedback|project|reference
---
 
記憶の本体内容（summary 行）
 
Why: 背景にある理由（AI がエッジケースを理解し、盲目的にルールに従わないようにするため）
How to apply: 適用シナリオと使用方法

feedback および project タイプでは、エッジケースでも記憶が正しく適用されるよう、Why と How to apply の記入を強く推奨します。

コアライフサイクル

Extract — 抽出

トリガーのタイミング

AI が各ターンでレスポンスを完了した後、scheduleAutoMemoryExtract によって自動的にトリガーされます（バックグラウンドの非ブロッキング処理）。

スケジューリングロジック（extractScheduler.ts）

スキップ理由の説明：

コア抽出フロー（extract.ts）

抽出カーソル（Cursor）：

• フィールド：{ sessionId, processedOffset, updatedAt }
• 抽出完了後、processedOffset を現在の履歴長に更新する
• 次回抽出時は、offset >= processedOffset のメッセージのみを処理する
• セッション跨ぎ（sessionId が変更）の場合、オフセット 0 から再開する

パッチのフィルタリングルール：

• 要約の長さが 12 文字未満 → 破棄
• 要約が ? で終わる → 破棄（疑問文）
• 一時的なキーワード（today/now/currently/temporary など）を含む → 破棄
• 同一の topic:summary 組み合わせ → 重複排除

Dream — 統合

トリガーのタイミング

AI が各ターンでレスポンスを完了した後、scheduleManagedAutoMemoryDream によって自動的にトリガーされます（バックグラウンドの非ブロッキング処理）。ただし、複数のゲート条件によって保護されており、ほとんどの場合はスキップされます。

スケジューリングゲート（dreamScheduler.ts）

ゲートパラメータ：

ロックメカニズム：

• ロックファイルは <project-state-dir>/consolidation.lock に配置される
• 内容は保持プロセスの PID
• 確認時：PID プロセスが存在しない場合（kill(pid, 0) が失敗）またはロックが 1 時間を超えた場合 → 失効とみなし、自動的にクリアされる

統合実行フロー（dream.ts）

ルールベースの重複排除ロジック：

1. 各トピックファイル内：summary.toLowerCase() で重複排除し、why / howToApply フィールドをマージする
2. summary のアルファベット順に並べ替える
3. ファイル間：同一の type:summary を持つエントリは最初に見つかったファイルにマージし、重複ファイルを削除する

Recall — 検索

トリガーのタイミング

AI がユーザーリクエストを処理する各ターンの前に、resolveRelevantAutoMemoryPromptForQuery によって自動的にトリガーされ、関連する記憶がシステムプロンプトに注入されます。

検索フロー（recall.ts）

スコアリングルール（ヒューリスティック）：

各タイプの特性キーワード：

• user：user, preference, background, role, terse
• feedback：feedback, rule, avoid, style, summary
• project：project, goal, incident, deadline, release
• reference：reference, dashboard, ticket, docs, link

プロンプト構築ルール：

• 最大 5 ドキュメントを注入（MAX_RELEVANT_DOCS）
• 各ドキュメントのボディは 1200 文字で切り捨て（MAX_DOC_BODY_CHARS）
• 切り捨てが発生した場合は、"NOTE: Relevant memory truncated for prompt budget." を追記
• ドキュメントの新規性情報（ファイルの mtime に基づく）を含む

Forget — 削除

トリガーのタイミング

ユーザーが /forget <query> コマンドを手動で実行することでトリガーされます。

削除フロー（forget.ts）

エントリ ID の設計：

• 単一エントリファイル（一般的なケース）：relativePath（例：feedback/no-summary.md）
• 複数エントリファイル：relativePath:index（例：feedback/style.md:2）
• 安定した ID を使用することで、モデルが同ファイル内の他のエントリに影響を与えずにエントリを正確に特定できるようにする

インデックス再構築

MEMORY.md は全トピックファイルのナビゲーションインデックスであり、Extract または Dream 実行後に rebuildManagedAutoMemoryIndex を呼び出して再構築されます。

- [ユーザー設定](user/preferences.md) — ユーザーはシニア Go エンジニア、React は初接触
- [フィードバック規範](feedback/style.md) — 回答は簡潔に、末尾のまとめは不要
- [プロジェクトマイルストーン](project/milestone.md) — モバイル公開前のブランチ切り替え用マージフリーズウィンドウ

インデックスの制限：

• 1 行あたり最大 150 文字（超過分は … で切り捨て）
• 最大 200 行
• 総サイズは 25,000 バイト以内

テレメトリ

システムには、記憶操作のパフォーマンスと効果を監視するための 3 種類のテレメトリイベントが組み込まれています。

Extract テレメトリ

Dream テレメトリ

Recall テレメトリ

関連ソースファイルインデックス