@weppy/roblox-mcp 1.5.4 → 2.0.0

package/docs/id/dashboard/settings.md

@@ -0,0 +1,67 @@
+# Settings
+
+> Periksa dan kelola informasi lisensi, pengaturan server, pengaturan sinkronisasi, dan bahasa.
+
+## Ikhtisar
+
+Di halaman Settings, Anda dapat melihat informasi lisensi dan pengaturan server, serta mengubah sebagian pengaturan. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+
+## License (hanya-baca)
+
+Menampilkan status lisensi saat ini:
+
+| Item | Deskripsi |
+|------|-----------|
+| Status | Badge status (Active/Inactive) |
+| Tier | Tier saat ini (Basic/Pro) |
+| License Key | Kunci lisensi yang disamarkan |
+| Provider | Informasi penyedia lisensi |
+
+## General
+
+| Pengaturan | Deskripsi |
+|------------|-----------|
+| Log Level | Tingkat output log |
+| History Recording | Apakah riwayat eksekusi alat disimpan |
+| Stats Collection | Apakah statistik alat dikumpulkan |
+| Request Timeout | Batas waktu permintaan (detik) |
+
+## Server Environment (hanya-baca)
+
+Menampilkan pengaturan server yang dikonfigurasi melalui variabel lingkungan:
+
+| Variabel Lingkungan | Deskripsi | Nilai Default |
+|---------------------|-----------|---------------|
+| `HTTP_PORT` | Port HTTP | 3002 |
+| `HTTP_HOST` | Host HTTP | 127.0.0.1 |
+| `DASHBOARD_AUTO_OPEN` | Pembukaan otomatis dashboard | true |
+
+## Sync Settings
+
+| Pengaturan | Deskripsi |
+|------------|-----------|
+| Max Depth | Kedalaman maksimum sinkronisasi |
+| Max Instances | Jumlah maksimum instance yang disinkronkan |
+
+## Language
+
+Mengubah bahasa UI dashboard. Mendukung 6 bahasa + Auto (deteksi otomatis bahasa browser).
+
+| Opsi | Bahasa |
+|------|--------|
+| Auto | Deteksi otomatis bahasa browser |
+| English | Inggris |
+| 한국어 | Korea |
+| 日本語 | Jepang |
+| Español | Spanyol |
+| Português | Portugis |
+| Bahasa Indonesia | Indonesia |
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)

package/docs/id/dashboard/sync.md

@@ -0,0 +1,75 @@
+# Sync
+
+> Pantau status saat ini, pengaturan arah, dan log sinkronisasi Studio <-> file lokal.
+
+![Sync — status sinkronisasi, pengaturan arah, log](../../assets/screenshots/dashboard/dashboard_sync.png)
+
+> Untuk panduan detail fitur Sync itu sendiri, lihat [Panduan detail fitur Sync](../sync/overview.md).
+
+## Ikhtisar
+
+Halaman Sync menampilkan status dan pengaturan sinkronisasi Studio <-> file lokal secara visual. Halaman ini hanya dapat diakses saat plugin terhubung (L2).
+
+## Sync Status
+
+Menampilkan status sinkronisasi saat ini:
+
+| Status | Arti |
+|--------|------|
+| **Idle** | Menunggu sinkronisasi |
+| **Initializing** | Sinkronisasi awal sedang berlangsung |
+| **Syncing** | Sinkronisasi inkremental sedang berlangsung |
+| **Error** | Terjadi kesalahan sinkronisasi |
+
+Kartu status juga menampilkan path sinkronisasi, jumlah instance yang disinkronkan, dan mode penerapan saat ini (Auto/Manual).
+
+## Sync Directions
+
+Menampilkan arah sinkronisasi per tipe dalam bentuk tabel:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Type | Tipe target sinkronisasi (Scripts, Values, Instances, Data, Services) |
+| Direction | Arah sinkronisasi (Local -> Studio, Studio -> Local) |
+| Apply Mode | Mode penerapan (Auto/Manual) |
+
+Periksa arah sinkronisasi setiap tipe untuk memahami perubahan mana yang direfleksikan ke arah mana.
+
+## Sync Config
+
+Menampilkan nilai pengaturan sinkronisasi:
+- Max Depth — kedalaman maksimum sinkronisasi
+- Max Instances — jumlah maksimum instance yang disinkronkan
+- Interval — interval sinkronisasi
+
+## Sync Log
+
+Menampilkan event sinkronisasi secara kronologis. Setiap item log mencakup tag jenis perubahan (create, update, delete, dll.) dan path target.
+
+## Contoh Penggunaan
+
+### Memeriksa Status Sinkronisasi
+
+```
+"Saya ingin memastikan Sync berjalan dengan benar"
+```
+
+Periksa apakah Sync Status menunjukkan Idle, dan konfirmasi di Sync Log bahwa perubahan terbaru tercatat dengan normal.
+
+### Memahami Arah Sinkronisasi
+
+```
+"Saya ingin tahu ke arah mana perubahan script disinkronkan"
+```
+
+Periksa Direction dari tipe Scripts di tabel Sync Directions.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [Panduan detail fitur Sync](../sync/overview.md)

package/docs/id/dashboard/tools.md

@@ -0,0 +1,69 @@
+# Tools
+
+> Periksa riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI.
+
+![Tools — riwayat eksekusi dan statistik alat](../../assets/screenshots/dashboard/dashboard_tools.png)
+
+## Ikhtisar
+
+Halaman Tools menyediakan riwayat eksekusi dan statistik alat MCP yang dijalankan oleh AI. Terdiri dari dua sub-tab: **History** dan **Statistics**. Halaman ini selalu dapat diakses selama server terhubung (L1 ke atas).
+
+## Tab History
+
+Menampilkan riwayat eksekusi alat dalam tabel kronologis:
+
+| Kolom | Deskripsi |
+|-------|-----------|
+| Time | Waktu eksekusi |
+| Tool.Action | Alat dan aksi yang dieksekusi (contoh: `query_instances.get_instance`) |
+| Duration | Durasi eksekusi |
+| Status | Status hasil (OK/Error) |
+| Tier | Tier yang digunakan (Basic/Pro) |
+
+Fitur:
+- Dropdown **Tool filter** untuk memfilter alat tertentu
+- Paginasi untuk menelusuri riwayat dalam jumlah besar
+- Penambahan riwayat eksekusi baru secara real-time
+
+## Tab Statistics
+
+Menganalisis statistik penggunaan alat secara visual:
+
+- **Distribusi tier** — rasio penggunaan alat Basic/Pro
+- **Statistik per alat** — jumlah panggilan dan rata-rata waktu respons setiap alat
+- **Analisis per aksi** — statistik detail per aksi dalam alat
+
+## Fitur Khusus Tier Basic
+
+UI tambahan ditampilkan untuk pengguna tier Basic:
+
+- **Tier Usage Progress** — progress bar penggunaan
+- **Modal perbandingan Basic vs Pro** — informasi fitur tambahan tier Pro
+
+## Contoh Penggunaan
+
+### Analisis Performa Alat
+
+```
+"Saya ingin tahu alat mana yang paling lama eksekusinya"
+```
+
+Periksa rata-rata waktu respons per alat di tab Statistics.
+
+### Pelacakan Error
+
+```
+"Saya ingin tahu mengapa alat yang baru saja dieksekusi gagal"
+```
+
+Cari item dengan Status Error di tab History untuk melihat informasi detail.
+
+## Dokumen Terkait
+
+- [Dashboard Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Settings](settings.md)
+- [Daftar tool lengkap](../tools/overview.md)

package/docs/id/installation/ai-apps/claude-code.md

@@ -21,7 +21,7 @@ Jalankan di terminal Claude Code:
 
 ```bash
 # Tambah marketplace
-/plugin marketplace add hope1026/roblox-mcp
+/plugin marketplace add hope1026/weppy-roblox-mcp
 
 # Instal plugin
 /plugin install weppy-roblox-mcp@hope1026-roblox-mcp

package/docs/id/installation/roblox-plugin.md

@@ -4,7 +4,7 @@ Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
 
 ## 1. Unduh Plugin
 
-1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Buka [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
 2. Unduh `weppy-roblox-mcp-v{version}.zip`
 3. Ekstrak ZIP - Anda akan menemukan `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
 

package/docs/id/pro-upgrade.md

@@ -30,7 +30,7 @@ Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi
 
 ### Langkah 2: Unduh dari GitHub Releases
 
-1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+1. Buka [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest)
 2. Unduh `weppy-roblox-mcp-v{version}.zip`
 3. Ekstrak lalu salin `roblox-plugin/WeppyRobloxMCP.rbxm` ke folder Plugins Roblox
 

package/docs/ja/README.md

@@ -1,10 +1,12 @@
-# Roblox MCP
+# Roblox MCP — Roblox Studio MCPサーバー | Claude、Codex、Cursor、GeminiでAIゲーム開発
 
-> Roblox Studio用MCPサーバー＆プラグイン — Claude Code、Cursor、Codex、GeminiでスクリプトやTerrain、アセット、ライティングをAI制御。
+> **Weppy Roblox MCP**は、AIコーディングエージェントがライブRoblox Studioセッションを制御できるMCPサーバーです — 自然言語でスクリプト、インスタンス、Terrain、ライティング、アセット、オーディオ、アニメーションを作成・編集します。
+
+**21統合ツール · 140+アクション · 双方向Sync · 自動プレイテスト · マルチPlace対応**
 
 [English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-[![デモ](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+[![デモ — AIがリアルタイムでRobloxゲームを制作する様子](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
 ## クイックインストール（5分）
 
@@ -64,7 +66,17 @@ AIがStudioプレイテストを直接制御します。Play（F5）/Run（F8）
 - 「SpawnLocationが地面の上にあることを確認するテストを書いて実行して。」
 - 「今修正したスクリプトがエラーなしで動くかプレイテストで検証して。」
 
-### 4) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
+### 4) Dashboard: AI作業をリアルタイムでモニタリング
+
+MCPサーバーが提供するWebダッシュボードで、接続状態、ツール実行履歴、同期状態、ゲーム変更履歴をリアルタイムで確認します。
+
+![ダッシュボード Overview — サーバー状態、最近の変更、セッション要約](../assets/screenshots/dashboard/dashboard_overview.png)
+
+- サーバー/プラグイン/エージェントの接続状態を一目で確認
+- AIが変更したすべての内容をChangelogでBefore & Afterで比較
+- ツール実行履歴と統計で作業フローを分析
+
+### 5) Roblox Explorer: VSCodeでStudioの階層構造を閲覧
 
 Roblox Studioのインスタンスツリー全体をVSCode内で直接確認できます。サービスを探索し、同期されたスクリプトやプロパティファイルを開き、同期状態を追跡 — Studioに切り替える必要はありません。
 
@@ -86,6 +98,7 @@ Roblox Studioのインスタンスツリー全体をVSCode内で直接確認で
 - [インストールガイド](../en/installation/README.md)
 - [Tool一覧](tools/overview.md)
 - [Sync機能詳細ガイド](sync/overview.md)
+- [ダッシュボードガイド](dashboard/overview.md)
 - [Roblox Explorer (VSCode拡張)](../en/installation/roblox-explorer.md)
 - [互換性](../compatibility.md)
 - [トラブルシューティング](../troubleshooting.md)
@@ -107,4 +120,4 @@ Roblox Studioのインスタンスツリー全体をVSCode内で直接確認で
 
 ---
 
-[GitHubイシュー](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)
+[GitHubイシュー](https://github.com/hope1026/weppy-roblox-mcp/issues) · [Discussions](https://github.com/hope1026/weppy-roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ja/dashboard/changelog.md

@@ -0,0 +1,114 @@
+# Changelog
+
+> AIがRoblox Studioで実行したすべての変更をセッション単位で記録し、変更要約/タイムライン/Before & Afterを提供します。
+
+![Changelog — セッション別変更カード一覧](../../assets/screenshots/dashboard/dashboard_changelog1.png)
+
+## 概要
+
+ChangelogはAIエージェントがStudioで実行したゲーム変更履歴を追跡するページです。変更はセッション単位でグループ化され、各セッションでどのような種類の変更が何件発生したかを一目で把握できます。
+
+## セッションカード一覧
+
+Changelogの最初の画面はセッション別のカード一覧を表示します。
+
+### セッション状態
+
+各セッションカードには状態が表示されます：
+
+| 状態 | 意味 |
+|------|------|
+| **Active** | 現在進行中のセッション（リアルタイム更新） |
+| **Completed** | 完了したセッション |
+| **Bootstrap** | 初期同期セッション |
+
+### セッション要約
+
+各カードには該当セッションの変更件数がカテゴリ別に要約されます：
+
+- Script — スクリプト作成/修正件数
+- Instance — インスタンス作成/削除/移動件数
+- Property — プロパティ変更件数
+- Lighting — ライティング/環境設定件数
+- Terrain — 地形変更件数
+- Asset — アセット挿入件数
+
+### フィルタータブ
+
+上部のタブでセッションをフィルタリングできます：
+- **All** — すべてのセッション
+- **Active** — 進行中のセッションのみ
+- **Completed** — 完了したセッションのみ
+
+## セッション詳細ビュー
+
+セッションカードをクリックすると詳細ビューに入ります。
+
+![Changelog詳細ビュー — 変更要約、タイムライン、Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
+
+### Change Summary
+
+セッションの変更を6つのカテゴリカードで可視化します：
+
+| カテゴリ | アイコン | 説明 |
+|---------|--------|------|
+| Scripts | スクリプト | スクリプト作成/修正件数 |
+| Instances | インスタンス | インスタンス作成/削除/移動件数 |
+| Properties | プロパティ | プロパティ変更件数 |
+| Lighting | ライティング | ライティング/環境変更件数 |
+| Terrain | 地形 | 地形変更件数 |
+| Assets | アセット | アセット挿入件数 |
+
+### Change Timeline
+
+セッション内のすべての変更を時系列で一覧表示します。
+
+- 各項目にタイムスタンプ、変更カテゴリタグ、対象パスが表示されます
+- **Category**ドロップダウンで特定のカテゴリのみフィルタリングできます
+- 項目をクリックするとBefore & After比較ビューが展開されます
+
+### Before & After
+
+変更前後のデータを比較します。変更タイプに応じて異なるレベルの情報を提供します：
+
+| 信頼度 | 意味 | 例 |
+|--------|------|------|
+| **exact** | 変更前後の値が正確に記録されている | プロパティ変更、スクリプト修正 |
+| **partial** | 一部の情報のみ記録されている | 複合変更 |
+| **after-only** | 変更後の値のみ存在する | 新規インスタンス作成 |
+| **intent-only** | 意図のみ記録されている | 削除など |
+
+## 活用事例
+
+### 作業検証
+
+```
+「AIが修正したスクリプトが何か確認したい」
+```
+
+ChangelogでActiveセッションのScriptカテゴリをフィルタリングすると、修正されたスクリプト一覧と変更前後のコードを比較できます。
+
+### 変更追跡
+
+```
+「昨日のセッションでLightingをどう設定したか確認したい」
+```
+
+CompletedタブでそのセッションをLightingカテゴリでフィルタリングすると、変更履歴と設定値を確認できます。
+
+### 問題デバッグ
+
+```
+「どの時点で特定のインスタンスが削除されたか探す必要がある」
+```
+
+タイムラインでInstanceカテゴリをフィルタリングし、deleteタイプの変更を時系列で追跡できます。
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)

package/docs/ja/dashboard/connection.md

@@ -0,0 +1,77 @@
+# Connection
+
+> サーバー、AIエージェント、プラグインの接続状態を一か所でモニタリングします。
+
+![Connection — サーバー状態、AIエージェント、プラグイン接続情報](../../assets/screenshots/dashboard/dashboard_connection.png)
+
+## 概要
+
+ConnectionページはMCPシステムのすべての接続状態を一か所でモニタリングします。サーバーが接続されていれば（L1以上）常にアクセスできます。
+
+## Server Status
+
+サーバーの主要情報を表示します：
+
+| 項目 | 説明 |
+|------|------|
+| Status | 接続状態バッジ（Online/Offline） |
+| Version | MCPサーバーバージョン |
+| PID | サーバープロセスID |
+| Uptime | サーバー稼働時間 |
+| Session ID | 現在のセッション識別子 |
+| Exec Path | サーバー実行パス |
+
+## AI Agents
+
+現在接続されているAIエージェント一覧をテーブルで表示します：
+
+| 列 | 説明 |
+|----|------|
+| Name | エージェント名（例：Claude Code） |
+| PID | エージェントプロセスID |
+| Working Dir | エージェント作業ディレクトリ |
+| Connected | 接続経過時間 |
+
+複数のエージェントが同時に接続されている場合、すべて表示されます。
+
+## Plugins
+
+接続されているRoblox Studioプラグイン一覧を表示します：
+
+| 列 | 説明 |
+|----|------|
+| Place | Place名 |
+| Client ID | プラグインクライアント識別子 |
+| Last Seen | 最終通信時間 |
+| Version | プラグインバージョン |
+
+## Connection Log
+
+接続関連イベントをリアルタイムで表示します。SSEを通じてエージェント/プラグインの接続/切断イベントが自動的に追加されます。
+
+## 活用事例
+
+### 接続問題の診断
+
+```
+「AIがStudioと接続されていないようだ」
+```
+
+Server StatusがOnlineか、PluginsテーブルにプラグインがUPされているかを確認します。Connection Logで接続/切断イベントを追跡できます。
+
+### エージェント確認
+
+```
+「今どのAIが接続されているか確認したい」
+```
+
+AI Agentsテーブルで現在接続されているエージェントの名前、PID、作業ディレクトリを確認します。
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Changelog](changelog.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)

package/docs/ja/dashboard/overview.md

@@ -0,0 +1,95 @@
+# ダッシュボード
+
+> MCPサーバーの状態、接続、同期、ツール実行履歴、ゲーム変更履歴をWebブラウザでリアルタイムに確認・管理します。
+
+![ダッシュボード Overview — サーバー状態、最近の変更、セッション要約を一目で確認](../../assets/screenshots/dashboard/dashboard_overview.png)
+
+## ダッシュボードとは？
+
+ダッシュボードはMCPサーバーが提供するWeb基盤のモニタリングインターフェースです。MCPサーバーが起動すると自動的にブラウザで開かれ、AIエージェントがRoblox Studioで実行するすべての作業をリアルタイムで追跡できます。
+
+- ターミナルログを探す必要なく、視覚的に状態を把握
+- AIがStudioで何を変更したか、変更履歴で追跡
+- 同期状態、接続状態、ツール実行統計を一か所で確認
+
+## ページ構成
+
+| ページ | 説明 | 詳細ガイド |
+|--------|------|------------|
+| [Overview](#overview) | サーバー/プラグイン/エージェント/Sync状態カード、最近の変更フィード | このドキュメント |
+| [Changelog](changelog.md) | ゲーム変更履歴 — セッション別カード、変更要約、タイムライン、Before & After | [詳細ガイド](changelog.md) |
+| [Connection](connection.md) | サーバー状態、AIエージェント一覧、プラグイン接続情報 | [詳細ガイド](connection.md) |
+| [Sync](sync.md) | 同期状態、方向設定、ログ | [詳細ガイド](sync.md) |
+| [Playtest](playtest.md) | プレイテスト状態、テスト記録 | [詳細ガイド](playtest.md) |
+| [Tools](tools.md) | ツール実行履歴、統計、ティア分布 | [詳細ガイド](tools.md) |
+| [Settings](settings.md) | ライセンス、ログレベル、Sync設定、言語 | [詳細ガイド](settings.md) |
+
+## アクセス方法
+
+MCPサーバーが起動するとダッシュボードが自動的にブラウザで開きます。手動でアクセスするには：
+
+```
+http://localhost:3002
+```
+
+> `DASHBOARD_AUTO_OPEN=false`に設定すると自動オープンを無効化できます（[Settings](settings.md)ページで確認）。
+
+## 接続レベル
+
+ダッシュボードは接続状態に応じて使用可能な機能が異なります：
+
+| レベル | 条件 | 使用可能なページ |
+|:----:|------|-------------------|
+| **L0** | サーバー未接続 | 再接続待機画面のみ表示 |
+| **L1** | サーバー接続、プラグイン未接続 | Connection, Tools, Settings |
+| **L2** | サーバー + プラグイン両方接続 | すべてのページ |
+
+プラグインが接続されていない状態（L1）では、Overview、Changelog、Sync、Playtestページにアクセスできません。
+
+## Overview
+
+Overviewページはダッシュボードの最初の画面で、システム全体の状態を一目で表示します。
+
+### 状態カード
+
+| カード | 表示情報 |
+|------|----------|
+| **Server** | サーバー接続状態（Online/Offline） |
+| **Plugin** | プラグイン接続状態、Place情報 |
+| **Agent** | 現在接続されているAIエージェント名 |
+| **Sync** | 同期状態（Idle/Syncing/Error） |
+
+### 最近のゲーム変更（Recent Game Changes）
+
+AIがStudioで実行した最近の変更をリアルタイムで表示します（最大20件）。各項目は変更カテゴリアイコンとともに表示され、クリックすると[Changelog](changelog.md)の詳細ビューに移動します。
+
+カテゴリアイコン：
+- Script — スクリプト作成/修正
+- Instance — インスタンス作成/削除/移動
+- Property — プロパティ変更
+- Lighting — ライティング/環境設定
+- Terrain — 地形変更
+- Asset — アセット挿入
+
+### セッション変更要約（Session Change Summary）
+
+現在のセッションの変更統計をカテゴリ別に集計して表示します（例："4 scripts · 3 properties"）。
+
+## リアルタイム更新
+
+ダッシュボードはSSE（Server-Sent Events）を使用してリアルタイムでデータを更新します：
+
+- サーバー状態：5秒間隔ポーリング
+- 変更フィード、接続イベント：SSEリアルタイムストリーミング
+- SSE接続切断時：3秒後に自動再接続
+
+## 関連ドキュメント
+
+- [Changelog](changelog.md) — ゲーム変更履歴の追跡
+- [Connection](connection.md) — サーバー/エージェント/プラグイン接続状態
+- [Sync](sync.md) — 同期状態モニタリング
+- [Playtest](playtest.md) — プレイテスト記録
+- [Tools](tools.md) — ツール実行履歴/統計
+- [Settings](settings.md) — ライセンス、サーバー設定、言語
+- [Tool一覧](../tools/overview.md)
+- [Sync機能詳細ガイド](../sync/overview.md)

package/docs/ja/dashboard/playtest.md

@@ -0,0 +1,61 @@
+# Playtest
+
+> AIが実行したプレイテストの状態とテスト結果を確認します。
+
+![Playtest — プレイテスト状態とテスト記録](../../assets/screenshots/dashboard/dashboard_playtest.png)
+
+## 概要
+
+PlaytestページはAIが実行したプレイテストの状態とテスト結果を表示します。プラグインが接続された状態（L2）でのみアクセスできます。
+
+## Playtest Status
+
+現在のプレイテスト状態を表示します：
+
+| 状態 | 意味 |
+|------|------|
+| **NotRunning** | プレイテスト未実行 |
+| **Running** | プレイテスト実行中 |
+| **Paused** | プレイテスト一時停止（Runモード） |
+
+## Test History
+
+AIが`run_test`アクションで実行したテスト結果を時系列で一覧表示します：
+
+| 項目 | 説明 |
+|------|------|
+| タイムスタンプ | テスト実行時間 |
+| Test Report | テストレポートリンク |
+| Mode | 実行モード（play/run） |
+| Duration | テスト所要時間 |
+| Status | 結果（Passed/Failed） |
+
+テストレポートをクリックすると、マークダウン形式の詳細レポートとログを確認できます。
+
+## 活用事例
+
+### テスト失敗の分析
+
+```
+「実行した自動テストが失敗した原因を探したい」
+```
+
+Test HistoryでFailed状態のテストを見つけてTest Reportをクリックすると、詳細ログと失敗原因を確認できます。
+
+### テスト履歴の確認
+
+```
+「今日実行したテストの成功/失敗状況を確認したい」
+```
+
+Test HistoryでタイムスタンプとStatusを確認して、テスト結果の推移を把握します。
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [プレイテスト & 自動テスト（ツール）](../tools/playtest.md)