プロジェクト

全般

プロフィール

操作
リンクをコピー

機能 #415

完了

機能 #396: ゲーム内常駐ペット育成機能の追加

自然文曲検索用ローカルLLMモデルの同梱・パッケージングと実モデル動作検証 (#404 follow-up)

機能 #415: 自然文曲検索用ローカルLLMモデルの同梱・パッケージングと実モデル動作検証 (#404 follow-up)

エージェント ちゃん さんが11日前に追加. 11日前に更新.

ステータス:
完了
優先度:
通常
担当者:
いづ さん
対象バージョン:
1.2.0
開始日:
2026/06/24
期日:
2026/06/24
進捗率:

100%

予定工数:

説明

背景 / 目的

#404（自然文による曲検索）のフォローアップ。#404 では検索ロジック＋API層を実装済みだが、ローカルLLM（de.kherud:llama / GGUF）のモデルファイル本体は未同梱で、未配置時は常にルールベースへフォールバックする状態。LLM経路を実際に有効化・検証し、リリース物に含めるための作業を本チケットで扱う。

作業内容

  • 推奨する小型GGUF Instructモデル（例: Qwen2.5-0.5B/1.5B-Instruct Q4等）の選定とライセンス確認
  • jpackage / zip・msi へのモデル同梱（build.gradle の prepareJpackageContent 等）と配置パス規約（-Dbeatoraja.songsearch.model）の確定
  • LlamaCppInference の防御的リフレクション実装（TODO #404）を de.kherud:llama の実 API に合わせて確定
  • 推論のスレッドモデル化：選曲画面でのロード/推論をバックグラウンドスレッドで実行し、ゲームプレイ中（judgeタイミング）に影響させない
  • 実Windowsホストでの実モデル動作検証（代表クエリでの出力品質・CPU/メモリ/ロード時間・GPU使用の有無）
  • CPU推論を既定とし、GPUオフロードを使う場合はレンダリング（libGDX/LWJGL3）との競合評価

完了条件 (DoD)

  • リリース物にモデルが同梱され、代表的な自然文クエリでLLM経路が期待どおり動作する
  • モデル未同梱/ロード失敗時は従来通りルールベースにフォールバックし例外が生じない
  • 推論がゲームプレイ中の動作（judgeタイミング・フレーム）に影響を与えない
  • ユニットテストがすべて通る

関連するチケット 1 (0件未完了 — 1件完了)

次のチケットに後続 beatoraja - 機能 #404: 自然文による曲検索完了いづ さん2026/06/23

操作
操作
リンクをコピー

他の形式にエクスポート: PDF Atom