セッション管理

​

セッション運用を徹底する理由

​

セッションのスコーピング

• セッションはオーナーごとに分離されます。
• プレイヤーコマンドはプレイヤーの UUID をオーナーキーに使います。
• コンソールコマンドはコマンドソース名をオーナーキーに使います。
• 各オーナーにアクティブなセッションポインタが一つだけあります。
• すべてのセッションコマンドは OP 権限レベル 2 を要求します。

​

毎日のコマンドワークフロー

​

長い作業向けのコツ

1. 目的ごとにセッションを分け、1 つのセッションにすべてを詰め込まない。
2. 文脈をリネームしたいときは古い履歴を伸ばすより、新しいセッションを作って切り替える。
3. resume、remove、repair を使う前に /mineclawd sessions list を実行する。
4. リクエストがまだ実行中の状態でセッションを変更しない。
5. 破壊的な作業を始める前に /mineclawd history で文脈を確認する。

​

/mineclawd history を有効に使う

• 履歴ブックにはセッショントークン、更新時間、表示可能なチャットターンが出ます。
• このコマンドはプレイヤー専用で、コンソールからは使えません。
• 履歴ブック UI にはクライアント側の MineClawd が必要です。
• 非常に長い履歴は Minecraft 書物のページ制限でトリミングされます。

​

復旧手順

​

リクエストに失敗したが文脈は残したい

​

Vertex の function-call 不一致エラー

/mineclawd sessions repair

/mineclawd sessions repair <session>

​

セッションファイルの場所

mineclawd/
  sessions/
    <owner>/
      active.json
      <id>.json

• active.json がアクティブなセッション ID を保持します。
• <id>.json にメタデータと OpenAI/Vertex の両方の履歴が入ります。
• アクティブセッションを削除すると、MineClawd は直近で更新された残りを自動選択します。残りがなければアクティブポインタをクリアします。

​

バックアップと掃除の流れ

1. 大量削除前に mineclawd/sessions/ をバックアップします。
2. 古いセッションは /mineclawd sessions remove <session> で削除します。
3. 各オペレーターは既知の良好なセッションを 1 つ残しておくと即時リカバリできます。
4. ストレージの内部を見たいときは /resources/technical-details を参照します。

​

関連ページ

• GUI の使い方
• /commands/sessions-list
• /commands/sessions-resume
• /commands/sessions-repair
• /commands/history