# Memory Console ガイド

/me の個人用 Web コンソールを操作して、メモリの確認、検索、修正、エージェント帰属の確認、スペースの管理、レコードのエクスポート、設定の構成を行います。

- Canonical: https://docs.xmemo.dev/ja/docs/guides/memory-console
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 4aea951f5bf9f94fc8465b3b4089d9fe087baec4eab55f135bd33c84f878c7e8
- Edition-Digest: 84031f178449384da3cc74eff22482f423b919f247ee2fef6e726696e81e0c2d
- Source-Revision: sha256:ed359fa7ac7e89021568a98e14885eb4624796d3c8401d0c47d80a787520d3cf

## ユーザーの目標とコンソールの概要

Memory Console は、/me (/memory-console というエイリアスもあります) でメモリレコード、エージェント接続、プロジェクト、およびセキュリティ設定を確認、検索、管理するための視覚的な Web インターフェースを提供します。CLI コマンドや MCP ツールのみを介して操作する代わりに、開発者やチームメンバーはコンソールを使用して、エージェントが記録した内容の監査、不正確なメモリの修正、エージェント帰属の検査、API トークンの管理、データのエクスポートと削除の制御を行います。

## 利用資格と前提条件

Memory Console は、認証されたユーザー向けに最新のブラウザで利用できます。コンソールのレイアウトは、サイドバーナビゲーションおよび直接の URL ハッシュアンカーを介してアクセスできる個別のワークスペースセクションとアクセスセクションに機能を体系化しています:

- 認証要件: アクティブなユーザーセッションが必要です。未認証のアクセスは /login (サインインページ) にリダイレクトされます。
- 概要 (#overview): 個人メモリワークスペース、最近のアクティビティ、接続されたエージェント、およびストレージシグナルのクイックサマリー。
- メモリ (#memory): 全文検索、タイプフィルター、およびソースフィルターを使用したメモリレコードの検索、絞り込み、確認、および編集。
- Knowledge (#knowledge): 承認されたエージェントが参照できるナレッジドキュメントの表示と維持管理。
- プロジェクト (#projects): プロジェクトワークスペース、コンテキストノート、およびプロジェクト関連のメモリの閲覧。
- Cloud Skill (#skills): 手続き型クラウドスキルの作成、インポート、および管理。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
- Dream (#dream): 永続メモリになる前に、定期的なパターンと統合の提案を確認。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
- エージェント (#agents): このワークスペースに接続されているエージェントの表示、最後のアクティブタイムスタンプの確認、および権限の検査。
- チーム (#teams): チームの作成と管理、メンバーの招待、およびチームワークスペースロールの設定。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
- プロフィール (#profile): アカウントのID、メール確認ステータス、および個人の設定。
- セッション (#sessions): アクティブなサインインセッションと接続されたデバイスの確認。
- API キー (#api-keys): CLI、エージェント、および自動化のためのスコープ付きアクセストークンの発行、ローテーション、および失効。
- 設定 (#memory-settings): プライバシー態勢、セキュリティモード、データエクスポートリクエスト、およびメモリ削除コントロール。

## 一連の完全なタスク: 合成メモリの検査と修正

このウォークスルーでは、クイックスタートガイド中に保存された合成規約メモリを見つけ、そのエージェント帰属を検査し、コンソールでそのテキストを修正し、更新を確認して、個人ワークスペースの境界を確かめます。

## 1. メモリパネルで合成メモリを見つける

/me に移動し、サイドバーで Memories をクリックするか #memory に移動してメモリパネルを開きます。検索バーに "demo project timestamp format" と入力するか、Facts カテゴリで絞り込みます。一覧には、概要コンテンツ、作成時刻、および可視性バッジを示す一致するメモリカードが表示されます。

```bash
# Access personal workspace
https://xmemo.dev/me#memory

# Access team workspace with explicit team context
https://xmemo.dev/me?space=<team_id>#memory
```

## 2. エージェントの帰属とメタデータを検査する

メモリカードをクリックして Explain パネルを展開します。コンソールには、書き込み時に取得された来歴と帰属の詳細が表示されます:

- 書き込み者の種類とエージェントID: メモリがエージェント、人間のユーザー、またはインポートされたスクリプトのいずれによって書き込まれたかが、エージェント名およびIDとともに表示されます。
- エージェントインスタンスの表示: 同じエージェントの個別の実行を区別するために、明確なエージェントインスタンス識別子 (agent_instance_display) が表示されます。
- デバイスとトランスポート: デバイスラベル (device_label) と、書き込みが送信されたトランスポートチャネルが表示されます。
- 可視性とスコープ: レコードが個人用かチーム共有 (team_id) かが、プロジェクトおよびバケットの割り当てとともに示されます。
- バージョン履歴: 現在のリビジョン番号が表示され、バージョン系統ドロワーへのリンクが表示されます。

## 3. メモリコンテンツをインラインで修正する

メモリカードの Edit ボタンをクリックして、インラインエディタを開きます。改良されたプロジェクト規約を反映するようにコンテンツを更新し、Save をクリックします:

- 更新されたコンテンツ: "demo project timestamp format" を "Demo project timestamps use UTC with ISO 8601 formatting." に変更します。
- 保存アクション: コンソールは CSRF 保護付きの認証済み更新リクエストを発行し、リビジョンカウンターをインクリメントします。
- 競合保護: エージェントがメモリを同時に更新した場合、コンソールはリビジョンの不一致 (HTTP 409) を検出し、上書きする前に最新のコンテンツを確認するよう "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." と促します。

## 4. コンソールとエージェントのリコールで更新を確認する

保存後、コンソールに成功通知が表示され、メモリカードが更新されます。バージョン系統ドロワーには、以前のリビジョンが新しいリビジョンに置き換えられたことが示されます。接続されたエージェントが修正を即座に認識することを確認するには、ターミナルで recall を実行します:

```bash
node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1
```

## 観察可能な結果

コンソールでの修正が成功すると、Web UI およびエージェントインターフェース全体で観察可能な変化が生じます:

- Web コンソールトースト: 画面下部に確認トースト ("Memory updated") が表示されます。
- カードの表示: カードには、更新されたテキスト、更新されたタイムスタンプ、およびインクリメントされたリビジョンインデックスが即座に表示されます。
- 系統ドロワー: バージョン系統ドロワーには、以前のリビジョンと更新されたテキストを比較する単語レベルの差分が表示されます。
- エージェントリコール出力: "demo project timestamp format" に対するクエリは、最新のリビジョン参照とともに更新されたテキストを返します。

## エージェントがアクセスできる範囲

エージェントとコンソールユーザーは、別個の認証および権限境界のもとで動作します:

- コンソール権限: コンソールユーザーは、CSRF 検証を伴うブラウザクッキーを介してデータにアクセスします。コンソール内のアクションは、ログインしているユーザープロフィールを反映します。
- エージェント権限: エージェントは、API キーパネル (#api-keys) で発行されたスコープ付き API キーまたは OAuth トークンを使用して認証します。許可されるトークンスコープには、memory:read、memory:write、knowledge:read、ledger:read、ledger:write、および read:audit が含まれます。
- エージェントの可視性境界: エージェントはアカウントのパスワード、アクティブなブラウザセッション、または請求の詳細を表示できません。個人トークンを発行されたエージェントは、個人のメモリと公開されたナレッジのみをクエリできます。そのチームに明示的にバインドされていない限り、チームワークスペースを検査することはできません。

## 共有とストレージの境界

Memory Console は、個人データとチームワークスペースの厳格な分離を強制します:

- スペースの選択: スペースセレクターは、クエリパラメータ ?space=<team_id> (useSpaceContext によって管理) を介して個人メモリとチームワークスペースを切り替えます。パラメータを省略するか ?space=personal を設定すると、表示が個人メモリに限定されます。
- 設定の分離: 設定パネル (#memory-settings) は、テナント間の設定ドリフトを防ぐために、チームスペースの閲覧時には自動的に非表示になります。チームスペースにいる間に設定を開こうとすると、アクティブなスペースが Personal にリセットされます。
- データエクスポートの境界: 設定 (#memory-settings) から、ユーザーは機密を保護したエクスポートアーカイブ (/api/v1/me/export-requests) を要求できます。個人エクスポートには、個人メモリレコード、バージョン系統、個人元帳トランザクション、および個人ドキュメントが含まれます。チームメモリは個人エクスポートから厳格に除外されます。
- エクスポートダウンロード認証: 生成されたエクスポートアーカイブは、xmemo-personal-export.zip を取得する前に一時的なダウンロード認証トークンを取得するための sudo チャレンジが必要です。エクスポート成果物はいつでも取り消して削除できます。
- メモリ削除コントロール: ユーザーは確認の上で個々のメモリを削除したり、すべてのメモリを消去したり、アカウントのメールアドレスを確認して確認フレーズ "RESET MY XMEMO MEMORY" を入力してメモリをリセットしたりできます。セルフサービスによるアカウントの閉鎖では、削除前に所有するチームを移譲する必要があります (HTTP 409)。
- TODO エントリポイント: コンソールは、プロジェクト (#projects) のプロジェクトカード内に集計カウンターとして TODO を公開し、各ワークスペースに関連付けられた未完了のアクションアイテム数を表示します。
- 元帳エントリポイント: 元帳レコードはメモリ (#memory) の下で絞り込み可能なタイプカテゴリとして表示され、API キー (#api-keys) の下で API トークン (ledger:read、ledger:write) にスコープでき、個人データエクスポートアーカイブに含まれます。

## 障害復旧

次の手順を使用して、一般的なコンソールエラーとアクセス問題を解決します:

- 検索でメモリが見つからない: スペースセレクターが正しいスペース (Personal 対 Team ?space=<team_id>) に設定されているか確認してください。ツールバーのアクティブなフィルタードロップダウン (Type や Visibility など) をクリアして、検索結果を広げてください。
- 同時編集エラー (HTTP 409): 編集を開いている間にエージェントまたは別のタブがメモリを更新した場合、コンソールに "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." と表示されます。リストを更新し、新しいリビジョンを確認して、変更を再適用してください。
- サイドバーに設定オプションが表示されない: チームスペースを表示している場合、設定は非表示になります。サイドバーのスペースドロップダウンを開き、Personal ワークスペースに戻して、設定 (#memory-settings) へのアクセスを復元してください。
- エクスポートダウンロード認証の期限切れ: sudo ダウンロード認証トークンは短命です。ダウンロードプロンプトでアカウントの認証情報を再入力し、新しいダウンロード認証を生成してください。

## 関連リファレンス

基盤となるメカニズムおよび API コントラクトについては、関連する概念およびツールのドキュメントを参照してください:

- クイックスタート: 初期設定と合成メモリ作成については /docs/quickstart を参照してください。
- メモリ修正: リビジョン履歴と置換セマンティクスについては /docs/concepts/memory-correction を参照してください。
- メモリ削除: 論理削除とツームストーンのライフサイクルについては /docs/concepts/memory-deletion を参照してください。
- 来歴と帰属: エージェントインスタンスおよび書き込み者の種類の仕様については /docs/concepts/provenance-attribution を参照してください。
- プロジェクト: プロジェクトワークスペースの境界とコンテキストスコープについては /docs/concepts/projects を参照してください。
- チーム: チームワークスペースの作成、ロール、およびコラボレーションについては /docs/capabilities/teams を参照してください。
- ナレッジベース: ドキュメントベースと公開ルールについては /docs/concepts/knowledge-bases を参照してください。
- Cloud Skills: 手続き型クラウドスキルの作成については /docs/concepts/cloud-skills を参照してください。
- Dream リフレクション: パターン分析の概念については /docs/concepts/dream-reflection を参照してください。
- ガバナンスと保持: 保持ポリシーと DSAR コントロールについては /docs/concepts/governance-retention を参照してください。
- データ境界: 暗号化、マルチテナンシー、および分離については /docs/security/data-boundary を参照してください。
- TODO ツール: エージェントタスク追跡ツールのパラメータについては /docs/tools/todos を参照してください。
- 元帳ツール: 財務取引ツールのパラメータについては /docs/tools/ledger を参照してください。

## ChatGPT ユーザー

bearer token をチャットに貼り付けずに、ChatGPT が XMemo の設定、プロジェクト事実、意思決定、TODO に永続的にアクセスできるようにします。

ChatGPT/OpenAI app の OAuth フローで hosted XMemo MCP server に接続し、XMemo アカウントに memory:read と memory:write の許可を承認します。

合成の設定またはプロジェクトメモを保存し、新しいチャットを開始してから、作業を続ける前に ChatGPT に XMemo 経由でそれを呼び出させます。

OAuth が失敗する、またはツールが表示されない場合は、direct token を作成する前に、ホストアプリで MCP server からサインアウトし、XMemo server URL を再接続して再試行します。

## Copilot / Codex 開発者

リポジトリの判断、コーディング規約、バグ修正メモ、タスク履歴を IDE と CLI エージェント間で持ち運べます。

利用可能な場合は、VS Code / GitHub Copilot および Gemini CLI に OAuth を使用してください。Copilot CLI、Codex、Cursor、またはその他の直接 MCP クライアントの場合は、XMEMO_KEY をローカル環境またはシークレットストアに保持し、安定した XMEMO_AGENT_INSTANCE_ID を設定してください。

コードベースの判断またはバグ修正を記録し、次の IDE または CLI エージェントに、編集前に関連する XMemo コンテキストを呼び出させます。

呼び出し結果が空の場合は、選択した MCP 設定パス、direct client 用の XMEMO_KEY 環境変数、ホストアプリ内の古い OAuth 認証情報を確認します。

## チーム / エンタープライズ pilot owner

アカウント制御、ソース attribution、エクスポート/削除ワークフロー、レビュー担当者向けに安全な設定証跡で共有メモリを評価します。

保護された XMemo workspace を作成または開き、承認済みユーザーを招待してから、readiness badges に従って OAuth またはスコープ付き direct credential で各クライアントを接続します。

pilot メンバーに合成のチームメモリを保存してもらい、XMemo でソース attribution を確認し、削除/エクスポートとサポート経路をレビューします。

メンバーが接続できない場合は、新しい token を発行する前に、ロール権限、OAuth 承認、クライアント readiness 状態、サポートガイダンスを確認します。

## 自律エージェント operator

headless またはスケジュール済みエージェントが進捗を記録し、過去の判断を取得し、安定した非秘密のインスタンス ID を保持できるようにします。

/api/v1/mcp/config/autonomous-agent を取得します。runner が OAuth + custom headers をサポートする場合は auth_modes.oauth を優先し、完全 headless runner の場合のみ secret store の XMEMO_KEY で auth_modes.xmemo_key を使います。

XMemo に進捗を書き込む合成タスクを 1 つ実行し、runner を再起動して、同じ XMEMO_AGENT_INSTANCE_ID でその進捗を呼び出せることを確認します。

attribution が変わる、または呼び出し結果がインスタンス間で分かれる場合は、XMEMO_AGENT_INSTANCE_ID を git の外に永続化し、runner が起動ごとに再生成していないことを確認します。