はじめにとインターフェース

はじめに

blunderDB はバックギャモンのポジションのデータベースを構築するためのソフトウェアです。その主な強みは、プレイヤーが遭遇したポジション（オンラインやトーナメントで）を一か所に集約し、自由に組み合わせ可能なさまざまなフィルターで絞り込みながら再検討できる点にあります。blunderDB は参照用ポジションのカタログを作成するためにも利用できます。

ポジションは .db ファイルで表されるデータベースに保存されます。デスクトップアプリケーションはこのファイルを直接開き、ネットワークアドレスを開くことは決してありません。サーバーモードは同じバイナリの別のモードであり、一方から他方へ移るにはデータベースをエクスポートするか移行するのであって、アプリケーションを URL に向けるのではありません。

主な操作

blunderDB で可能な主な操作は次のとおりです：

  • 新しいポジションを追加する、

  • 既存のポジションを編集する、

  • CTRL-X でボードの画像をクリップボードにコピーする（PNG）、または CTRL-X CTRL-X で完全な分析と共にコピーする、

  • 既存のポジションを削除する、

  • 1 つまたは複数のポジションを検索する、

  • さまざまなソース（XG、GNUbg、BGBlitz、Jellyfish、HedgeHog）からマッチをインポートする。XG ファイルからのコメントも含む、

  • インポートしたマッチの手を辿る、

  • ポジションをコレクションに整理する、

  • マッチをトーナメントに整理する。

ユーザーはタグを使ってポジションに自由にラベルを付け、コメントで注釈を加えることができます。

インターフェースの説明

blunderDB のインターフェースは上から下に次の要素で構成されています：

  • ［上部］ツールバー。データベースに対して実行できる主な操作がすべてまとめられています、

  • ［中央］メイン表示エリア。バックギャモンのポジションを表示または編集できます、

  • ［下部］ステータスバー。データベースや現在のポジションに関するさまざまな情報を表示し、コマンドラインを内蔵しています。

次の目的でパネルを表示できます：

  • eXtreme Gammon（XG）、GNUbg、または BGBlitz から取得した、現在のポジションに関連する分析データを表示する、

  • コメントを表示、追加、または編集する、

  • 組み合わせ可能な条件に従ってポジションを検索・フィルターする、

  • ポジションのコレクションを表示・管理する（コレクションパネル）、

  • インポートしたマッチの一覧を表示し、マッチの手を辿る（マッチパネル）、

  • トーナメントを表示・管理する（トーナメントパネル）、

  • パフォーマンス統計を表示する（Stats パネル）、

  • ベアオフポジションの EPC（Effective Pip Count）を計算する（Eval パネル）、

  • 計算問題でトレーニングする（Training パネル）、

  • 間隔反復によってポジションを学習する（Anki パネル）、

  • マッチを手で記譜する（Transcription パネル）、

  • データベースのメタデータを表示する（メタデータパネル）。

パネルの高さはハンドルをドラッグして調整します。高さはどのタブでも同じです。

次の目的でモーダルウィンドウを表示できます：

  • blunderDB のヘルプを表示する。検索欄（/ でカーソルが移動）は、大文字小文字やアクセントを区別せずに、入力したテキストの出現箇所を選択します（ENTER で次へ、SHIFT-ENTER で前へ）、

  • ガイドツアーのカタログを表示します（ ガイドツアーとサンプルデータベース を参照）、

  • データベースのエクスポートを設定する、

  • blunderDB を設定する。特にインターフェースの言語を設定する（設定 を参照）。

メイン表示エリアはユーザーに次のものを提供します：

  • バックギャモンのポジションを表示または編集するためのボード、

  • キューブのレベルと所有者、

  • 各プレイヤーのピップカウント、

  • 各プレイヤーのスコア、

  • 出目です。ダイスに値が表示されていない場合、ダイスの位置はどちらのプレイヤーに手番があるかを示し、そのポジションがキューブの判断であることを表します。キューブの判断がダブルへの応答（テイク／パス）である場合、提示されたキューブが盤面の中央に、提示された値で表示されます。

盤上で右クリックすると、コンテキストメニューが開きます。表示中の局面を Eval パネルで評価する、その鏡像を評価する、盤の画像を解析付きでクリップボードにコピーする（CTRL-X CTRL-X と同じですが見つけにくい）、画像をファイルに保存する（SVG または PNG）、この局面の新しいビューを開く、そして——局面がすでにデータベース由来なら——Anki デッキ（間隔反復）に追加する、または近い局面を並べ替える（検索パネルを参照）、が並びます。盤上で手を進めている間（クイズ、トランスクリプト）は、盤上で右クリックすると局面には触れずに手全体をやり直します。メニューが開くのは最初の一歩の前だけです。編集と Eval では、盤上の右クリックが駒を置くため、メニューは盤の外（ダイス、キューブ、スコアの外）での右クリックで開き、局面を消去（BACKSPACEと同じ）と初期配置（新しいゲームの駒を配置）だけが並びます。

クリップボードは日常の動作で、保存はもうひとつの必要——記事や掲示板の投稿、レッスンの図版です。SVGを用意したのは、盤がもともと SVG だからです。拡大に耐える形式であり、文書に入れてもぼやけません。PNG はそこから作られ、クリップボードへのコピーも同じです。描画はひとつ、行き先は三つ。したがってどれも互いに食い違いません。このメニューは Eval パネルと検索パネルには出ません。そこでは右ボタンがすでに相手色の駒を置く操作だからです。局面を Eval パネルに持ち込む方法は ポジションを Eval パネルに持ち込む を参照してください。

ステータスバーは左から右に次の情報で構成されています：

  • コマンドライン。スペース キーを押すとアクセスできます、

  • ユーザーが実行した操作に関連する情報メッセージ、

  • 現在の局面の番号と、現在のライブラリの局面数（マッチを辿っているときは着手・ゲームの情報）、

  • ライブラリ・カウンター——「局面 412 · ブランダー 38 · マッチ 5」——各数字はそれが数えているものを開きます。局面、ライブラリの閾値での E> の検索（入力したときと同じように即座に実行され、検索履歴に残ります）、あるいはマッチ一覧です。画面のリストがライブラリ全体でない場合（検索、コレクション、マッチ）、ブランダーの数は「12 / 340 ブランダー」と表示されます。そのリストのブランダー、続いて同じ閾値でのライブラリのブランダーです。20,000 局面を超えるリストは数えられず、合計のみが残ります。辿れない数字は飾りです。ブランダーの閾値はライブラリのものであり、設定のライブラリタブで調整され、統計と共有されます。閾値が二つあれば、同じ語が二つのことを意味してしまいます。カウンターはリンクが開くものをそのとおりに約束します。それは複数の指し方で指された局面についても同じで、その局面は最も大きい損失の値をとります。非常に大きなライブラリ（20 万行超）では、カウンターはテーブルを走査しません。「≈」が付いた数は推定値（削除された行が欠番を残すため上限値）です。 局面が推定値の場合、正直な推定のないブランダーの数は直近の正確な集計で、それを変えうる書き込みがない限り保たれます。インポートや変更の後は、バックグラウンドで集計し直すあいだ「?」と表示され、終わると自動的に戻ります。読み取り専用で開いたライブラリは集計し直さず、書き込み中のインスタンスが集計し直すまで「?」のままです。リンクは検索を実行し、正確な数を返します。 2 つのブランダー数は別々のリンクです。前者は表示中のリストで部分検索 ss E> を、後者はライブラリ全体の検索を実行します。合計だけが表示されるときは、リンクは 1 つです。

注釈

ユーザーによる検索から得られたポジションの場合、ステータスバーに表示されるポジション数はフィルターされたポジションの数に対応します。

Anki タブは、全デッキを通じて復習待ちのカードがあるとき バッジ を表示します。この数字はタブを開く理由であり、タブの向こう側にあってはなりません。ゼロのときは何も出ません。「0」と書かれたバッジは雑音です。

log コマンドは 動作ログ を開きます。ログファイルの末尾二百行、それをコピーするボタン——報告に添えるのに必要なもの——、そしてログの入ったフォルダを開くボタンです。ログは絞り込みも整形もされません。整えたログはもう引用できません。

grid コマンドは コンタクトシート を開きます。閲覧中のリスト（検索結果、ライブラリ、コレクション）を、盤面と同じ描画のミニ盤面のグリッドとして、24局面ずつのページで表示します。現在の局面のページで開き、そのサムネイルは枠で囲まれます。サムネイルをクリックするか ENTER を押すと、その局面が盤面に開き、シートが閉じます。キーボードだけで操作できます ( コンタクトシート を参照)。編集モードやマッチの中では開きません。マッチは手順で閲覧します。

検索パネルの 検索履歴 では、保存されたコマンドの各トークンが裸のトークンではなく、名前付きのチップとして表示されます（接触なし、着手の誤り など）。正確なコマンドはツールチップに残ります。再実行されるのはそれだからです。blunderDB が認識しないトークンは、近いものに置き換えず そのまま 表示されます。

ビュータブ

ツールバーの下にあるタブバーを使うと、複数のビューを並行して扱えます。各ビューは独立したワークスペースであり、独自のポジションリスト、現在のポジションのインデックス、表示中のポジション、解析と選択中の手、アクティブなパネル、編集中のコメント、そしてマッチ内のナビゲーション状態を保持します。これにより、例えば、あるビューで検索を開いたまま、別のビューでマッチを閲覧するといったことが可能になります。

  • ビューを作成する：タブバーの + ボタン（ビューが一つしかない間は + 新規ビュー という名前）をクリックするか、CTRL-T を押します。新しいビューは現在のビューのコピーとして始まります。

  • ビューを閉じる：タブの×印をクリックするか、CTRL-Wを押します。最後のビューは閉じることができません。

  • ビューの切り替え：タブをクリックする、CTRL-PageUp/ CTRL-PageDown（または SHIFT-J/ SHIFT-K）を押して前 / 次のビューへ移る、あるいは CTRL-1～CTRL-9でアクティブなライブラリの n 番目のビューへ直接移動します。

  • ビューの名前を変更する：タブをダブルクリックし、新しい名前を入力してENTREEで確定します。

Eval パネルに残したビューは、残したときのまま戻ります。下書きの盤面も、パネルを出たときに戻る研究中のポジションもそのままです。Eval パネルの最後の下書き盤面もビューごとに保たれます。

ビューはデータベースのセッション状態とともに保存され、再オープン時に復元されます。

複数のライブラリを開く

複数のデータベースを同時に開いたままにできます。それぞれがタブのグループを構成します。バーでは、色付きの見出しにファイル名が表示され、そのライブラリのビューが続き、その上端には同じ色が使われます。同時にアクティブになるライブラリは 1 つだけで、パネル、検索、インポート、アシスタントが読み書きするのはこのライブラリです。

開いているライブラリが 1 つだけのとき、バーには見出しが表示されません。データベースの名前を示すのはウィンドウのタイトルだけです。

  • ライブラリを新しいグループで開く：タブバー右側の ⧉ 別のライブラリボタン（2 つのグループが開いている場合は ⧉のみ）、CTRL-SHIFT-O、またはコマンド open_group（og）。それまでアクティブだったライブラリは、そのグループで開いたままです。一方、CTRL-Oはアクティブなグループのライブラリを置き換えます。ツールバーの 開くボタンのツールチップに両方のショートカットが示されます。

  • ライブラリの切り替え：別のグループのタブをクリックすると、そのライブラリとそのビューが一度に有効になります。グループの見出しをクリックすると、最後に残したビューに戻ります。CTRL-SHIFT-PageUp/ CTRL-SHIFT-PageDownは前 / 次のライブラリへ移ります。CTRL-PageUp/ CTRL-PageDown（または SHIFT-J/ SHIFT-K）はすべてのグループのビューを順に巡ります。

  • グループを閉じる：見出しの × でライブラリとそのビューを閉じます。アクティブなグループを閉じると、隣のグループが表示されます。ステータスバーには、閉じたライブラリと表示されたライブラリの名前が示されます。

アクティブなグループの見出しは、その色の上に白で名前を表示します。ほかのグループの見出しは、バーの背景に名前を表示し、上端にそれぞれの色の下線が付きます。色は 6 色が順に使われ、7 番目のグループは最初の色に戻ります。ビューはライブラリごとに番号が付けられます。新しいグループで開いたデータベースは「#1」から始まり、CTRL-1… CTRL-9はアクティブなグループのビューを指します。タブがウィンドウの幅に収まらなくなると、バーは縮めずにスクロールします（マウスホイール、または表示中のタブを画面内に移すビューの切り替え）。

切り替えは即座に行われます。各グループは、ビュー、ポジション一覧、現在のポジション、検索条件（入力中で検索を実行していなくても）、マッチ一覧、カウンター、パネルの各一覧のスクロール位置をメモリに保持し、データベースを読み直さずに復元します。新しいグループで開いたライブラリは、空の検索フォームから始まります。あるグループで選んだマッチやトーナメントが別のグループに適用されることはありません。進行中の作業も一緒に移ります。文字起こしの下書き、レッスン、Anki の復習、学習キュー、開いている Direction は、離れたときのまま戻ります。不在の間に変わった可能性のあるものは、表示直後に読み直されます。カウンターは常に、マッチ一覧は件数が変わった場合、または不在の間にバックグラウンドタスクがライブラリへ書き込んだ場合です。各データベース固有の一覧（コレクション、トーナメント、Anki デッキ、下書き、デュエル、検索履歴、保存済みフィルター）は、表示されたライブラリで読み直されます。

同じファイルを2つのグループで開くことはできません。開き直すと、すでにそのファイルを保持しているグループが表示されます。

バックグラウンドタスクは自分のライブラリに結び付いたままです。マッチファイルのインポート、監視フォルダ、GammonNet のバッチ解析は、別のグループを表示しても開始したグループで続行され、表示中のライブラリには一切書き込みません。進捗とレポートはそのグループに残ります。グループが表示されていない間は、その見出しにバッジが付き、タスクが動作中は点滅し、完了すると点灯したままになります。グループに戻るとバッジは消え、ステータスバーにタスクの実行内容が表示され、マッチ一覧が読み直されます。インポートに続く自動解析は、インポート先のライブラリで開始されます。監視フォルダは開始したグループに属します。マッチファイルはそこでバックグラウンドでインポートされ、統合するデータベースやポジションテキストは、そのグループが再び表示されるまで待機します。グループを閉じると、そのタスクと監視が停止します。

ライブラリ間のコピー。 別のグループの見出しへドラッグした行は、どちらの向きでもそこへコピーされます。マッチ一覧のマッチ、コレクション一覧のコレクション、開いているコレクションのポジション、表示中のポジション（ステータスバーの「n / N」カウンターでつかみます）、または読んでいるレッスン（レッスンバーのその名前で）です。対象の見出しは点線で囲まれます。コピーは transfer コマンドと同じです。エクスポートの選択をネイティブインポートで統合し、解析、コメント、指した手も含みます。コレクションはそのポジションを、マッチはその書き起こしを伴います。受け取る側のライブラリがすでに持っているものは再びコピーされません。A から B へ、次に B から A へコピーしても重複は生じず、コピー元を示すものも何も残りません。コピーは受け取る側のグループに結び付いたバックグラウンドで実行されます。その見出しにはバッジが付き、戻るとステータスバーが新しいポジションとマッチの数、すでにあった数を伝えます。

バスケット は複数のライブラリの行を集め、一度に移します。 SHIFT-B は表示中のポジションを入れたり出したりします。Pile に対する b と同じです。バスケットへドラッグした行も入ります。タブバーの右端のバスケットはその数を表示し、クリックでメニュー（各グループへの … へ移す、 バスケットを空にする）が開き、グループの見出しへドラッグするとそこへ移します。バスケットはメモリ上にあり、データベースには決して保存されません。グループを閉じるとその行は取り除かれ、blunderDB を閉じると消えます。まだ下書きのポジションは先に保存する必要があります。

見出しの 南京錠 はそのグループをロックします。ドラッグでもバスケットからでも、もう何も移されず、ステータスバーがそう伝えます。ロックはインポートにもグループ内での変更にも影響しません。もう一度クリックすると解除されます。

表示中のものに連動して動作しているものがある場合、グループの切り替えは、クリックでもキーボードでも拒否され続け、原因と停止する場所を示すメッセージがステータスバーに表示されます。対象は、結果がボード上のポジションに表示されるロールアウト（rollout stop）、表示中のライブラリをクラブのネットワークで提供するトーナメント表示（Direction で停止します）、ボードとそのビューを占有している実行中のデュエル、タイマーとログがどのグループにも属さないトレーニングセッション、そして、実行している間に限り、インターフェースでしか読めないファイル（ポジションテキスト、1件ずつインポート）のインポートやデータベースの統合です。blunderDB を終了するとき、保存されるのはアクティブなライブラリのセッションだけで、グループの一覧は保存されません。次回の起動時には、最後にアクティブだったデータベースが開き直されます。

他のライブラリが知っていること: 「他のライブラリ」タブ

他のライブラリタブ(CTRL-SHIFT-A)は、表示中のポジションについて、グループで開かれている他のライブラリが何を知っているかを示します。ポジションは番号ではなく盤面の同一性(ハッシュ)で見つけられます。同じ番号でも、二つのデータベースでは異なるポジションを指すためです。各ライブラリには、そのグループの色で縁取られた専用のブロックがあります。

  • 解析:最善手または最善のキューブアクションと、それを見つけたエンジン。アクティブなライブラリとは異なるマッチ・エクイティ・テーブルで評価された解析には、他の MET と表示されます。

  • コメント:それぞれ作者、または署名者と署名の状態が、コメントパネルと同様に表示されます。

  • そのポジションがプレイされたマッチ:プレイヤー、大会、日付、手番号、プレイされた手または判断とそのコスト。判定(良い、エラー、ブランダー)は、他方ではなくアクティブなライブラリのしきい値で下されます。別の MET で計算されたコストは比較されず、他の MET と表示されたままになります。50 マッチを超える場合は、最後にインポートされた 50 件が一覧表示され、総数が示されます。

  • 近傍のポジション:最も近い 5 件が、距離とともにサムネイルで表示されます。

ポジションを含まないライブラリはその旨を示し、それでも近傍のポジションを表示します。向こうで開く、マッチまたはサムネイルのクリックで、そのライブラリのグループが有効になり、そこでポジションが表示されます。どのデータベースにも何も書き込まれません。⟳ ボタンは他のライブラリを再読み込みします。

その場での入れ替え。 x キーは、盤面の代わりに、同じ場所に同じ大きさで、他のライブラリのポジションを表示します。その名前、最善手、コメント数を示す、そのライブラリの色の帯が付きます。キーを押し続けた場合は、離すと盤面に戻ります。短く押した場合は、次に押すまで入れ替えたままになります。ポジションやウィンドウを変えても盤面に戻ります。アクティブなグループ、ビュー、リストは変わりません。表示されるポジションは、既定では、それを含む最初の他のライブラリにある同じポジションです。「他のライブラリ」タブのサムネイルの下にあるピン留めボタンは、代わりにその近傍ポジションを選び、ピン留め解除かグループの変更までそのままになります。

分割画面　大きな画面では、タブバーの ◫ ボタン（CTRL-SHIFT-X）でウィンドウを同じ幅の二つのペインに分けます。一方はアクティブなグループをそのまま、もう一方は開いている別のライブラリ（一つしか開いていなければ同じライブラリ）の閲覧専用ビューアで、その盤、局面の解析、コメントを表示します。ビューアはライブラリ全体、手ごとに再生するマッチ（ゲーム、手、指された内容が盤の上に表示されます）、またはコレクションを、ドロップダウンで選び、⏮ ◀ ▶ ⏭ ボタンでたどります。そのライブラリを離れた場所から開きます。表示内容はどこにも書き込まれません。ボタン以外の場所でビューアをクリックすると、そのライブラリがアクティブになり、二つのペインは役割を入れ替え、各ライブラリは自分の側に留まります。キーボードではCTRL-SHIFT-PAGE UP/PAGE DOWNで同じことができます。幅が 1280 ピクセル未満では分割画面は使えず、代わりにその場での切り替え（x）を提案します。ウィンドウが狭くなりすぎると閉じます。

設定

ツールバーのヘルプボタンの左にある設定ボタン（歯車のアイコン）が、blunderDB の設定ウィンドウを開きます。設定は十のタブに分かれています。

  • インターフェース — テーマ、言語、表示倍率、パネルの位置、PageUp / PageDown の移動幅（10、50、100、500、1 000 ポジション、またはリストの 10 %）、ログ、更新の確認、あなたの名前と近傍ポジション。

  • ボードの色 — ボードの配色。

  • ライブラリ — 開いているデータベースに属するもの。エラーとブランダーの閾値で、以下で説明します。

  • メンテナンス — データベースの健全性。操作ごとに一行で、以下で説明します。

  • コーパス— インポート時の重複、プレイヤーとイベントの別名、重複の可能性の検索（マッチのインポートを参照）。

  • Bearoff — Eval パネルが使うベアオフテーブル。

  • gammonNet— 内蔵の評価エンジンの設定。以下で説明します；

  • 監視フォルダ——フォルダに届いたマッチを自動で取り込む仕組み。下で説明します。

  • アシスタントと MCP — ローカル MCP サーバーと内蔵アシスタント。以下で説明します。

  • 発行者の識別情報 — 出所の記載に署名する鍵。データベースの配布：出所とパスワードの節で説明します。

インターフェースタブの先頭にはテーマがあります。システムに従う、ライト、ダーク、ハイコントラスト、印刷向けです。テーマは画面の配色を決め、盤のパレットも提案します。暗い画面に明るい盤ではダークテーマの半分にしかなりません。盤がウィンドウの大半を占めるからです。

最終的に決めるのはあなたであり、そのことは約束ではなく仕組みで保証されています。色タブは引き続き盤を直接設定でき、テーマのあとに選んだ色はあなたのものです。起動時に適用されるのは画面のトークンだけで、盤のパレットは決して上書きされません。あなたが設定したパレットはすでに読み込まれており、起動のたびに書き直せば、あなたの作業が一セッションずつ消えていくからです。ADR-0038 を参照してください。

既定はシステムに従うです。デスクトップのライト／ダークの設定に従い、セッションの途中で変わっても追随します。すでに決めているデスクトップに、道具が自分のライトやダークを押しつけることはありません。

インターフェースタブでは言語も選べます。英語、フランス語、ドイツ語、イタリア語、スペイン語、フィンランド語、日本語、ギリシャ語、ロシア語です。ツールバー、パネル、メッセージ、ヘルプを含む画面全体が選んだ言語に翻訳されます。言語の選択は保存され、次のセッションにも引き継がれます。

ライブラリタブは、マシンではなく開いているファイルに属するものをまとめます。データベースが一つも開かれていないあいだは空で、そのことを明示します。

このタブはまず、アプリケーション全体の語彙を決める二つの閾値を備えています。決定はその損失がエラー閾値に達した時点でエラーとなり、そのエラーはブランダー閾値に達した時点でブランダーとなります。すべてのブランダーはエラーですから、前者の閾値が後者を超えることはできず、blunderDB は逆転した組を拒みます。値はエクイティで入力し——「0.080」——これはすべての表の単位です。一方、コマンドラインはミリポイントで語るため、0.080 の閾値は検索では E>80 と書きます。

これらの閾値はコンピューターではなくファイルに従います。同じデータベースは、どこで開いても同じ数のブランダーを数え、blunderdb info がそれらを表示し、blunderdb edit --error-threshold / --blunder-threshold がそれらを設定します。閾値はエクスポートには持ち出されません。閾値は読み方の習慣であって、局面についての事実ではないからです。

三つのプリセットがワンクリックで用意されており、それぞれこの線を引いたプログラムの名前を冠しています。blunderDB（0.050 / 0.100）、XG（0.020 / 0.080）、gnubg（0.040 / 0.080）です。既定では、ライブラリは 0.050 と 0.100 を読みます。

画面上で変わるのは、ステータスバーのカウンターのブランダー数とそのリンクが用意する検索、統計とプレイヤー表の「エラー」列と「ブランダー」列、マッチの詳細画面での手の印 (マッチパネル)、そしてインポート後に blunderDB が見直しを勧める局面の一覧です。

メンテナンスタブの回収可能な容量の行には圧縮ボタンがあり、削除（マッチ、トーナメント、パージ）で空いたディスク容量を回収します。データを削除してもデータベースは自然には小さくならないので、この圧縮は明示的に要求する必要があります。大きなデータベースでは、この操作に時間がかかることがあります。圧縮されたコピーはファイルの隣に書き込まれ、その後でファイルを置き換えます。一時的に、そのボリューム上にデータベースと同程度の空きディスク容量が必要で、必要なのはメモリではありません。別のプログラムがデータベースを開いている場合（たとえば読み取り専用の二つ目のインスタンス）、ファイルは置き換えられません。データベースはその場で圧縮され、そのために空き容量がデータベースの約二倍必要になり、一時ファイルはシステムの一時フォルダ、または環境変数 SQLITE_TMPDIR が指すフォルダに置かれます。/tmp が小さい場合は、この変数をデータベースのあるボリュームに向けてください。blunderDB は、圧縮が中断される危険を冒す代わりに、足りないもの（ディスク容量、または利用可能なメモリが 512 MB 未満）を伝えるメッセージとともに開始を拒否します。操作を開始する前に確認が求められます。結果（得られた容量、単位はメガバイト）はその後ステータスバーに表示されます。同じ操作はコマンドラインから blunderdb vacuum で利用できます（コマンドラインインターフェース（CLI） を参照）。

その場での圧縮の後、blunderDB はファイルが実際に小さくなったかを確認します。Windows では、別のプログラムが特定の方法で開いているファイルをシステムが縮小できません。その場合、圧縮は実際には得られなかった削減量を表示するのではなく、その旨を伝えるメッセージで終了します。もう一方のプログラムを閉じてから、もう一度実行してください。

インターフェース タブにある ログフォルダを開く ボタンは、アプリケーションのログが入っているフォルダを開きます。不具合の報告に詳細を添えるときに便利で、とりわけ blunderDB をショートカットやダブルクリックから起動し、何かを表示する端末が付いていない場合に役立ちます。

同じタブにある、既定でオフの 起動時に更新を確認 チェックボックスは、起動ごとに一度だけ GitHub リポジトリのリリースページを問い合わせ、より新しいバージョンがあればステータスバーにメッセージを表示します。操作を妨げるウィンドウは決して出ません。パッケージマネージャ（Flatpak、Homebrew、ディストリビューションのパッケージなど）経由でインストールした場合、この確認は自動的に無効のままです。その場合は更新を扱うのはそのチャネルであり、blunderDB 自身ではありません。

インターフェース タブの二つの設定が、近傍ポジション の並べ替えを決めます（like トークン、検索パネル を参照）。返す近傍の数と、それを超えるとポジションが近傍でなくなる最大距離です。この距離は既定でゼロ、すなわち上限なしです。尺度はゲームの段階によって変わり、ここで選んだ値は測定値のように読まれてしまうからです。like<12 トークンは、設定に触れることなく、一度の検索にかぎって独自の上限を課します。

ボードの色タブでは、ボードの色を自由に設定できます。背景、枠、明るいポイントと暗いポイント、プレイヤー 1 とプレイヤー 2 のチェッカー、ダイス、ダイスの目、キューブのそれぞれに色の選択欄があります。リセットボタンですべての色が既定値に戻ります。言語と同じく、選んだ色もセッションをまたいで保持されます。

Bearoffタブは Eval パネルのベアオフテーブルを扱います（Eval パネル を参照）。テーブルは実行ファイルに埋め込まれてもいなければ、ダウンロードされるものでもありません。blunderDB はそれを使う機械の上で計算し、結果は gnubg が生成するものとバイト単位で同一です。テーブルを受け入れる前に SHA-256 の指紋が検証されます。

通常の二つのテーブル（キューブ判断用の TS-06-06、EPC 用の OS-06）は初回起動時に、背後で、何も尋ねずに計算されます。1 コアで約 6 秒、その間アプリケーションは普通に使えます。Eval パネルがそれに触れるのは、まだ用意できていないテーブルを必要とするポジションを置いたときだけです。

このタブは、有効な領域とその出どころ、EPC が読む片面表の状態、それらが置かれるフォルダー、そして存在する表の一覧を大きさと判定つきで示します。各行は確認のうえ個別に削除できます。

検証済みか未検証か。 検証済み の表は、その領域について gnubg が出すバイト列そのものです。SHA-256 の指紋が blunderDB に登録されており、それが再現されました。片面の表（OS-06 から OS-10）について登録されている指紋は、GNUbg 1.08 の makebearoff ツールが生成するものです。未検証 の表は形こそ正しいものの、その領域の指紋が登録されていません — 落ち度があるわけではなく、参照と比べた人がいないだけです。破損 した表は自分自身と矛盾しており、決して読まれません。再計算されます。

より広い表を計算する。 領域は二つの系統からなる一覧から選び、割り当てるコア数も選びます（既定は 1 つを除く全部。計算機が使えるままであるように）。

  • 厳密なキューブ（両面）、TS-06-06 から TS-06-15 まで。勝率とキューブ判定が推定ではなく読み取りになる範囲を広げます。

  • 内奥の外の EPC（片面）、OS-06 から OS-10 まで。EPC の欄が黙らずに済む駒の距離を広げます。この走査は計算中の局面より小さい局面しか読まないので構造上逐次的であり、コア数は役に立ちません — 選択欄が灰色になってそう告げます。

何かを始める前に、タブは選んだ領域について 3 つの数を示します。ディスク上の大きさ、計算中に必要なメモリ、そして この計算機で かかるはずの時間です。最後のものは推定値から始まり、実測値になります。十分に広い計算はそれぞれ自らの速度を測り、保持するからです。使えるメモリが許さない領域は、理由とともに灰色で提示されます — 「24 GB 必要だが 12 GB しか残っていない」は答えですが、行が無いことは答えになりません。

目安として、16 スレッドの計算機では、TS-06-09 は 191 MB で 10 秒ほど、TS-06-11 は 1.2 GB で数分、TS-06-13 はたいていの計算機がメモリに保持できる量を超えます。片面の側は 1 コアで、OS-07 が 4.9 MB で 17 秒、OS-08 が 15 MB で 1 分 20 秒、OS-10 が 117 MB で 30 分です。

一時停止と再開。 計算中、進捗は 実測の 残り時間と、2 つの別々のボタン — 一時停止 と 中止 — を示します。一時停止は計算の状態を表の隣に書き出し、再び動かすと最初からではなく止まったところから続きます。中止は何も残しません。設定ウィンドウを閉じても何も中断されません — 計算は背後で続きます。

一時停止した計算は次回の起動時に、名前と数字つきで（「TS-06-09 は 43 % で中断」）、再開 と 削除 とともに現れます。ひとりでに再開することはありません。停止を求めたのは利用者だからです。

このタブでは最後に、外部の両面 .bd ファイル — 例えば gnubg 自身が作ったデータベース — を指定できます。領域がもっとも広い表が優先されます。

メンテナンスタブはデータベースの健全性を示します。操作ごとに1行で、その件数、最後の実行（日付と結果：完了、キャンセル、失敗）、そのアクションを表示します。統計のないマッチの計算だけが、開いたときに自動で始まります。

  • 解析のないポジション — 解析を一つも持たないポジション。アクションは、後述の gammonNet 解析です。gammonNet が評価を拒否するポジション（ダンス、マッチ表の範囲外のスコア）はこの件数に残るため、件数が必ずしもゼロになるとは限りません。

  • 古い gammonNet 解析 — 後述します。

  • 統計のないマッチ— 統計がまだ計算されていないマッチです。アクションはそれらをすべて計算します。書き込み可能で開いたデータベースにそれがあると、バックグラウンドでバッチごとに自動で計算します。ステータスバーにこの行の進捗とキャンセルボタンが表示され、トーナメントのバッジと統計パネルのプレイヤータブは計算の終了を待ち、アプリケーションの他の部分はそのまま使えます。別のデータベースを開くと停止します。読み取り専用またはコマンドラインでは、統計の最初の読み込みがそれらを計算し、大きなデータベースでは時間がかかることがあります。そのとき統計パネルにこの件数が表示され、このタブを開きます。

  • 解析列 — 検索と統計が参照する列は、保存された解析からの射影で、保存された解析自体は手つかずのままです。アクションは何も再インポートせずに、それらを再計算します。

  • 指し手のエラー — まだエラーのない指し手を採点します。

  • 旧形式の解析 — 以前のバージョンが JSON で保存していた解析を、バイナリ形式に書き直します。

  • ゴミ箱 — ゴミ箱のエントリ数で、クリックするとゴミ箱が開きます。

  • 回収可能な容量 — ファイルの空き容量で、前述の圧縮によってディスクに戻されます。

負荷の大きい件数（テーブル全体を読み込みます）は、数えるボタンを待ちます。ポジションの件数をクリックすると、それらのポジションがリストに開きます。統計のないマッチの件数をクリックすると、それらのマッチがマッチパネルに開きます。操作はバックグラウンドで実行され、進行状況とキャンセルボタンがステータスバーに表示されます。データベースに書き込む操作は同時に一つしか実行されません。gammonNet 解析、ロールアウト、または別のメンテナンス操作が実行中だと次の操作は拒否され、データベースを占有している操作の名前が示されます。読み取り専用で開いたデータベースでは、アクションは無効になります。同じ操作はコマンドライン（blunderdb maintenance）にもあります。

gammonNetタブは内蔵の評価エンジンを設定します（ADR-0011 を参照）。ここでは2つの探索深さを設定でき、それぞれ名前を持ち別々に保存されます——一方を下げても他方は決して変わりません：

  • 表示深度——ボード編集時の対話的な快適さのための設定；データベースには決して書き込まれません。

  • 解析深度——インポート後の分析バッチがポジションの「分析」として書き込む深さです。

どちらもデフォルトは2-plyで、これが標準の構成です。表示のメニューでは 3-ply と 4-ply の深さに ⚠ が付き、1 ポジションあたりのコストは 2-ply を大きく上回ります。このタブではさらに枝刈り（デフォルト k=12）と表示する候補手の数（デフォルト 10）、そしてインポート後に自動解析するチェックボックスを設定できます。このチェックボックスを有効にすると、各インポートの後に解析を一つも持たないポジション（gammonNet も XG も GNUbg も BGBlitz もない——ルールは「評価は穴を埋めるだけ」であり、決して置き換えではありません）が残っていないかを確認し、あればバックグラウンドで、設定された解析深度の gammonNet 解析を起動します。メンテナンスタブの解析のないポジションの行は、同じ追いつき解析を手動で再実行します。この機能の追加前に作られたライブラリに便利です。

テイクまたはパスは、ダブルの前の、ダブルを提示する側の判断について gammonNet が評価します。以前のバージョンの blunderDB がこのような応答に書き込んだ gammonNet の判定は、受け手のリダブルを評価していました。その判定は、ライブラリを開くとき、またはそれを持つデータベースをインポートするときに削除されます。テイクまたはパスは再び解析のないポジションとなり、メンテナンスタブの解析のないポジションの行（またはインポート後の自動解析）が再評価するまで、統計には含まれません。

メンテナンスタブの古い gammonNet 解析の行は、その逆のケースを扱います。すでに gammonNet で解析されているが、保存された解析が実行中のものより古いエンジンバージョンで、または上で設定した解析深度とは異なる深度で書かれたポジションは、そこで古いものとして示され、再評価されます。XG、GNUbg、BGBlitz の解析も持つポジションは、gammonNet の内容にかかわらず、この一括処理では決して変更されません。ADR-0013の保護は無条件のままです。古いポジションの件数はデータベース内のすべての gammonNet 解析を読むため、数えるボタンを待ちます。一括処理は、開始時に独自のリストを再計算します。

両方のロットは範囲が定まり、可視で、キャンセル可能であり、決して静かなデーモンではありません：その深さ、進捗（分析済みポジション / 総数、起動時は 0 から）とキャンセルボタンが、実行中ずっとステータスバーに表示され、完了すると消えて、結果を要約するメッセージに置き換わります——何件のポジションが解析され、何件が拒否され（gammonNet が評価を拒否するポジション、たとえばそのマッチ・イクイティ・テーブルの範囲を超えたスコアなど、これは決して故障ではありません）、何件が失敗したか（次回の実行で変更されずに再試行されます）。どちらかの実行中にアプリケーションを閉じても何も失われません：解析されたポジションはその都度書き込まれ、次の実行は解析が止まった正確にその場所から再開します——ジャーナルを持つ必要は一切ありません。キャンセルでも終了でも、計算中のポジションも中断され、その分析は残りません。

ライブラリに書き込む処理は一度に一つだけです：gammonNet の一括解析、保存するロールアウト、メンテナンス処理。メンテナンスタブから始めた一括解析や処理は、別の処理が実行中なら拒否され、ステータスバーがその処理を示します。インポート、書き起こし、デュエルが始める一括解析は逆にその終了を待ち、開始するまでステータスバーに「待機中」と表示されます。

同じタブには、解析パネルから開始するロールアウトの設定があり(ロールアウト を参照)、セッションをまたいで保持されます。高速(216 ゲーム、7 ハーフムーブで打ち切り)、標準(1296 ゲーム、11 ハーフムーブで打ち切り)、または自由です。自由では、打ち切り、最小・最大ゲーム数(36 の倍数)、JSD の上限、深さ(ply)、候補数、シード、プロセス数のすべてを編集できます。

データベースのマッチエクイティテーブル。 タブの下部にあるリストデータベースのマッチエクイティテーブル（MET）で、gammonNet がマッチスコアの評価に使うテーブルを選びます。既定は内蔵の Kazaross-XG2 で、GNUbg の .xml ファイルから読み込んだテーブルをボタン.xml の MET を読み込む…で選ぶこともできます。この選択はアプリケーションではなくデータベースに属します。別のデータベースを開くと、そのデータベースのテーブルに戻ります。読み込まれるのは明示的なテーブルのみです（パラメトリックな zadeh や mec テーブルは対象外）。読み込んだテーブルの長さを超える範囲では、内蔵テーブルが引き継ぎます。テーブルは名前ではなく値で識別されます。GNUbg の Kazaross-XG2.xml を読み込んでも何も追加されません。それは内蔵テーブルだからです。gammonNet が計算した各解析は、計算に使ったテーブルを記録します。読み込まれた解析（XG、GNUbg、BGBlitz）は Kazaross-XG2 で計算されたものとみなされます。現在のテーブルと異なるテーブルで計算されたマッチスコアの解析は、解析パネルで異なる METと表示され、統計（エラー平均、PR、ランキング、直接対決）から除外されます。マネーゲームの解析が除外されることはありません。テーブルを変更しても解析は書き換えられず、比較が対象とするものだけが変わります。

パネルのライブ評価とキューブマトリクスは、データベースが保存する解析と同じく、データベースのテーブルで評価されます。テーブルはそれを参照する解析とともに移動します。データベースのエクスポートはテーブルを含め、データベースのインポートは受け取り側のデータベースにテーブルを追加します。重複はせず（既にあるテーブルは値で識別されます）、現在のテーブルにもしません。別のエンジン（XG、GNUbg）の解析で置き換えられた gammonNet の解析は、再び Kazaross-XG2 で計算されたものとみなされます。

解析なしで取り込んだマッチにも PR が付くようになりました。オンラインで指したマッチや、XG を通していない Jellyfish の .mat ファイルがこれに当たります。blunderDB は局面と指された手を知っていましたが、それがどれだけの価値かを語る解析がありませんでした。バッチが走ると、実際に指された手が gammonNet の順位づけと比較され、その差が PR、エラー率、最悪の判断、そのほかすべての指標に、XG が解析したマッチとまったく同じように反映されます。この比較は何も作り出しません。指された手はマッチの手のテーブル、すなわち取り込み時に書かれたものから来ます。ファイルが解析を持っていたかどうかは関係ありません。

本バージョンより前に解析したデータベースを評価し直す必要はありません。blunderdb repair が既存の解析と手から列を計算し直し、それらのマッチに PR を取り戻します（repair を参照）。

正直な留保をひとつ。局面はその構造で識別されるため、二度現れた局面は——一方はうまく、他方はまずく指されていても——最初に記録された出現の差だけを持ちます。これはこの計算に固有のことではありません。XG のライブラリもまったく同じ形をしています。

監視フォルダ

監視フォルダタブは、blunderDB が動作中にフォルダを見張り、そこに現れたマッチファイルを取り込むよう指示します。eXtreme Gammon でセッションを打ち、blunderDB に戻ると、マッチがすでにそこにあります。

推測はしません。フォルダを指定するまで監視は行われず、blunderDB があなたのマッチの置き場所を推測してディレクトリを読み始めることはありません。候補を出すボタンはこのマシンのよくある場所を探し、実際に存在する場合にのみ候補を示します。見つからなければそう伝え、フォルダの指定はあなたに委ねられます。

チェックを入れる前に知っておく価値のあることが三つあります。

  • 取り込まれるのは現れたファイルだけです。監視を始めた時点でフォルダにあるものは既知として記録され、そのまま残されます。四年分のマッチに監視を向けたからといって、それらをすべて取り込んではいけません。すでにあるものを取り込むには、そのためにあるフォルダの取り込みを使ってください。二つはとてもよく噛み合います。先に取り込み、次に監視です。

  • ファイルはサイズが安定してから取り込まれます。他のプログラムが書いている途中のマッチは、見るたびに大きくなります。書きかけで取り込めば、誰にも手の打ちようがない構文解析エラーになります。そこで blunderDB は、同じファイルを二度、変化なしと確認するまで待ちます。

  • 取り込みは静かに行われます。マッチが届いたとき、あなたは局面を検討している最中でした。そこで画面を奪うのは最悪のタイミングです。モード、有効な検索、タブ、表示中の局面は動きません。局面の一覧は再読み込みされず、新しいマッチは次の再読み込みで表示されます。取り込みはウィンドウを出さずに行われ、ステータスバーに、取り込んだ数・（重複として）飛ばした数・失敗した数を示す帯が出ます。望めば完全な報告を開くボタンもあります。ほかはすべて手動の取り込みと同じです。重複の検出も、取り込みのロットも、有効なら自動解析も同じです。

既定の間隔は 10 秒、下限は 2 秒です。フォルダは再帰的にはたどりません。監視フォルダは道具がマッチを置く場所であって、探索すべき木ではないからです。アンマウントされたネットワーク共有は監視を止めず、復帰したときにその中身を新規と見せることもありません。

同じ監視はコマンドラインにもあり、blunderdb import --type batch --dir <フォルダ> --watch で使えます（コマンドラインインターフェース（CLI） を参照）。サーバや定期実行、スクリプトが使えるのはこの形です。

2台のマシンを同期する

.dbデータベースをマシン間でコピーしたり、同期フォルダー（Syncthing、Dropbox など）に置いたりすると、いずれ壊れてしまいます。SQLite はデータベースの隣にジャーナルファイルを書き、ファイル同期がそれを順不同でコピーするためです。blunderDB は代わりに、もう一方のマシンが監視するフォルダーに置かれる増分エクスポートで二つのライブラリを同期します。転送手段は自由です（Syncthing、USB メモリ、メールなど）。サーバーもアカウントも不要です。

  • マシン A のエクスポートウィンドウでライブラリ全体を選び、このフォルダーへの前回のエクスポート以降の新しいものだけにチェックを入れ、フォルダーを選択…でフォルダーを指定します。エクスポートのたびに、そのフォルダーへsync-<machine>-<date>.dbファイルが書き込まれます。これには同じフォルダーへの前回のエクスポート以降にライブラリへ入ったものだけが含まれ、最初のファイルにはすべてが含まれます。

  • マシン B では、そのフォルダーを監視フォルダにします。そこに現れた.dbファイルはすべて、データベースのインポートと同じようにプレビューなしでマージされます。既知のポジションは重複せず、既知のマッチは認識され、コレクションとレッスンは名前でマージされます。

  • 反対方向も、二つ目のフォルダーで同じようにします。

知っておくべきこと：

  • 「最後の同期」の目印はエクスポートする側にあり、書き出し先フォルダーごとに一つで、ファイルが完成したときだけ進みます。受け取る側のマシンは何も記録しません。エクスポートが失敗すると目印はそのままで、次のエクスポートが同じ行を運びます。

  • 同期は追加のみで行われます。削除は伝わりません。A でマッチを削除しても B では削除されません。その場での変更も同様です。書き直したコメント、名前を変えたマッチ、送信済みのポジションでやり直した解析などです。送られるのは、前回のエクスポート以降に入ったポジション、マッチ、トーナメント、コレクション、レッスン、コメントです。コレクションはポジションが追加されたときにも、ポジションはコメントが追加されたときにも再び送られます。書き直したコメントは再び送られません。受け取る側のマシンは既に持っているテキストを置き換えないためです。訂正を伝えるには、新しいコメントとして追加してください。保存済みフィルターと Anki デッキは対象外です。チェックボックスなしのライブラリ全体のエクスポートにはこれらが含まれます。

  • マシンが受け取ったものは、一度だけ相手へ戻ります。そのマシンのライブラリでは新しいものだからです。相手は何も追加せずにそれを認識し、次の交換は空になります。

  • blunderDB が閉じている間に届いたファイルは失われません。監視の開始時に、フォルダーにすでにある各.dbがマージされます（マッチファイルとは異なります）。受け取る側のマシンは読み込んだものを記録しないため、起動のたびにフォルダーにまだ残っているすべてのファイルを再びマージします。何も追加されませんが、読み直す時間がかかります。この起動を速く保つため、受信済みのsync-…ファイルは時々削除してください。

  • 増分エクスポートはファイルを上書きしません。前のファイルには、相手のマシンがまだ受け取っていない行が入っているかもしれません。既に存在するファイル名へのエクスポートは拒否されます。フォルダーを指定すれば、エクスポートのたびに新しい名前が付きます。

  • 既に見た名前で書き直されたファイルは再び統合されます。監視はファイルを名前、サイズ、更新日時で識別します。

  • 開いているライブラリが自分自身に統合されることはありません：監視フォルダーの中にあっても、監視はそれを飛ばします。

  • 行を除外せざるを得なかったエクスポート（ログに記録されます）は、目印を進めません。次のエクスポートが、それらとその後に続くすべてを再試行します。

  • エクスポートが書きかけの状態で見えることはありません。隠し名で書き込まれ、その後一度に名前が変更されます。パスワード保護されたファイル（.dbx）は、パスワードを尋ねられない監視では取り込まれません。

コマンドラインでは、一方でblunderdb export --type database --incremental --file <フォルダー>、もう一方でblunderdb import --type batch --dir <フォルダー> --watchを実行します（コマンドラインインターフェース（CLI）を参照）。サーバーは/v1/exports.sqliteで"incremental": trueを受け付けます（ヘッドレスモード（サーバー）を参照）。

アシスタントと MCP

アシスタントと MCP タブでは二つの項目を設定します。どちらも初期状態では無効です。

ローカル MCP サーバー は、ウィンドウが開いている間、blunderDB のツール（検索、ポジションとその分析の読み取り、プレイヤーの統計、クイズなど）を、Claude Desktop や Claude Code のような Model Context Protocol を話すアシスタントに提供します。このマシン上でのみ http://127.0.0.1:<port>/mcp（既定のポートは 8765）で待ち受け、Web ページからのリクエストは拒否します。表示用のツールが二つ追加されます。検索結果のビューを開くことと、ポジションを表示することです。ツールは読み取りのみですが、書き込みを許可 にチェックを入れると、ポジションの保存、コメントの追加、コレクションの作成と充填、Anki カードの評価、ポジションの分析の隣へのロールアウトの保存ができるようになります。何も消去されません。ウィンドウが開いていないときは、blunderdb mcp が同じツールを提供します（コマンドラインインターフェース（CLI） を参照）。

内蔵アシスタントは、これらと同じツールのクライアントです。モデルは同梱されていません。OpenAI 互換のプロバイダーに接続します。既定ではこのマシン上の Ollama で、Groq、OpenRouter、Gemini、Anthropic、または別のアドレスも使えます。選んだプロバイダーに関わらず、このマシンの外にあるアドレスはすべてリモートとみなされます。その場合、入力した文とツールの結果がマシンの外に出ます。タブにその旨が表示され、そのアドレスそのものについて同意を求められます。別のアドレスにすると、あらためて求められます。API キーはシステムのキーリングに保存され、データベースにも設定ファイルにも保存されません。Ollama の既定のモデル qwen2.5:7b は出発点であって、推奨ではありません。ソースコードに同梱の計測用ベンチのスコアがない限り、モデルの推奨は行われません。

有効にすると、アシスタントは検索パネルのアシスタントサブタブになります。文 (「レースでの 50 ミリポイントを超えるミス」など) を入力すると、その文にちなんだ名前の新しいビューが開き、そこで検索が実行されて切り替わります。そのトークンは検索履歴に残ります。ツールが返す内容はデータベース由来で、モデルが書いた内容にはモデルの自由記述と表示されます。アシスタントが変更を提案するのは、アシスタントに変更の提案を許可する（それぞれ確認あり）にチェックを入れた場合だけです。これはローカル MCP サーバーの書き込みとは別の設定です。アシスタントが準備した変更はそれぞれ表示され、確定の後にのみ実行されます。

設定ウィンドウには、インターフェースの表示設定もまとめられています。インターフェースの拡大率 のスライダーを使うと、すべての要素を拡大または縮小でき、高密度ディスプレイや読みやすさの向上に役立ちます。ショートカット CTRL-+、CTRL-- 、CTRL-0 は、ブラウザーと同じようにこの拡大率を調整します。パネルの位置 メニューでは、パネル（検索、マッチ、分析）をボードに対してどこに配置するかを決定します： 下、横 または 自動（自動の場合、横長の画面では利用可能なスペースをより有効に活用するため横が選択されます）。他の設定と同様に、これらの選択はセッションをまたいで保持されます。

ガイドツアーとサンプルデータベース

操作に慣れやすくするため、blunderDB はインターフェースの ガイドツアー を用意しています。ツアーのカタログは、ツールバーから、またはコマンド tutorial（別名 tour）で開けます。7つのツアーが利用できます。インターフェースの全体ツアー、そしてポジションの検索、マッチのレビュー、トーナメントのレビュー、Eval パネル、Anki 復習、統計に特化したツアーです。各ツアーは、関連するインターフェースの要素を一手順ずつ強調表示し、その途中で話題のパネルを開き、いつでも再生できます。初回起動時には、全体ツアーが自動的に案内されます。

コマンド demo は、自分の対局をインポートしなくてもツールの機能を試せる サンプルデータベース を読み込みます。内容は、eXtreme Gammon、BGBlitz、gammonNet が解析した 3 つのマッチ（うち 2 つはトーナメントにまとめられています）、3 つのテーマ別コレクション、タグ付きのコメント（ #blunder 、 #cube ）、復習履歴付きの Anki デッキです。プレイヤー、トーナメント、会場は架空のものです。データベースが開かれていない場合、ガイドツアーはこのデータベースを利用します。

ポジションの編集

TAB キーを押すと検索パネルが開き、ボード上のポジションを編集して、データベースに追加したり、検索するポジションの構造を定義したりできます。チェッカーの配置、キューブ、スコア、手番はマウスで変更できます（ポジションを編集する を参照）。

ヒント

利用可能なショートカットについては キーボードショートカット を参照してください。

コマンドライン

ステータスバーに内蔵されたコマンドラインでは、グラフィカルインターフェースで利用できる blunderDB のすべての機能を実行できます。データベースに対する一般的な操作、ポジションのナビゲーション、分析やコメントの表示、フィルターに基づくポジションの検索などです。インターフェースにある程度慣れたら、特にポジション検索機能において blunderDB を強力かつ快適に使用できるコマンドラインを徐々に使うことをお勧めします。

コマンドラインを開くには、スペース キーを押します。リクエストを送信してコマンドラインを閉じるには、Enter キーを押します。

blunderDB は、ユーザーが送信したリクエストが有効である限りそれを実行し、必要に応じてデータベースの状態を即座に変更します。ユーザーによる明示的な保存操作はありません。

ヒント

コマンドラインで利用可能なコマンドの一覧については コマンド一覧 を参照してください。

コマンドパレット

コマンドパレット（CTRL-SHIFT-P）は、どこで探せばよいか分からなくなったものを、おおよその名前で見つけます。コマンドラインのコマンド、タブ、ライブラリのフィルター、マッチが対象です。入力した文字は順番どおりに現れればよく、隣り合っている必要はありません。大文字・小文字やアクセントも区別しません。「キュマト」でキューブマトリクスが、「lyon」でリヨンの大会のマッチが見つかります。

矢印キーで選び、ENTER で実行し、ESC で閉じます。コマンドは入力したときと同じように実行されます。s と ss はフィルターを書き込めるようにコマンドラインを開きます。フィルターはライブラリでダブルクリックしたときと同じように実行され、マッチはマッチパネルでダブルクリックしたときと同じように開きます。

Direction を開いている間、パレットにはその大会が加わります。プレイヤー、テーブル、進行中のマッチ、種目が対象です(クイック検索を参照)。