Go Lab 機能詳細・仕様ガイド

第1章 対局モードとルール設定

1.1 対局モード

1.2 ルールセットとコミ

1.3 盤サイズとルールの組み合わせ

全盤サイズ × 全ルールの組み合わせに対応しています。

1.4 置石（ハンディキャップ）と手番選択

• 置石（ハンディキャップ）: SGF の AB/AW タグを解析し、「黒石 → 白石」の順に配置。置石ありの場合はSGF規約に従って手番を白に設定します。
• 手番選択: 対局設定画面で黒（先手）／白（後手）を選択可能。AI側は自動で反対の色になります。
• 1台2人対局: 手番選択は不要で、黒から交互に打ちます。

1.5 終局処理と死石判定

2連続パスまたは投了で終局します。日本・韓国ルール（地＋アゲハマ方式）では、終局後に死石判定フェーズが入ります。

• AI候補の自動ハイライト: 終局直後、KataGoが「死んでいる石」の候補を自動で盤上にハイライトします。赤い半透明の円＋赤い枠線で、視覚的に分かりやすく表示します。
• 感度スライダー: 画面下部のスライダーで、AIの判定感度（0.0〜0.9、デフォルト 0.3）を調整できます。「もっと候補を出したい」「絞りたい」を直感的に操作できます。
• 手動修正: ハイライトされた石をタップして、死活を手動で切り替えられます。AIの判定が実感と合わない時も安心です。
• 確定: 「Confirm」ボタンで死石を盤上から除去し、地の集計に進みます。除去された石はアゲハマとして両者に加算されます。

1.6 終局後アクション

• 結果モーダル: 勝敗、地の内訳（黒地・白地・アゲハマ・コミ・合計）、死石数が表示されます。
• 投了の扱い: 投了時は「黒/白の投了勝ち」を専用文言で表示。地の内訳は省略され、勝者と理由のみシンプルに提示されます。
• 新規対局への導線: 結果モーダルの「New Game」ボタンから、即座に次の対局へ進めます。

第2章 CPU対局の難易度制御（Lv.1〜63）

2.1 難易度と内部パラメータの関係

難易度は単純なVisits数の増減ではなく、KataGoの推論結果に対して意図的なノイズ（ランダム性やミス）を加えることで実現されています。

• Visits: 読みの深さ。
• Random Rate: 最善手以外の手をランダムに選ぶ確率。
• Mistake Rate: 明らかな悪手を打つ確率。
• Is Weakening: 弱体化処理を行うかどうかのフラグ。

2.2 レベル帯ごとの傾向

第3章 HumanSL（人間らしいAI）

3.1 HumanSLの技術的特徴

• 単一モデルによる多段級対応: 棋力帯ごとに別モデルを用意するのではなく、1つのモデルに対して「段級位」や「時代」を条件として入力。任意の強さの着手確率分布を出力します。
• プロファイル: rank_20kからrank_9dまでの現代プロファイルと、preaz_5kなどの古典プロファイルが存在します。
• 探索なしでの利用: 探索（Visits）なしでもそれなりの精度で人間らしい手を選べますが、トップ人間レベルに到達するには探索が必要です。

3.2 現代棋風と古典棋風の2系統

3.3 対局用モデルと分析用モデルの分離

Go Lab では「対局用」と「分析用」で、使用モデルと HumanSL プロファイルを別々に設定できます。

• 対局用モデル: CPU対局の相手として使うモデル。HumanSL を選択した場合は「対局用プロファイル」を別途指定。
• 分析用モデル: 検討モード・形勢判断・レポート生成で使うモデル。より精度の高いモデル（High / HumanSL）を選ぶのがおすすめ。

なお、HumanSL を対局用に選んだ場合、分析用には b6c96（Light）を選べません（精度差が大きすぎるため）。分析用は b18c384 または HumanSL から選択します。

第4章 オンライン対局

4.1 マッチングとレーティング

• クイックマッチ: 盤サイズ・レーティング帯を指定して、自動マッチング。
• レーティング: Glicko-2ベースのレーティングが変動。勝敗・相手の強さに応じて適切に更新されます。
• ニックネーム: 対局前に自由に設定可能。変更は即座にサーバーへ反映されます。
• リーダーボード: 上位ランカーを一覧表示。シーズン制で、シーズンごとにレーティングがリセットされます。

4.2 対局の流れ

1. 対局設定で「Online」を選択し、クイックマッチを開始。
2. マッチ成立で、3.5秒の開始演出（カウントダウン）。
3. 対局中は、双方の指し手がリアルタイムに同期されます。
4. 終局（2連続パス／投了）で、勝敗とレーティング変動が確定。

第5章 OGS連携

5.1 OGS観戦（Watch）

• 匿名認証: アカウント未登録でも観戦・一覧取得が可能。ログイン不要の観戦体験を提供します。
• ライブ対局リスト: 対局中のゲームを最大100件取得し、30秒ごとに自動更新。手動更新ボタンも用意。
• ライブ対局数イベント: ライブ対局数の変化を購読し、増加時のみ一覧を再取得。減少時は30秒タイマーに任せ、さらに10秒のスロットルを敷いてサーバー負荷を抑制しています。
• サムネイル購読: 画面に表示中の対局IDだけを購読し、スクロールで消えたら購読解除。0.5秒のdebounceでまとめて反映し、スクロール時の過剰購読を防止します。
• gamedataウォッチドッグ: 観戦開始後、4秒ごとに「gamedataが届いているか」を確認。10秒以上届かなければ再購読を最大10回まで自動リトライ。
• 時計表示: 「手番側だけ、サーバーから受信した時刻からの経過時間を減算」する方式。RTTの半分（最大3秒）を補正値として使用。
• 観戦中のAI形勢評価: 終局後、評価セクションをタップすると各手をKataGoで評価し、スコア配列を蓄積してリアルタイムにグラフを更新します。
• 棋譜保存: 観戦した対局をSGFとして保存し、検討モードで分析可能。

5.2 OGS対局（Play）

• クイックマッチ: 条件を指定して自動マッチング。
• 公開チャレンジ作成: 自分の色（黒/白/自動）とコミ（自動/カスタム）を指定して募集を作成。
• 公開チャレンジ参加: 他ユーザーの募集をタップで参加。マッチ成立通知を待ってから対局画面へ。
• ボット対局: OGS上のボットと対局。ボット個別の対応条件を事前チェックします。
• レーティング: Glicko-2レーティングが変動。
• 時間設定プリセット: 盤サイズごとに最適なプリセットを動的切替。
  • 9路: 30s+5s / 30s+5x10s / 2m+7s / 2m+5x30s / 3m+10s / 5m+5x30s / 3d+1d
  • 13路: 30s+5s / 30s+5x10s / 3m+7s / 3m+5x30s / 5m+10s / 10m+5x30s / 3d+1d
  • 19路: 30s+5s / 30s+5x10s / 5m+7s / 5m+5x30s / 10m+10s / 20m+5x30s / 3d+1d
• ボット互換性チェック: 対応盤サイズ・時間方式・速度・同時対局数を照合。同時対局数が0なら「現在この時間設定を受け付けていません」とエラーを返します。
• ランク差制限: ランク戦の場合、相手とのランク差が9以上なら受諾不可。実力差が大きすぎる対局を未然に防ぎます。
• 自分の募集の管理: 作成した公開チャレンジはロビーに「Open Challenge」として表示され、キャンセルボタンでいつでも取り下げ可能。マッチ成立時に自動クリアされます。

5.3 時間設定（Time Control）

5.4 対局中の操作とクロック補正

• 違法手のブロック: 現局面のルールを再現した仮想盤面で着手の合法性をチェックし、失敗した場合はサーバーに送信しません。
• 多重送信防止: 「送信中の手」フラグを立て、次手の送信をブロック。送信後10秒経過してもフラグが残っていれば、自動的にゲーム接続を再同期します。
• タイムアウト自動送信: 自分の手番でメイン時間が-10秒以下、かつ秒読み残りも0以下なら、タイムアウトを1回だけ送信。
• 相手投了の検知: 相手の最終手が「投了」、または終局イベントで終局処理。結果モーダルを表示します。
• レーティング表示: Glicko-2レーティングを取得して、「5k (1500)」のように段級位と併記します。

5.5 観戦・対局棋譜の履歴保存

• 共通の履歴保存: 観戦棋譜も対局棋譜も、同じ形式でアプリのローカル履歴に保存。後から検討モードで読み返せます。
• タイトル接頭辞: 観戦棋譜には"[OGS] "を付与して通常棋譜と区別。
• メタデータ保持: 黒/白の対局者名・段級位・対局名・結果・コミ・ルールを保持。
• 「Save Only」ボタン: 対局画面の下部に常設。終局後は「Save Only」、保存済みは「Saved ✓」に変化。

第6章 リアルタイム分析

6.1 形勢グラフ

• 縦軸: 目差（リード）。上方向が自分有利になるよう自動反転。
• 横軸: 手数。
• 現在位置: 黄色のマーカーで表示。
• タップジャンプ: グラフをタップした位置を手数に正規化し、その局面へ瞬時にジャンプ（検討モード中のみ有効）。
• Y軸の動的スケーリング: 全手の最大スコア + 200目、かつ最低2000目を500刻みに切り上げてY軸上限を決定。軸ラベル刻みは5目 / 10目 / 20目を状況に応じて自動切替。
• X軸の動的刻み: 総手数を7分割する刻み（1, 2, 5, 10, 20, 25, 50, 100, 200, 500, 1000手）を自動選択。
• 本譜と分岐のY軸共有: 本譜タブと分岐タブで同じY軸スケールを共有するため、タブ切替で見た目の高さが変わりません。
• 分岐点の破線表示: 分岐点の手数に白の破線を縦に描画。
• パス時の前値保持: コミ計算等でスコアが瞬間的にゼロに落ちた場合、直前のスコアを保持してグラフの急落を防止。

6.2 候補手（5段階色分け）

盤面上に、AIが推奨する上位の候補手が表示されます。

• 表示件数: 3〜30件（デフォルト5件）。設定画面から変更可能。
• 色分け: 最善手からの勝率差と目数差の悪い方で判定します。序盤（目数支配）でも終盤（勝率支配）でも、同じ閾値で自然に色分けされます。

• 勝率表示の桁揃え: 整数部と小数部を分離し、%記号を整数部の右下に固定、小数をその真上に積む独自レイアウト。99.2%と99%で数字の位置がブレず、円からはみ出しません。
• ズーム・パンへの完全追従: 盤の拡大率・パン量を反映して各候補手の最終位置を算出。
• 影の比例スケーリング: 影のオフセットも候補手の直径に比例して計算。

6.3 地合い表示（Ownership Overlay）

「地図のアイコン」をタップすると、AIが予測する地の所有状況が盤面上に表示されます。

• 量子化: 確信度 0.3 未満の地は描画しません。ノイズを除去して「確信のある地」だけを表示。
• アウトライン: 黒地には白の細枠、白地には黒の細枠を描画。石の上や木目背景でも境界が視認可能。
• キャッシュ: 新規対局・盤サイズ変更時のみ前回の地図をクリア。候補手評価の合間に一時的に空になっても地図がチラつきません。
• 集計値: 確信度 0.6 を閾値として黒地・白地をカウントし、形勢グラフのヘッダ横に「●N ○M」として表示。

6.4 思考時間の可視化

• パーセンタイル・ハイライト: 棋譜リストでは全手の思考時間をソートし、上位5%を赤、上位15%を黄で着色。
• ライブ更新の粒度: HUDは毎秒20回、カードは0.4〜0.5秒間隔で更新。画面の再描画負荷と視認性のバランスを取っています。
• 手番中のみ加算: 現在の手番側の経過時間だけを加算。終局後は値が凍結されます。
• リプレイ時の再計算: 過去の手数へジャンプした時、HUDが「その時点の累積思考時間」に切り替わります。

第7章 検討モード

7.1 分岐（バリエーション）の作成

• 本譜の再生: 棋譜リストの手をタップしてジャンプ。
• 分岐の作成: 盤面タップで新しい分岐を作成し、タブを追加。
• タブ切り替え: 画面上部のタブで本譜と分岐を切り替え。
• 分岐の削除: タブの「×」ボタンで削除。

分岐管理の内部仕様

• タブベースの分岐管理: 各分岐は「分岐ID・全手順・現在の局面・カーソル位置・分岐開始手数」をセッションとして保持。
• 本譜バックアップ: 初回分岐時に本譜の全手順・局面・カーソル位置を退避し、本譜タブに戻る時に正確に復元。
• 前方一致マージ: 分岐作成時、既存の分岐と前方一致する手順なら新規タブを作らず既存タブへ移動。「同じ手順を別タブに重複作成」する事故を防ぎます。
• 末尾追記 vs 途中分岐: カーソルが末尾にある時は追記、途中にある時は新規分岐。
• 途中分岐の undo: 分岐の末尾を削除し、分岐開始手数以下になったら分岐タブ自体を自動削除して本譜に復帰。
• 安全なノードジャンプ: 巻き戻しではなく、初期局面から対象手まで再適用する方式。複雑な分岐でも盤面状態が壊れません。

7.2 PV（推奨手順）の再生

• PVの長さ: 3手、5手、7手から選択可能。
• 再生: PVの手順を盤面上に半透明＋黄色枠のゴースト石として順番に表示。
• Place: PVの手順を実際の盤面に適用（分岐として確定）。

PVプレビューの内部仕様

• ゴースト石の視覚仕様: 半径はセルサイズ×0.45、影付き、黄色2.5pt枠。白石は白い不透明円、黒石はやや透過した黒。手数番号を中央に黒字／白字で描画。
• PV操作バー（ドラッグ可能）: 候補手の前後移動、PV長さの切替、Placeボタンを1つの浮遊バーに統合。位置は次回起動時も記憶されます。
• 一括適用: Place押下時、PVの各手を順次ルールエンジンで適用しながら新しい棋譜エントリを生成。末尾なら既存セッションへ追記、途中なら新規セッション作成。
• 適用後の逐次評価: 1手評価するごとにスコアを埋めてUIを更新し、形勢グラフの点が1つずつ埋まっていくUXを実現。途中で別タブに切り替わったら即座に評価を打ち切ります。

7.3 バリエーションツリー

作成した分岐の全体像をツリー形式で表示します。各ノードをタップするとその局面にジャンプします。右端の列には各手の「目差」と「合計」が表示され、形勢の変化を視覚的に把握できます。

• 3列構成の右パネル: 盤面ノードの右側に「Delta（その手での形勢変化）」「Total（その時点の形勢）」の2列を表示。
• ベジェ曲線の分岐線: 縦方向の中点で制御点を取る2次ベジェで親→子を結び、アクティブ分岐のみ線を太く（3.0pt vs 1.5pt）して強調。
• 左右交互配置: 分岐は左右交互に配置し、深い分岐でも横方向の衝突を回避。
• 分岐タブ選択時は末尾へ: 分岐タブをタップすると、その分岐の末端（最後の手）へスクロール。「この分岐がどこまで進んだか」が一目で分かります。

7.4 局面ナビゲーション（相互ジャンプ）

Go Lab では、複数の画面から同じ局面へアクセスできる導線を用意しています。

7.5 検討モード中の盤タップ制御

• 本譜再生中のタップは無効化＋ヒント: 検討モードがOFFの時の盤タップは警告ハプティックを鳴らし、「検討ボタンを押すと盤面に石を置いて検討できます」のトーストを3.5秒表示。誤って本譜を壊すのを防ぎます。
• 検討モード中のタップ: 手が進めば「カチッ」という中程度のハプティック、進まなければ「ブブー」という警告で「その手は既存の手と一致しない／不正手」を伝えます。

第8章 レポート生成

8.1 2種類のレポート

8.2 悪手の5段階評価

8.3 AI推奨手との比較

• Best: 打った手 = AI最善手（パーフェクト）
• Second: 評価差が2.5目未満（十分に良い手）
• Mismatch: AI推奨手から外れた手（改善余地あり）

レポートには「打った手」と「AI推奨手」の両方が盤図で並記され、「もしこの手を打っていたら」のPV（推奨手順）も確認できます。

8.4 価値差（Value Gap）

「打った手」と「AI推奨手」の形勢差を、同じ局面同士で比較した純粋な価値差として算出。打った手＝推奨手の場合は定義上0.0目になります。

8.5 低信頼度フラグ

その手を解析した時の訪問回数が500未満の場合、「低信頼度」フラグが付きます。分析の精度が十分でない手を「悪手」と断定しないための配慮です。

8.6 非同期解析と進捗表示

1. 対象手の候補を全件抽出
2. 各候補手について「AI最善手」が未キャッシュならエンジンで再解析し、最善手・形勢値・推奨手順・訪問回数を棋譜に埋める
3. 1手ごとに進捗コールバックを呼び、UIに「N / M」を表示
4. 有効候補を指定件数に絞り、各手のハイライト情報を生成
5. 勝率の変化量をシグモイドで計算して埋め込み

8.7 レポート出力

• 2種類のレポートテンプレート: スコア低下用／勝率低下用のHTMLテンプレートをWebViewに読み込み、JavaScriptでJSONを描画。
• PDF→画像化: WebViewでPDFを生成後、高解像度のPNGにラスタライズ。高さは最大4000pxにスケールしてメモリを節約。
• QRコード埋め込み: App Store URLをQRコード化し、レポート画像内に「アプリのストアページ」への導線を自動挿入。
• クリップボード／共有: クリップボードへのコピーと標準の共有シートの両対応。
• コピー完了トースト: 1.5秒間のトーストをアニメーション表示。成功ハプティックも同時に鳴らします。

第9章 棋譜管理・SGF入出力

9.1 SGF入出力

• インポート（ファイル選択）: SGFファイルを選択して分析。
• インポート（テキスト貼り付け）: SGF文字列を直接貼り付けて読み込み。他アプリからのコピペに対応。
• 文字コード自動判定: BOMを先に検出してUTF-8で読む → 失敗ならUTF-8 / Shift-JIS / UTF-16を順に試行。
• 置石（AB/AW）対応: SGFの置石タグ（[dp][pd]...）を解析し、「黒→白の順に適用」「置石ありなら手番を白に」というSGF規約通りに処理。
• 合法手チェック: インポート時にルールエンジンで1手ずつ検証。失敗した手があってもログを残して続行し、1手の失敗で全体を失わない堅牢設計。
• インポート直後の一括解析: 各手をKataGoで評価し、進捗コールバックで「N / M」をUIに表示。既に評価済みの手はスキップして再開可能。
• エクスポート: 棋譜をSGF形式（GM[1]FF[4]）で出力。他アプリに持ち出すことも可能。

9.2 対局履歴の管理

• JSONファイル履歴: アプリのドキュメントフォルダに1件1ファイルのJSONとして保存。2回目以降の読み込みはメモリ参照で高速化。
• 履歴一覧: 日付・対局者名・勝敗・盤サイズ・ルールを一覧表示。タップで分析モードへ。
• 履歴削除: 左スワイプで削除。
• タイトル接頭辞: 観戦棋譜には"[OGS] "を付与して通常棋譜と区別。
• メタデータ保持: 黒/白の対局者名・段級位・対局名・結果・コミ・ルールを保持。

9.3 オートセーブと再開

• オートセーブ: 対局中は毎手保存され、アプリ再起動時に再開確認が表示されます（有効期限: 無制限）。
• 再開ヒントの経過時間表記:
  • 同日 < 1分："直前"
  • 同日 < 60分："N分前"
  • 同日 ≥ 60分："N時間前"
  • 日跨ぎ："N日前"（カレンダーで日付差を優先）
• 旧データ警告: リリース日以前の保存日時の棋譜を読み込んだ時、「データが古い可能性があります」というトーストを表示。直近50件まで「トースト済みキー」を保存し、同じ棋譜で2回出さない設計。
• 旧データからの移行: 旧形式の履歴データをファイル形式に自動マイグレーション。成功したら旧キーを削除、失敗時は次回起動時に再試行。

9.4 棋譜からの局面ジャンプ

• 棋譜リストのタップ: 棋譜リストの任意の手をタップして、その局面へジャンプ（検討モード中）。
• 検討中のタブ切り替え: 本譜／分岐のタブを切り替えると、該当セッションのカーソル位置が復元されます。

第10章 詰碁（Tsumego）

10.1 問題の構成

• コレクション: 現在有効なコレクションは「玄玄棋経（XXQJ）」ベース。SGFデータが整備済みのもののみ公開しており、他の古典棋書はデータ準備が整い次第の追加を予定。
• フィルタ: 手数（1-3手、4-6手、7-10手、11手以上）、ステータス（未クリア、クリア済み）で絞り込み。
• ソート: 問題番号順、手数順。

10.2 解答判定とAI応手

• 正解: 正しい手を打つと、0.5秒の間の後にAIが応手を返します。ユーザーの着手が画面に描画される時間を確保し、連打による不整合を防ぐための設計。
• 不正解: 間違った手を打つと「Failed」と表示され、その手は取り消されます。取り消しのきっかけは専用のフラグで管理。
• フリープレイ: 解答がない問題ではAIと自由に対局（最大15手）。「プレイアブル矩形の外側」の点はAIに打たせないよう制御。

10.3 複数正解の可視化

10.4 解答再生モード

• 解答再生: 問題を一旦リセットし、解答手順を1手ずつ順番に盤面に並べます。1手進む／1手戻る／最初へ／最後への4つのナビゲーションを搭載。
• 自動再生: 1秒間隔で解答を自動再生。末尾到達で自動停止。
• 手数番号オーバーレイ: 石の上に「1, 2, 3…」を重ねて表示。黒石には白背景＋黒数字、白石には黒背景＋白数字。円のサイズは石の直径×0.65に抑え、石の縁が見えて黒白が判別できる設計。
• 盤座標の完全一致: 盤面描画と同じ座標計算を共有し、ズーム・パンしても手数番号が正しい交点に追従。

10.5 進捗管理とストリーク

• レベル別の完了データ: 初級／中級／上級など、レベル別に「クリア済み問題番号」を別々に保存。
• ストリーク（連続学習）: 「最後に解いた日」と「連続日数」を保存。翌日に解けば+1、1日以上空くと1にリセット。同日内の複数問クリアではstreakは増えません。
• 今日のクリア数: 「問題ID → クリア日時」を全件保持し、今日の日付と一致するものだけをカウント。
• 進捗通知: クリア時に関連画面へ通知を送り、一覧画面を自動再描画。

10.6 正解演出

※内部名「くるりん〜ぱっ！キラーん」。製品紹介としては「正解演出」として扱います。

第11章 レッスン

11.1 レッスンカリキュラムの構造

• レベル: 初級／中級／上級／達人の4段階。データが整備済みのレベルのみ順次公開。
• レッスン（読む）: 1レッスン = 複数のステップ。各ステップに「盤面」「マーク」「テロップ」が紐づき、Live2Dキャラクターが解説します。
• 操作型教材（試す）: 盤面上のマークが0.6秒間隔で順次ハイライトされ、「ここに注目 → 次はここ」という順序を視覚的に追えます。タイピング演出中にタップすると全文表示に切り替わる「スキップ」も可能。
• テスト（解く）: レッスンの最後に「操作型テスト」が出題されます。
  • 全問タップ: 正解点をすべてタップする形式（残り個数表示付き）
  • 1問タップ: 正解点を1つタップする形式
  正解時は軽い振動＋「正解！」表示、不正解時はエラー振動＋「もう一度」表示。不正解の自動消去は行わず、ユーザーがタップで閉じるまで表示し続けます。
• 完了演出: 全問正解で完了オーバーレイが表示され、「Next Lesson」で次のレッスンへ。

11.2 Live2Dキャラクターの統合

• Live2D Cubism SDKとの連携: Live2DのMetal描画ViewをSwiftUIにブリッジする専用のラッパーを実装。シングルトンでViewControllerを保持し、複数生成によるチラつきを防止。
• リップシンク: 0.1秒間隔のタイマーでキャラクターの口パクパラメータを更新。セリフ表示中の最初の3秒間だけ動かし、その後は口を閉じます。
• 表示サイズの最適化: Live2Dビューの高さを画面の1.5倍にし、画面下まで伸ばすことで、テロップ背景がキャラクターの足を隠さないよう設計。
• 視線追従: Live2D側のタップ処理をそのまま活かし、SwiftUI側では背景の黒部分だけを拾う設計。
• 起動時ウォームアップ: アプリ起動から1.5秒後にモデル読み込みとMetal初期化を先に実行。レッスン画面を開いた瞬間にキャラクターが表示されない、という待ち時間を削減。

11.3 盤面連動解説とテロップ

• タイピング演出: 1文字40ミリ秒のタイピングでテロップを表示。タイピング中にテロップをタップすると即座に全文表示に切り替わる「スキップ」機能も搭載。
• マークの順次ハイライト: 0.6秒間隔で盤面上のマークを1つずつハイライト。レッスン中のみ有効で、テスト中／完了画面／タイピング中は無効化。
• ハイライト時の視覚効果: 該当マークは1.3倍に拡大、非該当マークは不透明度 0.5で減光。0.4秒のイージングで滑らかに切り替わります。
• マークの色分け:
  • 丸 = 青（注目点/正解）
  • 三角 = 赤（相手の逃げ道/狙われる点）
  • 四角 = 緑（自分の形/地）
  • × = オレンジ（急所/打てない点）
  • ラベル = 白
• 石の色との反転: マーク位置に石がある場合、石の色と逆の色でマークを描画（白石→黒マーク、黒石→白マーク）。
• 最終手の二重丸: 最終手に「黒い太枠（7pt）＋白い円（5pt）」を重ねて表示。レッスン中に「今どこに打ったか」が一目で分かります。

11.4 レベル管理と多言語

• 4レベル: 初級 / 中級 / 上級 / 達人。公開中のレベルを制限する仕組みがあり、データ未整備のレベルはUIに出しません。
• レベル別の完了データ: レベルごとに別々の完了データキーで管理。
• 多言語テキスト: 日本語 / 英語 / 韓国語 / 繁体字中国語の4言語を保持し、デバイスの言語設定に応じて実行時選択。英語フォールバックあり。
• 問題番号の解釈: SGFコメントから"problem (\d+)(?:-(\d+))?"を正規表現で抽出し、「(章, 番号)」に分解。

第12章 システム概要と動作環境

12.1 動作環境

12.2 アプリの構成

• KataGoエンジン: C++で実装されたKataGoをSwift/Objective-C++ブリッジ経由で呼び出し。CoreML（ANE）またはMetal（GPU）バックエンドで推論を実行。
• ゲームコントローラ: 対局の進行、Undo、オートセーブ、終局判定などを管理。
• UIレイヤー: SwiftUIで構築され、盤面描画にはMetalベースのCanvasを使用。
• 永続化レイヤー: 対局履歴や設定をJSON形式でローカルに保存。

第13章 AIエンジン「KataGo」の技術仕様

13.1 モデルの種類と技術的差異

※パラメータ数は公開されているKataGoのネットワークアーキテクチャに基づく。

13.2 モデルの選択と利用可否判定

• Light: アプリに同梱されているため、常に利用可能。
• High / HumanSL: 追加ダウンロードが必要。未ダウンロード時はアプリが自動的に Light にフォールバックします。
• 選択中のモデル: 設定画面から切り替え可能。変更時は共有エンジンが破棄され、次の推論から新モデルで動作します。

13.3 バックエンドの違い

• Metal (GPU): b6c96のような軽量モデルに適しており、消費電力を抑えつつ高速に動作。
• CoreML (ANE): Apple Neural Engineを使用。b18c384のような大規模モデルを効率的に実行でき、高い推論速度を実現。

シミュレータ環境では、自動的にMetal + b6c96が使用される仕様です。

13.4 エンジンの推論パラメータ

• 対局時のVisits: 難易度（Lv.1〜63）に応じて内部的に動的に設定されます。
• 分析時のVisits: 設定画面から「40〜1000」の範囲で調整可能です（デフォルト: 評価用100、候補手用280）。

第14章 設定とデータ永続化

14.1 設定項目一覧

14.2 データ永続化

• 対局履歴: アプリのドキュメント領域にJSON形式で1件1ファイル保存。
• 設定: ユーザー設定領域に保存。
• オートセーブ: 対局中は毎手保存され、アプリ再起動時に再開確認が表示されます（有効期限: 無制限）。

14.3 オートセーブの堅牢性

• サニタイズ: 極端な有効期限設定（無限など）はJSONエンコード時に事故るため、「実質100年」の定数に置換して安全に保存。
• 壊れたファイルの退避: デコード失敗時は.broken拡張子にリネームして退避。他の正常ファイルは読み込み続行。
• 旧データからの移行: 旧形式の履歴データをファイル形式に自動マイグレーション。

第15章 モデル管理とアプリ運用

15.1 モデルダウンロードマネージャ

• 2段階ダウンロード: HumanSL選択時はベースモデル（b18c384）→ HumanSLモデルの順に2ファイルを自動ダウンロード。キューに積んで順次処理。
• .mlpackageから.mlmodelcへの自動コンパイル: ダウンロードした.mlpackageをCore MLでコンパイルし、.mlmodelcとして配置。次回起動時はコンパイル済みモデルを直接ロードして起動を高速化。
• ダウンロード中の安全策: ダウンロード／削除中は一時的に軽量モデル（Metal b6c96）にフォールバック。重いファイル処理中でもアプリが固まりません。
• 削除時の依存関係: b18c384を削除するとHumanSLモデルも一緒に削除。HumanSLだけを削除する場合はベースモデルを残します。
• 容量内訳ログ: アプリ本体・アプリケーションデータ・キャッシュのサイズと上位5ファイルの内訳をログ出力。

15.2 レビュー依頼

• 3日ルール: 初回起動日時を保存し、初回起動から72時間未満ならレビュー依頼を抑止。使い始めたばかりのユーザーに依頼を出さない配慮。
• アプリ全体で1回のみ: 「既に依頼したか」をアプリ全体で管理。対局・詰碁・分析のどこから先に呼ばれても、最初の1回だけ通す方式。
• 機能別カウント: 「分岐作成」「SGFインポート分析」などの利用回数を累積し、閾値到達時にレビュー依頼を出します。
• 詰碁マイルストーン: 累計クリア数3 / 15 / 60 / 100 / 300問に到達した時点でもレビュー依頼。

15.3 リリースノートと強制アップデート

• リリースノート取得: App Storeの情報を取得し、lastVersion != currentVersionの時だけ照会。さらに言語簡易判定（日本語：ひらがな/カタカナ/漢字、韓国語：ハングル、中国語：漢字）で「期待する言語でない」フォールバックをスキップ。英語フォールバックで日本語ユーザーに英語リリースノートが出る事故を防ぎます。
• 強制アップデート: サーバー上の最小バージョンと現在のバージョンを数値比較し、古ければApp Storeへの誘導アラートを表示。

第16章 通信とオンライン対局の堅牢性

16.1 バックグラウンド離脱時のタイマー

• アプリがバックグラウンドに回った時、オンライン対局中なら20秒後に自動退室。アプリに戻ればタイマーはキャンセル。相手を長時間待たせない配慮です。

16.2 相手投了の検知と終局

• 相手の最終手が「投了」、または終局イベントで終局処理。結果モーダルをアニメーションで表示します。

16.3 手数同期のズレ防止

• サーバー上の手数とローカルの棋譜件数を照合し、「既に適用済みの手を二重適用」する事故を防ぎます。

16.4 ネットワーク回復時のリカバリ

• 保留中の手の照合: 「保留中の手」と「サーバー上の最終手」を比較し、未反映なら再送、既に反映済みなら保留をクリア。二重送信と取りこぼしの両方を防ぎます。
• 切断検知と再接続: ネットワーク変化を監視し、オフライン復帰またはインターフェース切替を検出したら1.5秒待ってリカバリを実行。急な再接続連打を回避する設計。

16.5 多重送信防止

• 「送信中の手」フラグを立て、次手の送信をブロック。送信後10秒経過してもフラグが残っていれば、自動的にゲーム接続を再同期。

第17章 UI/UXのこだわりと隠れた便利機能

17.1 盤面操作の心地よさと誤操作防止

• CPUの手への自動追従（フォロー機能）: 盤面を拡大している時、CPU（相手）が画面外や端に手を打つと、自動的に画面がパンしてその手が見えるように追従します。しかし「自分の手」では追従しないため、画面酔いや誤操作を防ぐ工夫。
• 自動ズームアウト＆着手: 拡大状態で交点をタップすると、一瞬で等倍に戻ってから石が置かれます。拡大したまま石が置かれて全体が見えない、というストレスがありません。
• ダブルタップでの倍率切り替え: ダブルタップするだけで「等倍表示」と「短辺あたり12交点が見える拡大表示」を瞬時に切り替え。
• パン操作のクランプ: 拡大時に盤の外側（空白部分）が見えすぎないように、移動できる範囲に制限（クランプ）がかかっています。
• 多様な端末レイアウト: iPhoneの縦向き・横向き、iPad、フルスクリーン表示のすべてに対応。横画面では盤面の右側に情報パネルを配置するなど、最適なレイアウトに自動で切り替わります。

17.2 没入感を高める演出とフィードバック

• Zen Mode: 盤面以外のUI（棋譜、候補手、形勢グラフ、操作ボタンなど）を優しくフェードアウトさせ、盤面に全集中できるモードです。右上の「Zen」ボタンでいつでも切り替え可能。
• 石を置く時の物理アニメーション: 石が上から落ちてくるような「easeOutCubic」の動きと、それに連動して変化する影の描画（空中では薄く広がり、着地で濃く収束する）をリアルタイムで計算。
• 触覚フィードバック（Haptics）: 石を置いた時の「カチッ」という衝撃（CoreHaptics）、打てない場所をタップした時の「タッタッタッタ」という警告振動など、触覚でも操作をサポート。
• 思考中/解析中のドットアニメーション: 盤上の上中央に「…」が流れるようなアニメーションを表示し、AIが考えていることや解析中であることを主張しすぎずに伝えます。
• 盤面スタイルの変更: 設定から「木目（Wood）」と「無地（Plain）」を切り替えられます。無地はフラットでモダンな見た目になり、分析や検討に集中したい時に適しています。

17.3 分析・検討機能の便利ポイント

• グラフのタップジャンプ: 検討モード中、形勢グラフの任意の位置をタップすると、その手数まで瞬時にジャンプできます。
• プレイヤー視点への自動反転: 自分が白番（後手）の場合、形勢グラフの上下やスコアのプラスマイナスを自動で反転。常に「自分が良いか悪いか」が直感的にわかります。
• 候補手の視認性へのこだわり: 候補手の丸の中には勝率（%）と目差が表示されますが、円のサイズが変わっても数字の位置がズレないように、独自のカスタム描画。
• PV（推奨手順）のゴースト表示: 検討モードでPVをONにすると、推奨される手順が盤上に半透明の仮想の石（ゴースト）として順番に表示されます。そのまま「Place」ボタンで実際の盤面に適用（分岐として確定）できます。
• バリエーションツリーの視覚化: 棋譜全体の分岐をツリー形式で表示。右側に各手の「目差」と「形勢」が並んで表示され、どこで形勢が悪くなったか一目でわかります。
• 賢い分岐のマージ: 検討モードで盤面をタップして新しい手を打つと自動でタブが作られますが、もし既存の分岐と同じ手順だった場合は、新しくタブを作らずに既存のタブにマージ（移動）されます。

17.4 学習・レッスン機能のこだわり

• Live2Dキャラクター: レッスン画面ではLive2Dのキャラクターがガイド役として登場します。セリフに合わせたリップシンク（口パク）やまばたきの機能も実装されています。
• 順次ハイライト: レッスンの解説では、盤面上のマーク（丸、三角、四角、バツ）が一定間隔（0.6秒）で順番にハイライトされ、解説の順序を視覚的に追うことができます。
• 複数正解の可視化（詰碁）: 詰碁で複数の正解がある場合、正解の一つを打つと、他の正解の候補点が「緑の破線の円」で表示されます。
• 手数番号のオーバーレイ（詰碁）: 解答再生モード時、石の上に「1, 2, 3...」と手数が表示されます。黒石には白い数字、白石には黒い数字が重ねられ、石の縁が見えるようにサイズが調整されています。
• 正解演出: 詰碁を解いた瞬間、チェックマーク・メッセージ・星のパーティクルによる独自のアニメーションで称えてくれます。
• ストリーク（連続学習）機能: 毎日詰碁を解くと、連続日数が記録され、クリア時に「🔥 N day streak」と表示されます。

17.5 オンライン・OGS連携の便利機能

• サムネイル付き観戦リスト: 観戦リスト（OGS Watch）で、実際の盤面のサムネイルが表示されます。手数や対局者のレートも一目でわかります。
• 観戦中のAI形勢評価: OGSの観戦画面でも、自分のKataGoエンジンを使って形勢グラフを表示できます。
• レート制限（レートリミッター）: OGSのAPI制限（1時間あたりのリクエスト数）を超えないよう、アプリ内のレートリミッターで制御。
• 時間設定のプリセット: OGS対局の時間設定は、盤サイズ（9路、13路、19路）に合わせた推奨プリセットから直感的に選択できます。

17.6 Zen Mode の操作体系

• 残るもの: 盤面、Undo／Pass／Resign ボタン、Zen 解除ボタン（薄く残る）。
• 消えるもの: ヘッダー、思考時間、棋譜、形勢グラフ、候補手、地表示。
• フローティングメニュー: 右上に「≡」ボタンが浮遊し、タップで通常メニューを開けます（Zen中でも棋譜・設定にアクセス可能）。
• 順序付きフェード: ヘッダー → 思考時間 → 情報カードの順に、外側から0.08秒ずつ遅れて消えます。突然全部消えるのではなく、視線を盤面に自然に誘導する設計。
• AI着手間隔の延長: Zen 中はAIの着手前の最小間隔が1.0秒 → 2.0秒に延長され、盤面をじっくり見ながらAIの着手を待てます。
• 初回案内: 初回起動時に一度だけ、対局設定シートを閉じたタイミングで10秒間のトーストを表示。

17.7 その他の細かいUX・サポート機能

• オートセーブと親切な再開: アプリが落ちても、最後の手から再開できます。再開時には「N分前」「N時間前」「N日前」といった親切なメッセージが表示されます。
• 古いデータの警告トースト: リリース日より前の古い棋譜データを読み込んだ際、自動的にトースト通知を表示して「データが古い可能性がある」ことを知らせてくれます。
• レポートのQRコード: 生成された分析レポートには、アプリのApp Storeページへ誘導するQRコードが自動的に埋め込まれます。
• 多言語対応: 日本語、英語、中国語（簡体字・繁体字）、韓国語など、デバイスの言語設定に合わせてUIが切り替わります。
• 強制アップデート/リリースノート: 起動時にサーバーからバージョン情報を取得し、必要に応じてApp Storeへの誘導やリリースノートの表示を行います。

17.8 その他の隠れた配慮

• 正解演出の初回フレーム問題回避: アニメーション開始を1フレーム遅らせて発火。SwiftUIの初期化順序による「アニメーションが動かない」バグを防ぎます。
• 大規模棋譜のスクロール最適化: 遅延描画のリストと自動スクロールを使い、現在手数が変わるたびに該当行へ自動スクロール。
• リプレイ中の体感速度: 「途中から再生」する時、まず推論をキックして推論完了を待ってから再生開始。推論中に次の手へ進んでしまう「カクつき」を防止。
• Undo時の思考時間復元: 累積時間から該当手の所要時間を差し引き、下限は0でクランプ。Undoを繰り返しても累積時間が負にならず、Undo→Redoでも整合。
• 合法手ゼロ時のフォールバック: AIが不正手を返した場合、合法手を列挙してランダムに1つ選び、それでも無ければパス。AIのバグで対局が止まるのを防ぎます。
• 盤サイズ変更時のリセット順序: 「解析タスクをキャンセル → 分岐をクリア → 地の所有状況をクリア → 共有エンジンをリセット」の順で実行。
• 設定変更時のモデル破棄: 使用モデルが変わった時、共有エンジンを強制破棄。新設定で次のエンジンが生成され、古いモデルの混在を防ぎます。
• シミュレータでのモデル自動切替: シミュレータ環境では自動的に軽量モデル（Metal b6c96）を強制。