shinkuan/Akagi

支持雀魂、天鳳、麻雀一番街、天月麻將，能夠使用自定義的AI模型實時分析對局並給出建議，內建Mortal AI作為示例。 Supports Majsoul, Tenhou, Riichi City, Amatsuki, with the ability to use custom AI models to analyze games in real time and provide suggestions. Comes with Mortal AI as a built-in example.

Akagi とは何か？

Akagi は、オンラインリーチ麻雀（Mahjong Soul、Tenhou、Riichi City など）をプレイしているときに、リアルタイムで分析を提供するデスクトップアシスタントです。プレイ中に、以下の有用な数値を表示する小さなオーバーレイ（HUD）が表示されます：

シャンテン – 完全形まで何枚の牌が必要か
待ち – 手を完成させるために必要な牌
アガリ / テンパイ確率 – ツモまたはロンの確率
各プレイヤーのデットリスク – 各プレイヤーの捨て牌の危険度
推奨捨て牌 – ビルトインAIが最も適切だと考える捨て牌

オーバーレイは移動・リサイズ可能で、終了した対局はすべてローカルに保存され、後から統計、ランク分布、PTトレンドチャート、各手の詳細データを閲覧できます。

どうやって動くの？

ゲームデータのキャプチャ – Akagi は以下のいずれかで動作します：
- MITMプロキシ を起動し、ゲームのWebSocket通信を傍受（一度だけ自己署名CAをインストール）
- Chromiumベースのブラウザ を起動し、Chrome DevTools Protocol でWebSocketフレームをスニッフィング（証明書不要）
生データの変換 – プラットフォーム固有のブリッジ（Mahjong Soul、Tenhou など）により、生のフレームを標準的な mjai イベントストリーム（日本語リーチ麻雀用の共通JSONフォーマット）に変換します。
イベントをボットに供給 – 2種類のバックエンドが利用可能：
- ビルトインボット – HuggingFaceの candle ライブラリを使用してRustバイナリにコンパイルされた小さなニューラルネット。ローカルで動作し、ダウンロード不要。4人用・3人用（サンマ）両方に対応。
- クラウド推論 – オプションのリモートモデル。より強力な性能が期待できるが、ローカルモデルは常にフォールバックとしてロードされるため、サーバーが遅いまたは利用不可でもゲームが止まることはない。
分析の表示 – HUDに上記の数値を表示。History タブでは蓄積された統計を可視化。
オプションのAutoPlay – 有効にすると、ボットが実際に手を打ってくれます（Chromiumウィンドウ内の牌をクリック、またはTenhouに直接アクションを送信）。

すべてのコンポーネントは単一のRustバイナリ内に軽量なイベントバスで通信しており、UIは Tauri 2、React 19、Tailwind CSS で構築されています。

誰に役立つ？

決定の瞬時にフィードバックが欲しい、または「良い捨て牌」の見た目を学びたいカジュアルプレイヤー
プレイ中にシャンテン、待ちリスト、リスク指標を素早く確認したい麻雀理論の学習者
リアルタイムのゲーム状態キャプチャ、Rustベースのニューラルネット推論パイプライン、WebゲームとデスクトップUIの橋渡しに興味のある開発者／研究者

はじめ方

リリースをダウンロード – Releases ページからWindows、macOS（Apple Silicon）、Linux用のzipファイルを取得。任意の場所に解凍し、akagi 実行ファイルを実行。
セットアップウィザードを実行 – 言語、プレイするプラットフォーム、キャプチャモード（MITM または Chromium）、クラウド推論キーの有無を設定。
ゲームをプレイ – Akagi から内蔵のChromiumブラウザを起動するか、既存のクライアントをローカルプロキシ（127.0.0.1:23410）に設定。HUDが自動的に表示されます。
数試合後にHistoryタブを確認 – 勝率チャート、PTトレンド、各手の統計データを閲覧可能。

制限と注意点

ビルトインニューラルネット は意図的に控えめ。妥当なアドバイスは提供しますが、トップレベルのエンジンではありません。
MITMプロキシ を使用するには、自己署名CAのインストールと、WindowsではProxifierなどのサードパーティリダイレクターが必要。ループバックトラフィックを除外しないとゲームが正しく動作しない可能性があります。
クラウド推論 には購入または redeemed されたキーが必要。なければローカルモデルにフォールバック。
完全な対局のみ が保存されます。途中で切断された手はデータが破棄されます。
本ソフトウェアは教育目的のみ。ゲームの利用規約違反の可能性があり、アカウントペナルティはユーザーの責任です。

速見リファレンス

機能	詳細
対応ゲーム	Mahjong Soul、Tenhou、Riichi City（今後：Amatsuki）
キャプチャモード	MITMプロキシ（システムワイド）または Chromium CDP（CA不要）
ボット	ビルトインRust NN、オプションのクラウドホストモデル、外部mjaiプラグイン
対応プラットフォーム	Windows x64、macOS ARM64、Linux x64（glibc 2.35+）
UI技術	Tauri 2 + React 19 + TypeScript + Tailwind
ライセンス	Apache 2.0

Akagi は、単一のポータブルバイナリとしてパッケージ化されたリアルタイムAI支援分析ツールであり、オプションのクラウドベース推論を備えています。