@weppy/roblox-mcp 1.5.4 → 2.0.0

package/docs/ja/dashboard/settings.md

@@ -0,0 +1,67 @@
+# Settings
+
+> ライセンス情報、サーバー設定、同期設定、言語を確認・管理します。
+
+## 概要
+
+Settingsページではライセンス情報とサーバー設定を確認し、一部を変更できます。サーバーが接続されていれば（L1以上）常にアクセスできます。
+
+## License（読み取り専用）
+
+現在のライセンス状態を表示します：
+
+| 項目 | 説明 |
+|------|------|
+| Status | 状態バッジ（Active/Inactive） |
+| Tier | 現在のティア（Basic/Pro） |
+| License Key | マスクされたライセンスキー |
+| Provider | ライセンスプロバイダー情報 |
+
+## General
+
+| 設定 | 説明 |
+|------|------|
+| Log Level | ログ出力レベル |
+| History Recording | ツール実行履歴の保存有無 |
+| Stats Collection | ツール統計収集の有無 |
+| Request Timeout | リクエストタイムアウト（秒） |
+
+## Server Environment（読み取り専用）
+
+環境変数で設定されたサーバー設定を表示します：
+
+| 環境変数 | 説明 | デフォルト値 |
+|----------|------|--------|
+| `HTTP_PORT` | HTTPポート | 3002 |
+| `HTTP_HOST` | HTTPホスト | 127.0.0.1 |
+| `DASHBOARD_AUTO_OPEN` | ダッシュボード自動オープン | true |
+
+## Sync Settings
+
+| 設定 | 説明 |
+|------|------|
+| Max Depth | 同期最大深度 |
+| Max Instances | 同期最大インスタンス数 |
+
+## Language
+
+ダッシュボードUI言語を変更します。6言語 + Auto（ブラウザ言語自動検出）をサポートしています。
+
+| オプション | 言語 |
+|------|------|
+| Auto | ブラウザ言語自動検出 |
+| English | 英語 |
+| 한국어 | 韓国語 |
+| 日本語 | 日本語 |
+| Español | スペイン語 |
+| Português | ポルトガル語 |
+| Bahasa Indonesia | インドネシア語 |
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)

package/docs/ja/dashboard/sync.md

@@ -0,0 +1,75 @@
+# Sync
+
+> Studio ↔ ローカルファイル同期の現在の状態、方向設定、ログをモニタリングします。
+
+![Sync — 同期状態、方向設定、ログ](../../assets/screenshots/dashboard/dashboard_sync.png)
+
+> Sync機能自体の詳細ガイドは[Sync機能詳細ガイド](../sync/overview.md)をご参照ください。
+
+## 概要
+
+SyncページはStudio ↔ ローカルファイル同期の現在の状態と設定を視覚的に表示します。プラグインが接続された状態（L2）でのみアクセスできます。
+
+## Sync Status
+
+現在の同期状態を表示します：
+
+| 状態 | 意味 |
+|------|------|
+| **Idle** | 同期待機中 |
+| **Initializing** | 初期同期進行中 |
+| **Syncing** | 増分同期進行中 |
+| **Error** | 同期エラー発生 |
+
+状態カードには同期パス、同期されたインスタンス数、現在の適用モード（Auto/Manual）が併せて表示されます。
+
+## Sync Directions
+
+タイプ別の同期方向をテーブルで表示します：
+
+| 列 | 説明 |
+|----|------|
+| Type | 同期対象タイプ（Scripts, Values, Instances, Data, Services） |
+| Direction | 同期方向（Local → Studio, Studio → Local） |
+| Apply Mode | 適用モード（Auto/Manual） |
+
+各タイプの同期方向を確認して、どの変更がどの方向に反映されるかを把握できます。
+
+## Sync Config
+
+同期設定値を表示します：
+- Max Depth — 同期最大深度
+- Max Instances — 同期最大インスタンス数
+- Interval — 同期間隔
+
+## Sync Log
+
+同期イベントを時系列で表示します。各ログ項目には変更タイプタグ（create, update, deleteなど）と対象パスが含まれます。
+
+## 活用事例
+
+### 同期状態の確認
+
+```
+「Syncが正しく動作しているか確認したい」
+```
+
+Sync StatusがIdleであることを確認し、Sync Logで最近の変更が正常に記録されているか確認します。
+
+### 同期方向の把握
+
+```
+「スクリプトの変更がどの方向に同期されるか知りたい」
+```
+
+Sync DirectionsテーブルでScriptsタイプのDirectionを確認します。
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Playtest](playtest.md)
+- [Tools](tools.md)
+- [Settings](settings.md)
+- [Sync機能詳細ガイド](../sync/overview.md)

package/docs/ja/dashboard/tools.md

@@ -0,0 +1,69 @@
+# Tools
+
+> AIが実行したMCPツールの履歴と統計を確認します。
+
+![Tools — ツール実行履歴と統計](../../assets/screenshots/dashboard/dashboard_tools.png)
+
+## 概要
+
+ToolsページはAIが実行したMCPツールの履歴と統計を提供します。**History**と**Statistics**の2つのサブタブで構成されています。サーバーが接続されていれば（L1以上）常にアクセスできます。
+
+## Historyタブ
+
+ツール実行履歴を時系列テーブルで表示します：
+
+| 列 | 説明 |
+|----|------|
+| Time | 実行時間 |
+| Tool.Action | 実行されたツールとアクション（例：`query_instances.get_instance`） |
+| Duration | 実行所要時間 |
+| Status | 結果ステータス（OK/Error） |
+| Tier | 使用されたティア（Basic/Pro） |
+
+機能：
+- **Toolフィルター**ドロップダウンで特定のツールのみフィルタリング
+- ページネーションで大量の履歴を閲覧
+- リアルタイムで新しい実行履歴を追加
+
+## Statisticsタブ
+
+ツール使用統計を視覚的に分析します：
+
+- **ティア分布** — Basic/Proツール使用比率
+- **ツール別統計** — 各ツールの呼び出し回数、平均応答時間
+- **アクション別分析** — ツール内のアクション別詳細統計
+
+## Basicティア専用機能
+
+Basicティアユーザーには追加UIが表示されます：
+
+- **Tier Usage Progress** — 使用量プログレスバー
+- **Basic vs Pro比較モーダル** — Proティアの追加機能を案内
+
+## 活用事例
+
+### ツールパフォーマンス分析
+
+```
+「どのツールが最も時間がかかるか知りたい」
+```
+
+Statisticsタブでツール別の平均応答時間を確認します。
+
+### エラー追跡
+
+```
+「実行したツールが失敗した理由を知りたい」
+```
+
+HistoryタブでStatusがErrorの項目を見つけて詳細情報を確認します。
+
+## 関連ドキュメント
+
+- [ダッシュボード Overview](overview.md)
+- [Changelog](changelog.md)
+- [Connection](connection.md)
+- [Sync](sync.md)
+- [Playtest](playtest.md)
+- [Settings](settings.md)
+- [Tool一覧](../tools/overview.md)

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

@@ -21,7 +21,7 @@ Claude Codeターミナルで実行:
 
 ```bash
 # マーケットプレイスを追加
-/plugin marketplace add hope1026/roblox-mcp
+/plugin marketplace add hope1026/weppy-roblox-mcp
 
 # プラグインをインストール
 /plugin install weppy-roblox-mcp@hope1026-roblox-mcp

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

@@ -4,7 +4,7 @@ Roblox StudioでAIエージェントと連携するためのプラグインイ
 
 ## 1. プラグインをダウンロード
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) を開く
+1. [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest) を開く
 2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
 3. ZIPを解凍 - `roblox-plugin/WeppyRobloxMCP.rbxm` とセットアップガイドを確認
 

package/docs/ja/pro-upgrade.md

@@ -30,7 +30,7 @@ Pro Syncは単方向エクスポートを超えます。ローカルでスクリ
 
 ### ステップ2: GitHub Releasesからダウンロード
 
-1. [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest) を開く
+1. [GitHub Releases](https://github.com/hope1026/weppy-roblox-mcp/releases/latest) を開く
 2. `weppy-roblox-mcp-v{version}.zip` をダウンロード
 3. 解凍して `roblox-plugin/WeppyRobloxMCP.rbxm` を Roblox Plugins フォルダへコピー
 

package/docs/ko/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로 스크립트, 지형, 에셋, 조명을 AI로 제어합니다.
+> **Weppy Roblox MCP**는 AI 코딩 에이전트가 라이브 Roblox Studio 세션을 제어할 수 있게 하는 MCP 서버입니다 — 자연어로 스크립트, 인스턴스, 지형, 조명, 에셋, 오디오, 애니메이션을 생성하고 편집합니다.
+
+**21개 통합 도구 · 140+ 액션 · 양방향 Sync · 자동 플레이테스트 · 멀티 Place 지원**
 
 [English](../../README.md) | **한국어** | [日本語](../ja/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 @@ Studio 플레이테스트를 AI가 직접 제어합니다. F5(Play)/F8(Run) 시
 - "SpawnLocation이 지면 위에 있는지 테스트 스크립트를 작성해서 자동 실행해줘."
 - "방금 수정한 스크립트가 에러 없이 동작하는지 플레이테스트로 검증해줘."
 
-### 4) Roblox Explorer: VSCode에서 Studio 계층 구조 탐색
+### 4) Dashboard: AI 작업을 실시간으로 모니터링
+
+MCP 서버가 제공하는 웹 대시보드에서 연결 상태, 도구 실행 기록, 동기화 상태, 게임 변경 이력을 실시간으로 확인합니다.
+
+![대시보드 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 확장)](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/ko/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/ko/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 테이블에 플러그인이 표시되는지 확인합니다. 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/ko/dashboard/overview.md

@@ -0,0 +1,95 @@
+# 대시보드
+
+> MCP 서버의 상태, 연결, 동기화, 도구 실행 기록, 게임 변경 이력을 웹 브라우저에서 실시간으로 확인하고 관리합니다.
+
+![대시보드 Overview — 서버 상태, 최근 변경 사항, 세션 요약을 한눈에 확인](../../assets/screenshots/dashboard/dashboard_overview.png)
+
+## 대시보드란?
+
+대시보드는 MCP 서버가 제공하는 웹 기반 모니터링 인터페이스입니다. 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/ko/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)