https://github.com/pkki/shogianalytics
将棋対局分析プラットフォーム | Real-time Shogi game analysis powered by YaneuraOu engine
https://github.com/pkki/shogianalytics
capacitor game-analysis japanese-chess pwa react shogi shogi-analysis socket-io tailwindcss vite
Last synced: 4 days ago
JSON representation
将棋対局分析プラットフォーム | Real-time Shogi game analysis powered by YaneuraOu engine
- Host: GitHub
- URL: https://github.com/pkki/shogianalytics
- Owner: pkki
- License: mit
- Created: 2026-03-28T14:31:40.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-15T11:37:18.000Z (about 2 months ago)
- Last Synced: 2026-05-15T13:30:54.228Z (about 2 months ago)
- Topics: capacitor, game-analysis, japanese-chess, pwa, react, shogi, shogi-analysis, socket-io, tailwindcss, vite
- Language: JavaScript
- Size: 10.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
## 概要
**ShogiAnalytics** は、YaneuraOu USI エンジンと連携するリアルタイム将棋分析アプリです。ブラウザでもスマートフォンでも、プロ級の解析をすぐに使える UI で提供します。
> このリポジトリは **フロントエンド**のみです。エンジン連携・分析API は別リポジトリ（非公開）で管理されています。
**なぜ公開しているのか？**
やねうら王や水匠などの将棋AIをローカルで動かしている方が、外出先やスマートフォンからも自分のエンジンを使えるようにしたいというニーズから生まれました。GPL v3 の要件としても、このフロントエンドのソースコードを公開しています。
---
## 機能
| 機能 | 説明 |
|------|------|
| 🤖 エンジン解析 | YaneuraOu USI による深い候補手分析 |
| 📊 評価値グラフ | 棋譜全体の形勢推移を視覚化 |
| ♟️ インタラクティブ盤面 | タッチ対応・盤面反転・手戻しに完全対応 |
| 🆚 AI 対局 | 段階別強さでAIと対戦 |
| 📱 モバイルアプリ | Capacitor で Android ネイティブアプリ化 |
| 🌍 多言語 | 日本語・英語に自動対応 |
| 💾 棋譜管理 | 対局の保存・読み込み |
---
## 技術スタック
```
React 19 + Vite 8 ───── UI & ビルド
TailwindCSS 3 ────────── スタイリング
React Router 7 ──────── ルーティング
Socket.io Client ────── バックエンドとのリアルタイム通信
Recharts ────────────── 評価値グラフ
Capacitor 7 ─────────── Android アプリ化
i18next ─────────────── 多言語対応
```
---
## クイックスタート
### 必要な環境
- **Node.js** 18+
### セットアップ
```bash
git clone https://github.com/pkki/ShogiAnalytics.git
cd ShogiAnalytics
npm install
npm run dev
```
開発サーバーが `http://localhost:5173` で起動します。
> バックエンドサーバーが別途 `http://localhost:3001` で動いている必要があります。
---
## ビルド & デプロイ
```bash
# Web 向けビルド（出力: dist/）
npm run build
# Android APK ビルド
npm run android:apk
```
---
## プロジェクト構成
```
ShogiAnalytics/
├── src/
│ ├── App.jsx # メインアプリ
│ ├── components/
│ │ ├── ShogiBoard.jsx # 盤面 UI
│ │ ├── GameSetupDialog.jsx # AI 対局設定
│ │ └── NavigationPanel.jsx # ナビゲーション
│ └── state/
│ └── gameState.js # 棋譜・盤面ロジック
├── public/
│ └── icons/ # アプリアイコン各サイズ
└── android/ # Capacitor Android プロジェクト
```
---
## スクリプト
```bash
npm run dev # 開発サーバー起動
npm run build # 本番ビルド
npm run preview # ビルド結果プレビュー
npm run lint # ESLint 検査
npm run android:sync # Android 同期
npm run android:open # Android Studio 起動
npm run android:apk # APK ビルド
```
---
## ライセンス
[MIT](LICENSE)
---
Built with ♟️ for Shogi players worldwide
